# eidalhadidi/dvld architecture

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

## Overview

DVLD is a WinForms desktop system for managing driver records, applications, testing, and license services. Users sign in, reach the main menu, and enter workflows such as local-license applications, staged tests, and license issuance; the business layer applies domain operations and the data layer accesses SQL Server. The excerpts directly show startup, login, local-application scheduling, and several license-service actions. Other major capabilities are included as documented subsystems, but their internal calls are not inferred from unsampled code.

Main entry points: [`My DVLD/Main Menu/frmMainMenu.cs`](https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Main%20Menu/frmMainMenu.cs) (Main menu), [`Business/clsLocalDrivingLicenseApplication.cs`](https://github.com/eidalhadidi/dvld/blob/main/Business/clsLocalDrivingLicenseApplication.cs) (Local application rules), [`My DVLD/Login/frmLoginScreen.cs`](https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Login/frmLoginScreen.cs) (User sign-in), [`My DVLD/Local Driving License Application/frmManageLocalDrivingLicenseApplications.cs`](https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Local%20Driving%20License%20Application/frmManageLocalDrivingLicenseApplications.cs) (Local applications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Desktop workflows"]
  node_entry["Application startup<br/>[Program.cs]"]
  node_login["User sign-in<br/>[frmLoginScreen.cs]"]
  node_menu["Main menu<br/>[frmMainMenu.cs]"]
  node_people["People records"]
  node_users["User administration<br/>[frmManageUsers.cs]"]
  node_localui["Local applications"]
  node_tests["Test scheduling<br/>[frmScheduleTest.cs]"]
  node_internationalui["International issuance"]
  node_renew["License renewal"]
  node_replace["License replacement"]
  node_detain["Detain and release"]
end

subgraph group_domain["Business services"]
  node_localdomain["Local application rules"]
  node_persondomain["Person services<br/>[clsPerson.cs]"]
  node_applicationdomain["Application services<br/>[clsApplication.cs]"]
  node_license["License services<br/>[clsLicense.cs]"]
  node_international["International license service"]
  node_detained["Detained license service"]
  node_userdomain["User services<br/>[clsUser.cs]"]
end

subgraph group_data["Data access"]
  node_localdal["Local application storage"]
  node_applicationdal["Application storage"]
  node_peopledal["People storage<br/>[DAL_People.cs]"]
  node_database[("SQL Server")]
end

subgraph group_support["Identity and administration"]
end

node_operator(("Department staff"))

node_operator -->|"starts"| node_entry
node_entry -->|"opens"| node_login
node_login -->|"authenticates"| node_userdomain
node_login -->|"opens after login"| node_menu
node_menu -->|"opens"| node_people
node_menu -.->|"opens"| node_users
node_menu -->|"opens"| node_localui
node_menu -->|"opens"| node_internationalui
node_menu -->|"opens"| node_renew
node_menu -->|"opens"| node_replace
node_menu -.->|"opens"| node_detain
node_people -->|"saves records"| node_persondomain
node_localui -->|"opens appointments"| node_tests
node_localui -.->|"manages applications"| node_localdomain
node_tests -.->|"records outcomes"| node_localdomain
node_internationalui -.->|"issues license"| node_international
node_internationalui -.->|"creates application"| node_applicationdomain
node_renew -->|"creates renewed license"| node_license
node_renew -->|"creates application"| node_applicationdomain
node_replace -->|"creates replacement"| node_license
node_replace -->|"creates application"| node_applicationdomain
node_localdomain -->|"reads and writes"| node_localdal
node_localdomain -->|"deletes base application"| node_applicationdal
node_persondomain -.->|"persists people"| node_peopledal
node_localdal -->|"queries"| node_database
node_applicationdal -.->|"queries"| node_database
node_peopledal -.->|"queries"| node_database
node_userdomain -.->|"checks credentials"| node_database

click node_entry "https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Program.cs"
click node_login "https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Login/frmLoginScreen.cs"
click node_menu "https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Main%20Menu/frmMainMenu.cs"
click node_people "https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/People/frmAddEditPerson.cs"
click node_users "https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Users/frmManageUsers.cs"
click node_localui "https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Local%20Driving%20License%20Application/frmManageLocalDrivingLicenseApplications.cs"
click node_tests "https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Local%20Driving%20License%20Application/frmScheduleTest.cs"
click node_internationalui "https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/International%20Licenses/frmNewInternationalLicenseApplication.cs"
click node_renew "https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Renew%20Application/frmRenewLocalDrivingLicense.cs"
click node_replace "https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Replace%20Licenses/frmReplaceLicense.cs"
click node_detain "https://github.com/eidalhadidi/dvld/tree/main/My%20DVLD"
click node_localdomain "https://github.com/eidalhadidi/dvld/blob/main/Business/clsLocalDrivingLicenseApplication.cs"
click node_persondomain "https://github.com/eidalhadidi/dvld/blob/main/Business/clsPerson.cs"
click node_applicationdomain "https://github.com/eidalhadidi/dvld/blob/main/Business/clsApplication.cs"
click node_license "https://github.com/eidalhadidi/dvld/blob/main/Business/clsLicense.cs"
click node_international "https://github.com/eidalhadidi/dvld/blob/main/Business/clsInternationalLicense.cs"
click node_detained "https://github.com/eidalhadidi/dvld/blob/main/Business/clsDetainedLicense.cs"
click node_localdal "https://github.com/eidalhadidi/dvld/blob/main/Data/DAL_LocalDrivingLicenseApplications.cs"
click node_applicationdal "https://github.com/eidalhadidi/dvld/blob/main/Data/DAL_Applications.cs"
click node_peopledal "https://github.com/eidalhadidi/dvld/blob/main/Data/DAL_People.cs"
click node_userdomain "https://github.com/eidalhadidi/dvld/blob/main/Business/clsUser.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_entry,node_login,node_menu,node_people,node_users,node_localui,node_tests,node_internationalui,node_renew,node_replace,node_detain toneBlue
class node_localdomain,node_persondomain,node_applicationdomain,node_license,node_international,node_detained,node_userdomain toneAmber
class node_localdal,node_applicationdal,node_peopledal,node_database toneMint
class node_operator toneIndigo
```

## Components

### Desktop workflows

- [Application startup](https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Program.cs): `My DVLD/Program.cs`
- [User sign-in](https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Login/frmLoginScreen.cs): `My DVLD/Login/frmLoginScreen.cs`
- [Main menu](https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Main%20Menu/frmMainMenu.cs): `My DVLD/Main Menu/frmMainMenu.cs`
- [People records](https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/People/frmAddEditPerson.cs): `My DVLD/People/frmAddEditPerson.cs`
- [User administration](https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Users/frmManageUsers.cs): `My DVLD/Users/frmManageUsers.cs`
- [Local applications](https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Local%20Driving%20License%20Application/frmManageLocalDrivingLicenseApplications.cs): `My DVLD/Local Driving License Application/frmManageLocalDrivingLicenseApplications.cs`
- [Test scheduling](https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Local%20Driving%20License%20Application/frmScheduleTest.cs): `My DVLD/Local Driving License Application/frmScheduleTest.cs`
- [International issuance](https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/International%20Licenses/frmNewInternationalLicenseApplication.cs): `My DVLD/International Licenses/frmNewInternationalLicenseApplication.cs`
- [License renewal](https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Renew%20Application/frmRenewLocalDrivingLicense.cs): `My DVLD/Renew Application/frmRenewLocalDrivingLicense.cs`
- [License replacement](https://github.com/eidalhadidi/dvld/blob/main/My%20DVLD/Replace%20Licenses/frmReplaceLicense.cs): `My DVLD/Replace Licenses/frmReplaceLicense.cs`
- [Detain and release](https://github.com/eidalhadidi/dvld/tree/main/My%20DVLD): `My DVLD`

### Business services

- [Local application rules](https://github.com/eidalhadidi/dvld/blob/main/Business/clsLocalDrivingLicenseApplication.cs): `Business/clsLocalDrivingLicenseApplication.cs`
- [Person services](https://github.com/eidalhadidi/dvld/blob/main/Business/clsPerson.cs): `Business/clsPerson.cs`
- [Application services](https://github.com/eidalhadidi/dvld/blob/main/Business/clsApplication.cs): `Business/clsApplication.cs`
- [License services](https://github.com/eidalhadidi/dvld/blob/main/Business/clsLicense.cs): `Business/clsLicense.cs`
- [International license service](https://github.com/eidalhadidi/dvld/blob/main/Business/clsInternationalLicense.cs): `Business/clsInternationalLicense.cs`
- [Detained license service](https://github.com/eidalhadidi/dvld/blob/main/Business/clsDetainedLicense.cs): `Business/clsDetainedLicense.cs`
- [User services](https://github.com/eidalhadidi/dvld/blob/main/Business/clsUser.cs): `Business/clsUser.cs`

### Data access

- [Local application storage](https://github.com/eidalhadidi/dvld/blob/main/Data/DAL_LocalDrivingLicenseApplications.cs): `Data/DAL_LocalDrivingLicenseApplications.cs`
- [Application storage](https://github.com/eidalhadidi/dvld/blob/main/Data/DAL_Applications.cs): `Data/DAL_Applications.cs`
- [People storage](https://github.com/eidalhadidi/dvld/blob/main/Data/DAL_People.cs): `Data/DAL_People.cs`
- **SQL Server**

### Other components

- **Department staff**

## Connections

- Department staff → Application startup: starts
- Application startup → User sign-in: opens (evidence: `My DVLD/Program.cs`)
- User sign-in → User services: authenticates (evidence: `My DVLD/Login/frmLoginScreen.cs`)
- User sign-in → Main menu: opens after login (evidence: `My DVLD/Login/frmLoginScreen.cs`)
- Main menu → People records: opens (evidence: `My DVLD/Main Menu/frmMainMenu.cs`)
- Main menu → User administration: opens
- Main menu → Local applications: opens (evidence: `My DVLD/Main Menu/frmMainMenu.cs`)
- Main menu → International issuance: opens (evidence: `My DVLD/Main Menu/frmMainMenu.cs`)
- Main menu → License renewal: opens (evidence: `My DVLD/Main Menu/frmMainMenu.cs`)
- Main menu → License replacement: opens (evidence: `My DVLD/Main Menu/frmMainMenu.cs`)
- Main menu → Detain and release: opens
- People records → Person services: saves records (evidence: `My DVLD/People/frmAddEditPerson.cs`)
- Local applications → Test scheduling: opens appointments (evidence: `My DVLD/Local Driving License Application/frmManageLocalDrivingLicenseApplications.cs`)
- Local applications → Local application rules: manages applications
- Test scheduling → Local application rules: records outcomes
- International issuance → International license service: issues license
- International issuance → Application services: creates application
- License renewal → License services: creates renewed license (evidence: `My DVLD/Renew Application/frmRenewLocalDrivingLicense.cs`)
- License renewal → Application services: creates application (evidence: `My DVLD/Renew Application/frmRenewLocalDrivingLicense.cs`)
- License replacement → License services: creates replacement (evidence: `My DVLD/Replace Licenses/frmReplaceLicense.cs`)
- License replacement → Application services: creates application (evidence: `My DVLD/Replace Licenses/frmReplaceLicense.cs`)
- Local application rules → Local application storage: reads and writes (evidence: `Business/clsLocalDrivingLicenseApplication.cs`)
- Local application rules → Application storage: deletes base application (evidence: `Business/clsLocalDrivingLicenseApplication.cs`)
- Person services → People storage: persists people
- Local application storage → SQL Server: queries (evidence: `Data/DAL_LocalDrivingLicenseApplications.cs`)
- Application storage → SQL Server: queries
- People storage → SQL Server: queries
- User services → SQL Server: checks credentials
