# erandime/delivery-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/erandime/delivery-management-system
- Repository: https://github.com/erandime/delivery-management-system

## Overview

This PHP delivery-management system gives dispatchers a login-protected dashboard and delivery list, where they can inspect deliveries, filter/search/sort the list, view driver details, and assign available drivers. The principal workflow loads delivery and driver data, presents it in the delivery view, then sends assignment requests to the controller, which updates assignments and driver quotas. Login is a separate credential-validation and session flow. The sampled files show these paths; broader documented capabilities are not inferred beyond the visible dashboard and delivery-management features.

Main entry points: [`01_src/controller/deliverycontroller.php`](https://github.com/erandime/delivery-management-system/blob/main/01_src/controller/deliverycontroller.php) (Delivery operations), [`01_src/controller/logincontroller.php`](https://github.com/erandime/delivery-management-system/blob/main/01_src/controller/logincontroller.php) (Login handling), [`01_src/model/loginmodel.php`](https://github.com/erandime/delivery-management-system/blob/main/01_src/model/loginmodel.php) (Credential validation), [`01_src/view/delivery.php`](https://github.com/erandime/delivery-management-system/blob/main/01_src/view/delivery.php) (Delivery list view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and dashboard"]
  node_login_view["Login form<br/>[login.php]"]
  node_login_controller["Login handling"]
  node_login_model["Credential validation<br/>[loginmodel.php]"]
  node_homepage["Dispatcher dashboard<br/>[homepage.php]"]
end

subgraph group_dispatch["Delivery dispatch"]
  node_delivery_view["Delivery list view<br/>[delivery.php]"]
  node_delivery_controller["Delivery operations"]
  node_delivery_model["Delivery queries<br/>[deliverymodel.php]"]
  node_browser_scripts["List interactions<br/>[scripts.js]"]
end

subgraph group_persistence["Persistence"]
  node_db_connection["Database connection<br/>[dbconnection.php]"]
  node_database[("Application database")]
end

node_dispatcher(("Dispatcher"))

node_dispatcher -->|"opens"| node_login_view
node_login_view -->|"submits credentials"| node_login_controller
node_login_controller -->|"validates credentials"| node_login_model
node_login_controller -->|"redirects on success"| node_homepage
node_homepage -->|"links to list"| node_delivery_view
node_delivery_view -->|"includes"| node_delivery_controller
node_delivery_controller -->|"loads data"| node_delivery_model
node_delivery_view -->|"loads interactions"| node_browser_scripts
node_browser_scripts -->|"posts actions"| node_delivery_controller
node_login_model -->|"initializes"| node_db_connection
node_delivery_model -->|"initializes"| node_db_connection
node_db_connection -->|"connects"| node_database
node_login_model -->|"queries credentials"| node_database
node_delivery_model -->|"queries deliveries and drivers"| node_database
node_delivery_controller -->|"updates assignments and quotas"| node_database

click node_login_view "https://github.com/erandime/delivery-management-system/blob/main/01_src/view/login.php"
click node_login_controller "https://github.com/erandime/delivery-management-system/blob/main/01_src/controller/logincontroller.php"
click node_login_model "https://github.com/erandime/delivery-management-system/blob/main/01_src/model/loginmodel.php"
click node_homepage "https://github.com/erandime/delivery-management-system/blob/main/01_src/view/homepage.php"
click node_delivery_view "https://github.com/erandime/delivery-management-system/blob/main/01_src/view/delivery.php"
click node_delivery_controller "https://github.com/erandime/delivery-management-system/blob/main/01_src/controller/deliverycontroller.php"
click node_delivery_model "https://github.com/erandime/delivery-management-system/blob/main/01_src/model/deliverymodel.php"
click node_browser_scripts "https://github.com/erandime/delivery-management-system/blob/main/01_src/js/scripts.js"
click node_db_connection "https://github.com/erandime/delivery-management-system/blob/main/01_src/commons/dbconnection.php"

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_login_view,node_login_controller,node_login_model,node_homepage toneBlue
class node_delivery_view,node_delivery_controller,node_delivery_model,node_browser_scripts toneAmber
class node_db_connection,node_database toneMint
class node_dispatcher toneIndigo
```

## Components

### Access and dashboard

- [Login form](https://github.com/erandime/delivery-management-system/blob/main/01_src/view/login.php): `01_src/view/login.php`
- [Login handling](https://github.com/erandime/delivery-management-system/blob/main/01_src/controller/logincontroller.php): `01_src/controller/logincontroller.php`
- [Credential validation](https://github.com/erandime/delivery-management-system/blob/main/01_src/model/loginmodel.php): `01_src/model/loginmodel.php`
- [Dispatcher dashboard](https://github.com/erandime/delivery-management-system/blob/main/01_src/view/homepage.php): `01_src/view/homepage.php`

### Delivery dispatch

- [Delivery list view](https://github.com/erandime/delivery-management-system/blob/main/01_src/view/delivery.php): `01_src/view/delivery.php`
- [Delivery operations](https://github.com/erandime/delivery-management-system/blob/main/01_src/controller/deliverycontroller.php): `01_src/controller/deliverycontroller.php`
- [Delivery queries](https://github.com/erandime/delivery-management-system/blob/main/01_src/model/deliverymodel.php): `01_src/model/deliverymodel.php`
- [List interactions](https://github.com/erandime/delivery-management-system/blob/main/01_src/js/scripts.js): `01_src/js/scripts.js`

### Persistence

- [Database connection](https://github.com/erandime/delivery-management-system/blob/main/01_src/commons/dbconnection.php): `01_src/commons/dbconnection.php`
- **Application database**

### Other components

- **Dispatcher**

## Connections

- Dispatcher → Login form: opens (evidence: `01_src/view/login.php`)
- Login form → Login handling: submits credentials (evidence: `01_src/view/login.php`)
- Login handling → Credential validation: validates credentials (evidence: `01_src/controller/logincontroller.php`)
- Login handling → Dispatcher dashboard: redirects on success (evidence: `01_src/controller/logincontroller.php`)
- Dispatcher dashboard → Delivery list view: links to list (evidence: `01_src/view/homepage.php`)
- Delivery list view → Delivery operations: includes (evidence: `01_src/view/delivery.php`)
- Delivery operations → Delivery queries: loads data (evidence: `01_src/controller/deliverycontroller.php`)
- Delivery list view → List interactions: loads interactions (evidence: `01_src/view/delivery.php`)
- List interactions → Delivery operations: posts actions (evidence: `01_src/js/scripts.js`)
- Credential validation → Database connection: initializes (evidence: `01_src/model/loginmodel.php`)
- Delivery queries → Database connection: initializes (evidence: `01_src/model/deliverymodel.php`)
- Database connection → Application database: connects (evidence: `01_src/commons/dbconnection.php`)
- Credential validation → Application database: queries credentials (evidence: `01_src/model/loginmodel.php`)
- Delivery queries → Application database: queries deliveries and drivers (evidence: `01_src/model/deliverymodel.php`)
- Delivery operations → Application database: updates assignments and quotas (evidence: `01_src/controller/deliverycontroller.php`)
