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

2.3 KiB

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.