278 lines
9.9 KiB
Markdown
278 lines
9.9 KiB
Markdown
# 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)
|
|
|
|
- [x] Historias de usuario definidas
|
|
- [x] Criterios de aceptacion claros
|
|
- [x] Dependencias identificadas
|
|
- [x] 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
|