codigo0/docs/guia-refuerzo-modelo.md

# 📚 Modelo Oficial - Guía de Refuerzo

**Fecha de creación:** 2025-12-23  
**Versión:** 1.0  
**Estado:** Contrato Conceptual Oficial  
**Propósito:** Definir esquema, estructura y reglas de la Guía de Refuerzo

---

## 🎯 Propósito del Documento

Este documento es el **contrato conceptual oficial** del sistema de Guías de Refuerzo. Define:

- ✅ **Qué es** una Guía de Refuerzo
- ✅ **Cómo se estructura** (secciones estándar)
- ✅ **Qué bloques de contenido** puede usar
- ✅ **Cómo convive** con el contenido operativo
- ✅ **Reglas de diseño** que deben seguirse

**Uso:**
- No improvisar al crear guías
- No contaminar Markdown con contenido operativo
- Tener criterio claro cuando haya dudas
- Mantener coherencia entre guías

---

## 1️⃣ Esquema de Secciones Estándar

Toda Guía de Refuerzo sigue esta estructura de **8 secciones**:

### Sección 1: Introducción

**Propósito:** Establecer contexto y expectativas

**Contenido obligatorio:**
- Título y subtítulo descriptivo
- Contexto clínico del tema
- Objetivos de aprendizaje (qué aprenderás)
- Tiempo estimado de lectura/visualización
- Prerrequisitos (qué debes saber antes)
- **Enlace al protocolo operativo relacionado** (obligatorio)

**Formato:** Texto narrativo corto (2-3 párrafos)

**Bloques permitidos:**
- Texto Explicativo

**Cuándo se usa:** Siempre presente, primera sección

---

### Sección 2: Explicación Clínica

**Propósito:** Proporcionar base científica y comprensión profunda

**Contenido:**
- Fisiopatología del proceso
- Mecanismos de acción (si aplica)
- Conceptos científicos clave
- Relaciones causa-efecto
- Contexto clínico amplio

**Formato:** Texto narrativo con diagramas embebidos

**Bloques permitidos:**
- Texto Explicativo
- Imagen Estática
- Diagrama de Flujo
- Tabla de Referencia

**Cuándo se usa:** Para temas que requieren comprensión científica

**Relación con operativo:** Explica el "por qué" de los pasos operativos

---

### Sección 3: Algoritmo Comentado

**Propósito:** Visualizar el protocolo operativo con explicaciones

**Contenido:**
- Diagrama de flujo del protocolo
- Comentarios explicativos en cada paso
- Decisiones y ramificaciones visualizadas
- **Enlace directo al protocolo operativo** (obligatorio)
- Variaciones según contexto (adulto/pediátrico)

**Formato:** Infografía interactiva o diagrama estático con anotaciones

**Bloques permitidos:**
- Infografía
- Diagrama de Flujo
- Texto Explicativo (comentarios)

**Cuándo se usa:** Para protocolos complejos con múltiples decisiones

**Relación con operativo:** Visualiza y explica los pasos operativos sin duplicarlos

---

### Sección 4: Medios Visuales

**Propósito:** Aprender mediante visualización

**Contenido:**
- Infografías paso a paso de técnicas
- Vídeos de demostración (si aplica)
- Diagramas anatómicos
- Secuencias fotográficas
- Animaciones de procesos

**Formato:** Galería de medios con descripciones

**Bloques permitidos:**
- Galería de Imágenes
- Vídeo
- Imagen Estática
- Infografía

**Cuándo se usa:** Para técnicas que requieren visualización (inmovilización, uso de equipamiento)

**Relación con operativo:** Muestra visualmente cómo ejecutar los pasos operativos

---

### Sección 5: Errores Frecuentes

**Propósito:** Prevenir errores mediante aprendizaje visual

**Contenido:**
- Errores comunes identificados
- Visualización del error (imagen/vídeo)
- Visualización de la forma correcta
- Consecuencias del error
- Cómo evitarlo

**Formato:** Comparación lado a lado (incorrecto vs correcto)

**Bloques permitidos:**
- Comparación Visual
- Caja de Advertencia
- Texto Explicativo
- Imagen Estática

