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,42 @@
+# 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`.