43 lines
1.5 KiB
Markdown
43 lines
1.5 KiB
Markdown
# Fase D5.2 — Catálogo administrable de hallazgos
|
|
|
|
Versión: `0.19.2`
|
|
|
|
## Objetivo
|
|
|
|
El dashboard permite administrar las categorías y los tipos de hallazgo que
|
|
consume la APK durante una inspección. Esta configuración no habilita crear
|
|
visitas operativas, actas, hallazgos ni informes desde la web.
|
|
|
|
## Alcance funcional
|
|
|
|
- listado completo de categorías y tipos activos e inactivos;
|
|
- alta y edición de categorías, con orden y estado;
|
|
- alta y edición de tipos, con número, título, fundamento legal, glosario y
|
|
nota de origen;
|
|
- búsqueda y conteo de uso en hallazgos reales;
|
|
- desactivación sin borrado físico;
|
|
- permisos `finding_catalog.manage` para admin y supervisor.
|
|
|
|
Los inspectores siguen siendo los únicos que pueden registrar hallazgos,
|
|
crear el acta y solicitar el informe desde la APK. El dashboard configura el
|
|
catálogo y consulta o gestiona el seguimiento posterior.
|
|
|
|
## Integridad histórica
|
|
|
|
Cada tipo comienza en revisión 1. Una edición incrementa la revisión y crea un
|
|
snapshot en `finding_catalog_item_versions`. La tabla es append-only para el
|
|
usuario de runtime: puede leer e insertar, pero no actualizar ni borrar.
|
|
|
|
Los hallazgos ya existentes conservan el título, fundamento, glosario y
|
|
revisión que fueron copiados al momento de la inspección. Cambiar el catálogo
|
|
no altera un acta cerrada ni un informe histórico.
|
|
|
|
## Auditoría
|
|
|
|
Se registran altas y cambios de categorías y tipos mediante:
|
|
|
|
- `FINDING_CATEGORY_CREATED`;
|
|
- `FINDING_CATEGORY_UPDATED`;
|
|
- `FINDING_CATALOG_ITEM_CREATED`;
|
|
- `FINDING_CATALOG_ITEM_UPDATED`.
|