codigo0/docs/MODELO_CANONICO_CONTENIDO_EMERGES_TES.md

# 📐 MODELO CANÓNICO DE CONTENIDO - EMERGES TES

**Versión:** 1.0  
**Fecha:** 2025-01-XX  
**Estado:** Documento Oficial - Contrato de Arquitectura  
**Autor:** Arquitecto de Software Senior + Arquitecto de Contenido + Diseñador Instruccional Sanitario

---

## 🎯 PROPÓSITO DEL DOCUMENTO

Este documento define **EL MODELO OFICIAL** de organización de contenido en EMERGES TES. Es el **contrato arquitectónico** que:

- ✅ Establece los 3 niveles canónicos del sistema
- ✅ Define reglas estrictas de separación y responsabilidad
- ✅ Mapea la estructura actual del proyecto
- ✅ Prohíbe violaciones de separación de niveles
- ✅ Garantiza escalabilidad institucional

**Este documento NO se modifica sin consenso arquitectónico.**

---

## 1️⃣ LOS 3 NIVELES CANÓNICOS DEL SISTEMA

### 🔴 NIVEL 1: OPERATIVO (Escena)

**Identidad:** "¿Qué hago ahora?"

**Propósito:**
- Respuesta inmediata en situación crítica
- Consulta rápida bajo estrés
- Acción sin reflexión profunda
- Uso con guantes, en movimiento, con ruido

**Características:**
- ✅ **Inmediato:** Acceso en <3 segundos
- ✅ **Visual:** Iconos, colores, números grandes
- ✅ **Táctil:** Botones grandes, checklist grandes
- ✅ **Minimalista:** Solo lo esencial
- ✅ **Offline-first:** Funciona sin red
- ✅ **Sin scroll:** Información visible sin desplazamiento

**Contenido permitido:**
- Protocolos paso a paso numerados
- Checklists interactivas
- Algoritmos visuales
- Dosis críticas (inline)
- Timers y contadores
- Escalas rápidas (Glasgow, Triage)
- Advertencias críticas (máx. 3-5)
- Material necesario (lista corta)

**Contenido PROHIBIDO:**
- ❌ Explicaciones fisiopatológicas
- ❌ Contexto histórico o académico
- ❌ Casos clínicos extensos
- ❌ Referencias bibliográficas
- ❌ Texto narrativo >2 líneas
- ❌ Contenido que requiera lectura profunda

**Ubicación actual:**
- `src/pages/RCP.tsx`, `Ictus.tsx`, `ViaAerea.tsx`, `Shock.tsx`
- `src/data/procedures.ts` (estructura de datos)
- Checklists hardcodeadas en componentes
- Dosis inline en protocolos

**Ejemplo canónico:**
```
RCP Adulto SVB:
1. Seguridad escena
2. Comprobar respuesta
3. Apertura vía aérea
4. Comprobar respiración (<10s)
5. Activación emergencias
6. Inicio compresiones
```

---

### 🟡 NIVEL 2: FORMATIVO (Aprendizaje)

**Identidad:** "¿Por qué se hace así?"

**Propósito:**
- Comprensión profunda de protocolos
- Formación reglada y no reglada
- Refuerzo de conocimientos
- Preparación para examen o certificación

**Características:**
- ✅ **Estructurado:** 8 secciones estándar
- ✅ **Multimedia:** Imágenes, diagramas, casos
- ✅ **Pedagógico:** Explicaciones, errores, simulaciones
- ✅ **Navegable:** Secciones, progreso, metadatos
- ✅ **SCORM-compatible:** Exportable a LMS
- ✅ **Offline-compatible:** Descargable y consultable offline

**Contenido permitido:**
- Explicación clínica y fisiopatología
- Algoritmos comentados visualmente
- Medios visuales y demostraciones
- Errores frecuentes visualizados
- Casos clínicos
- Simulación mental guiada
- Resumen visual y puente al operativo

**Contenido PROHIBIDO:**
- ❌ Pasos operativos exactos (referencia al Nivel 1)
- ❌ Valores numéricos precisos (referencia al Nivel 1)
- ❌ Secuencias operativas paso a paso
- ❌ Información crítica para escena (debe estar en Nivel 1)

**Ubicación actual:**
- `docs/consolidado/SECCION_XX_*.md` (80 archivos, 10 guías × 8 secciones)
- `src/data/guides-index.ts` (índice de guías)
- `src/views/formativo/` (visualizadores)
- `public/scorm/dist/*.zip` (paquetes SCORM)

