# ducank06/qldiemjava architecture

> Architecture diagram of the GitHub repository ducank06/qldiemjava, 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/ducank06/qldiemjava
- Repository: https://github.com/ducank06/qldiemjava

## Overview

This is a Java Swing student-and-grade management application backed by MySQL. The main user journey is login, role-aware navigation, then student/course/class maintenance or grade entry; staff can also review cumulative credits and GPA and print a report. The UI panels issue SQL through a shared connection helper, while the schema supplies the relational model and grade rules. README documents account administration, password changes, role restrictions, and closed-term grade protection. Some panels are only partially excerpted, so their documented capabilities are retained without inferring unshown internal calls.

Main entry points: [`src/project_qldiem/KNCSDL.java`](https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/KNCSDL.java) (JDBC connection), [`src/project_qldiem/MainMenu.java`](https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/MainMenu.java) (Main menu), [`src/project_qldiem/BangDiem.java`](https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/BangDiem.java) (Grade entry), [`src/project_qldiem/ThongKe.java`](https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/ThongKe.java) (GPA and reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and navigation"]
  node_login["Sign-in<br/>[Login.java]"]
  node_main["Main menu<br/>[MainMenu.java]"]
  node_accounts["Account admin<br/>[HeThong.java]"]
end

subgraph group_records["Academic records"]
  node_records["Student and course records<br/>[QuanLy.java]"]
end

subgraph group_grading["Grade management"]
  node_marks["Grade entry<br/>[BangDiem.java]"]
  node_reports["GPA and reports<br/>[ThongKe.java]"]
end

subgraph group_platform["Persistence"]
  node_connection["JDBC connection<br/>[KNCSDL.java]"]
  node_mysql[("MySQL database<br/>[QLDiem_schema.sql]")]
end

node_user(("User"))

node_user -->|"signs in"| node_login
node_login -->|"opens on success"| node_main
node_main -->|"opens panel"| node_records
node_main -->|"opens panel"| node_accounts
node_main -->|"opens panel"| node_marks
node_main -->|"opens panel"| node_reports
node_user -->|"administers accounts"| node_accounts
node_user -->|"maintains records"| node_records
node_user -->|"enters grades"| node_marks
node_user -->|"views reports"| node_reports
node_login -->|"queries credentials"| node_connection
node_accounts -->|"accesses accounts"| node_connection
node_records -->|"loads and edits"| node_connection
node_marks -->|"reads and writes"| node_connection
node_reports -->|"queries GPA"| node_connection
node_connection -->|"opens JDBC connection"| node_mysql
node_mysql -->|"enforces term closure"| node_marks
node_mysql -->|"provides GPA view"| node_reports

click node_login "https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/Login.java"
click node_main "https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/MainMenu.java"
click node_accounts "https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/HeThong.java"
click node_records "https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/QuanLy.java"
click node_marks "https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/BangDiem.java"
click node_reports "https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/ThongKe.java"
click node_connection "https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/KNCSDL.java"
click node_mysql "https://github.com/ducank06/qldiemjava/blob/master/QLDiem_schema.sql"

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,node_main,node_accounts,node_user toneBlue
class node_records toneAmber
class node_marks,node_reports toneMint
class node_connection,node_mysql toneRose
```

## Components

### Access and navigation

- [Sign-in](https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/Login.java): `src/project_qldiem/Login.java`
- [Main menu](https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/MainMenu.java): `src/project_qldiem/MainMenu.java`
- [Account admin](https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/HeThong.java): `src/project_qldiem/HeThong.java`

### Academic records

- [Student and course records](https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/QuanLy.java): `src/project_qldiem/QuanLy.java`

### Grade management

- [Grade entry](https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/BangDiem.java): `src/project_qldiem/BangDiem.java`
- [GPA and reports](https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/ThongKe.java): `src/project_qldiem/ThongKe.java`

### Persistence

- [JDBC connection](https://github.com/ducank06/qldiemjava/blob/master/src/project_qldiem/KNCSDL.java): `src/project_qldiem/KNCSDL.java`
- [MySQL database](https://github.com/ducank06/qldiemjava/blob/master/QLDiem_schema.sql): `QLDiem_schema.sql`

### Other components

- **User**

## Connections

- User → Sign-in: signs in
- Sign-in → Main menu: opens on success (evidence: `src/project_qldiem/Login.java`)
- Main menu → Student and course records: opens panel (evidence: `src/project_qldiem/MainMenu.java`)
- Main menu → Account admin: opens panel (evidence: `src/project_qldiem/MainMenu.java`)
- Main menu → Grade entry: opens panel (evidence: `src/project_qldiem/MainMenu.java`)
- Main menu → GPA and reports: opens panel (evidence: `src/project_qldiem/MainMenu.java`)
- User → Account admin: administers accounts
- User → Student and course records: maintains records
- User → Grade entry: enters grades
- User → GPA and reports: views reports
- Sign-in → JDBC connection: queries credentials (evidence: `src/project_qldiem/Login.java`)
- Account admin → JDBC connection: accesses accounts (evidence: `src/project_qldiem/HeThong.java`)
- Student and course records → JDBC connection: loads and edits (evidence: `src/project_qldiem/QuanLy.java`)
- Grade entry → JDBC connection: reads and writes (evidence: `src/project_qldiem/BangDiem.java`)
- GPA and reports → JDBC connection: queries GPA (evidence: `src/project_qldiem/ThongKe.java`)
- JDBC connection → MySQL database: opens JDBC connection (evidence: `src/project_qldiem/KNCSDL.java`)
- MySQL database → Grade entry: enforces term closure
- MySQL database → GPA and reports: provides GPA view (evidence: `src/project_qldiem/ThongKe.java`)
