¿Qué son las estadísticas generales?
El Dashboard muestra 4 tarjetas con las métricas más importantes de tu clínica:- Citas Confirmadas: Total de citas agendadas para hoy
- Citas Completadas: Citas finalizadas (marcadas automáticamente cuando pasa la hora)
- Ingresos Estimados: Suma del precio de los servicios (NO son pagos reales)
- Uso del Plan: Porcentaje de citas consumidas en el período de facturación actual
Las estadísticas se actualizan automáticamente cada 5 minutos. No es necesario refrescar la página.
Citas Confirmadas
¿Qué muestra?
Cuenta todas las citas con estadoCONFIRMED para la fecha actual (según la zona horaria de tu clínica).
¿Para qué sirve?
- Capacidad diaria: Ver cuánto está ocupada tu agenda hoy
- Comparación histórica: Identificar días de mayor/menor demanda
- Planificación: Decidir si aceptar más citas o no
Citas Completadas
¿Qué muestra?
Cuenta todas las citas con estadoCOMPLETED para la fecha actual.
¿Cómo se marcan como completadas?
El sistema ejecuta un job automático cada 60 segundos que:
- Busca citas cuya hora de fin ya pasó
- Cambia el estado de
CONFIRMED→COMPLETED - Actualiza el contador en el Dashboard
¿Para qué sirve?
- Productividad: Ver cuántas citas atendiste hoy
- Análisis de flujo: Comparar confirmadas vs completadas (¿hubo inasistencias?)
- Reportes: Base para informes de actividad mensual
Ingresos Estimados
¿Qué muestra?
Suma el precio de todos los servicios de las citas completadas del día.¿Para qué sirve?
- Proyección: Estimar facturación diaria
- Comparación: Identificar días de mayor ingreso potencial
- Planificación: Decidir qué servicios promocionar
Limitaciones
- No refleja:
- Descuentos aplicados manualmente
- Pagos parciales o adelantos
- Inasistencias (si el cliente no vino, el ingreso real es €0)
Para control financiero real, necesitas un sistema de cobros (ej: TPV, Stripe, contabilidad manual).
Uso del Plan
¿Qué muestra?
Porcentaje de citas consumidas en el período de facturación actual.Estados visuales
| Porcentaje | Color | Significado |
|---|---|---|
| 0% - 70% | Verde | Uso normal |
| 70% - 90% | Amarillo | Acercándose al límite |
| 90% - 100% | Naranja | Límite cercano |
| > 100% | Rojo | Límite excedido (overage) |
El sistema permite crear citas aunque se exceda el límite SI tienes overage habilitado.
El excedente se cobra a fin de mes según la tarifa de tu plan (ej: €0.35/cita extra en STARTER).
¿Qué cuenta como cita facturada?
- ✅ Citas creadas en el período (confirmadas, completadas o canceladas)
- ❌ Citas creadas ANTES del período (aunque se atiendan hoy)
¿Para qué sirve?
- Control de costos: Saber cuánto pagarás a fin de mes
- Planificación: Decidir si cambiar de plan o activar overage
- Alertas: Evitar sorpresas en la factura
Actualización automática
¿Cómo funciona?
El Dashboard usa polling (consultas periódicas):- Frontend hace una petición GET
/v1/dashboard/stats?clinic_id=...cada 5 minutos - Backend calcula las métricas en tiempo real (query a PostgreSQL)
- Frontend actualiza las tarjetas sin refrescar la página
Filtros y personalización
Filtros disponibles
Actualmente el Dashboard NO tiene filtros. Siempre muestra:- Fecha: Hoy (según zona horaria de la clínica)
- Clínica: La seleccionada en el menú superior
Personalizaciones futuras (planificadas)
- Filtro por rango de fechas (última semana, mes, trimestre)
- Filtro por servicio (ver ingresos solo de “Corte de pelo”)
- Filtro por proveedor (estadísticas por barbero/peluquero)
- Gráficos de tendencia (línea de tiempo de citas/ingresos)
¿Necesitas algún filtro específico? Contacta a soporte para solicitar la funcionalidad.
Casos de uso comunes
Escenario 1: Planificar el día
Objetivo: Saber cuántas citas tengo hoy y cuánto voy a facturar. Pasos:- Abre el Dashboard al iniciar el día
- Revisa “Citas Confirmadas” (ej: 15 citas)
- Revisa “Ingresos Estimados” (ej: €0 al inicio, porque ninguna se completó aún)
- A lo largo del día, las citas se completan automáticamente
- Al cierre (ej: 20:00), revisas de nuevo: 15 confirmadas, 13 completadas, €450 estimados
Escenario 2: Control del plan
Objetivo: Evitar exceder el límite del plan. Pasos:- Abre el Dashboard a mitad de mes
- Revisa “Uso del Plan”: 38 / 50 (76%)
- Calculas: Faltan 15 días → 12 citas restantes / 15 días ≈ 0.8 citas/día
- Conclusión: Estás consumiendo ~2.5 citas/día (38 / 15 días), llegarás al límite
- Acción: Activas overage o haces upgrade a PRO (200 citas/mes)
Escenario 3: Identificar días lentos
Objetivo: Comparar actividad de diferentes días. Pasos:- Lunes: Dashboard muestra 18 citas confirmadas
- Martes: 12 citas confirmadas
- Miércoles: 22 citas confirmadas
- Conclusión: Los miércoles son tu día más ocupado
- Acción: Planificas promociones para los martes (día lento)
Para análisis histórico más robusto, necesitas exportar datos a Excel o usar reportes (funcionalidad futura).
Solución de problemas
Las estadísticas no se actualizan
Causas posibles:- Cache del navegador: Refresca con Ctrl+F5 (Windows) o Cmd+Shift+R (Mac)
- Backend caído: Verifica que el servidor FastAPI esté corriendo
- Base de datos desconectada: Ejecuta
python -m app.db.management health
”Ingresos Estimados” no coincide con mis registros
Posibles razones:- Solo cuenta citas completadas: Las citas confirmadas pero no finalizadas NO suman
- Precios desactualizados: Verifica que el precio del servicio en “Servicios” sea correcto
- Citas sin servicio asignado: Si una cita no tiene servicio, su precio es €0
”Uso del Plan” muestra más de 100%
Esto es normal si:- Tienes overage habilitado en tu suscripción
- Creaste más citas que el límite mensual (ej: 55 citas en plan STARTER de 50)
- Te permite seguir creando citas
- Cobra el excedente a fin de mes (ej: 5 citas × €0.35 = €1.75 extra)