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,47 @@
+# D5.3.16 · Planificación de verificaciones
+
+## Objetivo
+
+Transformar la segunda fecha del seguimiento de un hallazgo en trabajo operativo planificable desde oficina, sin confundirla con el vencimiento administrativo de respuesta de la empresa.
+
+## Regla funcional
+
+- `correction_due_on`: vencimiento administrativo para recibir la respuesta de la empresa.
+- `next_control_on`: fecha objetivo para verificar en campo la resolución del hallazgo.
+- Una verificación sólo entra en la bandeja operativa cuando el hallazgo sigue abierto, la empresa ya respondió y `next_control_on` está definido.
+- La planificación no modifica ninguna de esas fechas.
+
+## Bandeja de planificación
+
+Ruta: `/hallazgos/planificacion`.
+
+La pantalla separa:
+
+- hallazgos verificables sin visita;
+- verificaciones vencidas sin planificar;
+- verificaciones próximas;
+- hallazgos que ya tienen una visita activa asociada.
+
+Los hallazgos se seleccionan por empresa y área. No se permite mezclar contextos operativos distintos dentro de una misma visita.
+
+## Creación de visita
+
+La acción de oficina crea una visita de verificación en estado `DRAFT` con:
+
+- área como alcance principal;
+- elementos del Inventario afectados;
+- fecha y hora previstas;
+- referencias explícitas a los hallazgos;
+- trazabilidad entre hallazgo y visita.
+
+La visita se completa después con inspector y equipo y se marca `PLANNED` usando el flujo existente de Inspecciones.
+
+## Trazabilidad
+
+La tabla `inspection_finding_verification_visits` conserva el vínculo histórico entre hallazgo y visita. Un hallazgo no puede incorporarse simultáneamente a dos visitas activas (`DRAFT`, `PLANNED` o `IN_PROGRESS`). Si una visita se cancela o termina y el hallazgo continúa abierto, puede planificarse una nueva verificación sin perder el vínculo anterior.
+
+## Permisos
+
+`inspection_verifications.plan` se asigna inicialmente a admin, director y supervisor.
+
+La consulta de la bandeja conserva `inspection_findings.read`.