dh-inspeccion-v2/docs/PHASE_D3.md

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.