224 lines
8.2 KiB
Markdown
224 lines
8.2 KiB
Markdown
# 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
|