**Cuándo se usa:** Para procedimientos donde los errores son frecuentes o críticos

**Relación con operativo:** Profundiza en los "Puntos críticos TES" del contenido operativo

---

### Sección 6: Casos Clínicos

**Propósito:** Aprender mediante ejemplos prácticos

**Contenido:**
- Caso clínico completo (real o simulado)
- Presentación del caso
- Análisis paso a paso
- Aplicación del protocolo
- Puntos de aprendizaje
- Variaciones del caso

**Formato:** Narrativa estructurada con imágenes/vídeos

**Bloques permitidos:**
- Caso Clínico
- Imagen Estática
- Vídeo (opcional)
- Texto Explicativo

**Cuándo se usa:** Para protocolos complejos o situaciones poco frecuentes

**Relación con operativo:** Muestra aplicación práctica del protocolo operativo

---

### Sección 7: Resumen Visual

**Propósito:** Síntesis rápida y referencia visual

**Contenido:**
- Infografía resumen del tema completo
- Puntos clave destacados visualmente
- **Enlace rápido al protocolo operativo** (obligatorio)
- Checklist visual de pasos críticos

**Formato:** Infografía única de una página

**Bloques permitidos:**
- Resumen Visual
- Infografía

**Cuándo se usa:** Siempre presente como cierre

**Relación con operativo:** Proporciona puente visual hacia el protocolo operativo

---

### Sección 8: Referencias

**Propósito:** Fuentes y recursos adicionales

**Contenido:**
- Guías oficiales citadas (ERC, AHA, SEMES)
- Bibliografía científica
- Enlaces a protocolos relacionados
- Recursos adicionales de formación

**Formato:** Lista estructurada con enlaces

**Bloques permitidos:**
- Lista Estructurada

**Cuándo se usa:** Siempre presente

**Relación con operativo:** Proporciona contexto y validación del contenido operativo

---

## 2️⃣ Tipos de Bloques de Contenido

### Bloque 1: Texto Explicativo

**Propósito:** Proporcionar información narrativa y contextual

**Características:**
- Texto estructurado en párrafos
- Longitud variable (1-5 párrafos típicamente)
- Puede incluir formato (negrita, cursiva, listas)
- Soporta enlaces internos y externos

**Cuándo usarlo:**
- Introducciones y contexto
- Explicaciones científicas
- Descripciones de conceptos
- Narrativas de casos clínicos

**Relación con operativo:**
- Explica el "por qué" de los pasos operativos
- Proporciona contexto que no está en operativo
- Nunca duplica pasos operativos

---

### Bloque 2: Imagen Estática

**Propósito:** Mostrar fotografías, diagramas o ilustraciones

**Características:**
- Imagen única con descripción
- Caption opcional
- Alt text para accesibilidad
- Puede tener zoom o lightbox

**Cuándo usarlo:**
- Fotografías de técnicas
- Diagramas anatómicos
- Ilustraciones de conceptos
- Capturas de equipamiento

**Relación con operativo:**
- Muestra visualmente lo que los pasos operativos describen
- Complementa información operativa sin duplicarla

---

### Bloque 3: Infografía

**Propósito:** Visualizar información compleja de forma sintética

**Características:**
- Combinación de texto, iconos, diagramas
- Diseño visual estructurado
- Información densa pero escaneable
- Puede ser interactiva

**Cuándo usarlo:**
- Algoritmos visuales
- Flujos de decisión
- Comparaciones lado a lado
- Resúmenes visuales

**Relación con operativo:**
- Visualiza protocolos operativos sin duplicar pasos
- Hace comprensible información compleja

---

### Bloque 4: Vídeo

**Propósito:** Demostrar técnicas o procesos en movimiento

**Características:**
- Archivo de vídeo embebido
- Controles de reproducción
- Subtítulos opcionales
- Descripción textual alternativa

**Cuándo usarlo:**
- Técnicas que requieren movimiento
- Secuencias temporales
- Demostraciones prácticas
- Animaciones de procesos

**Relación con operativo:**
- Muestra ejecución de pasos operativos
- Complementa descripciones textuales

---

### Bloque 5: Lista Estructurada

