docs: align document model with multi-Act inspections and provisional PDFs
This commit is contained in:
@@ -1,96 +1,124 @@
|
|||||||
# Modelo documental de inspecciones
|
# Modelo documental de inspecciones
|
||||||
|
|
||||||
Este documento fija el modelo funcional validado a partir del Informe Técnico
|
Este documento fija el modelo funcional vigente para Inspecciones, Actas,
|
||||||
Nº 124/2026, el acta manuscrita adjunta y la planilla de hallazgos entregada.
|
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
|
## Canales de operación
|
||||||
|
|
||||||
| Función | APK móvil | Dashboard web |
|
| Función | APK móvil | Dashboard web |
|
||||||
|---|---:|---:|
|
|---|---:|---:|
|
||||||
| Planificar visita, activos y equipo | Consulta | Administra |
|
| Planificar Inspección, alcance y equipo | Consulta | Administra |
|
||||||
| Administrar activos y catálogo de hallazgos | Consulta | Administra |
|
| Administrar Inventarios y catálogo de Hallazgos | Consulta | Administra |
|
||||||
| Iniciar y ejecutar la visita | Inspector | No |
|
| Iniciar y ejecutar la Inspección | Inspector | No |
|
||||||
| Crear o modificar el acta y sus hallazgos | Inspector | Sólo consulta |
|
| Crear Actas y registrar Hallazgos de campo | Inspector | Sólo consulta |
|
||||||
| Incorporar evidencia de campo y GPS | Inspector | Sólo consulta |
|
| Incorporar evidencia de campo y GPS | Inspector | Sólo consulta |
|
||||||
| Identificar responsable, firmar y cerrar | Inspector | Sólo consulta |
|
| Identificar responsable, firmar y sellar Acta | Inspector | Sólo consulta |
|
||||||
| Registrar respuesta empresarial, PDF y próximo control | Consulta | Administra |
|
| Preparar y revisar el INF | Consulta | Administra |
|
||||||
| Consultar acta, hallazgos e informe sincronizados | Sí | Sí |
|
| 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
|
La API aplica esta separación además de la interfaz. Las escrituras operativas de
|
||||||
requieren autenticación bearer de la aplicación móvil y el rol `inspector`.
|
campo se realizan desde la aplicación móvil con las autorizaciones correspondientes;
|
||||||
Una sesión web no puede eludir la restricción llamando directamente al endpoint.
|
el dashboard administra planificación, consulta y circuito documental posterior.
|
||||||
|
|
||||||
## Cardinalidades
|
## Cardinalidades vigentes
|
||||||
|
|
||||||
| Origen | Relación | Destino |
|
| 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 |
|
| Acta | 1 a muchos | Hallazgos |
|
||||||
| Hallazgo | muchos a 1 | Activo o equipo del Maestro |
|
| Hallazgo | muchos a 1 | Elemento de Inventario |
|
||||||
| Hallazgo | muchos a 1 | Ítem del catálogo configurable |
|
| Hallazgo | muchos a 1 | Ítem del catálogo configurable, o propuesta OTROS |
|
||||||
| Hallazgo | 1 a muchos | Evidencias, principalmente fotografías |
|
| Hallazgo | 1 a muchos | Evidencias y seguimientos |
|
||||||
| Acta | 1 a muchos | Firmas de inspectores |
|
| Acta | 1 a muchos | Firmas de inspectores |
|
||||||
| Acta | 1 a 1 | Firma del responsable que atendió la visita |
|
| Acta | 0 o 1 | Firma/manifestación del responsable de empresa |
|
||||||
| Inspección o visita | 1 a 1 | Informe técnico |
|
| Acta sellada | 0 o 1 | Informe técnico (INF) |
|
||||||
| Informe técnico | incorpora | Acta, hallazgos y evidencias congelados |
|
| 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
|
## 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;
|
- número y año oficial del Acta;
|
||||||
- empresa, área, yacimiento o instalación inspeccionada;
|
- Inspección vinculada, fecha y hora;
|
||||||
- objeto y resultado de la inspección;
|
- Departamento, Área, Yacimiento, Operadora y ubicación de la actuación;
|
||||||
- todos los hallazgos de la visita y sus plazos de correcció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;
|
- inspectores intervinientes;
|
||||||
- identidad, DNI, cargo y correo del responsable de la empresa que recibió al
|
- identidad, DNI, cargo y correo del responsable de la empresa que recibió al
|
||||||
equipo;
|
equipo, cuando corresponda;
|
||||||
- firmas manuscritas capturadas en pantalla de inspectores y responsable;
|
- firma de inspectores y manifestación/firma del responsable de empresa, incluida
|
||||||
- versión inmutable, hash, sello de tiempo y token de verificación.
|
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
|
Al sellarse, el Acta queda inmutable. Los cambios posteriores pertenecen al
|
||||||
PDF verificable y se envía al correo del responsable de la empresa y a una
|
seguimiento y no reescriben el contenido constatado. El sistema conserva la
|
||||||
dirección interna de Hidrocarburos definida por configuración. Cada intento y
|
instantánea y hashes necesarios para que el PDF se pueda regenerar o sustituir su
|
||||||
resultado de entrega debe quedar auditado.
|
renderer sin alterar la evidencia fuente.
|
||||||
|
|
||||||
Si se requiere corregir un acta cerrada, se emitirá una rectificativa vinculada
|
|
||||||
sin reemplazar ni borrar el documento original.
|
|
||||||
|
|
||||||
## Hallazgos
|
## Hallazgos
|
||||||
|
|
||||||
La planilla entregada contiene 170 modelos de hallazgo agrupados en 19
|
El catálogo de Hallazgos es administrable, importable y versionado. Cada Hallazgo
|
||||||
categorías de equipos, con descripción, normativa y glosario. Se implementará
|
operativo conserva una instantánea de su descripción y base legal para que cambios
|
||||||
como catálogo administrable, importable y versionado. No se copiarán esas
|
posteriores del catálogo no modifiquen documentos ya emitidos.
|
||||||
opciones como constantes en la interfaz.
|
|
||||||
|
|
||||||
Cada hallazgo operativo conservará una instantánea de su descripción y base
|
Cada Hallazgo nace abierto. Se distinguen el plazo exigido, la respuesta y fecha
|
||||||
legal para que posteriores cambios del catálogo no alteren documentos ya
|
comprometida por la empresa, la fecha de próximo control y las verificaciones
|
||||||
emitidos. También podrá registrar estado, observación específica, activo,
|
posteriores. La respuesta empresarial no cierra por sí sola un Hallazgo: el cierre
|
||||||
ubicación/GPS, plazo y evidencias.
|
surge del flujo de verificación autorizado.
|
||||||
|
|
||||||
Cada hallazgo nace abierto. Se distinguen el plazo exigido, la respuesta y
|
## Informe técnico (INF)
|
||||||
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 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
|
El contrato proyectado del Informe contempla:
|
||||||
independiente. Siguiendo el modelo entregado, contempla:
|
|
||||||
|
|
||||||
- título, número, acta referenciada, empresa, área/yacimiento y autores;
|
- número/año del INF y Acta referenciada;
|
||||||
- objetivos;
|
- Inspección, Empresa, Departamento, Área, Yacimiento y autores;
|
||||||
- antecedentes;
|
- objetivos y antecedentes;
|
||||||
- marco legal;
|
- marco legal;
|
||||||
- resumen ejecutivo;
|
- resumen ejecutivo;
|
||||||
- descripción de la inspección y de todos los hallazgos;
|
- descripción y análisis técnico de la inspección;
|
||||||
- registro fotográfico;
|
- Inventarios inspeccionados;
|
||||||
- conclusión;
|
- detalle de los Hallazgos, reincidencias, gravedad y plazos;
|
||||||
- acta digital completa como anexo final.
|
- 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,
|
Cuando GEDO devuelve el identificador IF y su PDF oficial, ambos se registran de
|
||||||
evidencias y normativa que incorpora.
|
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
|
## Plantillas PDF provisionales
|
||||||
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.
|
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`.
|
||||||
|
|||||||
Reference in New Issue
Block a user