# 📋 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)