planetazuzu a26963654f Implementación completa: Guías de Refuerzo (Modo Formativo)

- Arquitectura paralela para Guías de Refuerzo
- Nuevos componentes: GuideCard, GuideHeader, GuideNavigation, etc.
- Vistas formativas: GuideIndex, GuideViewer, GuideSectionViewer
- Layout específico GuideLayout (sin BottomNav)
- Índice de guías con ABCDE Operativo y RCP Adulto SVB
- Corrección de Service Worker para desarrollo
- Enlaces de navegación en menú y página principal
- Documentación completa de implementación

2025-12-27 19:29:00 +01:00

56 KiB

Raw Blame History

🔧 Esqueleto Técnico - Guía de Refuerzo

Fecha: 2025-12-23
Autor: Arquitecto de Sistema de Contenido, Diseñador de Estructuras Formativas y Experto en Arquitectura de Información
Especialización: Aplicaciones sanitarias críticas y guías profesionales
Versión: 1.0
Estado: Plantilla Estructural Definitiva

🎯 Propósito del Documento

Este documento define el esqueleto técnico vacío de la Guía de Refuerzo como estructura reutilizable para todas las Guías de Refuerzo de Categoría C.

Objetivo:

Establecer estructura técnica sin contenido médico
Definir campos, tipos y relaciones
Crear plantilla reutilizable
Establecer reglas de validación

Uso:

Base para crear nuevas Guías de Refuerzo
Contrato de estructura técnica
Validación automática de guías
Versionado y mantenimiento

1️⃣ FORMATO DEL ESQUELETO

A) Esquema Estructural en YAML

# Esqueleto Técnico - Guía de Refuerzo
# Versión: 1.0
# Uso: Plantilla para todas las Guías de Refuerzo Categoría C

