codigo0/docs/consolidado/ANALISIS_REESTRUCTURACION_GUIA.md
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

35 KiB
Raw Blame History

📚 Análisis y Reestructuración de la Guía TES Digital

Fecha de análisis: 2025-12-23
Analista: Arquitecto de Información, Documentación Técnica y Contenido Sanitario
Objetivo: Analizar estructura actual y proponer reestructuración coherente como manual profesional


1 Análisis de la Estructura Actual

Organización Actual

Estructura física:

  • 94 archivos Markdown organizados en 17 bloques (carpetas)
  • Numeración de bloques: BLOQUE_0 a BLOQUE_15
  • Cada bloque contiene archivos con formato: BLOQUE_XX_Y_NOMBRE.md

Jerarquía actual:

public/manual/
├── BLOQUE_0_FUNDAMENTOS/ (1 archivo)
├── BLOQUE_1_PROCEDIMIENTOS_BASICOS/ (4 archivos)
├── BLOQUE_2_MATERIAL_E_INMOVILIZACION/ (15 archivos)
├── BLOQUE_3_MATERIAL_SANITARIO_Y_OXIGENOTERAPIA/ (30 archivos)
├── BLOQUE_4_SOPORTE_VITAL_BASICO_Y_RCP/ (11 archivos)
├── BLOQUE_5_PROTOCOLOS_TRANSTELEFONICOS/ (10 archivos)
├── BLOQUE_6_FARMACOLOGIA/ (8 archivos)
├── BLOQUE_7_CONDUCCION_Y_SEGURIDAD_VIAL/ (6 archivos)
├── BLOQUE_8_GESTION_OPERATIVA/ (vacío)
├── BLOQUE_8_GESTION_OPERATIVA_Y_DOCUMENTACION/ (5 archivos) ⚠️ DUPLICADO
├── BLOQUE_9_MEDICINA_EMERGENCIAS_APLICADA/ (1 archivo)
├── BLOQUE_10_SITUACIONES_ESPECIALES/ (1 archivo)
├── BLOQUE_11_PROTOCOLOS_TRAUMA/ (1 archivo)
├── BLOQUE_12_MARCO_LEGAL_ETICO_PROFESIONAL/ (1 archivo)
├── BLOQUE_13_COMUNICACION_RELACION_PACIENTE/ (1 archivo)
├── BLOQUE_14_SEGURIDAD_PERSONAL_SALUD_TES/ (1 archivo)
└── BLOQUE_15_ALTERACIONES_PSIQUIATRICAS_Y_CONTENCION/ (1 archivo)

Criterios Aparentes de Organización

Análisis de criterios utilizados:

  1. Criterio Temático (Principal)

    • Bloques organizados por temas: Fundamentos, Material, RCP, Farmacología, etc.
    • Ventaja: Agrupación lógica por área de conocimiento
    • Problema: No hay criterio claro de orden entre bloques
  2. Criterio Funcional (Secundario)

    • Algunos bloques agrupan por función: "Procedimientos Básicos", "Gestión Operativa"
    • Ventaja: Agrupa acciones relacionadas
    • Problema: Mezcla con criterio temático crea confusión
  3. Criterio Cronológico (Implícito)

    • Orden aparente: Fundamentos → Procedimientos → Material → RCP
    • Ventaja: Sigue flujo de aprendizaje básico
    • Problema: No es consistente (Bloque 9 "Medicina Emergencias" aparece después de RCP)
  4. Criterio Mixto (Actual)

    • Combinación de temático, funcional y cronológico sin reglas claras
    • Problema: Falta de coherencia estructural

Tipos de Contenido que Conviven

Análisis de contenido por bloque:

  1. Contenido Operativo Puro

    • Pasos numerados de procedimientos
    • Checklists operativos
    • Protocolos de acción inmediata
    • Ejemplos: RCP Adultos, ABCDE Operativo, Constantes Vitales
  2. Contenido Formativo

    • Explicaciones conceptuales
    • Fundamentos teóricos
    • Contexto clínico
    • Ejemplos: Fundamentos de Emergencias, Marco Legal
  3. Contenido Mixto

    • Procedimientos con explicaciones extensas
    • Técnicas con fundamentos teóricos
    • Ejemplos: Oxigenoterapia (tiene técnica + fundamentos)
  4. Contenido de Referencia

    • Inventarios de material
    • Tablas de referencia
    • Glosarios
    • Ejemplos: Inventario Material Sanitario, Abreviaturas

Problema identificado: Estos tipos conviven en el mismo nivel jerárquico sin diferenciación clara.


2 Detección de Inconsistencias

Inconsistencias Estructurales Críticas

1. Duplicación de Carpetas

Problema:

  • BLOQUE_8_GESTION_OPERATIVA/ (vacía)
  • BLOQUE_8_GESTION_OPERATIVA_Y_DOCUMENTACION/ (5 archivos)

Impacto: Confusión sobre qué carpeta usar, posible pérdida de contenido

Solución propuesta: Fusionar en una sola carpeta BLOQUE_8_GESTION_OPERATIVA_Y_DOCUMENTACION


2. Contenido Duplicado

Ejemplos identificados:

