Ver panel de asistencia
Consulta el panel de Asistencia de Marea Gran Via para ver el personal de la ubicación, revisar su presencia operativa cuando existe un turno abierto y acceder al listado de asistencias si el rol lo permite.
En este artículo
El panel de Asistencia da al responsable una vista rápida del equipo en la ubicación activa. En el demo ES muestra personal como Marta Ruiz, Lucia Navarro, Diego Serrano y Alba Castro, con avatar, nombre y un indicador de presencia cuando hay un turno abierto.
Esta guía cubre solo la consulta del tablero, la selección de una tarjeta y la navegación al listado. Registrar entradas, salidas, asistencias manuales o correcciones pertenece a acciones separadas.
Antes de empezar
- Sesión iniciada en Antylogic con Grupo Marea Demo y Marea Gran Via como contexto activo.
- Contexto válido con `selectedOrgId` y `selectedLocationId`; si falta alguno, la pantalla muestra ubicación no encontrada.
- Permiso `staff-shifts:notify` para ver el grid de tarjetas de personal.
- Permiso `staff-shifts:manage` para acceder al botón `Listado de asistencias` y al resumen de correcciones.
- Permiso `staff:view` en el rol para que el backend devuelva el personal de la ubicación.
- Personal creado en la ubicación; en el demo ES existen Marta Ruiz, Lucia Navarro, Diego Serrano y Alba Castro.
Instrucciones
- 1.
Abrir Asistencia
Desde Inicio, entra en Asistencia o abre `${APP_DEEPLINK_BASE}${ORG_ID}/${LOCATION_ID}/attendance` con la sesión ya autenticada. La pantalla debe mostrar el encabezado `Asistencia` y la descripción `Registra la entrada y salida de los empleados.`.
- 2.
Revisar las tarjetas de personal
Observa el grid de empleados de Marea Gran Via. Cada tarjeta muestra avatar, nombre y, si el empleado tiene un `staff_shift` abierto, un indicador verde de presencia en ubicación.
- 3.
Seleccionar una tarjeta
Pulsa una tarjeta, por ejemplo Marta Ruiz, para dejarla activa y ver `Entrada` y `Salida`. No pulses esos botones en esta acción: el fichaje se documenta en guías independientes.
- 4.
Abrir con empleado preseleccionado
Usa `${APP_DEEPLINK_BASE}${ORG_ID}/${LOCATION_ID}/attendance?staff=${STAFF_ID}` cuando quieras abrir el panel con Marta Ruiz seleccionada. Si el `staff` no existe en el personal disponible, la pantalla ignora el parámetro.
- 5.
Ir al listado de asistencias
Con `staff-shifts:manage`, usa `Listado de asistencias` para pasar del tablero a la vista de asistencias y correcciones. El contador del botón depende de `pending.staff_shift_corrections` cuando el resumen está disponible.
Validaciones y límites
- Sin `staff-shifts:notify`, sin `staff-shifts:manage` y sin autoservicio propio, la pantalla muestra el estado sin acceso.
- `staff-shifts:view` por sí solo no habilita el tablero en el frontend.
- Con `staff-shifts:manage` pero sin `staff-shifts:notify`, el guard permite entrar, pero el grid de tarjetas solo aparece con `staff-shifts:notify` o en autoservicio propio.
- Durante la carga del personal se muestra `Cargando personal`; si no hay empleados disponibles aparece `No hay empleados disponibles`.
- El backend de `GET /api/app/{orgId}/{locationId}/staff` exige `staff:view`.
- La etiqueta de cada empleado se resuelve por `full_name`, luego `email` y finalmente `id`; las tarjetas se ordenan alfabéticamente por esa etiqueta.
- El parámetro `staff` se divide por comas, recorta espacios y usa la primera coincidencia válida en el personal disponible.
- Los parámetros `from`, `to` y `corrections_page` pueden parsearse, pero `from` y `to` no filtran las tarjetas en la vista `attendance`.
- El tablero no crea, edita ni borra turnos; las mutaciones de entrada, salida, corrección y asistencia manual pertenecen a otras acciones.
Resultado esperado
El responsable ve el personal de Marea Gran Via y su estado operativo de presencia, puede seleccionar una tarjeta o abrir el listado de asistencias sin modificar turnos desde el tablero inicial.