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,64 @@
+# Fase B5 — Procedencia de datos y consulta temporal
+
+Versión: `0.12.0`
+
+## Objetivo
+
+Completar el Maestro de Activos con dos capacidades previstas desde su diseño:
+
+- identificar de dónde proviene la información principal de cada activo;
+- reconstruir cómo se encontraba el maestro en una fecha y hora determinada.
+
+## Procedencia
+
+Cada activo registra:
+
+- origen controlado: carga manual, relevamiento de campo, documentación
+  recibida, importación o sistema;
+- nombre de la fuente y referencia;
+- fecha y hora observada;
+- notas de procedencia;
+- usuario y fecha de la última actualización;
+- usuario y fecha de verificación.
+
+Actualizar la procedencia reinicia cualquier verificación previa. Las fuentes
+documentales e importaciones requieren identificar la fuente.
+
+## Permisos
+
+- `assets.read_provenance`: cinco roles base;
+- `assets.manage_provenance`: admin, supervisor e inspector;
+- `assets.verify_provenance`: admin, director y supervisor;
+- `assets.read_temporal`: cinco roles base.
+
+## Versionado y auditoría
+
+La migración incorpora una versión inicial de procedencia a todos los activos
+existentes. Las actualizaciones y verificaciones posteriores:
+
+- incrementan `assets.current_version`;
+- generan un snapshot inmutable completo;
+- registran actor, origen, request ID y evento de auditoría;
+- no permiten al usuario runtime modificar ni borrar versiones anteriores.
+
+## Consulta temporal
+
+La API selecciona la última versión de cada activo cuya fecha sea menor o igual
+al instante solicitado. Así reconstruye sólo los activos que ya existían en ese
+momento y conserva sus códigos, nombres, tipos, jerarquías, estados, atributos,
+geometrías, archivos y procedencia histórica.
+
+Rutas:
+
+- `GET /api/v3/temporal-assets?at=...`: maestro histórico paginado y filtrable;
+- `GET /api/v3/temporal-assets/:assetId?at=...`: snapshot exacto de un activo.
+
+Las consultas son de sólo lectura y no modifican el estado actual.
+
+## Interfaz
+
+- panel de procedencia dentro de cada activo;
+- estado pendiente o verificado en el listado maestro;
+- sección **Consulta temporal** con fecha, hora y filtros;
+- vigencia desde/hasta de cada snapshot;
+- visor semántico y snapshot técnico exacto.