🧠 Proyecto Saber Pro IA - Tutor Virtual UDC

📘 Descripción General

---

Este repositorio contiene el desarrollo completo del Tutor Virtual para la preparación Saber Pro, una solución basada en Inteligencia Artificial que asiste a los estudiantes en la preparación de la prueba mediante simulaciones, análisis de desempeño y retroalimentación inteligente.

El proyecto integra módulos de interfaz, lógica de tutoría, bases de datos y archivos de soporte (.zip, .rar) gestionados mediante Git Large File Storage (LFS) para un manejo eficiente de archivos grandes.

---

🧩 Requisitos Previos

Antes de comenzar, asegúrate de tener instaladas las siguientes herramientas:

Herramienta	Descripción	Verificación
Git	Control de versiones	git --version
Git LFS	Manejo de archivos grandes	git lfs version
Visual Studio Code	Entorno de desarrollo	code --version
Python (si aplica)	Entorno backend o IA	python --version
Node.js / npm (si aplica)	Entorno frontend	node -v / npm -v

---

Arquitectura

flowchart TD
    A[Estudiante] --> B[Interfaz de Usuario - Web / Desktop]
    B --> C[Modulo de Tutoria IA - Retroalimentacion inteligente]
    C --> D[Simulaciones Saber Pro - Preguntas y respuestas]
    C --> E[Analisis de Desempeno - Reportes de progreso]
    D --> F[(Base de Datos - Preguntas y resultados)]
    E --> F
    G[Archivos .zip/.rar - Git LFS] --> C
    F --> H[Retroalimentacion al estudiante]
    H --> A

Loading

🚀 Guía Completa de Clonado y Despliegue

🔹 Paso 1: Clonar el Repositorio desde GitHub

Abre tu terminal (CMD o PowerShell) y ejecuta:

git clone https://github.com/AlejoTechEngineer/Proyecto_Saber_Pro_IA_Tutor_Virtual_UDC.git
cd Proyecto_Saber_Pro_IA_Tutor_Virtual_UDC

---

🔹 Paso 2: Configurar Git LFS

Antes de abrir el proyecto, descarga correctamente los archivos grandes:

git lfs install
git lfs pull

Esto asegura que los archivos .zip y .rar se descarguen completos.

---

🔹 Paso 3: Abrir el Proyecto en Visual Studio Code

code .

O manualmente:

1. Abre Visual Studio Code
2. Selecciona Archivo → Abrir carpeta
3. Elige la carpeta clonada del proyecto

---

🔹 Paso 4: Instalar Dependencias

Dependiendo del módulo que ejecutes:

Si es un proyecto Node.js:

npm install

Si es un proyecto Python:

pip install -r requirements.txt

---

🔹 Paso 5: Ejecutar el Proyecto

En Node.js:

npm start

En Python (Flask o FastAPI):

python app.py

---

🔹 Paso 6: Visualizar el Proyecto

Una vez iniciado el servidor local, abre tu navegador en:

• Node.js → http://localhost:3000
• Python → http://127.0.0.1:5000

---

🗂️ Estructura del Proyecto

Proyecto_Saber_Pro_IA_Tutor_Virtual_UDC/
│
├── DATA SABER PRO UTIL/
│   └── Saber Pro S.rar
│
├── Tutor Virtual Codigo/
│   └── TutorVirtual-main.zip
│
├── assets/
│   └── recursos estáticos (imágenes, íconos, etc.)
│
├── docs/
│   └── documentación técnica y guías
│
├── README.md
└── .gitattributes

---

💾 Actualización del Repositorio

Para mantener tu versión local actualizada con la versión remota:

git pull origin main
git lfs pull

---

⚙️ Resolución de Problemas Comunes

❌ Error: “File exceeds 100MB”

➡ Esto ocurre si Git LFS no está activo.
Solución:

git lfs install
git lfs track "*.zip"
git lfs track "*.rar"
git add .gitattributes
git commit -m "Activar LFS para archivos grandes"
git push origin main

---

❌ Error: No se instalan dependencias

Si al ejecutar npm start o python app.py aparecen errores, reinstala dependencias:

npm install

o

pip install -r requirements.txt

---

❌ El servidor no arranca

Verifica que el puerto esté libre:

npx kill-port 3000

Y luego vuelve a ejecutar:

npm start

---

👨‍💻 Autor

Alejandro De Mendoza Tovar
Universitaria de Colombia
GitHub: AlejoTechEngineer

---

📄 Licencia

Licencia MIT — Uso educativo y no comercial permitido con atribución.
Puedes modificar, distribuir y utilizar el código con fines académicos bajo esta licencia.

---

Repositorio oficial:
🔗 https://github.com/AlejoTechEngineer/Proyecto_Saber_Pro_IA_Tutor_Virtual_UDC