2.1 KiB
Fase C1 — Planificación de relevamientos
Versión: 0.13.0
Objetivo
Iniciar el ciclo operativo de relevamiento planificando trabajo sobre el único Maestro de Activos. La fase no crea inventarios ni copias paralelas.
Campañas
Cada campaña define código, nombre, descripción, fechas previstas, coordinación y un alcance opcional. El alcance referencia cualquier activo del árbol configurable y comprende ese activo y sus descendientes, sin niveles fijos.
Estados controlados:
- borrador;
- planificada;
- en curso;
- completada;
- cancelada.
Una campaña sólo puede iniciarse si contiene objetivos. Sólo puede completarse cuando todos están completados u omitidos. Completadas y canceladas quedan cerradas.
Objetivos
Cada objetivo referencia exactamente un activo existente y registra responsable, vencimiento, instrucciones y avance. La restricción campaña-activo impide duplicados. Si existe alcance, la API verifica la jerarquía antes de agregar el activo.
Los inspectores sólo pueden avanzar objetivos que tengan asignados. La base no
concede DELETE al usuario runtime: la omisión es un estado trazable, no un
borrado físico.
Permisos
surveys.read: admin, director, supervisor, inspector y auditor;surveys.manage: admin y supervisor;surveys.assign: admin y supervisor;surveys.execute: admin, supervisor e inspector.
Auditoría
Se registran creación, actualización y cambio de estado de campañas, además de alta, actualización, asignación y cambio de avance de objetivos.
Interfaz y API
La sección Relevamientos incluye listado, filtros, alta, edición, flujo de estados, incorporación de activos existentes, asignaciones y avance.
Rutas principales:
GET|POST /api/v3/survey-campaigns;GET|PATCH /api/v3/survey-campaigns/:id;PUT /api/v3/survey-campaigns/:id/status;POST /api/v3/survey-campaigns/:id/targets;PATCH /api/v3/survey-campaign-targets/:id;PUT /api/v3/survey-campaign-targets/:id/assignment;PUT /api/v3/survey-campaign-targets/:id/status.
La captura de datos de campo y la consolidación de relevamientos continúan en las fases siguientes.