Saltar a contenido

0004. Layouts de ruta y guard de sesión

Estado: Aceptado Fecha: 2026-10-21 Autor: Duval Alcivar Módulo(s) afectado(s): panel administrativo (core-admin): router, layouts y acceso Evidencia: commit 3b81172 (2026-10-21) y src/app, src/shared/layouts, App.vue

Contexto

El panel tiene dos marcos visuales incompatibles: el acceso (login y cambio de contraseña temporal) y la aplicación autenticada con sidebar y topbar. Además hacía falta una única regla de acceso que no dependiera de que cada vista se acordara de comprobarla.

Decisión

/login y /login/cambiar-password cuelgan de AuthLayout; el resto de las rutas cuelga de AdminLayout (sidebar + topbar + RouterView) y declara meta.requiresAuth. Un beforeEach global redirige a login conservando el destino en redirect, y el catch-all resuelve a home. App.vue solo renderiza RouterView.

Alternativas descartadas

  • Un layout único para todo, incluido el login — mostraría el sidebar antes de que exista sesión y filtraría la estructura del panel a un usuario no autenticado.
  • Comprobar la sesión dentro de cada vista — repite la regla en cada pantalla y basta olvidar una para dejar una ruta abierta.

Consecuencias

La protección es declarativa y se lee en la definición de la ruta. El riesgo es el inverso: una ruta nueva sin meta.requiresAuth queda accesible aunque el usuario no tenga token.


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).