How bmynk/graduation-credit-tracker works
Graduation Credit Tracker is a student-success platform whose central workflow is: students and administrators use separate interfaces, the frontend sends authenticated requests to the FastAPI backend, and academic records and programme rules support progress views and study planning. Additional branches cover community, rewards, support information, AI assistance, email, and administration. Evidence is strongest for application wiring, shared data models, progress calculations, and documented product capabilities; several route and page implementations are unsampled, so their internal call paths are not expanded.
Main entry points: App.jsx Student app · main.py API application · api.js API client · AdminApp.jsx Admin app
Components 26
Web experiences
- Student app
frontend/src/App.jsx - Admin app
frontend/src/AdminApp.jsx - API client
frontend/src/api.js
Academic progress
- Progress views
frontend/src/pages/student/SummaryPage.jsx - Academic history
frontend/src/pages/student/HistoryPage.jsx - Study planning
frontend/src/pages/student/PlannerPage.jsx - Grade prediction
frontend/src/pages/student/PredictorPage.jsx - Peer comparison
frontend/src/components/PeerComparison.jsx - Progress logic
backend/app/services/progress_service.py
Student services
- Community
frontend/src/pages/student/CommunityPage.jsx - Achievements
frontend/src/pages/student/AchievementsPage.jsx - Marcel assistant
frontend/src/components/assistant/AssistantWidget.jsx - Support services
backend/app/routers/support_services.py - Assistant services
backend/app/services/assistant_service.py - Web search
backend/app/services/web_search_service.py
Backend foundation
- API application
backend/app/main.py - Authentication
backend/app/routers/auth.py - Domain APIs
backend/app/routers - Email delivery
backend/app/email_service.py - Academic records
backend/app/models.py - Database access
backend/app/database.py - Runtime settings
backend/app/config.py
Other components
- Students
- Administrators
- Mailjet
- Tavily
Connections 28
- Students → Student app: use
README.md - Administrators → Admin app: use
README.md - Student app → API client: requests
frontend/src/App.jsx - Admin app → API client: requests
- API client → API application: calls API
README.md - API application → Authentication: registers
backend/app/main.py - API application → Domain APIs: registers
backend/app/main.py - Student app → Progress views: renders
frontend/src/App.jsx - Student app → Academic history: renders
frontend/src/App.jsx - Student app → Study planning: renders
frontend/src/App.jsx - Student app → Peer comparison: renders
frontend/src/App.jsx - Student app → Community: renders
frontend/src/App.jsx - Student app → Achievements: renders
frontend/src/App.jsx - Student app → Marcel assistant: renders
frontend/src/App.jsx - API client → Progress views: serves data
- Progress logic → Email delivery: calls
backend/app/services/progress_service.py - Progress logic → Academic records: reads records
backend/app/services/progress_service.py - Domain APIs → Support services: includes
backend/app/main.py - API application → Database access: creates tables
backend/app/main.py - Database access → Runtime settings: reads settings
backend/app/database.py - Academic records → Database access: defines tables
backend/app/models.py - Email delivery → Mailjet: sends email
backend/app/email_service.py - Web search → Tavily: searches web
backend/app/services/web_search_service.py - Assistant services → Web search: uses search
backend/app/services/assistant_service.py - Email delivery → Runtime settings: reads settings
backend/app/email_service.py - Web search → Runtime settings: reads settings
backend/app/services/web_search_service.py - Domain APIs → Progress logic: uses calculations
backend/app/routers/admin.py - Admin app → Grade prediction: offers