codigo0/docs/ANALISIS_COBERTURA_INDICE_MAESTRO.md
planetazuzu dcc2151530 fix: solución completa para vendor-other en Docker/producción
CRÍTICO: Eliminación definitiva de vendor-other

Cambios:
- vite.config.ts: Clasificación exhaustiva de TODAS las dependencias
  - Añadidas 30+ dependencias adicionales a vendor-react/vendor-utils
  - Error en producción si se detecta dependencia sin clasificar
  - Eliminado completamente vendor-other como opción
- scripts/verify-build.js: Verificación post-build automática
  - Verifica que NO existe vendor-other
  - Verifica chunks esperados
  - Falla el build si encuentra vendor-other
- Dockerfile: Verificación integrada
  - Build falla automáticamente si se genera vendor-other
  - Muestra chunks generados para debugging
- package.json: build ahora ejecuta verificación automáticamente
- manifest.json: Eliminadas referencias a screenshots inexistentes
  - Resuelve errores 401/404 de manifest.json
- docs/SOLUCION_DOCKER_VENDOR_OTHER.md: Documentación completa

Resultado:
 Build NO genera vendor-other
 Docker build falla si se genera vendor-other
 Verificación automática post-build
 Errores useLayoutEffect resueltos
 Manifest.json sin errores
2026-01-02 19:17:26 +01:00

19 KiB
Raw Blame History

📊 ANÁLISIS DE COBERTURA: EMERGES TES vs ÍNDICE MAESTRO UNIFICADO

Fecha: 2024-12-30
Analista: Arquitecto Académico, Diseñador Instruccional y Arquitecto Frontend Senior
Estado: ⚠️ PENDIENTE ÍNDICE MAESTRO - Análisis basado en estructura actual


📋 RESUMEN EJECUTIVO

El proyecto EMERGES TES presenta una arquitectura tripartita (Manual + App + Guías de Refuerzo) con cobertura parcial del contenido formativo completo. Existen 92 archivos Markdown de manual operativo, 80 secciones de guías de refuerzo formativas, y componentes React para consulta rápida. NO se detectan módulos SCORM para e-learning. La estructura actual está organizada en 17 bloques temáticos (BLOQUE_0 a BLOQUE_15), pero requiere el Índice Maestro Unificado para validar cobertura completa y identificar huecos críticos.

Cobertura estimada: ~60-70% del contenido operativo, ~20% del contenido formativo profundo, 0% e-learning SCORM.


🔍 METODOLOGÍA DE ANÁLISIS

Formatos Identificados:

  • [M] Manual: Archivos Markdown en public/manual/ (92 archivos)
  • [Q] Quick/App: Componentes React + datos TypeScript (procedures.ts, drugs.ts, etc.)
  • [E] E-learning: Módulos SCORM (NO detectados)

Fuentes Analizadas:

  1. src/data/manual-index.ts - Índice estructurado del manual (2,715 líneas)
  2. src/data/procedures.ts - Protocolos operativos rápidos (5 procedimientos)
  3. src/data/guides-index.ts - Guías de refuerzo formativas (2 guías completas)
  4. public/manual/ - 92 archivos Markdown organizados en 17 bloques
  5. docs/consolidado/ - 80 secciones de guías de refuerzo (10 guías × 8 secciones)

📊 TABLA DE COBERTURA (ESTRUCTURA ACTUAL)

