Centro de ayuda: guías y tutoriales

💡 Antes de comenzar: El panel de sesiones te permite ver qué empleados están trabajando ahora, revisar el historial completo de turnos, calcular horas trabajadas y analizar productividad.

Acceder al Panel de Sesiones

Inicia sesión como administrador
Ve a /[slug]/admin/employees/sessions
O navega desde el menú: Empleados → Sesiones

Vista General del Panel

El panel de sesiones muestra:

🟢 Sesiones Activas

Empleados trabajando ahora mismo con tiempo transcurrido en vivo

📊 Estadísticas

Total de horas, sesiones completadas, promedios de duración

📜 Historial

Todas las sesiones pasadas con filtros por fecha y empleado

Información Mostrada por Sesión

Campo	Descripción
Empleado	Nombre completo del empleado
Entrada	Hora de check-in (ej: "13 ene 08:30")
Salida	Hora de check-out (vacío si activa)
Duración	Tiempo trabajado (ej: "2h 45m")
Terminal	POS, Kitchen, Waiter, Cadete
Órdenes	Cantidad procesada en la sesión
Ventas	Total vendido en la sesión
Estado	🟢 Activa / 🔵 Completada

Filtrar Sesiones

Por Período de Tiempo

Usa los botones de filtro rápido:

Hoy: Solo sesiones del día actual
Esta Semana: Últimos 7 días
Este Mes: Mes actual completo
Todas: Historial completo (puede ser extenso)
Rango Personalizado: Selecciona fecha inicio y fin

Por Empleado

Usa el dropdown de empleados:

Haz clic en "Filtrar por empleado"
Selecciona el empleado del dropdown
Se muestran solo las sesiones de ese empleado
Para ver todos nuevamente, selecciona "Todos"

Por Estado

Solo Activas: Empleados trabajando ahora
Solo Completadas: Turnos finalizados
Todas: Activas + Completadas

Estadísticas Calculadas Automáticamente

En la parte superior del panel verás tarjetas con:

Métricas Principales

Total de Sesiones: Cantidad de turnos en el período seleccionado
Sesiones Activas: Empleados trabajando ahora
Total Horas Trabajadas: Suma de todas las duraciones (ej: 124.5 horas)
Duración Promedio: Promedio de tiempo por sesión (ej: 5.3 horas)
Total Órdenes Procesadas: Suma de todas las órdenes
Total Ventas: Suma de todas las ventas realizadas en las sesiones

Estadísticas por Empleado

Debajo de las métricas generales, hay una tabla con:

Nombre del empleado
Total de horas trabajadas
Cantidad de sesiones/turnos
Promedio de horas por sesión

💡 Exportación: Puedes exportar estas estadísticas a CSV o Excel para análisis más profundos en hojas de cálculo.

Acciones en Sesiones

Cerrar Sesión Activa Manualmente

Encuentra la sesión activa en la lista
Haz clic en el icono de "Cerrar Sesión" (⏹️)
Se abre un modal de confirmación
Opcionalmente, agrega notas explicando por qué (ej: "Empleado olvidó hacer logout")
Confirma
La sesión se marca como completada

⚠️ Impacto inmediato: Cerrar la sesión de un empleado lo desconecta inmediatamente de su interfaz (POS/Kitchen). Solo hazlo cuando sea necesario.

Ver Detalles de una Sesión

Haz clic en cualquier sesión de la lista
Se abre un modal con información completa:
- Dirección IP del dispositivo
- Terminal usado
- Notas del administrador
- Si fue auto-cerrada a las 8 horas
- Si es sesión de overtime
- Estadísticas detalladas

Casos de Uso Comunes

1. Ver Quién Está Trabajando Ahora

Objetivo: Saber qué empleados están en turno ahora mismo

Cómo:

Ve al panel de sesiones
Filtra por "Solo Activas"
Verás lista de empleados con tiempo en vivo

2. Calcular Horas de la Semana para Nómina

Objetivo: Calcular horas trabajadas de cada empleado en la semana

Cómo:

Selecciona "Rango Personalizado"
Configura: Lunes 00:00 a Domingo 23:59
Revisa la tabla "Estadísticas por Empleado"
Exporta a CSV para procesar en nómina

3. Analizar Productividad de un Empleado

Objetivo: Ver cuántas órdenes procesa un empleado por hora

Cómo:

Filtra por el empleado específico
Selecciona período (ej: "Este Mes")
Revisa columna "Órdenes" en cada sesión
Calcula: Total Órdenes / Total Horas

4. Auditar Quién Trabajaba en un Momento Específico

Objetivo: Saber quién estaba trabajando cuando ocurrió un incidente

Cómo:

Selecciona el día del incidente
Busca sesiones que incluyan la hora específica
Verifica qué empleados tenían sesión activa en ese momento

Actualización en Tiempo Real

Las sesiones activas se actualizan automáticamente:

Duración en vivo: Se recalcula cada minuto
Nuevas sesiones: Aparecen automáticamente cuando un empleado inicia sesión
Sesiones cerradas: Se mueven de "Activas" a "Completadas" al hacer logout
WebSocket: Usa conexión en tiempo real para actualizaciones inmediatas

Buenas Prácticas

✅ Revisa diariamente: Al final del día, verifica que no haya sesiones activas olvidadas.

✅ Exporta semanalmente: Descarga el reporte semanal para procesarlo en nómina.

✅ Analiza productividad: Usa las métricas de órdenes/hora para identificar empleados estrella o que necesitan capacitación.

✅ Documenta cierres manuales: Siempre agrega notas al cerrar sesiones manualmente para trazabilidad.

Solución de Problemas

No veo ninguna sesión activa pero sé que hay empleados trabajando

Verifica que: (1) Estás viendo la sucursal correcta (si tienes múltiples), (2) Los empleados iniciaron sesión con PIN (no solo abrieron la URL), (3) Refresca la página por si hay un problema de conexión WebSocket.

Las estadísticas no coinciden con lo que espero

Asegúrate de: (1) Tener seleccionado el período correcto, (2) No estar filtrando por un empleado específico cuando quieres ver el total, (3) Las órdenes/ventas solo se cuentan si fueron procesadas durante esa sesión específica.

¿Puedo ver sesiones de sucursales específicas?

Sí, si tienes múltiples sucursales, usa el selector de sucursal en la barra superior. El sistema filtrará automáticamente las sesiones de la sucursal seleccionada. Los administradores ven todas las sucursales, los empleados solo las asignadas.

La duración muestra un número extraño (ej: 480.5 horas)

Puede ser que haya una sesión que no se cerró correctamente y quedó abierta por días. Busca sesiones con check-in antiguo y check-out vacío, y ciérralas manualmente.