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,78 @@
+# Fase D3 — Hallazgos y seguimiento
+
+Versión: `0.17.0`
+
+## Objetivo
+
+Permitir que el acta única de una visita contenga múltiples hallazgos y que
+cada hallazgo permanezca abierto después de recibir la respuesta de la empresa,
+hasta que el organismo verifique efectivamente la corrección.
+
+## Catálogo importado
+
+La fuente es `Lista de hallazgos (1).xlsx`, con SHA-256
+`a49e5d8627b3d43490b43b90d4a7efde6fd88f76cdc1c29fbb8906012e13587d`.
+
+La importación contiene:
+
+- 19 categorías;
+- 170 modelos de hallazgo;
+- descripción, normativa y glosario cuando la planilla los informa;
+- códigos estables por categoría y número de origen;
+- revisión e indicador de actividad para administración futura.
+
+La celda correspondiente a `BOMBAS-003` contenía solamente el número `4` en la
+columna del título. Se normalizó como `PUESTA A TIERRA` por la normativa de la
+misma fila y su repetición exacta en la categoría Defensa contra incendios. La
+corrección queda registrada en `import_note`.
+
+## Ciclo operativo
+
+1. El inspector selecciona un modelo del catálogo o crea uno personalizado.
+2. Vincula el hallazgo con un activo incluido en el acta.
+3. Registra la descripción concreta y, si corresponde, el plazo exigido.
+4. El hallazgo nace con estado `OPEN`.
+5. Después de notificar a la empresa, se registra su respuesta y fecha.
+6. Se registra por separado la fecha en que la empresa promete corregir.
+7. El organismo define la fecha del próximo control.
+8. La respuesta no cierra el hallazgo.
+9. Una fase posterior permitirá cerrarlo únicamente después de verificar la
+   corrección en campo o mediante el procedimiento autorizado.
+
+## Fechas separadas
+
+- `correction_due_on`: plazo exigido por el organismo;
+- `company_response_received_on`: recepción de la respuesta empresarial;
+- `company_committed_correction_on`: compromiso declarado por la empresa;
+- `next_control_on`: fecha programada por el organismo para volver a controlar.
+
+Estas fechas no se reemplazan entre sí. El dashboard usa `next_control_on` para
+detectar controles vencidos y los próximos 30 días.
+
+## Integridad y trazabilidad
+
+- todo hallazgo referencia un activo incluido en el acta;
+- el contenido del catálogo se copia al hallazgo como snapshot;
+- cada alta, edición y seguimiento genera una versión inmutable;
+- la API runtime no puede borrar hallazgos ni versiones;
+- los cambios generan auditoría;
+- editar el contenido requiere acta en borrador, visita en curso y asignación;
+- registrar seguimiento requiere permiso específico y puede continuar después
+  del cierre documental del acta;
+- sólo los estados futuros de verificación podrán pasar un hallazgo a cerrado.
+
+## Dashboard
+
+El panel muestra:
+
+- hallazgos abiertos;
+- hallazgos todavía sin respuesta empresarial;
+- controles cuya fecha ya venció;
+- controles programados en los próximos 30 días;
+- agenda de los ocho próximos controles con acceso al acta correspondiente.
+
+## Límites de D3
+
+D3 no cierra hallazgos, actas ni visitas. Tampoco adjunta todavía el PDF de la
+respuesta empresarial. D4 agregará fotografías, GPS y documentos protegidos,
+incluido ese PDF. D5 implementará responsables, cierre y firmas.