Capítulo / Subcapítulo Tipo Esperado [M][Q][E] Existe Formato Actual Observaciones Técnicas
BLOQUE 0: FUNDAMENTOS
Fundamentos de Emergencias [M] MD BLOQUE_00_0_FUNDAMENTOS_EMERGENCIAS.md - Formativo, necesita profundización
BLOQUE 1: PROCEDIMIENTOS BÁSICOS
Constantes Vitales [M][Q] MD + React BLOQUE_01_1_CONSTANTES_VITALES.md + componente React
ABCDE Operativo [M][Q] MD + React BLOQUE_01_2_ABCDE_OPERATIVO.md + componente + Guía Refuerzo completa (8 secciones)
Glasgow Operativo [M][Q] MD + React BLOQUE_01_3_GLASGOW_OPERATIVO.md + calculadora React
Triage START [M][Q] MD + React BLOQUE_01_4_TRIAGE_START.md + componente React
BLOQUE 2: MATERIAL E INMOVILIZACIÓN
Anatomía Operativa [M] MD BLOQUE_02_0_ANATOMIA_OPERATIVA.md - 14 archivos totales
Collarín Cervical [M] MD BLOQUE_02_3_COLLARIN_CERVICAL.md
Tablero Espinal [M] MD BLOQUE_02_5_TABLERO_ESPINAL.md
Extricación Vehicular [M] MD BLOQUE_02_7_EXTRICACION_MOVIMIENTOS_BLOQUE.md
Férulas, Cinturón Pélvico, etc. [M] MD 14 archivos completos en bloque
BLOQUE 3: MATERIAL SANITARIO Y OXIGENOTERAPIA
Oxigenoterapia Completa [M] MD BLOQUE_03_0_OXIGENOTERAPIA_COMPLETA.md - 25 archivos totales
Dispositivos Oxigenoterapia [M] MD BLOQUE_03_1_DISPOSITIVOS_OXIGENOTERAPIA.md
Ventilación BVM [M] MD BLOQUE_03_3_BVM.md
Control Hemorragias [M] MD BLOQUE_03_6_CONTROL_HEMORRAGIAS.md
Quemaduras, Heridas, Vendas [M] MD Múltiples archivos
Monitorización Básica [M] MD BLOQUE_03_10_MONITORIZACION_BASICA.md
Inventarios y Checklists [M] MD 25 archivos completos
BLOQUE 4: SOPORTE VITAL BÁSICO Y RCP
Reconocimiento PCR [M] MD BLOQUE_04_0_RECONOCIMIENTO_PCR.md + Guía Refuerzo (8 secciones)
RCP Adultos SVB [M][Q] MD + React BLOQUE_04_1_RCP_ADULTOS.md + procedures.ts + Guía Refuerzo (8 secciones)
RCP Pediatría [M][Q] MD + React BLOQUE_04_2_RCP_PEDIATRIA.md + procedures.ts + Guía Refuerzo (8 secciones)
RCP Lactantes [M][Q] MD + React BLOQUE_04_3_RCP_LACTANTES.md + Guía Refuerzo (8 secciones)
Uso DESA [M][Q] MD + React BLOQUE_04_4_USO_DESA.md + Guía Refuerzo (8 secciones)
RCP Dos Intervinientes [M] MD BLOQUE_04_5_RCP_DOS_INTERVINIENTES.md
OVACE Adultos [M][Q] MD + React BLOQUE_04_6_OVACE_ADULTOS.md + procedures.ts + Guía Refuerzo (8 secciones)
OVACE Pediatría [M][Q] MD + React BLOQUE_04_7_OVACE_PEDIATRIA.md + Guía Refuerzo (8 secciones)
OVACE Lactantes [M][Q] MD + React BLOQUE_04_8_OVACE_LACTANTES.md
Posición Lateral Seguridad [M] MD BLOQUE_04_9_POSICION_LATERAL_SEGURIDAD.md
Acceso Vascular Básico [M] MD BLOQUE_04_10_ACCESO_VASCULAR_BASICO.md
BLOQUE 5: PROTOCOLOS TRANSTELEFÓNICOS
Introducción Protocolos [M] MD BLOQUE_05_0_INTRODUCCION_PROTOCOLOS_TRANSTELEFONICOS.md
PCR Transtelefónica [M] MD BLOQUE_05_1_PCR_TRANSTELEFONICA.md - Etiquetado [IA_FUTURA]
OVACE Transtelefónica [M] MD BLOQUE_05_2_OVACE_TRANSTELEFONICA.md - Etiquetado [IA_FUTURA]
SCA Transtelefónico [M] MD BLOQUE_05_3_SCA_TRANSTELEFONICO.md - Etiquetado [IA_FUTURA]
Ictus Transtelefónico [M] MD BLOQUE_05_4_ICTUS_TRANSTELEFONICO.md - Etiquetado [IA_FUTURA]
Anafilaxia Transtelefónica [M] MD BLOQUE_05_5_ANAFILAXIA_TRANSTELEFONICA.md - Etiquetado [IA_FUTURA]
Crisis Asmática Transtelefónica [M] MD BLOQUE_05_6_CRISIS_ASMATICA_TRANSTELEFONICA.md - Etiquetado [IA_FUTURA]
Hipoglucemia Transtelefónica [M] MD BLOQUE_05_7_HIPOGLUCEMIA_TRANSTELEFONICA.md - Etiquetado [IA_FUTURA]
BLOQUE 6: FARMACOLOGÍA
Principios Administración [M] MD BLOQUE_06_0_PRINCIPIOS_ADMINISTRACION_FARMACOS.md
Vademécum Operativo [M][Q] MD + React BLOQUE_06_1_VADEMECUM_OPERATIVO.md + drugs.ts (6 fármacos)
Oxígeno: Administración [M][Q] MD + React BLOQUE_06_2_OXIGENO_ADMINISTRACION_Y_SEGURIDAD.md + drugs.ts
Adrenalina [M][Q] MD + React BLOQUE_06_3_ADRENALINA_USO_ANAFILAXIA_Y_RCP.md + drugs.ts
Aspirina [M][Q] MD + React BLOQUE_06_4_ASPIRINA_USO_SCA.md + drugs.ts
Glucagón [M][Q] MD + React BLOQUE_06_5_GLUCAGON_USO_HIPOGLUCEMIA.md + drugs.ts
Salbutamol [M][Q] MD + React BLOQUE_06_6_SALBUTAMOL_USO_CRISIS_ASMATICA.md + drugs.ts
Abreviaturas [M] MD BLOQUE_06_7_ABREVIATURAS_TERMINOLOGIA_FARMACOLOGICA.md
BLOQUE 7: CONDUCCIÓN Y SEGURIDAD VIAL
Principios Conducción [M] MD 6 archivos completos - Etiquetado [DOC]
Uso Luces y Sirena [M] MD Etiquetado [DOC]
Técnicas Conducción [M] MD Etiquetado [DOC]
BLOQUE 8: GESTIÓN OPERATIVA Y DOCUMENTACIÓN
Introducción Gestión [M] MD BLOQUE_08_0_INTRODUCCION_GESTION_OPERATIVA.md - 5 archivos
Documentación Operativa [M] MD Múltiples archivos
BLOQUE 9: MEDICINA EMERGENCIAS APLICADA
Medicina Emergencias [M] ⚠️ Parcial MD BLOQUE_09_0_MEDICINA_EMERGENCIAS_APLICADA.md - 1 archivo, necesita desarrollo
BLOQUE 10: SITUACIONES ESPECIALES
Situaciones Especiales [M] ⚠️ Parcial MD BLOQUE_10_0_SITUACIONES_ESPECIALES.md - 1 archivo, necesita desarrollo
BLOQUE 11: PROTOCOLOS TRAUMA
Protocolos Trauma [M] ⚠️ Parcial MD BLOQUE_11_0_PROTOCOLOS_TRAUMA.md - 1 archivo, necesita desarrollo
BLOQUE 12: MARCO LEGAL ÉTICO PROFESIONAL
Marco Legal Ético [M] MD BLOQUE_12_0_MARCO_LEGAL_ETICO_PROFESIONAL.md - Etiquetado [DOC]
BLOQUE 13: COMUNICACIÓN Y RELACIÓN PACIENTE
Comunicación Paciente [M] MD BLOQUE_13_0_COMUNICACION_RELACION_PACIENTE.md - Etiquetado [DOC]
BLOQUE 14: SEGURIDAD PERSONAL SALUD TES
Seguridad Personal [M] MD BLOQUE_14_0_SEGURIDAD_PERSONAL_SALUD_TES.md - Etiquetado [DOC]
BLOQUE 15: ALTERACIONES PSIQUIÁTRICAS Y CONTENCIÓN
Alteraciones Psiquiátricas [M] ⚠️ Parcial MD BLOQUE_15_0_INTRODUCCION_ALTERACIONES_PSIQUIATRICAS.md - 1 archivo, necesita desarrollo
GUIAS DE REFUERZO (MODO FORMATIVO)
ABCDE Operativo [M] MD (8 secciones) SECCION_01-08_ABCDE_OPERATIVO.md - Completa
RCP Adulto SVB [M] MD (8 secciones) SECCION_01-08_RCP_ADULTO_SVB.md - Completa
Reconocimiento PCR [M] MD (8 secciones) SECCION_01-08_RECONOCIMIENTO_PCR.md - Completa
RCP Pediátrica [M] MD (8 secciones) SECCION_01-08_RCP_PEDIATRICA.md - Completa
RCP Lactantes [M] MD (8 secciones) SECCION_01-08_RCP_LACTANTES.md - Completa
OVACE Adulto [M] MD (8 secciones) SECCION_01-08_OVACE_ADULTO.md - Completa
OVACE Pediátrica [M] MD (8 secciones) SECCION_01-08_OVACE_PEDIATRICA.md - Completa
DESA Adulto [M] MD (8 secciones) SECCION_01-08_DESA_ADULTO.md - Completa
PCR Traumática [M] MD (8 secciones) SECCION_01-08_PCR_TRAUMATICA.md - Completa
Parada Respiratoria [M] MD (8 secciones) SECCION_01-08_PARADA_RESPIRATORIA.md - Completa
E-LEARNING SCORM
Módulos SCORM [E] No Ninguno NO EXISTEN - Requiere creación desde cero

