Revisar solicitudes de vacaciones
Abre la cola de vacaciones de una ubicación, revisa empleados, estados, fechas y notas, y acota el listado por rango, empleado y solo pendientes sin ejecutar aprobar, rechazar ni eliminar.
En este artículo
La cola de solicitudes de vacaciones centraliza los eventos `staff_vacation` de una ubicación para que un responsable vea quién pide días libres, en qué fechas y con qué motivo antes de tomar una decisión.
Esta guía cubre la revisión del listado y la entrada al detalle. Las decisiones de aprobar, rechazar o borrar se tratan como acciones separadas, porque cambian el estado de la solicitud.
Antes de empezar
- Sesión autenticada en Antylogic con organización y ubicación seleccionadas.
- Permiso de ubicación `vacation:view` para consultar el listado o `vacation:manage` para ver también controles de gestión relacionados.
- Datos de personal cargados para resolver nombres, avatares y el selector de empleado.
- Solicitudes de vacaciones creadas dentro del rango que quieras revisar.
Instrucciones
- 1.
Abre la cola de solicitudes
Entra en `/:orgId/:locationId/calendars/vacations/requests?pending_only=true` desde la ubicación. También puedes llegar desde la tarea de Inicio, desde una notificación de solicitud recibida o desde el calendario de vacaciones.
- 2.
Comprueba el alcance del listado
La pantalla lista solo solicitudes de tipo `staff_vacation` de la ubicación activa. No mezcla vacaciones de ubicación, ausencias generales ni bloqueos de vacaciones.
- 3.
Ajusta el rango de fechas
Usa los filtros de fecha para revisar el periodo correcto. Si la ruta no trae `from` y `to` válidos, la pantalla usa el año natural actual completo y sincroniza esos valores en la navegación.
- 4.
Filtra por empleado
Selecciona una persona concreta, como Marta Ruiz o Lucia Navarro, para acotar la revisión. Deja `Todos los empleados` cuando quieras revisar toda la cola.
- 5.
Alterna solo pendientes
Mantén `Solo pendientes` activado para ver estados `requested` o `pending`. Desactívalo para revisar también solicitudes aceptadas, aprobadas o rechazadas dentro del mismo rango.
- 6.
Lee la fila y abre el detalle
Revisa empleado, estado, fechas y notas. Si necesitas más contexto, pulsa la fila para abrir el detalle `staff_vacation` y vuelve al listado sin resolver la solicitud desde esta guía.
Validaciones y límites
- Sin `vacation:view` ni `vacation:manage`, la pantalla muestra `No tienes permisos para ver este calendario.` y no consulta datos.
- El backend exige `from` y `to`; si falta alguno responde `rango requerido`.
- Si `to` queda antes de `from`, el backend rechaza el rango como `rango de fechas invalido` y el frontend normaliza el filtro visual para evitarlo.
- `pending_only` solo se interpreta cuando llega como booleano o como string `true`/`false`; otros valores usan el valor por defecto según el origen de navegación.
- El filtro de empleado solo se conserva si el id existe entre las opciones cargadas desde `staff`; si llegan varios ids separados por coma, se usa el primer valor no vacío.
- La consulta principal pide `kinds=staff_vacation`; los filtros de empleado y pendientes se aplican localmente sobre los eventos cargados del rango.
- Los estados se normalizan para lectura: `requested` y `pending` se muestran como pendiente, `accepted` y `approved` como aprobada, y `rejected` como rechazada.
- Aprobar, rechazar o eliminar solicitudes no forma parte de esta guía; esas acciones deben documentarse en sus artículos unitarios.
Resultado esperado
El responsable queda con una vista acotada y trazable de las solicitudes de vacaciones de la ubicación, lista para revisar contexto y entrar al detalle antes de ejecutar una decisión separada.