# nani517/riderservice architecture

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

- Interactive diagram: https://gitdiagram.com/nani517/riderservice
- Repository: https://github.com/nani517/riderservice

## Overview

RiderService is a Spring service for rider accounts, vehicle details, availability, location updates, and assigned-ride acceptance. Its main workflow is HTTP requests into the rider controller, service-layer validation and coordination, then persistence or Redis operations; accepting a ride also calls the CustomerService. The source index and excerpts support these paths, but do not show database configuration or the global exception-handler implementation, so those connections are not inferred.

Main entry points: [`RiderService/src/main/java/com/Rapido/RiderService/Service/RiderServicelayer.java`](https://github.com/nani517/riderservice/blob/main/RiderService/src/main/java/com/Rapido/RiderService/Service/RiderServicelayer.java) (Rider Service), [`RiderService/src/main/java/com/Rapido/RiderService/Ridercontorller/Ridercontorller.java`](https://github.com/nani517/riderservice/blob/main/RiderService/src/main/java/com/Rapido/RiderService/Ridercontorller/Ridercontorller.java) (Rider Controller), [`RiderService/src/main/java/com/Rapido/RiderService/Service/RedisService.java`](https://github.com/nani517/riderservice/blob/main/RiderService/src/main/java/com/Rapido/RiderService/Service/RedisService.java) (Redis Ride / Location), [`RiderService/src/main/java/com/Rapido/RiderService/DTO`](https://github.com/nani517/riderservice/tree/main/RiderService/src/main/java/com/Rapido/RiderService/DTO) (Request / Ride DTOs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Rider API"]
  node_controller["Rider Controller"]
  node_service["Rider Service"]
end

subgraph group_domain["Rider Domain"]
  node_contracts["Request / Ride DTOs"]
  node_entities["Rider / Vehicle Entities"]
  node_riderrepo["Rider Repository"]
  node_vehiclerepo["Vehicle Repository"]
end

subgraph group_state["Ride State"]
  node_redisservice["Redis Ride / Location<br/>[RedisService.java]"]
  node_redis[("Redis")]
end

node_rider(("Rider"))
node_customer["CustomerService"]

node_rider -->|"sends requests"| node_controller
node_controller -->|"delegates"| node_service
node_controller -->|"accepts / returns"| node_contracts
node_service -->|"maps data"| node_contracts
node_service -->|"reads / writes"| node_riderrepo
node_service -->|"saves / deletes"| node_vehiclerepo
node_riderrepo -->|"stores riders"| node_entities
node_vehiclerepo -->|"stores vehicles"| node_entities
node_service -->|"coordinates rides"| node_redisservice
node_redisservice -->|"reads / writes"| node_redis
node_redisservice -->|"builds ride DTOs"| node_contracts
node_service -->|"requests booking updates"| node_customer

click node_controller "https://github.com/nani517/riderservice/blob/main/RiderService/src/main/java/com/Rapido/RiderService/Ridercontorller/Ridercontorller.java"
click node_service "https://github.com/nani517/riderservice/blob/main/RiderService/src/main/java/com/Rapido/RiderService/Service/RiderServicelayer.java"
click node_contracts "https://github.com/nani517/riderservice/tree/main/RiderService/src/main/java/com/Rapido/RiderService/DTO"
click node_entities "https://github.com/nani517/riderservice/tree/main/RiderService/src/main/java/com/Rapido/RiderService/entity"
click node_riderrepo "https://github.com/nani517/riderservice/blob/main/RiderService/src/main/java/com/Rapido/RiderService/Repository/RiderRepository.java"
click node_vehiclerepo "https://github.com/nani517/riderservice/blob/main/RiderService/src/main/java/com/Rapido/RiderService/Repository/VehicleRepository.java"
click node_redisservice "https://github.com/nani517/riderservice/blob/main/RiderService/src/main/java/com/Rapido/RiderService/Service/RedisService.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_controller,node_service toneBlue
class node_contracts,node_entities,node_riderrepo,node_vehiclerepo toneAmber
class node_redisservice,node_redis toneMint
class node_rider,node_customer toneIndigo
```

## Components

### Rider API

- [Rider Controller](https://github.com/nani517/riderservice/blob/main/RiderService/src/main/java/com/Rapido/RiderService/Ridercontorller/Ridercontorller.java): `RiderService/src/main/java/com/Rapido/RiderService/Ridercontorller/Ridercontorller.java`
- [Rider Service](https://github.com/nani517/riderservice/blob/main/RiderService/src/main/java/com/Rapido/RiderService/Service/RiderServicelayer.java): `RiderService/src/main/java/com/Rapido/RiderService/Service/RiderServicelayer.java`

### Rider Domain

- [Request / Ride DTOs](https://github.com/nani517/riderservice/tree/main/RiderService/src/main/java/com/Rapido/RiderService/DTO): `RiderService/src/main/java/com/Rapido/RiderService/DTO`
- [Rider / Vehicle Entities](https://github.com/nani517/riderservice/tree/main/RiderService/src/main/java/com/Rapido/RiderService/entity): `RiderService/src/main/java/com/Rapido/RiderService/entity`
- [Rider Repository](https://github.com/nani517/riderservice/blob/main/RiderService/src/main/java/com/Rapido/RiderService/Repository/RiderRepository.java): `RiderService/src/main/java/com/Rapido/RiderService/Repository/RiderRepository.java`
- [Vehicle Repository](https://github.com/nani517/riderservice/blob/main/RiderService/src/main/java/com/Rapido/RiderService/Repository/VehicleRepository.java): `RiderService/src/main/java/com/Rapido/RiderService/Repository/VehicleRepository.java`

### Ride State

- [Redis Ride / Location](https://github.com/nani517/riderservice/blob/main/RiderService/src/main/java/com/Rapido/RiderService/Service/RedisService.java): `RiderService/src/main/java/com/Rapido/RiderService/Service/RedisService.java`
- **Redis**

### Other components

- **Rider**
- **CustomerService**

## Connections

- Rider → Rider Controller: sends requests (evidence: `RiderService/src/main/java/com/Rapido/RiderService/Ridercontorller/Ridercontorller.java`)
- Rider Controller → Rider Service: delegates (evidence: `RiderService/src/main/java/com/Rapido/RiderService/Ridercontorller/Ridercontorller.java`)
- Rider Controller → Request / Ride DTOs: accepts / returns (evidence: `RiderService/src/main/java/com/Rapido/RiderService/Ridercontorller/Ridercontorller.java`)
- Rider Service → Request / Ride DTOs: maps data (evidence: `RiderService/src/main/java/com/Rapido/RiderService/Service/RiderServicelayer.java`)
- Rider Service → Rider Repository: reads / writes (evidence: `RiderService/src/main/java/com/Rapido/RiderService/Service/RiderServicelayer.java`)
- Rider Service → Vehicle Repository: saves / deletes (evidence: `RiderService/src/main/java/com/Rapido/RiderService/Service/RiderServicelayer.java`)
- Rider Repository → Rider / Vehicle Entities: stores riders (evidence: `RiderService/src/main/java/com/Rapido/RiderService/Repository/RiderRepository.java`)
- Vehicle Repository → Rider / Vehicle Entities: stores vehicles (evidence: `RiderService/src/main/java/com/Rapido/RiderService/Repository/VehicleRepository.java`)
- Rider Service → Redis Ride / Location: coordinates rides (evidence: `RiderService/src/main/java/com/Rapido/RiderService/Service/RiderServicelayer.java`)
- Redis Ride / Location → Redis: reads / writes (evidence: `RiderService/src/main/java/com/Rapido/RiderService/Service/RedisService.java`)
- Redis Ride / Location → Request / Ride DTOs: builds ride DTOs (evidence: `RiderService/src/main/java/com/Rapido/RiderService/Service/RedisService.java`)
- Rider Service → CustomerService: requests booking updates (evidence: `RiderService/src/main/java/com/Rapido/RiderService/Service/RiderServicelayer.java`)