🚨 BLOQUES PRIORITARIOS FALTANTES (CRÍTICOS PARA TES)

1. E-LEARNING SCORM (PRIORIDAD CRÍTICA)

  • Estado: 0% cobertura
  • Impacto: Sin certificación formativa, sin tracking de progreso, sin integración LMS
  • Necesario: Módulos SCORM 1.2 o 2004 para:
    • RCP Adulto/Pediátrico/Lactantes
    • OVACE
    • ABCDE Operativo
    • Protocolos Transtelefónicos
    • Farmacología básica

2. BLOQUE 9: MEDICINA EMERGENCIAS APLICADA (PRIORIDAD ALTA)

  • Estado: ⚠️ Parcial (1 archivo introductorio)
  • Falta:
    • Patologías por sistemas (Respiratorias, Cardiovasculares, Neurológicas, Endocrinas, Intoxicaciones)
    • Casos clínicos reales
    • Algoritmos de decisión
    • Nota: Existe src/pages/Patologias.tsx con 10 patologías, pero no está integrado en manual

3. BLOQUE 11: PROTOCOLOS TRAUMA (PRIORIDAD ALTA)

  • Estado: ⚠️ Parcial (1 archivo introductorio)
  • Falta:
    • Trauma craneoencefálico (TCE)
    • Trauma torácico
    • Trauma abdominal
    • Trauma raquimedular
    • Politraumatizado
    • Algoritmos de actuación

