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,66 @@
+# D5.3.4 · Asset Center y administración intuitiva
+
+Versión: `0.19.3-4`
+
+## Objetivo
+
+Reducir la complejidad visible del Maestro y de la administración sin simplificar el modelo de datos definido en D5.3.3.
+La regla de diseño de esta fase es: **modelo completo, interfaz simple**.
+
+## Asset Center
+
+`Activos` pasa a ser el punto de entrada único al Maestro y ofrece:
+
+- búsqueda por nombre, código DH e identificadores externos vigentes;
+- vistas Lista, Jerarquía, Mapa, Historial y Consulta temporal;
+- filtros Área → Operadora, tipo, estado del dato y estado operativo;
+- vistas rápidas para pendientes de validar, sin ubicación y fuera de servicio;
+- tabla compacta orientada al uso cotidiano;
+- jerarquía física navegable conservando `parent_id` como única relación de contención.
+
+La API agrega `GET /api/v3/assets/tree`, protegido con `assets.read`, que devuelve los activos coincidentes junto con sus ancestros físicos. La respuesta se limita a 5.000 nodos y avisa si fue truncada.
+
+## Alta y detalle de activos
+
+- alta contextual desde cualquier activo con `Agregar activo aquí`;
+- herencia del padre y, cuando corresponde, del contexto Área–Operadora;
+- búsqueda de padre compatible en lugar de depender de un listado fijo;
+- detalle organizado por pestañas: Resumen, Ubicación, Documentos y registro, Archivos e Historial;
+- estado del dato y estado operativo mostrados como conceptos separados.
+
+## Registro documental e institucional
+
+El modelo D5.3.3 se expone en una interfaz administrable desde el detalle del activo:
+
+- identificadores externos;
+- documentos fuente;
+- perfil de Organización;
+- composición histórica de UTE;
+- permisos y concesiones del Área;
+- participantes de los derechos legales.
+
+## Configuración del Maestro
+
+La pantalla de tipos prioriza nombre, descripción y comportamiento comprensible.
+Código interno, rol operativo, posibilidad de raíz y matriz de padres permitidos quedan dentro de `Configuración avanzada`.
+
+## Roles y permisos
+
+Los permisos se presentan primero con nombres funcionales en castellano y el código técnico queda como referencia secundaria.
+
+## Dashboard y navegación
+
+El Inicio prioriza operación:
+
+- inspecciones planificadas;
+- controles vencidos;
+- hallazgos abiertos;
+- activos pendientes de validar;
+- activos sin ubicación;
+- respuestas pendientes y próximos controles.
+
+La navegación lateral se agrupa en Operación, Seguimiento, Maestro, Administración y Sistema. Mapa/Historial/Consulta temporal dejan de competir como módulos principales y pasan a ser vistas del Asset Center.
+
+## Compatibilidad
+
+D5.3.4 no agrega una migración propia. Si D5.3.3 aún estuviera pendiente, el deploy aplica las migraciones incluidas en la entrega antes de levantar la nueva versión.