Degree Flow

An interactive graduation planner for UFPel Computer Engineering, with a visual curriculum flow, prerequisite validation, and semester planning.

This is a local, single-user demo. It starts with My plan and every course marked as incomplete.

Requirements

• Python 3.11+
• Node.js 20.19+ or 22.12+

Run locally

Windows (PowerShell)

git clone https://github.com/EduardoTBuss/degree-flow.git
cd degree-flow
./run.ps1

Linux / macOS

git clone https://github.com/EduardoTBuss/degree-flow.git
cd degree-flow
make run

Open http://localhost:8000. The same server delivers the interface and the API.

To rebuild the frontend on Windows:

./run.ps1 -Rebuild

Development

Run these commands in separate terminals:

make dev-backend   # API on :8000
make dev-frontend  # interface on :5173

Tests

make test

On Windows, after running run.ps1 at least once:

backend/.venv/Scripts/python -m pip install -r backend/requirements-dev.txt
backend/.venv/Scripts/python -m pytest -c backend/pytest.ini backend/tests

SQLite is created at data/app.db and is not tracked. The repository contains no accounts, academic records, local databases, or student PDFs.

For technical details, see docs/ARCHITECTURE.md.

License

MIT © 2026 Eduardo Timm Buss.