codigo0/REPORTE_3_RECOMENDACIONES_APP.md
planetazuzu af02a569a2 feat: Aplicación completa Manual TES Digital
- Integración de 93 capítulos del manual completo
- Componente MarkdownViewer para renderizar archivos .md
- Navegación jerárquica completa (ManualIndex)
- Sistema de búsqueda mejorado
- Página ManualViewer con navegación anterior/siguiente
- Scripts de verificación del manual
- Puerto configurado en 8096
- Configuración de despliegue (Vercel, Netlify, GitHub Pages)
- Todos los problemas detectados corregidos
2025-12-17 12:12:10 +01:00

6.3 KiB

REPORTE 3: RECOMENDACIONES PARA ESTRUCTURA DE APP

Fecha: 2025-12-17 10:34:50


📱 ESTRUCTURA DE CARPETAS IDEAL PARA APP

Propuesta de Estructura:


app-manual-tes/

├── contenido/

│   ├── parte-i-fundamentos/

│   │   ├── bloque-0-fundamentos/

│   │   │   ├── 1.1.1-fundamentos-emergencias.md

│   │   │   └── metadata.json

│   │   └── bloque-1-procedimientos-basicos/

│   │       ├── 1.2.1-constantes-vitales.md

│   │       ├── 1.2.2-abcde-operativo.md

│   │       ├── 1.2.3-glasgow-operativo.md

│   │       ├── 1.2.4-triage-start.md

│   │       └── metadata.json

│   ├── parte-ii-soporte-vital/

│   │   ├── bloque-4-rcp/

│   │   └── bloque-9-medicina-emergencias/

│   ├── parte-iii-material/

│   │   ├── bloque-2-inmovilizacion/

│   │   └── bloque-3-oxigenoterapia/

│   ├── parte-iv-farmacologia/

│   │   └── bloque-6-farmacologia/

│   ├── parte-v-protocolos/

│   │   ├── bloque-5-transtelefonicos/

│   │   └── bloque-8-gestion/

│   ├── parte-vi-conduccion/

│   │   └── bloque-7-conduccion/

│   ├── parte-vii-situaciones-especiales/

│   │   ├── bloque-10-situaciones-especiales/

│   │   └── bloque-11-trauma/

│   └── parte-viii-habilidades/

│       ├── bloque-12-marco-legal/

│       ├── bloque-13-comunicacion/

│       └── bloque-14-seguridad/

├── assets/

│   ├── imagenes/

│   ├── videos/

│   └── iconos/

├── data/

│   ├── indice.json

│   └── metadata-global.json

└── public/

    └── (archivos estáticos)


📋 METADATOS NECESARIOS EN CADA .MD

Front Matter Propuesto (YAML):


---

id: '1.1.1'

titulo: 'Fundamentos de Emergencias'

subtitulo: 'Marco conceptual y operativo'

parte: 1

bloque: 0

bloque_nombre: 'Fundamentos de Emergencias Prehospitalarias'

parte_nombre: 'Fundamentos y Evaluación Inicial'

nivel_dificultad: 'basico'

importancia: 'alta'

palabras_clave:

  - 'emergencias'

  - 'soporte vital'

  - 'cadena supervivencia'

tipo_contenido: 'formativo'

tiempo_lectura: 15

version: '1.0'

fecha_actualizacion: '2024-12-13'

autor: 'Manual TES Digital'

navegacion:

  anterior: null

  siguiente: '1.2.1'

  relacionados:

    - '1.2.1'

    - '2.1.1'

---

Campos Explicados:

  • id: Identificador único del capítulo (formato X.Y.Z)

  • titulo: Título principal del capítulo

  • subtitulo: Descripción breve

  • parte/bloque: Números para organización jerárquica

  • nivel_dificultad: 'basico', 'intermedio', 'avanzado'

  • importancia: 'alta', 'media', 'baja'

  • palabras_clave: Array de términos para búsqueda

  • tipo_contenido: 'formativo', 'operativo', 'referencia'

  • tiempo_lectura: Minutos estimados

  • navegacion: Enlaces a capítulos relacionados


