# krish-2466/e-commerce-project architecture

> Architecture diagram of the GitHub repository krish-2466/e-commerce-project, 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/krish-2466/e-commerce-project
- Repository: https://github.com/krish-2466/e-commerce-project

## Overview

This is a React storefront and admin SPA backed by a Spring Boot REST API. A shopper browses the catalog, manages a cart, checks out with an address and payment, and receives order confirmation; admins and sellers also manage catalog items and order status. The frontend routes views and uses Redux actions/API calls, while the backend follows the documented controller–service–repository layering with MySQL persistence. Some backend modules and payment/image integrations are represented from the README and tree; their detailed call paths were not sampled.

Main entry points: [`sb-ecom/src/main/java/com/ecommerce/project/service`](https://github.com/krish-2466/e-commerce-project/tree/main/sb-ecom/src/main/java/com/ecommerce/project/service) (Domain services), [`ecom-frontend/src/App.jsx`](https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/App.jsx) (App routes), [`ecom-frontend/src/store/actions/index.js`](https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/store/actions/index.js) (API actions), [`sb-ecom/src/main/java/com/ecommerce/project/controller`](https://github.com/krish-2466/e-commerce-project/tree/main/sb-ecom/src/main/java/com/ecommerce/project/controller) (REST controllers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React storefront"]
  node_app["App routes<br/>[App.jsx]"]
  node_store["Redux store<br/>[store.js]"]
  node_actions["API actions<br/>[index.js]"]
  node_api["HTTP client<br/>[api.js]"]
  node_catalogui["Catalog views<br/>[Products.jsx]"]
  node_cartui["Cart and checkout<br/>[Checkout.jsx]"]
  node_adminui["Admin workspace<br/>[AdminLayout.jsx]"]
end

subgraph group_backend["Commerce API"]
  node_controllers["REST controllers"]
  node_productcontroller["Product endpoints"]
  node_cartcontroller["Cart endpoints"]
  node_ordercontroller["Order endpoints"]
  node_services["Domain services"]
  node_models["Commerce entities"]
end

subgraph group_identity["Identity and access"]
  node_authcontroller["Auth endpoints"]
  node_security["JWT security"]
end

subgraph group_persistence["Persistence and integrations"]
  node_repositories["JPA repositories"]
  node_mysql[("MySQL database")]
  node_stripe["Stripe payments"]
  node_files["Image handling"]
end

node_shopper(("Shopper"))

node_shopper -->|"uses"| node_app
node_app -->|"routes to"| node_catalogui
node_app -->|"routes to"| node_cartui
node_app -->|"routes to"| node_adminui
node_app -->|"renders within"| node_store
node_catalogui -.->|"dispatches"| node_actions
node_cartui -.->|"dispatches"| node_actions
node_adminui -.->|"dispatches"| node_actions
node_actions -->|"calls"| node_api
node_api -->|"REST requests"| node_controllers
node_controllers -->|"delegates to"| node_services
node_productcontroller -->|"calls"| node_services
node_cartcontroller -->|"calls"| node_services
node_ordercontroller -->|"calls"| node_services
node_authcontroller -->|"calls"| node_services
node_services -->|"uses"| node_repositories
node_repositories -->|"persists entities"| node_mysql
node_security -->|"protects endpoints"| node_controllers
node_ordercontroller -->|"creates intents"| node_stripe
node_productcontroller -.->|"updates images via service"| node_files

click node_app "https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/App.jsx"
click node_store "https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/store/reducers/store.js"
click node_actions "https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/store/actions/index.js"
click node_api "https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/api/api.js"
click node_catalogui "https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/components/products/Products.jsx"
click node_cartui "https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/components/checkout/Checkout.jsx"
click node_adminui "https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/components/admin/AdminLayout.jsx"
click node_controllers "https://github.com/krish-2466/e-commerce-project/tree/main/sb-ecom/src/main/java/com/ecommerce/project/controller"
click node_productcontroller "https://github.com/krish-2466/e-commerce-project/blob/main/sb-ecom/src/main/java/com/ecommerce/project/controller/ProductController.java"
click node_cartcontroller "https://github.com/krish-2466/e-commerce-project/blob/main/sb-ecom/src/main/java/com/ecommerce/project/controller/CartController.java"
click node_ordercontroller "https://github.com/krish-2466/e-commerce-project/blob/main/sb-ecom/src/main/java/com/ecommerce/project/controller/OrderController.java"
click node_authcontroller "https://github.com/krish-2466/e-commerce-project/blob/main/sb-ecom/src/main/java/com/ecommerce/project/controller/AuthController.java"
click node_services "https://github.com/krish-2466/e-commerce-project/tree/main/sb-ecom/src/main/java/com/ecommerce/project/service"
click node_models "https://github.com/krish-2466/e-commerce-project/tree/main/sb-ecom/src/main/java/com/ecommerce/project/model"
click node_repositories "https://github.com/krish-2466/e-commerce-project/tree/main/sb-ecom/src/main/java/com/ecommerce/project/repositories"
click node_security "https://github.com/krish-2466/e-commerce-project/tree/main/sb-ecom/src/main/java/com/ecommerce/project/security"
click node_stripe "https://github.com/krish-2466/e-commerce-project/blob/main/sb-ecom/src/main/java/com/ecommerce/project/service/StripeServiceImpl.java"
click node_files "https://github.com/krish-2466/e-commerce-project/blob/main/sb-ecom/src/main/java/com/ecommerce/project/service/FileServiceImpl.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_store,node_actions,node_api,node_catalogui,node_cartui,node_adminui toneBlue
class node_controllers,node_productcontroller,node_cartcontroller,node_ordercontroller,node_services,node_models toneAmber
class node_authcontroller,node_security toneMint
class node_repositories,node_mysql,node_stripe,node_files toneRose
class node_shopper toneIndigo
```

## Components

### React storefront

- [App routes](https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/App.jsx): `ecom-frontend/src/App.jsx`
- [Redux store](https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/store/reducers/store.js): `ecom-frontend/src/store/reducers/store.js`
- [API actions](https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/store/actions/index.js): `ecom-frontend/src/store/actions/index.js`
- [HTTP client](https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/api/api.js): `ecom-frontend/src/api/api.js`
- [Catalog views](https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/components/products/Products.jsx): `ecom-frontend/src/components/products/Products.jsx`
- [Cart and checkout](https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/components/checkout/Checkout.jsx): `ecom-frontend/src/components/checkout/Checkout.jsx`
- [Admin workspace](https://github.com/krish-2466/e-commerce-project/blob/main/ecom-frontend/src/components/admin/AdminLayout.jsx): `ecom-frontend/src/components/admin/AdminLayout.jsx`

### Commerce API

- [REST controllers](https://github.com/krish-2466/e-commerce-project/tree/main/sb-ecom/src/main/java/com/ecommerce/project/controller): `sb-ecom/src/main/java/com/ecommerce/project/controller`
- [Product endpoints](https://github.com/krish-2466/e-commerce-project/blob/main/sb-ecom/src/main/java/com/ecommerce/project/controller/ProductController.java): `sb-ecom/src/main/java/com/ecommerce/project/controller/ProductController.java`
- [Cart endpoints](https://github.com/krish-2466/e-commerce-project/blob/main/sb-ecom/src/main/java/com/ecommerce/project/controller/CartController.java): `sb-ecom/src/main/java/com/ecommerce/project/controller/CartController.java`
- [Order endpoints](https://github.com/krish-2466/e-commerce-project/blob/main/sb-ecom/src/main/java/com/ecommerce/project/controller/OrderController.java): `sb-ecom/src/main/java/com/ecommerce/project/controller/OrderController.java`
- [Domain services](https://github.com/krish-2466/e-commerce-project/tree/main/sb-ecom/src/main/java/com/ecommerce/project/service): `sb-ecom/src/main/java/com/ecommerce/project/service`
- [Commerce entities](https://github.com/krish-2466/e-commerce-project/tree/main/sb-ecom/src/main/java/com/ecommerce/project/model): `sb-ecom/src/main/java/com/ecommerce/project/model`

### Identity and access

- [Auth endpoints](https://github.com/krish-2466/e-commerce-project/blob/main/sb-ecom/src/main/java/com/ecommerce/project/controller/AuthController.java): `sb-ecom/src/main/java/com/ecommerce/project/controller/AuthController.java`
- [JWT security](https://github.com/krish-2466/e-commerce-project/tree/main/sb-ecom/src/main/java/com/ecommerce/project/security): `sb-ecom/src/main/java/com/ecommerce/project/security`

### Persistence and integrations

- [JPA repositories](https://github.com/krish-2466/e-commerce-project/tree/main/sb-ecom/src/main/java/com/ecommerce/project/repositories): `sb-ecom/src/main/java/com/ecommerce/project/repositories`
- **MySQL database**
- [Stripe payments](https://github.com/krish-2466/e-commerce-project/blob/main/sb-ecom/src/main/java/com/ecommerce/project/service/StripeServiceImpl.java): `sb-ecom/src/main/java/com/ecommerce/project/service/StripeServiceImpl.java`
- [Image handling](https://github.com/krish-2466/e-commerce-project/blob/main/sb-ecom/src/main/java/com/ecommerce/project/service/FileServiceImpl.java): `sb-ecom/src/main/java/com/ecommerce/project/service/FileServiceImpl.java`

### Other components

- **Shopper**

## Connections

- Shopper → App routes: uses (evidence: `README.md`)
- App routes → Catalog views: routes to (evidence: `ecom-frontend/src/App.jsx`)
- App routes → Cart and checkout: routes to (evidence: `ecom-frontend/src/App.jsx`)
- App routes → Admin workspace: routes to (evidence: `ecom-frontend/src/App.jsx`)
- App routes → Redux store: renders within (evidence: `ecom-frontend/src/main.jsx`)
- Catalog views → API actions: dispatches
- Cart and checkout → API actions: dispatches
- Admin workspace → API actions: dispatches
- API actions → HTTP client: calls (evidence: `ecom-frontend/src/store/actions/index.js`)
- HTTP client → REST controllers: REST requests (evidence: `README.md`)
- REST controllers → Domain services: delegates to (evidence: `README.md`)
- Product endpoints → Domain services: calls (evidence: `sb-ecom/src/main/java/com/ecommerce/project/controller/ProductController.java`)
- Cart endpoints → Domain services: calls (evidence: `sb-ecom/src/main/java/com/ecommerce/project/controller/CartController.java`)
- Order endpoints → Domain services: calls (evidence: `sb-ecom/src/main/java/com/ecommerce/project/controller/OrderController.java`)
- Auth endpoints → Domain services: calls (evidence: `sb-ecom/src/main/java/com/ecommerce/project/controller/AuthController.java`)
- Domain services → JPA repositories: uses (evidence: `README.md`)
- JPA repositories → MySQL database: persists entities (evidence: `README.md`)
- JWT security → REST controllers: protects endpoints (evidence: `README.md`)
- Order endpoints → Stripe payments: creates intents (evidence: `sb-ecom/src/main/java/com/ecommerce/project/controller/OrderController.java`)
- Product endpoints → Image handling: updates images via service
