codigo0/PROBLEMAS_DETECTADOS.md

Problemas Detectados por el Script de Verificación

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

---

🔴 PROBLEMA 1: Archivo Faltante

Detalles

Capítulo: 7.1.1 - "Situaciones Especiales"
Ubicación en índice: src/data/manual-index.ts línea 2395

Problema:

• El índice referencia: BLOQUE_11_0_SITUACIONES_ESPECIALES.md
• El archivo real es: BLOQUE_10_0_SITUACIONES_ESPECIALES.md

Ruta esperada (incorrecta):

public/manual/BLOQUE_10_SITUACIONES_ESPECIALES/BLOQUE_11_0_SITUACIONES_ESPECIALES.md

Ruta real (correcta):

public/manual/BLOQUE_10_SITUACIONES_ESPECIALES/BLOQUE_10_0_SITUACIONES_ESPECIALES.md

Causa

Error en el script generar_indice_app.py que genera el índice. El mapeo tiene un error donde confunde el número de bloque (10) con el número de bloque siguiente (11).

Solución

Opción 1: Corregir el índice manualmente

// En src/data/manual-index.ts línea 2395
rutaArchivo: "manual-tes/TES_Manual_Digital/BLOQUE_10_SITUACIONES_ESPECIALES/BLOQUE_10_0_SITUACIONES_ESPECIALES.md",

Opción 2: Corregir el script generador Corregir el mapeo en generar_indice_app.py:

MAPEO_REAL = {
    # ...
    "7.1.1": "BLOQUE_10_0_SITUACIONES_ESPECIALES.md",  # Era BLOQUE_11_0
    # ...
}

Luego regenerar el índice:

python3 generar_indice_app.py

Impacto

• ⚠️ Alto: El capítulo 7.1.1 no se puede cargar en la app
• ⚠️ La navegación desde 6.1.6 hacia 7.1.1 fallará
• ⚠️ La navegación desde 7.1.1 hacia 7.2.1 funcionará (pero el contenido no se mostrará)

---

🟡 PROBLEMA 2: Búsqueda sin Resultados

Detalles

Query: "Farmacología"
Resultado: Sin resultados encontrados

Análisis

El script busca en:

1. ✅ Título del capítulo (capitulo.titulo)
2. ✅ Palabras clave (capitulo.palabrasClave)
3. ✅ ID del capítulo (capitulo.id)

Problema:

• "Farmacología" aparece en:
  • ✅ Nombres de parte: "Farmacología y Medicamentos"
  • ✅ Nombres de bloque: "Farmacología y Vademécum Operativo"
  • ❌ NO aparece en títulos de capítulos individuales
  • ❌ NO está en palabrasClave de los capítulos

Capítulos relacionados con Farmacología:

• 4.1.1 - "Principios de Administración de Fármacos"
• 4.1.2 - "Vademécum Operativo"
• 4.1.3 - "Oxígeno - Administración y Seguridad"
• 4.1.4 - "Adrenalina - Uso en Anafilaxia y RCP"
• 4.1.5 - "Aspirina - Uso en SCA"
• 4.1.6 - "Glucagón - Uso en Hipoglucemia"
• 4.1.7 - "Salbutamol - Uso en Crisis Asmática"
• 4.1.8 - "Abreviaturas y Terminología Farmacológica"

Causa

Los capítulos no tienen "Farmacología" en sus títulos ni en sus palabras clave. Solo aparece en los nombres de parte/bloque que no se buscan.

Solución

Opción 1: Agregar palabras clave a los capítulos

Modificar generar_indice_app.py para agregar palabras clave automáticamente:

def extraer_palabras_clave(nombre: str, bloque: int) -> list:
    palabras_clave = []
    
    # Agregar palabras del nombre de bloque/parte
    if bloque == 6:  # Bloque de Farmacología
        palabras_clave.append("farmacologia")
        palabras_clave.append("farmacos")
        palabras_clave.append("medicamentos")
    
    # ... resto del código

Opción 2: Mejorar la búsqueda en el componente

Modificar ManualIndex.tsx para buscar también en nombres de parte/bloque:

// Buscar también en nombres de parte y bloque
manualIndex.forEach(parte => {
  if (parte.nombre.toLowerCase().includes(queryLower)) {
    // Incluir todos los capítulos de esta parte
  }
  
  parte.bloques.forEach(bloque => {
    if (bloque.nombre.toLowerCase().includes(queryLower)) {
      // Incluir todos los capítulos de este bloque
    }
  });
});

Impacto

• 🟡 Medio: Los usuarios no pueden encontrar capítulos de farmacología buscando "Farmacología"
• 🟡 Pueden encontrar buscando términos específicos como "Adrenalina", "Vademécum", etc.
• 🟡 La búsqueda funciona para términos más específicos

---

📊 Resumen de Problemas

#	Problema	Severidad	Impacto	Solución
1	Archivo faltante (7.1.1)	🔴 Alta	Capítulo no cargable	Corregir ruta en índice
2	Búsqueda "Farmacología"	🟡 Media	No encuentra resultados	Agregar palabras clave o mejorar búsqueda

---

✅ Verificación Post-Corrección

Después de corregir los problemas, ejecutar:

npm run verify:manual

Debería mostrar:

• ✅ Archivos: 93/93 encontrados
• ✅ Búsqueda: 13/13 exitosas

---

🔧 Comandos para Corregir

Corregir Problema 1:

# Opción A: Editar manualmente el índice
# Editar src/data/manual-index.ts línea 2395

# Opción B: Corregir y regenerar
# Editar generar_indice_app.py
python3 generar_indice_app.py

Corregir Problema 2:

# Opción A: Mejorar búsqueda en ManualIndex.tsx
# Agregar búsqueda en nombres de parte/bloque

# Opción B: Agregar palabras clave
# Modificar generar_indice_app.py y regenerar
python3 generar_indice_app.py

---

Estado: ⚠️ 2 problemas detectados - Requieren corrección