Files
dh-inspeccion-v2/docs/PHASE_D5_3_15_1.md
T

57 lines
2.3 KiB
Markdown

# D5.3.15.1 · Centro documental
## Objetivo
Concentrar la consulta de actas e informes de inspección sin duplicar el contenido operativo que ya existe en visitas, hallazgos e Inventarios.
## Actas
El dashboard incorpora una vista global de actas con búsqueda y filtros por estado y año. Cada fila mantiene acceso directo a la inspección, los hallazgos y el informe relacionado cuando exista.
La API incorpora `GET /inspection-acts` para consulta paginada global. El endpoint por visita permanece disponible y conserva su comportamiento.
## Informes
Se incorpora el registro `inspection_reports` con numeración anual independiente mediante la secuencia `REPORT` ya prevista en el modelo documental.
Un informe sólo puede solicitarse sobre un acta cerrada. La solicitud se realiza mediante una operación autenticada de inspector desde la aplicación de campo. El backend:
- valida que el acta esté cerrada y sellada;
- valida que el inspector esté asignado a la visita;
- asigna un número anual global de informe;
- congela la instantánea final del cierre del acta;
- conserva versión del acta y hashes de integridad;
- deja la composición PDF en estado pendiente para la etapa documental posterior.
El dashboard no numera ni genera informes manualmente. Muestra dos vistas: informes emitidos y actas cerradas pendientes de emisión.
## Navegación
Se agregan accesos globales:
- `/actas`
- `/informes`
- `/informes/:id`
Desde estas vistas se puede navegar a la inspección, acta y hallazgos relacionados.
## Seguridad
Permisos incorporados:
- `inspection_reports.read`
- `inspection_reports.generate`
La lectura se concede a perfiles de consulta operativa. La generación queda reservada al inspector y además requiere autenticación de campo mediante la política móvil existente.
El contenido congelado del informe está protegido a nivel de base de datos. La tabla no admite eliminación mediante el rol de aplicación y un trigger impide alterar la identidad, numeración, snapshot y hashes una vez emitidos.
## Base de datos
La fase incorpora una migración para crear `inspection_reports`, permisos, índices y protección de inmutabilidad.
## Corrección 15.1
Ajuste de tipado estricto en los rótulos de contexto de las bandejas globales de Actas e Informes. No modifica el modelo documental ni la migración de D5.3.15.