planetazuzu/codigo0
1
0
Fork 0
Code Issues Pull requests Actions 1 Packages Projects Releases Wiki Activity
codigo0/docs/PLAN_CREACION_CONTENIDO.md

15 KiB
Raw Blame History

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

  1. Ictus Completo ⚠️

    • Protocolo: ictus-completo
    • Guía: 8 secciones
    • Razón: Ventana de tiempo crítica para tratamiento

  2. Trauma Politrauma ⚠️

    • Protocolo: trauma-politrauma
    • Guía: 8 secciones
    • Razón: Requiere abordaje sistemático estructurado

  3. TCE ⚠️

    • Protocolo: tce
    • Guía: 8 secciones
    • Razón: Deterioro rápido si no se maneja correctamente

  4. 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)

  1. Shock Hipovolémico ⚠️ (Solo falta guía formativa)

    • Guía: 8 secciones (protocolo ya existe)

  2. Aspiración de Secreciones ⚠️

    • Protocolo: aspiracion-secreciones
    • Guía: 8 secciones

  3. Ventilación con AMBU ⚠️

    • Protocolo: ventilacion-ambu
    • Guía: 8 secciones

  4. Reevaluación ABCDE ⚠️

    • Protocolo: reevaluacion-abcde
    • Guía: 8 secciones

PRIORIDAD 1D - Completar FASE B (Semana 4)

  1. Valoración Secundaria + SAMPLE ⚠️

    • Protocolo: valoracion-secundaria-sample
    • Guía: 8 secciones

  2. Preparación Intubación ❌ (No existe)

    • Protocolo: preparacion-intubacion
    • Guía: 8 secciones

  3. Vademécum - Primera Línea Crítica (Inicio, continuar en FASE 3)

    • Flumazenil (antídoto crítico)

📝 PLANTILLAS Y ESTRUCTURAS

Plantilla Protocolo Operativo

{
  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:

{
  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

{
  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)