# koppuladurgaprasad/gowheels architecture

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

## Overview

GoWheels is a full-stack car-rental platform: customers browse vehicles, book rentals, and manage profiles and bookings; administrators manage cars, images, rentals, and their profile. React dashboards call Spring REST controllers through an Axios client, with service/repository layers behind the API. The README documents JWT/Google authentication, Redis caching, Cloudinary media storage, and a MySQL-compatible database. Some backend implementations were not sampled, so their internal links are shown only where the README or source index supports them.

Main entry points: [`GoWheels_Frontend/src/api.js`](https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/api.js) (API client), [`GoWheels_Frontend/src/CustomerDashboard.jsx`](https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/CustomerDashboard.jsx) (Customer dashboard), [`GoWheels_Frontend/src/AdminDashboard.jsx`](https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/AdminDashboard.jsx) (Admin dashboard), [`GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Repository`](https://github.com/koppuladurgaprasad/gowheels/tree/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Repository) (JPA repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["Route application<br/>[App.jsx]"]
  node_customer_dashboard["Customer dashboard"]
  node_admin_dashboard["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_auth_ui["Sign-in UI<br/>[AuthModal.jsx]"]
  node_api["API client<br/>[api.js]"]
  node_profile_ui["Profile views<br/>[Profile.jsx]"]
  node_cars_ui["Car browsing<br/>[Cars.jsx]"]
  node_bookings_ui["Booking views<br/>[Bookings.jsx]"]
end

subgraph group_identity["Identity and profiles"]
  node_auth_controller["Authentication API"]
  node_customer_controller["Customer API"]
  node_admin_controller["Admin API"]
  node_customer_service["Customer services"]
  node_auth_service["Authentication services<br/>[AuthService.java]"]
end

subgraph group_rental["Fleet and rentals"]
  node_car_controller["Car API<br/>[CarController.java]"]
  node_car_service["Car services"]
  node_image_service["Car image services"]
  node_rental_controller["Rental API"]
  node_rental_service["Rental services"]
end

subgraph group_platform["Backend platform"]
  node_security["JWT and access control"]
  node_repositories["JPA repositories"]
  node_database[("MySQL-compatible store")]
  node_redis[("Redis cache")]
  node_cloudinary["Cloudinary media"]
end

node_customer(("Customer"))
node_admin(("Administrator"))

node_customer -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"routes to"| node_customer_dashboard
node_app -->|"routes to"| node_admin_dashboard
node_customer_dashboard -->|"requests data"| node_api
node_admin_dashboard -->|"requests data"| node_api
node_auth_ui -->|"sends requests"| node_api
node_customer_dashboard -->|"renders"| node_cars_ui
node_customer_dashboard -->|"renders"| node_profile_ui
node_customer_dashboard -->|"renders"| node_bookings_ui
node_admin_dashboard -->|"renders"| node_cars_ui
node_admin_dashboard -->|"renders"| node_profile_ui
node_admin_dashboard -->|"renders"| node_bookings_ui
node_api -.->|"calls REST API"| node_auth_controller
node_api -->|"calls REST API"| node_customer_controller
node_api -->|"calls REST API"| node_admin_controller
node_api -->|"calls REST API"| node_car_controller
node_api -->|"calls REST API"| node_rental_controller
node_customer_controller -->|"delegates to"| node_customer_service
node_admin_controller -->|"delegates to"| node_auth_service
node_auth_controller -.->|"delegates to"| node_auth_service
node_customer_controller -->|"uses JWT"| node_security
node_car_controller -->|"delegates to"| node_car_service
node_car_controller -->|"uploads images"| node_image_service
node_rental_controller -->|"delegates to"| node_rental_service
node_customer_service -.->|"persists data"| node_repositories
node_auth_service -->|"looks up accounts"| node_repositories
node_car_service -.->|"persists data"| node_repositories
node_rental_service -.->|"persists data"| node_repositories
node_repositories -->|"reads and writes"| node_database
node_car_service -.->|"caches reads"| node_redis
node_image_service -.->|"stores media"| node_cloudinary

click node_app "https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/App.jsx"
click node_customer_dashboard "https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/CustomerDashboard.jsx"
click node_admin_dashboard "https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/AdminDashboard.jsx"
click node_auth_ui "https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/AuthModal.jsx"
click node_api "https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/api.js"
click node_profile_ui "https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/Profile.jsx"
click node_cars_ui "https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/Cars.jsx"
click node_bookings_ui "https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/Bookings.jsx"
click node_auth_controller "https://github.com/koppuladurgaprasad/gowheels/blob/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/AuthController.java"
click node_customer_controller "https://github.com/koppuladurgaprasad/gowheels/blob/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/CustomerController.java"
click node_admin_controller "https://github.com/koppuladurgaprasad/gowheels/blob/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/AdminController.java"
click node_customer_service "https://github.com/koppuladurgaprasad/gowheels/tree/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service"
click node_auth_service "https://github.com/koppuladurgaprasad/gowheels/blob/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service/AuthService.java"
click node_security "https://github.com/koppuladurgaprasad/gowheels/tree/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Config"
click node_car_controller "https://github.com/koppuladurgaprasad/gowheels/blob/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/CarController.java"
click node_car_service "https://github.com/koppuladurgaprasad/gowheels/tree/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service"
click node_image_service "https://github.com/koppuladurgaprasad/gowheels/tree/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service"
click node_rental_controller "https://github.com/koppuladurgaprasad/gowheels/blob/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/RentalController.java"
click node_rental_service "https://github.com/koppuladurgaprasad/gowheels/tree/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service"
click node_repositories "https://github.com/koppuladurgaprasad/gowheels/tree/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Repository"

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_customer_dashboard,node_admin_dashboard,node_auth_ui,node_api,node_profile_ui,node_cars_ui,node_bookings_ui toneBlue
class node_auth_controller,node_customer_controller,node_admin_controller,node_customer_service,node_auth_service toneAmber
class node_car_controller,node_car_service,node_image_service,node_rental_controller,node_rental_service toneMint
class node_security,node_repositories,node_database,node_redis,node_cloudinary toneRose
class node_customer,node_admin toneIndigo
```

## Components

### React client

- [Route application](https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/App.jsx): `GoWheels_Frontend/src/App.jsx`
- [Customer dashboard](https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/CustomerDashboard.jsx): `GoWheels_Frontend/src/CustomerDashboard.jsx`
- [Admin dashboard](https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/AdminDashboard.jsx): `GoWheels_Frontend/src/AdminDashboard.jsx`
- [Sign-in UI](https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/AuthModal.jsx): `GoWheels_Frontend/src/AuthModal.jsx`
- [API client](https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/api.js): `GoWheels_Frontend/src/api.js`
- [Profile views](https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/Profile.jsx): `GoWheels_Frontend/src/Profile.jsx`
- [Car browsing](https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/Cars.jsx): `GoWheels_Frontend/src/Cars.jsx`
- [Booking views](https://github.com/koppuladurgaprasad/gowheels/blob/main/GoWheels_Frontend/src/Bookings.jsx): `GoWheels_Frontend/src/Bookings.jsx`

### Identity and profiles

- [Authentication API](https://github.com/koppuladurgaprasad/gowheels/blob/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/AuthController.java): `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/AuthController.java`
- [Customer API](https://github.com/koppuladurgaprasad/gowheels/blob/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/CustomerController.java): `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/CustomerController.java`
- [Admin API](https://github.com/koppuladurgaprasad/gowheels/blob/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/AdminController.java): `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/AdminController.java`
- [Customer services](https://github.com/koppuladurgaprasad/gowheels/tree/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service): `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service`
- [Authentication services](https://github.com/koppuladurgaprasad/gowheels/blob/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service/AuthService.java): `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service/AuthService.java`

### Fleet and rentals

- [Car API](https://github.com/koppuladurgaprasad/gowheels/blob/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/CarController.java): `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/CarController.java`
- [Car services](https://github.com/koppuladurgaprasad/gowheels/tree/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service): `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service`
- [Car image services](https://github.com/koppuladurgaprasad/gowheels/tree/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service): `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service`
- [Rental API](https://github.com/koppuladurgaprasad/gowheels/blob/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/RentalController.java): `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/RentalController.java`
- [Rental services](https://github.com/koppuladurgaprasad/gowheels/tree/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service): `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service`

### Backend platform

- [JWT and access control](https://github.com/koppuladurgaprasad/gowheels/tree/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Config): `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Config`
- [JPA repositories](https://github.com/koppuladurgaprasad/gowheels/tree/main/GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Repository): `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Repository`
- **MySQL-compatible store**
- **Redis cache**
- **Cloudinary media**

### Other components

- **Customer**
- **Administrator**

## Connections

- Customer → Route application: uses (evidence: `README.md`)
- Administrator → Route application: uses (evidence: `README.md`)
- Route application → Customer dashboard: routes to (evidence: `GoWheels_Frontend/src/App.jsx`)
- Route application → Admin dashboard: routes to (evidence: `GoWheels_Frontend/src/App.jsx`)
- Customer dashboard → API client: requests data (evidence: `GoWheels_Frontend/src/CustomerDashboard.jsx`)
- Admin dashboard → API client: requests data (evidence: `GoWheels_Frontend/src/AdminDashboard.jsx`)
- Sign-in UI → API client: sends requests (evidence: `GoWheels_Frontend/src/AuthModal.jsx`)
- Customer dashboard → Car browsing: renders (evidence: `GoWheels_Frontend/src/CustomerDashboard.jsx`)
- Customer dashboard → Profile views: renders (evidence: `GoWheels_Frontend/src/CustomerDashboard.jsx`)
- Customer dashboard → Booking views: renders (evidence: `GoWheels_Frontend/src/CustomerDashboard.jsx`)
- Admin dashboard → Car browsing: renders (evidence: `GoWheels_Frontend/src/AdminDashboard.jsx`)
- Admin dashboard → Profile views: renders (evidence: `GoWheels_Frontend/src/AdminDashboard.jsx`)
- Admin dashboard → Booking views: renders (evidence: `GoWheels_Frontend/src/AdminDashboard.jsx`)
- API client → Authentication API: calls REST API
- API client → Customer API: calls REST API
- API client → Admin API: calls REST API
- API client → Car API: calls REST API
- API client → Rental API: calls REST API
- Customer API → Customer services: delegates to (evidence: `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/CustomerController.java`)
- Admin API → Authentication services: delegates to (evidence: `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/AdminController.java`)
- Authentication API → Authentication services: delegates to
- Customer API → JWT and access control: uses JWT (evidence: `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/CustomerController.java`)
- Car API → Car services: delegates to (evidence: `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/CarController.java`)
- Car API → Car image services: uploads images (evidence: `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/CarController.java`)
- Rental API → Rental services: delegates to (evidence: `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Controller/RentalController.java`)
- Customer services → JPA repositories: persists data (evidence: `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service/AuthService.java`)
- Authentication services → JPA repositories: looks up accounts (evidence: `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service/AuthService.java`)
- Car services → JPA repositories: persists data (evidence: `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service/AuthService.java`)
- Rental services → JPA repositories: persists data (evidence: `GOWheels_Backend/src/main/java/com/GoWheels/Car_Rental_System/Service/AuthService.java`)
- JPA repositories → MySQL-compatible store: reads and writes (evidence: `README.md`)
- Car services → Redis cache: caches reads (evidence: `README.md`)
- Car image services → Cloudinary media: stores media (evidence: `README.md`)
