Cómo ver el calendario general
Consulta el calendario operativo general de una ubicación en vista de día, semana, mes o año. En Marea Gran Via, la pantalla reúne los eventos visibles según permisos y permite revisar el rango activo, moverse por fechas, refrescar la información y abrir eventos para ver su detalle.
En este artículo
El calendario general ofrece una lectura única de la operativa de una ubicación: servicios, eventos privados, vacaciones, bajas, bloqueos, horarios y turnos aparecen solo cuando el usuario tiene permisos para verlos.
Para el runtime demo ES, la vista estable de Marea Gran Via se abre con `/:orgId/:locationId/calendars?mode=week&startDate=${SERVICE_OCCURRENCE_START}`.
Antes de empezar
- Sesión iniciada con organización y ubicación seleccionadas.
- Contexto disponible para `Grupo Marea Demo` y `Marea Gran Via`.
- Al menos un permiso de vista o gestión sobre servicios, vacaciones, bajas, bloqueos de vacaciones, horarios o turnos.
- Zona horaria de ubicación disponible; en Marea Gran Via se usa `Europe/Madrid`.
Instrucciones
- 1.
Abrir el calendario general
Accede a `/:orgId/:locationId/calendars`. Si falta la organización o la ubicación seleccionada, la pantalla no muestra el calendario operativo; si no hay permisos aplicables, muestra el aviso de permisos.
- 2.
Elegir la vista temporal
Consulta el calendario en `day`, `week`, `month` o `year` según la granularidad necesaria. Para planificación operativa suele ser útil abrir semana; para concentración de eventos, mes.
- 3.
Revisar los eventos visibles
Lee los servicios, eventos privados, vacaciones, bajas, bloqueos, horarios y turnos del rango. El calendario general no fija un filtro de tipos: el backend devuelve solo los eventos permitidos para el usuario.
- 4.
Moverse por fechas
Usa la navegación del calendario para avanzar o retroceder. Cada cambio válido de fecha o modo recalcula el rango con la zona horaria de la ubicación y carga los eventos necesarios.
- 5.
Refrescar el rango visible
Recarga el calendario para confirmar cambios recientes. La pantalla fuerza refresco al recuperar el foco después de la primera carga y expone el refresco manual desde el encabezado como gesto de arrastre vertical.
- 6.
Abrir un evento
Selecciona un evento para revisar su detalle mediante `calendars.open-event`. La edición no es requisito para consultar el calendario; si el usuario no tiene permiso de gestión para ese tipo, el detalle se abre en solo lectura.
Validaciones y límites
- `mode` solo admite `day`, `week`, `month` y `year`; cualquier otro valor arranca en `month`.
- `startDate` y `firstVisibleDate` se ignoran si no son fechas válidas.
- Los permisos se aplican en la pantalla y también en el backend antes de devolver eventos.
- La pantalla consulta primero `/calendar-events/feed` con `include=instances,summary` y usa `/calendar-events` si el feed falla de forma recuperable.
- El backend rechaza rangos con fin anterior al inicio con `rango de fechas invalido`.
- Los overrides cancelados no se muestran y algunos servicios pueden omitirse si solapan vacaciones de ubicación o eventos privados.
- `staff_schedule` se abre en solo lectura desde esta pantalla.
Resultado esperado
El usuario obtiene una lectura actualizada del calendario operativo general de Marea Gran Via, filtrada por permisos y organizada por el rango temporal elegido.