spr migrated books, and tester

This commit is contained in:
buenosairesam
2025-12-31 09:07:27 -03:00
parent 21b8eab3cb
commit cccc6b5a93
136 changed files with 15763 additions and 472 deletions

View File

@@ -0,0 +1,99 @@
# 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