# bmynk/graduation-credit-tracker architecture

> Architecture diagram of the GitHub repository bmynk/graduation-credit-tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bmynk/graduation-credit-tracker
- Repository: https://github.com/bmynk/graduation-credit-tracker

## Overview

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: [`frontend/src/App.jsx`](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/App.jsx) (Student app), [`backend/app/main.py`](https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/main.py) (API application), [`frontend/src/api.js`](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/api.js) (API client), [`frontend/src/AdminApp.jsx`](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/AdminApp.jsx) (Admin app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web experiences"]
  node_student_app["Student app<br/>[App.jsx]"]
  node_admin_app["Admin app<br/>[AdminApp.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_academic["Academic progress"]
  node_progress_views["Progress views<br/>[SummaryPage.jsx]"]
  node_history_view["Academic history<br/>[HistoryPage.jsx]"]
  node_planning_views["Study planning<br/>[PlannerPage.jsx]"]
  node_prediction_view["Grade prediction<br/>[PredictorPage.jsx]"]
  node_peer_view["Peer comparison<br/>[PeerComparison.jsx]"]
  node_progress_logic["Progress logic"]
end

subgraph group_engagement["Student services"]
  node_community_view["Community<br/>[CommunityPage.jsx]"]
  node_achievement_view["Achievements"]
  node_assistant_view["Marcel assistant"]
  node_support_routes["Support services"]
  node_assistant_logic["Assistant services"]
  node_search_service["Web search"]
end

subgraph group_operations["Backend foundation"]
  node_backend_app["API application<br/>[main.py]"]
  node_auth_routes["Authentication<br/>[auth.py]"]
  node_domain_routes["Domain APIs"]
  node_email_service["Email delivery<br/>[email_service.py]"]
  node_data_models[("Academic records<br/>[models.py]")]
  node_database[("Database access<br/>[database.py]")]
  node_configuration["Runtime settings<br/>[config.py]"]
end

node_students(("Students"))
node_administrators(("Administrators"))
node_mailjet{{"Mailjet"}}
node_tavily{{"Tavily"}}

node_students -->|"use"| node_student_app
node_administrators -->|"use"| node_admin_app
node_student_app -->|"requests"| node_api_client
node_admin_app -.->|"requests"| node_api_client
node_api_client -->|"calls API"| node_backend_app
node_backend_app -->|"registers"| node_auth_routes
node_backend_app -->|"registers"| node_domain_routes
node_student_app -->|"renders"| node_progress_views
node_student_app -->|"renders"| node_history_view
node_student_app -->|"renders"| node_planning_views
node_student_app -->|"renders"| node_peer_view
node_student_app -->|"renders"| node_community_view
node_student_app -->|"renders"| node_achievement_view
node_student_app -->|"renders"| node_assistant_view
node_api_client -->|"serves data"| node_progress_views
node_progress_logic -->|"calls"| node_email_service
node_progress_logic -->|"reads records"| node_data_models
node_domain_routes -->|"includes"| node_support_routes
node_backend_app -->|"creates tables"| node_database
node_database -->|"reads settings"| node_configuration
node_data_models -->|"defines tables"| node_database
node_email_service -->|"sends email"| node_mailjet
node_search_service -->|"searches web"| node_tavily
node_assistant_logic -->|"uses search"| node_search_service
node_email_service -->|"reads settings"| node_configuration
node_search_service -->|"reads settings"| node_configuration
node_domain_routes -.->|"uses calculations"| node_progress_logic
node_admin_app -.->|"offers"| node_prediction_view

click node_student_app "https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/App.jsx"
click node_admin_app "https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/AdminApp.jsx"
click node_api_client "https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/api.js"
click node_progress_views "https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/pages/student/SummaryPage.jsx"
click node_history_view "https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/pages/student/HistoryPage.jsx"
click node_planning_views "https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/pages/student/PlannerPage.jsx"
click node_prediction_view "https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/pages/student/PredictorPage.jsx"
click node_peer_view "https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/components/PeerComparison.jsx"
click node_community_view "https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/pages/student/CommunityPage.jsx"
click node_achievement_view "https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/pages/student/AchievementsPage.jsx"
click node_assistant_view "https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/components/assistant/AssistantWidget.jsx"
click node_support_routes "https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/routers/support_services.py"
click node_backend_app "https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/main.py"
click node_auth_routes "https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/routers/auth.py"
click node_domain_routes "https://github.com/bmynk/graduation-credit-tracker/tree/main/backend/app/routers"
click node_progress_logic "https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/services/progress_service.py"
click node_assistant_logic "https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/services/assistant_service.py"
click node_search_service "https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/services/web_search_service.py"
click node_email_service "https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/email_service.py"
click node_data_models "https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/models.py"
click node_database "https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/database.py"
click node_configuration "https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/config.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_student_app,node_admin_app,node_api_client toneBlue
class node_progress_views,node_history_view,node_planning_views,node_prediction_view,node_peer_view,node_progress_logic toneAmber
class node_community_view,node_achievement_view,node_assistant_view,node_support_routes,node_assistant_logic,node_search_service toneMint
class node_backend_app,node_auth_routes,node_domain_routes,node_email_service,node_data_models,node_database,node_configuration toneRose
class node_students,node_administrators,node_mailjet,node_tavily toneIndigo
```

## Components

### Web experiences

- [Student app](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Admin app](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/AdminApp.jsx): `frontend/src/AdminApp.jsx`
- [API client](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/api.js): `frontend/src/api.js`

### Academic progress

- [Progress views](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/pages/student/SummaryPage.jsx): `frontend/src/pages/student/SummaryPage.jsx`
- [Academic history](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/pages/student/HistoryPage.jsx): `frontend/src/pages/student/HistoryPage.jsx`
- [Study planning](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/pages/student/PlannerPage.jsx): `frontend/src/pages/student/PlannerPage.jsx`
- [Grade prediction](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/pages/student/PredictorPage.jsx): `frontend/src/pages/student/PredictorPage.jsx`
- [Peer comparison](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/components/PeerComparison.jsx): `frontend/src/components/PeerComparison.jsx`
- [Progress logic](https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/services/progress_service.py): `backend/app/services/progress_service.py`

### Student services

- [Community](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/pages/student/CommunityPage.jsx): `frontend/src/pages/student/CommunityPage.jsx`
- [Achievements](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/pages/student/AchievementsPage.jsx): `frontend/src/pages/student/AchievementsPage.jsx`
- [Marcel assistant](https://github.com/bmynk/graduation-credit-tracker/blob/main/frontend/src/components/assistant/AssistantWidget.jsx): `frontend/src/components/assistant/AssistantWidget.jsx`
- [Support services](https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/routers/support_services.py): `backend/app/routers/support_services.py`
- [Assistant services](https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/services/assistant_service.py): `backend/app/services/assistant_service.py`
- [Web search](https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/services/web_search_service.py): `backend/app/services/web_search_service.py`

### Backend foundation

- [API application](https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication](https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/routers/auth.py): `backend/app/routers/auth.py`
- [Domain APIs](https://github.com/bmynk/graduation-credit-tracker/tree/main/backend/app/routers): `backend/app/routers`
- [Email delivery](https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/email_service.py): `backend/app/email_service.py`
- [Academic records](https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/models.py): `backend/app/models.py`
- [Database access](https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/database.py): `backend/app/database.py`
- [Runtime settings](https://github.com/bmynk/graduation-credit-tracker/blob/main/backend/app/config.py): `backend/app/config.py`

### Other components

- **Students**
- **Administrators**
- **Mailjet**
- **Tavily**

## Connections

- Students → Student app: use (evidence: `README.md`)
- Administrators → Admin app: use (evidence: `README.md`)
- Student app → API client: requests (evidence: `frontend/src/App.jsx`)
- Admin app → API client: requests
- API client → API application: calls API (evidence: `README.md`)
- API application → Authentication: registers (evidence: `backend/app/main.py`)
- API application → Domain APIs: registers (evidence: `backend/app/main.py`)
- Student app → Progress views: renders (evidence: `frontend/src/App.jsx`)
- Student app → Academic history: renders (evidence: `frontend/src/App.jsx`)
- Student app → Study planning: renders (evidence: `frontend/src/App.jsx`)
- Student app → Peer comparison: renders (evidence: `frontend/src/App.jsx`)
- Student app → Community: renders (evidence: `frontend/src/App.jsx`)
- Student app → Achievements: renders (evidence: `frontend/src/App.jsx`)
- Student app → Marcel assistant: renders (evidence: `frontend/src/App.jsx`)
- API client → Progress views: serves data
- Progress logic → Email delivery: calls (evidence: `backend/app/services/progress_service.py`)
- Progress logic → Academic records: reads records (evidence: `backend/app/services/progress_service.py`)
- Domain APIs → Support services: includes (evidence: `backend/app/main.py`)
- API application → Database access: creates tables (evidence: `backend/app/main.py`)
- Database access → Runtime settings: reads settings (evidence: `backend/app/database.py`)
- Academic records → Database access: defines tables (evidence: `backend/app/models.py`)
- Email delivery → Mailjet: sends email (evidence: `backend/app/email_service.py`)
- Web search → Tavily: searches web (evidence: `backend/app/services/web_search_service.py`)
- Assistant services → Web search: uses search (evidence: `backend/app/services/assistant_service.py`)
- Email delivery → Runtime settings: reads settings (evidence: `backend/app/email_service.py`)
- Web search → Runtime settings: reads settings (evidence: `backend/app/services/web_search_service.py`)
- Domain APIs → Progress logic: uses calculations (evidence: `backend/app/routers/admin.py`)
- Admin app → Grade prediction: offers
