# falloudev190/parking architecture

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

- Interactive diagram: https://gitdiagram.com/falloudev190/parking
- Repository: https://github.com/falloudev190/parking

## Overview

This PHP application supports parking operations: authenticated users enter through the front controller, which dispatches page requests to controllers that coordinate parking domain models and views. Distinct workflows cover space/zone management, reservations, visitor tickets and vehicle journal entries, subscriptions, payments, alerts, user administration, reporting and configuration. The database layer is visible, but many controller implementations were not excerpted; their model/view links are supported by the SOURCE INDEX references, while unverified payment-gateway wiring is left out.

Main entry points: [`smart-parking/index.php`](https://github.com/falloudev190/parking/blob/main/smart-parking/index.php) (Front controller), [`smart-parking/controllers/DashboardController.php`](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/DashboardController.php) (Operations dashboard), [`smart-parking/controllers/VisiteurController.php`](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/VisiteurController.php) (Visitor parking), [`smart-parking/controllers/ReservationController.php`](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/ReservationController.php) (Reservations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Request and access"]
  node_router["Front controller<br/>[index.php]"]
  node_auth["Access control<br/>[Auth.php]"]
  node_settings["Application settings"]
  node_views["Page views"]
  node_layout["Shared layout<br/>[layout.php]"]
end

subgraph group_parking["Parking operations"]
  node_zones["Zone management<br/>[ZoneController.php]"]
  node_reservation["Reservations"]
  node_visitor["Visitor parking"]
end

subgraph group_accounts["Accounts and billing"]
  node_login["Login and registration<br/>[AuthController.php]"]
  node_userui["Account administration"]
  node_profile["User profile"]
  node_subscription["Subscriptions"]
  node_payment["Payment initiation"]
  node_paymentflow["Payment return handlers<br/>[payer.php]"]
  node_paymentconfig["Payment configuration<br/>[Payment.php]"]
end

subgraph group_insight["Alerts and reporting"]
  node_dashboard["Operations dashboard"]
  node_alerts["Alert management"]
  node_reports["Reports and export"]
end

subgraph group_persistence["Persistence"]
  node_usersmodel["User records"]
  node_placemodel["Parking places<br/>[PlaceModel.php]"]
  node_zonemodel["Zone records<br/>[ZoneModel.php]"]
  node_reservationmodel["Reservation records"]
  node_ticketmodel["Ticket records<br/>[TicketModel.php]"]
  node_journalmodel["Vehicle journal<br/>[JournalModel.php]"]
  node_abomodel["Subscription records"]
  node_alertmodel["Alert records<br/>[AlerteModel.php]"]
  node_dbconn["PDO connection<br/>[Database.php]"]
  node_database[("MySQL database")]
end

node_actor(("Web user"))

node_actor -->|"requests page"| node_router
node_router -->|"checks access"| node_auth
node_router -->|"dispatches"| node_login
node_router -->|"dispatches"| node_dashboard
node_router -->|"dispatches"| node_zones
node_router -->|"dispatches"| node_reservation
node_router -->|"dispatches"| node_visitor
node_router -->|"dispatches"| node_subscription
node_router -->|"dispatches"| node_payment
node_router -->|"dispatches"| node_alerts
node_router -->|"dispatches"| node_reports
node_router -->|"dispatches"| node_userui
node_router -->|"dispatches"| node_profile
node_router -->|"dispatches"| node_settings
node_login -->|"authenticates users"| node_usersmodel
node_login -->|"renders login"| node_views
node_userui -->|"manages users"| node_usersmodel
node_profile -->|"reads account"| node_usersmodel
node_profile -->|"reads reservations"| node_reservationmodel
node_profile -->|"reads subscriptions"| node_abomodel
node_profile -->|"reads tickets"| node_ticketmodel
node_dashboard -->|"reads occupancy"| node_placemodel
node_dashboard -->|"reads alerts"| node_alertmodel
node_dashboard -->|"reads activity"| node_journalmodel
node_dashboard -->|"reads zones"| node_zonemodel
node_dashboard -->|"reads tickets"| node_ticketmodel
node_dashboard -->|"reads subscriptions"| node_abomodel
node_dashboard -->|"reads reservations"| node_reservationmodel
node_dashboard -->|"renders dashboard"| node_views
node_zones -->|"manages zones"| node_zonemodel
node_zones -->|"manages places"| node_placemodel
node_reservation -->|"creates reservations"| node_reservationmodel
node_reservation -->|"checks availability"| node_placemodel
node_reservation -->|"records conflicts"| node_alertmodel
node_reservation -.->|"renders reservations"| node_views
node_visitor -->|"checks place"| node_placemodel
node_visitor -->|"issues tickets"| node_ticketmodel
node_visitor -->|"records violation"| node_alertmodel
node_visitor -->|"records entry"| node_journalmodel
node_visitor -->|"reads zones"| node_zonemodel
node_subscription -->|"manages subscriptions"| node_abomodel
node_subscription -->|"selects users"| node_usersmodel
node_subscription -->|"selects zones"| node_zonemodel
node_payment -->|"loads settings"| node_paymentconfig
node_payment -->|"renders payment"| node_views
node_paymentflow -->|"loads ticket"| node_ticketmodel
node_alerts -->|"manages alerts"| node_alertmodel
node_reports -->|"aggregates tickets"| node_ticketmodel

click node_router "https://github.com/falloudev190/parking/blob/main/smart-parking/index.php"
click node_auth "https://github.com/falloudev190/parking/blob/main/smart-parking/config/Auth.php"
click node_login "https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/AuthController.php"
click node_userui "https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/UtilisateurController.php"
click node_profile "https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/ProfilController.php"
click node_dashboard "https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/DashboardController.php"
click node_zones "https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/ZoneController.php"
click node_reservation "https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/ReservationController.php"
click node_visitor "https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/VisiteurController.php"
click node_subscription "https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/AbonnementController.php"
click node_payment "https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/PaymentController.php"
click node_paymentflow "https://github.com/falloudev190/parking/blob/main/smart-parking/payer.php"
click node_alerts "https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/AlerteController.php"
click node_reports "https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/RapportController.php"
click node_settings "https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/ConfigController.php"
click node_views "https://github.com/falloudev190/parking/tree/main/smart-parking/views"
click node_layout "https://github.com/falloudev190/parking/blob/main/smart-parking/views/layout.php"
click node_usersmodel "https://github.com/falloudev190/parking/blob/main/smart-parking/models/UtilisateurModel.php"
click node_placemodel "https://github.com/falloudev190/parking/blob/main/smart-parking/models/PlaceModel.php"
click node_zonemodel "https://github.com/falloudev190/parking/blob/main/smart-parking/models/ZoneModel.php"
click node_reservationmodel "https://github.com/falloudev190/parking/blob/main/smart-parking/models/ReservationModel.php"
click node_ticketmodel "https://github.com/falloudev190/parking/blob/main/smart-parking/models/TicketModel.php"
click node_journalmodel "https://github.com/falloudev190/parking/blob/main/smart-parking/models/JournalModel.php"
click node_abomodel "https://github.com/falloudev190/parking/blob/main/smart-parking/models/AbonnementModel.php"
click node_alertmodel "https://github.com/falloudev190/parking/blob/main/smart-parking/models/AlerteModel.php"
click node_dbconn "https://github.com/falloudev190/parking/blob/main/smart-parking/config/Database.php"
click node_paymentconfig "https://github.com/falloudev190/parking/blob/main/smart-parking/config/Payment.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_router,node_auth,node_settings,node_views,node_layout,node_actor toneBlue
class node_zones,node_reservation,node_visitor toneAmber
class node_login,node_userui,node_profile,node_subscription,node_payment,node_paymentflow,node_paymentconfig toneMint
class node_dashboard,node_alerts,node_reports toneRose
class node_usersmodel,node_placemodel,node_zonemodel,node_reservationmodel,node_ticketmodel,node_journalmodel,node_abomodel,node_alertmodel,node_dbconn,node_database toneIndigo
```

## Components

### Request and access

- [Front controller](https://github.com/falloudev190/parking/blob/main/smart-parking/index.php): `smart-parking/index.php`
- [Access control](https://github.com/falloudev190/parking/blob/main/smart-parking/config/Auth.php): `smart-parking/config/Auth.php`
- [Application settings](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/ConfigController.php): `smart-parking/controllers/ConfigController.php`
- [Page views](https://github.com/falloudev190/parking/tree/main/smart-parking/views): `smart-parking/views`
- [Shared layout](https://github.com/falloudev190/parking/blob/main/smart-parking/views/layout.php): `smart-parking/views/layout.php`

### Parking operations

- [Zone management](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/ZoneController.php): `smart-parking/controllers/ZoneController.php`
- [Reservations](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/ReservationController.php): `smart-parking/controllers/ReservationController.php`
- [Visitor parking](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/VisiteurController.php): `smart-parking/controllers/VisiteurController.php`

### Accounts and billing

- [Login and registration](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/AuthController.php): `smart-parking/controllers/AuthController.php`
- [Account administration](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/UtilisateurController.php): `smart-parking/controllers/UtilisateurController.php`
- [User profile](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/ProfilController.php): `smart-parking/controllers/ProfilController.php`
- [Subscriptions](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/AbonnementController.php): `smart-parking/controllers/AbonnementController.php`
- [Payment initiation](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/PaymentController.php): `smart-parking/controllers/PaymentController.php`
- [Payment return handlers](https://github.com/falloudev190/parking/blob/main/smart-parking/payer.php): `smart-parking/payer.php`
- [Payment configuration](https://github.com/falloudev190/parking/blob/main/smart-parking/config/Payment.php): `smart-parking/config/Payment.php`

### Alerts and reporting

- [Operations dashboard](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/DashboardController.php): `smart-parking/controllers/DashboardController.php`
- [Alert management](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/AlerteController.php): `smart-parking/controllers/AlerteController.php`
- [Reports and export](https://github.com/falloudev190/parking/blob/main/smart-parking/controllers/RapportController.php): `smart-parking/controllers/RapportController.php`

### Persistence

- [User records](https://github.com/falloudev190/parking/blob/main/smart-parking/models/UtilisateurModel.php): `smart-parking/models/UtilisateurModel.php`
- [Parking places](https://github.com/falloudev190/parking/blob/main/smart-parking/models/PlaceModel.php): `smart-parking/models/PlaceModel.php`
- [Zone records](https://github.com/falloudev190/parking/blob/main/smart-parking/models/ZoneModel.php): `smart-parking/models/ZoneModel.php`
- [Reservation records](https://github.com/falloudev190/parking/blob/main/smart-parking/models/ReservationModel.php): `smart-parking/models/ReservationModel.php`
- [Ticket records](https://github.com/falloudev190/parking/blob/main/smart-parking/models/TicketModel.php): `smart-parking/models/TicketModel.php`
- [Vehicle journal](https://github.com/falloudev190/parking/blob/main/smart-parking/models/JournalModel.php): `smart-parking/models/JournalModel.php`
- [Subscription records](https://github.com/falloudev190/parking/blob/main/smart-parking/models/AbonnementModel.php): `smart-parking/models/AbonnementModel.php`
- [Alert records](https://github.com/falloudev190/parking/blob/main/smart-parking/models/AlerteModel.php): `smart-parking/models/AlerteModel.php`
- [PDO connection](https://github.com/falloudev190/parking/blob/main/smart-parking/config/Database.php): `smart-parking/config/Database.php`
- **MySQL database**

### Other components

- **Web user**

## Connections

- Web user → Front controller: requests page (evidence: `smart-parking/index.php`)
- Front controller → Access control: checks access (evidence: `smart-parking/index.php`)
- Front controller → Login and registration: dispatches (evidence: `smart-parking/index.php`)
- Front controller → Operations dashboard: dispatches (evidence: `smart-parking/index.php`)
- Front controller → Zone management: dispatches (evidence: `smart-parking/index.php`)
- Front controller → Reservations: dispatches (evidence: `smart-parking/index.php`)
- Front controller → Visitor parking: dispatches (evidence: `smart-parking/index.php`)
- Front controller → Subscriptions: dispatches (evidence: `smart-parking/index.php`)
- Front controller → Payment initiation: dispatches (evidence: `smart-parking/index.php`)
- Front controller → Alert management: dispatches (evidence: `smart-parking/index.php`)
- Front controller → Reports and export: dispatches (evidence: `smart-parking/index.php`)
- Front controller → Account administration: dispatches (evidence: `smart-parking/index.php`)
- Front controller → User profile: dispatches (evidence: `smart-parking/index.php`)
- Front controller → Application settings: dispatches (evidence: `smart-parking/index.php`)
- Login and registration → User records: authenticates users (evidence: `smart-parking/controllers/AuthController.php`)
- Login and registration → Page views: renders login (evidence: `smart-parking/controllers/AuthController.php`)
- Account administration → User records: manages users (evidence: `smart-parking/controllers/UtilisateurController.php`)
- User profile → User records: reads account (evidence: `smart-parking/controllers/ProfilController.php`)
- User profile → Reservation records: reads reservations (evidence: `smart-parking/controllers/ProfilController.php`)
- User profile → Subscription records: reads subscriptions (evidence: `smart-parking/controllers/ProfilController.php`)
- User profile → Ticket records: reads tickets (evidence: `smart-parking/controllers/ProfilController.php`)
- Operations dashboard → Parking places: reads occupancy (evidence: `smart-parking/controllers/DashboardController.php`)
- Operations dashboard → Alert records: reads alerts (evidence: `smart-parking/controllers/DashboardController.php`)
- Operations dashboard → Vehicle journal: reads activity (evidence: `smart-parking/controllers/DashboardController.php`)
- Operations dashboard → Zone records: reads zones (evidence: `smart-parking/controllers/DashboardController.php`)
- Operations dashboard → Ticket records: reads tickets (evidence: `smart-parking/controllers/DashboardController.php`)
- Operations dashboard → Subscription records: reads subscriptions (evidence: `smart-parking/controllers/DashboardController.php`)
- Operations dashboard → Reservation records: reads reservations (evidence: `smart-parking/controllers/DashboardController.php`)
- Operations dashboard → Page views: renders dashboard (evidence: `smart-parking/controllers/DashboardController.php`)
- Zone management → Zone records: manages zones (evidence: `smart-parking/controllers/ZoneController.php`)
- Zone management → Parking places: manages places (evidence: `smart-parking/controllers/ZoneController.php`)
- Reservations → Reservation records: creates reservations (evidence: `smart-parking/controllers/ReservationController.php`)
- Reservations → Parking places: checks availability (evidence: `smart-parking/controllers/ReservationController.php`)
- Reservations → Alert records: records conflicts (evidence: `smart-parking/controllers/ReservationController.php`)
- Reservations → Page views: renders reservations (evidence: `smart-parking/controllers/ReservationController.php`)
- Visitor parking → Parking places: checks place (evidence: `smart-parking/controllers/VisiteurController.php`)
- Visitor parking → Ticket records: issues tickets (evidence: `smart-parking/controllers/VisiteurController.php`)
- Visitor parking → Alert records: records violation (evidence: `smart-parking/controllers/VisiteurController.php`)
- Visitor parking → Vehicle journal: records entry (evidence: `smart-parking/controllers/VisiteurController.php`)
- Visitor parking → Zone records: reads zones (evidence: `smart-parking/controllers/VisiteurController.php`)
- Subscriptions → Subscription records: manages subscriptions (evidence: `smart-parking/controllers/AbonnementController.php`)
- Subscriptions → User records: selects users (evidence: `smart-parking/controllers/AbonnementController.php`)
- Subscriptions → Zone records: selects zones (evidence: `smart-parking/controllers/AbonnementController.php`)
- Payment initiation → Payment configuration: loads settings (evidence: `smart-parking/controllers/PaymentController.php`)
- Payment initiation → Page views: renders payment (evidence: `smart-parking/controllers/PaymentController.php`)
- Payment return handlers → Ticket records: loads ticket (evidence: `smart-parking/payer.php`)
- Alert management → Alert records: manages alerts (evidence: `smart-parking/controllers/AlerteController.php`)
- Reports and export → Ticket records: aggregates tickets (evidence: `smart-parking/controllers/RapportController.php`)
