Cómo abrir el detalle de un evento de calendario
Selecciona un evento u ocurrencia del calendario y deja que Antylogic abra el destino correcto: formulario editable, consulta en solo lectura o detalle operativo de reservas.
En este artículo
En Marea Gran Via, una tarjeta de calendario puede representar un servicio, un evento privado, una ausencia, un turno o una ocurrencia con reservas. Antylogic decide qué pantalla abrir según el calendario, el tipo de evento y los permisos del usuario.
El caso más operativo ocurre en el calendario de reservas: al pulsar Servicio de comidas Gran Via se abre la ocurrencia del servicio con reservas, mesas y estado de operación. En otros calendarios, el mismo servicio puede abrirse como evento editable o en solo lectura.
Antes de empezar
- Sesión iniciada en Grupo Marea Demo con la organización y la ubicación Marea Gran Via activas.
- Una vista de calendario cargada dentro de la ubicación: general, servicios, reservas, vacaciones, calendario de empleado o mi calendario.
- Al menos un evento u ocurrencia visible en el periodo seleccionado.
- Permiso de vista para el tipo de evento que se quiere abrir; permiso de gestión si se espera editarlo.
- Para el detalle operativo de reservas, una ocurrencia de servicio existente o resoluble y permiso `reservation:view` o `reservation:manage`.
Instrucciones
- 1.
Abre el calendario adecuado
Entra en la vista que corresponda al trabajo del momento. Para operación de sala, usa el calendario de reservas en modo semana; para configurar servicios, usa el calendario de servicios; para ausencias, usa vacaciones, empleado o mi calendario.
- 2.
Pulsa el elemento del calendario
Selecciona la tarjeta del evento o servicio visible. La app decide el destino por superficie y tipo: los calendarios generales abren el evento, mientras que el calendario de reservas abre el detalle operativo cuando el elemento es un `service`.
- 3.
Revisa si se abre como edición o consulta
Con permiso de gestión, el evento se abre en formulario editable. Con solo permiso de vista, se abre en solo lectura. Los eventos `staff_schedule` siempre se abren en consulta desde esta acción.
- 4.
Opera la ocurrencia de reservas
Si abriste un servicio desde el calendario de reservas, la pantalla de ocurrencia concentra reservas, asignaciones de mesa, clientes y el estado del servicio abierto. Si la tarjeta no trae `occurrenceId`, Antylogic puede resolver la ocurrencia con los datos del evento y el rango.
- 5.
Vuelve al origen
Usa el botón de volver del detalle para regresar al calendario desde el que abriste el evento. Cuando el enlace incluye contexto de retorno, la app conserva la superficie, el modo y la fecha visible siempre que sean válidos.
Validaciones y límites
- `GET /calendar-events` exige `from` y `to` válidos; el final del rango no puede ser anterior al inicio.
- El evento solo se carga si pertenece a la ubicación activa y el usuario tiene permiso de vista para su tipo.
- La edición exige permiso de gestión del tipo correspondiente; sin ese permiso, el destino es solo lectura.
- `staff_schedule` queda forzado a solo lectura aunque se abra por la ruta de edición.
- En el calendario de reservas, `service` abre ocurrencia, `private_event` abre detalle de evento y `location_vacation` no navega desde esta acción.
- El detalle operativo de reservas exige `reservation:view` o `reservation:manage` y una ocurrencia de tipo `service` de la misma ubicación.
- Los modos de retorno válidos son `day`, `week`, `month` y `year`; otros valores se ignoran.
- Abrir un evento no guarda cambios. La única mutación posible es resolver o materializar una ocurrencia de servicio si todavía no existía.
Resultado esperado
El usuario llega a la pantalla correcta para el elemento seleccionado: edición si puede gestionar, consulta si solo puede ver, o detalle operativo cuando abre un servicio desde el calendario de reservas.