Files
dh-inspeccion-v2/docs/PHASE_D5_2.md

1.5 KiB

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.