soleprint/atlas/book/feature-form-samples/feature-form/backoffice/05-reportes.md

Reportes y Dashboard

Tipo de usuario

Administrador / Gerencia

Donde empieza

Backoffice /admin/ -> Dashboard o Seccion "Reportes"

Que quiere hacer el usuario

Ver metricas del negocio, generar reportes y analizar datos

Pasos - Ver dashboard

1. Acceder al backoffice
2. Ver dashboard principal con:
   • Solicitudes del dia/semana/mes
   • Ingresos del periodo
   • Visitas completadas
   • Conversion (solicitudes -> pagos)
   • Vets activos

Pasos - Generar reporte de solicitudes

1. Ir a "Reportes" -> "Solicitudes"
2. Seleccionar rango de fechas
3. Filtrar por:
   • Estado
   • Zona
   • Veterinario
   • Tipo de servicio
4. Click "Generar"
5. Ver tabla con resultados
6. Opcion de exportar (CSV/Excel)

Pasos - Generar reporte de ingresos

1. Ir a "Reportes" -> "Ingresos"
2. Seleccionar periodo
3. Agrupar por:
   • Dia/Semana/Mes
   • Veterinario
   • Servicio
   • Zona
4. Ver grafico y tabla
5. Exportar si es necesario

Pasos - Reporte de veterinarios

1. Ir a "Reportes" -> "Veterinarios"
2. Ver para cada vet:
   • Visitas completadas
   • Calificacion promedio
   • Ingresos generados
   • Tasa de cancelacion
3. Filtrar por periodo
4. Ordenar por metrica

Pasos - Exportar datos

1. En cualquier reporte, click "Exportar"
2. Seleccionar formato (CSV, Excel)
3. Descargar archivo
4. Usar para analisis externo o contabilidad

Que deberia pasar

• Vision clara del estado del negocio
• Datos para toma de decisiones
• Reportes exportables para contabilidad
• Identificacion de tendencias

Problemas comunes

• Datos no actualizados en tiempo real
• Filtros que no devuelven lo esperado
• Discrepancia entre reportes y realidad
• Exportacion con formato incorrecto

Casos especiales

• Reporte de prueba vs produccion
• Datos historicos antes de implementar filtro
• Comparativa año vs año
• Reporte personalizado para inversores

Flujos relacionados

• Gestion de solicitudes (fuente de datos)
• Facturacion AFIP
• Google Sheets sync

Notas tecnicas

• API:
  • GET /mascotas/api/v1/stats-summary (metricas principales)
  • GET /solicitudes/api/v1/service-requests/?date_from=X&date_to=Y (datos crudos)
• Google Sheets: sincronizacion automatica via Celery
• Dashboard actualiza cada 5 minutos
• Reportes pesados: generar async y notificar cuando estan listos