planetazuzu/codigo0
1
0
Fork 0
Code Issues Pull requests Actions 1 Packages Projects Releases Wiki Activity
codigo0/docs/MODELO_CANONICO_CONTENIDO_EMERGES_TES.md

15 KiB
Raw Blame History

📐 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.