# shyamkumar-22/paydrive_flutter architecture

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

- Interactive diagram: https://gitdiagram.com/shyamkumar-22/paydrive_flutter
- Repository: https://github.com/shyamkumar-22/paydrive_flutter

## Overview

PayDrive is a cross-platform ride-sharing app backed by a Spring Boot API. The principal workflow is to authenticate, post or find a ride, connect and accept a booking, then pay and track the ride; chat and ratings support the trip lifecycle. The Flutter client’s documented screens and backend capabilities are represented, but its Dart source is absent from the supplied tree. Backend edges are limited to relationships visible in excerpts, source-index references, or the README.

Main entry points: [`backend/src/main/java/com/paydrive/repository`](https://github.com/shyamkumar-22/paydrive_flutter/tree/main/backend/src/main/java/com/paydrive/repository) (JPA repositories), [`flutter_app`](https://github.com/shyamkumar-22/paydrive_flutter/tree/main/flutter_app) (App screens and state), [`backend/src/main/java/com/paydrive/controller/RideController.java`](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/controller/RideController.java) (Ride endpoints), [`backend/src/main/java/com/paydrive/controller/ChatController.java`](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/controller/ChatController.java) (Chat endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Flutter client"]
  node_flutter["App screens and state"]
end

subgraph group_api["REST and realtime API"]
  node_auth_api["Auth endpoints"]
  node_ride_api["Ride endpoints"]
  node_payment_api["Payment endpoints"]
  node_chat_api["Chat endpoints"]
  node_rating_api["Rating endpoints"]
  node_websocket["WebSocket transport"]
end

subgraph group_domain["Ride services"]
  node_ride_service["Ride marketplace<br/>[RideService.java]"]
  node_tracking["Live location tracking"]
  node_payment_service["Payment processing"]
  node_chat_service["Chat messaging<br/>[ChatService.java]"]
  node_rating_service["Ratings<br/>[RatingService.java]"]
end

subgraph group_data["Persistence"]
  node_models["Users, rides, bookings"]
  node_repositories[("JPA repositories")]
end

subgraph group_identity["Identity and security"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_security["JWT security"]
end

node_rider(("Rider or driver"))

node_rider -->|"uses"| node_flutter
node_flutter -->|"authenticates via"| node_auth_api
node_flutter -->|"manages rides via"| node_ride_api
node_flutter -->|"pays via"| node_payment_api
node_flutter -->|"chats via"| node_chat_api
node_flutter -->|"rates via"| node_rating_api
node_auth_api -->|"delegates to"| node_auth_service
node_ride_api -->|"delegates to"| node_ride_service
node_ride_api -->|"delegates to"| node_tracking
node_payment_api -->|"delegates to"| node_payment_service
node_chat_api -->|"delegates to"| node_chat_service
node_rating_api -.->|"delegates to"| node_rating_service
node_chat_api -.->|"supports realtime via"| node_websocket
node_auth_service -->|"reads and writes users"| node_repositories
node_auth_service -->|"issues JWTs with"| node_security
node_ride_service -->|"queries and saves rides"| node_repositories
node_payment_service -->|"records payments"| node_repositories
node_chat_service -->|"stores messages"| node_repositories
node_rating_service -->|"stores ratings"| node_repositories
node_tracking -->|"checks booking and ride"| node_repositories
node_repositories -->|"persists"| node_models

click node_flutter "https://github.com/shyamkumar-22/paydrive_flutter/tree/main/flutter_app"
click node_auth_api "https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/controller/AuthController.java"
click node_ride_api "https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/controller/RideController.java"
click node_payment_api "https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/controller/PaymentController.java"
click node_chat_api "https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/controller/ChatController.java"
click node_rating_api "https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/controller/RatingController.java"
click node_auth_service "https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/service/AuthService.java"
click node_security "https://github.com/shyamkumar-22/paydrive_flutter/tree/main/backend/src/main/java/com/paydrive/security"
click node_ride_service "https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/service/RideService.java"
click node_tracking "https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/service/TrackingService.java"
click node_payment_service "https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/service/PaymentService.java"
click node_chat_service "https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/service/ChatService.java"
click node_rating_service "https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/service/RatingService.java"
click node_models "https://github.com/shyamkumar-22/paydrive_flutter/tree/main/backend/src/main/java/com/paydrive/model"
click node_repositories "https://github.com/shyamkumar-22/paydrive_flutter/tree/main/backend/src/main/java/com/paydrive/repository"
click node_websocket "https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/config/WebSocketConfig.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_flutter toneBlue
class node_auth_api,node_ride_api,node_payment_api,node_chat_api,node_rating_api,node_websocket toneAmber
class node_ride_service,node_tracking,node_payment_service,node_chat_service,node_rating_service toneMint
class node_models,node_repositories toneRose
class node_auth_service,node_security,node_rider toneIndigo
```

## Components

### Flutter client

- [App screens and state](https://github.com/shyamkumar-22/paydrive_flutter/tree/main/flutter_app): `flutter_app`

### REST and realtime API

- [Auth endpoints](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/controller/AuthController.java): `backend/src/main/java/com/paydrive/controller/AuthController.java`
- [Ride endpoints](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/controller/RideController.java): `backend/src/main/java/com/paydrive/controller/RideController.java`
- [Payment endpoints](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/controller/PaymentController.java): `backend/src/main/java/com/paydrive/controller/PaymentController.java`
- [Chat endpoints](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/controller/ChatController.java): `backend/src/main/java/com/paydrive/controller/ChatController.java`
- [Rating endpoints](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/controller/RatingController.java): `backend/src/main/java/com/paydrive/controller/RatingController.java`
- [WebSocket transport](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/config/WebSocketConfig.java): `backend/src/main/java/com/paydrive/config/WebSocketConfig.java`

### Ride services

- [Ride marketplace](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/service/RideService.java): `backend/src/main/java/com/paydrive/service/RideService.java`
- [Live location tracking](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/service/TrackingService.java): `backend/src/main/java/com/paydrive/service/TrackingService.java`
- [Payment processing](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/service/PaymentService.java): `backend/src/main/java/com/paydrive/service/PaymentService.java`
- [Chat messaging](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/service/ChatService.java): `backend/src/main/java/com/paydrive/service/ChatService.java`
- [Ratings](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/service/RatingService.java): `backend/src/main/java/com/paydrive/service/RatingService.java`

### Persistence

- [Users, rides, bookings](https://github.com/shyamkumar-22/paydrive_flutter/tree/main/backend/src/main/java/com/paydrive/model): `backend/src/main/java/com/paydrive/model`
- [JPA repositories](https://github.com/shyamkumar-22/paydrive_flutter/tree/main/backend/src/main/java/com/paydrive/repository): `backend/src/main/java/com/paydrive/repository`

### Identity and security

- [Authentication](https://github.com/shyamkumar-22/paydrive_flutter/blob/main/backend/src/main/java/com/paydrive/service/AuthService.java): `backend/src/main/java/com/paydrive/service/AuthService.java`
- [JWT security](https://github.com/shyamkumar-22/paydrive_flutter/tree/main/backend/src/main/java/com/paydrive/security): `backend/src/main/java/com/paydrive/security`

### Other components

- **Rider or driver**

## Connections

- Rider or driver → App screens and state: uses (evidence: `README.md`)
- App screens and state → Auth endpoints: authenticates via (evidence: `README.md`)
- App screens and state → Ride endpoints: manages rides via (evidence: `README.md`)
- App screens and state → Payment endpoints: pays via (evidence: `README.md`)
- App screens and state → Chat endpoints: chats via (evidence: `README.md`)
- App screens and state → Rating endpoints: rates via (evidence: `README.md`)
- Auth endpoints → Authentication: delegates to (evidence: `backend/src/main/java/com/paydrive/controller/AuthController.java`)
- Ride endpoints → Ride marketplace: delegates to (evidence: `backend/src/main/java/com/paydrive/controller/RideController.java`)
- Ride endpoints → Live location tracking: delegates to (evidence: `backend/src/main/java/com/paydrive/controller/RideController.java`)
- Payment endpoints → Payment processing: delegates to (evidence: `backend/src/main/java/com/paydrive/controller/PaymentController.java`)
- Chat endpoints → Chat messaging: delegates to (evidence: `backend/src/main/java/com/paydrive/controller/ChatController.java`)
- Rating endpoints → Ratings: delegates to
- Chat endpoints → WebSocket transport: supports realtime via
- Authentication → JPA repositories: reads and writes users (evidence: `backend/src/main/java/com/paydrive/service/AuthService.java`)
- Authentication → JWT security: issues JWTs with (evidence: `backend/src/main/java/com/paydrive/service/AuthService.java`)
- Ride marketplace → JPA repositories: queries and saves rides (evidence: `backend/src/main/java/com/paydrive/service/RideService.java`)
- Payment processing → JPA repositories: records payments (evidence: `backend/src/main/java/com/paydrive/service/PaymentService.java`)
- Chat messaging → JPA repositories: stores messages (evidence: `backend/src/main/java/com/paydrive/service/ChatService.java`)
- Ratings → JPA repositories: stores ratings (evidence: `backend/src/main/java/com/paydrive/service/RatingService.java`)
- Live location tracking → JPA repositories: checks booking and ride (evidence: `backend/src/main/java/com/paydrive/service/TrackingService.java`)
- JPA repositories → Users, rides, bookings: persists (evidence: `backend/src/main/java/com/paydrive/repository/RideRepository.java`)
