From 324a73d35cfe4ac81a628c4c6855922480a9db8c Mon Sep 17 00:00:00 2001 From: enlineawork Date: Thu, 10 Sep 2026 20:20:33 -0300 Subject: [PATCH] docs: define provisional PDF contract for Actas and INF --- docs/PDF_PROVISIONAL_STRUCTURE.md | 184 ++++++++++++++++++++++++++++++ 1 file changed, 184 insertions(+) create mode 100644 docs/PDF_PROVISIONAL_STRUCTURE.md diff --git a/docs/PDF_PROVISIONAL_STRUCTURE.md b/docs/PDF_PROVISIONAL_STRUCTURE.md new file mode 100644 index 0000000..de18b48 --- /dev/null +++ b/docs/PDF_PROVISIONAL_STRUCTURE.md @@ -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.