Listar roles de empleados
Consulta los roles de empleados de la ubicación activa desde la pestaña Roles de empleados, con búsqueda local, paginación en cliente y empleados activos asociados cuando la cuenta puede leer personal.
En este artículo
Esta guía explica cómo revisar los roles de empleados dentro de una ubicación concreta. En el demo es-ES, Grupo Marea Demo usa Marea Gran Via con roles como Barra, Cocina y Sala.
La tabla carga los roles de la ubicación activa. La búsqueda y la paginación se aplican en la interfaz, y la columna Empleados se completa desde el personal activo cuando existe permiso `staff:view`.
Antes de empezar
- Sesión iniciada en la app con Grupo Marea Demo y la ubicación Marea Gran Via seleccionadas.
- Permiso de ubicación `staff-roles:view` para cargar el listado de roles.
- Permiso `staff:view` si la guía debe mostrar empleados activos en la columna Empleados.
- Acceso a `location/staff?tab=roles` o a la variante filtrada `location/staff?tab=roles&roles_query=Sala&roles_page=1`.
Instrucciones
- 1.
Abrir Roles de empleados
Entra en Empleados y roles desde la ubicación activa y selecciona la pestaña Roles de empleados. También puedes abrir directamente `location/staff?tab=roles` si la sesión ya tiene organización y ubicación seleccionadas.
- 2.
Revisar la tabla
Comprueba las columnas Nombre, Descripción y Empleados. En Marea Gran Via deben aparecer roles demo como Barra, Cocina y Sala, ordenados por nombre.
- 3.
Comprobar empleados asignados
Si la cuenta puede leer personal, revisa la columna Empleados. La interfaz cruza los roles con empleados activos, excluye archivados y puede mostrar empleados de sala como Marta Ruiz y Lucia Navarro para el rol Sala.
- 4.
Buscar un rol
Usa la búsqueda para filtrar por nombre o descripción. En el demo es-ES, buscar Sala actualiza `roles_query`, reinicia `roles_page` a 1 y deja visible el rol Sala.
- 5.
Usar paginación y refresco
Cuando haya más roles de los que caben en la vista, usa la paginación de la tabla. El refresco vuelve a cargar roles y, si la cuenta puede leer personal, también recarga staff.
- 6.
Interpretar acciones de fila
En una cuenta de solo lectura la fila ofrece Ver. Con permiso de gestión pueden aparecer Editar y Eliminar, pero crear, editar y borrar roles pertenecen a acciones separadas.
Validaciones y límites
- El listado pertenece solo a la ubicación activa y no mezcla roles de otras ubicaciones.
- `GET /api/app/{orgId}/{locationId}/staff-roles` exige `staff-roles:view` y no recibe búsqueda ni paginación server-side.
- `roles_query` se trata como texto, recorta espacios e ignora mayúsculas al comparar nombre y descripción.
- `roles_page` se interpreta como entero positivo; los valores inválidos vuelven a 1 y las páginas fuera de rango se corrigen.
- `roles_page_size` puede existir en la ruta, pero esta pantalla calcula el tamaño de página por viewport.
- El endpoint de roles no devuelve empleados ni conteos; la columna Empleados se deriva de staff activo y requiere `staff:view`.
- Esta acción no crea, edita ni elimina roles de empleados.
Resultado esperado
El usuario obtiene una vista acotada a la ubicación activa para revisar roles, validar empleados activos asociados cuando tiene permiso y filtrar rápidamente el rol Sala en el demo es-ES.