Cómo crear un rol de empleado
Crea un rol para la ubicación activa Marea Gran Via, con nombre, descripción opcional y color visual, para reutilizarlo después en fichas de personal, servicios y calendarios.
En este artículo
Los roles de empleado ayudan a ordenar el equipo por funciones operativas como sala, cocina o barra. En Antylogic se crean dentro de la ubicación activa, por lo que el alcance queda ligado al local desde el que trabaja el responsable.
Este flujo no gestiona permisos de acceso ni crea usuarios. Sirve para dar identidad operativa a los puestos del equipo y reutilizarlos en superficies de personal, planificación y calendario.
Antes de empezar
- Sesión iniciada en Grupo Marea Demo con la ubicación activa Marea Gran Via.
- Permiso de ubicación `staff-roles:manage` para abrir el alta y guardar el nuevo rol.
- Permiso `staff-roles:view` si se entra desde el listado de roles o se necesita comprobar el refresco posterior.
- Ubicación activa resuelta con `selectedOrgId` y `selectedLocationId`; si falta, la app muestra un estado de ubicación no encontrada.
Instrucciones
- 1.
Abre Roles de empleados
Entra en `location/staff?tab=roles` y revisa la tabla de Roles de empleados. Desde ahí puedes buscar por nombre o descripción y ver cuántos empleados aparecen asociados a cada rol.
- 2.
Inicia el alta
Pulsa `Crear rol`. La app abre la pantalla Crear rol de empleado con Nombre, Descripción y Color vacíos, además de las acciones Cancelar y Crear rol en el pie.
- 3.
Completa nombre y descripción
Escribe un nombre corto y reconocible; para el runtime documental de Marea Gran Via se puede usar un ejemplo temporal como `Jefe de turno`. Añade descripción solo si ayuda a distinguir responsabilidades.
- 4.
Elige un color
Selecciona un color de la paleta visible del formulario. Ese color actúa como señal visual del rol en insignias y superficies de personal.
- 5.
Guarda el rol
Cuando el nombre tenga contenido y haya color seleccionado, pulsa `Crear rol`. La app envía el alta a `POST /api/app/{orgId}/{locationId}/staff-roles` y el backend asocia el rol a la ubicación del contexto.
- 6.
Confirma el retorno al listado
Tras crear correctamente, la app muestra `Rol creado`, invalida la lista `staff_roles` y vuelve a Roles de empleados. Comprueba que el rol aparece en el listado actualizado.
- 7.
Cancela o corrige errores
Cancelar o volver atrás regresa al listado sin enviar `POST`. Si falla el guardado por validación, permisos, red o repositorio, el formulario mantiene los datos y muestra `No se pudo crear el rol`.
Validaciones y límites
- El botón `Crear rol` solo está disponible para usuarios con `staff-roles:manage`.
- El listado de entrada y el refresco posterior requieren `staff-roles:view`.
- `name.trim()` es obligatorio; sin nombre, la UI deshabilita el guardado y el backend rechaza un nombre vacío.
- La descripción es opcional; si queda vacía tras recortar espacios, no se envía como valor material.
- El color es obligatorio en la UI y se elige desde la paleta `gray`, `blue`, `indigo`, `purple`, `pink`, `orange`, `success`, `warning` y `error`.
- La acción usa la ubicación del contexto backend; un `location_id` enviado por el cliente no decide el alcance del rol.
- Crear un rol no asigna empleados, no vincula usuarios y no concede permisos de acceso.
- No hay que afirmar validación de nombres duplicados: el análisis no encontró una regla explícita de unicidad en la acción revisada.
Resultado esperado
El rol queda creado dentro de Marea Gran Via, la tabla de Roles de empleados se recarga y el nuevo nombre queda disponible para reutilizarlo en la gestión operativa del equipo.