# minhquan-sv/quan-ly-nhan-su architecture

> Architecture diagram of the GitHub repository minhquan-sv/quan-ly-nhan-su, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/minhquan-sv/quan-ly-nhan-su
- Repository: https://github.com/minhquan-sv/quan-ly-nhan-su

## Overview

This is a Java Swing HR and attendance desktop application. A user signs in, then role-specific screens provide employee and account management, personal-profile access, and attendance actions; JDBC-backed DAOs read and update the database. Attendance calculations are a separate business layer. The graph preserves the documented director, manager, employee, and password-change capabilities. Some screens and DAO calls are supported only by the source index or README, so unsampled implementation details and uncertain links are omitted.

Main entry points: [`src/view/MainFrame.java`](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/MainFrame.java) (Role navigation), [`src/dao/NhanVienDAO.java`](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/dao/NhanVienDAO.java) (Employee data access), [`src/view/QuanLyChamCongPanel.java`](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/QuanLyChamCongPanel.java) (Team attendance), [`src/dao/TaiKhoanDAO.java`](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/dao/TaiKhoanDAO.java) (Account data access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and navigation"]
  node_main["Application entry<br/>[Main.java]"]
  node_login["Sign-in<br/>[LoginFrame.java]"]
  node_mainframe["Role navigation<br/>[MainFrame.java]"]
  node_password["Change password"]
end

subgraph group_workforce["Workforce management"]
  node_director["Director tools<br/>[GiamDocPanel.java]"]
  node_staff["Staff management<br/>[NhanVienPanel.java]"]
  node_staffform["Employee form"]
  node_profile["Personal profile"]
end

subgraph group_attendance["Attendance"]
  node_attendance_self["Personal attendance<br/>[ChamCongPanel.java]"]
  node_attendance_team["Team attendance"]
  node_attendance_rules["Attendance rules"]
end

subgraph group_data["Data and shared utilities"]
  node_staff_dao["Employee data access<br/>[NhanVienDAO.java]"]
  node_account_dao["Account data access<br/>[TaiKhoanDAO.java]"]
  node_attendance_dao["Attendance data access<br/>[ChamCongDAO.java]"]
  node_category_dao["Reference data access<br/>[DanhMucDAO.java]"]
  node_models["Domain records"]
  node_format["Vietnamese formatting<br/>[DinhDang.java]"]
  node_hash["Password hashing<br/>[MatKhau.java]"]
  node_connection["JDBC connection<br/>[KetNoiCSDL.java]"]
  node_database[("MySQL database<br/>[QuanLyNhanSu.sql]")]
end

node_user(("User"))

node_user -->|"signs in"| node_login
node_main -->|"opens"| node_login
node_login -->|"authenticates"| node_account_dao
node_login -->|"opens after login"| node_mainframe
node_mainframe -->|"routes by role"| node_director
node_mainframe -->|"routes by role"| node_staff
node_mainframe -->|"opens"| node_profile
node_mainframe -->|"opens"| node_attendance_self
node_mainframe -->|"opens"| node_attendance_team
node_mainframe -->|"opens"| node_password
node_director -->|"manages staff"| node_staff_dao
node_director -->|"loads references"| node_category_dao
node_director -->|"opens form"| node_staffform
node_staff -->|"manages staff"| node_staff_dao
node_staff -->|"loads references"| node_category_dao
node_staff -->|"opens form"| node_staffform
node_staffform -->|"saves employee"| node_staff_dao
node_staffform -->|"checks account"| node_account_dao
node_profile -->|"loads profile"| node_staff_dao
node_attendance_self -->|"records attendance"| node_attendance_dao
node_attendance_self -->|"loads shifts"| node_category_dao
node_attendance_self -->|"calculates status"| node_attendance_rules
node_attendance_team -->|"manages attendance"| node_attendance_dao
node_attendance_team -->|"loads employees"| node_staff_dao
node_attendance_team -->|"loads shifts"| node_category_dao
node_attendance_team -->|"calculates status"| node_attendance_rules
node_password -->|"updates password"| node_account_dao
node_account_dao -->|"checks and hashes"| node_hash
node_staff_dao -->|"hashes credentials"| node_hash
node_staff_dao -->|"opens JDBC"| node_connection
node_account_dao -->|"opens JDBC"| node_connection
node_attendance_dao -->|"opens JDBC"| node_connection
node_category_dao -->|"opens JDBC"| node_connection
node_connection -->|"connects via JDBC"| node_database

click node_main "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/Main.java"
click node_login "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/LoginFrame.java"
click node_mainframe "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/MainFrame.java"
click node_password "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/DoiMatKhauDialog.java"
click node_director "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/GiamDocPanel.java"
click node_staff "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/NhanVienPanel.java"
click node_staffform "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/NhanVienFormDialog.java"
click node_profile "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/ThongTinCaNhanPanel.java"
click node_attendance_self "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/ChamCongPanel.java"
click node_attendance_team "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/QuanLyChamCongPanel.java"
click node_attendance_rules "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/service/ChamCongService.java"
click node_staff_dao "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/dao/NhanVienDAO.java"
click node_account_dao "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/dao/TaiKhoanDAO.java"
click node_attendance_dao "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/dao/ChamCongDAO.java"
click node_category_dao "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/dao/DanhMucDAO.java"
click node_models "https://github.com/minhquan-sv/quan-ly-nhan-su/tree/main/src/model"
click node_format "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/util/DinhDang.java"
click node_hash "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/util/MatKhau.java"
click node_connection "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/util/KetNoiCSDL.java"
click node_database "https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/database/mysql/QuanLyNhanSu.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_main,node_login,node_mainframe,node_password,node_user toneBlue
class node_director,node_staff,node_staffform,node_profile toneAmber
class node_attendance_self,node_attendance_team,node_attendance_rules toneMint
class node_staff_dao,node_account_dao,node_attendance_dao,node_category_dao,node_models,node_format,node_hash,node_connection,node_database toneRose
```

## Components

### Access and navigation

- [Application entry](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/Main.java): `src/Main.java`
- [Sign-in](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/LoginFrame.java): `src/view/LoginFrame.java`
- [Role navigation](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/MainFrame.java): `src/view/MainFrame.java`
- [Change password](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/DoiMatKhauDialog.java): `src/view/DoiMatKhauDialog.java`

### Workforce management

- [Director tools](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/GiamDocPanel.java): `src/view/GiamDocPanel.java`
- [Staff management](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/NhanVienPanel.java): `src/view/NhanVienPanel.java`
- [Employee form](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/NhanVienFormDialog.java): `src/view/NhanVienFormDialog.java`
- [Personal profile](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/ThongTinCaNhanPanel.java): `src/view/ThongTinCaNhanPanel.java`

### Attendance

- [Personal attendance](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/ChamCongPanel.java): `src/view/ChamCongPanel.java`
- [Team attendance](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/view/QuanLyChamCongPanel.java): `src/view/QuanLyChamCongPanel.java`
- [Attendance rules](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/service/ChamCongService.java): `src/service/ChamCongService.java`

### Data and shared utilities

- [Employee data access](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/dao/NhanVienDAO.java): `src/dao/NhanVienDAO.java`
- [Account data access](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/dao/TaiKhoanDAO.java): `src/dao/TaiKhoanDAO.java`
- [Attendance data access](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/dao/ChamCongDAO.java): `src/dao/ChamCongDAO.java`
- [Reference data access](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/dao/DanhMucDAO.java): `src/dao/DanhMucDAO.java`
- [Domain records](https://github.com/minhquan-sv/quan-ly-nhan-su/tree/main/src/model): `src/model`
- [Vietnamese formatting](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/util/DinhDang.java): `src/util/DinhDang.java`
- [Password hashing](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/util/MatKhau.java): `src/util/MatKhau.java`
- [JDBC connection](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/src/util/KetNoiCSDL.java): `src/util/KetNoiCSDL.java`
- [MySQL database](https://github.com/minhquan-sv/quan-ly-nhan-su/blob/main/database/mysql/QuanLyNhanSu.sql): `database/mysql/QuanLyNhanSu.sql`

### Other components

- **User**

## Connections

- User → Sign-in: signs in (evidence: `README.md`)
- Application entry → Sign-in: opens (evidence: `src/Main.java`)
- Sign-in → Account data access: authenticates (evidence: `src/view/LoginFrame.java`)
- Sign-in → Role navigation: opens after login (evidence: `src/view/LoginFrame.java`)
- Role navigation → Director tools: routes by role (evidence: `src/view/MainFrame.java`)
- Role navigation → Staff management: routes by role (evidence: `src/view/MainFrame.java`)
- Role navigation → Personal profile: opens (evidence: `src/view/MainFrame.java`)
- Role navigation → Personal attendance: opens (evidence: `src/view/MainFrame.java`)
- Role navigation → Team attendance: opens (evidence: `src/view/MainFrame.java`)
- Role navigation → Change password: opens (evidence: `src/view/MainFrame.java`)
- Director tools → Employee data access: manages staff (evidence: `src/view/GiamDocPanel.java`)
- Director tools → Reference data access: loads references (evidence: `src/view/GiamDocPanel.java`)
- Director tools → Employee form: opens form (evidence: `src/view/GiamDocPanel.java`)
- Staff management → Employee data access: manages staff (evidence: `src/view/NhanVienPanel.java`)
- Staff management → Reference data access: loads references (evidence: `src/view/NhanVienPanel.java`)
- Staff management → Employee form: opens form (evidence: `src/view/NhanVienPanel.java`)
- Employee form → Employee data access: saves employee (evidence: `src/view/NhanVienFormDialog.java`)
- Employee form → Account data access: checks account (evidence: `src/view/NhanVienFormDialog.java`)
- Personal profile → Employee data access: loads profile (evidence: `src/view/ThongTinCaNhanPanel.java`)
- Personal attendance → Attendance data access: records attendance (evidence: `src/view/ChamCongPanel.java`)
- Personal attendance → Reference data access: loads shifts (evidence: `src/view/ChamCongPanel.java`)
- Personal attendance → Attendance rules: calculates status (evidence: `src/view/ChamCongPanel.java`)
- Team attendance → Attendance data access: manages attendance (evidence: `src/view/QuanLyChamCongPanel.java`)
- Team attendance → Employee data access: loads employees (evidence: `src/view/QuanLyChamCongPanel.java`)
- Team attendance → Reference data access: loads shifts (evidence: `src/view/QuanLyChamCongPanel.java`)
- Team attendance → Attendance rules: calculates status (evidence: `src/view/QuanLyChamCongPanel.java`)
- Change password → Account data access: updates password (evidence: `src/view/DoiMatKhauDialog.java`)
- Account data access → Password hashing: checks and hashes (evidence: `src/dao/TaiKhoanDAO.java`)
- Employee data access → Password hashing: hashes credentials (evidence: `src/dao/NhanVienDAO.java`)
- Employee data access → JDBC connection: opens JDBC (evidence: `src/dao/NhanVienDAO.java`)
- Account data access → JDBC connection: opens JDBC (evidence: `src/dao/TaiKhoanDAO.java`)
- Attendance data access → JDBC connection: opens JDBC (evidence: `src/dao/ChamCongDAO.java`)
- Reference data access → JDBC connection: opens JDBC (evidence: `src/dao/DanhMucDAO.java`)
- JDBC connection → MySQL database: connects via JDBC (evidence: `README.md`)