**Estructura canónica (8 secciones):**
1. Introducción y Contexto
2. Explicación Clínica y Fisiopatología
3. Algoritmo Comentado Visual
4. Medios Visuales y Demostración
5. Errores Frecuentes Visualizados
6. Casos Clínicos
7. Simulación Mental Guiada
8. Resumen Visual y Puente al Operativo

---

### 🔵 NIVEL 3: REFERENCIA (Manual Completo)

**Identidad:** "Quiero todo el contexto"

**Propósito:**
- Manual profesional de referencia
- Documentación completa y exhaustiva
- Contexto legal, ético y profesional
- Fuente de verdad para validación

**Características:**
- ✅ **Exhaustivo:** Todo el conocimiento disponible
- ✅ **Estructurado:** 17 bloques temáticos
- ✅ **Navegable:** Índice jerárquico completo
- ✅ **Buscable:** Búsqueda full-text
- ✅ **Versionado:** Historial de cambios
- ✅ **Validado:** Fuentes clínicas oficiales

**Contenido permitido:**
- Manual completo (94 archivos Markdown)
- Farmacología extendida
- Marco legal y ético
- Fisiopatología detallada
- Documentación técnica
- Referencias bibliográficas
- Casos clínicos extensos
- Protocolos transtelefónicos completos

**Contenido PROHIBIDO:**
- ❌ Duplicación de contenido operativo (referencia al Nivel 1)
- ❌ Contenido formativo estructurado (referencia al Nivel 2)

**Ubicación actual:**
- `public/manual/BLOQUE_XX_*/` (94 archivos Markdown)
- `src/data/manual-index.ts` (índice jerárquico)
- `src/components/manual/` (visualizadores)

**Estructura canónica (17 bloques):**
- BLOQUE_0: Fundamentos
- BLOQUE_1: Procedimientos Básicos
- BLOQUE_2: Material e Inmovilización
- BLOQUE_3: Material Sanitario y Oxigenoterapia
- BLOQUE_4: Soporte Vital Básico y RCP
- BLOQUE_5: Protocolos Transtelefónicos
- BLOQUE_6: Farmacología
- BLOQUE_7: Conducción y Seguridad Vial
- BLOQUE_8: Gestión Operativa y Documentación
- BLOQUE_9: Medicina Emergencias Aplicada
- BLOQUE_10: Situaciones Especiales
- BLOQUE_11: Protocolos Trauma
- BLOQUE_12: Marco Legal Ético Profesional
- BLOQUE_13: Comunicación Relación Paciente
- BLOQUE_14: Seguridad Personal Salud TES
- BLOQUE_15: Alteraciones Psiquiátricas y Contención

---

## 2️⃣ REGLAS ESTRICTAS DE SEPARACIÓN

### Regla 1: Fuente de Verdad Única

**Cada tipo de información tiene UNA fuente de verdad:**

| Tipo de Información | Fuente de Verdad | Niveles que Referencian |
|---------------------|------------------|-------------------------|
| Pasos operativos exactos | Nivel 1 (Operativo) | Nivel 2, Nivel 3 |
| Valores numéricos precisos | Nivel 1 (Operativo) | Nivel 2, Nivel 3 |
| Explicación fisiopatológica | Nivel 2 (Formativo) | Nivel 3 |
| Contexto legal/ético | Nivel 3 (Referencia) | - |
| Casos clínicos extensos | Nivel 3 (Referencia) | Nivel 2 (resumen) |

**Violación:** ❌ Duplicar pasos operativos en Nivel 2 o Nivel 3  
**Correcto:** ✅ Nivel 2 y Nivel 3 referencian al Nivel 1

---

### Regla 2: Prohibición de Duplicación

**NUNCA duplicar contenido entre niveles:**

- ❌ **NO** copiar pasos de Nivel 1 en Nivel 2
- ❌ **NO** copiar explicaciones de Nivel 2 en Nivel 3
- ❌ **NO** duplicar dosis en múltiples niveles

**Correcto:**
- ✅ Nivel 2: "Ver protocolo operativo RCP Adulto SVB para pasos exactos"
- ✅ Nivel 3: "Consultar guía formativa RCP Adulto SVB para explicación fisiopatológica"

---

### Regla 3: Navegación Bidireccional

**Cada nivel debe poder navegar a los otros:**

- 🔴 Nivel 1 → 🟡 Nivel 2: "Ver Guía Formativa"
- 🔴 Nivel 1 → 🔵 Nivel 3: "Ver Manual Completo"
- 🟡 Nivel 2 → 🔴 Nivel 1: "Ir a Protocolo Operativo"
- 🟡 Nivel 2 → 🔵 Nivel 3: "Ver Manual Completo"
- 🔵 Nivel 3 → 🔴 Nivel 1: "Ver Protocolo Operativo"
- 🔵 Nivel 3 → 🟡 Nivel 2: "Ver Guía Formativa"

