# eliasjoby/urban-smart-parking-system architecture

> Architecture diagram of the GitHub repository eliasjoby/urban-smart-parking-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/eliasjoby/urban-smart-parking-system
- Repository: https://github.com/eliasjoby/urban-smart-parking-system

## Overview

Urban Smart Parking is a role-based web application for driver parking and administrative operations. Drivers sign up or log in, register vehicles, find lots and slots, reserve parking, release slots, and view sessions and dues. Administrators manage users, lots, slot configuration and status, sessions, and dues. The server handles API operations and fee/session logic against a MySQL database. The map follows README capabilities where source excerpts are incomplete; unsampled endpoint implementations are represented only at the server subsystem level.

Main entry points: [`server/server.js`](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js) (Express API server), [`public/js/driver.js`](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/public/js/driver.js) (Driver portal), [`public/js/admin.js`](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/public/js/admin.js) (Admin portal), [`public/js/login.js`](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/public/js/login.js) (Login and signup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_login["Login and signup<br/>[login.js]"]
  node_sharedclient["Shared client services<br/>[main.js]"]
end

subgraph group_parking["Parking operations"]
  node_driverportal["Driver portal<br/>[driver.js]"]
  node_authapi["Authentication API<br/>[server.js]"]
  node_vehicles["Vehicle registration<br/>[server.js]"]
  node_lotdiscovery["Lot and slot discovery<br/>[server.js]"]
  node_reservations["Reservations<br/>[server.js]"]
  node_sessionrelease["Release and fee tracking<br/>[server.js]"]
  node_driverrecords["Sessions and dues views<br/>[driver.js]"]
end

subgraph group_adminops["Administration"]
  node_adminportal["Admin portal<br/>[admin.js]"]
  node_lotmanagement["Lot management<br/>[server.js]"]
  node_slotmanagement["Slot configuration and overrides<br/>[server.js]"]
  node_useradministration["User and vehicle administration<br/>[server.js]"]
  node_sessionreporting["Session history and reports<br/>[server.js]"]
  node_duesadministration["Dues administration<br/>[server.js]"]
end

subgraph group_persistence["Persistence"]
  node_api["Express API server<br/>[server.js]"]
  node_dbaccess["Database pool and schema<br/>[database.js]"]
end

node_driver(("Driver"))
node_administrator(("Administrator"))
node_mysql[("MySQL database")]

node_driver -->|"signs in"| node_login
node_administrator -->|"signs in"| node_login
node_login -->|"submits credentials"| node_authapi
node_login -->|"routes by role"| node_driverportal
node_login -->|"routes by role"| node_adminportal
node_driver -->|"uses"| node_driverportal
node_administrator -->|"uses"| node_adminportal
node_driverportal -.->|"uses API helper"| node_sharedclient
node_adminportal -.->|"uses API helper"| node_sharedclient
node_driverportal -->|"manages vehicles"| node_vehicles
node_driverportal -->|"loads lots and slots"| node_lotdiscovery
node_driverportal -->|"submits reservation"| node_reservations
node_driverportal -->|"releases slot"| node_sessionrelease
node_driverportal -->|"refreshes views"| node_driverrecords
node_adminportal -->|"manages lots"| node_lotmanagement
node_adminportal -->|"manages slots"| node_slotmanagement
node_adminportal -->|"manages users"| node_useradministration
node_adminportal -->|"loads sessions"| node_sessionreporting
node_administrator -->|"sets user dues"| node_duesadministration
node_authapi -->|"is served by"| node_api
node_vehicles -->|"is served by"| node_api
node_lotdiscovery -->|"is served by"| node_api
node_reservations -->|"is served by"| node_api
node_sessionrelease -->|"is served by"| node_api
node_lotmanagement -->|"is served by"| node_api
node_slotmanagement -->|"is served by"| node_api
node_useradministration -->|"is served by"| node_api
node_sessionreporting -->|"is served by"| node_api
node_duesadministration -.->|"is served by"| node_api
node_api -->|"queries through"| node_dbaccess
node_dbaccess -->|"connects to"| node_mysql

click node_login "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/public/js/login.js"
click node_sharedclient "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/public/js/main.js"
click node_driverportal "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/public/js/driver.js"
click node_authapi "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js"
click node_vehicles "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js"
click node_lotdiscovery "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js"
click node_reservations "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js"
click node_sessionrelease "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js"
click node_driverrecords "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/public/js/driver.js"
click node_adminportal "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/public/js/admin.js"
click node_lotmanagement "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js"
click node_slotmanagement "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js"
click node_useradministration "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js"
click node_sessionreporting "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js"
click node_duesadministration "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js"
click node_api "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js"
click node_dbaccess "https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/database.js"

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,node_sharedclient toneBlue
class node_driverportal,node_authapi,node_vehicles,node_lotdiscovery,node_reservations,node_sessionrelease,node_driverrecords,node_mysql toneAmber
class node_adminportal,node_lotmanagement,node_slotmanagement,node_useradministration,node_sessionreporting,node_duesadministration toneMint
class node_api,node_dbaccess toneRose
class node_driver,node_administrator toneIndigo
```

## Components

### Web client

- [Login and signup](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/public/js/login.js): `public/js/login.js`
- [Shared client services](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/public/js/main.js): `public/js/main.js`

### Parking operations

- [Driver portal](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/public/js/driver.js): `public/js/driver.js`
- [Authentication API](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js): `server/server.js`
- [Vehicle registration](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js): `server/server.js`
- [Lot and slot discovery](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js): `server/server.js`
- [Reservations](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js): `server/server.js`
- [Release and fee tracking](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js): `server/server.js`
- [Sessions and dues views](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/public/js/driver.js): `public/js/driver.js`

### Administration

- [Admin portal](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/public/js/admin.js): `public/js/admin.js`
- [Lot management](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js): `server/server.js`
- [Slot configuration and overrides](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js): `server/server.js`
- [User and vehicle administration](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js): `server/server.js`
- [Session history and reports](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js): `server/server.js`
- [Dues administration](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js): `server/server.js`

### Persistence

- [Express API server](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/server.js): `server/server.js`
- [Database pool and schema](https://github.com/eliasjoby/urban-smart-parking-system/blob/main/server/database.js): `server/database.js`

### Other components

- **Driver**
- **Administrator**
- **MySQL database**

## Connections

- Driver → Login and signup: signs in (evidence: `README.md`)
- Administrator → Login and signup: signs in (evidence: `README.md`)
- Login and signup → Authentication API: submits credentials (evidence: `public/js/login.js`)
- Login and signup → Driver portal: routes by role (evidence: `public/js/login.js`)
- Login and signup → Admin portal: routes by role (evidence: `public/js/login.js`)
- Driver → Driver portal: uses (evidence: `README.md`)
- Administrator → Admin portal: uses (evidence: `README.md`)
- Driver portal → Shared client services: uses API helper
- Admin portal → Shared client services: uses API helper
- Driver portal → Vehicle registration: manages vehicles (evidence: `public/js/driver.js`)
- Driver portal → Lot and slot discovery: loads lots and slots (evidence: `public/js/driver.js`)
- Driver portal → Reservations: submits reservation (evidence: `public/js/driver.js`)
- Driver portal → Release and fee tracking: releases slot (evidence: `public/js/driver.js`)
- Driver portal → Sessions and dues views: refreshes views (evidence: `public/js/driver.js`)
- Admin portal → Lot management: manages lots (evidence: `public/js/admin.js`)
- Admin portal → Slot configuration and overrides: manages slots (evidence: `public/js/admin.js`)
- Admin portal → User and vehicle administration: manages users (evidence: `public/js/admin.js`)
- Admin portal → Session history and reports: loads sessions (evidence: `public/js/admin.js`)
- Administrator → Dues administration: sets user dues (evidence: `README.md`)
- Authentication API → Express API server: is served by (evidence: `server/server.js`)
- Vehicle registration → Express API server: is served by (evidence: `server/server.js`)
- Lot and slot discovery → Express API server: is served by (evidence: `server/server.js`)
- Reservations → Express API server: is served by (evidence: `server/server.js`)
- Release and fee tracking → Express API server: is served by (evidence: `server/server.js`)
- Lot management → Express API server: is served by (evidence: `server/server.js`)
- Slot configuration and overrides → Express API server: is served by (evidence: `server/server.js`)
- User and vehicle administration → Express API server: is served by (evidence: `server/server.js`)
- Session history and reports → Express API server: is served by (evidence: `server/server.js`)
- Dues administration → Express API server: is served by (evidence: `server/server.js`)
- Express API server → Database pool and schema: queries through (evidence: `server/server.js`)
- Database pool and schema → MySQL database: connects to (evidence: `README.md`)
