Cómo ver el calendario de vacaciones
Revisa en una ubicación las vacaciones del personal, las ausencias, los cierres y los bloqueos que afectan a la planificación del equipo.
En este artículo
El calendario de vacaciones reúne en una vista operativa los eventos que afectan a la cobertura del local. En el demo ES, la referencia es Grupo Marea Demo > Marea Gran Via.
La pantalla abre el preset de vacaciones y limita la consulta a `vacation_blackout`, `staff_vacation`, `staff_leave` y `location_vacation`. Cada evento se muestra según el tipo y los permisos disponibles.
Esta guía explica la consulta del calendario. La creación, edición y aprobación de vacaciones quedan en acciones separadas.
Antes de empezar
- Tener seleccionadas una organización y una ubicación; para el demo ES: Grupo Marea Demo > Marea Gran Via.
- La ubicación debe tener zona horaria configurada. Marea Gran Via usa `Europe/Madrid`; si falta zona horaria, la app cae a UTC.
- Contar con al menos un permiso de consulta o gestión de vacaciones, ausencias o bloqueos: `vacation:view`, `vacation:manage`, `staff-leave:view`, `staff-leave:manage`, `vacation-blackout:view` o `vacation-blackout:manage`.
- Para capturas del demo, usar `ORG_ID` y `LOCATION_ID` del runtime localizado ES.
Instrucciones
- 1.
Abre el calendario de vacaciones
Entra en Calendarios > Vacaciones o abre directamente `/:orgId/:locationId/calendars/vacations?mode=month`. La pantalla queda limitada al calendario de vacaciones de la ubicación activa.
- 2.
Elige el periodo visible
Usa los controles para cambiar entre Día, Semana, Mes y Año. Si la ruta no trae un modo válido, Antylogic abre la vista en Mes y toma la fecha de `startDate`, `firstVisibleDate` o la fecha actual.
- 3.
Lee los eventos del equipo
La vista muestra `vacation_blackout`, `staff_vacation`, `staff_leave` y `location_vacation`. En vacaciones y ausencias de personal, carga el staff para enseñar nombre y avatar; en cierres de ubicación usa el nombre del local.
- 4.
Interpreta estados y colores
Los bloqueos aparecen en negro. Las vacaciones solicitadas aparecen en amarillo; las aceptadas o rechazadas, en gris. Las vacaciones de ubicación aparecen en gris y las ausencias de personal en rojo.
- 5.
Abre un evento
Selecciona una instancia para revisar su detalle. Si el usuario no tiene permiso de gestión para ese tipo de evento, el detalle se abre en modo de solo lectura.
- 6.
Actualiza la información
Al volver a enfocar la pantalla o refrescar, la app vuelve a consultar personal y eventos del rango visible. Si el feed optimizado falla de forma recuperable, reintenta con el listado clásico de `calendar-events`.
- 7.
Revisa solicitudes pendientes
Con `vacation:manage`, aparece el botón Listado de vacaciones con el contador de solicitudes pendientes. Al abrirlo, conserva el modo y la fecha visible para volver al mismo contexto.
Validaciones y límites
- Si falta organización o ubicación, la pantalla muestra el estado de ubicación no encontrada y no consulta eventos.
- Si el usuario no tiene permisos suficientes, la pantalla informa que no tiene permisos para ver el calendario.
- El menú Calendarios > Vacaciones depende de permisos de vacaciones o bloqueos; un perfil con solo permisos de `staff-leave` puede necesitar enlace directo.
- `mode` solo acepta `day`, `week`, `month` y `year`; `startDate` y `firstVisibleDate` se ignoran si están vacíos o no son fechas válidas.
- La ruta de vacaciones no envía filtros por empleado, estado de solicitud, `payload_status` ni `payload_statuses`.
- La API solo devuelve los tipos para los que el usuario tiene permiso de lectura, aunque el calendario solicite más tipos.
- Las recurrencias se expanden dentro del rango visible; las excepciones y ocurrencias canceladas no se muestran.
- El contador `pending.staff_vacation_approvals` se actualiza cada 30 segundos solo para gestores con `vacation:manage`.
- Si no hay eventos en el rango, el calendario queda cargado sin instancias visibles; no se observó un estado vacío específico.
Resultado esperado
El responsable consulta el calendario de vacaciones de la ubicación, entiende qué vacaciones, ausencias, cierres y bloqueos afectan al servicio, y puede abrir detalles o el listado de solicitudes según sus permisos.