Cómo ver el calendario de cobertura de personal
Consulta la cobertura operativa de personal de una ubicación para revisar turnos, horarios asignados a servicios, vacaciones, bajas, bloqueos de vacaciones y cierres por vacaciones. Puede abrirse filtrado por una empleada, como Marta Ruiz en el demo ES, o sin filtro para revisar todo el equipo.
En este artículo
El calendario de personal reúne las capas que afectan a la cobertura real del equipo: turnos, horarios de servicio asignados, vacaciones, bajas y restricciones compartidas de la ubicación.
En Grupo Marea Demo, la captura principal se prepara sobre Marea Gran Via y Marta Ruiz, usando la vista semanal anclada en `SERVICE_OCCURRENCE_START` para revisar la semana del servicio demo.
Antes de empezar
- Tener una organización y una ubicación seleccionadas, por ejemplo Grupo Marea Demo y Marea Gran Via.
- Contar con permisos de vista suficientes sobre calendario de personal, turnos, vacaciones, bajas o bloqueos de vacaciones en la ubicación.
- Para ver una persona concreta, abrir `calendars/staff/:staffId`; sin `staffId`, la pantalla muestra la cobertura general del personal.
- Para la captura localizada, usar la sesión demo ES con `STAFF_ID` de Marta Ruiz y `SERVICE_OCCURRENCE_START` como fecha de ancla.
Instrucciones
- 1.
Abrir el calendario de empleados
Desde la navegación de calendarios, entra en Empleados. Si aparecen enlaces por empleado, selecciona Marta Ruiz para abrir la vista filtrada; si no, usa el acceso general para revisar toda la cobertura de personal de la ubicación.
- 2.
Elegir la vista de planificación
Cambia entre Día, Semana, Mes y Año según el nivel de detalle necesario. Para la revisión semanal del demo, abre `calendars/staff/${STAFF_ID}?mode=week&startDate=${SERVICE_OCCURRENCE_START}`.
- 3.
Leer cobertura y restricciones
Revisa los eventos visibles del preset `staff`: turnos, horarios asignados a servicios, vacaciones, bajas, bloqueos de vacaciones y cierres por vacaciones. En un calendario filtrado, los eventos propios se limitan al empleado, pero los cierres de ubicación y bloqueos aplicables siguen visibles.
- 4.
Abrir el detalle de un evento
Selecciona un evento para revisar su detalle. Si el usuario no tiene permisos de gestión para ese tipo, se abre en modo lectura. Los eventos `staff_schedule` se consultan desde este calendario, pero su edición vive en el flujo del servicio.
Validaciones y límites
- Si falta la organización o la ubicación seleccionada, la pantalla muestra `No encontramos la ubicacion solicitada.` y no consulta eventos.
- Si no hay permisos suficientes para el preset de personal, se muestra `No tienes permisos para ver el calendario.` antes de cargar datos.
- Solo son válidos los modos `day`, `week`, `month` y `year`; cualquier otro valor inicial abre la vista `month`.
- Si `startDate` o `firstVisibleDate` no son fechas válidas, la pantalla usa la fecha actual como ancla.
- El preset `staff` fija los tipos `staff_shift`, `staff_schedule`, `staff_vacation`, `staff_leave`, `vacation_blackout` y `location_vacation`; no ofrece selector manual de tipos.
- Con `staffId`, los cierres de ubicación siguen visibles y los bloqueos de vacaciones solo aparecen si aplican al empleado o a su rol.
- Con filtro de empleado, los turnos abiertos sin `ends_at` no aparecen en este calendario.
- La UI intenta primero `/calendar-events/feed` y cae a `/calendar-events` si el feed no está disponible o falla de forma recuperable.
Resultado esperado
El responsable puede comprobar la cobertura de personal de la ubicación, comparar una empleada concreta con el equipo completo y abrir detalles sin crear ni modificar eventos desde esta acción de consulta.