# prasannagvt01/salessavvy-ecommerce architecture

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

- Interactive diagram: https://gitdiagram.com/prasannagvt01/salessavvy-ecommerce
- Repository: https://github.com/prasannagvt01/salessavvy-ecommerce

## Overview

SalesSavvy is a full-stack e-commerce application: customers browse a catalog, manage carts and accounts, place orders, and pay; administrators manage products, orders, stock, and store operations. The React frontend communicates with Spring REST APIs, whose services implement domain logic and persist through JPA to MySQL. Payment verification, email, reviews, and reporting are important additional capabilities. The graph combines excerpted calls with README-documented capabilities; several backend and frontend subsystems were not sampled, so their internal links are omitted or marked unverified.

Main entry points: [`frontend/src/services/api.js`](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/frontend/src/services/api.js) (Axios API), [`backend/src/main/java/com/ecommerce/service/OrderService.java`](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/OrderService.java) (Order Service), [`backend/src/main/java/com/ecommerce/service/AuthService.java`](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/AuthService.java) (Authentication Service), [`backend/src/main/java/com/ecommerce/controller/ProductController.java`](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/controller/ProductController.java) (Product API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_react["React Storefront<br/>[App.jsx]"]
  node_api["Axios API<br/>[api.js]"]
  node_catalog_ui["Catalog &amp; Product UI<br/>[Products.jsx]"]
  node_checkout_ui["Cart &amp; Checkout<br/>[Checkout.jsx]"]
end

subgraph group_identity["Identity"]
  node_auth_ui["Account UI<br/>[authStore.js]"]
  node_auth_api["Authentication API"]
  node_auth_service["Authentication Service<br/>[AuthService.java]"]
  node_jwt["JWT Security"]
end

subgraph group_commerce["Commerce"]
  node_product_api["Product API"]
  node_product_service["Catalog Service"]
  node_cart_service["Cart Service<br/>[CartService.java]"]
  node_order_api["Order API"]
  node_order_service["Order Service<br/>[OrderService.java]"]
  node_payment_service["Payment Service"]
  node_review_service["Reviews<br/>[ReviewService.java]"]
end

subgraph group_operations["Store Operations"]
  node_admin_ui["Admin Console<br/>[Dashboard.jsx]"]
  node_admin_api["Admin API"]
  node_inventory["Inventory Service"]
  node_admin_services["Admin &amp; Reporting"]
end

subgraph group_backend["Backend Platform"]
  node_mail["Mail Service<br/>[MailService.java]"]
end

node_customer(("Customer"))
node_razorpay{{"Razorpay"}}
node_mysql[("MySQL Database")]

node_customer -->|"uses"| node_react
node_react -.->|"requests data"| node_api
node_api -.->|"calls REST APIs"| node_auth_api
node_api -.->|"calls REST APIs"| node_product_api
node_api -.->|"calls REST APIs"| node_order_api
node_auth_ui -->|"uses"| node_api
node_auth_api -.->|"delegates to"| node_auth_service
node_auth_service -->|"issues tokens"| node_jwt
node_auth_service -->|"sends welcome mail"| node_mail
node_catalog_ui -.->|"requests catalog"| node_api
node_product_api -->|"calls"| node_product_service
node_checkout_ui -.->|"starts checkout"| node_api
node_order_api -.->|"delegates to"| node_order_service
node_order_service -->|"initiates payment"| node_payment_service
node_payment_service -->|"creates and verifies"| node_razorpay
node_order_service -->|"updates stock"| node_inventory
node_order_service -->|"sends order notices"| node_mail
node_product_api -->|"gets product reviews"| node_review_service
node_admin_ui -.->|"requests administration"| node_api
node_admin_api -->|"delegates operations"| node_admin_services
node_product_service -.->|"persists catalog"| node_mysql
node_order_service -.->|"persists orders"| node_mysql
node_auth_service -.->|"persists accounts"| node_mysql
node_admin_services -.->|"reads operational data"| node_mysql

click node_react "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/frontend/src/App.jsx"
click node_api "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/frontend/src/services/api.js"
click node_catalog_ui "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/frontend/src/pages/Products.jsx"
click node_checkout_ui "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/frontend/src/pages/Checkout.jsx"
click node_auth_ui "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/frontend/src/store/authStore.js"
click node_auth_api "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/controller/AuthController.java"
click node_auth_service "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/AuthService.java"
click node_jwt "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/security/JwtTokenProvider.java"
click node_product_api "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/controller/ProductController.java"
click node_product_service "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/ProductService.java"
click node_cart_service "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/CartService.java"
click node_order_api "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/controller/OrderController.java"
click node_order_service "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/OrderService.java"
click node_payment_service "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/PaymentService.java"
click node_review_service "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/ReviewService.java"
click node_admin_ui "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/frontend/src/pages/admin/Dashboard.jsx"
click node_admin_api "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/controller/AdminController.java"
click node_inventory "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/InventoryService.java"
click node_admin_services "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/DashboardService.java"
click node_mail "https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/MailService.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_react,node_api,node_catalog_ui,node_checkout_ui toneBlue
class node_auth_ui,node_auth_api,node_auth_service,node_jwt,node_mysql toneAmber
class node_product_api,node_product_service,node_cart_service,node_order_api,node_order_service,node_payment_service,node_review_service toneMint
class node_admin_ui,node_admin_api,node_inventory,node_admin_services toneRose
class node_mail,node_customer,node_razorpay toneIndigo
```

## Components

### Storefront

- [React Storefront](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Axios API](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Catalog & Product UI](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/frontend/src/pages/Products.jsx): `frontend/src/pages/Products.jsx`
- [Cart & Checkout](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/frontend/src/pages/Checkout.jsx): `frontend/src/pages/Checkout.jsx`

### Identity

- [Account UI](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/frontend/src/store/authStore.js): `frontend/src/store/authStore.js`
- [Authentication API](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/controller/AuthController.java): `backend/src/main/java/com/ecommerce/controller/AuthController.java`
- [Authentication Service](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/AuthService.java): `backend/src/main/java/com/ecommerce/service/AuthService.java`
- [JWT Security](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/security/JwtTokenProvider.java): `backend/src/main/java/com/ecommerce/security/JwtTokenProvider.java`

### Commerce

- [Product API](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/controller/ProductController.java): `backend/src/main/java/com/ecommerce/controller/ProductController.java`
- [Catalog Service](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/ProductService.java): `backend/src/main/java/com/ecommerce/service/ProductService.java`
- [Cart Service](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/CartService.java): `backend/src/main/java/com/ecommerce/service/CartService.java`
- [Order API](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/controller/OrderController.java): `backend/src/main/java/com/ecommerce/controller/OrderController.java`
- [Order Service](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/OrderService.java): `backend/src/main/java/com/ecommerce/service/OrderService.java`
- [Payment Service](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/PaymentService.java): `backend/src/main/java/com/ecommerce/service/PaymentService.java`
- [Reviews](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/ReviewService.java): `backend/src/main/java/com/ecommerce/service/ReviewService.java`

### Store Operations

- [Admin Console](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/frontend/src/pages/admin/Dashboard.jsx): `frontend/src/pages/admin/Dashboard.jsx`
- [Admin API](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/controller/AdminController.java): `backend/src/main/java/com/ecommerce/controller/AdminController.java`
- [Inventory Service](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/InventoryService.java): `backend/src/main/java/com/ecommerce/service/InventoryService.java`
- [Admin & Reporting](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/DashboardService.java): `backend/src/main/java/com/ecommerce/service/DashboardService.java`

### Backend Platform

- [Mail Service](https://github.com/prasannagvt01/salessavvy-ecommerce/blob/main/backend/src/main/java/com/ecommerce/service/MailService.java): `backend/src/main/java/com/ecommerce/service/MailService.java`

### Other components

- **Customer**
- **Razorpay**
- **MySQL Database**

## Connections

- Customer → React Storefront: uses
- React Storefront → Axios API: requests data
- Axios API → Authentication API: calls REST APIs
- Axios API → Product API: calls REST APIs
- Axios API → Order API: calls REST APIs
- Account UI → Axios API: uses (evidence: `frontend/src/store/authStore.js`)
- Authentication API → Authentication Service: delegates to
- Authentication Service → JWT Security: issues tokens (evidence: `backend/src/main/java/com/ecommerce/service/AuthService.java`)
- Authentication Service → Mail Service: sends welcome mail (evidence: `backend/src/main/java/com/ecommerce/service/AuthService.java`)
- Catalog & Product UI → Axios API: requests catalog
- Product API → Catalog Service: calls (evidence: `backend/src/main/java/com/ecommerce/controller/ProductController.java`)
- Cart & Checkout → Axios API: starts checkout
- Order API → Order Service: delegates to
- Order Service → Payment Service: initiates payment (evidence: `backend/src/main/java/com/ecommerce/service/OrderService.java`)
- Payment Service → Razorpay: creates and verifies
- Order Service → Inventory Service: updates stock (evidence: `backend/src/main/java/com/ecommerce/service/OrderService.java`)
- Order Service → Mail Service: sends order notices (evidence: `backend/src/main/java/com/ecommerce/service/OrderService.java`)
- Product API → Reviews: gets product reviews (evidence: `backend/src/main/java/com/ecommerce/controller/ProductController.java`)
- Admin Console → Axios API: requests administration
- Admin API → Admin & Reporting: delegates operations (evidence: `backend/src/main/java/com/ecommerce/controller/AdminController.java`)
- Catalog Service → MySQL Database: persists catalog
- Order Service → MySQL Database: persists orders
- Authentication Service → MySQL Database: persists accounts
- Admin & Reporting → MySQL Database: reads operational data
