Saltar al contenido principal

Fix: el Almacenista ya ve el panel completo de la pantalla de Inicio

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

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​

PruebaResultado
npx tsc --noEmit (web)EXIT 0
npx eslint src/components/general-dashboard.tsx0 errores (7 warnings previos de hooks y <img>)
menu-registry.spec.ts, favoritos-menu, menu-favoritos-estrella, menu-esqueleto, cambio-password-obligatorio5 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ódulo 95), el menú no se lo mostrará aunque el render ya lo permita: eso es un dato en roles_modulos (puede_ver), no código. Conviene verificarlo al desplegar.