a) Cánulas Orofaringeas:

  • BLOQUE_03_2B_CANULA_OROFARINGEA.md (capítulo específico)
  • BLOQUE_03_4_CANULAS.md (capítulo general que incluye OPA y NPA)

Problema: Información sobre OPA aparece en dos lugares con posible inconsistencia

Solución propuesta:

  • Mantener BLOQUE_03_4_CANULAS.md como capítulo principal
  • Eliminar BLOQUE_03_2B_CANULA_OROFARINGEA.md o convertirlo en referencia cruzada

b) Oxigenoterapia:

  • BLOQUE_03_0A_OXIGENOTERAPIA_BASICA.md
  • BLOQUE_03_0B_OXIGENOTERAPIA_FUNDAMENTOS.md

Problema: Dos capítulos "0" sobre el mismo tema con nombres similares

Solución propuesta: Fusionar o clarificar diferencia (uno operativo, otro formativo)


3. Niveles de Profundidad Desiguales

Análisis por bloque:

Bloque Archivos Profundidad Problema
BLOQUE_0 1 Superficial Solo introducción, falta desarrollo
BLOQUE_1 4 Medio Bien estructurado
BLOQUE_2 15 Profundo Muy detallado, bien organizado
BLOQUE_3 30 Muy profundo Excesivo, necesita subdivisión
BLOQUE_4 11 Profundo Bien estructurado
BLOQUE_5 10 Profundo Bien estructurado
BLOQUE_6 8 Medio Bien estructurado
BLOQUE_7 6 Medio Bien estructurado
BLOQUE_9-15 1 cada uno Superficial Solo introducciones, falta desarrollo

Problema:

  • BLOQUE_3 tiene 30 archivos (demasiado extenso)
  • Bloques 9-15 tienen solo 1 archivo cada uno (demasiado superficial)
  • No hay equilibrio en profundidad

Solución propuesta:

  • Subdividir BLOQUE_3 en sub-bloques temáticos
  • Desarrollar bloques 9-15 o fusionarlos con bloques relacionados

4. Mezcla de Contenido Operativo y Formativo

Ejemplos identificados:

BLOQUE_3 (Material Sanitario):

  • BLOQUE_03_0A_OXIGENOTERAPIA_BASICA.md → Operativo
  • BLOQUE_03_0B_OXIGENOTERAPIA_FUNDAMENTOS.md → Formativo
  • BLOQUE_03_1_DISPOSITIVOS_OXIGENOTERAPIA.md → Operativo
  • BLOQUE_03_99_CIERRE_BLOQUE_3.md → Formativo/Metadatos

Problema: Mismo nivel jerárquico para contenido operativo y formativo

Solución propuesta: Separar en sub-bloques o etiquetar claramente


5. Títulos Poco Homogéneos

Análisis de patrones de títulos:

Patrón 1: # X.Y Título Descriptivo

  • Ejemplo: # 3.11 Glucómetro y Control de Glucemia: Uso Operativo (Tes)
  • Uso: Mayoría de archivos en BLOQUE_3

Patrón 2: # X.Y Título Simple

  • Ejemplo: # 3.0 Oxigenoterapia Básica
  • Uso: Algunos archivos en BLOQUE_3

Patrón 3: # X.0 Título con Subtítulo

  • Ejemplo: # 0.0 Fundamentos de la Atención en Emergencias Prehospitalarias
  • Uso: BLOQUE_0

Patrón 4: # X.Y Título con Especificación

  • Ejemplo: # 1.1 Constantes Vitales: Toma y Registro Operativo
  • Uso: BLOQUE_1

Problemas identificados:

  • Inconsistencia en uso de dos puntos (:) después del título
  • Inconsistencia en especificación de "(Tes)" o "(Operativo Tes)"
  • Inconsistencia en uso de mayúsculas/minúsculas
  • Algunos títulos muy largos, otros muy cortos

Solución propuesta: Establecer reglas editoriales claras para títulos


6. Saltos Lógicos en Progresión

Ejemplos identificados:

a) Numeración de capítulos en índice:

2.1.1 → 2.1.10 → 2.1.11 → 2.1.2 → 2.1.3 → ...

Problema: Orden lógico roto (10 y 11 aparecen antes de 2 y 3)

b) Orden de bloques:

  • BLOQUE_4 (RCP) aparece antes de BLOQUE_9 (Medicina Emergencias)
  • BLOQUE_9 debería ser contexto previo a protocolos específicos

Problema: Falta progresión lógica de lo general a lo específico

c) Archivos con sufijos especiales:

  • BLOQUE_04_0_ACCESO_VASCULAR_BASICO.md (0)
  • BLOQUE_04_0B_RECONOCIMIENTO_PCR.md (0B)
  • BLOQUE_03_X_INVENTARIO_MATERIAL_SANITARIO.md (X)
  • BLOQUE_03_X2_MALETIN_CURAS.md (X2)
  • BLOQUE_03_99_CIERRE_BLOQUE_3.md (99)

Problema: Sistema de numeración inconsistente:

  • 0 = Introducción
  • 0B = Introducción alternativa (?)
  • X = Anexo/Inventario
  • X2, X3, X4, X5 = Anexos numerados
  • 99 = Cierre