**Implementación actual:**
- `src/data/protocol-guide-manual-mapping.ts` (mapeo formal)

---

### Regla 4: Responsabilidad por Nivel

**Cada nivel es responsable de su propio contenido:**

| Nivel | Responsable | Proceso de Validación |
|-------|-------------|----------------------|
| 🔴 Operativo | Médico de emergencias + TES senior | Validación clínica crítica |
| 🟡 Formativo | Diseñador instruccional + Docente TES | Validación pedagógica |
| 🔵 Referencia | Médico especialista + Comité editorial | Validación exhaustiva |

**Violación:** ❌ Modificar Nivel 1 desde panel formativo  
**Correcto:** ✅ Panel formativo solo modifica Nivel 2

---

## 3️⃣ MAPEO REAL CON EL PROYECTO ACTUAL

### Mapeo Físico de Archivos

```
EMERGES TES/
├── 🔴 NIVEL 1: OPERATIVO
│   ├── src/pages/
│   │   ├── RCP.tsx              → Protocolo RCP (SVB, SVA, Pediátrico)
│   │   ├── Ictus.tsx            → Protocolo Ictus
│   │   ├── ViaAerea.tsx         → Protocolo OVACE
│   │   ├── Shock.tsx            → Protocolo Shock
│   │   └── ...
│   ├── src/data/
│   │   ├── procedures.ts        → Estructura de protocolos
│   │   ├── drugs.ts              → Vademécum (dosis críticas)
│   │   └── acronyms.ts          → Diccionario siglas
│   └── src/components/
│       ├── procedures/           → Componentes protocolos
│       └── tools/                → Calculadoras, timers
│
├── 🟡 NIVEL 2: FORMATIVO
│   ├── docs/consolidado/
│   │   ├── SECCION_01-08_*.md   → 80 archivos (10 guías × 8 secciones)
│   │   └── *.meta.json          → Metadatos SCORM
│   ├── src/data/
│   │   ├── guides-index.ts       → Índice de guías
│   │   └── protocol-guide-manual-mapping.ts → Mapeo relaciones
│   ├── src/views/formativo/      → Visualizadores guías
│   └── public/scorm/dist/        → Paquetes SCORM ZIP
│
└── 🔵 NIVEL 3: REFERENCIA
    ├── public/manual/
    │   └── BLOQUE_XX_*/          → 94 archivos Markdown
    ├── src/data/
    │   └── manual-index.ts        → Índice jerárquico manual
    └── src/components/manual/     → Visualizadores manual
```

---

### Mapeo Lógico de Contenido

| Contenido | Nivel Actual | Ubicación Física | Estado |
|-----------|--------------|------------------|--------|
| RCP Adulto SVB - Pasos | 🔴 Operativo | `src/pages/RCP.tsx` | ✅ Completo |
| RCP Adulto SVB - Checklist | 🔴 Operativo | `src/pages/RCP.tsx` | ✅ Completo |
| RCP Adulto SVB - Dosis | 🔴 Operativo | `src/pages/RCP.tsx` (inline) | ✅ Completo |
| RCP Adulto SVB - Explicación | 🟡 Formativo | `docs/consolidado/SECCION_*_RCP_ADULTO_SVB.md` | ✅ Completo |
| RCP Adulto SVB - Manual | 🔵 Referencia | `public/manual/BLOQUE_4_*/` | ✅ Completo |
| Ictus - Protocolo | 🔴 Operativo | `src/pages/Ictus.tsx` | ✅ Completo |
| Ictus - Checklist | 🔴 Operativo | `src/pages/Ictus.tsx` | ✅ Completo |
| Ictus - Manual | 🔵 Referencia | `public/manual/BLOQUE_5_*/` | ✅ Completo |
| OVACE - Protocolo | 🔴 Operativo | `src/pages/ViaAerea.tsx` | ✅ Completo |
| OVACE - Checklist | 🔴 Operativo | `src/pages/ViaAerea.tsx` | ✅ Completo |
| OVACE - Guía Formativa | 🟡 Formativo | `docs/consolidado/SECCION_*_OVACE_*.md` | ✅ Completo |
| Vademécum - Dosis | 🔴 Operativo | `src/data/drugs.ts` | ✅ Completo |
| Vademécum - Extendido | 🔵 Referencia | `public/manual/BLOQUE_6_*/` | ✅ Completo |

---

## 4️⃣ CASOS ESPECIALES Y EXCEPCIONES

### Caso 1: ABCDE Operativo

