125 lines
5.9 KiB
Markdown
125 lines
5.9 KiB
Markdown
# 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:
|
|
|
|
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`.
|