dh-inspeccion-v2/docs/PHASE_D5_3_4.md

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.