dh-inspeccion-v2/docs/PHASE_D5_3_22.md

Fase D5.3.22 · Revisión directiva de Informes

D5.3.22 incorpora el circuito posterior a la generación automática del Informe Word.

Flujo

1. El cierre del Acta conserva la generación automática del Informe y del Word inicial.
2. El Word automático pasa a ser la Versión 1 del Informe.
3. El Director puede descargarlo, revisarlo en Word y cargar una nueva versión corregida con un resumen obligatorio de cambios.
4. Cada corrección crea una revisión nueva e inmutable. Nunca reemplaza ni borra una versión anterior.
5. El Director aprueba explícitamente la versión vigente.
6. Sólo después de esa aprobación puede registrar la firma electrónica final.
7. La firma final vincula el Informe congelado, la revisión aprobada, ambos hashes, el usuario Director y la fecha de firma.
8. Después de la firma no se admiten nuevas revisiones.

Permisos

• inspection_reports.revise: cargar versiones corregidas.
• inspection_reports.review: aprobar la versión vigente.
• inspection_reports.sign_final: firma electrónica final.

Los tres permisos se asignan inicialmente únicamente al rol director. El backend además exige que el usuario tenga efectivamente el rol Director para revisar, aprobar o firmar.

Integridad documental

La revisión no modifica el Acta, los Hallazgos ni el frozen_snapshot del Informe. La Versión 1 automática se conserva. Las versiones corregidas se almacenan como documentos DOCX separados, con número, autor, fecha, resumen de cambios, tamaño y SHA-256.

Los DOCX cargados tienen un límite de 15 MB, deben contener la estructura mínima OOXML y no pueden contener macros VBA ni objetos embebidos.

Firma

La fase implementa una firma electrónica de aprobación trazable y exclusiva del Director. Se almacena un payload canónico con el hash del Informe y el hash de la revisión aprobada, y se calcula un SHA-256 de firma.

La ubicación visual de una rúbrica o sello dentro del documento final no se fija todavía porque la plantilla institucional definitiva continúa pendiente de definición.

Correo

D5.3.22 no exige SMTP y no modifica el alcance de D5.3.21.1. El envío inicial del Word al Director permanece preparado pero puede seguir en estado pendiente mientras no exista una cuenta institucional definida.