Files
dh-inspeccion-v2/docs/PHASE_D5_3_4.md

67 lines
2.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 ÁreaOperadora;
- 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.