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

9.7 KiB

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)

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