Cómo actualizar un bloqueo de vacaciones
Modifica un bloqueo de vacaciones existente en Marea Gran Via para ajustar fechas, motivo, alcance, roles, empleados afectados o repetición, y refrescar el calendario tras guardar.
En este artículo
Los bloqueos de vacaciones ayudan a proteger periodos críticos del restaurante en los que no se deben aceptar nuevas ausencias del equipo. En Antylogic se gestionan como eventos del calendario de personal de tipo `vacation_blackout`.
Este flujo sirve para corregir un bloqueo ya creado: revisar el evento desde el calendario de vacaciones, abrirlo en edición, ajustar sus condiciones y guardar el cambio sin convertirlo en otro tipo de evento.
Antes de empezar
- Tener acceso a Grupo Marea Demo y a la ubicación Marea Gran Via.
- Contar con `vacation-blackout:view` para abrir el bloqueo; para guardar cambios se necesita `vacation-blackout:manage`.
- El bloqueo debe existir como evento `calendar_events` de tipo `vacation_blackout`.
- Si el alcance se limita por rol o empleado, la pantalla debe poder cargar los roles y empleados de la ubicación.
Instrucciones
- 1.
Abre el calendario de vacaciones
Entra en el calendario de vacaciones de Marea Gran Via y localiza el bloqueo existente. Esta vista es el punto de entrada operativo para revisar qué periodos están cerrados a nuevas vacaciones.
- 2.
Abre el bloqueo en edición
Toca el evento o abre la ruta de edición con `kind=vacation_blackout`. La pantalla carga el detalle y rellena comienzo, fin, motivo, alcance, roles o empleados afectados y la recurrencia existente si la hay.
- 3.
Ajusta fechas y motivo
Modifica Comienzo, Fin y Motivo según el periodo que debe quedar bloqueado. El bloqueo se trata como evento de día completo, con inicio al principio del día y fin al cierre del día seleccionado.
- 4.
Elige el alcance
Selecciona si aplica a toda la ubicación, a roles concretos como Sala, Cocina o Barra, o a empleados concretos como Marta Ruiz o Diego Serrano. Al cambiar el alcance, la app limpia las selecciones que ya no correspondan.
- 5.
Configura la repetición si procede
Abre la pestaña Repetir cuando el bloqueo deba seguir una pauta diaria, semanal, mensual o anual. No uses este flujo para documentar la eliminación de una recurrencia existente, porque no está confirmada para esta acción.
- 6.
Guarda los cambios
Pulsa Guardar. Si hay cambios válidos y el usuario tiene permiso de gestión, Antylogic actualiza el evento, muestra `Evento actualizado correctamente.` y vuelve a la superficie desde la que se abrió.
Validaciones y límites
- La ruta debe tener `orgId` y `locationId` resueltos.
- El `eventId` debe existir y el evento cargado debe ser de tipo `vacation_blackout`.
- Sin `vacation-blackout:view` no se puede ver la pantalla; sin `vacation-blackout:manage` no se puede guardar.
- Comienzo y Fin deben ser fechas válidas, y Comienzo debe ser anterior a Fin.
- El motivo no puede quedar vacío tras quitar espacios.
- El alcance por rol exige al menos un rol seleccionado; el alcance por empleado exige al menos un empleado seleccionado.
- No se pueden mezclar `staff_role_ids` y `staff_ids`, ni enviarlos cuando el alcance es ubicación.
- Guardar queda deshabilitado si la mutación está pendiente, si el formulario no es válido o si no hay cambios.
- Esta acción no permite cambiar el tipo del evento ni borrar bloqueos.
Resultado esperado
El `calendar_events` existente queda actualizado como `vacation_blackout`; si se envía recurrencia, se guarda sobre `calendar_recurrences`, y los calendarios de vacaciones se refrescan para mostrar el cambio.