guia_refuerzo:
  # Metadatos de nivel guía
  metadata:
    idGuia: ""                    # Identificador único (slug)
    titulo: ""                    # Título principal
    subtitulo: ""                 # Subtítulo descriptivo
    categoria: "C"                # Siempre "C" para este esqueleto
    modo: "formacion_refuerzo"    # Siempre "formacion_refuerzo"
    tiempoEstimado:
      minimo: 0                   # Minutos (solo secciones obligatorias)
      recomendado: 0              # Minutos (con secciones opcionales recomendadas)
      completo: 0                 # Minutos (todo el contenido)
    publicoObjetivo: ""           # Descripción del público objetivo
    advertenciaUso: ""            # Texto de advertencia sobre uso formativo
    protocoloOperativoRelacionado:
      id: ""                      # ID del protocolo operativo relacionado
      slug: ""                    # Slug del protocolo operativo
      titulo: ""                  # Título del protocolo operativo
    versionGuia: "1.0"            # Versión de la guía
    estadoGuia: "borrador"        # borrador | activa | archivada
    fechaCreacion: ""             # ISO 8601
    fechaRevision: ""             # ISO 8601
    fechaActualizacion: ""        # ISO 8601 (última actualización)
    autor: ""                     # Autor/es de la guía
    revisadoPor: ""               # Revisor/es médico/s técnico/s

  # Estructura de secciones (8 secciones estándar)
  secciones:
    - idSeccion: "seccion_01"
      nombreSeccion: "Introducción y Contexto"
      orden: 1                    # Orden fijo en la guía
      obligatoria: true
      tiempoEstimado: 3           # Minutos estimados
      objetivoPedagogico: ""      # Objetivo pedagógico de la sección
      tiposDeBloquePermitidos:    # Tipos de bloques que puede contener
        - "texto_explicativo"
        - "visual_explicativo"
        - "enlace_operativo"
      enlaceOperativoRecomendado: true
      bloques: []                 # Array de bloques (ver definición de bloques)

    - idSeccion: "seccion_02"
      nombreSeccion: "Explicación Clínica y Fisiopatología"
      orden: 2
      obligatoria: true
      tiempoEstimado: 5
      objetivoPedagogico: ""
      tiposDeBloquePermitidos:
        - "texto_explicativo"
        - "visual_explicativo"
        - "pedagogico_explicativo"
      enlaceOperativoRecomendado: false
      bloques: []

    - idSeccion: "seccion_03"
      nombreSeccion: "Algoritmo Comentado Visual"
      orden: 3
      obligatoria: true
      tiempoEstimado: 4
      objetivoPedagogico: ""
      tiposDeBloquePermitidos:
        - "visual_explicativo"
        - "texto_explicativo"
        - "enlace_operativo"
      enlaceOperativoRecomendado: true
      bloques: []

    - idSeccion: "seccion_04"
      nombreSeccion: "Medios Visuales y Demostración"
      orden: 4
      obligatoria: true
      tiempoEstimado: 5
      objetivoPedagogico: ""
      tiposDeBloquePermitidos:
        - "audiovisual"
        - "visual_explicativo"
        - "texto_explicativo"
      enlaceOperativoRecomendado: false
      bloques: []

    - idSeccion: "seccion_05"
      nombreSeccion: "Errores Frecuentes Visualizados"
      orden: 5
      obligatoria: true
      tiempoEstimado: 4
      objetivoPedagogico: ""
      tiposDeBloquePermitidos:
        - "error_frecuente"
        - "visual_explicativo"
        - "texto_explicativo"
        - "enlace_operativo"
      enlaceOperativoRecomendado: true
      bloques: []

    - idSeccion: "seccion_06"
      nombreSeccion: "Casos Clínicos"
      orden: 6
      obligatoria: false
      tiempoEstimado: 8
      objetivoPedagogico: ""
      tiposDeBloquePermitidos:
        - "caso_clinico"
        - "visual_explicativo"
        - "texto_explicativo"
      enlaceOperativoRecomendado: false
      bloques: []

    - idSeccion: "seccion_07"
      nombreSeccion: "Simulación Mental Guiada"
      orden: 7
      obligatoria: false
      tiempoEstimado: 5
      objetivoPedagogico: ""
      tiposDeBloquePermitidos:
        - "simulacion_mental"
        - "texto_explicativo"
      enlaceOperativoRecomendado: false
      bloques: []

    - idSeccion: "seccion_08"
      nombreSeccion: "Resumen Visual y Puente al Operativo"
      orden: 8
      obligatoria: true
      tiempoEstimado: 2
      objetivoPedagogico: ""
      tiposDeBloquePermitidos:
        - "resumen_visual"
        - "enlace_operativo"
        - "texto_explicativo"
      enlaceOperativoRecomendado: true
      bloques: []

  # Definición de tipos de bloques (plantillas reutilizables)
  tipos_de_bloques:
    texto_explicativo:
      idBloque: "texto_explicativo"
      tipoBloque: "texto_explicativo"
      proposito: "Proporcionar explicaciones narrativas que contextualizan y profundizan conceptos"
      camposEsperados:
        - id: ""                  # ID único del bloque
        - titulo: ""              # Título del bloque (opcional)
        - contenido: ""           # Contenido textual explicativo
        - relacionConMarkdown:    # Referencia al Markdown relacionado
            capituloId: ""
            enlace: ""
      reglasDeUso:
        - "Explica el 'por qué' de conceptos"
        - "Proporciona contexto clínico"
        - "Amplía conceptos del Markdown"
      restricciones:
        - "NO incluye pasos numerados exactos"
        - "NO incluye valores numéricos críticos"
        - "NO incluye contraindicaciones exactas"
        - "NO incluye advertencias críticas operativas"
      relacionConMarkdown: "amplia_conceptos"
      obligatorioEnGuiasC: false

    visual_explicativo:
      idBloque: "visual_explicativo"
      tipoBloque: "visual_explicativo"
      proposito: "Mostrar visualmente conceptos, técnicas o procesos que requieren comprensión visual"
      camposEsperados:
        - id: ""
        - titulo: ""
        - tipoVisual: ""          # infografia | diagrama | secuencia_fotografica | comparacion
        - urlImagen: ""           # URL o ruta a imagen/infografía
        - altText: ""             # Texto alternativo para accesibilidad
        - caption: ""             # Caption descriptivo (opcional)
        - relacionConMarkdown:
            capituloId: ""
            enlace: ""
      reglasDeUso:
        - "Visualiza algoritmos y flujos"
        - "Muestra técnicas paso a paso"
        - "Ilustra conceptos anatómicos o fisiológicos"
        - "Compara visualmente (correcto vs incorrecto)"
      restricciones:
        - "NO incluye valores numéricos exactos (solo rangos o conceptos)"
        - "NO incluye pasos operativos numerados exactos"
        - "NO incluye información crítica de seguridad sin enlace al operativo"
      relacionConMarkdown: "visualiza_conceptos"
      obligatorioEnGuiasC: false

    audiovisual:
      idBloque: "audiovisual"
      tipoBloque: "audiovisual"
      proposito: "Demostrar técnicas en movimiento y proporcionar experiencia sensorial completa"
      camposEsperados:
        - id: ""
        - titulo: ""
        - tipoAudiovisual: ""    # video | animacion | audio
        - urlVideo: ""            # URL o ruta a vídeo
        - duracion: 0             # Segundos
        - descripcion: ""         # Descripción del contenido del vídeo
        - transcripcion: ""       # Transcripción para accesibilidad (opcional)
        - relacionConMarkdown:
            capituloId: ""
            enlace: ""
      reglasDeUso:
        - "Demuestra técnicas que requieren movimiento"
        - "Muestra secuencias temporales complejas"
        - "Proporciona experiencia sensorial"
      restricciones:
        - "NO incluye valores numéricos exactos (solo demostración visual)"
        - "NO incluye pasos operativos numerados exactos"
        - "NO incluye información crítica sin enlace al operativo"
      relacionConMarkdown: "muestra_ejecucion"
      obligatorioEnGuiasC: false

    error_frecuente:
      idBloque: "error_frecuente"
      tipoBloque: "error_frecuente"
      proposito: "Prevenir errores mediante visualización comparativa y comprensión de consecuencias"
      camposEsperados:
        - id: ""
        - titulo: ""
        - descripcionError: ""    # Descripción del error frecuente
        - visualizacionCorrecto: # Visualización de técnica correcta
            urlImagen: ""
            altText: ""
        - visualizacionIncorrecto: # Visualización de técnica incorrecta
            urlImagen: ""
            altText: ""
        - consecuencias: ""       # Explicación de consecuencias del error
        - prevencion: ""          # Cómo evitar el error
        - relacionConMarkdown:
            capituloId: ""
            enlace: ""
            puntoCritico: ""      # Referencia a "Puntos críticos TES" del protocolo
      reglasDeUso:
        - "Visualiza comparación lado a lado (correcto vs incorrecto)"
        - "Explica consecuencias de errores frecuentes"
        - "Muestra cómo evitar errores comunes"
      restricciones:
        - "NO incluye pasos operativos exactos (solo comparación visual)"
        - "NO incluye valores numéricos exactos"
        - "NO incluye información crítica sin enlace al operativo"
      relacionConMarkdown: "visualiza_advertencias"
      obligatorioEnGuiasC: false

    caso_clinico:
      idBloque: "caso_clinico"
      tipoBloque: "caso_clinico"
      proposito: "Aprender mediante aplicación práctica del protocolo en situaciones reales o simuladas"
      camposEsperados:
        - id: ""
        - titulo: ""
        - nivelComplejidad: ""    # estandar | variaciones | complejo
        - presentacion:           # Presentación del caso
            situacion: ""
            lugar: ""
            paciente: ""
            contexto: ""
        - analisis:               # Análisis paso a paso
            pasos: []             # Array de pasos de análisis (NO pasos operativos)
            decisiones: []        # Array de decisiones tomadas
        - aprendizaje:            # Puntos de aprendizaje
            puntosClave: []       # Array de puntos clave aprendidos (máx 3-5)
            aplicacion: ""        # Aplicación a otras situaciones
        - relacionConMarkdown:
            capituloId: ""
            enlace: ""
      reglasDeUso:
        - "Muestra aplicación del protocolo en contexto"
        - "Valida comprensión profunda"
        - "Ilustra integración de múltiples conceptos"
      restricciones:
        - "NO incluye pasos operativos exactos (solo aplicación contextual)"
        - "NO incluye valores numéricos exactos"
        - "NO incluye información crítica sin enlace al operativo"
      relacionConMarkdown: "muestra_aplicacion"
      obligatorioEnGuiasC: false

    simulacion_mental:
      idBloque: "simulacion_mental"
      tipoBloque: "simulacion_mental"
      proposito: "Facilitar práctica mental del protocolo mediante escenarios guiados con decisiones y feedback"
      camposEsperados:
        - id: ""
        - titulo: ""
        - escenario: ""           # Descripción del escenario inicial
        - decisiones: []          # Array de decisiones
            - id: ""
              pregunta: ""
              opciones: []        # Array de opciones
              respuestaCorrecta: ""
              feedback: ""        # Explicación de la respuesta
        - reflexion: ""           # Reflexión post-simulación
        - relacionConMarkdown:
            capituloId: ""
            enlace: ""
      reglasDeUso:
        - "Facilita práctica mental del protocolo"
        - "Valida comprensión profunda"
        - "Entrena toma de decisiones"
      restricciones:
        - "NO incluye pasos operativos exactos (solo decisiones)"
        - "NO incluye valores numéricos exactos"
        - "NO incluye información crítica sin enlace al operativo"
      relacionConMarkdown: "basado_en_protocolo"
      obligatorioEnGuiasC: false

    resumen_visual:
      idBloque: "resumen_visual"
      tipoBloque: "resumen_visual"
      proposito: "Síntesis visual rápida de toda la guía para referencia posterior y puente al protocolo operativo"
      camposEsperados:
        - id: ""
        - titulo: ""
        - tipoResumen: ""         # infografia_una_pagina | algoritmo_visual | puntos_clave
        - urlInfografia: ""       # URL o ruta a infografía
        - puntosClave: []         # Array de puntos clave (5-7 puntos)
            - id: ""
              texto: ""
              icono: ""           # Opcional
        - relacionConMarkdown:
            capituloId: ""
            enlace: ""
      reglasDeUso:
        - "Sintetiza visualmente puntos clave aprendidos"
        - "Proporciona puente visual hacia protocolo operativo"
        - "Consolida aprendizaje"
      restricciones:
        - "NO incluye pasos operativos exactos (solo síntesis visual)"
        - "NO incluye valores numéricos exactos"
        - "NO incluye información crítica sin enlace al operativo"
      relacionConMarkdown: "resume_conceptos"
      obligatorioEnGuiasC: true  # Obligatorio en todas las guías C

    enlace_operativo:
      idBloque: "enlace_operativo"
      tipoBloque: "enlace_operativo"
      proposito: "Proporcionar acceso claro y destacado al protocolo operativo relacionado"
      camposEsperados:
        - id: ""
        - textoEnlace: ""         # Texto del enlace
        - tipoEnlace: ""          # boton_primario | boton_secundario | enlace_discreto
        - protocoloOperativo:
            id: ""
            slug: ""
            titulo: ""
        - mensajeContextual: ""   # Mensaje contextual (opcional)
      reglasDeUso:
        - "Proporciona acceso al protocolo operativo"
        - "Transición clara entre modos"
        - "Siempre disponible"
      restricciones:
        - "NO incluye información operativa exacta (solo enlace)"
        - "NO incluye valores numéricos exactos"
      relacionConMarkdown: "enlace_directo"
      obligatorioEnGuiasC: false  # Pero debe aparecer en múltiples puntos