**Propósito:** Organizar información en formato de lista

**Características:**
- Lista numerada o con viñetas
- Items con formato consistente
- Puede tener sub-items
- Puede ser expandible/colapsable

**Cuándo usarlo:**
- Conceptos clave
- Características o propiedades
- Checklist de verificación
- Pasos explicativos (no operativos)

**Relación con operativo:**
- Organiza información complementaria
- Nunca duplica listas de pasos operativos

---

### Bloque 6: Caja de Advertencia

**Propósito:** Destacar información crítica de seguridad

**Características:**
- Fondo de color distintivo (amarillo/naranja/rojo)
- Icono de alerta
- Texto destacado
- Borde visible

**Cuándo usarlo:**
- Advertencias de seguridad
- Errores críticos a evitar
- Información de riesgo
- Contraindicaciones importantes

**Relación con operativo:**
- Profundiza en advertencias operativas
- Proporciona contexto de por qué es importante
- Nunca contradice información operativa

---

### Bloque 7: Caso Clínico

**Propósito:** Aprender mediante ejemplo práctico completo

**Características:**
- Estructura narrativa completa
- Presentación del caso
- Análisis paso a paso
- Aplicación de protocolo
- Puntos de aprendizaje

**Cuándo usarlo:**
- Situaciones complejas
- Aplicación práctica de protocolos
- Aprendizaje por casos
- Validación de comprensión

**Relación con operativo:**
- Muestra aplicación real del protocolo operativo
- Ilustra cómo se usan los pasos en contexto

---

### Bloque 8: Comparación Visual

**Propósito:** Mostrar diferencias entre opciones o errores vs correcto

**Características:**
- Dos o más elementos lado a lado
- Etiquetas claras (correcto/incorrecto, antes/después)
- Diferencias destacadas visualmente
- Descripción de cada opción

**Cuándo usarlo:**
- Errores frecuentes vs forma correcta
- Comparación de técnicas
- Antes y después
- Opciones de tratamiento

**Relación con operativo:**
- Visualiza los "Puntos críticos TES" del contenido operativo
- Muestra qué NO hacer (complementa lo que SÍ hacer)

---

### Bloque 9: Tabla de Referencia

**Propósito:** Organizar información tabular compleja

**Características:**
- Filas y columnas estructuradas
- Headers claros
- Datos organizados lógicamente
- Puede ser responsive

**Cuándo usarlo:**
- Valores de referencia
- Comparaciones sistemáticas
- Rangos y parámetros
- Clasificaciones

**Relación con operativo:**
- Proporciona contexto de valores mencionados en operativo
- Nunca duplica tablas operativas críticas

---

### Bloque 10: Diagrama de Flujo

**Propósito:** Visualizar procesos de decisión y algoritmos

**Características:**
- Nodos y flechas
- Decisiones y acciones claras
- Flujo lógico visualizado
- Puede ser interactivo

**Cuándo usarlo:**
- Algoritmos de decisión
- Flujos de protocolo
- Árboles de decisión
- Procesos complejos

**Relación con operativo:**
- Visualiza la lógica detrás de los pasos operativos
- Muestra ramificaciones y decisiones

---

### Bloque 11: Galería de Imágenes

**Propósito:** Mostrar secuencia de imágenes relacionadas

**Características:**
- Múltiples imágenes en secuencia
- Navegación entre imágenes
- Descripción por imagen
- Vista previa en miniatura

**Cuándo usarlo:**
- Secuencias paso a paso de técnicas
- Múltiples ángulos de vista
- Progresión temporal
- Variaciones de un procedimiento

**Relación con operativo:**
- Muestra visualmente la secuencia de pasos operativos
- Proporciona múltiples perspectivas

---

### Bloque 12: Resumen Visual

**Propósito:** Síntesis visual de toda la guía

**Características:**
- Infografía única de una página
- Puntos clave destacados
- Diseño escaneable rápidamente
- Enlace al protocolo operativo

**Cuándo usarlo:**
- Cierre de guía
- Referencia rápida posterior
- Resumen de aprendizaje

**Relación con operativo:**
- Proporciona puente visual hacia protocolo operativo
- Síntesis de lo aprendido