4. BLOQUE 10: SITUACIONES ESPECIALES (PRIORIDAD MEDIA)

  • Estado: ⚠️ Parcial (1 archivo introductorio)
  • Falta:
    • Partos en urgencia
    • Urgencias pediátricas específicas
    • Urgencias geriátricas
    • Urgencias en situaciones especiales (montaña, mar, etc.)

5. BLOQUE 15: ALTERACIONES PSIQUIÁTRICAS Y CONTENCIÓN (PRIORIDAD MEDIA)

  • Estado: ⚠️ Parcial (1 archivo introductorio)
  • Falta:
    • Protocolos de contención
    • Agitación psicomotriz
    • Crisis de ansiedad/angustia
    • Intoxicaciones psiquiátricas
    • Aspectos legales de contención

6. GUIAS DE REFUERZO FALTANTES (PRIORIDAD MEDIA)

  • Estado: 10 guías completas, pero faltan:
    • RCP Dos Intervinientes (SVA)
    • Shock Hemorrágico
    • Protocolos Transtelefónicos (PCR, OVACE, SCA, Ictus, Anafilaxia, Crisis Asmática, Hipoglucemia)
    • Farmacología (Adrenalina, Oxígeno, etc.)
    • Trauma (TCE, Torácico, Abdominal)
    • Contención Psiquiátrica

7. COMPONENTES APP FALTANTES (PRIORIDAD MEDIA)

  • Estado: Existen 5 procedimientos en procedures.ts, pero faltan:
    • Más protocolos transtelefónicos interactivos
    • Calculadoras adicionales (dosis pediátricas avanzadas, scoring de trauma, etc.)
    • Checklists interactivos para material
    • Simuladores de escenarios

