Análisis de brecha: algoritmo de recomendación VAP

// Entrada
const evaluation: VAPEvaluation[];   // puntajes C1–C5
const catalog: Course[];             // catálogo completo de cursos

// Paso 1: identificar brechas
const brechas = evaluation
  .filter(ev => ev.puntaje < 4.0)
  .sort((a, b) => a.puntaje - b.puntaje); // más crítica primero

// Paso 2: encontrar cursos candidatos
const candidatos = catalog.filter(curso =>
  curso.competencias_VAP_primarias?.some(
    comp => brechas.some(b => b.competencia_id === comp)
  )
);

// Paso 3: priorizar por criticidad (brecha de menor puntaje primero)
const ordenados = candidatos.sort((a, b) => {
  const puntoA = Math.min(
    ...a.competencias_VAP_primarias!.map(
      c => brechas.find(b => b.competencia_id === c)?.puntaje ?? 5
    )
  );
  const puntoB = Math.min(
    ...b.competencias_VAP_primarias!.map(
      c => brechas.find(b => b.competencia_id === c)?.puntaje ?? 5
    )
  );
  return puntoA - puntoB;
});

// Paso 4: seleccionar máximo 4 cursos
const cursos_sugeridos = ordenados.slice(0, 4).map(c => c.id_curso);

{
  "mensaje_estudiante": "Mensaje motivador personalizado basado en el área de profundización del aspirante.",
  "cursos_sugeridos": ["CURSO_085EF97C", "CURSO_59B6A6C4"],
  "plan_semestral": [
    {
      "semestre": 1,
      "materias": [
        {
          "nombre": "Comunicación efectiva en el aula",
          "estado": "sugerida",
          "justificacion": "Fortalece C1 (puntaje 2.8), competencia con mayor brecha detectada."
        },
        {
          "nombre": "Diseño Microcurricular",
          "estado": "regular",
          "justificacion": "Materia obligatoria del plan de estudios."
        }
      ]
    },
    {
      "semestre": 2,
      "materias": [
        {
          "nombre": "Investigación",
          "estado": "exonerada",
          "justificacion": "C2 supera el umbral de 4.0 según evaluación VAP."
        }
      ]
    }
  ],
  "analisis_director": "Se sugieren los cursos CURSO_085EF97C y CURSO_59B6A6C4 para fortalecer las brechas detectadas en C1 y C2, permitiendo la flexibilización de los mismos en la ruta de posgrado."
}