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