9.9 KiB
9.9 KiB
EPICA: EPIC-CL-004 - Consultas (Notas Médicas)
Metadata
| Campo | Valor |
|---|---|
| ID | EPIC-CL-004 |
| Nombre | Consultas (Notas Médicas) |
| Modulo | consultas |
| Fase | Fase 1 - MVP |
| Prioridad | P0 (Critico) |
| Estado | Backlog |
| Story Points | 55 |
| Sprint(s) | Sprint 4-6 |
Descripcion
Módulo 100% nuevo para documentación de consultas médicas. Incluye notas clínicas estructuradas (SOAP), signos vitales, diagnósticos con codificación CIE-10, planes de tratamiento, indicaciones y generación de documentos médicos.
Objetivo de Negocio
- Documentación clínica completa
- Cumplimiento de NOM-004-SSA3-2012
- Agilizar consulta médica
- Historial clínico consultable
- Soporte para decisiones clínicas
Historias de Usuario
| ID | Historia | Prioridad | SP | Estado |
|---|---|---|---|---|
| US-CL004-001 | Como médico, quiero iniciar consulta desde cita agendada para documentar atención | P0 | 3 | Backlog |
| US-CL004-002 | Como enfermera, quiero registrar signos vitales antes de la consulta | P0 | 5 | Backlog |
| US-CL004-003 | Como médico, quiero documentar nota clínica en formato SOAP | P0 | 8 | Backlog |
| US-CL004-004 | Como médico, quiero registrar diagnósticos con código CIE-10 | P0 | 5 | Backlog |
| US-CL004-005 | Como médico, quiero ver historial de consultas previas del paciente | P0 | 3 | Backlog |
| US-CL004-006 | Como médico, quiero generar indicaciones médicas imprimibles | P0 | 3 | Backlog |
| US-CL004-007 | Como médico, quiero usar plantillas de notas para consultas frecuentes | P1 | 5 | Backlog |
| US-CL004-008 | Como médico, quiero dictar nota por voz (speech-to-text) | P2 | 8 | Backlog |
| US-CL004-009 | Como médico, quiero agregar antecedentes a la historia clínica | P0 | 5 | Backlog |
| US-CL004-010 | Como médico, quiero cerrar consulta y liberar consultorio | P0 | 2 | Backlog |
| US-CL004-011 | Como admin, quiero configurar plantillas de notas por especialidad | P1 | 3 | Backlog |
| US-CL004-012 | Como auditor, quiero ver log de cambios en notas clínicas | P0 | 5 | Backlog |
Total Story Points: 55 SP
Formato SOAP
┌─────────────────────────────────────────────────────────┐
│ NOTA CLÍNICA - FORMATO SOAP │
├─────────────────────────────────────────────────────────┤
│ │
│ S - SUBJETIVO (Lo que el paciente refiere) │
│ ├── Motivo de consulta │
│ ├── Historia de la enfermedad actual │
│ ├── Síntomas referidos │
│ └── Evolución desde última visita │
│ │
│ O - OBJETIVO (Lo que el médico observa/mide) │
│ ├── Signos vitales │
│ │ ├── T/A: 120/80 mmHg │
│ │ ├── FC: 72 lpm │
│ │ ├── FR: 16 rpm │
│ │ ├── Temp: 36.5°C │
│ │ ├── Peso: 70 kg │
│ │ ├── Talla: 170 cm │
│ │ └── IMC: 24.2 │
│ ├── Exploración física │
│ └── Resultados de estudios │
│ │
│ A - ANÁLISIS (Diagnósticos) │
│ ├── Diagnóstico principal (CIE-10) │
│ ├── Diagnósticos secundarios │
│ └── Diagnósticos diferenciales │
│ │
│ P - PLAN (Tratamiento) │
│ ├── Medicamentos (→ Receta) │
│ ├── Estudios solicitados (→ Lab/Imagen) │
│ ├── Indicaciones generales │
│ ├── Referencia a especialista │
│ └── Próxima cita │
│ │
└─────────────────────────────────────────────────────────┘
Flujo de Consulta
┌─────────────┐
│ CHECK-IN │ ← Paciente llega
└──────┬──────┘
│
▼
┌─────────────┐
│SIGNOS VITAL │ ← Enfermera registra
└──────┬──────┘
│
▼
┌─────────────┐
│ EN_CONSULTA │ ← Médico inicia
└──────┬──────┘
│
├── Revisar historial
├── Documentar SOAP
├── Generar receta
├── Solicitar estudios
│
▼
┌─────────────┐
│ CERRADA │ ← Consulta finalizada
└──────┬──────┘
│
▼
┌─────────────┐
│ FACTURAR │ ← Proceso de cobro
└─────────────┘
Criterios de Aceptacion de la Epica
Funcionales:
- Iniciar consulta desde cita
- Registrar signos vitales
- Documentar nota SOAP completa
- Codificar diagnósticos CIE-10
- Ver historial de consultas
- Generar indicaciones imprimibles
- Plantillas de notas
- Registro de antecedentes
- Auditoría de cambios
No Funcionales:
- Autoguardado cada 30 segundos
- Búsqueda de CIE-10 < 500ms
- Notas no editables después de cierre
- Cumplimiento NOM-004-SSA3-2012
Tecnicos:
- Catálogo CIE-10 integrado
- Editor de texto enriquecido
- Opcional: Speech-to-text
- Generación de PDFs
Dependencias
Esta epica depende de:
| Epica/Modulo | Estado | Bloqueante |
|---|---|---|
| EPIC-CL-001 Fundamentos | Backlog | Si |
| EPIC-CL-002 Pacientes | Backlog | Si |
| EPIC-CL-003 Citas | Backlog | Si |
Esta epica bloquea:
| Epica/Modulo | Razon |
|---|---|
| EPIC-CL-005 Recetas | Requiere consulta para prescribir |
| EPIC-CL-006 Laboratorio | Requiere consulta para solicitar |
| EPIC-CL-011 Expediente | Requiere notas clínicas |
Desglose Tecnico
Database:
- Schema:
consultations - Tablas: 10 (consultations, vital_signs, diagnoses, treatments, indications, templates, medical_history, antecedents, note_versions, audit_log)
- Funciones: 3 (search_icd10, calculate_bmi, lock_consultation)
- Indices: Por paciente, médico, fecha, diagnóstico
Backend:
- Modulo:
consultations - Entities: 8 (Consultation, VitalSigns, Diagnosis, Treatment, Template, MedicalHistory, Antecedent, NoteVersion)
- Endpoints: 20
- Tests: 40
Frontend:
- Paginas: 5 (ConsultationRoom, VitalSignsForm, SOAPEditor, HistoryView, Templates)
- Componentes: 18 (SOAPSection, ICD10Search, VitalsWidget, HistoryTimeline, etc.)
- Editor WYSIWYG para notas
- Stores: 2 (consultationsStore, icd10Store)
Endpoints API
| Metodo | Endpoint | Descripcion |
|---|---|---|
| POST | /api/consultations | Iniciar consulta |
| GET | /api/consultations/:id | Detalle de consulta |
| PATCH | /api/consultations/:id | Actualizar nota |
| POST | /api/consultations/:id/vitals | Registrar signos vitales |
| POST | /api/consultations/:id/diagnoses | Agregar diagnóstico |
| POST | /api/consultations/:id/close | Cerrar consulta |
| GET | /api/consultations/history/:patientId | Historial del paciente |
| GET | /api/icd10/search | Buscar código CIE-10 |
| GET | /api/templates | Listar plantillas |
| POST | /api/templates | Crear plantilla |
Catálogo CIE-10
Ejemplos de códigos frecuentes:
├── J00 - Rinofaringitis aguda (resfriado común)
├── J06.9 - Infección aguda de las vías respiratorias
├── E11 - Diabetes mellitus tipo 2
├── I10 - Hipertensión esencial
├── K30 - Dispepsia funcional
├── M54.5 - Dolor lumbar
└── F32 - Episodio depresivo
Riesgos
| Riesgo | Probabilidad | Impacto | Mitigacion |
|---|---|---|---|
| Pérdida de notas | Baja | Alto | Autoguardado + versiones |
| Diagnóstico incorrecto | Media | Alto | Búsqueda asistida CIE-10 |
| Notas incompletas | Media | Medio | Validación antes de cerrar |
Nota Técnica
Este módulo es 100% nuevo y no tiene equivalente en el ERP-Core. Es específico para el sector salud y debe cumplir con las NOM mexicanas aplicables a expedientes clínicos electrónicos.
Definition of Ready (DoR)
- Historias de usuario definidas
- Criterios de aceptacion claros
- Dependencias identificadas
- Estimacion completada
- Catálogo CIE-10 importado
- Plantillas iniciales definidas
Definition of Done (DoD)
- Flujo completo de consulta
- Formato SOAP funcionando
- Búsqueda CIE-10 operativa
- Auditoría de cambios
- 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