# kavyachitluriii/shopease architecture

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

## Overview

ShopEase is a React storefront backed by a Spring Boot API and MongoDB. Shoppers browse and filter products, add items to a locally persisted cart, simulate payment, and view orders; merchants manage inventory, while admins manage users and platform data. Authentication uses JWTs and role-based route protection. The graph includes the documented product areas, but some page and controller implementations were not excerpted, so their API connections are shown as unverified rather than asserted.

Main entry points: [`frontend/src/services/api.js`](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/services/api.js) (API Client), [`frontend/src/App.jsx`](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/App.jsx) (App Routing), [`frontend/src/pages/Cart.jsx`](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/pages/Cart.jsx) (Cart & Checkout), [`frontend/src/context/CartContext.jsx`](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/context/CartContext.jsx) (Cart State)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Storefront"]
  node_app["App Routing<br/>[App.jsx]"]
  node_home["Homepage<br/>[Home.jsx]"]
  node_products["Product Explorer<br/>[Products.jsx]"]
  node_productdetail["Product Details"]
  node_cartstate["Cart State<br/>[CartContext.jsx]"]
  node_cart["Cart &amp; Checkout<br/>[Cart.jsx]"]
  node_payment["Payment Modal"]
  node_orders["Order History<br/>[MyOrders.jsx]"]
  node_toast["Notifications<br/>[Toast.jsx]"]
end

subgraph group_ops["Commerce Portals"]
  node_merchant["Merchant Portal"]
  node_admin["Admin Portal<br/>[AdminDashboard.jsx]"]
end

subgraph group_api["Backend API"]
  node_api_client["API Client<br/>[api.js]"]
  node_adminctl["Admin API"]
  node_productctl["Product API"]
  node_orderctl["Order API"]
end

subgraph group_identity["Identity &amp; Security"]
  node_authstate["Auth Context<br/>[AuthContext.jsx]"]
  node_authctl["Authentication API"]
  node_jwt["JWT Utilities<br/>[JwtUtils.java]"]
  node_userdetails["User Details"]
end

subgraph group_data["MongoDB Persistence"]
  node_userrepo[("User Repository")]
  node_productrepo[("Product Repository")]
  node_orderrepo[("Order Repository")]
end

node_shopper(("Shopper"))
node_mongo[("MongoDB")]

node_shopper -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_products
node_app -->|"protects route"| node_cart
node_app -->|"protects route"| node_orders
node_app -->|"role-gates"| node_merchant
node_app -->|"role-gates"| node_admin
node_products -->|"opens details"| node_productdetail
node_products -->|"adds products"| node_cartstate
node_productdetail -->|"adds products"| node_cartstate
node_cart -->|"updates cart"| node_cartstate
node_cart -->|"opens payment"| node_payment
node_cartstate -->|"persists locally"| node_mongo
node_authstate -->|"calls"| node_api_client
node_authstate -.->|"requests auth"| node_authctl
node_cart -->|"requests orders"| node_api_client
node_orders -.->|"requests history"| node_api_client
node_merchant -->|"requests inventory"| node_api_client
node_admin -->|"requests admin data"| node_api_client
node_api_client -.->|"sends API requests"| node_productctl
node_api_client -.->|"sends API requests"| node_orderctl
node_api_client -.->|"sends API requests"| node_adminctl
node_authctl -->|"creates tokens"| node_jwt
node_authctl -->|"reads and saves"| node_userrepo
node_adminctl -->|"manages users"| node_userrepo
node_productctl -->|"accesses products"| node_productrepo
node_orderctl -->|"accesses orders"| node_orderrepo
node_userdetails -->|"loads users"| node_userrepo
node_userrepo -.->|"stores users"| node_mongo
node_productrepo -.->|"stores products"| node_mongo
node_orderrepo -.->|"stores orders"| node_mongo
node_cart -->|"shows notices"| node_toast
node_admin -->|"shows notices"| node_toast

click node_app "https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/pages/Home.jsx"
click node_products "https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/pages/Products.jsx"
click node_productdetail "https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/components/ProductDetailModal.jsx"
click node_cartstate "https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/context/CartContext.jsx"
click node_cart "https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/pages/Cart.jsx"
click node_payment "https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/components/FakeRazorpayModal.jsx"
click node_orders "https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/pages/MyOrders.jsx"
click node_merchant "https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/pages/MerchantDashboard.jsx"
click node_admin "https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/pages/AdminDashboard.jsx"
click node_toast "https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/components/Toast.jsx"
click node_authstate "https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/context/AuthContext.jsx"
click node_api_client "https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/services/api.js"
click node_authctl "https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/controllers/AuthController.java"
click node_adminctl "https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/controllers/AdminController.java"
click node_productctl "https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/controllers/ProductController.java"
click node_orderctl "https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/controllers/OrderController.java"
click node_jwt "https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/security/JwtUtils.java"
click node_userdetails "https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/security/UserDetailsServiceImpl.java"
click node_userrepo "https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/repositories/UserRepository.java"
click node_productrepo "https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/repositories/ProductRepository.java"
click node_orderrepo "https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/repositories/OrderRepository.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_home,node_products,node_productdetail,node_cartstate,node_cart,node_payment,node_orders,node_toast toneBlue
class node_merchant,node_admin,node_mongo toneAmber
class node_api_client,node_adminctl,node_productctl,node_orderctl toneMint
class node_authstate,node_authctl,node_jwt,node_userdetails toneRose
class node_userrepo,node_productrepo,node_orderrepo,node_shopper toneIndigo
```

## Components

### Storefront

- [App Routing](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Homepage](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Product Explorer](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/pages/Products.jsx): `frontend/src/pages/Products.jsx`
- [Product Details](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/components/ProductDetailModal.jsx): `frontend/src/components/ProductDetailModal.jsx`
- [Cart State](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/context/CartContext.jsx): `frontend/src/context/CartContext.jsx`
- [Cart & Checkout](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/pages/Cart.jsx): `frontend/src/pages/Cart.jsx`
- [Payment Modal](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/components/FakeRazorpayModal.jsx): `frontend/src/components/FakeRazorpayModal.jsx`
- [Order History](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/pages/MyOrders.jsx): `frontend/src/pages/MyOrders.jsx`
- [Notifications](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/components/Toast.jsx): `frontend/src/components/Toast.jsx`

### Commerce Portals

- [Merchant Portal](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/pages/MerchantDashboard.jsx): `frontend/src/pages/MerchantDashboard.jsx`
- [Admin Portal](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`