B) Representación Conceptual en Pseudo-Markdown (Vacía)

# [TÍTULO DE LA GUÍA DE REFUERZO]

**Subtítulo:** [SUBTÍTULO DESCRIPTIVO]

---

## 📋 Metadatos de la Guía

- **ID Guía:** `[idGuia]`
- **Categoría:** C
- **Modo:** Formación / Refuerzo
- **Tiempo Estimado:** [minimo] min (mínimo) | [recomendado] min (recomendado) | [completo] min (completo)
- **Protocolo Operativo Relacionado:** [título] ([enlace])
- **Versión:** [versionGuia]
- **Estado:** [estadoGuia]

> ⚠️ **Advertencia:** [advertenciaUso]

---

## SECCIÓN 1: Introducción y Contexto

**Objetivo:** [objetivoPedagogico]

### Bloque: Texto Explicativo
[TÍTULO DEL BLOQUE]

[CONTENIDO EXPLICATIVO - Contexto, importancia, objetivos de aprendizaje]

### Bloque: Visual Explicativo
[TÍTULO DEL BLOQUE]

![Mini resumen visual del algoritmo]([urlImagen])
*[caption]*

### Bloque: Enlace Operativo
[Ver Protocolo Operativo [título]]([enlace]) [botón primario destacado]

