Saltar al contenido principal

Fix: la cabecera del menú y el dashboard de Inicio leían el usuario de localStorage

· 4 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Dos síntomas reportados, una sola causa raíz: la migración a sesión por cookie (TEC-019, Fase 2) está incompleta.

Síntoma reportadoCausa
«Los datos del usuario se han perdido y no se están mostrando en la cabecera del menú»La cabecera leía localStorage['user'], que ya no se escribe
«No se muestra el dashboard que se mostraba al iniciar sesión»El dashboard leía localStorage['user'] → user_ vacío → isAdmin === false → se pintaba el dashboard de acceso limitado

🔎 Causa raíz​

TEC-019 movió la sesión a una cookie HttpOnly y el usuario a GET /auths/me. El propio login-form.tsx lo documenta:

// TEC-019 (Fase 2): la sesión se guardó en una cookie `HttpOnly`...
// el usuario se lee de `GET /auths/me`.
const objectToken: Usuario = await getMe();
...
// Sincroniza el contexto con el usuario autenticado...
setUser(objectToken);

Es decir: el usuario vive en el AuthContext y localStorage ya no guarda nada (login-form.tsx no tiene ni una escritura de localStorage).

Pero los consumidores no se migraron:

ArchivoQué hacíaConsecuencia
components/user/user-info.tsx (cabecera de escritorio)JSON.parse(getSafeKeyObjectFromStorage('user')) ?? {}Cabecera con avatar, nombre, correo y rol vacíos
components/layouts/mobile/mobile-navigation.tsx (cabecera móvil)el mismo patrón, con la lectura del contexto comentada (//const { user } = useContext(AuthContext);)Cabecera móvil vacía y menú móvil filtrado con rol vacío
components/general-dashboard.tsxconst user_: Usuario = JSON.parse(...) ?? {} → isAdmin = user_?.rol === RolUsuario.ADMINisAdmin === false → dashboard de acceso limitado en vez del completo

Dato relevante: components/layouts/sidebar/sidebar.tsx ya leía del contexto con respaldo a localStorage, así que el menú lateral funcionaba; por eso el síntoma se veía solo en la cabecera y en el dashboard.

🛠️ Corrección​

La fuente única es el AuthContext (es el mismo patrón que ya usaban main-content.tsx y sidebar.tsx):

// Antes
const user_: Usuario = JSON.parse(getSafeKeyObjectFromStorage('user')) ?? {};

// Ahora
const { token, user_ } = useContext(AuthContext);

En la cabecera de escritorio y en la móvil se lee user del contexto y se eliminó el estado/efecto intermedio que releía localStorage. También se retiraron los imports que quedaron sin uso.

🧪 Verificación​

Se reprodujo primero con una prueba que fallaba:

✗ muestra nombre, correo y rol del usuario del contexto
Unable to find an element with the text: Juana Pérez

y tras el arreglo:

✓ muestra nombre, correo y rol del usuario del contexto
✓ sin sesión no muestra datos de usuario
  • ccf-almacen-web/src/components/__tests__/user-info.test.tsx (nuevo) — la cabecera debe mostrar los datos del usuario del contexto, sin nada en localStorage.
  • npx tsc --noEmit -p tsconfig.json — 0 errores.
  • Suite de la web: 37 suites / 241 pruebas, sin regresiones nuevas.

Cómo validarlo en la aplicación​

  1. Inicia sesión con un usuario Administrador.
  2. La cabecera del menú (y la móvil) debe mostrar nombre, correo y rol.
  3. En Inicio debe aparecer el dashboard completo —con la card «Resumen por almacén» y las tarjetas estadísticas—, no el aviso de acceso limitado.

⚠️ Queda pendiente (misma causa raíz, otro alcance)​

El arreglo cubre los dos síntomas reportados, pero la migración sigue incompleta: quedan 23 puntos que aún leen el usuario de localStorage, entre ellos:

  • Fuera de React (alcance de módulo): api/notification.ts, api/inventory-movement.ts, api/file.ts — leen localStorage al importarse, así que no pueden usar el contexto tal cual y necesitan que el idUsuario se les pase por parámetro (o un accesor de sesión).
  • Componentes: notification-tray.tsx, general-dashboard/user-nav.tsx, general-dashboard/search.tsx, notification-item.tsx, security/cambio-password-obligatorio.tsx, auth/role-guard.tsx, requests/* (lista, formulario, despacho, detalle, móvil), pages/solicitudes/page.tsx, pages/products.tsx, pages/almacenes.tsx, ubicaciones/ubicaciones-management.tsx.

Además, tres suites de pruebas siguen afirmando el comportamiento anterior a TEC-019 (guardar la sesión y el usuario en localStorage): login-2fa.test.tsx («guarda la sesión en localStorage cuando el código es válido»), sesiones.test.tsx (escribe el rol en localStorage «porque el panel lo lee de ahí») y sesion-aviso.test.tsx (simula la sesión con un AuthContext vacío). Son los 3 fallos que venían reportándose como deuda ajena: no lo son, son parte de esta misma migración.

Conviene decidir el patrón para el código que no es React y completar la migración de una vez.