# widz-a/qlnckh architecture

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

- Interactive diagram: https://gitdiagram.com/widz-a/qlnckh
- Repository: https://github.com/widz-a/qlnckh

## Overview

QLNCKH is a Windows Forms application for managing academic research projects and student/faculty records. Users enter through the main navigation, manage research entities and category data, organize councils and submissions, record scores, and review or award results. The graph preserves the documented-by-source-index feature branches, including plagiarism records and council scoring. Source excerpts show repository and context behavior, but many form implementations were not sampled, so their internal workflows are represented only where the index names a relationship.

Main entry points: [`Forms/FrmMain.cs`](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmMain.cs) (Main navigation), [`Database/Repositories/Repository.cs`](https://github.com/widz-a/qlnckh/blob/main/Database/Repositories/Repository.cs) (Generic repository), [`Forms/FrmHome.cs`](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmHome.cs) (Home dashboard), [`Forms/FrmDeTaiEdit.cs`](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmDeTaiEdit.cs) (Project management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Navigation"]
  node_main["Main navigation<br/>[FrmMain.cs]"]
  node_home["Home dashboard<br/>[FrmHome.cs]"]
  node_lists["Entity lists<br/>[FrmList.cs]"]
end

subgraph group_records["Research records"]
  node_student["Student records<br/>[FrmSinhVienEdit.cs]"]
  node_faculty["Faculty records"]
  node_categories["Category management<br/>[DanhMucService.cs]"]
  node_category_ui["Category screens<br/>[FrmDanhMuc.cs]"]
  node_topic["Project management<br/>[FrmDeTaiEdit.cs]"]
  node_specialty["Specialty projects<br/>[FrmChuyenDeEdit.cs]"]
  node_submission["Project submissions<br/>[FrmNopDeTaiEdit.cs]"]
  node_plagiarism["Plagiarism checks<br/>[FrmDaoVanEdit.cs]"]
end

subgraph group_evaluation["Evaluation"]
  node_council["Council management<br/>[FrmHoiDongEdit.cs]"]
  node_scoring["Council scoring<br/>[FrmChamDiem.cs]"]
  node_score_project["Project scoring<br/>[FrmChamDiemDt.cs]"]
  node_score_dialog["Score entry<br/>[FrmDiem.cs]"]
  node_results["Results and awards<br/>[FrmKetQua.cs]"]
end

subgraph group_data["Persistence and models"]
  node_repo["Generic repository<br/>[Repository.cs]"]
  node_context["Entity Framework context<br/>[AppDbContext.cs]"]
  node_sql[("SQL Server database")]
  node_models["Domain entities<br/>[NCKH.cs]"]
end

subgraph group_shared["Shared UI logic"]
  node_validate["Input validation<br/>[ValidateHelper.cs]"]
  node_style["Grid and form styling<br/>[StyleHelper.cs]"]
end

node_user(("Staff user"))

node_user -->|"opens"| node_main
node_main -->|"shows"| node_home
node_main -->|"opens"| node_category_ui
node_main -->|"opens"| node_lists
node_main -->|"opens"| node_student
node_main -->|"opens"| node_faculty
node_main -->|"opens"| node_topic
node_main -->|"opens"| node_specialty
node_main -->|"opens"| node_submission
node_main -->|"opens"| node_plagiarism
node_main -->|"opens"| node_council
node_main -->|"opens"| node_scoring
node_main -->|"opens"| node_results
node_home -->|"opens"| node_topic
node_home -->|"opens"| node_specialty
node_home -->|"opens"| node_submission
node_home -->|"opens"| node_results
node_category_ui -->|"manages"| node_categories
node_topic -->|"reads and writes"| node_repo
node_topic -->|"loads categories"| node_categories
node_council -->|"reads and writes"| node_repo
node_scoring -->|"opens"| node_score_project
node_scoring -->|"reads and writes"| node_repo
node_score_project -->|"opens"| node_score_dialog
node_score_project -->|"reads and writes"| node_repo
node_results -->|"reads"| node_repo
node_repo -->|"creates"| node_context
node_categories -->|"creates"| node_context
node_context -->|"connects"| node_sql
node_context -->|"maps entities"| node_models
node_student -->|"validates"| node_validate
node_faculty -->|"validates"| node_validate
node_topic -->|"validates"| node_validate
node_lists -->|"styles grids"| node_style

click node_main "https://github.com/widz-a/qlnckh/blob/main/Forms/FrmMain.cs"
click node_home "https://github.com/widz-a/qlnckh/blob/main/Forms/FrmHome.cs"
click node_lists "https://github.com/widz-a/qlnckh/blob/main/Forms/List/FrmList.cs"
click node_student "https://github.com/widz-a/qlnckh/blob/main/Forms/FrmSinhVienEdit.cs"
click node_faculty "https://github.com/widz-a/qlnckh/blob/main/Forms/FrmGiangVienEdit.cs"
click node_categories "https://github.com/widz-a/qlnckh/blob/main/Database/DanhMucService.cs"
click node_category_ui "https://github.com/widz-a/qlnckh/blob/main/Forms/FrmDanhMuc.cs"
click node_topic "https://github.com/widz-a/qlnckh/blob/main/Forms/FrmDeTaiEdit.cs"
click node_specialty "https://github.com/widz-a/qlnckh/blob/main/Forms/FrmChuyenDeEdit.cs"
click node_submission "https://github.com/widz-a/qlnckh/blob/main/Forms/FrmNopDeTaiEdit.cs"
click node_plagiarism "https://github.com/widz-a/qlnckh/blob/main/Forms/FrmDaoVanEdit.cs"
click node_council "https://github.com/widz-a/qlnckh/blob/main/Forms/FrmHoiDongEdit.cs"
click node_scoring "https://github.com/widz-a/qlnckh/blob/main/Forms/FrmChamDiem.cs"
click node_score_project "https://github.com/widz-a/qlnckh/blob/main/Forms/ChamDiem/FrmChamDiemDt.cs"
click node_score_dialog "https://github.com/widz-a/qlnckh/blob/main/Forms/ChamDiem/FrmDiem.cs"
click node_results "https://github.com/widz-a/qlnckh/blob/main/Forms/FrmKetQua.cs"
click node_repo "https://github.com/widz-a/qlnckh/blob/main/Database/Repositories/Repository.cs"
click node_context "https://github.com/widz-a/qlnckh/blob/main/Database/AppDbContext.cs"
click node_models "https://github.com/widz-a/qlnckh/blob/main/Models/NCKH.cs"
click node_validate "https://github.com/widz-a/qlnckh/blob/main/Helpers/ValidateHelper.cs"
click node_style "https://github.com/widz-a/qlnckh/blob/main/Helpers/StyleHelper.cs"

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_home,node_lists,node_user toneBlue
class node_student,node_faculty,node_categories,node_category_ui,node_topic,node_specialty,node_submission,node_plagiarism toneAmber
class node_council,node_scoring,node_score_project,node_score_dialog,node_results toneMint
class node_repo,node_context,node_sql,node_models toneRose
class node_validate,node_style toneIndigo
```

## Components

### Navigation

- [Main navigation](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmMain.cs): `Forms/FrmMain.cs`
- [Home dashboard](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmHome.cs): `Forms/FrmHome.cs`
- [Entity lists](https://github.com/widz-a/qlnckh/blob/main/Forms/List/FrmList.cs): `Forms/List/FrmList.cs`

### Research records

- [Student records](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmSinhVienEdit.cs): `Forms/FrmSinhVienEdit.cs`
- [Faculty records](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmGiangVienEdit.cs): `Forms/FrmGiangVienEdit.cs`
- [Category management](https://github.com/widz-a/qlnckh/blob/main/Database/DanhMucService.cs): `Database/DanhMucService.cs`
- [Category screens](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmDanhMuc.cs): `Forms/FrmDanhMuc.cs`
- [Project management](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmDeTaiEdit.cs): `Forms/FrmDeTaiEdit.cs`
- [Specialty projects](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmChuyenDeEdit.cs): `Forms/FrmChuyenDeEdit.cs`
- [Project submissions](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmNopDeTaiEdit.cs): `Forms/FrmNopDeTaiEdit.cs`
- [Plagiarism checks](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmDaoVanEdit.cs): `Forms/FrmDaoVanEdit.cs`

### Evaluation

- [Council management](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmHoiDongEdit.cs): `Forms/FrmHoiDongEdit.cs`
- [Council scoring](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmChamDiem.cs): `Forms/FrmChamDiem.cs`
- [Project scoring](https://github.com/widz-a/qlnckh/blob/main/Forms/ChamDiem/FrmChamDiemDt.cs): `Forms/ChamDiem/FrmChamDiemDt.cs`
- [Score entry](https://github.com/widz-a/qlnckh/blob/main/Forms/ChamDiem/FrmDiem.cs): `Forms/ChamDiem/FrmDiem.cs`
- [Results and awards](https://github.com/widz-a/qlnckh/blob/main/Forms/FrmKetQua.cs): `Forms/FrmKetQua.cs`

### Persistence and models

- [Generic repository](https://github.com/widz-a/qlnckh/blob/main/Database/Repositories/Repository.cs): `Database/Repositories/Repository.cs`
- [Entity Framework context](https://github.com/widz-a/qlnckh/blob/main/Database/AppDbContext.cs): `Database/AppDbContext.cs`
- **SQL Server database**
- [Domain entities](https://github.com/widz-a/qlnckh/blob/main/Models/NCKH.cs): `Models/NCKH.cs`

### Shared UI logic

- [Input validation](https://github.com/widz-a/qlnckh/blob/main/Helpers/ValidateHelper.cs): `Helpers/ValidateHelper.cs`
- [Grid and form styling](https://github.com/widz-a/qlnckh/blob/main/Helpers/StyleHelper.cs): `Helpers/StyleHelper.cs`

### Other components

- **Staff user**

## Connections

- Staff user → Main navigation: opens
- Main navigation → Home dashboard: shows (evidence: `Forms/FrmMain.cs`)
- Main navigation → Category screens: opens (evidence: `Forms/FrmMain.cs`)
- Main navigation → Entity lists: opens (evidence: `Forms/FrmMain.cs`)
- Main navigation → Student records: opens (evidence: `Forms/FrmMain.cs`)
- Main navigation → Faculty records: opens (evidence: `Forms/FrmMain.cs`)
- Main navigation → Project management: opens (evidence: `Forms/FrmMain.cs`)
- Main navigation → Specialty projects: opens (evidence: `Forms/FrmMain.cs`)
- Main navigation → Project submissions: opens (evidence: `Forms/FrmMain.cs`)
- Main navigation → Plagiarism checks: opens (evidence: `Forms/FrmMain.cs`)
- Main navigation → Council management: opens (evidence: `Forms/FrmMain.cs`)
- Main navigation → Council scoring: opens (evidence: `Forms/FrmMain.cs`)
- Main navigation → Results and awards: opens (evidence: `Forms/FrmMain.cs`)
- Home dashboard → Project management: opens (evidence: `Forms/FrmHome.cs`)
- Home dashboard → Specialty projects: opens (evidence: `Forms/FrmHome.cs`)
- Home dashboard → Project submissions: opens (evidence: `Forms/FrmHome.cs`)
- Home dashboard → Results and awards: opens (evidence: `Forms/FrmHome.cs`)
- Category screens → Category management: manages (evidence: `Forms/FrmDanhMuc.cs`)
- Project management → Generic repository: reads and writes (evidence: `Forms/FrmDeTaiEdit.cs`)
- Project management → Category management: loads categories (evidence: `Forms/FrmDeTaiEdit.cs`)
- Council management → Generic repository: reads and writes (evidence: `Forms/FrmHoiDongEdit.cs`)
- Council scoring → Project scoring: opens (evidence: `Forms/FrmChamDiem.cs`)
- Council scoring → Generic repository: reads and writes (evidence: `Forms/FrmChamDiem.cs`)
- Project scoring → Score entry: opens (evidence: `Forms/ChamDiem/FrmChamDiemDt.cs`)
- Project scoring → Generic repository: reads and writes (evidence: `Forms/ChamDiem/FrmChamDiemDt.cs`)
- Results and awards → Generic repository: reads (evidence: `Forms/FrmKetQua.cs`)
- Generic repository → Entity Framework context: creates (evidence: `Database/Repositories/Repository.cs`)
- Category management → Entity Framework context: creates (evidence: `Database/DanhMucService.cs`)
- Entity Framework context → SQL Server database: connects (evidence: `Database/AppDbContext.cs`)
- Entity Framework context → Domain entities: maps entities (evidence: `Database/AppDbContext.cs`)
- Student records → Input validation: validates (evidence: `Forms/FrmSinhVienEdit.cs`)
- Faculty records → Input validation: validates (evidence: `Forms/FrmGiangVienEdit.cs`)
- Project management → Input validation: validates (evidence: `Forms/FrmDeTaiEdit.cs`)
- Entity lists → Grid and form styling: styles grids (evidence: `Forms/List/FrmList.cs`)
