0027. Navegación: plantilla declarativa, códigos jerárquicos y dashboard¶
Estado: Aceptado
Fecha: 2026-11-05
Autor: Duval Alcivar
Módulo(s) afectado(s): svc-identidad (core_sigfa), navegación y panel
Modifica a: ADR 0006, ADR 0010, ADR 0012, ADR 0013
Complementa a: ADR 0014
Origen: ADR 0034 de implementación, ADR 0036 de implementación, ADR 0043 de implementación, ADR 0044 de implementación, ADR 0058 de implementación, ADR 0059 de implementación
Contexto¶
Los ADR 0006, 0010, 0012 y 0013 fijaron una tabla de plantilla con migración de datos, rel_usuario_menu para la visibilidad y endpoints /navegacion/*; la implementación cambió las tres cosas.
Decisión¶
- La plantilla base deja de ser un esquema
app_plantillacon migración de datos y pasa a serPLANTILLA_BASEdeclarativa en Python; la materialización al crear una empresa es opt-in (materializar_plantilla=falsepor defecto). - Contenido: CORE usa el módulo
seguridad(nopermisos), CRM usaclientesyfuerza-ventas, ERP queda vacío. - Los códigos de navegación pasan a path jerárquico y el código de acción se ensancha; el path no repite el código de la aplicación.
- Se agregan operaciones de copiar y mover navegación entre empresas; el alta o el movimiento de un módulo habilita automáticamente la aplicación en
rel_empresa_aplicacion. - Los endpoints de navegación se reemplazan por el dashboard:
GET /api/v1/dashboardpara el panel yGET /api/v1/dashboard/{modulo_id}/menupara el menú. - La visibilidad del menú se resuelve con las acciones de
rel_usuario_accion, incluyendo ancestros;rel_usuario_menudesaparece.
Alternativas descartadas¶
- Mantener
app_plantillacon migración de datos — agrega un paso de datos para algo que es configuración estática y versionada. - Conservar
rel_usuario_menu— duplica la fuente de verdad que 0023 ya eliminó. - Mantener
/navegacion/*— obliga al cliente a componer panel y menú desde varias llamadas.
Consecuencias¶
La creación de empresas sin materialización explícita arranca con navegación vacía, lo que puede confundirse con un error de aprovisionamiento. Copiar y mover habilita aplicaciones de forma implícita, un efecto lateral que debe documentarse en el cliente.
Se incorporó a este sitio el 2026-11-09. La fecha del ADR corresponde a la última decisión de implementación que resume, no a la fecha de publicación en este sitio.