How i0bz/grade_tracker_site works
This is a grade-tracking web application: users register or log in, select catalog subjects, assign grading weights, record activities and scores, then view calculated subject grades. FastAPI serves the pages and API; TypeScript pages call the API, and backend handlers query MySQL through a shared session dependency. The grade calculation is a distinct domain stage in the user-subject API. Frontend dashboard and authentication-page behavior is represented from the tree, but their API wiring is not verified in the excerpts.
Main entry points: router.py API router · database.py DB sessions · auth.py Authentication · utils.ts Session helpers
Components 17
Web app
- Page server
main.py - Entry redirect
frontend/src/index.ts - Account pages
frontend/src/login.ts - Grade dashboard
frontend/src/dashboard.ts - Subject management
frontend/src/subjects.ts - Subject editor
frontend/src/edit.ts - Session helpers
frontend/src/utils.ts
API routing
- API router
api/router.py
Grade domain
- Authentication
api/auth.py - User operations
api/users.py - Subject catalog
api/subjects.py - User subjects
api/user_subjects.py - Grade calculation
api/user_subjects.py - Activities
api/activities.py
Persistence
- DB sessions
database.py - MySQL store
Other components
- User
Connections 28
- User → Page server: opens pages
main.py - Page server → API router: mounts API
main.py - User → Entry redirect: starts at
- Entry redirect → Session helpers: reads session
frontend/src/index.ts - Account pages → Session helpers: uses session
frontend/src/login.ts - Grade dashboard → Session helpers: uses session
frontend/src/dashboard.ts - Subject management → Session helpers: builds requests
frontend/src/subjects.ts - Subject editor → Session helpers: builds requests
frontend/src/edit.ts - Entry redirect → Page server: redirects pages
- Account pages → API router: calls account API
- Grade dashboard → API router: requests grades
- Subject management → API router: requests subjects
frontend/src/subjects.ts - Subject editor → API router: requests edits
frontend/src/edit.ts - API router → Authentication: registers routes
api/router.py - API router → User operations: registers routes
api/router.py - API router → Subject catalog: registers routes
api/router.py - API router → User subjects: registers routes
api/router.py - API router → Activities: registers routes
api/router.py - Authentication → DB sessions: gets session
api/auth.py - User operations → Authentication: checks token
api/users.py - User operations → DB sessions: gets session
api/users.py - Subject catalog → DB sessions: gets session
api/subjects.py - User subjects → Authentication: checks token
api/user_subjects.py - User subjects → DB sessions: gets session
api/user_subjects.py - Activities → Authentication: checks token
api/activities.py - Activities → DB sessions: gets session
api/activities.py - Grade calculation → MySQL store: reads scores
api/user_subjects.py - DB sessions → MySQL store: opens connection
database.py