Saltar a contenido

0008. Sidebar estático declarado en JSON

Estado: Aceptado Fecha: 2026-10-23 Autor: Duval Alcivar Módulo(s) afectado(s): panel administrativo (core-admin): navegación lateral Evidencia: commit 5c3ab19 (2026-10-23) y src/config/sidebar.json, SidebarItem

Contexto

El panel necesitaba el menú lateral completo en el primer corte, mientras el sidebar dinámico desde /api/v1/dashboard seguía pendiente. Bloquear la interfaz a esa integración no era viable.

Decisión

src/config/sidebar.json declara el árbol con label, icon, to, children, visible y disabled. SidebarItem resuelve cada entrada con router.resolve/router.hasRoute, colapsa según la ruta activa y limita la profundidad a 3 niveles; unos 30 iconos viven en un iconMap. El componente no consulta la API ni el claim permisos.

Alternativas descartadas

  • Construir el sidebar desde la API antes de tener contrato — la navegación dinámica (/api/v1/dashboard) quedó pendiente y no podía condicionar el arranque del panel.

Consecuencias

El menú se mantiene a mano y cualquier root ve todas las entradas, sin importar sus permisos. Cuando llegue el sidebar dinámico habrá que retirar el JSON y el iconMap, no adaptarlos.


Documentado a posteriori desde el código y el historial de Git del repositorio core-admin; la fecha corresponde al commit que introdujo la decisión, no a la fecha de publicación en este sitio (2026-11-09).