# anthonyalperov/cpts322-gradetracker architecture

> Architecture diagram of the GitHub repository anthonyalperov/cpts322-gradetracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anthonyalperov/cpts322-gradetracker
- Repository: https://github.com/anthonyalperov/cpts322-gradetracker

## Overview

GradeTracker is a web-based student performance and feedback system. Instructors enter or update grades and provide feedback; students look up grades, review course progress, and set academic goals. The FastAPI application handles these requests and reads or writes the SQLite-backed records. The README also describes account, course, and assignment management, but the sampled implementation does not establish their routes or wiring. Login code expects an authentication API; its backend is not shown, so that integration is marked unverified.

Main entry points: [`code/backend/database.py`](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/database.py) (SQLite access), [`code/frontend/login.js`](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/frontend/login.js) (Login UI), [`code/frontend/student.js`](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/frontend/student.js) (Student dashboard), [`code/backend/main.py`](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/main.py) (FastAPI app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Web clients"]
  node_login_ui["Login UI<br/>[login.js]"]
  node_student_dashboard["Student dashboard<br/>[student.js]"]
  node_goals_ui["Goals panel<br/>[goals.js]"]
  node_instructor_grade_ui["Grade update UI<br/>[script.js]"]
end

subgraph group_api["Application API"]
  node_web_app["FastAPI app<br/>[main.py]"]
  node_grade_entry["Grade entry<br/>[main.py]"]
  node_grade_update["Grade updates<br/>[main.py]"]
  node_student_grades["Student grades<br/>[main.py]"]
  node_feedback["Instructor feedback<br/>[main.py]"]
  node_academic_goals["Academic goals<br/>[main.py]"]
  node_auth_api["Authentication API"]
end

subgraph group_records["Academic records"]
  node_db_access["SQLite access<br/>[database.py]"]
  node_grade_data[("GradeTracker database")]
end

subgraph group_documented["Documented capabilities"]
  node_course_management["Course management"]
  node_assignment_management["Assignment management"]
  node_account_management["Student and instructor accounts"]
end

node_student(("Student"))
node_instructor(("Instructor"))

node_student -->|"signs in"| node_login_ui
node_instructor -->|"signs in"| node_login_ui
node_login_ui -->|"opens dashboard"| node_web_app
node_login_ui -.->|"requests login"| node_auth_api
node_web_app -->|"serves page"| node_student_dashboard
node_web_app -->|"serves page"| node_instructor_grade_ui
node_student -->|"looks up grades"| node_student_dashboard
node_student_dashboard -->|"fetches grades"| node_student_grades
node_student_dashboard -->|"loads goals"| node_goals_ui
node_goals_ui -->|"loads and saves"| node_academic_goals
node_instructor -->|"updates grade"| node_instructor_grade_ui
node_instructor_grade_ui -->|"sends update"| node_grade_update
node_grade_entry -->|"queries records"| node_db_access
node_grade_update -->|"queries records"| node_db_access
node_student_grades -->|"queries grades"| node_db_access
node_feedback -->|"queries records"| node_db_access
node_academic_goals -->|"queries goals"| node_db_access
node_db_access -->|"reads and writes"| node_grade_data

click node_login_ui "https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/frontend/login.js"
click node_student_dashboard "https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/frontend/student.js"
click node_goals_ui "https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/frontend/goals.js"
click node_instructor_grade_ui "https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/frontend/script.js"
click node_web_app "https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/main.py"
click node_grade_entry "https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/main.py"
click node_grade_update "https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/main.py"
click node_student_grades "https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/main.py"
click node_feedback "https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/main.py"
click node_academic_goals "https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/main.py"
click node_db_access "https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/database.py"
click node_grade_data "https://github.com/anthonyalperov/cpts322-gradetracker/tree/main/data"
click node_course_management "https://github.com/anthonyalperov/cpts322-gradetracker/tree/main/code/backend"
click node_assignment_management "https://github.com/anthonyalperov/cpts322-gradetracker/tree/main/code/backend"
click node_account_management "https://github.com/anthonyalperov/cpts322-gradetracker/tree/main/code/backend"

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_login_ui,node_student_dashboard,node_goals_ui,node_instructor_grade_ui toneBlue
class node_web_app,node_grade_entry,node_grade_update,node_student_grades,node_feedback,node_academic_goals,node_auth_api toneAmber
class node_db_access,node_grade_data toneMint
class node_course_management,node_assignment_management,node_account_management toneRose
class node_student,node_instructor toneIndigo
```

## Components

### Web clients

- [Login UI](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/frontend/login.js): `code/frontend/login.js`
- [Student dashboard](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/frontend/student.js): `code/frontend/student.js`
- [Goals panel](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/frontend/goals.js): `code/frontend/goals.js`
- [Grade update UI](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/frontend/script.js): `code/frontend/script.js`

### Application API

- [FastAPI app](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/main.py): `code/backend/main.py`
- [Grade entry](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/main.py): `code/backend/main.py`
- [Grade updates](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/main.py): `code/backend/main.py`
- [Student grades](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/main.py): `code/backend/main.py`
- [Instructor feedback](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/main.py): `code/backend/main.py`
- [Academic goals](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/main.py): `code/backend/main.py`
- **Authentication API**

### Academic records

- [SQLite access](https://github.com/anthonyalperov/cpts322-gradetracker/blob/main/code/backend/database.py): `code/backend/database.py`
- [GradeTracker database](https://github.com/anthonyalperov/cpts322-gradetracker/tree/main/data): `data`

### Documented capabilities

- [Course management](https://github.com/anthonyalperov/cpts322-gradetracker/tree/main/code/backend): `code/backend`
- [Assignment management](https://github.com/anthonyalperov/cpts322-gradetracker/tree/main/code/backend): `code/backend`
- [Student and instructor accounts](https://github.com/anthonyalperov/cpts322-gradetracker/tree/main/code/backend): `code/backend`

### Other components

- **Student**
- **Instructor**

## Connections

- Student → Login UI: signs in (evidence: `code/frontend/login.js`)
- Instructor → Login UI: signs in (evidence: `code/frontend/login.js`)
- Login UI → FastAPI app: opens dashboard (evidence: `code/frontend/login.js`)
- Login UI → Authentication API: requests login
- FastAPI app → Student dashboard: serves page (evidence: `code/backend/main.py`)
- FastAPI app → Grade update UI: serves page (evidence: `code/backend/main.py`)
- Student → Student dashboard: looks up grades (evidence: `code/frontend/student.js`)
- Student dashboard → Student grades: fetches grades (evidence: `code/frontend/student.js`)
- Student dashboard → Goals panel: loads goals (evidence: `code/frontend/student.js`)
- Goals panel → Academic goals: loads and saves (evidence: `code/frontend/goals.js`)
- Instructor → Grade update UI: updates grade (evidence: `code/frontend/script.js`)
- Grade update UI → Grade updates: sends update (evidence: `code/frontend/script.js`)
- Grade entry → SQLite access: queries records (evidence: `code/backend/main.py`)
- Grade updates → SQLite access: queries records (evidence: `code/backend/main.py`)
- Student grades → SQLite access: queries grades (evidence: `code/backend/main.py`)
- Instructor feedback → SQLite access: queries records (evidence: `code/backend/main.py`)
- Academic goals → SQLite access: queries goals (evidence: `code/backend/main.py`)
- SQLite access → GradeTracker database: reads and writes (evidence: `code/backend/database.py`)
