4.1 KiB
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.
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 |
| 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í |
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.
Cardinalidades
| Origen | Relación | Destino |
|---|---|---|
| Inspección o visita | 1 a 1 | Acta 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 |
| 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 digital
El acta debe 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;
- 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.
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.
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.
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, 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 informe se genera después del cierre del acta, con numeración anual global independiente. Siguiendo el modelo entregado, contempla:
- título, número, acta referenciada, empresa, área/yacimiento y autores;
- objetivos;
- 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.
El informe congela las versiones exactas del acta, hallazgos, activos, evidencias y normativa que incorpora.
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.