chore: import DH V2 D5.6.4 production baseline

2026-09-05 10:12:35 -03:00
commit 82213e72f5
757 changed files with 84218 additions and 0 deletions
@@ -0,0 +1,67 @@
+# 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.