68 lines
2.1 KiB
Markdown
68 lines
2.1 KiB
Markdown
# 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.
|