Cómo definir roles requeridos en un servicio
Indica qué roles de personal necesita un servicio de calendario y cuántas personas son mínimas o recomendadas por rol para revisar la cobertura planificada.
En este artículo
Los roles requeridos ayudan a preparar un servicio antes de que empiece: el responsable define cuánta Sala, Cocina y Barra necesita y Antylogic compara esos requisitos con los empleados asignados.
En el demo de Grupo Marea Demo, el flujo se documenta sobre Marea Gran Via y el Servicio de comidas Gran Via, usando la pestaña Roles requeridos del formulario de servicio.
Antes de empezar
- Sesión iniciada con Grupo Marea Demo y Marea Gran Via seleccionadas.
- Permiso service:manage para crear o editar el servicio; service:view y staff-roles:view para consultar el servicio y cargar los roles disponibles.
- Abrir un evento de calendario de tipo servicio o crear uno desde Calendario de servicios con kind=service.
- Tener roles de staff disponibles en la ubicación, por ejemplo Sala, Cocina y Barra.
- Si el servicio es público, completar también plano y catálogo antes de guardar; la edición queda bloqueada si el servicio ya empezó o está en el pasado.
Instrucciones
- 1.
Abre el servicio
Desde Calendario de servicios, abre el servicio que quieres planificar. En el demo, usa Servicio de comidas Gran Via en Marea Gran Via, o crea un servicio nuevo si vas a preparar una prueba sin tocar el servicio existente.
- 2.
Entra en Roles requeridos
En el formulario del servicio, abre la pestaña Roles requeridos. La tabla muestra Rol, Mínimo y Recomendado, que son los tres datos que definen la cobertura esperada por rol.
- 3.
Añade o revisa un requisito
Pulsa Añadir requisito para crear una fila. La app propone el primer rol libre y valores iniciales de 1 para Mínimo y 1 para Recomendado; si el requisito ya existe, ajusta la fila actual.
- 4.
Ajusta los conteos
Selecciona el rol y fija los conteos según la operación del servicio. Por ejemplo, Sala mínimo 2 recomendado 2, Cocina mínimo 1 recomendado 1 y Barra mínimo 1 recomendado 1.
- 5.
Guarda el servicio
Al guardar, Antylogic sincroniza la lista completa de requisitos del servicio. En un servicio nuevo se crea el servicio completo; en uno existente se actualiza, y si es recurrente la app pide el alcance del cambio.
- 6.
Revisa la cobertura
Abre la pestaña Empleados del servicio para comprobar si las asignaciones cubren lo requerido. Si faltan personas frente al mínimo aparecen problemas; si se alcanza el mínimo pero no el recomendado aparecen avisos.
Validaciones y límites
- Cada fila debe tener un rol seleccionado; si falta, la interfaz muestra Selecciona un rol de staff.
- Cada rol solo puede aparecer una vez en el mismo servicio; si se repite, aparece Cada rol solo puede aparecer una vez.
- Mínimo y Recomendado deben ser enteros entre 1 y 999 en la interfaz.
- El guardado completo también valida título, inicio, fin y, si el servicio no es interno, plano y catálogo.
- La lista guardada de requisitos es autoritativa: los roles que no estén en el formulario se eliminan del servicio.
- La cobertura se calcula contando empleados asignados por role_id: por debajo de min_count genera problems y por debajo de recommended_count genera warnings.
- La pantalla analizada guarda los requisitos mediante el service-bundle completo, aunque existe un endpoint directo de staff-requirements.
Resultado esperado
El servicio queda con sus requisitos por rol guardados y la pestaña Empleados puede mostrar si la cobertura planificada alcanza el mínimo y el recomendado para cada rol.