# EPICA: EPIC-CL-011 - Expediente Clínico Electrónico

## Metadata

| Campo | Valor |
|-------|-------|
| **ID** | EPIC-CL-011 |
| **Nombre** | Expediente Clínico Electrónico |
| **Modulo** | expediente |
| **Fase** | Fase 1 - MVP |
| **Prioridad** | P0 (Critico) |
| **Estado** | Backlog |
| **Story Points** | 30 |
| **Sprint(s)** | Sprint 10 |

---

## Descripcion

Vista consolidada del expediente clínico electrónico del paciente. Integra toda la información médica: datos personales, antecedentes, consultas, diagnósticos, recetas, estudios de laboratorio e imagen. Cumple con NOM-024-SSA3-2012.

---

## Objetivo de Negocio

- Historia clínica completa
- Cumplimiento normativo
- Acceso rápido a información
- Continuidad de atención
- Soporte a decisiones clínicas

---

## Historias de Usuario

| ID | Historia | Prioridad | SP | Estado |
|----|----------|-----------|-----|--------|
| US-CL011-001 | Como médico, quiero ver resumen ejecutivo del paciente en una pantalla | P0 | 5 | Backlog |
| US-CL011-002 | Como médico, quiero ver línea de tiempo de atenciones | P0 | 5 | Backlog |
| US-CL011-003 | Como médico, quiero ver todos los diagnósticos históricos | P0 | 3 | Backlog |
| US-CL011-004 | Como médico, quiero ver todos los medicamentos recetados | P0 | 3 | Backlog |
| US-CL011-005 | Como médico, quiero ver resultados de laboratorio con gráficas de tendencia | P0 | 5 | Backlog |
| US-CL011-006 | Como médico, quiero ver estudios de imagen (DICOM viewer) | P1 | 5 | Backlog |
| US-CL011-007 | Como paciente, quiero descargar mi expediente completo en PDF | P1 | 2 | Backlog |
| US-CL011-008 | Como admin, quiero configurar permisos de acceso al expediente | P0 | 2 | Backlog |

**Total Story Points:** 30 SP

---

## Estructura del Expediente (NOM-024)

```
┌─────────────────────────────────────────────────────────┐
│              EXPEDIENTE CLÍNICO ELECTRÓNICO             │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  DATOS DE IDENTIFICACIÓN                                │
│  ├── Nombre completo                                    │
│  ├── Fecha de nacimiento / Edad                         │
│  ├── Sexo                                               │
│  ├── CURP                                               │
│  └── Datos de contacto                                  │
│                                                         │
│  ANTECEDENTES                                           │
│  ├── Heredo-familiares                                  │
│  ├── Personales no patológicos                          │
│  ├── Personales patológicos                             │
│  ├── Gineco-obstétricos (si aplica)                     │
│  └── Alergias                                           │
│                                                         │
│  NOTAS MÉDICAS                                          │
│  ├── Historia clínica inicial                           │
│  ├── Notas de evolución                                 │
│  ├── Notas de interconsulta                             │
│  └── Notas de egreso                                    │
│                                                         │
│  ESTUDIOS                                               │
│  ├── Laboratorio                                        │
│  │   ├── Resultados                                     │
│  │   └── Gráficas de tendencia                          │
│  └── Imagenología                                       │
│      ├── Radiografías                                   │
│      ├── Ultrasonidos                                   │
│      └── Tomografías/Resonancias                        │
│                                                         │
│  PRESCRIPCIONES                                         │
│  ├── Recetas emitidas                                   │
│  └── Medicamentos actuales                              │
│                                                         │
│  CONSENTIMIENTOS                                        │
│  └── Firmados digitalmente                              │
│                                                         │
└─────────────────────────────────────────────────────────┘
```

---

## Vista de Timeline

