# venkatnplus/opensource-uberclone architecture

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

- Interactive diagram: https://gitdiagram.com/venkatnplus/opensource-uberclone
- Repository: https://github.com/venkatnplus/opensource-uberclone

## Overview

This is a Laravel/MySQL ride-sharing application. Riders and drivers use the API to register, request and match rides, follow trip progress, pay, and rate; administrators manage operations through the web dashboard. The graph also preserves documented messaging and real-time location capabilities. Several implementation details are unsampled, so links based on README capabilities are explicitly documented at that level rather than asserting particular controller calls.

Main entry points: [`app/Models/taxi/Requests/Request.php`](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/Requests/Request.php) (Trip lifecycle), [`app/Http/Controllers/Taxi/API/Request/DriverEndRequestController.php`](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/Taxi/API/Request/DriverEndRequestController.php) (Trip completion), [`app/Http/Controllers/Taxi/API/DriverController.php`](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/Taxi/API/DriverController.php) (Driver API), [`app/Http/Controllers/Taxi/Web/ZoneManagement/ZoneController.php`](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/Taxi/Web/ZoneManagement/ZoneController.php) (Zone administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_api_auth["API authentication"]
  node_driver_api["Driver API"]
  node_trip_api["Trip API"]
  node_admin_dispatch["Dispatcher"]
  node_admin_drivers["Driver administration"]
  node_admin_zones["Zone administration<br/>[ZoneController.php]"]
end

subgraph group_trips["Ride operations"]
  node_trip_request["Trip lifecycle<br/>[Request.php]"]
  node_matching["Driver matching"]
  node_trip_finish["Trip completion"]
  node_realtime["Location tracking<br/>[server.js]"]
  node_messaging["In-app messaging<br/>[MessagePushed.php]"]
end

subgraph group_domain["Domain data"]
  node_user_model[("User profiles<br/>[User.php]")]
  node_driver_model[("Driver records<br/>[Driver.php]")]
  node_zone_model[("Service zones<br/>[Zone.php]")]
  node_vehicle_model[("Vehicles<br/>[Vehicle.php]")]
  node_settings_model[("Settings<br/>[Settings.php]")]
  node_wallet_model[("Wallet<br/>[Wallet.php]")]
  node_wallet_tx[("Wallet transactions")]
  node_country_model[("Countries<br/>[Country.php]")]
end

subgraph group_integrations["External services"]
  node_payments["Payment provider"]
  node_maps["Maps API"]
end

node_rider(("Rider"))
node_driver_actor(("Driver"))
node_admin_actor(("Administrator"))

node_rider -->|"authenticates"| node_api_auth
node_driver_actor -->|"authenticates"| node_api_auth
node_rider -->|"requests rides"| node_trip_api
node_driver_actor -->|"accepts rides"| node_driver_api
node_driver_actor -->|"updates trips"| node_trip_api
node_admin_actor -->|"dispatches rides"| node_admin_dispatch
node_admin_actor -->|"manages drivers"| node_admin_drivers
node_admin_actor -->|"manages settings"| node_admin_zones
node_trip_api -.->|"records requests"| node_trip_request
node_admin_dispatch -.->|"creates bookings"| node_trip_request
node_trip_request -.->|"matches drivers"| node_matching
node_driver_api -.->|"shares location"| node_realtime
node_rider -->|"tracks trips"| node_realtime
node_driver_actor -->|"messages rider"| node_messaging
node_rider -->|"messages driver"| node_messaging
node_trip_finish -->|"processes payment"| node_payments
node_trip_finish -.->|"updates earnings"| node_wallet_model
node_trip_finish -.->|"records transactions"| node_wallet_tx
node_driver_api -->|"manages profiles"| node_user_model
node_driver_api -->|"manages drivers"| node_driver_model
node_admin_drivers -->|"manages drivers"| node_driver_model
node_admin_zones -->|"configures zones"| node_zone_model
node_admin_zones -->|"configures vehicles"| node_vehicle_model
node_admin_zones -->|"reads countries"| node_country_model
node_admin_dispatch -->|"manages trips"| node_trip_request
node_trip_finish -->|"completes trips"| node_trip_request
node_admin_actor -->|"uses mapping"| node_maps
node_rider -->|"uses mapping"| node_maps

click node_api_auth "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/boilerplate/API/AuthAPIController.php"
click node_driver_api "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/Taxi/API/DriverController.php"
click node_trip_api "https://github.com/venkatnplus/opensource-uberclone/tree/main/app/Http/Controllers/Taxi/API/Request"
click node_admin_dispatch "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/Taxi/Web/Dispatcher/DispatcherController.php"
click node_admin_drivers "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/Taxi/Web/Driver/DriverController.php"
click node_admin_zones "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/Taxi/Web/ZoneManagement/ZoneController.php"
click node_trip_request "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/Requests/Request.php"
click node_matching "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Jobs/Request/SendRequestToNextDriverJob.php"
click node_trip_finish "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/Taxi/API/Request/DriverEndRequestController.php"
click node_realtime "https://github.com/venkatnplus/opensource-uberclone/blob/main/node/server.js"
click node_messaging "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Events/MessagePushed.php"
click node_user_model "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/User.php"
click node_driver_model "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/Driver.php"
click node_zone_model "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/Zone.php"
click node_vehicle_model "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/Vehicle.php"
click node_settings_model "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/Settings.php"
click node_wallet_model "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/Wallet.php"
click node_wallet_tx "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/WalletTransaction.php"
click node_country_model "https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/boilerplate/Country.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_api_auth,node_driver_api,node_trip_api,node_admin_dispatch,node_admin_drivers,node_admin_zones toneBlue
class node_trip_request,node_matching,node_trip_finish,node_realtime,node_messaging toneAmber
class node_user_model,node_driver_model,node_zone_model,node_vehicle_model,node_settings_model,node_wallet_model,node_wallet_tx,node_country_model toneMint
class node_payments,node_maps toneRose
class node_rider,node_driver_actor,node_admin_actor toneIndigo
```

## Components

### User interfaces

- [API authentication](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/boilerplate/API/AuthAPIController.php): `app/Http/Controllers/boilerplate/API/AuthAPIController.php`
- [Driver API](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/Taxi/API/DriverController.php): `app/Http/Controllers/Taxi/API/DriverController.php`
- [Trip API](https://github.com/venkatnplus/opensource-uberclone/tree/main/app/Http/Controllers/Taxi/API/Request): `app/Http/Controllers/Taxi/API/Request`
- [Dispatcher](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/Taxi/Web/Dispatcher/DispatcherController.php): `app/Http/Controllers/Taxi/Web/Dispatcher/DispatcherController.php`
- [Driver administration](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/Taxi/Web/Driver/DriverController.php): `app/Http/Controllers/Taxi/Web/Driver/DriverController.php`
- [Zone administration](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/Taxi/Web/ZoneManagement/ZoneController.php): `app/Http/Controllers/Taxi/Web/ZoneManagement/ZoneController.php`

### Ride operations

- [Trip lifecycle](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/Requests/Request.php): `app/Models/taxi/Requests/Request.php`
- [Driver matching](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Jobs/Request/SendRequestToNextDriverJob.php): `app/Jobs/Request/SendRequestToNextDriverJob.php`
- [Trip completion](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Http/Controllers/Taxi/API/Request/DriverEndRequestController.php): `app/Http/Controllers/Taxi/API/Request/DriverEndRequestController.php`
- [Location tracking](https://github.com/venkatnplus/opensource-uberclone/blob/main/node/server.js): `node/server.js`
- [In-app messaging](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Events/MessagePushed.php): `app/Events/MessagePushed.php`

### Domain data

- [User profiles](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/User.php): `app/Models/User.php`
- [Driver records](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/Driver.php): `app/Models/taxi/Driver.php`
- [Service zones](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/Zone.php): `app/Models/taxi/Zone.php`
- [Vehicles](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/Vehicle.php): `app/Models/taxi/Vehicle.php`
- [Settings](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/Settings.php): `app/Models/taxi/Settings.php`
- [Wallet](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/Wallet.php): `app/Models/taxi/Wallet.php`
- [Wallet transactions](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/taxi/WalletTransaction.php): `app/Models/taxi/WalletTransaction.php`
- [Countries](https://github.com/venkatnplus/opensource-uberclone/blob/main/app/Models/boilerplate/Country.php): `app/Models/boilerplate/Country.php`

### External services

- **Payment provider**
- **Maps API**

### Other components

- **Rider**
- **Driver**
- **Administrator**

## Connections

- Rider → API authentication: authenticates
- Driver → API authentication: authenticates
- Rider → Trip API: requests rides
- Driver → Driver API: accepts rides
- Driver → Trip API: updates trips
- Administrator → Dispatcher: dispatches rides
- Administrator → Driver administration: manages drivers
- Administrator → Zone administration: manages settings
- Trip API → Trip lifecycle: records requests (evidence: `app/Http/Controllers/Taxi/API/Request/DriverEndRequestController.php`)
- Dispatcher → Trip lifecycle: creates bookings (evidence: `app/Http/Controllers/Taxi/Web/Dispatcher/DispatcherController.php`)
- Trip lifecycle → Driver matching: matches drivers
- Driver API → Location tracking: shares location
- Rider → Location tracking: tracks trips
- Driver → In-app messaging: messages rider
- Rider → In-app messaging: messages driver
- Trip completion → Payment provider: processes payment
- Trip completion → Wallet: updates earnings (evidence: `app/Http/Controllers/Taxi/API/Request/DriverEndRequestController.php`)
- Trip completion → Wallet transactions: records transactions (evidence: `app/Http/Controllers/Taxi/API/Request/DriverEndRequestController.php`)
- Driver API → User profiles: manages profiles (evidence: `app/Http/Controllers/Taxi/API/DriverController.php`)
- Driver API → Driver records: manages drivers (evidence: `app/Http/Controllers/Taxi/API/DriverController.php`)
- Driver administration → Driver records: manages drivers (evidence: `app/Http/Controllers/Taxi/Web/Driver/DriverController.php`)
- Zone administration → Service zones: configures zones (evidence: `app/Http/Controllers/Taxi/Web/ZoneManagement/ZoneController.php`)
- Zone administration → Vehicles: configures vehicles (evidence: `app/Http/Controllers/Taxi/Web/ZoneManagement/ZoneController.php`)
- Zone administration → Countries: reads countries (evidence: `app/Http/Controllers/Taxi/Web/ZoneManagement/ZoneController.php`)
- Dispatcher → Trip lifecycle: manages trips (evidence: `app/Http/Controllers/Taxi/Web/Dispatcher/DispatcherController.php`)
- Trip completion → Trip lifecycle: completes trips (evidence: `app/Http/Controllers/Taxi/API/Request/DriverEndRequestController.php`)
- Administrator → Maps API: uses mapping
- Rider → Maps API: uses mapping