Solución propuesta: Establecer sistema de numeración claro y consistente


3 Identificación de Módulos y Bloques Reales

Clasificación Propuesta

MÓDULO 1: FUNDAMENTOS Y EVALUACIÓN INICIAL

Propósito: Establecer base conceptual y evaluativa

Bloques identificados:

Bloque 1.1: Fundamentos Conceptuales

  • Contenido actual: BLOQUE_00_0_FUNDAMENTOS_EMERGENCIAS.md
  • Tipo: Formativo
  • Profundidad: Necesita desarrollo (actualmente superficial)

Bloque 1.2: Evaluación Primaria del Paciente

  • Contenido actual: BLOQUE_1_PROCEDIMIENTOS_BASICOS/
    • Constantes Vitales
    • ABCDE Operativo
    • Glasgow Operativo
    • Triage START
  • Tipo: Operativo
  • Profundidad: Adecuada

Bloque 1.3: Seguridad en Escena

  • Contenido actual: Disperso en varios bloques
  • Tipo: Operativo
  • Profundidad: Necesita consolidación

MÓDULO 2: SOPORTE VITAL Y PROCEDIMIENTOS CRÍTICOS

Propósito: Protocolos de actuación inmediata en situaciones críticas

Bloques identificados:

Bloque 2.1: Soporte Vital Básico (SVB)

  • Contenido actual: BLOQUE_4_SOPORTE_VITAL_BASICO_Y_RCP/
    • RCP Adultos, Pediatría, Lactantes
    • OVACE Adultos, Pediatría, Lactantes
    • Uso DESA
    • Posición Lateral de Seguridad
  • Tipo: Operativo
  • Profundidad: Adecuada

Bloque 2.2: Protocolos Transtelefónicos

  • Contenido actual: BLOQUE_5_PROTOCOLOS_TRANSTELEFONICOS/
  • Tipo: Operativo
  • Profundidad: Adecuada

Bloque 2.3: Protocolos de Trauma

  • Contenido actual: BLOQUE_11_PROTOCOLOS_TRAUMA.md (superficial)
  • Tipo: Operativo
  • Profundidad: Necesita desarrollo

MÓDULO 3: MATERIAL Y EQUIPAMIENTO

Propósito: Uso operativo de material sanitario y de inmovilización

Bloques identificados:

Bloque 3.1: Material de Inmovilización

  • Contenido actual: BLOQUE_2_MATERIAL_E_INMOVILIZACION/
  • Tipo: Operativo
  • Profundidad: Adecuada

Bloque 3.2: Material Sanitario Básico

  • Contenido actual: BLOQUE_3_MATERIAL_SANITARIO_Y_OXIGENOTERAPIA/ (parcial)
    • Sub-bloque 3.2.1: Oxigenoterapia
    • Sub-bloque 3.2.2: Vía Aérea Básica (Cánulas, BVM, Aspiración)
    • Sub-bloque 3.2.3: Monitorización (Glucometro, Termometría, Monitorización Básica)
    • Sub-bloque 3.2.4: Cuidados Básicos (Heridas, Quemaduras, Aislamiento Térmico)
    • Sub-bloque 3.2.5: Gestión de Material (Inventarios, Checklists, Organización)
  • Tipo: Operativo
  • Profundidad: Necesita subdivisión (actualmente 30 archivos)

Bloque 3.3: Inventarios y Checklists

  • Contenido actual: Archivos con sufijo _X_ en varios bloques
  • Tipo: Referencia
  • Profundidad: Consolidar en un solo bloque

MÓDULO 4: FARMACOLOGÍA Y MEDICACIÓN

Propósito: Administración segura de fármacos en emergencias

Bloques identificados:

Bloque 4.1: Vademécum Operativo

  • Contenido actual: BLOQUE_6_FARMACOLOGIA/
  • Tipo: Operativo/Referencia
  • Profundidad: Adecuada

Bloque 4.2: Principios de Administración

  • Contenido actual: BLOQUE_06_0_PRINCIPIOS_ADMINISTRACION_FARMACOS.md
  • Tipo: Formativo/Operativo
  • Profundidad: Adecuada

MÓDULO 5: MEDICINA DE EMERGENCIAS APLICADA

Propósito: Contexto clínico y manejo de patologías específicas

Bloques identificados:

Bloque 5.1: Patologías por Sistemas

  • Contenido actual: BLOQUE_9_MEDICINA_EMERGENCIAS_APLICADA.md (superficial)
  • Tipo: Formativo/Mixto
  • Profundidad: Necesita desarrollo

Bloque 5.2: Situaciones Especiales

  • Contenido actual: BLOQUE_10_SITUACIONES_ESPECIALES.md (superficial)
  • Tipo: Formativo/Mixto
  • Profundidad: Necesita desarrollo

Bloque 5.3: Alteraciones Psiquiátricas

  • Contenido actual: BLOQUE_15_ALTERACIONES_PSIQUIATRICAS_Y_CONTENCION.md (superficial)
  • Tipo: Operativo/Formativo
  • Profundidad: Necesita desarrollo

MÓDULO 6: GESTIÓN OPERATIVA Y PROFESIONAL

