2.7 KiB
Fase C2 — Ejecución y validación de relevamientos
Versión: 0.14.0
Objetivo
Ejecutar en campo los objetivos planificados en C1 y consolidar su resultado en el único Maestro de Activos. C2 no crea una segunda ficha ni un inventario paralelo: el informe referencia al objetivo y al activo originales.
Flujo operativo
- El responsable inicia un objetivo asignado.
- Guarda un borrador con resultado, fecha observada, GPS, precisión, notas y fotografías protegidas.
- Si detecta diferencias, actualiza el activo original desde el Maestro.
- Envía el informe. C2 actualiza la procedencia del activo, crea una versión de activo y congela una versión inmutable del informe con los hashes de evidencia.
- Un revisor aprueba o rechaza. La aprobación sólo continúa si el activo conserva exactamente la versión enviada.
- Al aprobar, el activo queda validado y el objetivo completado. Al rechazar, vuelve a ejecución con el motivo registrado.
Los resultados admitidos son activo confirmado, cambios registrados y no localizado. GPS con precisión y al menos una fotografía son obligatorios para el envío. Cambios registrados y no localizado requieren una explicación.
Inmutabilidad y Maestro único
survey_target_reportsconserva el estado actual del informe;survey_target_report_mediavincula evidencia existente del activo;survey_target_report_versionsconserva cada envío y decisión como JSON inmutable, incluyendo identificación, versión del activo y hash SHA-256 de cada evidencia;- las tres tablas revocan
DELETEal usuario runtime; - las versiones congeladas revocan también
UPDATE; - el envío actualiza procedencia y estado del activo original mediante el historial ya existente del Maestro.
Un informe enviado no puede editarse. Las correcciones requieren rechazo, nuevo borrador y un nuevo envío; las versiones anteriores permanecen disponibles.
Permisos
surveys.read_reports: admin, director, supervisor, inspector y auditor;surveys.capture: admin, supervisor e inspector;surveys.review: admin, director y supervisor.
Además se conservan los permisos de C1 para planificación y avance y los de B4 para cargar fotografías protegidas.
API e interfaz
Rutas nuevas:
GET|PUT /api/v3/survey-campaign-targets/:targetId/report;POST /api/v3/survey-campaign-targets/:targetId/report/submit;POST /api/v3/survey-campaign-targets/:targetId/report/review.
La pantalla de campaña abre cada objetivo en una vista de ejecución con captura GPS, carga y selección de evidencia, envío, control de calidad y consulta de todas las versiones inmutables.
Las inspecciones, visitas, actas y hallazgos continúan siendo un dominio separado para una fase posterior.