major restructure

cfg/amar/atlas/books/gherkin-samples/es/backoffice/05-reportes.feature

@@ -0,0 +1,155 @@
+# language: es
+# Fuente: album/book/ops-templates/backoffice/05-reportes.md
+# Drive: 07. Finanzas y contabilidad/Reportes
+# Tests Backend: pytest tests/contracts/mascotas/test_stats.py
+# Tests Frontend: npx playwright test admin-reports.spec.ts
+
+Característica: Reportes y dashboard
+
+  Como administrador o gerente
+  Quiero ver metricas y generar reportes
+  Para tomar decisiones informadas
+
+  Antecedentes:
+    Dado que estoy logueado como administrador
+    Y estoy en el backoffice
+
+  # ============================================
+  # DASHBOARD
+  # ============================================
+
+  Escenario: Ver dashboard principal
+    Cuando accedo al dashboard
+    Entonces deberia ver metricas resumidas:
+      | metrica               | periodo  |
+      | Solicitudes nuevas    | Hoy      |
+      | Visitas completadas   | Semana   |
+      | Ingresos              | Mes      |
+      | Veterinarios activos  | Actual   |
+      | Tasa de conversion    | Mes      |
+
+  Escenario: Dashboard actualiza periodicamente
+    Dado que estoy en el dashboard
+    Cuando pasan 5 minutos
+    Entonces los datos deberian actualizarse
+    Y deberia ver indicador de ultima actualizacion
+
+  Escenario: Ver grafico de tendencia
+    Cuando veo el grafico de solicitudes
+    Entonces deberia ver la evolucion de los ultimos 30 dias
+    Y deberia poder comparar con periodo anterior
+
+  # ============================================
+  # REPORTE DE SOLICITUDES
+  # ============================================
+
+  Escenario: Generar reporte de solicitudes
+    Cuando voy a "Reportes" -> "Solicitudes"
+    Y selecciono periodo "Enero 2024"
+    Y hago click en "Generar"
+    Entonces deberia ver tabla con solicitudes del periodo
+    Y deberia ver totales por estado:
+      | estado      | cantidad |
+      | Pendiente   | X        |
+      | Coordinado  | X        |
+      | Pagado      | X        |
+      | Completado  | X        |
+      | Cancelado   | X        |
+
+  Escenario: Filtrar reporte por multiples criterios
+    Cuando genero reporte con filtros:
+      | filtro         | valor       |
+      | Periodo        | Enero 2024  |
+      | Zona           | Palermo     |
+      | Veterinario    | Dra. Garcia |
+      | Estado         | Completado  |
+    Entonces deberia ver solo solicitudes que cumplan todos los criterios
+
+  # ============================================
+  # REPORTE DE INGRESOS
+  # ============================================
+
+  Escenario: Ver ingresos por periodo
+    Cuando voy a "Reportes" -> "Ingresos"
+    Y selecciono "Ultimo trimestre"
+    Entonces deberia ver:
+      | dato                  |
+      | Ingresos totales      |
+      | Cantidad de pagos     |
+      | Ticket promedio       |
+      | Reembolsos realizados |
+      | Ingreso neto          |
+
+  Escenario: Ingresos agrupados por veterinario
+    Cuando agrupo el reporte por "Veterinario"
+    Entonces deberia ver para cada vet:
+      | dato                  |
+      | Visitas completadas   |
+      | Ingresos generados    |
+      | Porcentaje del total  |
+    Y deberian estar ordenados de mayor a menor
+
+  Escenario: Ingresos agrupados por servicio
+    Cuando agrupo el reporte por "Servicio"
+    Entonces deberia ver los servicios mas vendidos
+    Y deberia ver el ingreso de cada uno
+    Y deberia ver la cantidad de veces realizado
+
+  # ============================================
+  # REPORTE DE VETERINARIOS
+  # ============================================
+
+  Escenario: Ver performance de veterinarios
+    Cuando voy a "Reportes" -> "Veterinarios"
+    Entonces deberia ver para cada veterinario:
+      | metrica               |
+      | Visitas completadas   |
+      | Calificacion promedio |
+      | Tasa de aceptacion    |
+      | Tasa de cancelacion   |
+      | Ingresos generados    |
+
+  Escenario: Identificar veterinarios con problemas
+    Dado que el reporte muestra la tasa de cancelacion
+    Cuando ordeno por "Tasa de cancelacion" descendente
+    Entonces deberia ver primero los vets con mas cancelaciones
+    Y deberia poder investigar los motivos
+
+  # ============================================
+  # EXPORTACION
+  # ============================================
+
+  Esquema del escenario: Exportar reporte en diferentes formatos
+    Dado que tengo un reporte generado
+    Cuando hago click en "Exportar"
+    Y selecciono formato "<formato>"
+    Entonces deberia descargarse el archivo en formato <formato>
+
+    Ejemplos:
+      | formato |
+      | CSV     |
+      | Excel   |
+      | PDF     |
+
+  Escenario: Exportar reporte grande de forma asincrona
+    Dado que genere un reporte con mas de 10000 registros
+    Cuando hago click en "Exportar"
+    Entonces deberia ver mensaje "Generando exportacion..."
+    Y deberia recibir notificacion cuando este listo
+    Y deberia poder descargar desde el centro de notificaciones
+
+  # ============================================
+  # REPORTES PROGRAMADOS
+  # ============================================
+
+  Escenario: Programar reporte semanal
+    Cuando voy a "Reportes" -> "Programados"
+    Y creo nuevo reporte programado:
+      | campo       | valor                    |
+      | Tipo        | Ingresos                 |
+      | Frecuencia  | Semanal                  |
+      | Dia         | Lunes                    |
+      | Destinatarios | gerencia@ejemplo.com   |
+    Y guardo
+    Entonces deberia enviarse el reporte cada lunes
+    Y los destinatarios deberian recibirlo por email