# ahmed-alhiti/driving-license-issuance-management-system architecture

> Architecture diagram of the GitHub repository ahmed-alhiti/driving-license-issuance-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ahmed-alhiti/driving-license-issuance-management-system
- Repository: https://github.com/ahmed-alhiti/driving-license-issuance-management-system

## Overview

This is a WinForms driving-license administration system. Its user workflow starts at login, opens the management UI, and supports person/user administration, local applications and sequential examinations, license issuance and lifecycle operations, and international licensing. Business classes encapsulate domain operations; the ADO.NET data-access layer persists records in SQL Server. The README documents the three-tier design and broader capabilities, but many individual form-to-business calls are unsampled, so those subsystem links are shown as unverified rather than asserted.

Main entry points: [`Buisness/clsLocalDrivingLicense.cs`](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsLocalDrivingLicense.cs) (Local applications), [`Buisness/clsLicenses.cs`](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsLicenses.cs) (License lifecycle), [`frmManageLocalDVL.cs`](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/frmManageLocalDVL.cs) (Local application UI), [`DataAccessLayer/clsLicense.cs`](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/DataAccessLayer/clsLicense.cs) (License records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Presentation"]
  node_program["Application entry<br/>[Program.cs]"]
  node_login["Login<br/>[frmLogin.cs]"]
  node_main["Main workspace<br/>[MainForm.cs]"]
  node_management["Management forms"]
  node_local_ui["Local application UI"]
  node_exam_ui["Exam scheduling UI<br/>[frmSechduleTest.cs]"]
  node_license_ui["License operations UI<br/>[frmIssueDL.cs]"]
  node_international_ui["International license UI"]
end

subgraph group_domain["Business domain"]
  node_user_domain["Users and people<br/>[clsUsers.cs]"]
  node_application_domain["Applications<br/>[clsApplications.cs]"]
  node_local_domain["Local applications"]
  node_exam_domain["Exams and appointments<br/>[clsTests.cs]"]
  node_license_domain["License lifecycle<br/>[clsLicenses.cs]"]
  node_international_domain["International licenses"]
  node_detention_domain["Detention and release"]
end

subgraph group_persistence["Data access"]
  node_license_data["License records<br/>[clsLicense.cs]"]
  node_class_data["License classes<br/>[LicenseClass.cs]"]
  node_local_data["Local application records"]
  node_people_data["People records<br/>[clsPersonData.cs]"]
end

subgraph group_external["External systems"]
  node_sql[("SQL Server")]
end

node_operator(("Staff user"))

node_operator -->|"signs in"| node_login
node_program -->|"launches"| node_login
node_login -->|"opens"| node_main
node_local_ui -->|"opens dialogs"| node_local_ui
node_local_ui -.->|"uses operations"| node_local_domain
node_local_domain -->|"reads and writes"| node_local_data
node_local_domain -->|"creates license"| node_license_domain
node_license_domain -->|"persists licenses"| node_license_data
node_license_data -->|"uses class data"| node_class_data
node_people_data -->|"queries"| node_sql
node_local_data -->|"queries"| node_sql
node_license_data -->|"queries"| node_sql
node_management -.->|"uses operations"| node_user_domain
node_management -.->|"manages records"| node_people_data
node_exam_ui -.->|"schedules and records"| node_exam_domain
node_exam_domain -.->|"checks progression"| node_local_domain
node_license_ui -.->|"issues and renews"| node_license_domain
node_license_domain -.->|"supports detention"| node_detention_domain
node_international_ui -.->|"requests issuance"| node_international_domain
node_application_domain -.->|"supports applications"| node_local_domain

click node_program "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Program.cs"
click node_login "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/frmLogin.cs"
click node_main "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/MainForm.cs"
click node_management "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/frmPeopleManagement.cs"
click node_local_ui "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/frmManageLocalDVL.cs"
click node_exam_ui "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/frmSechduleTest.cs"
click node_license_ui "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/frmIssueDL.cs"
click node_international_ui "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/frmInternationalLicenseApplication.cs"
click node_user_domain "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsUsers.cs"
click node_application_domain "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsApplications.cs"
click node_local_domain "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsLocalDrivingLicense.cs"
click node_exam_domain "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsTests.cs"
click node_license_domain "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsLicenses.cs"
click node_international_domain "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsInternationalLicenses.cs"
click node_detention_domain "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsDetainedLicenses.cs"
click node_license_data "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/DataAccessLayer/clsLicense.cs"
click node_class_data "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/DataAccessLayer/LicenseClass.cs"
click node_local_data "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/DataAccessLayer/clsLocalDrivingLicenseApplicationData.cs"
click node_people_data "https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/DataAccessLayer/clsPersonData.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_program,node_login,node_main,node_management,node_local_ui,node_exam_ui,node_license_ui,node_international_ui,node_operator toneBlue
class node_user_domain,node_application_domain,node_local_domain,node_exam_domain,node_license_domain,node_international_domain,node_detention_domain toneAmber
class node_license_data,node_class_data,node_local_data,node_people_data toneMint
class node_sql toneRose
```

## Components

### Presentation

- [Application entry](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Program.cs): `Program.cs`
- [Login](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/frmLogin.cs): `frmLogin.cs`
- [Main workspace](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/MainForm.cs): `MainForm.cs`
- [Management forms](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/frmPeopleManagement.cs): `frmPeopleManagement.cs`
- [Local application UI](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/frmManageLocalDVL.cs): `frmManageLocalDVL.cs`
- [Exam scheduling UI](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/frmSechduleTest.cs): `frmSechduleTest.cs`
- [License operations UI](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/frmIssueDL.cs): `frmIssueDL.cs`
- [International license UI](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/frmInternationalLicenseApplication.cs): `frmInternationalLicenseApplication.cs`

### Business domain

- [Users and people](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsUsers.cs): `Buisness/clsUsers.cs`
- [Applications](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsApplications.cs): `Buisness/clsApplications.cs`
- [Local applications](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsLocalDrivingLicense.cs): `Buisness/clsLocalDrivingLicense.cs`
- [Exams and appointments](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsTests.cs): `Buisness/clsTests.cs`
- [License lifecycle](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsLicenses.cs): `Buisness/clsLicenses.cs`
- [International licenses](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsInternationalLicenses.cs): `Buisness/clsInternationalLicenses.cs`
- [Detention and release](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/Buisness/clsDetainedLicenses.cs): `Buisness/clsDetainedLicenses.cs`

### Data access

- [License records](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/DataAccessLayer/clsLicense.cs): `DataAccessLayer/clsLicense.cs`
- [License classes](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/DataAccessLayer/LicenseClass.cs): `DataAccessLayer/LicenseClass.cs`
- [Local application records](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/DataAccessLayer/clsLocalDrivingLicenseApplicationData.cs): `DataAccessLayer/clsLocalDrivingLicenseApplicationData.cs`
- [People records](https://github.com/ahmed-alhiti/driving-license-issuance-management-system/blob/main/DataAccessLayer/clsPersonData.cs): `DataAccessLayer/clsPersonData.cs`

### External systems

- **SQL Server**

### Other components

- **Staff user**

## Connections

- Staff user → Login: signs in
- Application entry → Login: launches (evidence: `Program.cs`)
- Login → Main workspace: opens (evidence: `frmLogin.cs`)
- Local application UI → Local application UI: opens dialogs (evidence: `frmManageLocalDVL.cs`)
- Local application UI → Local applications: uses operations
- Local applications → Local application records: reads and writes (evidence: `Buisness/clsLocalDrivingLicense.cs`)
- Local applications → License lifecycle: creates license (evidence: `Buisness/clsLocalDrivingLicense.cs`)
- License lifecycle → License records: persists licenses (evidence: `Buisness/clsLicenses.cs`)
- License records → License classes: uses class data (evidence: `DataAccessLayer/clsLicense.cs`)
- People records → SQL Server: queries (evidence: `DataAccessLayer/clsPersonData.cs`)
- Local application records → SQL Server: queries (evidence: `DataAccessLayer/clsLocalDrivingLicenseApplicationData.cs`)
- License records → SQL Server: queries (evidence: `DataAccessLayer/clsLicense.cs`)
- Management forms → Users and people: uses operations
- Management forms → People records: manages records
- Exam scheduling UI → Exams and appointments: schedules and records
- Exams and appointments → Local applications: checks progression
- License operations UI → License lifecycle: issues and renews
- License lifecycle → Detention and release: supports detention
- International license UI → International licenses: requests issuance
- Applications → Local applications: supports applications