Propósito: Aspectos organizativos, legales y profesionales

Bloques identificados:

Bloque 6.1: Gestión Operativa

  • Contenido actual: BLOQUE_8_GESTION_OPERATIVA_Y_DOCUMENTACION/
  • Tipo: Operativo/Formativo
  • Profundidad: Adecuada

Bloque 6.2: Comunicación y Relación con Paciente

  • Contenido actual: BLOQUE_13_COMUNICACION_RELACION_PACIENTE.md (superficial)
  • Tipo: Formativo
  • Profundidad: Necesita desarrollo

Bloque 6.3: Marco Legal y Ético

  • Contenido actual: BLOQUE_12_MARCO_LEGAL_ETICO_PROFESIONAL.md (superficial)
  • Tipo: Formativo/Referencia
  • Profundidad: Necesita desarrollo

Bloque 6.4: Seguridad Personal y Salud del TES

  • Contenido actual: BLOQUE_14_SEGURIDAD_PERSONAL_SALUD_TES.md (superficial)
  • Tipo: Formativo/Operativo
  • Profundidad: Necesita desarrollo

Bloque 6.5: Conducción y Seguridad Vial

  • Contenido actual: BLOQUE_7_CONDUCCION_Y_SEGURIDAD_VIAL/
  • Tipo: Formativo/Operativo
  • Profundidad: Adecuada

Mapeo de Contenido Actual → Nueva Estructura

Contenido Actual Módulo Propuesto Bloque Propuesto Acción
BLOQUE_0 Módulo 1 Bloque 1.1 Mantener, desarrollar
BLOQUE_1 Módulo 1 Bloque 1.2 Mantener
BLOQUE_2 Módulo 3 Bloque 3.1 Mantener
BLOQUE_3 Módulo 3 Bloque 3.2 Subdividir en 5 sub-bloques
BLOQUE_4 Módulo 2 Bloque 2.1 Mantener
BLOQUE_5 Módulo 2 Bloque 2.2 Mantener
BLOQUE_6 Módulo 4 Bloque 4.1 Mantener
BLOQUE_7 Módulo 6 Bloque 6.5 Mantener
BLOQUE_8 (duplicado) Módulo 6 Bloque 6.1 Fusionar
BLOQUE_9 Módulo 5 Bloque 5.1 Desarrollar
BLOQUE_10 Módulo 5 Bloque 5.2 Desarrollar
BLOQUE_11 Módulo 2 Bloque 2.3 Desarrollar
BLOQUE_12 Módulo 6 Bloque 6.3 Desarrollar
BLOQUE_13 Módulo 6 Bloque 6.2 Desarrollar
BLOQUE_14 Módulo 6 Bloque 6.4 Desarrollar
BLOQUE_15 Módulo 5 Bloque 5.3 Desarrollar

4 Reestructuración como Documento Formal

Índice General Propuesto

MANUAL TES DIGITAL - GUÍA OPERATIVA Y FORMATIVA
Versión 2.0 - Estructura Reorganizada

═══════════════════════════════════════════════════════════════

PARTE I: FUNDAMENTOS Y EVALUACIÓN INICIAL
─────────────────────────────────────────

Módulo 1: Fundamentos y Evaluación Inicial
├── Capítulo 1.1: Fundamentos de Emergencias Prehospitalarias
│   ├── 1.1.1 Introducción y Marco Conceptual
│   ├── 1.1.2 Principios del Soporte Vital
│   ├── 1.1.3 Cadena de Supervivencia
│   └── 1.1.4 Rol y Alcance del TES
│
├── Capítulo 1.2: Evaluación Primaria del Paciente
│   ├── 1.2.1 Constantes Vitales: Toma y Registro Operativo
│   ├── 1.2.2 Evaluación Primaria ABCDE Operativo
│   ├── 1.2.3 Escala de Coma de Glasgow Operativo
│   └── 1.2.4 Triage START Operativo
│
└── Capítulo 1.3: Seguridad en Escena
    ├── 1.3.1 Evaluación de Seguridad de Escena
    ├── 1.3.2 Bioseguridad y EPI
    └── 1.3.3 Señalización y Seguridad Operativa

═══════════════════════════════════════════════════════════════

PARTE II: SOPORTE VITAL Y PROCEDIMIENTOS CRÍTICOS
──────────────────────────────────────────────────