---

## 3️⃣ Reglas de Convivencia con el Modo Operativo

### Regla 1: Separación Clara de Propósitos

**Operativo = Acción | Refuerzo = Comprensión**

- **Operativo:** Información para ejecutar AHORA
- **Refuerzo:** Información para entender y aprender

**Implementación:**
- Navegación separada pero relacionada
- Enlaces bidireccionales claros
- Indicadores visuales de modo (operativo vs refuerzo)

---

### Regla 2: Información que NUNCA Debe Ir a la Guía de Refuerzo

**Lista de exclusión absoluta:**

1. ❌ **Pasos numerados de protocolos**
   - **Razón:** Son sagrados en operativo, fuente única de verdad
   - **Alternativa:** Enlazar al protocolo operativo, comentar visualmente

2. ❌ **Dosis exactas de fármacos**
   - **Razón:** Valores críticos que no deben duplicarse
   - **Alternativa:** Explicar mecanismo, enlazar a vademécum operativo

3. ❌ **Contraindicaciones exactas**
   - **Razón:** Información crítica de seguridad
   - **Alternativa:** Explicar por qué son contraindicaciones, enlazar a operativo

4. ❌ **Advertencias críticas operativas**
   - **Razón:** Prevención de errores en tiempo real
   - **Alternativa:** Profundizar en errores frecuentes con casos visuales

5. ❌ **Valores numéricos críticos** (profundidad compresiones, frecuencias)
   - **Razón:** Valores precisos necesarios para ejecución
   - **Alternativa:** Explicar por qué esos valores, enlazar a operativo

**Principio:** La información operativa es **fuente única de verdad** para valores y pasos críticos.

---

### Regla 3: Información que Puede Aparecer en Ambos Modos

**Lista de información compartida:**

1. ✅ **Títulos y nombres**
   - Protocolo: "RCP Adulto SVB"
   - Fármaco: "Adrenalina"
   - **Razón:** Identificación común, no valores críticos

2. ✅ **Categorías y clasificaciones**
   - Prioridad: "Crítico"
   - Categoría: "Soporte Vital"
   - **Razón:** Metadatos de organización, no información operativa

3. ✅ **Relaciones entre entidades**
   - "Este protocolo usa este fármaco"
   - "Protocolos relacionados"
   - **Razón:** Navegación y contexto, no valores críticos

4. ✅ **Metadatos de navegación**
   - Enlaces relacionados
   - Breadcrumbs
   - **Razón:** Navegación, no contenido crítico

**Principio:** Solo metadatos y navegación pueden compartirse, nunca valores o pasos críticos.

---

### Regla 4: Enlaces Operativo ↔ Refuerzo

**Patrón de enlace:**

```
[Contenido Operativo]
  ↓ "¿Quieres entender más?"
[Guía de Refuerzo]

[Guía de Refuerzo]
  ↓ "Ver protocolo operativo"
[Contenido Operativo]
```

**Implementación:**

1. **Desde Operativo hacia Refuerzo:**
   - Botón discreto: "Guía de Refuerzo" o "Aprender más"
   - Ubicación: Al final del contenido operativo
   - Estilo: Secundario, no compite con información crítica

2. **Desde Refuerzo hacia Operativo:**
   - Botón destacado: "Ver Protocolo Operativo" o "Ir a Acción Rápida"
   - Ubicación: Múltiples puntos (introducción, resumen, referencias)
   - Estilo: Primario, claro que lleva a acción

**Principio:** Los enlaces deben ser **claros y bidireccionales**, sin confundir al usuario sobre qué modo está usando.

---

### Regla 5: Indicadores Visuales de Modo

**Sistema de identificación:**

1. **Header/Breadcrumb:**
   - Operativo: "Protocolo RCP" | Badge "Operativo"
   - Refuerzo: "Guía de Refuerzo: RCP" | Badge "Formación"

2. **Colores/Temas:**
   - Operativo: Colores de acción (rojo/naranja para crítico)
   - Refuerzo: Colores de aprendizaje (azul/verde para formación)

