# trupsm/e-commerce-website- architecture

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

- Interactive diagram: https://gitdiagram.com/trupsm/e-commerce-website-
- Repository: https://github.com/trupsm/e-commerce-website-

## Overview

Vyoma is a MERN storefront supporting account and address management, product discovery, guest-to-account cart synchronization, and transactional checkout with Stripe payments and order tracking. The primary journey runs from browsing products through cart and checkout to order history/details; admins also manage catalog and order status. Edges reflect the supplied README, source excerpts, or SOURCE INDEX references; unsampled frontend pages and integrations are represented at their listed paths, but their internal calls are not inferred.

Main entry points: [`frontend/src/App.jsx`](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/App.jsx) (SPA Routing), [`backend/server.js`](https://github.com/trupsm/e-commerce-website-/blob/main/backend/server.js) (Express API), [`backend/controllers/orderController.js`](https://github.com/trupsm/e-commerce-website-/blob/main/backend/controllers/orderController.js) (Order Logic), [`frontend/src/api/axiosInstance.js`](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/api/axiosInstance.js) (REST Transport)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Storefront"]
  node_app["SPA Routing<br/>[App.jsx]"]
  node_authui["Account Pages"]
  node_catalogui["Catalog Pages<br/>[Products.jsx]"]
  node_productviews["Product Views"]
  node_cartui["Cart Page<br/>[Cart.jsx]"]
  node_checkoutui["Checkout<br/>[Checkout.jsx]"]
  node_paymentui["Stripe Form"]
  node_orderui["Order Pages<br/>[OrderHistory.jsx]"]
  node_authstate["Auth State<br/>[AuthContext.jsx]"]
  node_cartstate["Cart State<br/>[CartContext.jsx]"]
  node_authapi["Auth Client<br/>[authApi.js]"]
  node_cartapi["Cart Client<br/>[cartApi.js]"]
  node_orderapi["Order Client<br/>[orderApi.js]"]
  node_productapi["Product Client<br/>[productApi.js]"]
  node_http["REST Transport<br/>[axiosInstance.js]"]
end

subgraph group_api["Commerce API"]
  node_server["Express API<br/>[server.js]"]
  node_authroutes["Auth Routes<br/>[authRoutes.js]"]
  node_catalogroutes["Catalog Routes<br/>[productRoutes.js]"]
  node_cartroutes["Cart Routes<br/>[cartRoutes.js]"]
  node_orderroutes["Order Routes<br/>[orderRoutes.js]"]
  node_paymentroutes["Payment Routes<br/>[paymentRoutes.js]"]
  node_authmw["JWT Authentication<br/>[authMiddleware.js]"]
  node_rolemw["Role Access<br/>[roleMiddleware.js]"]
end

subgraph group_domain["Commerce Domain"]
  node_authctrl["Account Logic<br/>[authController.js]"]
  node_cartctrl["Cart Logic<br/>[cartController.js]"]
  node_productctrl["Catalog Logic"]
  node_categoryctrl["Category Logic"]
  node_orderctrl["Order Logic<br/>[orderController.js]"]
  node_paymentctrl["Payment Webhook"]
end

subgraph group_persistence["Data and Payments"]
  node_users[("Users<br/>[User.js]")]
  node_products[("Products<br/>[Product.js]")]
  node_categories[("Categories<br/>[Category.js]")]
  node_carts[("Carts<br/>[Cart.js]")]
end

node_shopper(("Shopper"))

node_shopper -->|"uses"| node_app
node_app -->|"provides session"| node_authstate
node_app -->|"provides cart"| node_cartstate
node_app -->|"routes"| node_authui
node_app -->|"routes"| node_catalogui
node_app -->|"routes"| node_cartui
node_app -->|"routes"| node_checkoutui
node_app -->|"routes"| node_orderui
node_catalogui -.->|"renders"| node_productviews
node_authstate -->|"calls"| node_authapi
node_cartstate -->|"calls"| node_cartapi
node_cartui -->|"uses"| node_cartstate
node_checkoutui -->|"calls"| node_orderapi
node_checkoutui -->|"renders"| node_paymentui
node_authapi -->|"uses"| node_http
node_cartapi -->|"uses"| node_http
node_orderapi -.->|"uses"| node_http
node_productapi -.->|"uses"| node_http
node_http -->|"REST requests"| node_server
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_catalogroutes
node_server -->|"mounts"| node_cartroutes
node_server -->|"mounts"| node_orderroutes
node_server -->|"mounts"| node_paymentroutes
node_authroutes -->|"routes to"| node_authctrl
node_catalogroutes -->|"routes to"| node_productctrl
node_cartroutes -->|"routes to"| node_cartctrl
node_orderroutes -->|"routes to"| node_orderctrl
node_paymentroutes -->|"routes to"| node_paymentctrl
node_authroutes -->|"guards"| node_authmw
node_cartroutes -->|"guards"| node_authmw
node_orderroutes -->|"guards"| node_authmw
node_catalogroutes -->|"guards admin"| node_authmw
node_catalogroutes -->|"checks role"| node_rolemw
node_authctrl -->|"reads/writes"| node_users
node_authmw -->|"loads user"| node_users
node_cartctrl -->|"reads/writes"| node_carts
node_cartctrl -->|"checks stock"| node_products
node_productctrl -->|"manages"| node_products
node_productctrl -->|"queries"| node_categories
node_categoryctrl -->|"manages"| node_categories
node_orderctrl -->|"loads cart"| node_carts
node_orderctrl -->|"validates and updates"| node_products
node_orderctrl -->|"clears cart"| node_carts
node_orderctrl -.->|"payment lifecycle"| node_paymentctrl
node_orderctrl -.->|"creates intent"| node_paymentroutes
node_paymentctrl -->|"updates stock"| node_products
node_paymentctrl -->|"updates cart"| node_carts

click node_app "https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/trupsm/e-commerce-website-/tree/main/frontend/src/pages"
click node_catalogui "https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/pages/Products.jsx"
click node_productviews "https://github.com/trupsm/e-commerce-website-/tree/main/frontend/src/components/product"
click node_cartui "https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/pages/Cart.jsx"
click node_checkoutui "https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/pages/Checkout.jsx"
click node_paymentui "https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/components/payment/StripeCheckoutForm.jsx"
click node_orderui "https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/pages/OrderHistory.jsx"
click node_authstate "https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/context/AuthContext.jsx"
click node_cartstate "https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/context/CartContext.jsx"
click node_authapi "https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/api/authApi.js"
click node_cartapi "https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/api/cartApi.js"
click node_orderapi "https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/api/orderApi.js"
click node_productapi "https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/api/productApi.js"
click node_http "https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/api/axiosInstance.js"
click node_server "https://github.com/trupsm/e-commerce-website-/blob/main/backend/server.js"
click node_authroutes "https://github.com/trupsm/e-commerce-website-/blob/main/backend/routes/authRoutes.js"
click node_catalogroutes "https://github.com/trupsm/e-commerce-website-/blob/main/backend/routes/productRoutes.js"
click node_cartroutes "https://github.com/trupsm/e-commerce-website-/blob/main/backend/routes/cartRoutes.js"
click node_orderroutes "https://github.com/trupsm/e-commerce-website-/blob/main/backend/routes/orderRoutes.js"
click node_paymentroutes "https://github.com/trupsm/e-commerce-website-/blob/main/backend/routes/paymentRoutes.js"
click node_authctrl "https://github.com/trupsm/e-commerce-website-/blob/main/backend/controllers/authController.js"
click node_cartctrl "https://github.com/trupsm/e-commerce-website-/blob/main/backend/controllers/cartController.js"
click node_productctrl "https://github.com/trupsm/e-commerce-website-/blob/main/backend/controllers/productController.js"
click node_categoryctrl "https://github.com/trupsm/e-commerce-website-/blob/main/backend/controllers/categoryController.js"
click node_orderctrl "https://github.com/trupsm/e-commerce-website-/blob/main/backend/controllers/orderController.js"
click node_paymentctrl "https://github.com/trupsm/e-commerce-website-/blob/main/backend/controllers/paymentController.js"
click node_authmw "https://github.com/trupsm/e-commerce-website-/blob/main/backend/middleware/authMiddleware.js"
click node_rolemw "https://github.com/trupsm/e-commerce-website-/blob/main/backend/middleware/roleMiddleware.js"
click node_users "https://github.com/trupsm/e-commerce-website-/blob/main/backend/models/User.js"
click node_products "https://github.com/trupsm/e-commerce-website-/blob/main/backend/models/Product.js"
click node_categories "https://github.com/trupsm/e-commerce-website-/blob/main/backend/models/Category.js"
click node_carts "https://github.com/trupsm/e-commerce-website-/blob/main/backend/models/Cart.js"

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_authui,node_catalogui,node_productviews,node_cartui,node_checkoutui,node_paymentui,node_orderui,node_authstate,node_cartstate,node_authapi,node_cartapi,node_orderapi,node_productapi,node_http toneBlue
class node_server,node_authroutes,node_catalogroutes,node_cartroutes,node_orderroutes,node_paymentroutes,node_authmw,node_rolemw toneAmber
class node_authctrl,node_cartctrl,node_productctrl,node_categoryctrl,node_orderctrl,node_paymentctrl toneMint
class node_users,node_products,node_categories,node_carts toneRose
class node_shopper toneIndigo
```

## Components

### Storefront

- [SPA Routing](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Account Pages](https://github.com/trupsm/e-commerce-website-/tree/main/frontend/src/pages): `frontend/src/pages`
- [Catalog Pages](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/pages/Products.jsx): `frontend/src/pages/Products.jsx`
- [Product Views](https://github.com/trupsm/e-commerce-website-/tree/main/frontend/src/components/product): `frontend/src/components/product`
- [Cart Page](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/pages/Cart.jsx): `frontend/src/pages/Cart.jsx`
- [Checkout](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/pages/Checkout.jsx): `frontend/src/pages/Checkout.jsx`
- [Stripe Form](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/components/payment/StripeCheckoutForm.jsx): `frontend/src/components/payment/StripeCheckoutForm.jsx`
- [Order Pages](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/pages/OrderHistory.jsx): `frontend/src/pages/OrderHistory.jsx`
- [Auth State](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Cart State](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/context/CartContext.jsx): `frontend/src/context/CartContext.jsx`
- [Auth Client](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/api/authApi.js): `frontend/src/api/authApi.js`
- [Cart Client](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/api/cartApi.js): `frontend/src/api/cartApi.js`
- [Order Client](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/api/orderApi.js): `frontend/src/api/orderApi.js`
- [Product Client](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/api/productApi.js): `frontend/src/api/productApi.js`
- [REST Transport](https://github.com/trupsm/e-commerce-website-/blob/main/frontend/src/api/axiosInstance.js): `frontend/src/api/axiosInstance.js`

### Commerce API

- [Express API](https://github.com/trupsm/e-commerce-website-/blob/main/backend/server.js): `backend/server.js`
- [Auth Routes](https://github.com/trupsm/e-commerce-website-/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Catalog Routes](https://github.com/trupsm/e-commerce-website-/blob/main/backend/routes/productRoutes.js): `backend/routes/productRoutes.js`
- [Cart Routes](https://github.com/trupsm/e-commerce-website-/blob/main/backend/routes/cartRoutes.js): `backend/routes/cartRoutes.js`
- [Order Routes](https://github.com/trupsm/e-commerce-website-/blob/main/backend/routes/orderRoutes.js): `backend/routes/orderRoutes.js`
- [Payment Routes](https://github.com/trupsm/e-commerce-website-/blob/main/backend/routes/paymentRoutes.js): `backend/routes/paymentRoutes.js`
- [JWT Authentication](https://github.com/trupsm/e-commerce-website-/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Role Access](https://github.com/trupsm/e-commerce-website-/blob/main/backend/middleware/roleMiddleware.js): `backend/middleware/roleMiddleware.js`

### Commerce Domain

- [Account Logic](https://github.com/trupsm/e-commerce-website-/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Cart Logic](https://github.com/trupsm/e-commerce-website-/blob/main/backend/controllers/cartController.js): `backend/controllers/cartController.js`
- [Catalog Logic](https://github.com/trupsm/e-commerce-website-/blob/main/backend/controllers/productController.js): `backend/controllers/productController.js`
- [Category Logic](https://github.com/trupsm/e-commerce-website-/blob/main/backend/controllers/categoryController.js): `backend/controllers/categoryController.js`
- [Order Logic](https://github.com/trupsm/e-commerce-website-/blob/main/backend/controllers/orderController.js): `backend/controllers/orderController.js`
- [Payment Webhook](https://github.com/trupsm/e-commerce-website-/blob/main/backend/controllers/paymentController.js): `backend/controllers/paymentController.js`

### Data and Payments

- [Users](https://github.com/trupsm/e-commerce-website-/blob/main/backend/models/User.js): `backend/models/User.js`
- [Products](https://github.com/trupsm/e-commerce-website-/blob/main/backend/models/Product.js): `backend/models/Product.js`
- [Categories](https://github.com/trupsm/e-commerce-website-/blob/main/backend/models/Category.js): `backend/models/Category.js`
- [Carts](https://github.com/trupsm/e-commerce-website-/blob/main/backend/models/Cart.js): `backend/models/Cart.js`

### Other components

- **Shopper**

## Connections

- Shopper → SPA Routing: uses (evidence: `frontend/src/App.jsx`)
- SPA Routing → Auth State: provides session (evidence: `frontend/src/App.jsx`)
- SPA Routing → Cart State: provides cart (evidence: `frontend/src/App.jsx`)
- SPA Routing → Account Pages: routes (evidence: `frontend/src/App.jsx`)
- SPA Routing → Catalog Pages: routes (evidence: `frontend/src/App.jsx`)
- SPA Routing → Cart Page: routes (evidence: `frontend/src/App.jsx`)
- SPA Routing → Checkout: routes (evidence: `frontend/src/App.jsx`)
- SPA Routing → Order Pages: routes (evidence: `frontend/src/App.jsx`)
- Catalog Pages → Product Views: renders
- Auth State → Auth Client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Cart State → Cart Client: calls (evidence: `frontend/src/context/CartContext.jsx`)
- Cart Page → Cart State: uses (evidence: `frontend/src/pages/Cart.jsx`)
- Checkout → Order Client: calls (evidence: `frontend/src/pages/Checkout.jsx`)
- Checkout → Stripe Form: renders (evidence: `frontend/src/pages/Checkout.jsx`)
- Auth Client → REST Transport: uses (evidence: `frontend/src/api/authApi.js`)
- Cart Client → REST Transport: uses (evidence: `frontend/src/api/cartApi.js`)
- Order Client → REST Transport: uses
- Product Client → REST Transport: uses
- REST Transport → Express API: REST requests
- Express API → Auth Routes: mounts (evidence: `backend/server.js`)
- Express API → Catalog Routes: mounts (evidence: `backend/server.js`)
- Express API → Cart Routes: mounts (evidence: `backend/server.js`)
- Express API → Order Routes: mounts (evidence: `backend/server.js`)
- Express API → Payment Routes: mounts (evidence: `backend/server.js`)
- Auth Routes → Account Logic: routes to (evidence: `backend/routes/authRoutes.js`)
- Catalog Routes → Catalog Logic: routes to (evidence: `backend/routes/productRoutes.js`)
- Cart Routes → Cart Logic: routes to (evidence: `backend/routes/cartRoutes.js`)
- Order Routes → Order Logic: routes to (evidence: `backend/routes/orderRoutes.js`)
- Payment Routes → Payment Webhook: routes to (evidence: `backend/routes/paymentRoutes.js`)
- Auth Routes → JWT Authentication: guards (evidence: `backend/routes/authRoutes.js`)
- Cart Routes → JWT Authentication: guards (evidence: `backend/routes/cartRoutes.js`)
- Order Routes → JWT Authentication: guards (evidence: `backend/routes/orderRoutes.js`)
- Catalog Routes → JWT Authentication: guards admin (evidence: `backend/routes/productRoutes.js`)
- Catalog Routes → Role Access: checks role (evidence: `backend/routes/productRoutes.js`)
- Account Logic → Users: reads/writes (evidence: `backend/controllers/authController.js`)
- JWT Authentication → Users: loads user (evidence: `backend/middleware/authMiddleware.js`)
- Cart Logic → Carts: reads/writes (evidence: `backend/controllers/cartController.js`)
- Cart Logic → Products: checks stock (evidence: `backend/controllers/cartController.js`)
- Catalog Logic → Products: manages (evidence: `backend/controllers/productController.js`)
- Catalog Logic → Categories: queries (evidence: `backend/controllers/productController.js`)
- Category Logic → Categories: manages (evidence: `backend/controllers/categoryController.js`)
- Order Logic → Carts: loads cart (evidence: `backend/controllers/orderController.js`)
- Order Logic → Products: validates and updates (evidence: `backend/controllers/orderController.js`)
- Order Logic → Carts: clears cart (evidence: `backend/controllers/orderController.js`)
- Order Logic → Payment Webhook: payment lifecycle
- Order Logic → Payment Routes: creates intent
- Payment Webhook → Products: updates stock (evidence: `backend/controllers/paymentController.js`)
- Payment Webhook → Carts: updates cart (evidence: `backend/controllers/paymentController.js`)
