erp-clinicas/docs/08-epicas/EPIC-CL-009-reportes.md

EPICA: EPIC-CL-009 - Reportes

Metadata

Campo	Valor
ID	EPIC-CL-009
Nombre	Reportes
Modulo	reportes
Fase	Fase 1 - MVP
Prioridad	P1 (Alto)
Estado	Backlog
Story Points	25
Sprint(s)	Sprint 9-10

---

Descripcion

Dashboard y reportes para gestión clínica. Métricas de productividad médica, ocupación de consultorios, estadísticas de diagnósticos, indicadores financieros y reportes para autoridades sanitarias.

---

Objetivo de Negocio

• Visibilidad de operaciones
• Medición de productividad
• Toma de decisiones informada
• Cumplimiento de reportes regulatorios
• Identificación de oportunidades

---

Historias de Usuario

ID	Historia	Prioridad	SP	Estado
US-CL009-001	Como director, quiero ver dashboard de consultas del día en tiempo real	P0	5	Backlog
US-CL009-002	Como director, quiero ver productividad por médico (consultas/día)	P0	3	Backlog
US-CL009-003	Como director, quiero ver ocupación de consultorios por hora	P1	3	Backlog
US-CL009-004	Como director, quiero ver top 10 diagnósticos más frecuentes	P1	3	Backlog
US-CL009-005	Como admin, quiero ver reporte de ingresos vs gastos	P0	3	Backlog
US-CL009-006	Como admin, quiero generar reporte para SINBA/SISVER (autoridades)	P0	5	Backlog
US-CL009-007	Como admin, quiero exportar reportes a Excel	P0	2	Backlog
US-CL009-008	Como médico, quiero ver mi resumen de atenciones del mes	P1	1	Backlog

Total Story Points: 25 SP

---

Dashboard Principal

┌─────────────────────────────────────────────────────────┐
│              DASHBOARD CLÍNICA                          │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │ CITAS HOY    │  │ CONSULTAS    │  │ INGRESOS HOY │  │
│  │     45       │  │     38       │  │   $42,300    │  │
│  │   ▲ 12%      │  │   ▲ 8%       │  │    ▲ 15%     │  │
│  └──────────────┘  └──────────────┘  └──────────────┘  │
│                                                         │
│  PRODUCTIVIDAD POR MÉDICO (HOY)                         │
│  ┌────────────────────────────────────────────────────┐ │
│  │ Dr. García    ████████████████████ 15 consultas    │ │
│  │ Dra. López    ████████████████ 12 consultas        │ │
│  │ Dr. Martínez  ██████████ 8 consultas               │ │
│  │ Dra. Sánchez  ████████ 6 consultas                 │ │
│  └────────────────────────────────────────────────────┘ │
│                                                         │
│  OCUPACIÓN CONSULTORIOS                                 │
│  ┌────────────────────────────────────────────────────┐ │
│  │        8  9 10 11 12 13 14 15 16 17 18 19 20      │ │
│  │ C-1:  ██ ██ ██ ██ ░░ ░░ ██ ██ ██ ██ ██ ░░ ░░      │ │
│  │ C-2:  ██ ██ ██ ░░ ░░ ░░ ██ ██ ██ ██ ░░ ░░ ░░      │ │
│  │ C-3:  ░░ ██ ██ ██ ██ ░░ ██ ██ ██ ░░ ░░ ░░ ░░      │ │
│  └────────────────────────────────────────────────────┘ │
│                                                         │
│  TOP 5 DIAGNÓSTICOS (ESTE MES)                          │
│  1. J06.9 - IVAS (185 casos)                            │
│  2. I10   - Hipertensión (142 casos)                    │
│  3. E11   - Diabetes T2 (98 casos)                      │
│  4. K30   - Dispepsia (76 casos)                        │
│  5. M54.5 - Lumbalgia (54 casos)                        │
│                                                         │
└─────────────────────────────────────────────────────────┘

---

Reportes Disponibles

OPERATIVOS
├── Consultas por período
├── Productividad por médico
├── Ocupación de consultorios
├── Tiempo de espera promedio
├── Ausentismo de pacientes
└── Estudios de laboratorio realizados

CLÍNICOS
├── Diagnósticos más frecuentes
├── Medicamentos más prescritos
├── Estudios más solicitados
└── Pacientes crónicos

FINANCIEROS
├── Ingresos por servicio
├── Ingresos por aseguradora
├── Cuentas por cobrar
├── Ventas de farmacia
└── Rentabilidad por servicio

REGULATORIOS
├── SINBA (notificación epidemiológica)
├── SISVER (vigilancia epidemiológica)
├── Reporte de medicamentos controlados
└── Estadísticas para acreditación

---

Criterios de Aceptacion de la Epica

Funcionales:

• Dashboard en tiempo real
• Productividad por médico
• Ocupación de consultorios
• Top diagnósticos
• Reportes financieros
• Reportes regulatorios
• Exportación a Excel

No Funcionales:

• Carga de dashboard < 3 segundos
• Actualización cada 5 minutos
• Datos históricos de 3 años

Tecnicos:

• Agregación eficiente
• Caché de métricas
• Jobs de precálculo
• Formatos de autoridades

---

Dependencias

Esta epica depende de:

Epica/Modulo	Estado	Bloqueante
Todos los módulos anteriores	Backlog	Si

---

Desglose Tecnico

Database:

• Schema: analytics
• Tablas: 4 (daily_stats, doctor_metrics, diagnosis_stats, financial_metrics)
• Vistas materializadas para consultas frecuentes

Backend:

• Modulo: reports
• Services: MetricsAggregator, ReportGenerator
• Endpoints: 12
• Jobs: Cálculo de métricas diarias
• Tests: 20

Frontend:

• Paginas: 3 (Dashboard, Reports, Export)
• Componentes: 12 (MetricCard, ChartWidget, ReportTable, etc.)
• Librería: Chart.js
• Stores: 1 (reportsStore)

---

Endpoints API

Metodo	Endpoint	Descripcion
GET	/api/reports/dashboard	Dashboard principal
GET	/api/reports/productivity	Productividad por médico
GET	/api/reports/occupancy	Ocupación de consultorios
GET	/api/reports/diagnoses	Top diagnósticos
GET	/api/reports/financial	Métricas financieras
GET	/api/reports/export/:type	Exportar reporte
GET	/api/reports/regulatory/:type	Reporte regulatorio

---

Definition of Ready (DoR)

• Historias de usuario definidas
• Criterios de aceptacion claros
• Dependencias identificadas
• Estimacion completada
• KPIs prioritarios definidos
• Formatos regulatorios obtenidos

Definition of Done (DoD)

• Dashboard funcionando
• Reportes operativos disponibles
• Exportación funcionando
• Tests de integración pasando
• Documentación de API

---

Historial

Fecha	Cambio	Autor
2025-12-08	Creacion de epica	Claude-Agent

---

Creada por: Claude-Agent Fecha: 2025-12-08 Ultima actualizacion: 2025-12-08