# daksh2004/ridelink architecture

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

- Interactive diagram: https://gitdiagram.com/daksh2004/ridelink
- Repository: https://github.com/daksh2004/ridelink

## Overview

RideLink is a ride-sharing platform: passengers search for rides and request bookings, while drivers offer rides and manage requests; users authenticate and manage profiles, and bookings progress through OTP verification and payment. The repository includes a React client and a Spring backend, plus small Express/Netlify support surfaces. README capabilities and routes establish the product scope; sampled booking and authentication code confirms parts of the backend flow. Several client-to-backend and unsampled service relationships are not evidenced, so they are not shown as verified calls.

Main entry points: [`client/App.tsx`](https://github.com/daksh2004/ridelink/blob/main/client/App.tsx) (Route application), [`backend/src/main/java/com/Ridelink/RideLink/Controller/AuthController.java`](https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Controller/AuthController.java) (Authentication API), [`client/pages/Index.tsx`](https://github.com/daksh2004/ridelink/blob/main/client/pages/Index.tsx) (Ride discovery), [`backend/src/main/java/com/Ridelink/RideLink/Controller/BookingController.java`](https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Controller/BookingController.java) (Booking API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Ride experience"]
  node_app["Route application<br/>[App.tsx]"]
  node_home["Ride discovery<br/>[Index.tsx]"]
  node_search["Ride search<br/>[Search.tsx]"]
  node_post["Offer ride<br/>[PostRide.tsx]"]
  node_bookingui["Booking interface<br/>[BookRide.tsx]"]
  node_passengerdash["Passenger dashboard"]
  node_driverdash["Driver dashboard"]
  node_map["Ride map<br/>[RideMap.tsx]"]
  node_profile["Profile management<br/>[Profile.tsx]"]
end

subgraph group_identity["Identity and access"]
  node_authui["Authentication screens<br/>[Login.tsx]"]
  node_routeguard["Route guards<br/>[ProtectedRoute.tsx]"]
  node_authapi["Authentication API"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
  node_userlookup["User lookup"]
  node_userdata[("User records<br/>[User.java]")]
  node_userrepo[("User repository")]
end

subgraph group_operations["Ride operations"]
  node_kyc["Admin KYC<br/>[AdminKyc.tsx]"]
  node_rideapi["Ride API"]
  node_bookingapi["Booking API"]
  node_bookinglogic["Booking lifecycle"]
  node_bookingdata[("Booking records<br/>[Booking.java]")]
  node_payment["Payment service"]
  node_adminapi["Admin API"]
end

subgraph group_platform["Runtime support"]
  node_fetch["Fetch interceptor"]
  node_express["Express support API<br/>[index.ts]"]
end

node_rider(("Rider / driver"))

node_rider -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_search
node_app -->|"routes to"| node_post
node_app -->|"routes to"| node_bookingui
node_app -->|"routes to"| node_passengerdash
node_app -->|"routes to"| node_driverdash
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_authui
node_app -->|"uses"| node_routeguard
node_home -->|"navigates to"| node_search
node_home -->|"navigates to"| node_post
node_bookingapi -->|"delegates to"| node_bookinglogic
node_bookingapi -->|"requests refund"| node_payment
node_bookinglogic -->|"updates"| node_bookingdata
node_authapi -->|"looks up users"| node_userrepo
node_authapi -->|"generates tokens"| node_jwt
node_authapi -->|"loads identity"| node_userlookup
node_userlookup -->|"finds user"| node_userrepo
node_userrepo -->|"persists"| node_userdata
node_app -->|"loads"| node_fetch
node_rider -.->|"authenticates"| node_authapi
node_rider -.->|"searches and offers"| node_rideapi
node_rider -.->|"requests booking"| node_bookingapi
node_rider -.->|"uses"| node_kyc
node_rideapi -.->|"coordinates rides"| node_bookinglogic

click node_app "https://github.com/daksh2004/ridelink/blob/main/client/App.tsx"
click node_home "https://github.com/daksh2004/ridelink/blob/main/client/pages/Index.tsx"
click node_search "https://github.com/daksh2004/ridelink/blob/main/client/pages/Search.tsx"
click node_post "https://github.com/daksh2004/ridelink/blob/main/client/pages/PostRide.tsx"
click node_bookingui "https://github.com/daksh2004/ridelink/blob/main/client/pages/BookRide.tsx"
click node_passengerdash "https://github.com/daksh2004/ridelink/blob/main/client/pages/PassengerDashboard.tsx"
click node_driverdash "https://github.com/daksh2004/ridelink/blob/main/client/pages/DriverDashboard.tsx"
click node_map "https://github.com/daksh2004/ridelink/blob/main/client/components/RideMap.tsx"
click node_profile "https://github.com/daksh2004/ridelink/blob/main/client/pages/Profile.tsx"
click node_authui "https://github.com/daksh2004/ridelink/blob/main/client/pages/Login.tsx"
click node_routeguard "https://github.com/daksh2004/ridelink/blob/main/client/components/auth/ProtectedRoute.tsx"
click node_authapi "https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Controller/AuthController.java"
click node_jwt "https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Security/JwtUtil.java"
click node_userlookup "https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Security/CustomUserDetailsService.java"
click node_kyc "https://github.com/daksh2004/ridelink/blob/main/client/pages/AdminKyc.tsx"
click node_rideapi "https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Controller/RideController.java"
click node_bookingapi "https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Controller/BookingController.java"
click node_bookinglogic "https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Service/Impl/BookingServiceImpl.java"
click node_bookingdata "https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Entity/Booking.java"
click node_payment "https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Service/Impl/PaymentServiceImpl.java"
click node_adminapi "https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Controller/AdminController.java"
click node_userdata "https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Entity/User.java"
click node_userrepo "https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Repository/UserRepository.java"
click node_fetch "https://github.com/daksh2004/ridelink/blob/main/client/utils/fetchInterceptor.ts"
click node_express "https://github.com/daksh2004/ridelink/blob/main/server/index.ts"

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_app,node_home,node_search,node_post,node_bookingui,node_passengerdash,node_driverdash,node_map,node_profile toneBlue
class node_authui,node_routeguard,node_authapi,node_jwt,node_userlookup,node_userdata,node_userrepo toneAmber
class node_kyc,node_rideapi,node_bookingapi,node_bookinglogic,node_bookingdata,node_payment,node_adminapi toneMint
class node_fetch,node_express toneRose
class node_rider toneIndigo
```

## Components

### Ride experience

- [Route application](https://github.com/daksh2004/ridelink/blob/main/client/App.tsx): `client/App.tsx`
- [Ride discovery](https://github.com/daksh2004/ridelink/blob/main/client/pages/Index.tsx): `client/pages/Index.tsx`
- [Ride search](https://github.com/daksh2004/ridelink/blob/main/client/pages/Search.tsx): `client/pages/Search.tsx`
- [Offer ride](https://github.com/daksh2004/ridelink/blob/main/client/pages/PostRide.tsx): `client/pages/PostRide.tsx`
- [Booking interface](https://github.com/daksh2004/ridelink/blob/main/client/pages/BookRide.tsx): `client/pages/BookRide.tsx`
- [Passenger dashboard](https://github.com/daksh2004/ridelink/blob/main/client/pages/PassengerDashboard.tsx): `client/pages/PassengerDashboard.tsx`
- [Driver dashboard](https://github.com/daksh2004/ridelink/blob/main/client/pages/DriverDashboard.tsx): `client/pages/DriverDashboard.tsx`
- [Ride map](https://github.com/daksh2004/ridelink/blob/main/client/components/RideMap.tsx): `client/components/RideMap.tsx`
- [Profile management](https://github.com/daksh2004/ridelink/blob/main/client/pages/Profile.tsx): `client/pages/Profile.tsx`

### Identity and access

- [Authentication screens](https://github.com/daksh2004/ridelink/blob/main/client/pages/Login.tsx): `client/pages/Login.tsx`
- [Route guards](https://github.com/daksh2004/ridelink/blob/main/client/components/auth/ProtectedRoute.tsx): `client/components/auth/ProtectedRoute.tsx`
- [Authentication API](https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Controller/AuthController.java): `backend/src/main/java/com/Ridelink/RideLink/Controller/AuthController.java`
- [JWT utilities](https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Security/JwtUtil.java): `backend/src/main/java/com/Ridelink/RideLink/Security/JwtUtil.java`
- [User lookup](https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Security/CustomUserDetailsService.java): `backend/src/main/java/com/Ridelink/RideLink/Security/CustomUserDetailsService.java`
- [User records](https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Entity/User.java): `backend/src/main/java/com/Ridelink/RideLink/Entity/User.java`
- [User repository](https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Repository/UserRepository.java): `backend/src/main/java/com/Ridelink/RideLink/Repository/UserRepository.java`

### Ride operations

- [Admin KYC](https://github.com/daksh2004/ridelink/blob/main/client/pages/AdminKyc.tsx): `client/pages/AdminKyc.tsx`
- [Ride API](https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Controller/RideController.java): `backend/src/main/java/com/Ridelink/RideLink/Controller/RideController.java`
- [Booking API](https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Controller/BookingController.java): `backend/src/main/java/com/Ridelink/RideLink/Controller/BookingController.java`
- [Booking lifecycle](https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Service/Impl/BookingServiceImpl.java): `backend/src/main/java/com/Ridelink/RideLink/Service/Impl/BookingServiceImpl.java`
- [Booking records](https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Entity/Booking.java): `backend/src/main/java/com/Ridelink/RideLink/Entity/Booking.java`
- [Payment service](https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Service/Impl/PaymentServiceImpl.java): `backend/src/main/java/com/Ridelink/RideLink/Service/Impl/PaymentServiceImpl.java`
- [Admin API](https://github.com/daksh2004/ridelink/blob/main/backend/src/main/java/com/Ridelink/RideLink/Controller/AdminController.java): `backend/src/main/java/com/Ridelink/RideLink/Controller/AdminController.java`

### Runtime support

- [Fetch interceptor](https://github.com/daksh2004/ridelink/blob/main/client/utils/fetchInterceptor.ts): `client/utils/fetchInterceptor.ts`
- [Express support API](https://github.com/daksh2004/ridelink/blob/main/server/index.ts): `server/index.ts`

### Other components

- **Rider / driver**

## Connections

- Rider / driver → Route application: uses (evidence: `README.md`)
- Route application → Ride discovery: routes to (evidence: `client/App.tsx`)
- Route application → Ride search: routes to (evidence: `client/App.tsx`)
- Route application → Offer ride: routes to (evidence: `client/App.tsx`)
- Route application → Booking interface: routes to (evidence: `client/App.tsx`)
- Route application → Passenger dashboard: routes to (evidence: `client/App.tsx`)
- Route application → Driver dashboard: routes to (evidence: `client/App.tsx`)
- Route application → Profile management: routes to (evidence: `client/App.tsx`)
- Route application → Authentication screens: routes to (evidence: `client/App.tsx`)
- Route application → Route guards: uses (evidence: `client/App.tsx`)
- Ride discovery → Ride search: navigates to (evidence: `client/pages/Index.tsx`)
- Ride discovery → Offer ride: navigates to (evidence: `client/pages/Index.tsx`)
- Booking API → Booking lifecycle: delegates to (evidence: `backend/src/main/java/com/Ridelink/RideLink/Controller/BookingController.java`)
- Booking API → Payment service: requests refund (evidence: `backend/src/main/java/com/Ridelink/RideLink/Controller/BookingController.java`)
- Booking lifecycle → Booking records: updates (evidence: `backend/src/main/java/com/Ridelink/RideLink/Service/Impl/BookingServiceImpl.java`)
- Authentication API → User repository: looks up users (evidence: `backend/src/main/java/com/Ridelink/RideLink/Controller/AuthController.java`)
- Authentication API → JWT utilities: generates tokens (evidence: `backend/src/main/java/com/Ridelink/RideLink/Controller/AuthController.java`)
- Authentication API → User lookup: loads identity (evidence: `backend/src/main/java/com/Ridelink/RideLink/Controller/AuthController.java`)
- User lookup → User repository: finds user (evidence: `backend/src/main/java/com/Ridelink/RideLink/Security/CustomUserDetailsService.java`)
- User repository → User records: persists (evidence: `backend/src/main/java/com/Ridelink/RideLink/Repository/UserRepository.java`)
- Route application → Fetch interceptor: loads (evidence: `client/App.tsx`)
- Rider / driver → Authentication API: authenticates (evidence: `README.md`)
- Rider / driver → Ride API: searches and offers (evidence: `README.md`)
- Rider / driver → Booking API: requests booking (evidence: `README.md`)
- Rider / driver → Admin KYC: uses (evidence: `README.md`)
- Ride API → Booking lifecycle: coordinates rides
