0005. Sesión con JWT en localStorage y sin Pinia¶
Estado: Aceptado
Fecha: 2026-10-21
Autor: Duval Alcivar
Módulo(s) afectado(s): panel administrativo (core-admin): sesión y autorización de cliente
Evidencia: commit 3b81172 (2026-10-21) y src/session.ts, core_admin_access_token
Contexto¶
El panel necesitaba recordar la sesión entre recargas y decidir si el usuario puede entrar, sin introducir un store global para un único valor.
Decisión¶
Se persiste un solo token en localStorage bajo la clave
core_admin_access_token. La sesión es un ref de módulo, no un store. El JWT se
decodifica en el cliente para leer username, tipo_usuario y exp; se descarta
si ya expiró o si tipo_usuario !== 'root'. restoreSession() repite la
validación al recargar.
Alternativas descartadas¶
- Pinia — el estado de sesión es un token y tres claims; un store añade
ceremonia sin resolver nada que un
refde módulo no cubra (el README la listaba como pendiente). - Refresco automático con
expires_in— no hay endpoint ni flujo de refresh en el panel (también pendiente en el README).
Consecuencias¶
expires_in se ignora y no hay refresco: al vencer el token, el usuario solo lo
nota cuando una llamada falla. El cliente no verifica la firma, así que la
garantía real es que los endpoints /admin exijan root en el backend.
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).