Saltar a contenido

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