# n-elhamidi/driver-license-management architecture

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

- Interactive diagram: https://gitdiagram.com/n-elhamidi/driver-license-management
- Repository: https://github.com/n-elhamidi/driver-license-management

## Overview

DVLD is a Windows Forms desktop application for driver- and vehicle-license management, according to the README. The visible workflow starts the app, opens the People list, and loads person records through a business wrapper and SQL data-access layer. An add/edit person form exists, but the sampled code only sets its date-of-birth limit; it does not show saving or how the form is opened. License and vehicle-management capabilities are documented, but their implementation is not present in the supplied tree. Edges reflect shown calls; database details beyond the data-access queries are not inferred.

Main entry points: [`DVLD_DataAccess/clsPersonData.cs`](https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD_DataAccess/clsPersonData.cs) (Person Data Access), [`DVLD/Program.cs`](https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD/Program.cs) (App Startup), [`DVLD/frmMain.cs`](https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD/frmMain.cs) (Main Window), [`DVLD/People/frmListPeople.cs`](https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD/People/frmListPeople.cs) (People List)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop UI"]
  node_startup["App Startup<br/>[Program.cs]"]
  node_main["Main Window<br/>[frmMain.cs]"]
end

subgraph group_people["People Management"]
  node_people_list["People List<br/>[frmListPeople.cs]"]
  node_person_editor["Person Editor"]
  node_person_service["Person Service<br/>[clsPerson.cs]"]
end

subgraph group_data["Data Access"]
  node_person_data["Person Data Access<br/>[clsPersonData.cs]"]
  node_db_settings["Connection Settings"]
end

node_user(("User"))
node_sql_server[("SQL Server")]

node_user -->|"launches"| node_startup
node_startup -->|"runs"| node_main
node_main -->|"opens"| node_people_list
node_people_list -->|"loads people"| node_person_service
node_person_service -->|"gets people"| node_person_data
node_person_data -->|"reads connection"| node_db_settings
node_person_data -->|"queries records"| node_sql_server

click node_startup "https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD/Program.cs"
click node_main "https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD/frmMain.cs"
click node_people_list "https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD/People/frmListPeople.cs"
click node_person_editor "https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD/People/frmAddEditPerson.cs"
click node_person_service "https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD_Business/clsPerson.cs"
click node_person_data "https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD_DataAccess/clsPersonData.cs"
click node_db_settings "https://github.com/n-elhamidi/driver-license-management/blob/main/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_main,node_user toneBlue
class node_people_list,node_person_editor,node_person_service,node_sql_server toneAmber
class node_person_data,node_db_settings toneMint
```

## Components

### Desktop UI

- [App Startup](https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD/Program.cs): `DVLD/Program.cs`
- [Main Window](https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD/frmMain.cs): `DVLD/frmMain.cs`

### People Management

- [People List](https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD/People/frmListPeople.cs): `DVLD/People/frmListPeople.cs`
- [Person Editor](https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD/People/frmAddEditPerson.cs): `DVLD/People/frmAddEditPerson.cs`
- [Person Service](https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD_Business/clsPerson.cs): `DVLD_Business/clsPerson.cs`

### Data Access

- [Person Data Access](https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD_DataAccess/clsPersonData.cs): `DVLD_DataAccess/clsPersonData.cs`
- [Connection Settings](https://github.com/n-elhamidi/driver-license-management/blob/main/DVLD_DataAccess/clsDataAccessSettings.cs): `DVLD_DataAccess/clsDataAccessSettings.cs`

### Other components

- **User**
- **SQL Server**

## Connections

- User → App Startup: launches (evidence: `DVLD/Program.cs`)
- App Startup → Main Window: runs (evidence: `DVLD/Program.cs`)
- Main Window → People List: opens (evidence: `DVLD/frmMain.cs`)
- People List → Person Service: loads people (evidence: `DVLD/People/frmListPeople.cs`)
- Person Service → Person Data Access: gets people (evidence: `DVLD_Business/clsPerson.cs`)
- Person Data Access → Connection Settings: reads connection (evidence: `DVLD_DataAccess/clsPersonData.cs`)
- Person Data Access → SQL Server: queries records (evidence: `DVLD_DataAccess/clsPersonData.cs`)