---

## SECCIÓN 2: Explicación Clínica y Fisiopatología

**Objetivo:** [objetivoPedagogico]

### Bloque: Texto Explicativo
[TÍTULO DEL BLOQUE]

[CONTENIDO EXPLICATIVO - Fisiopatología, mecanismos, relaciones causa-efecto]

### Bloque: Visual Explicativo
[TÍTULO DEL BLOQUE]

![Diagrama del sistema cardiovascular]([urlImagen])
*[caption]*

---

## SECCIÓN 3: Algoritmo Comentado Visual

**Objetivo:** [objetivoPedagogico]

### Bloque: Visual Explicativo
[TÍTULO DEL BLOQUE]

![Algoritmo completo con comentarios]([urlImagen])
*[caption]*

### Bloque: Texto Explicativo
[TÍTULO DEL BLOQUE]

[COMENTARIOS EXPLICATIVOS POR PASO - Explicación del "por qué" de cada paso]

### Bloque: Enlace Operativo
[Ver pasos operativos exactos]([enlace]) [enlace discreto]

---

## SECCIÓN 4: Medios Visuales y Demostración

**Objetivo:** [objetivoPedagogico]

### Bloque: Audiovisual
[TÍTULO DEL BLOQUE]

[VIDEO DEMOSTRATIVO]
- Duración: [duracion] segundos
- Descripción: [descripcion]