3. **Iconografía:**
   - Operativo: Iconos de acción (play, check, alert)
   - Refuerzo: Iconos de aprendizaje (book, lightbulb, video)

**Principio:** El usuario debe saber **inmediatamente** en qué modo está.

---

### Regla 6: Prevención de Confusión

**Estrategias:**

1. **Nunca mostrar ambos modos simultáneamente**
   - No mostrar pasos operativos dentro de guía de refuerzo
   - No mostrar explicaciones extensas dentro de protocolo operativo

2. **Transiciones claras**
   - Al cambiar de modo, indicar claramente el cambio
   - Mostrar breadcrumb actualizado
   - Resaltar visualmente el nuevo contexto

3. **Mensajes contextuales**
   - En operativo: "Para acción inmediata"
   - En refuerzo: "Para comprensión y formación"

**Principio:** El usuario nunca debe dudar sobre qué información usar en cada contexto.

---

## 4️⃣ Estructura Abstracta de una Guía de Refuerzo

### Modelo Conceptual

```
GUÍA DE REFUERZO
│
├── METADATOS
│   ├── ID único
│   ├── Título
│   ├── Tema relacionado (protocolo/fármaco/herramienta)
│   ├── Nivel de dificultad
│   ├── Tiempo estimado
│   └── Enlace a contenido operativo relacionado (obligatorio)
│
├── SECCIÓN 1: INTRODUCCIÓN
│   ├── Bloque: Texto Explicativo
│   └── Contenido: Contexto, objetivos, prerrequisitos
│
├── SECCIÓN 2: EXPLICACIÓN CLÍNICA
│   ├── Bloque: Texto Explicativo
│   ├── Bloque: Imagen / Diagrama
│   └── Contenido: Base científica, fisiopatología
│
├── SECCIÓN 3: ALGORITMO COMENTADO
│   ├── Bloque: Diagrama de Flujo / Infografía
│   ├── Bloque: Texto Explicativo (comentarios)
│   └── Contenido: Visualización del protocolo con explicaciones
│
├── SECCIÓN 4: MEDIOS VISUALES
│   ├── Bloque: Galería de Imágenes
│   ├── Bloque: Vídeo (opcional)
│   └── Contenido: Técnicas visualizadas paso a paso
│
├── SECCIÓN 5: ERRORES FRECUENTES
│   ├── Bloque: Comparación Visual
│   ├── Bloque: Caja de Advertencia
│   └── Contenido: Errores comunes con visualización
│
├── SECCIÓN 6: CASOS CLÍNICOS
│   ├── Bloque: Caso Clínico
│   ├── Bloque: Imagen / Vídeo (opcional)
│   └── Contenido: Ejemplos prácticos completos
│
├── SECCIÓN 7: RESUMEN VISUAL
│   ├── Bloque: Resumen Visual / Infografía
│   └── Contenido: Síntesis de una página
│
└── SECCIÓN 8: REFERENCIAS
    ├── Bloque: Lista Estructurada
    └── Contenido: Bibliografía y enlaces
```

---

## 5️⃣ Reglas de Validación

**Validaciones que debe cumplir una Guía de Refuerzo:**

1. ✅ **Debe tener enlace a contenido operativo relacionado**
   - No puede existir sin relación con operativo

2. ✅ **No debe duplicar pasos operativos**
   - Puede comentarlos, visualizarlos, explicarlos
   - No puede listarlos como pasos numerados

3. ✅ **Debe tener al menos una sección de medios visuales**
   - Al menos una imagen, infografía o vídeo
   - Diferencia clave con contenido operativo

4. ✅ **Debe tener sección de resumen visual**
   - Siempre presente como cierre
   - Proporciona síntesis y enlace a operativo

5. ✅ **Debe tener tiempo estimado realista**
   - Basado en longitud de contenido
   - Ayuda al usuario a decidir si tiene tiempo

---

## 6️⃣ Criterios de Decisión

### ¿Cuándo crear una Guía de Refuerzo?

**Crear guía cuando:**
- ✅ El protocolo es complejo y se beneficiaría de explicación visual
- ✅ Hay errores frecuentes que requieren visualización
- ✅ El tema requiere comprensión científica profunda
- ✅ Hay casos clínicos que ilustran el protocolo
- ✅ El contenido operativo existe y está completo

