docs: define provisional PDF contract for Actas and INF
This commit is contained in:
@@ -0,0 +1,184 @@
|
|||||||
|
# Estructura provisional de PDFs · PREVIEW-1
|
||||||
|
|
||||||
|
Estado: **provisional hasta recepción de formularios oficiales**.
|
||||||
|
|
||||||
|
El objetivo de este documento no es fijar todavía la estética institucional. Fija
|
||||||
|
el conjunto de datos que DH Inspección debe ser capaz de colocar en los PDFs de
|
||||||
|
Actas e Informes y separa ese contrato del renderer visual.
|
||||||
|
|
||||||
|
## Principio de implementación
|
||||||
|
|
||||||
|
El dominio documental no debe depender de coordenadas, cuadros o textos impresos
|
||||||
|
de una plantilla determinada. Los datos se congelan primero en snapshots
|
||||||
|
versionados; luego un renderer transforma esa fuente a PDF. Cuando llegue el
|
||||||
|
formulario oficial se reemplaza o adapta el renderer, no la lógica de negocio.
|
||||||
|
|
||||||
|
Se consideran **estables**: identidad del documento, vínculos entre entidades,
|
||||||
|
contenido constatado, Hallazgos, firmas/manifestaciones, fechas, versiones, hashes
|
||||||
|
y trazabilidad. Se consideran **reemplazables**: logo, membrete, encabezado,
|
||||||
|
footer, tipografía, colores, tamaños, posiciones, cantidad de columnas, QR y forma
|
||||||
|
de los anexos.
|
||||||
|
|
||||||
|
## PDF de Acta
|
||||||
|
|
||||||
|
### 1. Cabecera institucional
|
||||||
|
|
||||||
|
Pendiente de modelo oficial. Debe reservar espacio para organismo, dependencia,
|
||||||
|
logo/membrete, denominación del documento y numeración.
|
||||||
|
|
||||||
|
### 2. Identificación
|
||||||
|
|
||||||
|
- número y año del Acta;
|
||||||
|
- código interno;
|
||||||
|
- código de Inspección/visita;
|
||||||
|
- fecha y hora de actuación;
|
||||||
|
- estado documental y versión.
|
||||||
|
|
||||||
|
### 3. Contexto territorial y operativo
|
||||||
|
|
||||||
|
- Departamento;
|
||||||
|
- Área;
|
||||||
|
- Yacimiento;
|
||||||
|
- Empresa/Operadora vigente;
|
||||||
|
- ubicación/GPS cuando corresponda;
|
||||||
|
- Instalación y Subinstalación relacionadas cuando el Acta tenga ese alcance.
|
||||||
|
|
||||||
|
### 4. Personas intervinientes
|
||||||
|
|
||||||
|
- Inspectores actuantes;
|
||||||
|
- responsable de la empresa;
|
||||||
|
- DNI/identificación;
|
||||||
|
- cargo o función;
|
||||||
|
- correo/dato de contacto que exija el formulario.
|
||||||
|
|
||||||
|
### 5. Objeto y descripción de lo actuado
|
||||||
|
|
||||||
|
- objeto o motivo;
|
||||||
|
- resumen/constatación;
|
||||||
|
- observaciones;
|
||||||
|
- Inventarios inspeccionados con código, nombre, tipo y ruta jerárquica.
|
||||||
|
|
||||||
|
### 6. Hallazgos
|
||||||
|
|
||||||
|
Por cada Hallazgo:
|
||||||
|
|
||||||
|
- código;
|
||||||
|
- Inventario asociado;
|
||||||
|
- ítem de catálogo u origen OTROS;
|
||||||
|
- título/denominación;
|
||||||
|
- descripción constatada;
|
||||||
|
- base legal congelada;
|
||||||
|
- reincidencia y referencia al antecedente, si existe;
|
||||||
|
- gravedad cuando aplique;
|
||||||
|
- plazo y tipo de días cuando corresponda;
|
||||||
|
- referencias a evidencia.
|
||||||
|
|
||||||
|
### 7. Firmas y manifestaciones
|
||||||
|
|
||||||
|
- firma de cada Inspector interviniente;
|
||||||
|
- firma/manifestación del responsable de empresa;
|
||||||
|
- conformidad o disidencia;
|
||||||
|
- texto de disidencia;
|
||||||
|
- negativa o ausencia con motivo cuando aplique;
|
||||||
|
- fecha/hora de cada constancia.
|
||||||
|
|
||||||
|
### 8. Integridad
|
||||||
|
|
||||||
|
- hash del contenido bloqueado;
|
||||||
|
- hash final del Acta sellada;
|
||||||
|
- sello de tiempo;
|
||||||
|
- versión del esquema;
|
||||||
|
- espacio para token/QR de verificación si el modelo institucional lo utiliza.
|
||||||
|
|
||||||
|
### 9. Anexo de evidencias
|
||||||
|
|
||||||
|
El sistema debe estar preparado para incorporar fotografías/evidencias, pero su
|
||||||
|
inclusión dentro del PDF principal queda pendiente de la plantilla oficial.
|
||||||
|
|
||||||
|
## Informe técnico · INF
|
||||||
|
|
||||||
|
Cada INF tiene **una sola Acta fuente**. Una Inspección puede contener múltiples
|
||||||
|
Actas y, por lo tanto, múltiples INF independientes.
|
||||||
|
|
||||||
|
### 1. Cabecera e identificación
|
||||||
|
|
||||||
|
- número/año y código del INF;
|
||||||
|
- Acta fuente;
|
||||||
|
- Inspección;
|
||||||
|
- fecha de generación;
|
||||||
|
- autores/Inspector responsable;
|
||||||
|
- Empresa/Operadora;
|
||||||
|
- Departamento, Área y Yacimiento.
|
||||||
|
|
||||||
|
### 2. Objetivos
|
||||||
|
|
||||||
|
Texto editable durante la preparación, si la plantilla oficial lo requiere como
|
||||||
|
campo separado.
|
||||||
|
|
||||||
|
### 3. Antecedentes
|
||||||
|
|
||||||
|
Antecedentes relevantes para comprender la inspección y el contexto técnico.
|
||||||
|
|
||||||
|
### 4. Marco legal
|
||||||
|
|
||||||
|
Normativa aplicable y bases legales congeladas con los Hallazgos del Acta fuente.
|
||||||
|
|
||||||
|
### 5. Resumen ejecutivo
|
||||||
|
|
||||||
|
Campo narrativo editable en estado de preparación.
|
||||||
|
|
||||||
|
### 6. Descripción y análisis técnico
|
||||||
|
|
||||||
|
Desarrollo técnico editable que no modifica el contenido del Acta ni de sus
|
||||||
|
Hallazgos.
|
||||||
|
|
||||||
|
### 7. Inventarios inspeccionados
|
||||||
|
|
||||||
|
Tabla o listado con código, nombre, tipo y ruta territorial/técnica.
|
||||||
|
|
||||||
|
### 8. Hallazgos
|
||||||
|
|
||||||
|
Detalle de los Hallazgos del Acta fuente, con descripción, base legal,
|
||||||
|
reincidencia, gravedad, plazos y vínculo con el Inventario.
|
||||||
|
|
||||||
|
### 9. Registro fotográfico
|
||||||
|
|
||||||
|
Fotografías/evidencias seleccionadas, identificando Hallazgo/Inventario, fecha y
|
||||||
|
metadatos disponibles. La maquetación se definirá con el modelo oficial.
|
||||||
|
|
||||||
|
### 10. Conclusiones y recomendaciones
|
||||||
|
|
||||||
|
Bloque técnico editable durante la preparación del INF.
|
||||||
|
|
||||||
|
### 11. GEDO
|
||||||
|
|
||||||
|
Al oficializar:
|
||||||
|
|
||||||
|
- identificador IF;
|
||||||
|
- fecha/hora de oficialización;
|
||||||
|
- nombre del PDF oficial;
|
||||||
|
- SHA-256 del PDF oficial.
|
||||||
|
|
||||||
|
La oficialización no equivale automáticamente a notificación a la empresa.
|
||||||
|
|
||||||
|
### 12. Integridad y anexo
|
||||||
|
|
||||||
|
- hash del snapshot fuente del INF;
|
||||||
|
- hash del cierre del Acta;
|
||||||
|
- versión de Acta utilizada;
|
||||||
|
- Acta fuente completa como anexo final.
|
||||||
|
|
||||||
|
## Reemplazo por la plantilla oficial
|
||||||
|
|
||||||
|
Cuando se reciba el Acta o Informe oficial en PDF/Word se deberá:
|
||||||
|
|
||||||
|
1. inventariar cada campo del formulario;
|
||||||
|
2. mapearlo contra este contrato;
|
||||||
|
3. identificar únicamente los datos faltantes;
|
||||||
|
4. añadir esos datos al dominio sólo si son información real y no mero diseño;
|
||||||
|
5. construir el renderer definitivo;
|
||||||
|
6. comparar visualmente una muestra contra el original;
|
||||||
|
7. conservar el renderer PREVIEW-1 sólo para pruebas históricas si resultara útil.
|
||||||
|
|
||||||
|
No se deben alterar Actas ya selladas para acomodar una nueva plantilla. Los
|
||||||
|
nuevos renderers deben poder representar snapshots históricos de forma trazable.
|
||||||
Reference in New Issue
Block a user