chore: import DH V2 D5.6.4 production baseline

docs/INSPECTION_DOCUMENT_MODEL.md

@@ -0,0 +1,96 @@
+# Modelo documental de inspecciones
+
+Este documento fija el modelo funcional validado a partir del Informe Técnico
+Nº 124/2026, el acta manuscrita adjunta y la planilla de hallazgos entregada.
+
+## Canales de operación
+
+| Función | APK móvil | Dashboard web |
+|---|---:|---:|
+| Planificar visita, activos y equipo | Consulta | Administra |
+| Administrar activos y catálogo de hallazgos | Consulta | Administra |
+| Iniciar y ejecutar la visita | Inspector | No |
+| Crear o modificar el acta y sus hallazgos | Inspector | Sólo consulta |
+| Incorporar evidencia de campo y GPS | Inspector | Sólo consulta |
+| Identificar responsable, firmar y cerrar | Inspector | Sólo consulta |
+| Registrar respuesta empresarial, PDF y próximo control | Consulta | Administra |
+| Consultar acta, hallazgos e informe sincronizados | Sí | Sí |
+
+La API aplica esta separación además de la interfaz: las escrituras operativas
+requieren autenticación bearer de la aplicación móvil y el rol `inspector`.
+Una sesión web no puede eludir la restricción llamando directamente al endpoint.
+
+## Cardinalidades
+
+| Origen | Relación | Destino |
+|---|---:|---|
+| Inspección o visita | 1 a 1 | Acta de inspección |
+| Acta | 1 a muchos | Hallazgos |
+| Hallazgo | muchos a 1 | Activo o equipo del Maestro |
+| Hallazgo | muchos a 1 | Ítem del catálogo configurable |
+| Hallazgo | 1 a muchos | Evidencias, principalmente fotografías |
+| Acta | 1 a muchos | Firmas de inspectores |
+| Acta | 1 a 1 | Firma del responsable que atendió la visita |
+| Inspección o visita | 1 a 1 | Informe técnico |
+| Informe técnico | incorpora | Acta, hallazgos y evidencias congelados |
+
+## Acta digital
+
+El acta debe reunir como mínimo:
+
+- número anual oficial, fecha, hora y ubicación;
+- empresa, área, yacimiento o instalación inspeccionada;
+- objeto y resultado de la inspección;
+- todos los hallazgos de la visita y sus plazos de corrección;
+- inspectores intervinientes;
+- identidad, DNI, cargo y correo del responsable de la empresa que recibió al
+  equipo;
+- firmas manuscritas capturadas en pantalla de inspectores y responsable;
+- versión inmutable, hash, sello de tiempo y token de verificación.
+
+Al finalizar la visita, el acta se cierra y ya no admite edición. Se genera el
+PDF verificable y se envía al correo del responsable de la empresa y a una
+dirección interna de Hidrocarburos definida por configuración. Cada intento y
+resultado de entrega debe quedar auditado.
+
+Si se requiere corregir un acta cerrada, se emitirá una rectificativa vinculada
+sin reemplazar ni borrar el documento original.
+
+## Hallazgos
+
+La planilla entregada contiene 170 modelos de hallazgo agrupados en 19
+categorías de equipos, con descripción, normativa y glosario. Se implementará
+como catálogo administrable, importable y versionado. No se copiarán esas
+opciones como constantes en la interfaz.
+
+Cada hallazgo operativo conservará una instantánea de su descripción y base
+legal para que posteriores cambios del catálogo no alteren documentos ya
+emitidos. También podrá registrar estado, observación específica, activo,
+ubicación/GPS, plazo y evidencias.
+
+Cada hallazgo nace abierto. Se distinguen el plazo exigido, la respuesta y
+fecha comprometida por la empresa, y la fecha de próximo control fijada por el
+organismo. La respuesta empresarial no cierra el hallazgo: sólo una verificación
+posterior autorizada puede hacerlo.
+
+## Informe técnico
+
+El informe se genera después del cierre del acta, con numeración anual global
+independiente. Siguiendo el modelo entregado, contempla:
+
+- título, número, acta referenciada, empresa, área/yacimiento y autores;
+- objetivos;
+- antecedentes;
+- marco legal;
+- resumen ejecutivo;
+- descripción de la inspección y de todos los hallazgos;
+- registro fotográfico;
+- conclusión;
+- acta digital completa como anexo final.
+
+El informe congela las versiones exactas del acta, hallazgos, activos,
+evidencias y normativa que incorpora.
+
+La solicitud de creación del informe corresponde al flujo del inspector en la
+APK después de cerrar la visita. El backend numera, compone y sella el PDF; el
+dashboard sólo lo consulta, descarga y administra su seguimiento documental.