Módulo 2: Soporte Vital y Procedimientos Críticos
├── Capítulo 2.1: Soporte Vital Básico (SVB)
│   ├── 2.1.1 Reconocimiento de Parada Cardiorrespiratoria
│   ├── 2.1.2 RCP Adulto SVB
│   ├── 2.1.3 RCP Pediátrico SVB
│   ├── 2.1.4 RCP Lactantes SVB
│   ├── 2.1.5 RCP con Dos Intervinientes
│   ├── 2.1.6 Uso del Desfibrilador Externo Automático (DEA)
│   ├── 2.1.7 OVACE Adultos
│   ├── 2.1.8 OVACE Pediátrico
│   ├── 2.1.9 OVACE Lactantes
│   └── 2.1.10 Posición Lateral de Seguridad
│
├── Capítulo 2.2: Protocolos Transtelefónicos
│   ├── 2.2.1 Introducción a Protocolos Transtelefónicos
│   ├── 2.2.2 PCR Transtelefónica
│   ├── 2.2.3 OVACE Transtelefónica
│   ├── 2.2.4 SCA Transtelefónico
│   ├── 2.2.5 Ictus Transtelefónico
│   ├── 2.2.6 Anafilaxia Transtelefónica
│   ├── 2.2.7 Crisis Asmática Transtelefónica
│   └── 2.2.8 Hipoglucemia Transtelefónica
│
└── Capítulo 2.3: Protocolos de Trauma
    ├── 2.3.1 Evaluación Primaria en Trauma
    ├── 2.3.2 Manejo de Hemorragias Masivas
    ├── 2.3.3 Shock Hemorrágico
    └── 2.3.4 Trauma Pediátrico

═══════════════════════════════════════════════════════════════

PARTE III: MATERIAL Y EQUIPAMIENTO
───────────────────────────────────

Módulo 3: Material y Equipamiento
├── Capítulo 3.1: Material de Inmovilización
│   ├── 3.1.1 Anatomía Operativa para Inmovilización
│   ├── 3.1.2 Inmovilización Manual
│   ├── 3.1.3 Collarín Cervical
│   ├── 3.1.4 Camilla Cuchara
│   ├── 3.1.5 Tablero Espinal
│   ├── 3.1.6 Colchón de Vacío
│   ├── 3.1.7 Extricación y Movimientos de Bloqueo
│   ├── 3.1.8 Transferencias y Movilización
│   ├── 3.1.9 Férulas
│   ├── 3.1.10 Cinturón Pélvico
│   ├── 3.1.11 Férula de Tracción
│   └── 3.1.12 Camillas y Sillas de Evacuación
│
├── Capítulo 3.2: Material Sanitario Básico
│   ├── 3.2.1 Oxigenoterapia Básica
│   │   ├── 3.2.1.1 Fundamentos de Oxigenoterapia
│   │   ├── 3.2.1.2 Dispositivos de Oxigenoterapia
│   │   └── 3.2.1.3 Seguridad en Oxigenoterapia
│   │
│   ├── 3.2.2 Vía Aérea Básica
│   │   ├── 3.2.2.1 Cánulas Orofaringeas (OPA)
│   │   ├── 3.2.2.2 Cánulas Nasofaringeas (NPA)
│   │   ├── 3.2.2.3 Ventilación con Bolsa-Mascarilla (BVM)
│   │   └── 3.2.2.4 Aspiración de Vía Aérea
│   │
│   ├── 3.2.3 Monitorización Básica
│   │   ├── 3.2.3.1 Monitorización de Constantes Vitales
│   │   ├── 3.2.3.2 Glucómetro y Control de Glucemia
│   │   └── 3.2.3.3 Termometría
│   │
│   ├── 3.2.4 Cuidados Básicos
│   │   ├── 3.2.4.1 Control de Hemorragias
│   │   ├── 3.2.4.2 Heridas y Vendajes
│   │   ├── 3.2.4.3 Quemaduras
│   │   └── 3.2.4.4 Exposición y Aislamiento Térmico
│   │
│   └── 3.2.5 Gestión de Material
│       ├── 3.2.5.1 Organización del Maletín
│       ├── 3.2.5.2 Gestión de Material en Escena
│       └── 3.2.5.3 Bioseguridad y Descontaminación
│
└── Capítulo 3.3: Inventarios y Checklists
    ├── 3.3.1 Inventario de Material de Inmovilización
    ├── 3.3.2 Inventario de Material Sanitario
    ├── 3.3.3 Checklist Maestro de Material
    └── 3.3.4 Documentación Operativa de Material

═══════════════════════════════════════════════════════════════

PARTE IV: FARMACOLOGÍA Y MEDICACIÓN
─────────────────────────────────────

Módulo 4: Farmacología y Medicación
├── Capítulo 4.1: Principios de Administración de Fármacos
│   ├── 4.1.1 Principios Generales
│   ├── 4.1.2 Vías de Administración
│   └── 4.1.3 Seguridad en Administración
│
└── Capítulo 4.2: Vademécum Operativo
    ├── 4.2.1 Oxígeno
    ├── 4.2.2 Adrenalina
    ├── 4.2.3 Amiodarona
    ├── 4.2.4 Atropina
    ├── 4.2.5 Midazolam
    ├── 4.2.6 Salbutamol
    ├── 4.2.7 Aspirina
    ├── 4.2.8 Glucagón
    └── 4.2.9 Abreviaturas y Terminología Farmacológica

═══════════════════════════════════════════════════════════════

PARTE V: MEDICINA DE EMERGENCIAS APLICADA
──────────────────────────────────────────

