Saltar a contenido

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_plantilla con migración de datos y pasa a ser PLANTILLA_BASE declarativa en Python; la materialización al crear una empresa es opt-in (materializar_plantilla=false por defecto).
  • Contenido: CORE usa el módulo seguridad (no permisos), CRM usa clientes y fuerza-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/dashboard para el panel y GET /api/v1/dashboard/{modulo_id}/menu para el menú.
  • La visibilidad del menú se resuelve con las acciones de rel_usuario_accion, incluyendo ancestros; rel_usuario_menu desaparece.

Alternativas descartadas

  • Mantener app_plantilla con 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.