# 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`.