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