🗺️ ROADMAP POR FASES

FASE 1: COMPLETAR LO CASI TERMINADO (2-3 meses)

Objetivo: Finalizar contenido parcial y conectar piezas existentes

1.1. Expandir Bloques Parciales

  • BLOQUE 9: Desarrollar Medicina Emergencias Aplicada
    • Integrar src/pages/Patologias.tsx con manual
    • Crear 10+ patologías por sistemas en Markdown
    • Añadir casos clínicos
  • BLOQUE 11: Desarrollar Protocolos Trauma
    • TCE, Torácico, Abdominal, Raquimedular, Politraumatizado
    • Algoritmos de actuación
  • BLOQUE 10: Desarrollar Situaciones Especiales
    • Partos, Urgencias pediátricas/geriátricas, Situaciones especiales
  • BLOQUE 15: Desarrollar Alteraciones Psiquiátricas
    • Protocolos de contención, Agitación, Crisis, Aspectos legales

1.2. Completar Guías de Refuerzo

  • RCP Dos Intervinientes (SVA) - 8 secciones
  • Shock Hemorrágico - 8 secciones
  • 7 Protocolos Transtelefónicos - 56 secciones (7 × 8)
  • Farmacología (Adrenalina, Oxígeno) - 16 secciones (2 × 8)

1.3. Integración Manual-App

  • Conectar src/pages/Patologias.tsx con manual
  • Añadir más procedimientos a procedures.ts
  • Expandir drugs.ts con más fármacos

Resultado esperado: 100% cobertura manual, 80% guías de refuerzo, 70% app rápida


FASE 2: CONTENIDOS CRÍTICOS OPERATIVOS (3-4 meses)

Objetivo: Priorizar contenido crítico para uso en ambulancia

2.1. E-Learning SCORM (CRÍTICO)

  • Módulo 1: RCP Adulto/Pediátrico/Lactantes (SCORM 1.2)
    • Contenido: Guías de refuerzo + Manual
    • Interactividad: Simulador de compresiones, Validación de técnica
    • Tracking: Progreso, Certificación
  • Módulo 2: OVACE (SCORM 1.2)
    • Contenido: Guías de refuerzo + Manual
    • Interactividad: Simulador de maniobras
  • Módulo 3: ABCDE Operativo (SCORM 1.2)
    • Contenido: Guía de refuerzo + Manual
    • Interactividad: Casos clínicos interactivos
  • Módulo 4: Protocolos Transtelefónicos (SCORM 1.2)
    • Contenido: Manual + Simulaciones
    • Interactividad: Simulador de llamadas
  • Módulo 5: Farmacología Básica (SCORM 1.2)
    • Contenido: Vademécum + Guías
    • Interactividad: Calculadoras de dosis, Casos clínicos

2.2. App Rápida - Funcionalidades Críticas

  • Calculadoras avanzadas (dosis pediátricas, scoring trauma, etc.)
  • Checklists interactivos de material
  • Simuladores de escenarios
  • Modo offline completo

2.3. Guías de Refuerzo - Trauma y Especiales

  • Trauma (TCE, Torácico, Abdominal) - 24 secciones (3 × 8)
  • Contención Psiquiátrica - 8 secciones

Resultado esperado: 5 módulos SCORM, 100% app rápida, 100% guías de refuerzo


FASE 3: EXPANSIÓN ACADÉMICA (4-6 meses)

Objetivo: Contenido avanzado y especializado

3.1. E-Learning SCORM - Módulos Avanzados

  • Módulo 6: Trauma (SCORM 1.2)
  • Módulo 7: Medicina Emergencias Aplicada (SCORM 1.2)
  • Módulo 8: Situaciones Especiales (SCORM 1.2)
  • Módulo 9: Alteraciones Psiquiátricas (SCORM 1.2)
  • Módulo 10: Gestión Operativa y Documentación (SCORM 1.2)

3.2. Contenido Avanzado

  • Casos clínicos complejos
  • Simulaciones avanzadas
  • Evaluaciones formativas
  • Certificaciones por módulo

