# prasadvirdande/ridebooking architecture

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

- Interactive diagram: https://gitdiagram.com/prasadvirdande/ridebooking
- Repository: https://github.com/prasadvirdande/ridebooking

## Overview

Ride Booking is a microservices application whose main workflow runs from client access and account authentication through ride search, booking, driver acceptance, OTP-verified start and completion, and payment confirmation. The README documents gateway routing and the payment-to-ride callback; excerpts show payment persistence, webhook handling and receipt dispatch. AI ride search and invoice generation are additional capabilities. Several service internals and integrations were not sampled, so uncertain links are omitted or marked unverified.

Main entry points: [`microservices/ApiGateway`](https://github.com/prasadvirdande/ridebooking/tree/main/microservices/ApiGateway) (API Gateway), [`microservices/Payment-Service/src/main/java/com/ridebooking/Payment_services/Service/PaymentService.java`](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Payment-Service/src/main/java/com/ridebooking/Payment_services/Service/PaymentService.java) (Payment Processing), [`microservices/driver-service/src/main/java/com/ridebooking/driver_service/Service/Impl/DriverServiceImpl.java`](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/driver-service/src/main/java/com/ridebooking/driver_service/Service/Impl/DriverServiceImpl.java) (Driver Operations), [`microservices/ride-service/src/main/java/com/ridebooking/ride_service/Service/Impl/RideServiceImpl.java`](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/ride-service/src/main/java/com/ridebooking/ride_service/Service/Impl/RideServiceImpl.java) (Ride Lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and Identity"]
  node_gateway["API Gateway"]
  node_auth["Authentication"]
end

subgraph group_supply["Users and Drivers"]
  node_users["User Accounts<br/>[ServiceImpl.java]"]
  node_user_store[("User Store<br/>[User.java]")]
  node_drivers["Driver Operations"]
  node_driver_store[("Driver Store<br/>[Driver.java]")]
  node_redis_geo[("Driver GEO Index<br/>[RedisConfig.java]")]
end

subgraph group_rides["Ride Lifecycle"]
  node_ride_api["Ride API"]
  node_ride_logic["Ride Lifecycle"]
  node_ride_store[("Ride Store<br/>[Ride.java]")]
  node_ride_events["Ride Events<br/>[RideProducer.java]"]
  node_ai_search["AI Ride Search"]
  node_ride_tools["Ride Tools<br/>[RideTools.java]"]
end

subgraph group_payments["Payments and Receipts"]
  node_payments["Payment Processing"]
  node_payment_store[("Payment Records<br/>[Payment.java]")]
  node_razorpay["Razorpay"]
  node_notifications["Receipt Email<br/>[EmailService.java]"]
  node_invoices["Invoice Generation"]
  node_invoice_pdf["PDF Generation"]
end

subgraph group_platform["Platform Services"]
  node_registry["Service Registry"]
end

node_client(("Client"))

node_client -->|"sends requests"| node_gateway
node_gateway -->|"routes requests"| node_auth
node_gateway -->|"routes requests"| node_users
node_gateway -->|"routes requests"| node_drivers
node_gateway -->|"routes requests"| node_ride_api
node_gateway -->|"routes requests"| node_payments
node_auth -->|"loads user"| node_users
node_auth -->|"loads driver"| node_drivers
node_users -.->|"persists accounts"| node_user_store
node_drivers -.->|"persists drivers"| node_driver_store
node_drivers -.->|"tracks locations"| node_redis_geo
node_ride_api -->|"delegates requests"| node_ride_logic
node_ride_logic -.->|"manages ride state"| node_ride_store
node_ride_logic -->|"finds nearby drivers"| node_drivers
node_ride_logic -.->|"publishes events"| node_ride_events
node_ai_search -->|"uses tools"| node_ride_tools
node_payments -->|"saves payments"| node_payment_store
node_payments -->|"creates payment links"| node_razorpay
node_razorpay -->|"sends webhooks"| node_payments
node_payments -->|"reports payment success"| node_ride_api
node_payments -->|"sends receipt request"| node_notifications
node_notifications -->|"generates invoice"| node_invoices
node_invoices -.->|"creates PDF"| node_invoice_pdf
node_client -.->|"service discovery"| node_registry

click node_gateway "https://github.com/prasadvirdande/ridebooking/tree/main/microservices/ApiGateway"
click node_auth "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Auth-Service/src/main/java/com/Auth_Service/Service/Impl/AuthserviceImpl.java"
click node_users "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/user-service/src/main/java/com/ridebooking/user_service/Service/ServiceImpl.java"
click node_user_store "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/user-service/src/main/java/com/ridebooking/user_service/Entity/User.java"
click node_drivers "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/driver-service/src/main/java/com/ridebooking/driver_service/Service/Impl/DriverServiceImpl.java"
click node_driver_store "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/driver-service/src/main/java/com/ridebooking/driver_service/Entity/Driver.java"
click node_redis_geo "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/driver-service/src/main/java/com/ridebooking/driver_service/Config/RedisConfig.java"
click node_ride_api "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/ride-service/src/main/java/com/ridebooking/ride_service/Controller/RideController.java"
click node_ride_logic "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/ride-service/src/main/java/com/ridebooking/ride_service/Service/Impl/RideServiceImpl.java"
click node_ride_store "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/ride-service/src/main/java/com/ridebooking/ride_service/Entity/Ride.java"
click node_ride_events "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/ride-service/src/main/java/com/ridebooking/ride_service/Service/Kafka/RideProducer.java"
click node_ai_search "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/AI_SERVICES/src/main/java/com/RideBooking/AI_SERVICES/Controller/AIControllerMain.java"
click node_ride_tools "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/AI_SERVICES/src/main/java/com/RideBooking/AI_SERVICES/Feign/Tools/RideTools.java"
click node_payments "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Payment-Service/src/main/java/com/ridebooking/Payment_services/Service/PaymentService.java"
click node_payment_store "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Payment-Service/src/main/java/com/ridebooking/Payment_services/Entity/Payment.java"
click node_notifications "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Notification-Service/src/main/java/com/ridebooking/Notification_Service/Service/EmailService.java"
click node_invoices "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Notification-Service/src/main/java/com/ridebooking/Notification_Service/Service/InvoiceService.java"
click node_invoice_pdf "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Notification-Service/src/main/java/com/ridebooking/Notification_Service/Service/PDFgenerationService.java"
click node_registry "https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Service-Discovery/src/main/java/com/ridebooking/Service_Discovery/ServiceDiscoveryApplication.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_gateway,node_auth,node_client toneBlue
class node_users,node_user_store,node_drivers,node_driver_store,node_redis_geo toneAmber
class node_ride_api,node_ride_logic,node_ride_store,node_ride_events,node_ai_search,node_ride_tools toneMint
class node_payments,node_payment_store,node_razorpay,node_notifications,node_invoices,node_invoice_pdf toneRose
class node_registry toneIndigo
```

## Components

### Access and Identity

- [API Gateway](https://github.com/prasadvirdande/ridebooking/tree/main/microservices/ApiGateway): `microservices/ApiGateway`
- [Authentication](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Auth-Service/src/main/java/com/Auth_Service/Service/Impl/AuthserviceImpl.java): `microservices/Auth-Service/src/main/java/com/Auth_Service/Service/Impl/AuthserviceImpl.java`

### Users and Drivers

- [User Accounts](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/user-service/src/main/java/com/ridebooking/user_service/Service/ServiceImpl.java): `microservices/user-service/src/main/java/com/ridebooking/user_service/Service/ServiceImpl.java`
- [User Store](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/user-service/src/main/java/com/ridebooking/user_service/Entity/User.java): `microservices/user-service/src/main/java/com/ridebooking/user_service/Entity/User.java`
- [Driver Operations](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/driver-service/src/main/java/com/ridebooking/driver_service/Service/Impl/DriverServiceImpl.java): `microservices/driver-service/src/main/java/com/ridebooking/driver_service/Service/Impl/DriverServiceImpl.java`
- [Driver Store](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/driver-service/src/main/java/com/ridebooking/driver_service/Entity/Driver.java): `microservices/driver-service/src/main/java/com/ridebooking/driver_service/Entity/Driver.java`
- [Driver GEO Index](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/driver-service/src/main/java/com/ridebooking/driver_service/Config/RedisConfig.java): `microservices/driver-service/src/main/java/com/ridebooking/driver_service/Config/RedisConfig.java`

### Ride Lifecycle

- [Ride API](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/ride-service/src/main/java/com/ridebooking/ride_service/Controller/RideController.java): `microservices/ride-service/src/main/java/com/ridebooking/ride_service/Controller/RideController.java`
- [Ride Lifecycle](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/ride-service/src/main/java/com/ridebooking/ride_service/Service/Impl/RideServiceImpl.java): `microservices/ride-service/src/main/java/com/ridebooking/ride_service/Service/Impl/RideServiceImpl.java`
- [Ride Store](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/ride-service/src/main/java/com/ridebooking/ride_service/Entity/Ride.java): `microservices/ride-service/src/main/java/com/ridebooking/ride_service/Entity/Ride.java`
- [Ride Events](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/ride-service/src/main/java/com/ridebooking/ride_service/Service/Kafka/RideProducer.java): `microservices/ride-service/src/main/java/com/ridebooking/ride_service/Service/Kafka/RideProducer.java`
- [AI Ride Search](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/AI_SERVICES/src/main/java/com/RideBooking/AI_SERVICES/Controller/AIControllerMain.java): `microservices/AI_SERVICES/src/main/java/com/RideBooking/AI_SERVICES/Controller/AIControllerMain.java`
- [Ride Tools](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/AI_SERVICES/src/main/java/com/RideBooking/AI_SERVICES/Feign/Tools/RideTools.java): `microservices/AI_SERVICES/src/main/java/com/RideBooking/AI_SERVICES/Feign/Tools/RideTools.java`

### Payments and Receipts

- [Payment Processing](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Payment-Service/src/main/java/com/ridebooking/Payment_services/Service/PaymentService.java): `microservices/Payment-Service/src/main/java/com/ridebooking/Payment_services/Service/PaymentService.java`
- [Payment Records](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Payment-Service/src/main/java/com/ridebooking/Payment_services/Entity/Payment.java): `microservices/Payment-Service/src/main/java/com/ridebooking/Payment_services/Entity/Payment.java`
- **Razorpay**
- [Receipt Email](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Notification-Service/src/main/java/com/ridebooking/Notification_Service/Service/EmailService.java): `microservices/Notification-Service/src/main/java/com/ridebooking/Notification_Service/Service/EmailService.java`
- [Invoice Generation](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Notification-Service/src/main/java/com/ridebooking/Notification_Service/Service/InvoiceService.java): `microservices/Notification-Service/src/main/java/com/ridebooking/Notification_Service/Service/InvoiceService.java`
- [PDF Generation](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Notification-Service/src/main/java/com/ridebooking/Notification_Service/Service/PDFgenerationService.java): `microservices/Notification-Service/src/main/java/com/ridebooking/Notification_Service/Service/PDFgenerationService.java`

### Platform Services

- [Service Registry](https://github.com/prasadvirdande/ridebooking/blob/main/microservices/Service-Discovery/src/main/java/com/ridebooking/Service_Discovery/ServiceDiscoveryApplication.java): `microservices/Service-Discovery/src/main/java/com/ridebooking/Service_Discovery/ServiceDiscoveryApplication.java`

### Other components

- **Client**

## Connections

- Client → API Gateway: sends requests
- API Gateway → Authentication: routes requests
- API Gateway → User Accounts: routes requests
- API Gateway → Driver Operations: routes requests
- API Gateway → Ride API: routes requests
- API Gateway → Payment Processing: routes requests
- Authentication → User Accounts: loads user
- Authentication → Driver Operations: loads driver
- User Accounts → User Store: persists accounts
- Driver Operations → Driver Store: persists drivers
- Driver Operations → Driver GEO Index: tracks locations
- Ride API → Ride Lifecycle: delegates requests (evidence: `microservices/ride-service/src/main/java/com/ridebooking/ride_service/Controller/RideController.java`)
- Ride Lifecycle → Ride Store: manages ride state
- Ride Lifecycle → Driver Operations: finds nearby drivers
- Ride Lifecycle → Ride Events: publishes events
- AI Ride Search → Ride Tools: uses tools (evidence: `microservices/AI_SERVICES/src/main/java/com/RideBooking/AI_SERVICES/Controller/AIControllerMain.java`)
- Payment Processing → Payment Records: saves payments (evidence: `microservices/Payment-Service/src/main/java/com/ridebooking/Payment_services/Service/PaymentService.java`)
- Payment Processing → Razorpay: creates payment links
- Razorpay → Payment Processing: sends webhooks
- Payment Processing → Ride API: reports payment success
- Payment Processing → Receipt Email: sends receipt request (evidence: `microservices/Payment-Service/src/main/java/com/ridebooking/Payment_services/Service/PaymentService.java`)
- Receipt Email → Invoice Generation: generates invoice (evidence: `microservices/Notification-Service/src/main/java/com/ridebooking/Notification_Service/Service/EmailService.java`)
- Invoice Generation → PDF Generation: creates PDF (evidence: `microservices/Notification-Service/src/main/java/com/ridebooking/Notification_Service/Service/InvoiceService.java`)
- Client → Service Registry: service discovery
