docs: align document model with multi-Act inspections and provisional PDFs

docs/INSPECTION_DOCUMENT_MODEL.md

@@ -1,96 +1,124 @@
 # 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.
+Este documento fija el modelo funcional vigente para Inspecciones, Actas,
+Hallazgos e Informes. La estructura visual definitiva de los documentos todavía
+puede cambiar cuando Hidrocarburos entregue las plantillas oficiales; el contrato
+de datos, la trazabilidad y las reglas de inmutabilidad deben permanecer estables.
 
 ## 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 |
+| Planificar Inspección, alcance y equipo | Consulta | Administra |
+| Administrar Inventarios y catálogo de Hallazgos | Consulta | Administra |
+| Iniciar y ejecutar la Inspección | Inspector | No |
+| Crear Actas y registrar Hallazgos de campo | 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í |
+| Identificar responsable, firmar y sellar Acta | Inspector | Sólo consulta |
+| Preparar y revisar el INF | Consulta | Administra |
+| Registrar oficialización GEDO/IF y PDF oficial | Consulta | Administra |
+| Registrar respuesta empresarial y seguimientos | Consulta | Administra |
+| Consultar Actas, Hallazgos e Informes 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.
+La API aplica esta separación además de la interfaz. Las escrituras operativas de
+campo se realizan desde la aplicación móvil con las autorizaciones correspondientes;
+el dashboard administra planificación, consulta y circuito documental posterior.
 
-## Cardinalidades
+## Cardinalidades vigentes
 
 | Origen | Relación | Destino |
 |---|---:|---|
-| Inspección o visita | 1 a 1 | Acta de inspección |
+| Inspección o visita | 1 a muchos | Actas 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 |
+| Hallazgo | muchos a 1 | Elemento de Inventario |
+| Hallazgo | muchos a 1 | Ítem del catálogo configurable, o propuesta OTROS |
+| Hallazgo | 1 a muchos | Evidencias y seguimientos |
 | 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 | 0 o 1 | Firma/manifestación del responsable de empresa |
+| Acta sellada | 0 o 1 | Informe técnico (INF) |
+| Informe técnico | 1 a 1 | Acta fuente |
+| Informe técnico | incorpora | Acta, Hallazgos, Inventarios y evidencias congelados |
+
+Una Inspección puede, por lo tanto, contener varias Actas y generar varios INF,
+pero cada INF conserva una única Acta fuente. No se mezcla el contenido de dos
+Actas dentro de un mismo Informe.
 
 ## Acta digital
 
-El acta debe reunir como mínimo:
+El Acta debe poder 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;
+- número y año oficial del Acta;
+- Inspección vinculada, fecha y hora;
+- Departamento, Área, Yacimiento, Operadora y ubicación de la actuación;
+- objeto, alcance y descripción de lo actuado;
+- Instalaciones y Subinstalaciones inspeccionadas;
+- todos los Hallazgos del Acta, con descripción, Inventario afectado, base legal,
+  reincidencia, gravedad y plazos que correspondan;
 - 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.
+  equipo, cuando corresponda;
+- firma de inspectores y manifestación/firma del responsable de empresa, incluida
+  conformidad, disidencia, negativa o ausencia según el flujo aplicable;
+- versión inmutable, hash, sello de tiempo y mecanismo de verificación documental;
+- referencias a fotografías/evidencias cuando el formulario oficial determine que
+  deben formar parte del documento.
 
-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.
+Al sellarse, el Acta queda inmutable. Los cambios posteriores pertenecen al
+seguimiento y no reescriben el contenido constatado. El sistema conserva la
+instantánea y hashes necesarios para que el PDF se pueda regenerar o sustituir su
+renderer sin alterar la evidencia fuente.
 
 ## 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.
+El catálogo de Hallazgos es administrable, importable y versionado. Cada Hallazgo
+operativo conserva una instantánea de su descripción y base legal para que cambios
+posteriores del catálogo no modifiquen documentos ya emitidos.
 
-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, la fecha de próximo control y las verificaciones
+posteriores. La respuesta empresarial no cierra por sí sola un Hallazgo: el cierre
+surge del flujo de verificación autorizado.
 
-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 (INF)
 
-## Informe técnico
+El INF nace desde una Acta sellada y tiene numeración propia. Mientras está en
+preparación dispone de un Word editable para el desarrollo técnico; modificar ese
+Word o los campos narrativos no modifica el Acta ni sus Hallazgos fuente.
 
-El informe se genera después del cierre del acta, con numeración anual global
-independiente. Siguiendo el modelo entregado, contempla:
+El contrato proyectado del Informe contempla:
 
-- título, número, acta referenciada, empresa, área/yacimiento y autores;
-- objetivos;
-- antecedentes;
+- número/año del INF y Acta referenciada;
+- Inspección, Empresa, Departamento, Área, Yacimiento y autores;
+- objetivos y 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.
+- descripción y análisis técnico de la inspección;
+- Inventarios inspeccionados;
+- detalle de los Hallazgos, reincidencias, gravedad y plazos;
+- registro fotográfico/evidencias seleccionadas;
+- conclusiones y recomendaciones;
+- trazabilidad e integridad de la fuente;
+- Acta digital completa como anexo final.
 
-El informe congela las versiones exactas del acta, hallazgos, activos,
-evidencias y normativa que incorpora.
+Cuando GEDO devuelve el identificador IF y su PDF oficial, ambos se registran de
+forma inmutable junto con la fecha de oficialización y el hash del archivo. La
+carga del IF/PDF oficial no se interpreta por sí sola como notificación a la
+empresa ni inicia plazos que dependan de una notificación posterior.
 
-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.
+## Plantillas PDF provisionales
+
+Hasta recibir los formularios oficiales, la implementación se divide en dos capas:
+
+1. **Contrato de datos estable.** Define qué información debe estar disponible para
+   Actas e Informes, de dónde proviene, qué versión se congela y qué hashes prueban
+   su integridad.
+2. **Renderer reemplazable.** Encabezado, logos, tipografías, márgenes, cuadros,
+   orden visual, QR y anexos podrán adaptarse al modelo institucional definitivo
+   sin modificar el dominio ni volver a diseñar el circuito documental.
+
+El dashboard muestra una sección **PDF preliminar · estructura proyectada** tanto
+en la ficha del Acta como en la del Informe. Esa sección no pretende reemplazar el
+formulario oficial: sirve para comprobar ahora que el sistema está capturando toda
+la información que después deberá volcarse al documento.
+
+La especificación detallada se mantiene en `docs/PDF_PROVISIONAL_STRUCTURE.md`.