chore: import DH V2 D5.6.4 production baseline

2026-09-05 10:12:35 -03:00
commit 82213e72f5
757 changed files with 84218 additions and 0 deletions
@@ -0,0 +1,40 @@
+# Fase D2.1 — Un acta por visita
+
+Versión: `0.16.1`
+
+## Corrección conceptual
+
+El dominio queda definido así:
+
+1. una inspección es una visita;
+2. cada visita genera una única acta;
+3. el acta contiene múltiples hallazgos;
+4. cada hallazgo puede vincular activos, normativa y evidencias;
+5. al finalizar la visita, el acta se cierra, se firma y se distribuye;
+6. después se genera un informe técnico que incorpora el acta y todos sus
+   hallazgos.
+
+El Informe Técnico Nº 124/2026 y su Acta Nº 105/2026 se usaron como referencia
+funcional. La planilla de hallazgos se interpreta como catálogo configurable de
+hallazgos por tipo de equipo y normativa, no como texto fijo de la interfaz.
+
+## Alcance de D2.1
+
+- agrega una restricción única sobre `inspection_acts.visit_id`;
+- bloquea en la API un segundo intento de creación con código
+  `INSPECTION_VISIT_ACT_ALREADY_EXISTS`;
+- adapta la interfaz y el footer al concepto de acta única;
+- mantiene numeración anual global, versiones, activos y auditoría de D2;
+- no elimina ni transforma actas existentes.
+
+Antes de crear la restricción, la migración verifica que no existan visitas con
+más de un acta. Si encuentra alguna, falla de forma segura y no modifica los
+datos para que la situación se resuelva explícitamente.
+
+## Próximas fases
+
+D3 incorporará múltiples hallazgos dentro del acta y el catálogo configurable
+derivado de la planilla entregada. Más adelante se implementarán cierre,
+firmas de inspectores y responsable de empresa, PDF verificable, envío al
+responsable y al correo interno configurable de Hidrocarburos, y el informe
+técnico con numeración anual propia.