# 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.