erp-clinicas/docs/08-epicas/EPIC-CL-011-expediente.md

242 lines
9.7 KiB
Markdown

# 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