### Bloque: Visual Explicativo
[TÍTULO DEL BLOQUE]

![Secuencia fotográfica paso a paso]([urlImagen])
*[caption]*

### Bloque: Texto Explicativo
[TÍTULO DEL BLOQUE]

[DESCRIPCIÓN DE QUÉ OBSERVAR - Qué observar en cada paso del vídeo]

---

## SECCIÓN 5: Errores Frecuentes Visualizados

**Objetivo:** [objetivoPedagogico]

### Bloque: Error Frecuente
[TÍTULO DEL ERROR]

**Descripción del error:** [descripcionError]

**Visualización:**
- ✅ Correcto: ![Técnica correcta]([urlImagenCorrecto])
- ❌ Incorrecto: ![Técnica incorrecta]([urlImagenIncorrecto])

**Consecuencias:** [consecuencias]

**Prevención:** [prevencion]

**Relación con Protocolo Operativo:** [enlace a punto crítico del protocolo]

---

## SECCIÓN 6: Casos Clínicos

**Objetivo:** [objetivoPedagogico]

### Bloque: Caso Clínico
**Caso [número]: [título]**

**Nivel de complejidad:** [nivelComplejidad]

**Presentación:**
- Situación: [situacion]
- Lugar: [lugar]
- Paciente: [paciente]
- Contexto: [contexto]

**Análisis:**
[ANÁLISIS PASO A PASO - Aplicación del protocolo en contexto]

**Puntos de aprendizaje:**
1. [puntoClave1]
2. [puntoClave2]
3. [puntoClave3]

---

## SECCIÓN 7: Simulación Mental Guiada

**Objetivo:** [objetivoPedagogico]

