# ravimahto69/e-commerce-project architecture

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

- Interactive diagram: https://gitdiagram.com/ravimahto69/e-commerce-project
- Repository: https://github.com/ravimahto69/e-commerce-project

## Overview

This is a React/Spring Boot/MySQL storefront. Shoppers browse products, authenticate, manage a cart or wishlist, check out, and review orders; administrators manage products and view orders. The graph follows the shown frontend API calls into backend controllers and services, then to persistence. The checkout, wishlist, and order-history capabilities are included from the README and tree, but some implementation links remain undocumented or unsampled, so those connections are marked unverified or omitted.

Main entry points: [`frontend/src/api/axios.jsx`](https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/api/axios.jsx) (HTTP client), [`frontend/src/App.jsx`](https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/App.jsx) (Route shell), [`backend/src/main/java/com/e_commerce/backend/service/OrderService.java`](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/service/OrderService.java) (Order service), [`backend/src/main/java/com/e_commerce/backend/service/AuthService.java`](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/service/AuthService.java) (Authentication service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Storefront UI"]
  node_app["Route shell<br/>[App.jsx]"]
  node_catalogui["Catalog pages<br/>[Home.jsx]"]
  node_productlist["Product listing<br/>[Products.jsx]"]
  node_detail["Product details"]
  node_cartui["Cart page<br/>[Cart.jsx]"]
  node_checkout["Checkout page<br/>[Checkout.jsx]"]
  node_ordersui["Order history<br/>[OrderHistory.jsx]"]
  node_wishlistui["Wishlist page<br/>[Wishlist.jsx]"]
  node_authui["Login and register<br/>[Login.jsx]"]
  node_adminui["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_http["HTTP client<br/>[axios.jsx]"]
end

subgraph group_api["Backend API"]
  node_authcontroller["Auth endpoints"]
  node_productcontroller["Product endpoints"]
  node_cartcontroller["Cart endpoints"]
  node_wishlistcontroller["Wishlist endpoints"]
  node_ordercontroller["Order endpoints"]
  node_admincontroller["Admin endpoints"]
end

subgraph group_identity["Identity and access"]
  node_authservice["Authentication service<br/>[AuthService.java]"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
  node_security["Security filter and config"]
end

subgraph group_commerce["Commerce services"]
  node_productservice["Product service"]
  node_cartservice["Cart service<br/>[CartService.java]"]
  node_orderservice["Order service<br/>[OrderService.java]"]
  node_wishlistservice["Wishlist service"]
end

subgraph group_persistence["MySQL persistence"]
  node_products[("Products<br/>[Product.java]")]
  node_cartdata[("Cart items<br/>[Cart.java]")]
  node_ordersdata[("Orders<br/>[Order.java]")]
  node_wishlistdata[("Wishlist items<br/>[WishListItem.java]")]
  node_users[("Users<br/>[User.java]")]
  node_backendorderitems[("Order items<br/>[OrderItem.java]")]
end

node_shopper(("Shopper"))
node_admin(("Administrator"))

node_shopper -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"routes"| node_catalogui
node_app -->|"routes"| node_productlist
node_app -->|"routes"| node_detail
node_app -->|"routes"| node_cartui
node_app -->|"routes"| node_checkout
node_app -->|"routes"| node_ordersui
node_app -->|"routes"| node_wishlistui
node_app -->|"routes"| node_authui
node_app -->|"routes"| node_adminui
node_catalogui -->|"requests"| node_http
node_cartui -->|"requests"| node_http
node_checkout -->|"requests"| node_http
node_ordersui -->|"requests"| node_http
node_authui -->|"requests"| node_http
node_adminui -->|"requests"| node_http
node_http -.->|"calls"| node_authcontroller
node_http -.->|"calls"| node_productcontroller
node_http -.->|"calls"| node_cartcontroller
node_http -.->|"calls"| node_wishlistcontroller
node_http -.->|"calls"| node_ordercontroller
node_http -.->|"calls"| node_admincontroller
node_authcontroller -->|"delegates"| node_authservice
node_authservice -->|"reads and writes"| node_users
node_authservice -->|"creates tokens"| node_jwt
node_security -.->|"validates tokens"| node_jwt
node_productcontroller -->|"delegates"| node_productservice
node_productservice -->|"queries"| node_products
node_cartcontroller -->|"delegates"| node_cartservice
node_cartservice -->|"looks up"| node_products
node_cartservice -->|"reads and writes"| node_cartdata
node_wishlistcontroller -->|"delegates"| node_wishlistservice
node_wishlistservice -->|"reads and writes"| node_wishlistdata
node_ordercontroller -.->|"delegates"| node_orderservice
node_orderservice -->|"reads and clears"| node_cartdata
node_orderservice -->|"saves and queries"| node_ordersdata
node_orderservice -.->|"creates items"| node_backendorderitems
node_admincontroller -->|"manages"| node_products

click node_app "https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/App.jsx"
click node_catalogui "https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/Home.jsx"
click node_productlist "https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/Products.jsx"
click node_detail "https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/ProductsDeatils.jsx"
click node_cartui "https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/Cart.jsx"
click node_checkout "https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/Checkout.jsx"
click node_ordersui "https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/OrderHistory.jsx"
click node_wishlistui "https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/Wishlist.jsx"
click node_authui "https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/Login.jsx"
click node_adminui "https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/AdminDashboard.jsx"
click node_http "https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/api/axios.jsx"
click node_authcontroller "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/controller/AuthController.java"
click node_productcontroller "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/controller/ProductController.java"
click node_cartcontroller "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/controller/CartController.java"
click node_wishlistcontroller "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/controller/WishListController.java"
click node_ordercontroller "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/controller/OrderController.java"
click node_admincontroller "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/controller/AdminController.java"
click node_authservice "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/service/AuthService.java"
click node_jwt "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/security/JwtUtil.java"
click node_security "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/security/JwtAuthenticationFilter.java"
click node_productservice "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/service/ProductService.java"
click node_cartservice "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/service/CartService.java"
click node_orderservice "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/service/OrderService.java"
click node_wishlistservice "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/service/WishListService.java"
click node_products "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/entity/Product.java"
click node_cartdata "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/entity/Cart.java"
click node_ordersdata "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/entity/Order.java"
click node_wishlistdata "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/entity/WishListItem.java"
click node_users "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/entity/User.java"
click node_backendorderitems "https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/entity/OrderItem.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_app,node_catalogui,node_productlist,node_detail,node_cartui,node_checkout,node_ordersui,node_wishlistui,node_authui,node_adminui,node_http toneBlue
class node_authcontroller,node_productcontroller,node_cartcontroller,node_wishlistcontroller,node_ordercontroller,node_admincontroller toneAmber
class node_authservice,node_jwt,node_security toneMint
class node_productservice,node_cartservice,node_orderservice,node_wishlistservice toneRose
class node_products,node_cartdata,node_ordersdata,node_wishlistdata,node_users,node_backendorderitems,node_shopper,node_admin toneIndigo
```

## Components

### Storefront UI

- [Route shell](https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Catalog pages](https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Product listing](https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/Products.jsx): `frontend/src/pages/Products.jsx`
- [Product details](https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/ProductsDeatils.jsx): `frontend/src/pages/ProductsDeatils.jsx`
- [Cart page](https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/Cart.jsx): `frontend/src/pages/Cart.jsx`
- [Checkout page](https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/Checkout.jsx): `frontend/src/pages/Checkout.jsx`
- [Order history](https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/OrderHistory.jsx): `frontend/src/pages/OrderHistory.jsx`
- [Wishlist page](https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/Wishlist.jsx): `frontend/src/pages/Wishlist.jsx`
- [Login and register](https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Admin dashboard](https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`
- [HTTP client](https://github.com/ravimahto69/e-commerce-project/blob/main/frontend/src/api/axios.jsx): `frontend/src/api/axios.jsx`

### Backend API

- [Auth endpoints](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/controller/AuthController.java): `backend/src/main/java/com/e_commerce/backend/controller/AuthController.java`
- [Product endpoints](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/controller/ProductController.java): `backend/src/main/java/com/e_commerce/backend/controller/ProductController.java`
- [Cart endpoints](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/controller/CartController.java): `backend/src/main/java/com/e_commerce/backend/controller/CartController.java`
- [Wishlist endpoints](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/controller/WishListController.java): `backend/src/main/java/com/e_commerce/backend/controller/WishListController.java`
- [Order endpoints](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/controller/OrderController.java): `backend/src/main/java/com/e_commerce/backend/controller/OrderController.java`
- [Admin endpoints](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/controller/AdminController.java): `backend/src/main/java/com/e_commerce/backend/controller/AdminController.java`

### Identity and access

- [Authentication service](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/service/AuthService.java): `backend/src/main/java/com/e_commerce/backend/service/AuthService.java`
- [JWT utilities](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/security/JwtUtil.java): `backend/src/main/java/com/e_commerce/backend/security/JwtUtil.java`
- [Security filter and config](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/security/JwtAuthenticationFilter.java): `backend/src/main/java/com/e_commerce/backend/security/JwtAuthenticationFilter.java`

### Commerce services

- [Product service](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/service/ProductService.java): `backend/src/main/java/com/e_commerce/backend/service/ProductService.java`
- [Cart service](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/service/CartService.java): `backend/src/main/java/com/e_commerce/backend/service/CartService.java`
- [Order service](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/service/OrderService.java): `backend/src/main/java/com/e_commerce/backend/service/OrderService.java`
- [Wishlist service](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/service/WishListService.java): `backend/src/main/java/com/e_commerce/backend/service/WishListService.java`

### MySQL persistence

- [Products](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/entity/Product.java): `backend/src/main/java/com/e_commerce/backend/entity/Product.java`
- [Cart items](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/entity/Cart.java): `backend/src/main/java/com/e_commerce/backend/entity/Cart.java`
- [Orders](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/entity/Order.java): `backend/src/main/java/com/e_commerce/backend/entity/Order.java`
- [Wishlist items](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/entity/WishListItem.java): `backend/src/main/java/com/e_commerce/backend/entity/WishListItem.java`
- [Users](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/entity/User.java): `backend/src/main/java/com/e_commerce/backend/entity/User.java`
- [Order items](https://github.com/ravimahto69/e-commerce-project/blob/main/backend/src/main/java/com/e_commerce/backend/entity/OrderItem.java): `backend/src/main/java/com/e_commerce/backend/entity/OrderItem.java`

### Other components

- **Shopper**
- **Administrator**

## Connections

- Shopper → Route shell: uses (evidence: `frontend/src/App.jsx`)
- Administrator → Route shell: uses (evidence: `frontend/src/App.jsx`)
- Route shell → Catalog pages: routes (evidence: `frontend/src/App.jsx`)
- Route shell → Product listing: routes (evidence: `frontend/src/App.jsx`)
- Route shell → Product details: routes (evidence: `frontend/src/App.jsx`)
- Route shell → Cart page: routes (evidence: `frontend/src/App.jsx`)
- Route shell → Checkout page: routes (evidence: `frontend/src/App.jsx`)
- Route shell → Order history: routes (evidence: `frontend/src/App.jsx`)
- Route shell → Wishlist page: routes (evidence: `frontend/src/App.jsx`)
- Route shell → Login and register: routes (evidence: `frontend/src/App.jsx`)
- Route shell → Admin dashboard: routes (evidence: `frontend/src/App.jsx`)
- Catalog pages → HTTP client: requests (evidence: `frontend/src/pages/Home.jsx`)
- Cart page → HTTP client: requests (evidence: `frontend/src/pages/Cart.jsx`)
- Checkout page → HTTP client: requests (evidence: `frontend/src/pages/Checkout.jsx`)
- Order history → HTTP client: requests (evidence: `frontend/src/pages/OrderHistory.jsx`)
- Login and register → HTTP client: requests (evidence: `frontend/src/pages/Login.jsx`)
- Admin dashboard → HTTP client: requests (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- HTTP client → Auth endpoints: calls
- HTTP client → Product endpoints: calls
- HTTP client → Cart endpoints: calls
- HTTP client → Wishlist endpoints: calls
- HTTP client → Order endpoints: calls
- HTTP client → Admin endpoints: calls
- Auth endpoints → Authentication service: delegates (evidence: `backend/src/main/java/com/e_commerce/backend/controller/AuthController.java`)
- Authentication service → Users: reads and writes (evidence: `backend/src/main/java/com/e_commerce/backend/service/AuthService.java`)
- Authentication service → JWT utilities: creates tokens (evidence: `backend/src/main/java/com/e_commerce/backend/service/AuthService.java`)
- Security filter and config → JWT utilities: validates tokens
- Product endpoints → Product service: delegates (evidence: `backend/src/main/java/com/e_commerce/backend/controller/ProductController.java`)
- Product service → Products: queries (evidence: `backend/src/main/java/com/e_commerce/backend/service/ProductService.java`)
- Cart endpoints → Cart service: delegates (evidence: `backend/src/main/java/com/e_commerce/backend/controller/CartController.java`)
- Cart service → Products: looks up (evidence: `backend/src/main/java/com/e_commerce/backend/service/CartService.java`)
- Cart service → Cart items: reads and writes (evidence: `backend/src/main/java/com/e_commerce/backend/service/CartService.java`)
- Wishlist endpoints → Wishlist service: delegates (evidence: `backend/src/main/java/com/e_commerce/backend/controller/WishListController.java`)
- Wishlist service → Wishlist items: reads and writes (evidence: `backend/src/main/java/com/e_commerce/backend/service/WishListService.java`)
- Order endpoints → Order service: delegates
- Order service → Cart items: reads and clears (evidence: `backend/src/main/java/com/e_commerce/backend/service/OrderService.java`)
- Order service → Orders: saves and queries (evidence: `backend/src/main/java/com/e_commerce/backend/service/OrderService.java`)
- Order service → Order items: creates items (evidence: `backend/src/main/java/com/e_commerce/backend/service/OrderService.java`)
- Admin endpoints → Products: manages (evidence: `backend/src/main/java/com/e_commerce/backend/controller/AdminController.java`)
