# faresamy/dvld-system architecture

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

- Interactive diagram: https://gitdiagram.com/faresamy/dvld-system
- Repository: https://github.com/faresamy/dvld-system

## Overview

DVLD is a C# desktop licensing-management system. Its documented operator workflow covers sign-in and administration, then citizen and application processing through staged tests, license issuance, and detention or release; the README also describes driver histories and international licenses. The supplied tree contains only business and data-access projects, not the Windows Forms presentation layer or database schema, so the UI entry points and several cross-domain links cannot be traced. Sampled source confirms selected business-to-data calls; other branches are documented capabilities, not inspected implementations.

Main entry points: [`DVLD-Data Access Layer`](https://github.com/faresamy/dvld-system/tree/master/DVLD-Data%20Access%20Layer) (SQL Data Access), [`DVLD-BusinessLayer/clsPerson.cs`](https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsPerson.cs) (People Registry), [`DVLD-BusinessLayer/clsUser.cs`](https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsUser.cs) (User Accounts), [`DVLD-BusinessLayer/clsLocalDrivingLicenseApplications.cs`](https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsLocalDrivingLicenseApplications.cs) (Local Applications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_domain["Business Services"]
  node_people["People Registry<br/>[clsPerson.cs]"]
  node_users["User Accounts<br/>[clsUser.cs]"]
  node_applications["Applications<br/>[clsApplication.cs]"]
  node_localapps["Local Applications"]
  node_appointments["Test Appointments"]
  node_testresults["Test Results<br/>[clsTests.cs]"]
  node_drivers["Driver Records<br/>[clsDriver.cs]"]
  node_licenses["Local Licenses<br/>[clsLicense.cs]"]
  node_intl["International Licenses"]
  node_detained["Detained Licenses"]
end

subgraph group_data["Data Access"]
  node_dal["SQL Data Access"]
end

node_operator(("System Operator"))
node_database[("SQL Server")]

node_operator -.->|"authenticates"| node_users
node_operator -.->|"manages people"| node_people
node_operator -.->|"processes requests"| node_applications
node_people -->|"reads and saves"| node_dal
node_licenses -->|"reads and saves"| node_dal
node_appointments -->|"reads and saves"| node_dal
node_intl -->|"reads and saves"| node_dal
node_dal -->|"queries"| node_database
node_localapps -.->|"persists applications"| node_dal
node_testresults -.->|"persists results"| node_dal
node_users -.->|"persists accounts"| node_dal
node_drivers -.->|"loads history"| node_dal
node_detained -.->|"persists detention"| node_dal

click node_people "https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsPerson.cs"
click node_users "https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsUser.cs"
click node_applications "https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsApplication.cs"
click node_localapps "https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsLocalDrivingLicenseApplications.cs"
click node_appointments "https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsAppoimentsTest.cs"
click node_testresults "https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsTests.cs"
click node_drivers "https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsDriver.cs"
click node_licenses "https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsLicense.cs"
click node_intl "https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsInternationalLicense.cs"
click node_detained "https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsDetainedLicense.cs"
click node_dal "https://github.com/faresamy/dvld-system/tree/master/DVLD-Data%20Access%20Layer"

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_people,node_users,node_applications,node_localapps,node_appointments,node_testresults,node_drivers,node_licenses,node_intl,node_detained toneBlue
class node_dal,node_database toneAmber
class node_operator toneIndigo
```

## Components

### Business Services

- [People Registry](https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsPerson.cs): `DVLD-BusinessLayer/clsPerson.cs`
- [User Accounts](https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsUser.cs): `DVLD-BusinessLayer/clsUser.cs`
- [Applications](https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsApplication.cs): `DVLD-BusinessLayer/clsApplication.cs`
- [Local Applications](https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsLocalDrivingLicenseApplications.cs): `DVLD-BusinessLayer/clsLocalDrivingLicenseApplications.cs`
- [Test Appointments](https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsAppoimentsTest.cs): `DVLD-BusinessLayer/clsAppoimentsTest.cs`
- [Test Results](https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsTests.cs): `DVLD-BusinessLayer/clsTests.cs`
- [Driver Records](https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsDriver.cs): `DVLD-BusinessLayer/clsDriver.cs`
- [Local Licenses](https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsLicense.cs): `DVLD-BusinessLayer/clsLicense.cs`
- [International Licenses](https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsInternationalLicense.cs): `DVLD-BusinessLayer/clsInternationalLicense.cs`
- [Detained Licenses](https://github.com/faresamy/dvld-system/blob/master/DVLD-BusinessLayer/clsDetainedLicense.cs): `DVLD-BusinessLayer/clsDetainedLicense.cs`

### Data Access

- [SQL Data Access](https://github.com/faresamy/dvld-system/tree/master/DVLD-Data%20Access%20Layer): `DVLD-Data Access Layer`

### Other components

- **System Operator**
- **SQL Server**

## Connections

- System Operator → User Accounts: authenticates (evidence: `README.md`)
- System Operator → People Registry: manages people (evidence: `README.md`)
- System Operator → Applications: processes requests (evidence: `README.md`)
- People Registry → SQL Data Access: reads and saves (evidence: `DVLD-BusinessLayer/clsPerson.cs`)
- Local Licenses → SQL Data Access: reads and saves (evidence: `DVLD-BusinessLayer/clsLicense.cs`)
- Test Appointments → SQL Data Access: reads and saves (evidence: `DVLD-BusinessLayer/clsAppoimentsTest.cs`)
- International Licenses → SQL Data Access: reads and saves (evidence: `DVLD-BusinessLayer/clsInternationalLicense.cs`)
- SQL Data Access → SQL Server: queries (evidence: `DVLD-Data Access Layer/clsPersonData.cs`)
- Local Applications → SQL Data Access: persists applications
- Test Results → SQL Data Access: persists results
- User Accounts → SQL Data Access: persists accounts
- Driver Records → SQL Data Access: loads history
- Detained Licenses → SQL Data Access: persists detention
