codigo0/VERIFICACION_MANUAL_COMPLETA.md

Script de Verificación del Manual TES Digital

Fecha: 2025-12-17
Script: scripts/verificar-manual.ts

---

📋 Descripción

Script completo de verificación que valida la integridad del Manual TES Digital, asegurando que todos los componentes funcionen correctamente.

---

🚀 Uso

npm run verify:manual

---

✅ Verificaciones Realizadas

1. Archivos .md Accesibles

Qué verifica:

• ✅ Que todos los 93 archivos .md existan en public/manual/
• ✅ Que los archivos se puedan leer correctamente
• ✅ Que los archivos no estén vacíos

Método:

• Lee el índice completo desde src/data/manual-index.ts
• Construye la ruta esperada en public/manual/
• Verifica existencia y legibilidad de cada archivo

Salida:

📁 Verificando archivos .md accesibles...
✅ Encontrados: X/93
❌ Faltantes: X
⚠️  Errores: X

2. Rutas

Qué verifica:

• ✅ Formato correcto de rutas URL (/manual/parte-X/bloque-X/codigo)
• ✅ Coincidencia entre código del capítulo y ruta URL
• ✅ Estructura consistente de rutas

Método:

• Valida formato de cada rutaUrl
• Verifica que el código en la ruta coincida con capitulo.id

Salida:

🔗 Verificando rutas...
✅ Rutas válidas: X/93
❌ Rutas inválidas: X

3. Navegación

Qué verifica:

• ✅ Que los capítulos anterior/siguiente existan
• ✅ Consistencia bidireccional (si A → B, entonces B ← A)
• ✅ Referencias circulares o rotas

Método:

• Para cada capítulo, verifica que navegacion.anterior y navegacion.siguiente apunten a capítulos existentes
• Verifica que las referencias sean bidireccionales

Salida:

🧭 Verificando navegación...
✅ Navegación válida: X/93
❌ Problemas de navegación: X

4. Búsqueda

Qué verifica:

• ✅ Que los capítulos sean encontrables por búsqueda
• ✅ Búsqueda por título
• ✅ Búsqueda por palabras clave
• ✅ Búsqueda por ID

Queries de prueba:

• Términos comunes: "RCP", "ABCDE", "Glasgow", "Triage", "Oxigenoterapia", etc.
• IDs específicos: "1.1.1", "2.1.3", etc.

Método:

• Simula búsqueda en títulos, palabras clave e IDs
• Verifica que cada query encuentre al menos un resultado

Salida:

🔍 Verificando búsqueda...
✅ "RCP": X resultado(s)
✅ "ABCDE": X resultado(s)
...
✅ Búsquedas exitosas: X/13
❌ Búsquedas fallidas: X

---

📊 Resumen Final

Al finalizar, el script muestra un resumen completo:

═══════════════════════════════════════════════════════
  RESUMEN FINAL
═══════════════════════════════════════════════════════

📁 Archivos: X/93 encontrados
🔗 Rutas: X/93 válidas
🧭 Navegación: X/93 válidas
🔍 Búsqueda: X/13 exitosas

---

🔧 Código de Salida

• 0 - Todas las verificaciones pasaron ✅
• 1 - Se encontraron problemas ❌

Útil para integración en CI/CD:

# .github/workflows/verify.yml
- name: Verify Manual
  run: npm run verify:manual

---

🐛 Problemas Detectados

El script detectó los siguientes problemas:

1. Archivo Faltante

• Capítulo: 7.1.1
• Problema: El índice referencia BLOQUE_11_0_SITUACIONES_ESPECIALES.md pero el archivo real es BLOQUE_10_0_SITUACIONES_ESPECIALES.md
• Solución: Corregir el mapeo en generar_indice_app.py

2. Búsqueda sin Resultados

• Query: "Farmacología"
• Problema: No encuentra resultados (probablemente la palabra clave es "Farmacologia" sin tilde)
• Solución: Agregar variantes con/sin tildes a las palabras clave

---

📝 Ejemplo de Salida

═══════════════════════════════════════════════════════
  VERIFICACIÓN DEL MANUAL TES DIGITAL
═══════════════════════════════════════════════════════

📁 Verificando archivos .md accesibles...
✅ Encontrados: 92/93
❌ Faltantes: 1

🔗 Verificando rutas...
✅ Rutas válidas: 93/93

🧭 Verificando navegación...
✅ Navegación válida: 93/93

🔍 Verificando búsqueda...
✅ "RCP": 5 resultado(s)
✅ "ABCDE": 1 resultado(s)
...
✅ Búsquedas exitosas: 12/13
❌ Búsquedas fallidas: 1

═══════════════════════════════════════════════════════
  RESUMEN FINAL
═══════════════════════════════════════════════════════

📁 Archivos: 92/93 encontrados
🔗 Rutas: 93/93 válidas
🧭 Navegación: 93/93 válidas
🔍 Búsqueda: 12/13 exitosas

❌ Se encontraron 2 problema(s)

---

🔄 Integración Continua

GitHub Actions

name: Verify Manual

on: [push, pull_request]

jobs:
  verify:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '18'
      - run: npm install
      - run: npm run verify:manual

Pre-commit Hook

#!/bin/sh
npm run verify:manual

---

🎯 Próximas Mejoras

• Verificación de contenido (no solo existencia)
• Validación de front matter YAML
• Verificación de enlaces internos entre capítulos
• Validación de imágenes referenciadas
• Generación de reporte HTML detallado

---

Estado: ✅ Script funcional y detectando problemas reales