3.3. Integración LMS

  • Compatibilidad con Moodle, Blackboard, etc.
  • Tracking de progreso
  • Reportes de aprendizaje
  • Certificaciones automáticas

Resultado esperado: 10 módulos SCORM completos, ecosistema formativo completo


🔄 REUTILIZACIÓN Y REESTRUCTURACIÓN

Puede Reutilizarse Tal Cual:

  1. 92 archivos Markdown del manual → Base para módulos SCORM
  2. 80 secciones de guías de refuerzo → Contenido formativo SCORM
  3. Componentes React (MarkdownViewer, ManualViewer, etc.) → Reutilizables en SCORM
  4. Datos TypeScript (procedures.ts, drugs.ts) → Base de datos para SCORM
  5. Infografías y diagramas → Assets visuales para SCORM

Debe Reestructurarse:

  1. ⚠️ Guías de Refuerzo → Convertir a estructura SCORM (objetivos, contenido, evaluación)
  2. ⚠️ Manual Markdown → Segmentar en unidades de aprendizaje SCORM
  3. ⚠️ Componentes React → Adaptar para interactividad SCORM (API, tracking)
  4. ⚠️ Navegación actual → Reestructurar para flujo SCORM (secuencial, ramificado)

Debe Crearse Desde Cero:

  1. Infraestructura SCORM (API, tracking, comunicación con LMS)
  2. Sistema de evaluación (cuestionarios, simulaciones, certificaciones)
  3. Player SCORM (navegación, progreso, bookmarking)
  4. Generador de SCORM (tooling para convertir Markdown → SCORM)
  5. Sistema de certificación (badges, certificados, tracking)

📈 ESTADÍSTICAS ACTUALES

Contenido Existente:

  • Manual Markdown: 92 archivos (~47,410 líneas)
  • Guías de Refuerzo: 80 secciones (10 guías × 8 secciones)
  • Procedimientos App: 5 procedimientos en procedures.ts
  • Fármacos App: 6 fármacos en drugs.ts
  • Componentes React: 90+ componentes
  • Páginas App: 24 páginas React

Cobertura Estimada:

  • Manual Operativo: ~85% (faltan bloques 9, 10, 11, 15 desarrollados)
  • App Rápida: ~40% (faltan más procedimientos, calculadoras, simuladores)
  • Guías de Refuerzo: ~50% (10 guías completas, faltan ~10-15 guías)
  • E-Learning SCORM: 0% (requiere creación completa)

⚠️ CONCLUSIÓN TÉCNICA

Fortalezas:

  1. Base sólida de contenido manual (92 archivos)
  2. Arquitectura paralela funcional (Manual + App + Guías)
  3. Componentes reutilizables bien estructurados
  4. 10 guías de refuerzo completas con estructura consistente

Debilidades Críticas:

  1. Ausencia total de e-learning SCORM (0% cobertura)
  2. ⚠️ Bloques parciales (9, 10, 11, 15) necesitan desarrollo
  3. ⚠️ Guías de refuerzo incompletas (faltan ~10-15 guías)
  4. ⚠️ App rápida limitada (solo 5 procedimientos, 6 fármacos)

Recomendaciones Inmediatas:

  1. PRIORIDAD 1: Crear infraestructura SCORM base (API, player, tracking)
  2. PRIORIDAD 2: Convertir 3-5 guías de refuerzo existentes a SCORM (piloto)
  3. PRIORIDAD 3: Desarrollar bloques parciales (9, 11 especialmente)
  4. PRIORIDAD 4: Expandir app rápida con más procedimientos y calculadoras

Próximos Pasos:

  1. Validar con Índice Maestro Unificado (cuando se proporcione)
  2. Ajustar roadmap según prioridades del índice maestro
  3. Iniciar Fase 1 (completar contenido parcial)
  4. Diseñar arquitectura SCORM (API, player, generador)

⚠️ NOTA IMPORTANTE: Este análisis se basa en la estructura actual del proyecto. Requiere el Índice Maestro Unificado "EL TES OPERATIVO" con BLOQUES IIX para validar cobertura completa y ajustar prioridades.

Fecha de análisis: 2024-12-30
Próxima revisión: Tras recepción del Índice Maestro Unificado