Planificador de Correlativas

App web para estudiantes de la Tecnicatura Universitaria en Programación (UTN, plan 2024). Marcás qué materias tenés regulares o aprobadas y te muestra qué podés cursar, qué podés rendir, qué está bloqueado y qué te falta para desbloquearlo.

Demo online: https://planificador-correlativas.vercel.app/

Qué hace

• Plan por año con las correlativas de cada materia.
• Marcás tu estado en cada materia: pendiente, regular o aprobada.
• Te dice qué podés hacer:
  • 🟩 Podés cursarla.
  • 🟦 Podés rendirla.
  • 🟧 Bloqueada, con la lista exacta de lo que falta. Por ejemplo: "Para cursar falta: Programación II (regular)".
• Tu avance en la carrera: el porcentaje completado (por cantidad de materias aprobadas) y tu promedio. La nota de cada materia aprobada es opcional, y el promedio es sin aplazos: solo cuenta las notas con las que aprobaste.
• Feedback motivador: un mensaje según cuánto te falta y tu promedio. Por ejemplo: "¡Te faltan solo 2 materias! Metele un último esfuerzo 💪 Y con un promedio de 8,67, ¡excelente!"
• Compartir progreso: un botón genera un link con tu avance (en el celular abre el menú para mandarlo por WhatsApp). Quien lo abre lo ve en modo solo lectura, sin que se modifique su propio progreso.
• Publicar progreso: arma una imagen con tu avance y el texto de una publicación para LinkedIn, en primera persona y distinto según la etapa de la carrera. Podés ver otra versión, sumar tu promedio (si es 7 o más) y editar el texto antes de publicar.
• Materias llave: cuántas materias desbloquea cada una, directamente y en cadena. Por ejemplo, Programación I y Matemática desbloquean 10 de las 17.
• Sin cuentas ni login: tu progreso se guarda en tu navegador (localStorage). El servidor no guarda datos personales.

Reglas de correlatividad

Según la Ordenanza N.º 2019/2023 del Consejo Superior de la UTN, cada materia tiene dos listas de correlativas:

• Para cursar una materia, sus correlativas regulares tienen que estar al menos regularizadas y sus correlativas aprobadas, aprobadas.
• Para rendir una materia, tiene que estar regularizada y todas sus correlativas (las dos listas) tienen que estar aprobadas.

El plan completo está en data/tup_plan2024.json.

Stack

Parte	Tecnología
Backend	Python 3.13, FastAPI, Pydantic, Uvicorn
Base de datos	SQLite con SQL escrito a mano (módulo sqlite3, sin ORM)
Frontend	HTML, CSS y JavaScript sin frameworks
Tests	pytest y TestClient de FastAPI
CI	GitHub Actions (Windows y Linux)

Cómo correrlo

Necesitás Python 3.13, la versión fijada en .python-version. También funciona desde 3.10.

Windows (PowerShell):

git clone https://github.com/TTubi/planificador-correlativas.git
cd planificador-correlativas
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
uvicorn app.main:app --reload

Linux o macOS:

git clone https://github.com/TTubi/planificador-correlativas.git
cd planificador-correlativas
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload

Después abrí http://127.0.0.1:8000/.

Al arrancar, la app valida el JSON del plan y genera la base planificador.db. Si el plan tiene errores, no arranca y los muestra. python -m scripts.cargar_plan hace lo mismo a mano, y sirve para validar el JSON sin levantar el servidor.

Tests

python -m pytest                      # backend (Python)
node --test "tests/js/*.test.mjs"     # lógica del frontend (JavaScript)

Los tests no necesitan la base generada: los de la API arman una base temporal propia. Los de JavaScript usan el runner que trae Node 22 y no necesitan instalar paquetes.

Configuración

Variable de entorno	Para qué sirve	Valor por defecto
PLANIFICADOR_DB	Ruta del archivo de la base SQLite que se genera al arrancar.	planificador.db en la raíz del proyecto

Localmente no hace falta definirla. Existe para los hostings donde la carpeta del proyecto es de solo lectura.

Deploy en Vercel

Vercel detecta la app FastAPI en app/main.py y la publica como una función serverless, así que no hace falta un vercel.json. Los archivos de app/static/ se sirven desde su CDN.

1. En vercel.com, entrá con tu cuenta de GitHub y elegí Add New → Project.

2. Importá el repo planificador-correlativas. Vercel reconoce el preset FastAPI: no cambies los comandos de build ni la carpeta raíz.

3. En Environment Variables, agregá:

   Nombre	Valor
   PLANIFICADOR_DB	/tmp/planificador.db

4. Tocá Deploy. En uno o dos minutos te da la URL pública. La demo de este repo está en https://planificador-correlativas.vercel.app/.

Desde ahí, cada push a main publica una versión nueva, y cada PR recibe su propia URL de vista previa.

Por qué hace falta PLANIFICADOR_DB: en Vercel el código queda en una carpeta de solo lectura, y el único lugar donde se puede escribir es /tmp. Sin la variable, la app intenta crear la base junto al código, falla al arrancar y el deploy queda caído.

Detalles a tener en cuenta:

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