Cómo registrar la entrada de un empleado
Registra la entrada de asistencia de Marta Ruiz en Marea Gran Via y deja abierto un turno activo sin hora de salida.
En este artículo
Esta guía documenta el fichaje normal desde la pantalla Asistencia: el responsable selecciona a Marta Ruiz, pulsa Entrada y confirma la acción antes de modificar datos.
La entrada crea un turno activo para el empleado seleccionado. Si ya existe un turno abierto, Antylogic cambia al flujo de advertencia y pide resolver la hora de salida anterior.
Antes de empezar
- Sesión autenticada con Grupo Marea Demo y la ubicación Marea Gran Via seleccionada.
- Permiso `staff-shifts:notify` para fichar empleados desde la ubicación, o acceso self-service para fichar el staff propio.
- Marta Ruiz existe como staff válido en Marea Gran Via; en el runtime ES corresponde a `STAFF_ID`.
- Para mostrar el camino normal, `STAFF_ID` no debe tener ya un turno abierto sin hora de salida.
Instrucciones
- 1.
Abrir Asistencia
Entra en `attendance` o abre `attendance?staff=${STAFF_ID}` para llegar directamente a Marta Ruiz en Marea Gran Via. La pantalla debe ser Asistencia, no Correcciones.
- 2.
Seleccionar a Marta Ruiz
Selecciona la tarjeta del empleado. La tarjeta muestra las acciones Entrada y Salida cuando el usuario puede notificar turnos o está fichando su propio staff.
- 3.
Pulsar Entrada
Pulsa Entrada para abrir el modal Confirmar entrada. El botón Confirmar queda bloqueado mientras faltan datos necesarios o se están cargando los turnos del empleado.
- 4.
Confirmar el fichaje
Pulsa Confirmar. En el camino normal la app envía una notificación de turno con `action` igual a `entry` y usa el staff de la ruta, aunque el cuerpo de la petición incluyera otro empleado.
- 5.
Revisar el resultado
El modal se cierra, la información del empleado se refresca y aparece Turno actualizado. El turno queda abierto con hora de entrada y sin hora de salida.
- 6.
Resolver un turno abierto
Si Marta Ruiz ya tiene un turno abierto, la nueva Entrada muestra una advertencia con Hora de salida. Indica la salida anterior para cerrar primero ese turno y permitir la nueva entrada.
Validaciones y límites
- Si no hay empleado seleccionado, la interfaz muestra Selecciona un empleado.
- Registrar entrada requiere `staff-shifts:notify`; `staff-shifts:view` permite consultar turnos pero no fichar.
- No se permiten dos turnos abiertos normales para el mismo staff.
- El backend acepta `entry` o `exit` como acción y rechaza un payload JSON inválido.
- El turno normal se persiste como `calendar_event` con `kind` igual a `staff_shift`, no como una tabla dedicada de fichajes.
- No documentar `entry_at` manual como parte de este flujo: esa variante pertenece a correcciones o creación manual.
Resultado esperado
Marta Ruiz queda con un turno activo: el sistema guarda la entrada como `calendar_event` de tipo `staff_shift`, refresca las consultas de asistencia y deja trazable el fichaje desde la pantalla Asistencia.