Fix: el Almacenista ya ve el panel completo de la pantalla de Inicio
El rol Almacenista entraba a la pantalla de Inicio sin problema —el menú se lo
ofrece, porque GET /api/menu le entrega el módulo 1 («Inicio»)— pero lo que veía no
era el panel del administrador, sino una tarjeta naranja que decía:
Acceso Limitado — Tu rol actual (Almacenista) tiene acceso limitado al dashboard. Para ver el panel completo, contacta al administrador del sistema.
Es decir: llegaba a la pantalla, pero con el contenido reducido. Lo que faltaba no era el permiso de menú, era el gate de render.
🔎 Causa raíz
src/components/general-dashboard.tsx monta la pantalla de Inicio y decide qué pintar
con una sola condición de rol:
// Antes
const isAdmin = user_?.rol === RolUsuario.ADMIN;
consumida por el ternario principal del return:
{!isAdmin ? (
renderUserDashboard() // tarjeta «Acceso Limitado» + dos acciones
) : (
<> … panel completo (stats, stock, solicitudes, alertas, movimientos) … </>
)}
El nombre isAdmin era exacto pero demasiado estrecho: el panel completo no es
«lo del administrador», es el panel de Inicio que cualquier rol operativo debería
ver. Como el único punto de decisión estaba ahí, ampliar el acceso es un cambio de una
línea de lógica.
Por qué no hubo que tocar el backend
El menú es dirigido por datos y la visibilidad por rol se siembra con
clavesPorRol() (ccf-almacen-api/src/domains/menu/datos-menu-inicial.ts):
- el Administrador ve todos los módulos;
- un rol sin whitelist —el Almacenista— ve todos menos
RESTRINGIDOS_NO_ADMIN(usuarios,configuración,auditoría de accesos,mapa navegación,IPs,gestión de menú).
La clave '1' (Inicio) no está en esa lista de restringidos, así que el Almacenista
ya tenía el módulo concedido en roles_modulos.puede_ver. El problema estaba solo en
cómo se pintaba.
🛠️ El arreglo
Se sustituye el check por una lista explícita de roles, para que la intención quede escrita y añadir un rol mañana sea evidente:
/**
* Roles que ven el panel **completo** de la pantalla de Inicio.
* Antes era exclusivo del Administrador. El Almacenista también lo ve.
*/
const ROLES_PANEL_COMPLETO: RolUsuario[] = [
RolUsuario.ADMIN,
RolUsuario.ALMACENISTA,
];
// Pantalla de Inicio: panel completo para Administrador y Almacenista.
const puedeVerPanelCompleto = ROLES_PANEL_COMPLETO.includes(
user_?.rol as RolUsuario,
);
El resto de los roles (Auxiliar inventario, Usuario Interno, Auditor) sigue viendo el panel de acceso limitado, con el mismo aviso de siempre.
Qué ve ahora el Almacenista
El panel completo no navega a ninguna pantalla exclusiva de administración: sus accesos
son Productos («Ver Catálogo»), Solicitudes («Ver Solicitudes»), Alertas de
stock, Movimientos e Inventarios, más el acceso a la landing /v2-1. Todo es
operación de almacén, que es justo el alcance del rol.
Un detalle que evitó sorpresas: la carga de datos es incondicional —los useEffect
que piden stock, movimientos, solicitudes y alertas se ejecutan sin mirar el rol—, así
que ampliar el render no añade ni una llamada nueva al API: las mismas peticiones ya
se hacían con el panel reducido.
🧪 Pruebas
| Prueba | Resultado |
|---|---|
npx tsc --noEmit (web) | EXIT 0 |
npx eslint src/components/general-dashboard.tsx | 0 errores (7 warnings previos de hooks y <img>) |
menu-registry.spec.ts, favoritos-menu, menu-favoritos-estrella, menu-esqueleto, cambio-password-obligatorio | 5 suites / 39 tests OK |
Ojo en producción: si un administrador apagó «Inicio» para el rol Almacenista desde Gestión de menú (pantalla
/menu-admin, módulo95), el menú no se lo mostrará aunque el render ya lo permita: eso es un dato enroles_modulos(puede_ver), no código. Conviene verificarlo al desplegar.