**NO crear guía cuando:**
- ❌ El protocolo operativo aún no existe
- ❌ El contenido es muy simple y no requiere explicación
- ❌ No hay medios visuales disponibles
- ❌ El protocolo es muy nuevo y puede cambiar

---

### ¿Qué información va a cada sección?

**Introducción:**
- Contexto general, objetivos, tiempo estimado

**Explicación Clínica:**
- Fisiopatología, mecanismos, ciencia detrás del protocolo

**Algoritmo Comentado:**
- Visualización del protocolo con comentarios explicativos

**Medios Visuales:**
- Técnicas paso a paso, demostraciones visuales

**Errores Frecuentes:**
- Errores comunes visualizados, comparaciones correcto/incorrecto

**Casos Clínicos:**
- Ejemplos prácticos completos con análisis

**Resumen Visual:**
- Síntesis de una página con puntos clave

**Referencias:**
- Guías oficiales, bibliografía, enlaces relacionados

---

## 7️⃣ Ejemplo de Uso del Modelo

### Ejemplo: Guía de Refuerzo "RCP Adulto SVB"

**Metadatos:**
- ID: `refuerzo-rcp-adulto-svb`
- Título: "Guía de Refuerzo: RCP Adulto SVB"
- Relacionado con: `protocolo-rcp-adulto-svb`
- Nivel: Intermedio
- Tiempo: 15 minutos

**Estructura:**

**Sección 1: Introducción**
- Bloque Texto: "La reanimación cardiopulmonar (RCP) es el conjunto de maniobras destinadas a sustituir temporalmente la función del corazón y los pulmones..."
- Enlace: "Ver Protocolo Operativo RCP"

**Sección 2: Explicación Clínica**
- Bloque Texto: Explicación de fisiopatología de la PCR
- Bloque Imagen: Diagrama del sistema cardiovascular
- Bloque Texto: Explicación de por qué las compresiones salvan vidas

**Sección 3: Algoritmo Comentado**
- Bloque Infografía: Algoritmo RCP visual con comentarios en cada paso
- Bloque Texto: "Paso 1: Garantizar seguridad - Esto es crítico porque..."
- Enlace: "Ver pasos operativos completos"

**Sección 4: Medios Visuales**
- Bloque Galería: 6 imágenes de técnica de compresiones (posición manos, profundidad, frecuencia)
- Bloque Vídeo: Demostración de compresiones de calidad (30 segundos)

**Sección 5: Errores Frecuentes**
- Bloque Comparación Visual: Compresiones incorrectas vs correctas (lado a lado)
- Bloque Caja Advertencia: "Error común: No permitir descompresión completa"
- Bloque Texto: Explicación de consecuencias del error

**Sección 6: Casos Clínicos**
- Bloque Caso Clínico: "Caso: PCR en vía pública"
  - Presentación: "Varón de 45 años encontrado inconsciente..."
  - Análisis: Aplicación paso a paso del protocolo
  - Puntos de aprendizaje: 3 puntos clave

**Sección 7: Resumen Visual**
- Bloque Resumen Visual: Infografía de una página con algoritmo completo y puntos clave

**Sección 8: Referencias**
- Bloque Lista: Guías ERC 2021, AHA 2020, enlaces relacionados

---

## Conclusión

Este modelo es el **contrato conceptual oficial** para crear Guías de Refuerzo. 

**Principios fundamentales:**
1. ✅ **Nunca duplicar** información operativa crítica
2. ✅ **Siempre enlazar** al protocolo operativo relacionado
3. ✅ **Usar medios visuales** como diferencia clave
4. ✅ **Seguir estructura** de 8 secciones estándar
5. ✅ **Mantener separación** clara con contenido operativo

**Uso del modelo:**
- Consultar antes de crear cualquier guía
- Seguir estructura y reglas definidas
- No improvisar ni contaminar Markdown operativo
- Mantener coherencia entre todas las guías

---

**Fin del Modelo Oficial**

*Este documento debe consultarse siempre que se cree o modifique una Guía de Refuerzo.*