520 lines
15 KiB
Markdown
520 lines
15 KiB
Markdown
# 📋 PLAN DE CREACIÓN DE CONTENIDO MÉDICO
|
|
|
|
**Fecha:** 2025-01-07
|
|
**Estado:** 🚀 LISTO PARA EJECUTAR
|
|
**Referencia:** `docs/CONTENIDO_MEDICO_FALTANTE.md`
|
|
|
|
---
|
|
|
|
## 🎯 OBJETIVO
|
|
|
|
Crear sistemáticamente el contenido médico faltante según prioridades clínicas, siguiendo estructura y formato consistente con el contenido existente.
|
|
|
|
---
|
|
|
|
## 📊 VISIÓN GENERAL
|
|
|
|
| Fase | Contenido | Prioridad | Esfuerzo | Estado |
|
|
|------|-----------|-----------|----------|--------|
|
|
| **FASE 1** | 15 Temas Críticos (FASE B) | 🔴 CRÍTICA | 80-100h | ⏳ Pendiente |
|
|
| **FASE 2** | Alta Prioridad | 🟠 ALTA | 60-80h | ⏳ Pendiente |
|
|
| **FASE 3** | Vademécum (21 fármacos) | 🟠 ALTA | 20-30h | ⏳ Pendiente |
|
|
| **FASE 4** | Complementarios | 🟡 MEDIA | 100-150h | ⏳ Pendiente |
|
|
| **TOTAL** | 65 protocolos + 24 guías + 21 fármacos | | **260-360h** | |
|
|
|
|
---
|
|
|
|
## 🔴 FASE 1: TEMAS CRÍTICOS (Semanas 1-4)
|
|
|
|
### Objetivo
|
|
Crear los 15 temas críticos de FASE B que son esenciales para operación TES.
|
|
|
|
### Priorización Interna
|
|
|
|
#### PRIORIDAD 1A - Urgencia Vital (Semana 1)
|
|
Temas que pueden salvar vidas en minutos:
|
|
|
|
1. **Convulsiones** ❌ (No existe)
|
|
- Protocolo: `convulsiones`
|
|
- Guía: 8 secciones
|
|
- Razón: Emergencia neurológica frecuente, puede ser fatal si no se maneja correctamente
|
|
|
|
2. **Control de Hemorragias Externas** ⚠️
|
|
- Protocolo: `control-hemorragias-externas`
|
|
- Guía: 8 secciones
|
|
- Razón: Primera causa de muerte evitable en trauma
|
|
|
|
3. **Uso de Torniquetes** ⚠️
|
|
- Protocolo: `uso-torniquetes`
|
|
- Guía: 8 secciones
|
|
- Razón: Crítico para hemorragias masivas, uso incorrecto puede causar lesiones
|
|
|
|
4. **Shock Séptico** ❌ (No existe)
|
|
- Protocolo: `shock-septico`
|
|
- Guía: 8 secciones
|
|
- Razón: Reconocimiento y manejo temprano salvan vidas
|
|
|
|
#### PRIORIDAD 1B - Alta Frecuencia (Semana 2)
|
|
5. **Ictus Completo** ⚠️
|
|
- Protocolo: `ictus-completo`
|
|
- Guía: 8 secciones
|
|
- Razón: Ventana de tiempo crítica para tratamiento
|
|
|
|
6. **Trauma Politrauma** ⚠️
|
|
- Protocolo: `trauma-politrauma`
|
|
- Guía: 8 secciones
|
|
- Razón: Requiere abordaje sistemático estructurado
|
|
|
|
7. **TCE** ⚠️
|
|
- Protocolo: `tce`
|
|
- Guía: 8 secciones
|
|
- Razón: Deterioro rápido si no se maneja correctamente
|
|
|
|
8. **Alteración de Conciencia** ⚠️
|
|
- Protocolo: `alteracion-conciencia`
|
|
- Guía: 8 secciones
|
|
- Razón: Múltiples causas reversibles (4H y 4T)
|
|
|
|
#### PRIORIDAD 1C - Soporte Vital (Semana 3)
|
|
9. **Shock Hipovolémico** ⚠️ (Solo falta guía formativa)
|
|
- Guía: 8 secciones (protocolo ya existe)
|
|
|
|
10. **Aspiración de Secreciones** ⚠️
|
|
- Protocolo: `aspiracion-secreciones`
|
|
- Guía: 8 secciones
|
|
|
|
11. **Ventilación con AMBU** ⚠️
|
|
- Protocolo: `ventilacion-ambu`
|
|
- Guía: 8 secciones
|
|
|
|
12. **Reevaluación ABCDE** ⚠️
|
|
- Protocolo: `reevaluacion-abcde`
|
|
- Guía: 8 secciones
|
|
|
|
#### PRIORIDAD 1D - Completar FASE B (Semana 4)
|
|
13. **Valoración Secundaria + SAMPLE** ⚠️
|
|
- Protocolo: `valoracion-secundaria-sample`
|
|
- Guía: 8 secciones
|
|
|
|
14. **Preparación Intubación** ❌ (No existe)
|
|
- Protocolo: `preparacion-intubacion`
|
|
- Guía: 8 secciones
|
|
|
|
15. **Vademécum - Primera Línea Crítica** (Inicio, continuar en FASE 3)
|
|
- Flumazenil (antídoto crítico)
|
|
|
|
---
|
|
|
|
## 📝 PLANTILLAS Y ESTRUCTURAS
|
|
|
|
### Plantilla Protocolo Operativo
|
|
|
|
```typescript
|
|
{
|
|
id: 'nombre-protocolo', // kebab-case
|
|
title: 'Título Completo',
|
|
shortTitle: 'Título Corto',
|
|
category: 'soporte_vital' | 'patologias' | 'escena',
|
|
subcategory?: 'rcp' | 'shock' | 'trauma' | 'neurologia' | 'respiratorio' | 'cardiologia',
|
|
priority: 'critico' | 'alto' | 'medio' | 'bajo',
|
|
ageGroup: 'adulto' | 'pediatrico' | 'neonatal' | 'todos',
|
|
steps: [
|
|
'Paso 1: Acción específica y medible',
|
|
'Paso 2: Acción específica y medible',
|
|
// ... mínimo 5-10 pasos
|
|
],
|
|
warnings: [
|
|
'Advertencia crítica 1',
|
|
'Advertencia crítica 2',
|
|
// ... advertencias de seguridad
|
|
],
|
|
keyPoints?: [
|
|
'Punto clave para recordar 1',
|
|
'Punto clave para recordar 2',
|
|
// ... puntos educativos importantes
|
|
],
|
|
equipment?: [
|
|
'Material necesario 1',
|
|
'Material necesario 2',
|
|
// ... equipo requerido
|
|
],
|
|
drugs?: [
|
|
'Fármaco indicado 1',
|
|
'Fármaco indicado 2',
|
|
// ... fármacos relevantes
|
|
]
|
|
}
|
|
```
|
|
|
|
**Ubicación:** `src/data/procedures.ts`
|
|
|
|
### Plantilla Guía de Refuerzo
|
|
|
|
Cada guía tiene **8 secciones obligatorias** en `docs/consolidado/`:
|
|
|
|
```
|
|
SECCION_01_[NOMBRE].md - Introducción y Contexto
|
|
SECCION_02_[NOMBRE].md - Explicación Clínica y Fisiopatología
|
|
SECCION_03_[NOMBRE].md - Algoritmo Comentado Visual
|
|
SECCION_04_[NOMBRE].md - Medios Visuales y Demostración
|
|
SECCION_05_[NOMBRE].md - Errores Frecuentes Visualizados
|
|
SECCION_06_[NOMBRE].md - Casos Clínicos
|
|
SECCION_07_[NOMBRE].md - Simulación Mental Guiada
|
|
SECCION_08_[NOMBRE].md - Resumen Visual y Puente al Operativo
|
|
```
|
|
|
|
**Estructura mínima por sección:**
|
|
- Introducción contextual
|
|
- Contenido clínico estructurado
|
|
- Referencias visuales (si aplica)
|
|
- Ejemplos prácticos
|
|
- Enlace al protocolo operativo relacionado
|
|
|
|
**Ubicación:** `docs/consolidado/`
|
|
|
|
**Registro en índice:**
|
|
```typescript
|
|
{
|
|
id: "nombre-guia", // kebab-case, debe coincidir con slug
|
|
titulo: "Título Completo",
|
|
descripcion: "Descripción breve del propósito formativo",
|
|
icono: "NombreIconoLucide", // de lucide-react
|
|
secciones: [
|
|
{ numero: 1, titulo: "...", archivo: "...", ruta: "..." },
|
|
// ... 8 secciones
|
|
],
|
|
protocoloOperativo?: {
|
|
titulo: "Nombre Protocolo",
|
|
ruta: "/ruta-al-protocolo"
|
|
}
|
|
}
|
|
```
|
|
|
|
**Ubicación:** `src/data/guides-index.ts`
|
|
|
|
### Plantilla Fármaco
|
|
|
|
```typescript
|
|
{
|
|
id: 'nombre-generico', // kebab-case
|
|
genericName: 'Nombre Genérico',
|
|
tradeName: 'Nombre Comercial / Presentación',
|
|
category: 'cardiovascular' | 'respiratorio' | 'neurologico' | 'analgesia' | 'oxigenoterapia' | 'otros',
|
|
presentation: 'Descripción completa de la presentación',
|
|
adultDose: 'Dosis adulto: cantidad, vía, frecuencia',
|
|
pediatricDose?: 'Dosis pediátrica: cantidad/kg, vía, frecuencia',
|
|
routes: ['IV', 'IM', 'SC', 'IO', 'Nebulizado', 'SL', 'Rectal', 'Nasal'],
|
|
dilution?: 'Instrucciones de dilución si aplica',
|
|
indications: [
|
|
'Indicación 1',
|
|
'Indicación 2',
|
|
// ... todas las indicaciones
|
|
],
|
|
contraindications: [
|
|
'Contraindicación absoluta 1',
|
|
'Contraindicación relativa 2',
|
|
// ... todas las contraindicaciones
|
|
],
|
|
sideEffects?: [
|
|
'Efecto adverso 1',
|
|
'Efecto adverso 2',
|
|
// ... efectos adversos relevantes
|
|
],
|
|
antidote?: 'Antídoto si existe',
|
|
notes?: [
|
|
'Nota clínica importante 1',
|
|
'Nota clínica importante 2',
|
|
// ... notas relevantes
|
|
],
|
|
criticalPoints?: [
|
|
'Punto crítico TES 1',
|
|
'Punto crítico TES 2',
|
|
// ... puntos específicos para TES
|
|
],
|
|
source?: 'Fuente del manual o guía'
|
|
}
|
|
```
|
|
|
|
**Ubicación:** `src/data/drugs.ts`
|
|
|
|
---
|
|
|
|
## 🔄 PROCESO DE CREACIÓN
|
|
|
|
### Para Protocolos Operativos
|
|
|
|
1. **Investigación y Validación**
|
|
- Revisar guías oficiales (ERC, AHA, SEMES)
|
|
- Verificar contenido existente en manual (`docs/MANUAL_TES_DIGITAL.md`)
|
|
- Consultar con validación médica si es necesario
|
|
|
|
2. **Creación del Protocolo**
|
|
- Crear objeto según plantilla en `src/data/procedures.ts`
|
|
- Verificar que todos los campos estén completos
|
|
- Validar formato y estructura
|
|
|
|
3. **Mapeo y Relaciones**
|
|
- Añadir mapeo en `src/data/protocol-guide-manual-mapping.ts` si aplica
|
|
- Definir relaciones bidireccionales (protocolo ↔ guía ↔ manual)
|
|
|
|
4. **Pruebas**
|
|
- Verificar que el protocolo se muestra correctamente en frontend
|
|
- Verificar que sincroniza correctamente a la base de datos
|
|
- Verificar que aparece en Content Pack
|
|
|
|
### Para Guías de Refuerzo
|
|
|
|
1. **Planificación**
|
|
- Definir las 8 secciones y su contenido específico
|
|
- Identificar medios visuales necesarios
|
|
- Planificar casos clínicos relevantes
|
|
|
|
2. **Creación de Secciones**
|
|
- Crear cada una de las 8 secciones en Markdown
|
|
- Seguir estructura estándar (ver ejemplos existentes)
|
|
- Incluir referencias visuales cuando sea posible
|
|
- Añadir enlaces al protocolo operativo relacionado
|
|
|
|
3. **Registro en Índice**
|
|
- Añadir entrada en `src/data/guides-index.ts`
|
|
- Verificar que las 8 secciones estén correctamente referenciadas
|
|
- Definir relación con protocolo operativo
|
|
|
|
4. **Validación**
|
|
- Revisar coherencia entre secciones
|
|
- Verificar que el contenido educativo es claro
|
|
- Validar que no contradice el protocolo operativo
|
|
|
|
### Para Fármacos
|
|
|
|
1. **Recopilación de Información**
|
|
- Dosis según guías oficiales
|
|
- Indicaciones aprobadas
|
|
- Contraindicaciones y precauciones
|
|
- Efectos adversos relevantes
|
|
|
|
2. **Creación del Fármaco**
|
|
- Crear objeto según plantilla en `src/data/drugs.ts`
|
|
- Verificar dosis pediátricas (si aplica)
|
|
- Validar información clínica
|
|
|
|
3. **Validación**
|
|
- Verificar contra fuentes oficiales
|
|
- Asegurar consistencia con otros fármacos similares
|
|
- Validación médica antes de publicar
|
|
|
|
---
|
|
|
|
## 📅 CRONOGRAMA DETALLADO - FASE 1
|
|
|
|
### Semana 1: Urgencias Vitales (20-25 horas)
|
|
|
|
**Día 1-2: Convulsiones** (6-8 horas)
|
|
- [ ] Crear protocolo `convulsiones` en `procedures.ts`
|
|
- [ ] Crear 8 secciones de guía formativa
|
|
- [ ] Registrar guía en `guides-index.ts`
|
|
- [ ] Sincronizar a DB
|
|
- [ ] Validar en frontend
|
|
|
|
**Día 3: Control Hemorragias** (4-5 horas)
|
|
- [ ] Crear protocolo `control-hemorragias-externas`
|
|
- [ ] Crear 8 secciones de guía
|
|
- [ ] Registrar en índice
|
|
- [ ] Sincronizar y validar
|
|
|
|
**Día 4: Uso Torniquetes** (4-5 horas)
|
|
- [ ] Crear protocolo `uso-torniquetes`
|
|
- [ ] Crear 8 secciones de guía
|
|
- [ ] Registrar en índice
|
|
- [ ] Sincronizar y validar
|
|
|
|
**Día 5: Shock Séptico** (6-7 horas)
|
|
- [ ] Crear protocolo `shock-septico`
|
|
- [ ] Crear 8 secciones de guía
|
|
- [ ] Registrar en índice
|
|
- [ ] Sincronizar y validar
|
|
|
|
### Semana 2: Alta Frecuencia (20-25 horas)
|
|
|
|
**Día 1-2: Ictus Completo** (6-8 horas)
|
|
- [ ] Crear protocolo `ictus-completo`
|
|
- [ ] Crear 8 secciones de guía
|
|
- [ ] Registrar en índice
|
|
- [ ] Sincronizar y validar
|
|
|
|
**Día 3: Trauma Politrauma** (6-8 horas)
|
|
- [ ] Crear protocolo `trauma-politrauma`
|
|
- [ ] Crear 8 secciones de guía
|
|
- [ ] Registrar en índice
|
|
- [ ] Sincronizar y validar
|
|
|
|
**Día 4: TCE** (4-5 horas)
|
|
- [ ] Crear protocolo `tce`
|
|
- [ ] Crear 8 secciones de guía
|
|
- [ ] Registrar en índice
|
|
- [ ] Sincronizar y validar
|
|
|
|
**Día 5: Alteración Conciencia** (4-4 horas)
|
|
- [ ] Crear protocolo `alteracion-conciencia`
|
|
- [ ] Crear 8 secciones de guía
|
|
- [ ] Registrar en índice
|
|
- [ ] Sincronizar y validar
|
|
|
|
### Semana 3: Soporte Vital (20-25 horas)
|
|
|
|
**Día 1: Shock Hipovolémico** (2-3 horas)
|
|
- [ ] Crear 8 secciones de guía (protocolo ya existe)
|
|
- [ ] Registrar guía en índice
|
|
- [ ] Sincronizar y validar
|
|
|
|
**Día 2-3: Aspiración y Ventilación** (8-10 horas)
|
|
- [ ] Crear protocolo `aspiracion-secreciones`
|
|
- [ ] Crear protocolo `ventilacion-ambu`
|
|
- [ ] Crear 8 secciones para cada guía (16 total)
|
|
- [ ] Registrar en índices
|
|
- [ ] Sincronizar y validar
|
|
|
|
**Día 4-5: Reevaluación ABCDE** (8-10 horas)
|
|
- [ ] Crear protocolo `reevaluacion-abcde`
|
|
- [ ] Crear 8 secciones de guía
|
|
- [ ] Registrar en índice
|
|
- [ ] Sincronizar y validar
|
|
|
|
### Semana 4: Completar FASE B (20-25 horas)
|
|
|
|
**Día 1-2: Valoración Secundaria** (6-8 horas)
|
|
- [ ] Crear protocolo `valoracion-secundaria-sample`
|
|
- [ ] Crear 8 secciones de guía
|
|
- [ ] Registrar en índice
|
|
- [ ] Sincronizar y validar
|
|
|
|
**Día 3-4: Preparación Intubación** (8-10 horas)
|
|
- [ ] Crear protocolo `preparacion-intubacion`
|
|
- [ ] Crear 8 secciones de guía
|
|
- [ ] Registrar en índice
|
|
- [ ] Sincronizar y validar
|
|
|
|
**Día 5: Revisión y Ajustes** (4-5 horas)
|
|
- [ ] Revisar todo el contenido creado
|
|
- [ ] Verificar consistencia y calidad
|
|
- [ ] Corregir errores encontrados
|
|
- [ ] Validar en frontend completo
|
|
- [ ] Documentar lecciones aprendidas
|
|
|
|
---
|
|
|
|
## ✅ CHECKLIST DE CALIDAD
|
|
|
|
### Para cada Protocolo Operativo:
|
|
- [ ] Todos los campos requeridos están completos
|
|
- [ ] Steps son claros, específicos y medibles
|
|
- [ ] Warnings incluyen todas las precauciones críticas
|
|
- [ ] KeyPoints resumen información esencial
|
|
- [ ] Equipment listado correctamente
|
|
- [ ] Drugs listados correctamente
|
|
- [ ] Validado contra guías oficiales
|
|
- [ ] Probado en frontend
|
|
- [ ] Sincronizado correctamente a DB
|
|
- [ ] Aparece en Content Pack
|
|
|
|
### Para cada Guía de Refuerzo:
|
|
- [ ] Las 8 secciones están completas
|
|
- [ ] Cada sección tiene contenido significativo
|
|
- [ ] Estructura consistente entre secciones
|
|
- [ ] Enlaces al protocolo operativo funcionan
|
|
- [ ] Contenido educativo es claro y preciso
|
|
- [ ] No contradice el protocolo operativo
|
|
- [ ] Registrada correctamente en `guides-index.ts`
|
|
- [ ] Probada en frontend
|
|
- [ ] Sincronizada correctamente a DB
|
|
|
|
### Para cada Fármaco:
|
|
- [ ] Todos los campos requeridos están completos
|
|
- [ ] Dosis adultas son precisas
|
|
- [ ] Dosis pediátricas incluidas (si aplica)
|
|
- [ ] Indicaciones son correctas
|
|
- [ ] Contraindicaciones son completas
|
|
- [ ] Efectos adversos relevantes incluidos
|
|
- [ ] CriticalPoints específicos para TES
|
|
- [ ] Validado contra fuentes oficiales
|
|
- [ ] Probado en frontend
|
|
- [ ] Sincronizado correctamente a DB
|
|
|
|
---
|
|
|
|
## 🔍 VALIDACIÓN Y REVISIÓN
|
|
|
|
### Validación Técnica
|
|
- [ ] Código sin errores de sintaxis
|
|
- [ ] Tipos TypeScript correctos
|
|
- [ ] Archivos en ubicaciones correctas
|
|
- [ ] Sincronización a DB exitosa
|
|
- [ ] Content Pack incluye nuevo contenido
|
|
- [ ] Frontend muestra contenido correctamente
|
|
|
|
### Validación Clínica
|
|
- [ ] Contenido basado en guías oficiales
|
|
- [ ] Información médica precisa
|
|
- [ ] Dosis y procedimientos correctos
|
|
- [ ] Sin contradicciones con contenido existente
|
|
- [ ] Revisión por profesional médico (si es posible)
|
|
|
|
### Validación de Calidad
|
|
- [ ] Formato consistente con contenido existente
|
|
- [ ] Ortografía y gramática correctas
|
|
- [ ] Estructura lógica y clara
|
|
- [ ] Enlaces y referencias funcionan
|
|
- [ ] Navegación intuitiva
|
|
|
|
---
|
|
|
|
## 📝 NOTAS Y RECOMENDACIONES
|
|
|
|
### Priorización
|
|
1. **Siempre empezar por temas críticos (FASE 1)** - pueden salvar vidas
|
|
2. **Crear protocolo operativo ANTES de la guía formativa** - la guía referencia al protocolo
|
|
3. **Validar cada tema antes de pasar al siguiente** - evita errores acumulados
|
|
|
|
### Eficiencia
|
|
- **Reutilizar estructura** de contenido existente similar
|
|
- **Revisar manual** antes de crear contenido nuevo (puede ya existir parcialmente)
|
|
- **Crear en lotes** temas relacionados (ej: todos los protocolos de trauma juntos)
|
|
|
|
### Calidad
|
|
- **No apresurarse** - mejor contenido completo que rápido e incompleto
|
|
- **Documentar fuentes** - importante para validación médica futura
|
|
- **Mantener consistencia** - seguir formato existente estrictamente
|
|
|
|
---
|
|
|
|
## 🚀 PRÓXIMOS PASOS INMEDIATOS
|
|
|
|
1. **Revisar este plan** y ajustar si es necesario
|
|
2. **Seleccionar primer tema** (recomendado: Convulsiones - es crítico y no existe)
|
|
3. **Crear primer protocolo** siguiendo plantilla
|
|
4. **Validar proceso** con un tema completo antes de continuar
|
|
5. **Establecer ritmo** sostenible (ej: 1 protocolo + guía por semana)
|
|
|
|
---
|
|
|
|
## 📊 SEGUIMIENTO DE PROGRESO
|
|
|
|
**Tracking:**
|
|
- Crear issue/tarea por cada tema en FASE 1
|
|
- Marcar como completado cuando pase todas las validaciones
|
|
- Actualizar `CONTENIDO_MEDICO_FALTANTE.md` cuando se complete contenido
|
|
- Documentar tiempo real vs estimado para ajustar estimaciones
|
|
|
|
**Métricas:**
|
|
- Temas completados / Total temas FASE 1
|
|
- Horas reales / Horas estimadas
|
|
- Errores encontrados en validación
|
|
- Tiempo promedio por protocolo/guía
|
|
|
|
---
|
|
|
|
**Última actualización:** 2025-01-07
|
|
**Estado:** 🚀 LISTO PARA EJECUTAR
|
|
**Próximo paso:** Crear primer protocolo (Convulsiones)
|
|
|