diff --git a/docs/INSPECTION_DOCUMENT_MODEL.md b/docs/INSPECTION_DOCUMENT_MODEL.md index 98789a2..4ea51c8 100644 --- a/docs/INSPECTION_DOCUMENT_MODEL.md +++ b/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`.