5.9 KiB
Modelo documental de inspecciones
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 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 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 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 vigentes
| Origen | Relación | Destino |
|---|---|---|
| Inspección o visita | 1 a muchos | Actas de inspección |
| Acta | 1 a muchos | Hallazgos |
| 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 | 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 poder reunir como mínimo:
- 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, 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 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
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 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.
Informe técnico (INF)
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 contrato proyectado del Informe contempla:
- 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 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.
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.
Plantillas PDF provisionales
Hasta recibir los formularios oficiales, la implementación se divide en dos capas:
- 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.
- 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.