🧭 SISTEMA DE NAVEGACIÓN RECOMENDADO

1. Menú Lateral Jerárquico


📚 Manual TES Digital

├── 📖 Parte I: Fundamentos

│   ├── 🔹 Bloque 0: Fundamentos

│   │   └── 1.1.1 Fundamentos de Emergencias

│   └── 🔹 Bloque 1: Procedimientos Básicos

│       ├── 1.2.1 Constantes Vitales

│       ├── 1.2.2 ABCDE Operativo

│       ├── 1.2.3 Glasgow Operativo

│       └── 1.2.4 Triage START

├── 💉 Parte II: Soporte Vital

│   ├── 🔹 Bloque 4: RCP

│   └── 🔹 Bloque 9: Medicina Emergencias

└── ... (resto de partes)

Características:

  • Expandible/colapsable por niveles

  • Indicador visual del capítulo actual

  • Búsqueda rápida integrada

  • Favoritos/marcadores

2. Breadcrumbs (Migas de Pan)


Inicio > Parte I > Bloque 1 > 1.2.1 Constantes Vitales

Funcionalidad:

  • Navegación rápida a niveles superiores

  • Contexto visual de ubicación

  • Click en cualquier nivel para ir directamente

3. Navegación Anterior/Siguiente


← Capítulo Anterior: 1.1.1 Fundamentos

Capítulo Siguiente: 1.2.2 ABCDE Operativo →

Funcionalidad:

  • Botones flotantes o en footer

  • Navegación secuencial lógica

  • Atajos de teclado (← →)

4. Índice Rápido

Características:

  • Modal o sidebar deslizable

  • Búsqueda instantánea

  • Filtros por parte/bloque

  • Acceso desde cualquier página


🔍 FUNCIONALIDADES ADICIONALES RECOMENDADAS

Búsqueda Avanzada

  • Búsqueda por texto completo

  • Filtros por parte, bloque, tipo de contenido

  • Búsqueda por palabras clave

  • Historial de búsquedas

Modo Offline

  • Cache de contenido para acceso offline

  • Service Worker para PWA

  • Sincronización cuando hay conexión

Personalización

  • Modo oscuro/claro

  • Tamaño de fuente ajustable

  • Favoritos personalizados

  • Notas/annotaciones por capítulo

Tests/Autoevaluaciones

  • Preguntas por capítulo

  • Tests por bloque/parte

  • Historial de resultados

  • Modo estudio vs modo examen


📐 ESTRUCTURA DE DATOS JSON RECOMENDADA

indice.json


{

  "version": "1.0",

  "fecha": "2024-12-15",

  "partes": [

    {

      "id": 1,

      "nombre": "Fundamentos y Evaluación Inicial",

      "bloques": [

        {

          "id": 0,

          "nombre": "Fundamentos de Emergencias",

          "capitulos": [

            {

              "id": "1.1.1",

              "titulo": "Fundamentos de Emergencias",

              "ruta": "parte-i-fundamentos/bloque-0-fundamentos/1.1.1-fundamentos-emergencias.md"

            }

          ]

        }

      ]

    }

  ]

}


CHECKLIST DE IMPLEMENTACIÓN

Fase 1: Estructura Base

  • Crear estructura de carpetas propuesta

  • Migrar archivos .md a nueva estructura

  • Agregar front matter a todos los archivos

  • Generar indice.json desde estructura

Fase 2: Navegación

  • Implementar menú lateral jerárquico

  • Agregar breadcrumbs

  • Implementar navegación anterior/siguiente

  • Crear índice rápido con búsqueda

Fase 3: Funcionalidades

  • Implementar búsqueda avanzada

  • Agregar modo offline (PWA)

  • Implementar personalización

  • Crear sistema de tests/autoevaluaciones