dh-inspeccion-v2/docs/PDF_PROVISIONAL_STRUCTURE.md

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.