# eranjanawr/ridelink architecture

> Architecture diagram of the GitHub repository eranjanawr/ridelink, 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/eranjanawr/ridelink
- Repository: https://github.com/eranjanawr/ridelink

## Overview

RideLink is a backend ride-sharing platform. In the shown runtime, clients manage driver profiles and vehicles, while a ride request is created and advanced through assignment, acceptance, start, completion, or cancellation. Assignment asks the Driver & Vehicle Service for eligible drivers and updates availability over its API. Source excerpts establish these service calls and repository usage; the README documents MongoDB ownership. Account and Fare & Payment services are named in the README but have no implementation in the supplied tree, so they are not represented as implemented components.

Main entry points: [`ride-management-service/src/main/java/com/ridelink/ride/service/RideService.java`](https://github.com/eranjanawr/ridelink/blob/main/ride-management-service/src/main/java/com/ridelink/ride/service/RideService.java) (Ride lifecycle), [`driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/VehicleService.java`](https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/VehicleService.java) (Vehicle management), [`ride-management-service/src/main/java/com/ridelink/ride/integration/driver/DriverServiceClient.java`](https://github.com/eranjanawr/ridelink/blob/main/ride-management-service/src/main/java/com/ridelink/ride/integration/driver/DriverServiceClient.java) (Driver service client), [`driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/DriverProfileController.java`](https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/DriverProfileController.java) (Driver profiles API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_driver["Driver and vehicle"]
  node_profileapi["Driver profiles API"]
  node_profilelogic["Profile management"]
  node_eligibleapi["Eligible drivers API"]
  node_eligibility["Eligibility search"]
  node_vehicleapi["Vehicle API"]
  node_vehiclelogic["Vehicle management"]
end

subgraph group_rides["Ride lifecycle"]
  node_rideapi["Ride API"]
  node_rideservice["Ride lifecycle<br/>[RideService.java]"]
  node_errorhandler["Ride error mapping"]
end

subgraph group_rideintegration["Driver API integration"]
  node_driverclient["Driver service client"]
end

subgraph group_storage["Persistence"]
  node_driverstore[("Driver data")]
  node_vehiclestore[("Vehicle data")]
  node_ridestore[("Ride data")]
end

node_client(("API client"))
node_driveraccount["Account Service"]
node_mongo[("MongoDB")]

node_client -->|"manages profiles"| node_profileapi
node_profileapi -->|"delegates to"| node_profilelogic
node_client -.->|"manages vehicles"| node_vehicleapi
node_vehicleapi -.->|"delegates to"| node_vehiclelogic
node_client -.->|"requests candidates"| node_eligibleapi
node_eligibleapi -.->|"delegates to"| node_eligibility
node_eligibility -->|"queries profiles"| node_driverstore
node_eligibility -->|"reads vehicles"| node_vehiclestore
node_profilelogic -->|"reads and writes"| node_driverstore
node_vehiclelogic -->|"checks drivers"| node_driverstore
node_vehiclelogic -->|"reads and writes"| node_vehiclestore
node_client -->|"requests rides"| node_rideapi
node_rideapi -->|"delegates to"| node_rideservice
node_rideservice -->|"reads and writes"| node_ridestore
node_rideservice -->|"requests candidates"| node_driverclient
node_rideservice -->|"updates availability"| node_driverclient
node_driverclient -.->|"fetches candidates"| node_eligibleapi
node_driverclient -.->|"patches availability"| node_profileapi
node_driveraccount -.->|"provides account identity"| node_profileapi
node_profilelogic -.->|"persists via repository"| node_mongo
node_vehiclelogic -.->|"persists via repository"| node_mongo
node_rideservice -.->|"persists via repository"| node_mongo

click node_profileapi "https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/DriverProfileController.java"
click node_profilelogic "https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/DriverProfileService.java"
click node_eligibleapi "https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/EligibleDriverController.java"
click node_eligibility "https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/EligibleDriverService.java"
click node_vehicleapi "https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/VehicleController.java"
click node_vehiclelogic "https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/VehicleService.java"
click node_driverstore "https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/repository/DriverProfileRepository.java"
click node_vehiclestore "https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/repository/VehicleRepository.java"
click node_rideapi "https://github.com/eranjanawr/ridelink/blob/main/ride-management-service/src/main/java/com/ridelink/ride/controller/RideController.java"
click node_rideservice "https://github.com/eranjanawr/ridelink/blob/main/ride-management-service/src/main/java/com/ridelink/ride/service/RideService.java"
click node_ridestore "https://github.com/eranjanawr/ridelink/blob/main/ride-management-service/src/main/java/com/ridelink/ride/repository/RideRepository.java"
click node_driverclient "https://github.com/eranjanawr/ridelink/blob/main/ride-management-service/src/main/java/com/ridelink/ride/integration/driver/DriverServiceClient.java"
click node_errorhandler "https://github.com/eranjanawr/ridelink/blob/main/ride-management-service/src/main/java/com/ridelink/ride/exception/GlobalExceptionHandler.java"

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_profileapi,node_profilelogic,node_eligibleapi,node_eligibility,node_vehicleapi,node_vehiclelogic,node_client toneBlue
class node_rideapi,node_rideservice,node_errorhandler,node_mongo toneAmber
class node_driverclient toneMint
class node_driverstore,node_vehiclestore,node_ridestore toneRose
class node_driveraccount toneIndigo
```

## Components

### Driver and vehicle

- [Driver profiles API](https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/DriverProfileController.java): `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/DriverProfileController.java`
- [Profile management](https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/DriverProfileService.java): `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/DriverProfileService.java`
- [Eligible drivers API](https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/EligibleDriverController.java): `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/EligibleDriverController.java`
- [Eligibility search](https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/EligibleDriverService.java): `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/EligibleDriverService.java`
- [Vehicle API](https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/VehicleController.java): `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/VehicleController.java`
- [Vehicle management](https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/VehicleService.java): `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/VehicleService.java`

### Ride lifecycle

- [Ride API](https://github.com/eranjanawr/ridelink/blob/main/ride-management-service/src/main/java/com/ridelink/ride/controller/RideController.java): `ride-management-service/src/main/java/com/ridelink/ride/controller/RideController.java`
- [Ride lifecycle](https://github.com/eranjanawr/ridelink/blob/main/ride-management-service/src/main/java/com/ridelink/ride/service/RideService.java): `ride-management-service/src/main/java/com/ridelink/ride/service/RideService.java`
- [Ride error mapping](https://github.com/eranjanawr/ridelink/blob/main/ride-management-service/src/main/java/com/ridelink/ride/exception/GlobalExceptionHandler.java): `ride-management-service/src/main/java/com/ridelink/ride/exception/GlobalExceptionHandler.java`

### Driver API integration

- [Driver service client](https://github.com/eranjanawr/ridelink/blob/main/ride-management-service/src/main/java/com/ridelink/ride/integration/driver/DriverServiceClient.java): `ride-management-service/src/main/java/com/ridelink/ride/integration/driver/DriverServiceClient.java`

### Persistence

- [Driver data](https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/repository/DriverProfileRepository.java): `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/repository/DriverProfileRepository.java`
- [Vehicle data](https://github.com/eranjanawr/ridelink/blob/main/driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/repository/VehicleRepository.java): `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/repository/VehicleRepository.java`
- [Ride data](https://github.com/eranjanawr/ridelink/blob/main/ride-management-service/src/main/java/com/ridelink/ride/repository/RideRepository.java): `ride-management-service/src/main/java/com/ridelink/ride/repository/RideRepository.java`

### Other components

- **API client**
- **Account Service**
- **MongoDB**

## Connections

- API client → Driver profiles API: manages profiles (evidence: `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/DriverProfileController.java`)
- Driver profiles API → Profile management: delegates to (evidence: `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/DriverProfileController.java`)
- API client → Vehicle API: manages vehicles
- Vehicle API → Vehicle management: delegates to (evidence: `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/VehicleController.java`)
- API client → Eligible drivers API: requests candidates
- Eligible drivers API → Eligibility search: delegates to (evidence: `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/EligibleDriverController.java`)
- Eligibility search → Driver data: queries profiles (evidence: `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/EligibleDriverService.java`)
- Eligibility search → Vehicle data: reads vehicles (evidence: `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/EligibleDriverService.java`)
- Profile management → Driver data: reads and writes (evidence: `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/DriverProfileService.java`)
- Vehicle management → Driver data: checks drivers (evidence: `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/VehicleService.java`)
- Vehicle management → Vehicle data: reads and writes (evidence: `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/service/VehicleService.java`)
- API client → Ride API: requests rides (evidence: `ride-management-service/src/main/java/com/ridelink/ride/controller/RideController.java`)
- Ride API → Ride lifecycle: delegates to (evidence: `ride-management-service/src/main/java/com/ridelink/ride/controller/RideController.java`)
- Ride lifecycle → Ride data: reads and writes (evidence: `ride-management-service/src/main/java/com/ridelink/ride/service/RideService.java`)
- Ride lifecycle → Driver service client: requests candidates (evidence: `ride-management-service/src/main/java/com/ridelink/ride/service/RideService.java`)
- Ride lifecycle → Driver service client: updates availability (evidence: `ride-management-service/src/main/java/com/ridelink/ride/service/RideService.java`)
- Driver service client → Eligible drivers API: fetches candidates
- Driver service client → Driver profiles API: patches availability
- Account Service → Driver profiles API: provides account identity (evidence: `driver-and-vehicle-service/src/main/java/com/ridelink/drivervehicle/controller/DriverProfileController.java`)
- Profile management → MongoDB: persists via repository (evidence: `README.md`)
- Vehicle management → MongoDB: persists via repository (evidence: `README.md`)
- Ride lifecycle → MongoDB: persists via repository (evidence: `README.md`)
