# tsamouridis/uni-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/tsamouridis/uni-tracker
- Repository: https://github.com/tsamouridis/uni-tracker

## Overview

Uni-Tracker is a desktop university-progress tracker. The student’s first-run workflow is to enter profile and degree details, which are saved as settings; subsequent launches load saved courses into semesters and open the main window for browsing and course updates. Semester statistics are computed from grades, and a Python plotting script produces graph images. The sampled excerpts show startup, persistence, and statistics/plotting links; some course-editing UI details are omitted, so those links are based on the documented capabilities and visible GUI references.

Main entry points: [`src/Main.java`](https://github.com/tsamouridis/uni-tracker/blob/main/src/Main.java) (Application startup), [`src/MainGui.java`](https://github.com/tsamouridis/uni-tracker/blob/main/src/MainGui.java) (Main window), [`src/Course.java`](https://github.com/tsamouridis/uni-tracker/blob/main/src/Course.java) (Course records), [`src/StartGui.java`](https://github.com/tsamouridis/uni-tracker/blob/main/src/StartGui.java) (Profile setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup and setup"]
  node_main["Application startup<br/>[Main.java]"]
  node_onboarding["Profile setup<br/>[StartGui.java]"]
  node_settings["User settings<br/>[Settings.java]"]
  node_settingsfile[("Settings CSV<br/>[settings.csv]")]
end

subgraph group_courses["Course and semester domain"]
  node_semester["Semester records<br/>[Semester.java]"]
  node_course["Course records<br/>[Course.java]"]
  node_coursefiles[("Course CSV files")]
  node_coursenum[("Course count CSV<br/>[courseNum.csv]")]
end

subgraph group_presentation["Desktop interface"]
  node_maingui["Main window<br/>[MainGui.java]"]
end

subgraph group_analytics["Statistics and graphs"]
  node_statistics["Grade statistics<br/>[Statistics.java]"]
  node_plotter["Graph generation<br/>[plotter.py]"]
  node_images["Graph images"]
end

node_student(("Student"))

node_student -->|"launches"| node_main
node_main -->|"checks settings"| node_settings
node_main -->|"opens setup"| node_onboarding
node_onboarding -->|"saves profile"| node_settings
node_settings -->|"reads and writes"| node_settingsfile
node_main -->|"loads course count"| node_course
node_main -->|"reads course data"| node_coursefiles
node_main -->|"loads courses into"| node_semester
node_main -->|"opens main window"| node_maingui
node_onboarding -->|"loads course count"| node_course
node_onboarding -->|"loads courses into"| node_semester
node_onboarding -->|"opens main window"| node_maingui
node_course -->|"reads and writes"| node_coursefiles
node_course -->|"reads and updates"| node_coursenum
node_maingui -->|"reads appearance"| node_settings
node_maingui -->|"browses and updates"| node_semester
node_maingui -->|"edits course"| node_course
node_maingui -->|"shows statistics"| node_statistics
node_semester -->|"collects grades"| node_course
node_semester -->|"creates statistics"| node_statistics
node_statistics -->|"runs plotting script"| node_plotter
node_plotter -->|"writes graph images"| node_images

click node_main "https://github.com/tsamouridis/uni-tracker/blob/main/src/Main.java"
click node_onboarding "https://github.com/tsamouridis/uni-tracker/blob/main/src/StartGui.java"
click node_settings "https://github.com/tsamouridis/uni-tracker/blob/main/src/Settings.java"
click node_settingsfile "https://github.com/tsamouridis/uni-tracker/blob/main/csvFiles/settings.csv"
click node_maingui "https://github.com/tsamouridis/uni-tracker/blob/main/src/MainGui.java"
click node_semester "https://github.com/tsamouridis/uni-tracker/blob/main/src/Semester.java"
click node_course "https://github.com/tsamouridis/uni-tracker/blob/main/src/Course.java"
click node_coursefiles "https://github.com/tsamouridis/uni-tracker/tree/main/csvFiles"
click node_coursenum "https://github.com/tsamouridis/uni-tracker/blob/main/csvFiles/courseNum.csv"
click node_statistics "https://github.com/tsamouridis/uni-tracker/blob/main/src/Statistics.java"
click node_plotter "https://github.com/tsamouridis/uni-tracker/blob/main/src/plotter.py"
click node_images "https://github.com/tsamouridis/uni-tracker/tree/main/media"

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_main,node_onboarding,node_settings,node_settingsfile toneBlue
class node_semester,node_course,node_coursefiles,node_coursenum toneAmber
class node_maingui toneMint
class node_statistics,node_plotter,node_images toneRose
class node_student toneIndigo
```

## Components

### Startup and setup

- [Application startup](https://github.com/tsamouridis/uni-tracker/blob/main/src/Main.java): `src/Main.java`
- [Profile setup](https://github.com/tsamouridis/uni-tracker/blob/main/src/StartGui.java): `src/StartGui.java`
- [User settings](https://github.com/tsamouridis/uni-tracker/blob/main/src/Settings.java): `src/Settings.java`
- [Settings CSV](https://github.com/tsamouridis/uni-tracker/blob/main/csvFiles/settings.csv): `csvFiles/settings.csv`

### Course and semester domain

- [Semester records](https://github.com/tsamouridis/uni-tracker/blob/main/src/Semester.java): `src/Semester.java`
- [Course records](https://github.com/tsamouridis/uni-tracker/blob/main/src/Course.java): `src/Course.java`
- [Course CSV files](https://github.com/tsamouridis/uni-tracker/tree/main/csvFiles): `csvFiles`
- [Course count CSV](https://github.com/tsamouridis/uni-tracker/blob/main/csvFiles/courseNum.csv): `csvFiles/courseNum.csv`

### Desktop interface

- [Main window](https://github.com/tsamouridis/uni-tracker/blob/main/src/MainGui.java): `src/MainGui.java`

### Statistics and graphs

- [Grade statistics](https://github.com/tsamouridis/uni-tracker/blob/main/src/Statistics.java): `src/Statistics.java`
- [Graph generation](https://github.com/tsamouridis/uni-tracker/blob/main/src/plotter.py): `src/plotter.py`
- [Graph images](https://github.com/tsamouridis/uni-tracker/tree/main/media): `media`

### Other components

- **Student**

## Connections

- Student → Application startup: launches (evidence: `README.md`)
- Application startup → User settings: checks settings (evidence: `src/Main.java`)
- Application startup → Profile setup: opens setup (evidence: `src/Main.java`)
- Profile setup → User settings: saves profile (evidence: `src/StartGui.java`)
- User settings → Settings CSV: reads and writes (evidence: `src/Settings.java`)
- Application startup → Course records: loads course count (evidence: `src/Main.java`)
- Application startup → Course CSV files: reads course data (evidence: `src/Main.java`)
- Application startup → Semester records: loads courses into (evidence: `src/Main.java`)
- Application startup → Main window: opens main window (evidence: `src/Main.java`)
- Profile setup → Course records: loads course count (evidence: `src/StartGui.java`)
- Profile setup → Semester records: loads courses into (evidence: `src/StartGui.java`)
- Profile setup → Main window: opens main window (evidence: `src/StartGui.java`)
- Course records → Course CSV files: reads and writes (evidence: `src/Course.java`)
- Course records → Course count CSV: reads and updates (evidence: `src/Course.java`)
- Main window → User settings: reads appearance (evidence: `src/MainGui.java`)
- Main window → Semester records: browses and updates (evidence: `src/MainGui.java`)
- Main window → Course records: edits course (evidence: `src/MainGui.java`)
- Main window → Grade statistics: shows statistics (evidence: `src/MainGui.java`)
- Semester records → Course records: collects grades (evidence: `src/Semester.java`)
- Semester records → Grade statistics: creates statistics (evidence: `src/Semester.java`)
- Grade statistics → Graph generation: runs plotting script (evidence: `src/Statistics.java`)
- Graph generation → Graph images: writes graph images (evidence: `src/plotter.py`)
