# 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.