79 lines
3.1 KiB
Markdown
79 lines
3.1 KiB
Markdown
# 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.
|