**Situación:** ABCDE está en Nivel 1 (Escena) pero también tiene guía formativa.

**Resolución:**
- 🔴 Nivel 1: ABCDE como protocolo operativo (`src/pages/Escena.tsx`)
- 🟡 Nivel 2: Guía formativa ABCDE (`docs/consolidado/SECCION_*_ABCDE_OPERATIVO.md`)
- 🔵 Nivel 3: Manual ABCDE (`public/manual/BLOQUE_1_*/`)

**Regla:** El mismo tema puede existir en los 3 niveles, pero con diferente granularidad.

---

### Caso 2: RCP SVA (Sin Guía Formativa)

**Situación:** RCP SVA tiene protocolo operativo y manual, pero NO tiene guía formativa.

**Resolución:**
- 🔴 Nivel 1: Protocolo RCP SVA (`src/pages/RCP.tsx`)
- 🟡 Nivel 2: ❌ No existe (gap identificado)
- 🔵 Nivel 3: Manual RCP SVA (`public/manual/BLOQUE_4_*/`)

**Regla:** No todos los protocolos deben tener los 3 niveles. Los gaps son aceptables si están documentados.

---

### Caso 3: Guías Sin Protocolo Operativo

**Situación:** Algunas guías formativas no tienen protocolo operativo directo (ej: RCP Lactantes, DESA).

**Resolución:**
- 🔴 Nivel 1: ❌ No existe protocolo operativo específico
- 🟡 Nivel 2: Guía formativa completa (`docs/consolidado/SECCION_*_*.md`)
- 🔵 Nivel 3: Manual completo (`public/manual/BLOQUE_4_*/`)

**Regla:** Las guías formativas pueden existir sin protocolo operativo si cubren contenido formativo puro.

---

## 5️⃣ PRINCIPIOS RECTORES

### Principio 1: "Un TES en escena no piensa"

**El Nivel 1 (Operativo) debe ser:**
- Accesible sin lectura profunda
- Visual y táctil
- Sin necesidad de contexto previo
- Funcional bajo estrés

---

### Principio 2: "Un docente necesita profundidad"

**El Nivel 2 (Formativo) debe ser:**
- Exhaustivo en explicaciones
- Pedagógicamente estructurado
- Con casos y ejemplos
- Exportable a sistemas LMS

---

### Principio 3: "Un sistema institucional necesita control"

**El Nivel 3 (Referencia) debe ser:**
- Validado y versionado
- Con fuentes oficiales
- Con control de calidad
- Con auditoría de cambios

---

## 6️⃣ VALIDACIÓN Y CUMPLIMIENTO

### Checklist de Validación

Para cada contenido nuevo, verificar:

- [ ] ¿Está en el nivel correcto según su propósito?
- [ ] ¿No duplica contenido de otro nivel?
- [ ] ¿Tiene navegación bidireccional a otros niveles?
- [ ] ¿Cumple las características del nivel?
- [ ] ¿No viola las prohibiciones del nivel?

---

### Proceso de Revisión

1. **Propuesta:** Documentar contenido nuevo con nivel propuesto
2. **Revisión:** Validar contra este modelo canónico
3. **Aprobación:** Confirmar nivel y ubicación
4. **Implementación:** Crear contenido según estructura del nivel
5. **Validación:** Verificar cumplimiento de reglas

---

## 7️⃣ EVOLUCIÓN DEL MODELO

### Versiones

- **v1.0 (2025-01-XX):** Modelo inicial canónico
- **Futuras:** Solo se modifica con consenso arquitectónico

### Cambios Permitidos

- ✅ Aclaraciones y ejemplos
- ✅ Nuevos casos especiales documentados
- ❌ Modificación de los 3 niveles canónicos
- ❌ Eliminación de reglas estrictas

---

## 📋 RESUMEN EJECUTIVO

**Los 3 niveles canónicos:**
1. 🔴 **Operativo:** "¿Qué hago ahora?" - Escena, inmediato, visual
2. 🟡 **Formativo:** "¿Por qué se hace así?" - Aprendizaje, estructurado, multimedia
3. 🔵 **Referencia:** "Quiero todo el contexto" - Manual, exhaustivo, validado

**Reglas absolutas:**
- Fuente de verdad única por tipo de información
- Prohibición de duplicación entre niveles
- Navegación bidireccional obligatoria
- Responsabilidad clara por nivel

**Estado actual:**
- ✅ Mapeo completo de estructura física
- ✅ Mapeo lógico de contenido existente
- ✅ Casos especiales documentados
- ✅ Gaps identificados y aceptables

---

**Este documento es el contrato arquitectónico oficial. Cualquier desviación debe ser justificada y documentada.**