Cómo listar correcciones de asistencia
Revisa las correcciones de asistencia pendientes de una ubicación, acota el listado por fechas o empleado y abre el turno que necesita revisión sin resolverlo desde esta guía.
En este artículo
Esta guía cubre la vista de `attendance/corrections`, pensada para responsables de Marea Gran Via que necesitan localizar solicitudes pendientes antes de revisar cada turno.
La lista muestra turnos de personal con entrada o salida marcada como `correction_requested`. Es una guía de consulta: aprobar, rechazar, editar o eliminar pertenecen a flujos separados.
Antes de empezar
- Sesión iniciada con organización y ubicación seleccionadas, por ejemplo Grupo Marea Demo y Marea Gran Via.
- Permiso `staff-shifts:manage` en la ubicación para acceder a Correcciones de asistencia.
- Rango temporal válido; si no se indica rango, la pantalla usa el año actual.
- Al menos un turno de personal con corrección pendiente para que la tabla muestre filas.
- Lista de empleados cargada para ver nombres, avatares y opciones del filtro.
Instrucciones
- 1.
Abrir el listado
Entra desde la tarea de Inicio `Correcciones de asistencia` o desde el módulo Asistencia. Cuando la entrada viene de Inicio, la pantalla se abre con `pending_only=true` para enseñar solo pendientes.
- 2.
Revisar la tabla
Lee cada fila como un turno que requiere atención. La tabla muestra empleado, estado, entrada, salida y, en escritorio, horas. El estado `Pendiente` indica que la entrada o la salida tiene una corrección solicitada.
- 3.
Cambiar fechas
Ajusta el rango para revisar otro periodo. Al cambiar fechas, la ruta actualiza `from` y `to`, vuelve a `corrections_page=1` y recarga el listado.
- 4.
Filtrar empleado
Usa el filtro de empleado para centrar la revisión en una persona de la ubicación. El filtro se aplica sobre los resultados cargados y solo usa empleados presentes en las opciones de la lista.
- 5.
Paginar y refrescar
Usa la paginación cuando el rango devuelva más de ocho filas. El listado también permite refrescar manualmente los turnos y empleados del rango activo.
- 6.
Abrir el turno
Selecciona una fila pendiente para abrir el turno asociado. La resolución de la corrección se documenta en acciones hermanas, no en este listado.
Validaciones y límites
- Sin `staff-shifts:manage`, la pantalla muestra `No tienes permisos para usar Asistencia.` y no carga la tabla.
- `from` y `to` deben formar un rango válido; si la ruta trae fechas vacías o no parseables, la pantalla vuelve al rango del año actual.
- La fecha final no puede ser anterior a la inicial.
- En modo pendiente solo aparecen turnos `staff_shift` con `start_status` o `end_status` igual a `correction_requested`.
- `pending_only` usa `true` desde Inicio si no viene definido; desde Asistencia el valor por defecto es `false`.
- El filtro de empleado solo se aplica si el parámetro `staff` coincide con una opción cargada de la ubicación.
- Cada página muestra hasta ocho filas y una página fuera de rango se corrige a una válida.
- Si no hay resultados pendientes, la tabla muestra `No hay correcciones pendientes.`; en móvil puede omitirse la columna Horas.
Resultado esperado
El responsable queda con una vista acotada de correcciones pendientes por ubicación, sabe qué turno abrir y mantiene separada la lectura del listado de la resolución de la incidencia.