### Backend API

- [API Client](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Admin API](https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/controllers/AdminController.java): `backend/src/main/java/com/shopease/backend/controllers/AdminController.java`
- [Product API](https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/controllers/ProductController.java): `backend/src/main/java/com/shopease/backend/controllers/ProductController.java`
- [Order API](https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/controllers/OrderController.java): `backend/src/main/java/com/shopease/backend/controllers/OrderController.java`

### Identity & Security

- [Auth Context](https://github.com/kavyachitluriii/shopease/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Authentication API](https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/controllers/AuthController.java): `backend/src/main/java/com/shopease/backend/controllers/AuthController.java`
- [JWT Utilities](https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/security/JwtUtils.java): `backend/src/main/java/com/shopease/backend/security/JwtUtils.java`
- [User Details](https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/security/UserDetailsServiceImpl.java): `backend/src/main/java/com/shopease/backend/security/UserDetailsServiceImpl.java`

### MongoDB Persistence

- [User Repository](https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/repositories/UserRepository.java): `backend/src/main/java/com/shopease/backend/repositories/UserRepository.java`
- [Product Repository](https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/repositories/ProductRepository.java): `backend/src/main/java/com/shopease/backend/repositories/ProductRepository.java`
- [Order Repository](https://github.com/kavyachitluriii/shopease/blob/main/backend/src/main/java/com/shopease/backend/repositories/OrderRepository.java): `backend/src/main/java/com/shopease/backend/repositories/OrderRepository.java`

### Other components

- **Shopper**
- **MongoDB**

## Connections

- Shopper → App Routing: uses (evidence: `frontend/src/App.jsx`)
- App Routing → Homepage: routes to (evidence: `frontend/src/App.jsx`)
- App Routing → Product Explorer: routes to (evidence: `frontend/src/App.jsx`)
- App Routing → Cart & Checkout: protects route (evidence: `frontend/src/App.jsx`)
- App Routing → Order History: protects route (evidence: `frontend/src/App.jsx`)
- App Routing → Merchant Portal: role-gates (evidence: `frontend/src/App.jsx`)
- App Routing → Admin Portal: role-gates (evidence: `frontend/src/App.jsx`)
- Product Explorer → Product Details: opens details (evidence: `frontend/src/pages/Products.jsx`)
- Product Explorer → Cart State: adds products (evidence: `frontend/src/pages/Products.jsx`)
- Product Details → Cart State: adds products (evidence: `frontend/src/components/ProductDetailModal.jsx`)
- Cart & Checkout → Cart State: updates cart (evidence: `frontend/src/pages/Cart.jsx`)
- Cart & Checkout → Payment Modal: opens payment (evidence: `frontend/src/pages/Cart.jsx`)
- Cart State → MongoDB: persists locally (evidence: `frontend/src/context/CartContext.jsx`)
- Auth Context → API Client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Auth Context → Authentication API: requests auth
- Cart & Checkout → API Client: requests orders (evidence: `frontend/src/pages/Cart.jsx`)
- Order History → API Client: requests history (evidence: `frontend/src/pages/MyOrders.jsx`)
- Merchant Portal → API Client: requests inventory (evidence: `frontend/src/pages/MerchantDashboard.jsx`)
- Admin Portal → API Client: requests admin data (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- API Client → Product API: sends API requests
- API Client → Order API: sends API requests
- API Client → Admin API: sends API requests
- Authentication API → JWT Utilities: creates tokens (evidence: `backend/src/main/java/com/shopease/backend/controllers/AuthController.java`)
- Authentication API → User Repository: reads and saves (evidence: `backend/src/main/java/com/shopease/backend/controllers/AuthController.java`)
- Admin API → User Repository: manages users (evidence: `backend/src/main/java/com/shopease/backend/controllers/AdminController.java`)
- Product API → Product Repository: accesses products (evidence: `backend/src/main/java/com/shopease/backend/controllers/ProductController.java`)
- Order API → Order Repository: accesses orders (evidence: `backend/src/main/java/com/shopease/backend/controllers/OrderController.java`)
- User Details → User Repository: loads users (evidence: `backend/src/main/java/com/shopease/backend/security/UserDetailsServiceImpl.java`)
- User Repository → MongoDB: stores users
- Product Repository → MongoDB: stores products
- Order Repository → MongoDB: stores orders
- Cart & Checkout → Notifications: shows notices (evidence: `frontend/src/pages/Cart.jsx`)
- Admin Portal → Notifications: shows notices (evidence: `frontend/src/pages/AdminDashboard.jsx`)
