Ver calendario de empleado
Consulta el calendario de personal de una ubicación y, si se indica un empleado, revisa turnos, horarios planificados, vacaciones, bajas y bloqueos aplicables. En la demo ES, el ejemplo recomendado es Marta Ruiz en Marea Gran Via.
En este artículo
Esta guía explica cómo abrir el calendario de personal en Antylogic y leer una agenda semanal individual o de toda la ubicación sin entrar en flujos de creación o edición.
La vista filtrada conserva los eventos compartidos que aplican al empleado o a su rol, y trata los horarios `staff_schedule` como información de solo lectura.
Antes de empezar
- Sesión iniciada con organización y ubicación seleccionadas.
- Permisos de ubicación para ver al menos una familia del calendario de personal.
- Para la vista filtrada, un empleado activo de la ubicación; en la demo ES se usa `STAFF_ID` para Marta Ruiz.
- Una fecha o rango visible. Si no se indica, la pantalla abre en modo `month` con la fecha actual.
Instrucciones
- 1.
Abrir el calendario de personal
Entra desde el menú lateral de calendarios o abre `calendars/staff/:staffId?`. Con `staffId`, la vista queda filtrada por ese empleado; sin `staffId`, muestra el calendario de personal de toda la ubicación.
- 2.
Confirmar filtro y semana
Comprueba que el calendario está enfocado en el empleado y el rango esperados. Para la demo ES, usa `mode=week` y `startDate=${SERVICE_OCCURRENCE_START}` con Marta Ruiz en Marea Gran Via.
- 3.
Revisar los eventos visibles
Lee turnos, horarios planificados de servicio, vacaciones, bajas, bloqueos de vacaciones y vacaciones de ubicación. El calendario usa las familias `staff_shift`, `staff_schedule`, `staff_vacation`, `staff_leave`, `vacation_blackout` y `location_vacation`.
- 4.
Comparar con la vista general
Abre `calendars/staff` sin filtro cuando necesites revisar la planificación conjunta de la ubicación. La consulta usa los mismos tipos de evento, pero no envía `staff_id`.
- 5.
Abrir un evento para consulta
Selecciona un evento para ver su detalle. Los horarios de personal derivados de servicios (`staff_schedule`) se abren en modo solo lectura; otros eventos pueden abrirse en edición si el usuario tiene permisos suficientes.
- 6.
Resolver falta de acceso o datos
Si no aparece el calendario, revisa permisos de ubicación. Si se abre sin eventos, el rango puede no contener eventos permitidos o los tipos solicitados pueden haber sido filtrados por permisos.
Validaciones y límites
- La pantalla requiere `selectedOrgId`, `selectedLocationId` y permiso efectivo para ver alguna familia del calendario de personal.
- `mode` solo acepta `day`, `week`, `month` o `year`; `staffId` y `staffName` vacíos se tratan como no definidos.
- Las consultas de eventos requieren rango completo y fechas válidas; `to/end` no puede ser anterior a `from/start`.
- `staff_schedule` es solo lectura en la UI aunque exista permiso `staff-schedule:manage`.
- El botón de crear del calendario de personal no ofrece `staff_schedule`; solo puede ofrecer turnos, vacaciones o bajas según permisos.
- No documentar `GET /api/app/{orgId}/{locationId}/staff/{staffId}/schedule` ni `GET /api/app/me/staff/{staffId}/schedule` como flujos operativos porque devuelven 501.
Resultado esperado
El responsable consulta la agenda de personal individual o general de la ubicación, entiende qué eventos aplican al empleado y evita editar horarios planificados desde esta acción.