Módulo 5: Medicina de Emergencias Aplicada
├── Capítulo 5.1: Patologías por Sistemas
│   ├── 5.1.1 Patologías Respiratorias
│   ├── 5.1.2 Patologías Cardiovasculares
│   ├── 5.1.3 Patologías Neurológicas
│   ├── 5.1.4 Patologías Endocrinas
│   └── 5.1.5 Intoxicaciones
│
├── Capítulo 5.2: Situaciones Especiales
│   ├── 5.2.1 Emergencias Obstétricas
│   ├── 5.2.2 Emergencias Pediátricas Específicas
│   ├── 5.2.3 Emergencias Geriátricas
│   └── 5.2.4 Catástrofes y Múltiples Víctimas
│
└── Capítulo 5.3: Alteraciones Psiquiátricas y Contención
    ├── 5.3.1 Evaluación de Paciente Psiquiátrico
    ├── 5.3.2 Técnicas de Contención Verbal
    └── 5.3.3 Contención Física (si aplica según protocolo)

═══════════════════════════════════════════════════════════════

PARTE VI: GESTIÓN OPERATIVA Y PROFESIONAL
──────────────────────────────────────────

Módulo 6: Gestión Operativa y Profesional
├── Capítulo 6.1: Gestión Operativa
│   ├── 6.1.1 Introducción a Gestión Operativa
│   ├── 6.1.2 Documentación Clínica Prehospitalaria
│   ├── 6.1.3 Coordinación y Comunicación Operativa
│   ├── 6.1.4 Gestión de Recursos y Material
│   └── 6.1.5 Calidad y Mejora Continua
│
├── Capítulo 6.2: Comunicación y Relación con Paciente
│   ├── 6.2.1 Principios de Comunicación en Emergencias
│   ├── 6.2.2 Comunicación con Paciente
│   ├── 6.2.3 Comunicación con Familiares
│   └── 6.2.4 Comunicación con Coordinador
│
├── Capítulo 6.3: Marco Legal y Ético
│   ├── 6.3.1 Marco Legal del TES
│   ├── 6.3.2 Aspectos Éticos en Emergencias
│   └── 6.3.3 Responsabilidad Profesional
│
├── Capítulo 6.4: Seguridad Personal y Salud del TES
│   ├── 6.4.1 Prevención de Riesgos Laborales
│   ├── 6.4.2 Gestión del Estrés
│   └── 6.4.3 Salud y Bienestar del Profesional
│
└── Capítulo 6.5: Conducción y Seguridad Vial
    ├── 6.5.1 Fundamentos de Conducción en Urgencias
    ├── 6.5.2 Uso de Luces y Sirena
    ├── 6.5.3 Técnicas de Conducción en Emergencias
    ├── 6.5.4 Seguridad Vial y Prevención de Accidentes
    ├── 6.5.5 Gestión de Rutas y Navegación
    └── 6.5.6 Protocolos de Seguridad en Escena

═══════════════════════════════════════════════════════════════

ANEXOS
──────

Anexo A: Glosario de Términos
Anexo B: Abreviaturas Comunes
Anexo C: Tablas de Referencia
Anexo D: Índice Alfabético

Criterios de Orden Propuestos

Principio 1: De lo General a lo Específico

  • Fundamentos → Procedimientos → Material específico → Patologías específicas

Principio 2: De lo Crítico a lo Avanzado

  • Soporte Vital Básico → Protocolos Transtelefónicos → Medicina Aplicada

Principio 3: De lo Operativo a lo Formativo

  • Procedimientos operativos primero → Contexto formativo después

Principio 4: Flujo Lógico de Aprendizaje

  • Evaluación → Actuación → Material → Farmacología → Contexto Clínico → Gestión

5 Separación Conceptual de Tipos de Contenido

Clasificación Propuesta

Contenido Operativo Puro

Características:

  • Pasos numerados claros
  • Checklists operativos
  • Valores exactos (dosis, frecuencias, profundidades)
  • Advertencias críticas destacadas
  • Sin explicaciones extensas

Ejemplos:

  • RCP Adulto SVB
  • ABCDE Operativo
  • Constantes Vitales
  • Uso DESA

Etiquetado propuesto: [OPERATIVO]

Capa en app: Capa operativa principal (acceso rápido)


Contenido Formativo

Características:

  • Explicaciones conceptuales
  • Fundamentos teóricos
  • Contexto clínico
  • Sin pasos operativos
  • Narrativa extensa

Ejemplos:

  • Fundamentos de Emergencias
  • Marco Legal y Ético
  • Principios de Comunicación

Etiquetado propuesto: [FORMATIVO]

Capa en app: Guía de Refuerzo (acceso formativo)


Contenido Mixto

Características:

  • Procedimientos con explicaciones
  • Técnicas con fundamentos teóricos
  • Contexto + acción

Ejemplos:

  • Oxigenoterapia (técnica + fundamentos)
  • Protocolos Transtelefónicos (procedimiento + comunicación)
  • Gestión Operativa (procedimientos + contexto organizativo)

Etiquetado propuesto: [MIXTO]

Capa en app:

  • Parte operativa → Capa operativa
  • Parte formativa → Guía de Refuerzo
  • Enlaces bidireccionales

Contenido de Referencia

Características:

  • Tablas de datos
  • Inventarios
  • Glosarios
  • Checklists de verificación
  • Sin narrativa extensa

Ejemplos:

  • Inventario de Material
  • Vademécum (valores exactos)
  • Abreviaturas
  • Checklists Maestros

Etiquetado propuesto: [REFERENCIA]

