codigo0/docs/MAPA_RELACIONES_CONTENIDO.md

🗺️ MAPA DE RELACIONES DE CONTENIDO - EMERGES TES

Versión: 1.0
Fecha: 2025-01-XX
Estado: Documento Oficial - Sistema de Correspondencias
Autor: Arquitecto de Software Senior + Arquitecto de Contenido

---

🎯 PROPÓSITO DEL DOCUMENTO

Este documento define EL SISTEMA OFICIAL DE RELACIONES entre los 3 niveles de contenido (Operativo ⇄ Formativo ⇄ Referencia). Es la columna vertebral de navegación que:

• ✅ Establece correspondencias oficiales entre niveles
• ✅ Identifica gaps y casos especiales
• ✅ Define reglas de navegación bidireccional
• ✅ Documenta excepciones y casos límite
• ✅ Permite escalabilidad sin duplicación

Este documento se actualiza cuando se añade nuevo contenido relacionado.

---

1️⃣ TABLA DE CORRESPONDENCIAS OFICIALES

Estructura de Correspondencia

Cada entrada en el mapa de relaciones contiene:

{
  // Nivel 1: Operativo
  protocoloId: string;           // ID único del protocolo
  protocoloRuta: string;          // Ruta en la app
  protocoloTitulo: string;        // Título visible
  
  // Nivel 2: Formativo
  guiaId?: string;                // ID de la guía formativa
  guiaRuta?: string;              // Ruta de la guía
  guiaTitulo?: string;            // Título de la guía
  tieneGuia: boolean;             // Si existe guía formativa
  
  // Nivel 3: Referencia
  manualBloque?: string;          // Bloque del manual
  manualRuta?: string;            // Ruta del manual
  manualTitulo?: string;          // Título del capítulo
  tieneManual: boolean;           // Si existe manual completo
}

---

Tabla Completa de Correspondencias

Protocolo Operativo	ID	Guía Formativa	Manual Completo	Estado
RCP Adulto SVB	rcp-adulto-svb	✅ rcp-adulto-svb	✅ BLOQUE_04_1	✅ Completo
RCP Adulto SVA	rcp-adulto-sva	❌ No existe	✅ BLOQUE_04_1	⚠️ Gap formativo
RCP Pediátrico	rcp-pediatrico	✅ rcp-pediatrica	✅ BLOQUE_04_2	✅ Completo
RCP Lactantes	❌ No existe	✅ rcp-lactantes	✅ BLOQUE_04_3	⚠️ Sin protocolo
OVACE Adulto	obstruccion-via-aerea	✅ ovace-adulto	✅ BLOQUE_04_6	✅ Completo
OVACE Pediátrico	❌ No existe	✅ ovace-pediatrica	✅ BLOQUE_04_7	⚠️ Sin protocolo
DESA Adulto	❌ No existe	✅ desa-adulto	✅ BLOQUE_04_4	⚠️ Sin protocolo
Shock Hemorrágico	shock-hemorragico	❌ No existe	✅ BLOQUE_11_0	⚠️ Gap formativo
Código Ictus	ictus-protocolo	❌ No existe	✅ BLOQUE_05_4	⚠️ Gap formativo
ABCDE Operativo	abcde-operativo*	✅ abcde-operativo	✅ BLOQUE_01_2	✅ Completo
Parada Respiratoria	❌ No existe	✅ parada-respiratoria	✅ BLOQUE_04_0	⚠️ Sin protocolo
PCR Traumática	❌ No existe	✅ pcr-traumatica	✅ BLOQUE_04_0	⚠️ Sin protocolo
Reconocimiento PCR	❌ No existe	✅ reconocimiento-pcr	✅ BLOQUE_04_0	⚠️ Sin protocolo

*ABCDE está en Escena, no como protocolo independiente

---

2️⃣ ANÁLISIS DE COBERTURA

✅ Contenido Completo (3 Niveles)

Protocolos con cobertura completa:

1. RCP Adulto SVB

   • 🔴 Operativo: src/pages/RCP.tsx (tab Adulto → SVB)
   • 🟡 Formativo: docs/consolidado/SECCION_*_RCP_ADULTO_SVB.md (8 secciones)
   • 🔵 Referencia: public/manual/BLOQUE_4_*/BLOQUE_04_1_RCP_ADULTOS.md
   • ✅ Checklist interactiva
   • ✅ Dosis inline
   • ✅ SCORM disponible

