450 lines
15 KiB
Markdown
450 lines
15 KiB
Markdown
# 📐 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.**
|
||
|