# mohammed-jalamneh/dvld architecture

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

- Interactive diagram: https://gitdiagram.com/mohammed-jalamneh/dvld
- Repository: https://github.com/mohammed-jalamneh/dvld

## Overview

DVLD is a Windows desktop application for managing people, users, driver licensing applications, tests, and license services. Its main workflow starts at login, enters a tabbed management screen, and branches into licensing and administrative tasks; licensing includes local and international applications, tests, renewals, replacements, detention, and release. The sampled people workflow shows a form calling business logic and business logic calling SQL data access. Several licensing and administration modules are present in the tree but were not sampled, so their internal call relationships are not asserted.

Main entry points: [`DVLD/Applications/Driving Licenses Services/frmDrivingLicensesServices.cs`](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Driving%20Licenses%20Services/frmDrivingLicensesServices.cs) (License Services Menu), [`DVLD/MainScreen/frmMainScreen.cs`](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/MainScreen/frmMainScreen.cs) (Tabbed Main Screen), [`DVLD/Login/frmLogicScreen.cs`](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Login/frmLogicScreen.cs) (User Login), [`DVLD/Applications/ServicesDashboard.cs`](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/ServicesDashboard.cs) (Services Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and Navigation"]
  node_startup["Application Startup<br/>[Program.cs]"]
  node_login["User Login<br/>[frmLogicScreen.cs]"]
  node_main["Tabbed Main Screen<br/>[frmMainScreen.cs]"]
  node_dashboard["Services Dashboard"]
end

subgraph group_licensing["Licensing Workflows"]
  node_service_menu["License Services Menu"]
  node_local_app["Local License Application"]
  node_local_management["Local Application Management"]
  node_license_issue["License Issuance<br/>[frmIssueLicense.cs]"]
  node_international["International Licenses"]
  node_renew["License Renewal"]
  node_replacement["License Replacement"]
  node_detention["License Detention"]
  node_detained_management["Detained License Management"]
  node_release["License Release"]
end

subgraph group_administration["People and Administration"]
  node_people["People Management<br/>[frmPeople.cs]"]
  node_person_editor["Person Editor<br/>[frmAddNewPeople.cs]"]
  node_drivers["Driver Directory<br/>[frmDrivers.cs]"]
  node_users["User Directory<br/>[frmUsers.cs]"]
  node_user_editor["User Editor<br/>[AddEditUser.cs]"]
end

subgraph group_business["Business Logic"]
  node_people_logic["People Business Logic<br/>[clsPeopleB.cs]"]
  node_users_logic["User Business Logic<br/>[clsUsersB.cs]"]
end

subgraph group_data["Data Access"]
  node_people_access["People SQL Access<br/>[clsPeopleDA.cs]"]
  node_sql_store[("SQL Database")]
end

node_operator(("Operator"))

node_operator -->|"signs in"| node_login
node_startup -->|"launches"| node_login
node_login -->|"checks credentials"| node_users_logic
node_login -->|"opens"| node_main
node_main -->|"shows initially"| node_dashboard
node_main -->|"opens tab"| node_people
node_main -->|"opens tab"| node_drivers
node_main -->|"opens tab"| node_users
node_dashboard -->|"opens services"| node_service_menu
node_dashboard -->|"opens management"| node_detained_management
node_service_menu -->|"opens dialog"| node_local_app
node_service_menu -->|"embeds view"| node_local_management
node_service_menu -->|"opens dialog"| node_renew
node_service_menu -->|"opens dialog"| node_international
node_service_menu -->|"opens dialog"| node_detention
node_service_menu -->|"opens dialog"| node_release
node_person_editor -->|"loads and saves"| node_people_logic
node_people_logic -->|"reads and writes"| node_people_access
node_people_access -->|"queries database"| node_sql_store
node_users -->|"opens editor"| node_user_editor

click node_startup "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Program.ccs/Program.cs"
click node_login "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Login/frmLogicScreen.cs"
click node_main "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/MainScreen/frmMainScreen.cs"
click node_dashboard "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/ServicesDashboard.cs"
click node_service_menu "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Driving%20Licenses%20Services/frmDrivingLicensesServices.cs"
click node_local_app "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Manage%20Applications/Manage%20Local%20License/Local%20License/frmAddUpdateNewLocalDrivingLicenseApplication.cs"
click node_local_management "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Manage%20Applications/Manage%20Local%20License/Local%20License/frmManageLocalDrivingLicenseApplication.cs.cs"
click node_license_issue "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Manage%20Applications/Manage%20Local%20License/License/frmIssueLicense.cs"
click node_international "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Manage%20Applications/Manage%20International%20License/frmAddEditInternationalLicense.cs"
click node_renew "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Driving%20Licenses%20Services/Renew%20Driver%20License/frmRenewDriverLicense.cs"
click node_replacement "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Driving%20Licenses%20Services/Damaged%20or%20Lost%20License%20Replacement/frmDamagedOrLostLicenseReplacement.cs"
click node_detention "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Driving%20Licenses%20Services/Detain%20and%20Release%20Licneses/frmDetainLicense.cs"
click node_detained_management "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Driving%20Licenses%20Services/Detain%20and%20Release%20Licneses/frmManageDetainedLicneses.cs"
click node_release "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Driving%20Licenses%20Services/Detain%20and%20Release%20Licneses/frmReleaseDetainedLicense.cs"
click node_people "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/People/frmPeople.cs"
click node_person_editor "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/People/frmAddNewPeople.cs"
click node_drivers "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Drivers/frmDrivers.cs"
click node_users "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Users/frmUsers.cs"
click node_user_editor "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Users/AddEditUser.cs"
click node_people_logic "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD_Business/clsPeopleB.cs"
click node_users_logic "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD_Business/clsUsersB.cs"
click node_people_access "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD_DataAccess/clsPeopleDA.cs"
click node_sql_store "https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD_DataAccess/clsDataAccessSettings.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_startup,node_login,node_main,node_dashboard toneBlue
class node_service_menu,node_local_app,node_local_management,node_license_issue,node_international,node_renew,node_replacement,node_detention,node_detained_management,node_release toneAmber
class node_people,node_person_editor,node_drivers,node_users,node_user_editor toneMint
class node_people_logic,node_users_logic toneRose
class node_people_access,node_sql_store,node_operator toneIndigo
```

## Components

### Entry and Navigation

- [Application Startup](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Program.ccs/Program.cs): `DVLD/Program.ccs/Program.cs`
- [User Login](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Login/frmLogicScreen.cs): `DVLD/Login/frmLogicScreen.cs`
- [Tabbed Main Screen](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/MainScreen/frmMainScreen.cs): `DVLD/MainScreen/frmMainScreen.cs`
- [Services Dashboard](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/ServicesDashboard.cs): `DVLD/Applications/ServicesDashboard.cs`

### Licensing Workflows

- [License Services Menu](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Driving%20Licenses%20Services/frmDrivingLicensesServices.cs): `DVLD/Applications/Driving Licenses Services/frmDrivingLicensesServices.cs`
- [Local License Application](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Manage%20Applications/Manage%20Local%20License/Local%20License/frmAddUpdateNewLocalDrivingLicenseApplication.cs): `DVLD/Applications/Manage Applications/Manage Local License/Local License/frmAddUpdateNewLocalDrivingLicenseApplication.cs`
- [Local Application Management](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Manage%20Applications/Manage%20Local%20License/Local%20License/frmManageLocalDrivingLicenseApplication.cs.cs): `DVLD/Applications/Manage Applications/Manage Local License/Local License/frmManageLocalDrivingLicenseApplication.cs.cs`
- [License Issuance](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Manage%20Applications/Manage%20Local%20License/License/frmIssueLicense.cs): `DVLD/Applications/Manage Applications/Manage Local License/License/frmIssueLicense.cs`
- [International Licenses](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Manage%20Applications/Manage%20International%20License/frmAddEditInternationalLicense.cs): `DVLD/Applications/Manage Applications/Manage International License/frmAddEditInternationalLicense.cs`
- [License Renewal](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Driving%20Licenses%20Services/Renew%20Driver%20License/frmRenewDriverLicense.cs): `DVLD/Applications/Driving Licenses Services/Renew Driver License/frmRenewDriverLicense.cs`
- [License Replacement](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Driving%20Licenses%20Services/Damaged%20or%20Lost%20License%20Replacement/frmDamagedOrLostLicenseReplacement.cs): `DVLD/Applications/Driving Licenses Services/Damaged or Lost License Replacement/frmDamagedOrLostLicenseReplacement.cs`
- [License Detention](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Driving%20Licenses%20Services/Detain%20and%20Release%20Licneses/frmDetainLicense.cs): `DVLD/Applications/Driving Licenses Services/Detain and Release Licneses/frmDetainLicense.cs`
- [Detained License Management](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Driving%20Licenses%20Services/Detain%20and%20Release%20Licneses/frmManageDetainedLicneses.cs): `DVLD/Applications/Driving Licenses Services/Detain and Release Licneses/frmManageDetainedLicneses.cs`
- [License Release](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Applications/Driving%20Licenses%20Services/Detain%20and%20Release%20Licneses/frmReleaseDetainedLicense.cs): `DVLD/Applications/Driving Licenses Services/Detain and Release Licneses/frmReleaseDetainedLicense.cs`

### People and Administration

- [People Management](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/People/frmPeople.cs): `DVLD/People/frmPeople.cs`
- [Person Editor](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/People/frmAddNewPeople.cs): `DVLD/People/frmAddNewPeople.cs`
- [Driver Directory](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Drivers/frmDrivers.cs): `DVLD/Drivers/frmDrivers.cs`
- [User Directory](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Users/frmUsers.cs): `DVLD/Users/frmUsers.cs`
- [User Editor](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD/Users/AddEditUser.cs): `DVLD/Users/AddEditUser.cs`

### Business Logic

- [People Business Logic](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD_Business/clsPeopleB.cs): `DVLD_Business/clsPeopleB.cs`
- [User Business Logic](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD_Business/clsUsersB.cs): `DVLD_Business/clsUsersB.cs`

### Data Access

- [People SQL Access](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD_DataAccess/clsPeopleDA.cs): `DVLD_DataAccess/clsPeopleDA.cs`
- [SQL Database](https://github.com/mohammed-jalamneh/dvld/blob/master/DVLD_DataAccess/clsDataAccessSettings.cs): `DVLD_DataAccess/clsDataAccessSettings.cs`

### Other components

- **Operator**

## Connections

- Operator → User Login: signs in (evidence: `DVLD/Login/frmLogicScreen.cs`)
- Application Startup → User Login: launches (evidence: `DVLD/Program.ccs/Program.cs`)
- User Login → User Business Logic: checks credentials (evidence: `DVLD/Login/frmLogicScreen.cs`)
- User Login → Tabbed Main Screen: opens (evidence: `DVLD/Login/frmLogicScreen.cs`)
- Tabbed Main Screen → Services Dashboard: shows initially (evidence: `DVLD/MainScreen/frmMainScreen.cs`)
- Tabbed Main Screen → People Management: opens tab (evidence: `DVLD/MainScreen/frmMainScreen.cs`)
- Tabbed Main Screen → Driver Directory: opens tab (evidence: `DVLD/MainScreen/frmMainScreen.cs`)
- Tabbed Main Screen → User Directory: opens tab (evidence: `DVLD/MainScreen/frmMainScreen.cs`)
- Services Dashboard → License Services Menu: opens services (evidence: `DVLD/Applications/ServicesDashboard.cs`)
- Services Dashboard → Detained License Management: opens management (evidence: `DVLD/Applications/ServicesDashboard.cs`)
- License Services Menu → Local License Application: opens dialog (evidence: `DVLD/Applications/Driving Licenses Services/frmDrivingLicensesServices.cs`)
- License Services Menu → Local Application Management: embeds view (evidence: `DVLD/Applications/Driving Licenses Services/frmDrivingLicensesServices.cs`)
- License Services Menu → License Renewal: opens dialog (evidence: `DVLD/Applications/Driving Licenses Services/frmDrivingLicensesServices.cs`)
- License Services Menu → International Licenses: opens dialog (evidence: `DVLD/Applications/Driving Licenses Services/frmDrivingLicensesServices.cs`)
- License Services Menu → License Detention: opens dialog (evidence: `DVLD/Applications/Driving Licenses Services/frmDrivingLicensesServices.cs`)
- License Services Menu → License Release: opens dialog (evidence: `DVLD/Applications/Driving Licenses Services/frmDrivingLicensesServices.cs`)
- Person Editor → People Business Logic: loads and saves (evidence: `DVLD/People/frmAddNewPeople.cs`)
- People Business Logic → People SQL Access: reads and writes (evidence: `DVLD_Business/clsPeopleB.cs`)
- People SQL Access → SQL Database: queries database (evidence: `DVLD_DataAccess/clsPeopleDA.cs`)
- User Directory → User Editor: opens editor (evidence: `DVLD/Users/frmUsers.cs`)