2. RCP Pediátrico

   • 🔴 Operativo: src/pages/RCP.tsx (tab Pediátrico)
   • 🟡 Formativo: docs/consolidado/SECCION_*_RCP_PEDIATRICA.md (8 secciones)
   • 🔵 Referencia: public/manual/BLOQUE_4_*/BLOQUE_04_2_RCP_PEDIATRIA.md
   • ✅ Checklist interactiva
   • ✅ SCORM disponible

3. OVACE Adulto

   • 🔴 Operativo: src/pages/ViaAerea.tsx
   • 🟡 Formativo: docs/consolidado/SECCION_*_OVACE_ADULTO.md (8 secciones)
   • 🔵 Referencia: public/manual/BLOQUE_4_*/BLOQUE_04_6_OVACE_ADULTOS.md
   • ✅ Checklist interactiva
   • ✅ SCORM disponible

4. ABCDE Operativo

   • 🔴 Operativo: src/pages/Escena.tsx (sección ABCDE)
   • 🟡 Formativo: docs/consolidado/SECCION_*_ABCDE_OPERATIVO.md (8 secciones)
   • 🔵 Referencia: public/manual/BLOQUE_1_*/BLOQUE_01_2_ABCDE_OPERATIVO.md
   • ✅ SCORM disponible

---

⚠️ Gaps Identificados

Gap 1: Protocolos Operativos Sin Guía Formativa

Protocolos afectados:

• RCP Adulto SVA
• Shock Hemorrágico
• Código Ictus

Impacto:

• ✅ Funcionalidad operativa completa
• ⚠️ Falta profundización formativa
• ✅ Manual completo disponible

Prioridad: Media (no bloqueante, contenido formativo puede añadirse después)

Resolución propuesta:

• Crear guías formativas para estos protocolos siguiendo estructura estándar (8 secciones)
• Mantener navegación desde protocolo operativo: "Guía formativa en desarrollo"

---

Gap 2: Guías Formativas Sin Protocolo Operativo

Guías afectadas:

• RCP Lactantes
• OVACE Pediátrico
• DESA Adulto
• Parada Respiratoria
• PCR Traumática
• Reconocimiento PCR

Impacto:

• ✅ Contenido formativo completo
• ⚠️ No hay protocolo operativo rápido
• ✅ Manual completo disponible

Justificación:

• Estas guías cubren contenido formativo puro o variantes específicas
• No requieren protocolo operativo separado (pueden referenciar protocolos relacionados)

Resolución propuesta:

• Mantener como guías formativas puras
• Añadir enlaces desde protocolos relacionados (ej: RCP Lactantes desde RCP Pediátrico)

---

3️⃣ REGLAS DE NAVEGACIÓN BIDIRECCIONAL

Regla 1: Navegación desde Nivel 1 (Operativo)

Desde cualquier protocolo operativo debe poder navegarse a:

1. Guía Formativa (si existe):

   • Botón: "🎓 Ver Guía Formativa"
   • Ubicación: Debajo del título del protocolo
   • Estilo: Botón azul con icono de graduación
   • Ruta: /guia-refuerzo/{guiaId}

2. Manual Completo (si existe):

   • Botón: "📘 Ver Manual Completo"
   • Ubicación: Junto al botón de guía formativa
   • Estilo: Botón púrpura con icono de libro
   • Ruta: {manualRuta}

Implementación actual:

• src/pages/RCP.tsx: ✅ Implementado
• src/pages/Ictus.tsx: ✅ Implementado (solo manual)
• src/pages/ViaAerea.tsx: ✅ Implementado
• src/pages/Shock.tsx: ✅ Implementado (solo manual)

---

Regla 2: Navegación desde Nivel 2 (Formativo)

Desde cualquier guía formativa debe poder navegarse a:

1. Protocolo Operativo (si existe):

   • Botón: "Ir a Protocolo Operativo"
   • Ubicación: Header de la guía + footer de cada sección
   • Estilo: Botón destacado azul
   • Ruta: {protocoloRuta}

2. Manual Completo (si existe):

   • Link: "Ver Manual Completo"
   • Ubicación: Metadatos visuales del header
   • Estilo: Link púrpura
   • Ruta: {manualRuta}

Implementación actual:

• src/components/guide/GuideHeader.tsx: ✅ Implementado
• src/components/guide/GuideNavigation.tsx: ✅ Implementado

---

Regla 3: Navegación desde Nivel 3 (Referencia)

Desde cualquier capítulo del manual debe poder navegarse a:

1. Protocolo Operativo (si existe):

   • Link: "Ver Protocolo Operativo"
   • Ubicación: Inicio del capítulo
   • Estilo: Link destacado
   • Ruta: {protocoloRuta}

2. Guía Formativa (si existe):

   • Link: "Ver Guía Formativa"
   • Ubicación: Inicio del capítulo
   • Estilo: Link destacado
   • Ruta: /guia-refuerzo/{guiaId}

Implementación actual:

• ⚠️ Pendiente de implementación en visualizadores del manual

---

4️⃣ CASOS ESPECIALES

Caso 1: RCP SVA (Sin Guía Formativa)

Situación:

• 🔴 Protocolo operativo: ✅ Existe (rcp-adulto-sva)
• 🟡 Guía formativa: ❌ No existe
• 🔵 Manual completo: ✅ Existe (comparte con SVB)

Navegación implementada:

• Desde protocolo RCP SVA: Solo botón "Ver Manual Completo"
• Desde manual: Referencia a protocolo operativo

Resolución:

• Mantener gap documentado
• Opción futura: Crear guía formativa específica para SVA

---

Caso 2: ABCDE (En Escena, No Protocolo Independiente)

Situación:

• 🔴 Protocolo operativo: ✅ Existe en src/pages/Escena.tsx (no como página independiente)
• 🟡 Guía formativa: ✅ Existe (abcde-operativo)
• 🔵 Manual completo: ✅ Existe

Navegación implementada:

• Desde Escena: Enlace a guía formativa ABCDE
• Desde guía formativa: Enlace a Escena (protocolo operativo)
• Desde manual: Enlace a Escena

Resolución:

• Mantener estructura actual (ABCDE como parte de Escena)
• Navegación bidireccional funcional

---

Caso 3: Guías Sin Protocolo Operativo

Situación:

• 🔴 Protocolo operativo: ❌ No existe
• 🟡 Guía formativa: ✅ Existe
• 🔵 Manual completo: ✅ Existe

Guías afectadas:

• RCP Lactantes
• OVACE Pediátrico
• DESA Adulto
• Parada Respiratoria
• PCR Traumática
• Reconocimiento PCR

Navegación implementada:

• Desde guía formativa: Solo enlace a manual completo
• Desde manual: Enlace a guía formativa

Resolución:

• Mantener como guías formativas puras
• Añadir enlaces desde protocolos relacionados cuando sea relevante

---

5️⃣ MAPA DE RELACIONES VISUAL

Diagrama de Correspondencias

┌─────────────────────────────────────────────────────────┐
│                    NIVEL 1: OPERATIVO                    │
│  (Protocolos Rápidos - Escena)                          │
└─────────────────────────────────────────────────────────┘
           │                    │                    │
           │                    │                    │
           ▼                    ▼                    ▼
┌──────────────────┐  ┌──────────────────┐  ┌──────────────┐
│ RCP Adulto SVB   │  │ RCP Adulto SVA   │  │ RCP Pediátrico│
│ ✅ Guía          │  │ ❌ Sin Guía      │  │ ✅ Guía       │
│ ✅ Manual        │  │ ✅ Manual        │  │ ✅ Manual     │
└──────────────────┘  └──────────────────┘  └──────────────┘
           │                    │                    │
           │                    │                    │
           ▼                    ▼                    ▼
┌─────────────────────────────────────────────────────────┐
│                    NIVEL 2: FORMATIVO                    │
│  (Guías de Refuerzo - Aprendizaje)                      │
└─────────────────────────────────────────────────────────┘
           │                    │                    │
           │                    │                    │
           ▼                    ▼                    ▼
┌──────────────────┐  ┌──────────────────┐  ┌──────────────┐
│ RCP Adulto SVB   │  │ RCP Lactantes     │  │ OVACE Adulto  │
│ ✅ Protocolo     │  │ ❌ Sin Protocolo  │  │ ✅ Protocolo  │
│ ✅ Manual        │  │ ✅ Manual         │  │ ✅ Manual     │
└──────────────────┘  └──────────────────┘  └──────────────┘
           │                    │                    │
           │                    │                    │
           ▼                    ▼                    ▼
┌─────────────────────────────────────────────────────────┐
│                    NIVEL 3: REFERENCIA                    │
│  (Manual Completo - Documentación)                       │
└─────────────────────────────────────────────────────────┘

---

6️⃣ IMPLEMENTACIÓN TÉCNICA

Archivo de Mapeo

Ubicación: src/data/protocol-guide-manual-mapping.ts

Estructura:

export interface ProtocolGuideManualMapping {
  protocoloId: string;
  protocoloRuta?: string;
  protocoloTitulo: string;
  guiaId?: string;
  guiaRuta?: string;
  guiaTitulo?: string;
  tieneGuia: boolean;
  manualBloque?: string;
  manualRuta?: string;
  manualTitulo?: string;
  tieneManual: boolean;
}

Funciones de utilidad:

• getMappingByProtocolId(protocoloId: string) - Obtiene mapeo desde protocolo
• getMappingByGuiaId(guiaId: string) - Obtiene mapeo desde guía
• getAllGuias() - Obtiene todas las guías disponibles

---

Uso en Componentes

Ejemplo: Navegación desde Protocolo Operativo

// En src/pages/RCP.tsx
const mappingSVB = getMappingByProtocolId('rcp-adulto-svb');

{mappingSVB?.tieneGuia && (
  <Link to={`/guia-refuerzo/${mappingSVB.guiaId}`}>
    🎓 Ver Guía Formativa
  </Link>
)}

{mappingSVB?.tieneManual && (
  <Link to={mappingSVB.manualRuta}>
    📘 Ver Manual Completo
  </Link>
)}

Ejemplo: Navegación desde Guía Formativa

// En src/components/guide/GuideHeader.tsx
const mapping = getMappingByGuiaId(guide.id);

{mapping && 'protocoloId' in mapping && mapping.protocoloId && (
  <Link to={mapping.protocoloRuta}>
    Ir a Protocolo Operativo
  </Link>
)}

---

7️⃣ MANTENIMIENTO Y EVOLUCIÓN

Proceso de Actualización

Cuando se añade nuevo contenido:

1. Identificar nivel: ¿Operativo, Formativo o Referencia?
2. Crear entrada: Añadir entrada en protocol-guide-manual-mapping.ts
3. Verificar relaciones: Comprobar navegación bidireccional
4. Actualizar este documento: Añadir entrada en tabla de correspondencias
5. Validar: Probar navegación desde todos los niveles

---

Checklist de Validación

Para cada nueva relación:

• ¿Existe entrada en protocol-guide-manual-mapping.ts?
• ¿Navegación bidireccional funciona?
• ¿Botones/enlaces visibles en UI?
• ¿Rutas correctas y accesibles?
• ¿Documentado en este mapa?

---

8️⃣ GAPS Y PRIORIZACIÓN

Gaps Críticos (Alta Prioridad)

Ninguno identificado. Todos los protocolos operativos críticos tienen al menos manual completo.

---

Gaps Formativos (Media Prioridad)

1. RCP Adulto SVA - Sin guía formativa

   • Impacto: Bajo (comparte manual con SVB)
   • Esfuerzo: Medio (8 secciones)
   • Prioridad: Media

2. Shock Hemorrágico - Sin guía formativa

   • Impacto: Medio (protocolo crítico)
   • Esfuerzo: Medio (8 secciones)
   • Prioridad: Media

3. Código Ictus - Sin guía formativa

   • Impacto: Medio (protocolo crítico)
   • Esfuerzo: Medio (8 secciones)
   • Prioridad: Media

---

Gaps Operativos (Baja Prioridad)

Guías formativas sin protocolo operativo:

• RCP Lactantes
• OVACE Pediátrico
• DESA Adulto
• Parada Respiratoria
• PCR Traumática
• Reconocimiento PCR

Justificación: Estas guías cubren contenido formativo puro o variantes específicas. No requieren protocolo operativo separado.

---

📋 RESUMEN EJECUTIVO

Correspondencias oficiales:

• ✅ 4 protocolos con cobertura completa (3 niveles)
• ⚠️ 3 protocolos con gap formativo (Operativo + Referencia)
• ⚠️ 6 guías sin protocolo operativo (Formativo + Referencia)

Navegación bidireccional:

• ✅ Implementada desde Nivel 1 → Nivel 2 y Nivel 3
• ✅ Implementada desde Nivel 2 → Nivel 1 y Nivel 3
• ⚠️ Pendiente desde Nivel 3 → Nivel 1 y Nivel 2

Gaps identificados:

• 3 gaps formativos (media prioridad)
• 6 guías sin protocolo operativo (baja prioridad, justificadas)

Estado técnico:

• ✅ Archivo de mapeo implementado
• ✅ Funciones de utilidad disponibles
• ✅ Navegación funcional en UI

---

Este documento se actualiza cuando se añade nuevo contenido relacionado o se resuelven gaps.