# 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)

- [x] Historias de usuario definidas
- [x] Criterios de aceptacion claros
- [x] Dependencias identificadas
- [x] 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
