https://github.com/rahulsamant37/self-tracking
A daily progress tracking app that manages multiple concurrent goals (CAT, GATE, DSA), generates daily tasks, and drives an adaptive topic-mastery engine for the TLE Eliminator DSA course.
https://github.com/rahulsamant37/self-tracking
cat dsa fastapi gate nextjs self-improvement
Last synced: 10 days ago
JSON representation
A daily progress tracking app that manages multiple concurrent goals (CAT, GATE, DSA), generates daily tasks, and drives an adaptive topic-mastery engine for the TLE Eliminator DSA course.
- Host: GitHub
- URL: https://github.com/rahulsamant37/self-tracking
- Owner: rahulsamant37
- Created: 2026-06-08T05:58:21.000Z (17 days ago)
- Default Branch: devin/1780898916-phase1-mvp
- Last Pushed: 2026-06-08T08:23:34.000Z (17 days ago)
- Last Synced: 2026-06-08T10:16:03.342Z (17 days ago)
- Topics: cat, dsa, fastapi, gate, nextjs, self-improvement
- Language: Python
- Homepage:
- Size: 129 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Goal Progress Tracker
A daily progress tracking app that manages multiple concurrent goals (CAT, GATE, DSA),
generates daily tasks, and drives an **adaptive topic-mastery engine** for the
TLE Eliminator DSA course.
> **Status:** Phase 1 MVP. See [the roadmap](#roadmap) for what's next.
## Features (Phase 1 MVP)
- **Multi-goal management** — create exam / skill / DSA goals with deadlines, daily time
budgets, priority, and color. Seeded with CAT 2026, GATE 2027, and DSA (TLE Eliminator).
- **TLE Eliminator course tracking** — all 4 levels and their topics, with per-topic
difficulty, video counts, and mastery.
- **Daily task generation** — one click builds a balanced plan across all active goals:
video lectures + course problems + a daily Codeforces problem (rating scaled to level).
- **Task completion tracking** — check off tasks; daily/total counts and streaks update.
- **Progress dashboard** — per-goal progress %, days remaining, on-track / at-risk / behind
status, and streak.
- **Adaptive mastery engine** — log each problem outcome (fast / slow / partial / unsolved);
the system scores mastery and keeps assigning more problems until a topic is mastered
(≥90%), per the spec's `+10 / +5` algorithm.
## Tech stack
| Layer | Tech |
| -------- | ------------------------------------------------- |
| Frontend | React + Vite + TypeScript + Tailwind CSS + Router |
| Backend | FastAPI + SQLModel (SQLite) |
## Project layout
```
goal-progress-tracker/
├── backend/ FastAPI app, SQLModel models, services, tests
│ └── app/
│ ├── routers/ goals, tasks, tle, dashboard
│ └── services/ mastery, task_generation, progress
└── frontend/ React + Vite app
└── src/
├── pages/ Dashboard, Today, Dsa, Goals
└── components/ Layout, ProgressBar
```
## Running locally
### Backend
```bash
cd backend
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
uvicorn app.main:app --reload --port 8000
```
The API runs at `http://localhost:8000` (docs at `/docs`). A SQLite DB is created and
seeded on first start.
### Frontend
```bash
cd frontend
npm install
npm run dev
```
The dev server runs at `http://localhost:5173` and proxies `/api` to the backend.
To point at a non-proxied backend, set `VITE_API_BASE` (e.g. `VITE_API_BASE=https://api.example.com`).
## Tests & checks
```bash
# backend
cd backend && source .venv/bin/activate && ruff check . && pytest
# frontend
cd frontend && npm run lint && npm run build
```
## Roadmap
- **Phase 2** — Codeforces API integration, richer analytics, problem timer.
- **Phase 3** — CAT/GATE syllabus DB and mock-test engine.
- **Phase 4** — AI insights & doubt-solving (free models).
- **Phase 5** — Spaced repetition, YouTube ingestion, gamification, PWA.