Capa en app: Capa operativa (acceso rápido) o Anexos


Recomendaciones de Etiquetado

Sistema de etiquetas propuesto:

---
tipoContenido: "operativo" | "formativo" | "mixto" | "referencia"
capaApp: "operativa" | "refuerzo" | "ambas" | "anexos"
prioridad: "critica" | "alta" | "media" | "baja"
nivelDificultad: "basico" | "intermedio" | "avanzado"
---

Ejemplo de uso:

---
tipoContenido: "operativo"
capaApp: "operativa"
prioridad: "critica"
nivelDificultad: "basico"
---

# 2.1.2  RCP Adulto SVB

6 Reglas Editoriales y de Coherencia

Reglas de Nomenclatura de Capítulos

Formato de Título Principal

Regla 1: Estructura

# X.Y  Título Descriptivo: Subtítulo Opcional (Especificación Opcional)

Componentes:

  • X.Y = Número de módulo y capítulo (obligatorio)
  • Título Descriptivo = Nombre principal (obligatorio)
  • : Subtítulo = Especificación adicional (opcional)
  • (Especificación) = Aclaración de tipo o alcance (opcional)

Ejemplos correctos:

# 2.1.2  RCP Adulto SVB
# 3.2.1.1  Fundamentos de Oxigenoterapia
# 1.2.1  Constantes Vitales: Toma y Registro Operativo
# 4.2.1  Oxígeno (Vademécum Operativo)

Ejemplos incorrectos:

# RCP Adulto  ← Falta numeración
# 2.1.2 RCP Adulto SVB  ← Falta guión después de numeración
# 2.1.2  RCP Adulto SVB:  ← Dos puntos sin subtítulo

Regla 2: Uso de Especificaciones

Especificaciones permitidas:

  • (Operativo) → Contenido operativo puro
  • (Formativo) → Contenido formativo puro
  • (Vademécum Operativo) → Referencia farmacológica
  • (Checklist) → Lista de verificación
  • (Inventario) → Lista de material

No usar:

  • (Tes) → Redundante (todo el manual es para TES)
  • (Operativo Tes) → Redundante
  • Especificaciones inconsistentes

Regla 3: Consistencia en Subtítulos

Patrón recomendado:

  • Si el capítulo es operativo: : Técnica Operativa o : Procedimiento Operativo
  • Si el capítulo es formativo: : Fundamentos o : Marco Conceptual
  • Si el capítulo es mixto: Sin subtítulo o : Guía Completa

Ejemplos:

# 1.2.1  Constantes Vitales: Toma y Registro Operativo
# 1.1.1  Fundamentos de Emergencias: Marco Conceptual
# 3.2.1  Oxigenoterapia Básica: Guía Completa

Reglas de Longitud y Profundidad

Por Tipo de Contenido

Contenido Operativo:

  • Longitud: 300-800 palabras
  • Profundidad: Pasos claros, sin explicaciones extensas
  • Estructura: Objetivo → Alcance → Pasos → Advertencias → Puntos Clave

Contenido Formativo:

  • Longitud: 800-2000 palabras
  • Profundidad: Explicaciones extensas, contexto completo
  • Estructura: Introducción → Desarrollo → Conclusiones → Referencias

Contenido Mixto:

  • Longitud: 1000-2500 palabras
  • Profundidad: Equilibrio entre explicación y procedimiento
  • Estructura: Introducción → Fundamentos → Procedimiento → Contexto → Referencias

Contenido de Referencia:

  • Longitud: Variable (tablas, listas)
  • Profundidad: Datos organizados, sin narrativa
  • Estructura: Tabla/Lista → Descripción breve → Uso

Por Nivel Jerárquico

Capítulo Principal (X.Y):

  • Longitud: 1000-2500 palabras
  • Subcapítulos: 3-8 subcapítulos

Subcapítulo (X.Y.Z):

  • Longitud: 500-1500 palabras
  • Subsecciones: 2-5 subsecciones

Subsección (X.Y.Z.W):

  • Longitud: 200-800 palabras
  • Sin subsecciones adicionales

Reglas de Uso de Elementos

Listas

Listas numeradas (pasos operativos):

1. Primer paso
2. Segundo paso
3. Tercer paso

Listas con viñetas (características, items):

- Característica 1
- Característica 2
- Característica 3

Listas anidadas (sub-pasos):

1. Paso principal
   - Sub-paso a
   - Sub-paso b
2. Siguiente paso principal

Regla: Usar listas numeradas solo para pasos secuenciales. Usar viñetas para listas no secuenciales.


Tablas

Formato estándar:

| Columna 1 | Columna 2 | Columna 3 |
|-----------|-----------|----------|
| Dato 1    | Dato 2    | Dato 3   |
| Dato 4    | Dato 5    | Dato 6   |

Uso recomendado:

  • Valores de referencia (dosis, frecuencias)
  • Comparaciones sistemáticas
  • Clasificaciones
  • Inventarios estructurados

Regla: Todas las tablas deben tener encabezados claros y alineación consistente.


Imágenes

Formato de referencia:

![Descripción de la imagen](/ruta/a/imagen.png)