```
┌─────────────────────────────────────────────────────────┐
│  LÍNEA DE TIEMPO - JUAN PÉREZ                           │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  DIC 2024                                               │
│  ├── 08 │ 💊 Receta - Antibiótico 7 días               │
│  ├── 08 │ 🩺 Consulta - Dr. García (IVAS)              │
│  ├── 05 │ 🧪 Laboratorio - Biometría hemática          │
│  │                                                      │
│  NOV 2024                                               │
│  ├── 22 │ 💊 Receta - Antihipertensivos                │
│  ├── 22 │ 🩺 Consulta - Dr. López (Control HTA)        │
│  ├── 15 │ 🧪 Laboratorio - Química sanguínea           │
│  │                                                      │
│  OCT 2024                                               │
│  ├── 10 │ 📷 Imagen - Rx Tórax                         │
│  ├── 10 │ 🩺 Consulta - Dr. García (Tos crónica)       │
│  │                                                      │
│  SEP 2024                                               │
│  ├── 05 │ 🩺 Primera consulta - Historia clínica       │
│  └── 05 │ ✍️ Consentimiento informado firmado          │
│                                                         │
└─────────────────────────────────────────────────────────┘
```

---

## Criterios de Aceptacion de la Epica

**Funcionales:**
- [ ] Resumen ejecutivo del paciente
- [ ] Línea de tiempo de atenciones
- [ ] Vista de diagnósticos históricos
- [ ] Vista de medicamentos
- [ ] Gráficas de laboratorio
- [ ] Visor DICOM básico
- [ ] Exportar expediente PDF
- [ ] Control de acceso

**No Funcionales:**
- [ ] Carga de expediente < 3 segundos
- [ ] Cumplimiento NOM-024-SSA3-2012
- [ ] Auditoría de accesos

**Tecnicos:**
- [ ] Integración de todos los módulos
- [ ] Visor DICOM (Cornerstone.js)
- [ ] Generación de PDF estructurado
- [ ] Gráficas con Chart.js

---

## Dependencias

**Esta epica depende de:**
| Epica/Modulo | Estado | Bloqueante |
|--------------|--------|------------|
| EPIC-CL-002 Pacientes | Backlog | Si |
| EPIC-CL-004 Consultas | Backlog | Si |
| EPIC-CL-005 Recetas | Backlog | Si |
| EPIC-CL-006 Laboratorio | Backlog | Si |
| EPIC-CL-012 Imagenología | Backlog | Parcial |

---

## Desglose Tecnico

**Database:**
- [ ] No requiere tablas nuevas (agrega datos de otros módulos)
- [ ] Vistas optimizadas para consolidación

**Backend:**
- [ ] Modulo: `medical-record`
- [ ] Services: RecordAggregator, PDFExporter
- [ ] Endpoints: 8
- [ ] Tests: 20

**Frontend:**
- [ ] Paginas: 3 (RecordOverview, Timeline, Export)
- [ ] Componentes: 15 (SummaryCard, Timeline, DiagnosisHistory, LabTrends, DICOMViewer, etc.)
- [ ] Visor DICOM con Cornerstone.js
- [ ] Stores: 1 (recordStore)

---

## Endpoints API

| Metodo | Endpoint | Descripcion |
|--------|----------|-------------|
| GET | /api/medical-record/:patientId | Expediente completo |
| GET | /api/medical-record/:patientId/summary | Resumen ejecutivo |
| GET | /api/medical-record/:patientId/timeline | Línea de tiempo |
| GET | /api/medical-record/:patientId/diagnoses | Historial de diagnósticos |
| GET | /api/medical-record/:patientId/medications | Historial de medicamentos |
| GET | /api/medical-record/:patientId/labs/trends | Tendencias de laboratorio |
| GET | /api/medical-record/:patientId/export | Exportar PDF |

---

## Riesgos

| Riesgo | Probabilidad | Impacto | Mitigacion |
|--------|--------------|---------|------------|
| Expediente incompleto | Media | Alto | Validar datos mínimos |
| Acceso no autorizado | Baja | Alto | RBAC + auditoría |
| Carga lenta | Media | Medio | Paginación + caché |

---

## Definition of Ready (DoR)

- [x] Historias de usuario definidas
- [x] Criterios de aceptacion claros
- [x] Dependencias identificadas
- [x] Estimacion completada
- [ ] Estructura NOM-024 documentada
- [ ] Diseño de UI aprobado

## Definition of Done (DoD)

- [ ] Vista consolidada funcionando
- [ ] Timeline operativo
- [ ] Visor DICOM básico
- [ ] Exportación PDF
- [ ] 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