### Bloque: Simulación Mental
[TÍTULO DE LA SIMULACIÓN]

**Escenario:** [escenario]

**Decisiones:**
1. [pregunta]
   - Opción A: [opcionA]
   - Opción B: [opcionB]
   - Opción C: [opcionC]
   - ✅ Respuesta correcta: [respuestaCorrecta]
   - 💡 Feedback: [feedback]

**Reflexión:** [reflexion]

---

## SECCIÓN 8: Resumen Visual y Puente al Operativo

**Objetivo:** [objetivoPedagogico]

### Bloque: Resumen Visual
[TÍTULO DEL RESUMEN]

![Infografía de una página con algoritmo completo]([urlInfografia])
*[caption]*

**Puntos clave recordar:**
1. [puntoClave1]
2. [puntoClave2]
3. [puntoClave3]
4. [puntoClave4]
5. [puntoClave5]

### Bloque: Enlace Operativo
[Ir a Protocolo Operativo [título]]([enlace]) [botón primario destacado]

**Mensaje de cierre:** [mensaje de cierre que consolida aprendizaje y prepara para acción]

2️⃣ METADATOS DE NIVEL GUÍA

Campos Obligatorios

metadata:
  # Identificación
  idGuia: ""                    # Slug único (ej: "rcp-adulto-svb")
  titulo: ""                    # Título principal (ej: "Guía de Refuerzo — RCP Adulto SVB")
  subtitulo: ""                 # Subtítulo descriptivo (ej: "Comprensión Profunda y Formación...")
  
  # Clasificación
  categoria: "C"                # Siempre "C" para este esqueleto
  modo: "formacion_refuerzo"    # Siempre "formacion_refuerzo"
  
  # Tiempo estimado
  tiempoEstimado:
    minimo: 0                   # Minutos (solo secciones obligatorias: 1-5, 8)
    recomendado: 0              # Minutos (con secciones opcionales recomendadas: +6)
    completo: 0                 # Minutos (todo el contenido: +7)
  
  # Público y uso
  publicoObjetivo: ""           # Descripción del público objetivo
  advertenciaUso: ""            # Texto de advertencia sobre uso formativo
  
  # Relación con protocolo operativo
  protocoloOperativoRelacionado:
    id: ""                      # ID del protocolo operativo
    slug: ""                    # Slug del protocolo operativo
    titulo: ""                  # Título del protocolo operativo
  
  # Versionado
  versionGuia: "1.0"            # Versión de la guía (semver)
  estadoGuia: "borrador"        # borrador | activa | archivada
  
  # Fechas (ISO 8601)
  fechaCreacion: ""             # Fecha de creación inicial
  fechaRevision: ""             # Fecha de última revisión médica/técnica
  fechaActualizacion: ""        # Fecha de última actualización de contenido
  
  # Autores
  autor: ""                     # Autor/es de la guía
  revisadoPor: ""               # Revisor/es médico/s técnico/s

Ejemplo de Valores (Placeholders)

metadata:
  idGuia: "[slug-unico-de-la-guia]"
  titulo: "[Título de la Guía de Refuerzo]"
  subtitulo: "[Subtítulo descriptivo del propósito formativo]"
  categoria: "C"
  modo: "formacion_refuerzo"
  tiempoEstimado:
    minimo: 15
    recomendado: 25
    completo: 35
  publicoObjetivo: "TES en formación inicial, formación continua y repaso"
  advertenciaUso: "Esta guía es para formación y comprensión. Para acción inmediata durante emergencia, usa el Protocolo Operativo."
  protocoloOperativoRelacionado:
    id: "[id-protocolo-operativo]"
    slug: "[slug-protocolo-operativo]"
    titulo: "[Título del Protocolo Operativo]"
  versionGuia: "1.0"
  estadoGuia: "borrador"
  fechaCreacion: "2025-12-23T00:00:00Z"
  fechaRevision: ""
  fechaActualizacion: "2025-12-23T00:00:00Z"
  autor: "[Nombre del autor]"
  revisadoPor: "[Nombre del revisor médico/técnico]"