Arquitectura de RAP-Rec: SPA React con IA en cliente

src/
├── App.tsx               # Orquestador principal y máquina de estados
├── main.tsx              # Punto de entrada React (StrictMode)
├── types.ts              # Interfaces TypeScript del dominio
├── index.css             # Estilos globales y tokens de diseño Icesi
├── components/           # Componentes de interfaz de usuario
├── services/
│   └── gemini.ts         # Integración con Google Gemini AI
└── data/
    ├── competencies.ts   # Definición de las 5 competencias VAP
    ├── courses.ts        # Catálogo de cursos de posgrado
    └── questions.json    # Banco de preguntas de evaluación por competencia

export interface Course {
  id_curso: string;
  nombre: string;
  codigo?: string | null;
  creditos: number;
  semestre?: number | null;
  area_tematica?: string | null;
  descripcion?: string | null;
  objetivos: string[];
  competencias_declaradas: string[];
  resultados_aprendizaje: string[];
  contenidos: { unidad: string | null; temas: string[] }[];
  temas_clave: string[];
  palabras_clave: string[];
  programa: string;
  nivel_programa: string;
  competencias_VAP_primarias?: string[];
}

export interface Competency {
  id: string;
  clave: string;
  nombre: string;
  descripcion: string;
  niveles: {
    nivel: number;
    nombre: string;
    descripcion: string;
  }[];
}

export interface UserProfile {
  id: string; // UUID
  nombre: string;
  email: string;
  phone: string;

  // Trayectoria profesional
  years_experience: number;
  current_position: string;
  empresa: string;
  industry: string;
  education_level: string;
  technical_skills: string[];
  certifications: string[];
  relevant_projects: string[];

  // Campos específicos de VAP-Rec
  area_profundizacion: string;
  contexto_aplicacion: string;
  objetivo_profesional: string;
  motivation: string;

  // Opcionales: enriquecidos por la IA de extracción
  resumen?: string;
  formacion?: {
    titulo: string;
    institucion: string;
    anio: string;
    nivel: string;
  }[];
  nivel_jerarquico?: string;
  respuestas_experiencia?: {
    transformacion_pedagogica?: string;
    diseño_curricular?: string;
    integracion_tic?: string;
  };
}

export interface VAPEvaluation {
  competencia_id: string;
  puntaje: number;       // Escala 1.0 – 5.0
  nivel: string;         // "Novato" | "Competente" | "Proficiente" | "Experto"
  justificacion: string; // Análisis generado por Gemini
}

export interface AppState {
  step: number;                    // 1 – 7
  selectedProgram: string | null;
  profile: UserProfile | null;
  evaluation: VAPEvaluation[];
  recommendations: {
    student_view: any[];
    director_view: any;
  } | null;
}