# bottledducky/gpu-utilization-manager-app architecture

> Architecture diagram of the GitHub repository bottledducky/gpu-utilization-manager-app, 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/bottledducky/gpu-utilization-manager-app
- Repository: https://github.com/bottledducky/gpu-utilization-manager-app

## Overview

This repository implements a desktop GPU-job scheduling simulator with student accounts, administrator controls, and simulated time. The user-facing workflow runs from registration and account approval through job-queue administration and monitoring; prediction and utilization provide operational views, while allowance models track GPU-time balances. The sampled dashboard and service code support those roles, and the source index documents additional backend and persistence links. The README is empty, and job-submission UI details were not sampled, so those relationships are not expanded here.

Main entry points: [`src/logic/AccountService.java`](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/AccountService.java) (Account service), [`src/ui/AdminDashboard.java`](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/AdminDashboard.java) (Admin dashboard), [`src/ui/RealAdminBackend.java`](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/RealAdminBackend.java) (Simulation backend), [`src/logic/PredictionService.java`](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/PredictionService.java) (Queue prediction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_main["Application entry<br/>[Main.java]"]
  node_login["Login<br/>[LoginFrame.java]"]
  node_registration["Registration"]
  node_dashboard["Admin dashboard"]
  node_backend_api["Backend interface<br/>[AdminBackend.java]"]
  node_real_backend["Simulation backend"]
  node_requests_ui["Request review<br/>[RequestsPanel.java]"]
  node_students_ui["Student management<br/>[StudentsPanel.java]"]
  node_jobs_ui["Job monitoring<br/>[AllJobsPanel.java]"]
end

subgraph group_services["Scheduling services"]
  node_accounts["Account service"]
  node_scheduler["Job scheduler<br/>[Scheduler.java]"]
  node_clock["Simulation clock"]
  node_prediction["Queue prediction"]
  node_utilization["Utilization metrics"]
  node_validation["Validation service"]
end

subgraph group_domain["Accounts and jobs"]
  node_allowance["GPU-time allowance<br/>[TimeAllowance.java]"]
  node_job["Job lifecycle<br/>[Job.java]"]
  node_gpu["GPU state<br/>[GPU.java]"]
  node_student["Student account<br/>[Student.java]"]
  node_access_request["Access request<br/>[AccessRequest.java]"]
  node_administrator_model["Administrator account<br/>[Administrator.java]"]
  node_time_grant["Time grant<br/>[TimeGrant.java]"]
  node_user["User identity<br/>[User.java]"]
end

subgraph group_persistence["Saved state"]
  node_data_store["Data store<br/>[DataStore.java]"]
  node_saved_state[("Saved state<br/>[SavedState.java]")]
end

node_admin(("Administrator"))

node_login -->|"authenticates with"| node_accounts
node_login -->|"opens"| node_registration
node_registration -->|"registers through"| node_accounts
node_dashboard -->|"queries and commands"| node_backend_api
node_dashboard -->|"computes forecasts"| node_prediction
node_dashboard -->|"computes metrics"| node_utilization
node_dashboard -->|"refreshes"| node_requests_ui
node_dashboard -->|"refreshes"| node_students_ui
node_dashboard -->|"refreshes"| node_jobs_ui
node_real_backend -->|"implements"| node_backend_api
node_real_backend -->|"delegates account actions"| node_accounts
node_real_backend -->|"delegates job actions"| node_scheduler
node_real_backend -->|"uses"| node_clock
node_scheduler -->|"advances simulation"| node_clock
node_accounts -->|"creates and checks"| node_student
node_accounts -->|"creates and reviews"| node_access_request
node_accounts -->|"authenticates"| node_administrator_model
node_accounts -->|"assigns on approval"| node_allowance
node_prediction -->|"reads queued jobs"| node_job
node_prediction -->|"reads GPU availability"| node_gpu
node_prediction -->|"reads current time"| node_clock
node_utilization -->|"reads job runtimes"| node_job
node_utilization -->|"counts busy GPUs"| node_gpu
node_utilization -->|"reads elapsed time"| node_clock
node_validation -->|"validates"| node_student
node_validation -->|"validates"| node_administrator_model
node_validation -->|"validates"| node_job
node_allowance -->|"records grants"| node_time_grant
node_allowance -->|"tracks reservations"| node_job
node_student -->|"extends"| node_user
node_administrator_model -->|"extends"| node_user
node_data_store -->|"uses"| node_saved_state

click node_main "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/app/Main.java"
click node_login "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/LoginFrame.java"
click node_registration "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/RegistrationPanel.java"
click node_dashboard "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/AdminDashboard.java"
click node_backend_api "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/AdminBackend.java"
click node_real_backend "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/RealAdminBackend.java"
click node_requests_ui "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/RequestsPanel.java"
click node_students_ui "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/StudentsPanel.java"
click node_jobs_ui "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/AllJobsPanel.java"
click node_accounts "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/AccountService.java"
click node_scheduler "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/Scheduler.java"
click node_clock "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/SimulationClock.java"
click node_prediction "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/PredictionService.java"
click node_utilization "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/UtilizationService.java"
click node_validation "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/ValidationService.java"
click node_allowance "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/TimeAllowance.java"
click node_job "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/Job.java"
click node_gpu "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/GPU.java"
click node_student "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/Student.java"
click node_access_request "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/AccessRequest.java"
click node_administrator_model "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/Administrator.java"
click node_time_grant "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/TimeGrant.java"
click node_user "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/User.java"
click node_data_store "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/storage/DataStore.java"
click node_saved_state "https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/storage/SavedState.java"

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_login,node_registration,node_dashboard,node_backend_api,node_real_backend,node_requests_ui,node_students_ui,node_jobs_ui toneBlue
class node_accounts,node_scheduler,node_clock,node_prediction,node_utilization,node_validation toneAmber
class node_allowance,node_job,node_gpu,node_student,node_access_request,node_administrator_model,node_time_grant,node_user toneMint
class node_data_store,node_saved_state toneRose
class node_admin toneIndigo
```

## Components

### Desktop interface

- [Application entry](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/app/Main.java): `src/app/Main.java`
- [Login](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/LoginFrame.java): `src/ui/LoginFrame.java`
- [Registration](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/RegistrationPanel.java): `src/ui/RegistrationPanel.java`
- [Admin dashboard](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/AdminDashboard.java): `src/ui/AdminDashboard.java`
- [Backend interface](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/AdminBackend.java): `src/ui/AdminBackend.java`
- [Simulation backend](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/RealAdminBackend.java): `src/ui/RealAdminBackend.java`
- [Request review](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/RequestsPanel.java): `src/ui/RequestsPanel.java`
- [Student management](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/StudentsPanel.java): `src/ui/StudentsPanel.java`
- [Job monitoring](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/ui/AllJobsPanel.java): `src/ui/AllJobsPanel.java`

### Scheduling services

- [Account service](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/AccountService.java): `src/logic/AccountService.java`
- [Job scheduler](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/Scheduler.java): `src/logic/Scheduler.java`
- [Simulation clock](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/SimulationClock.java): `src/logic/SimulationClock.java`
- [Queue prediction](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/PredictionService.java): `src/logic/PredictionService.java`
- [Utilization metrics](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/UtilizationService.java): `src/logic/UtilizationService.java`
- [Validation service](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/logic/ValidationService.java): `src/logic/ValidationService.java`

### Accounts and jobs

- [GPU-time allowance](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/TimeAllowance.java): `src/model/TimeAllowance.java`
- [Job lifecycle](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/Job.java): `src/model/Job.java`
- [GPU state](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/GPU.java): `src/model/GPU.java`
- [Student account](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/Student.java): `src/model/Student.java`
- [Access request](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/AccessRequest.java): `src/model/AccessRequest.java`
- [Administrator account](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/Administrator.java): `src/model/Administrator.java`
- [Time grant](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/TimeGrant.java): `src/model/TimeGrant.java`
- [User identity](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/model/User.java): `src/model/User.java`

### Saved state

- [Data store](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/storage/DataStore.java): `src/storage/DataStore.java`
- [Saved state](https://github.com/bottledducky/gpu-utilization-manager-app/blob/main/src/storage/SavedState.java): `src/storage/SavedState.java`

### Other components

- **Administrator**

## Connections

- Login → Account service: authenticates with (evidence: `src/ui/LoginFrame.java`)
- Login → Registration: opens (evidence: `src/ui/LoginFrame.java`)
- Registration → Account service: registers through (evidence: `src/ui/RegistrationPanel.java`)
- Admin dashboard → Backend interface: queries and commands (evidence: `src/ui/AdminDashboard.java`)
- Admin dashboard → Queue prediction: computes forecasts (evidence: `src/ui/AdminDashboard.java`)
- Admin dashboard → Utilization metrics: computes metrics (evidence: `src/ui/AdminDashboard.java`)
- Admin dashboard → Request review: refreshes (evidence: `src/ui/AdminDashboard.java`)
- Admin dashboard → Student management: refreshes (evidence: `src/ui/AdminDashboard.java`)
- Admin dashboard → Job monitoring: refreshes (evidence: `src/ui/AdminDashboard.java`)
- Simulation backend → Backend interface: implements (evidence: `src/ui/RealAdminBackend.java`)
- Simulation backend → Account service: delegates account actions (evidence: `src/ui/RealAdminBackend.java`)
- Simulation backend → Job scheduler: delegates job actions (evidence: `src/ui/RealAdminBackend.java`)
- Simulation backend → Simulation clock: uses (evidence: `src/ui/RealAdminBackend.java`)
- Job scheduler → Simulation clock: advances simulation (evidence: `src/logic/Scheduler.java`)
- Account service → Student account: creates and checks (evidence: `src/logic/AccountService.java`)
- Account service → Access request: creates and reviews (evidence: `src/logic/AccountService.java`)
- Account service → Administrator account: authenticates (evidence: `src/logic/AccountService.java`)
- Account service → GPU-time allowance: assigns on approval (evidence: `src/logic/AccountService.java`)
- Queue prediction → Job lifecycle: reads queued jobs (evidence: `src/logic/PredictionService.java`)
- Queue prediction → GPU state: reads GPU availability (evidence: `src/logic/PredictionService.java`)
- Queue prediction → Simulation clock: reads current time (evidence: `src/logic/PredictionService.java`)
- Utilization metrics → Job lifecycle: reads job runtimes (evidence: `src/logic/UtilizationService.java`)
- Utilization metrics → GPU state: counts busy GPUs (evidence: `src/logic/UtilizationService.java`)
- Utilization metrics → Simulation clock: reads elapsed time (evidence: `src/logic/UtilizationService.java`)
- Validation service → Student account: validates (evidence: `src/logic/ValidationService.java`)
- Validation service → Administrator account: validates (evidence: `src/logic/ValidationService.java`)
- Validation service → Job lifecycle: validates (evidence: `src/logic/ValidationService.java`)
- GPU-time allowance → Time grant: records grants (evidence: `src/model/TimeAllowance.java`)
- GPU-time allowance → Job lifecycle: tracks reservations (evidence: `src/model/TimeAllowance.java`)
- Student account → User identity: extends (evidence: `src/model/Student.java`)
- Administrator account → User identity: extends (evidence: `src/model/Administrator.java`)
- Data store → Saved state: uses (evidence: `src/storage/DataStore.java`)
