Fix: la cabecera del menú y el dashboard de Inicio leían el usuario de localStorage
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 reportado | Causa |
|---|---|
| «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:
| Archivo | Qué hacía | Consecuencia |
|---|---|---|
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.tsx | const user_: Usuario = JSON.parse(...) ?? {} → isAdmin = user_?.rol === RolUsuario.ADMIN | isAdmin === 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 enlocalStorage.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
- Inicia sesión con un usuario Administrador.
- La cabecera del menú (y la móvil) debe mostrar nombre, correo y rol.
- 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— leenlocalStorageal importarse, así que no pueden usar el contexto tal cual y necesitan que elidUsuariose 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.