Reglas:

  • Todas las imágenes deben tener texto alternativo descriptivo
  • Usar sistema de alias cuando aplique (![alias-imagen])
  • Incluir caption cuando sea necesario
  • Organizar en carpetas por bloque temático

Ubicación:

  • Imágenes operativas: public/assets/infografias/bloque-X-nombre/
  • Diagramas: public/assets/diagramas/

Cajas de Advertencia

Formato estándar:

> ⚠️ **ADVERTENCIA:** Texto de advertencia crítica

Tipos:

  • ⚠️ ADVERTENCIA → Información crítica de seguridad
  • ✅ IMPORTANTE → Información importante a destacar
  • ❌ ERROR COMÚN → Errores frecuentes a evitar
  • 💡 CONSEJO → Consejos prácticos

Regla: Usar solo para información crítica. No abusar de cajas de advertencia.


Reglas de Consistencia entre Capítulos Similares

Estructura Estándar para Capítulos Operativos

Todos los capítulos operativos deben seguir:

# X.Y  Título: Subtítulo

## Objetivo Operativo
[1-2 párrafos describiendo el objetivo]

## Alcance y Límites
### Alcance del capítulo
[Qué cubre]

### Límites del capítulo
[Qué NO cubre]

## Material Necesario
[Lista de material requerido]

## Procedimiento Paso a Paso
1. Paso 1
2. Paso 2
...

## Advertencias Críticas
- Advertencia 1
- Advertencia 2

## Errores Frecuentes
- Error común 1
- Error común 2

## Puntos Clave TES
- Punto clave 1
- Punto clave 2

## Integración con Otros Protocolos
[Enlaces a protocolos relacionados]

Estructura Estándar para Capítulos Formativos

Todos los capítulos formativos deben seguir:

# X.Y  Título: Subtítulo

## Introducción
[Contexto y objetivos del capítulo]

## Desarrollo del Tema
### Subtema 1
[Desarrollo]

### Subtema 2
[Desarrollo]

## Conclusiones
[Resumen de puntos clave]

## Referencias
[Enlaces a guías oficiales, bibliografía]

Estructura Estándar para Capítulos Mixtos

Todos los capítulos mixtos deben seguir:

# X.Y  Título: Subtítulo

## Introducción
[Contexto]

## Fundamentos
[Explicación teórica]

## Procedimiento Operativo
[Pasos operativos]

## Contexto Clínico
[Cuándo y por qué usar]

## Referencias
[Enlaces relacionados]

Reglas de Navegación y Enlaces

Enlaces Internos

Formato:

[Texto del enlace](/manual/parte-X/modulo-Y/capitulo-Z)

Reglas:

  • Todos los capítulos deben tener enlaces a capítulos anteriores y siguientes
  • Enlaces relacionados deben ser relevantes (máximo 5)
  • Usar breadcrumbs en la aplicación

Referencias Cruzadas

Formato:

Ver también: [Capítulo relacionado](/ruta)

Reglas:

  • Referencias cruzadas solo cuando sea necesario para comprensión
  • No crear dependencias circulares
  • Agrupar referencias al final del capítulo

Resumen de Recomendaciones

Acciones Inmediatas

  1. Fusionar BLOQUE_8 duplicado

    • Eliminar BLOQUE_8_GESTION_OPERATIVA/ vacía
    • Mantener BLOQUE_8_GESTION_OPERATIVA_Y_DOCUMENTACION/
  2. Eliminar contenido duplicado

    • Fusionar BLOQUE_03_0A y BLOQUE_03_0B (oxigenoterapia)
    • Eliminar BLOQUE_03_2B_CANULA_OROFARINGEA.md o convertir en referencia cruzada
  3. Subdividir BLOQUE_3

    • Crear 5 sub-bloques temáticos dentro de Material Sanitario
    • Reorganizar 30 archivos en estructura lógica
  4. Desarrollar bloques superficiales

    • BLOQUE_9, BLOQUE_10, BLOQUE_11, BLOQUE_12, BLOQUE_13, BLOQUE_14, BLOQUE_15
    • O fusionarlos con bloques relacionados
  5. Estandarizar nomenclatura

    • Aplicar reglas editoriales a todos los títulos
    • Unificar formato de numeración

Acciones a Medio Plazo

  1. Reorganizar estructura física

    • Crear nueva estructura de carpetas según módulos propuestos
    • Migrar archivos manteniendo referencias
  2. Implementar sistema de etiquetado

    • Añadir metadatos YAML a todos los archivos
    • Actualizar sistema de navegación
  3. Crear índices automáticos

    • Generar índices desde estructura de archivos
    • Mantener sincronización con contenido

Conclusión

La guía actual tiene contenido valioso pero estructura inconsistente. La reestructuración propuesta:

  1. Elimina duplicaciones y confusiones
  2. Establece jerarquía clara (Parte → Módulo → Capítulo)
  3. Separa tipos de contenido (Operativo vs Formativo)
  4. Define reglas editoriales para coherencia
  5. Proporciona progresión lógica de aprendizaje

El resultado será un manual profesional coherente, navegable y escalable.


Fin del Análisis

Este documento sirve como base para la reorganización editorial de la guía, sin proponer código ni migraciones específicas aún.