# siva-242006/shopnest-e-commerce-website architecture

> Architecture diagram of the GitHub repository siva-242006/shopnest-e-commerce-website, 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/siva-242006/shopnest-e-commerce-website
- Repository: https://github.com/siva-242006/shopnest-e-commerce-website

## Overview

ShopNest is a MERN e-commerce application. Customers browse products, manage a cart, submit a delivery address and place COD orders; they can then review or cancel orders. Administrators manage catalog listings and fulfillment status, and inspect audit logs. The backend exposes REST routes, protects selected operations with JWT verification and persists domain data in MongoDB. The README documents inventory atomicity and duplicate-order protection. Frontend-to-API edges are dashed because sampled excerpts do not show those requests; unsampled category and profile implementations are represented by their exact directories.

Main entry points: [`frontend/src/App.js`](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/App.js) (Route shell), [`backend/routes/ordersRoutes.js`](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/ordersRoutes.js) (Order routes), [`backend/routes/productRoutes.js`](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/productRoutes.js) (Product routes), [`backend/server.js`](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/server.js) (API server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["Route shell<br/>[App.js]"]
  node_catalog["Product catalog<br/>[products.js]"]
  node_item["Product detail<br/>[ProductsItem.js]"]
  node_cartui["Cart page<br/>[cart.js]"]
  node_cartstate["Cart state<br/>[CartContext.js]"]
  node_checkout["Checkout<br/>[checkoutPage.js]"]
  node_delivery["Delivery address"]
end

subgraph group_customer["Customer account"]
  node_authui["Login and signup<br/>[index.js]"]
  node_userstate["User state<br/>[UserContext.js]"]
  node_ordersui["Order history<br/>[ordersPage.js]"]
  node_profile["Profile page<br/>[profilePage.js]"]
end

subgraph group_commerce["Commerce API"]
  node_authapi["User routes<br/>[userRoutes.js]"]
  node_protect["JWT protection<br/>[protect.js]"]
  node_productapi["Product routes<br/>[productRoutes.js]"]
  node_cartapi["Cart routes<br/>[cartRoutes.js]"]
  node_orderapi["Order routes<br/>[ordersRoutes.js]"]
  node_categoryapi["Category routes<br/>[categoryRoutes.js]"]
  node_server["API server<br/>[server.js]"]
end

subgraph group_management["Store management"]
  node_adminproduct["Product editor"]
  node_logsui["Audit log viewer<br/>[logsPage.js]"]
  node_logapi["Log routes<br/>[logRoute.js]"]
  node_logwriter["Audit writer<br/>[createLog.js]"]
end

subgraph group_persistence["MongoDB data"]
  node_mongo[("MongoDB")]
  node_users[("User records<br/>[user.js]")]
  node_products[("Product records<br/>[products.js]")]
  node_carts[("Cart records<br/>[cart.js]")]
  node_orders[("Order records<br/>[orders.js]")]
  node_categories[("Category records<br/>[category.js]")]
  node_logs[("Audit records<br/>[logs.js]")]
end

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

node_shopper -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"routes to"| node_catalog
node_app -->|"routes to"| node_item
node_app -->|"routes to"| node_cartui
node_app -->|"routes to"| node_checkout
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_ordersui
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_adminproduct
node_app -->|"routes to"| node_logsui
node_checkout -->|"renders"| node_delivery
node_cartui -->|"uses"| node_cartstate
node_checkout -->|"uses"| node_cartstate
node_authui -->|"updates"| node_userstate
node_ordersui -->|"reads"| node_userstate
node_profile -->|"reads"| node_userstate
node_catalog -.->|"requests catalog"| node_productapi
node_item -.->|"requests detail"| node_productapi
node_cartui -.->|"requests cart"| node_cartapi
node_checkout -.->|"submits order"| node_orderapi
node_authui -.->|"authenticates"| node_authapi
node_ordersui -.->|"requests orders"| node_orderapi
node_adminproduct -.->|"manages products"| node_productapi
node_logsui -.->|"requests logs"| node_logapi
node_server -->|"mounts"| node_authapi
node_server -->|"mounts"| node_productapi
node_server -->|"mounts"| node_cartapi
node_server -->|"mounts"| node_orderapi
node_server -->|"mounts"| node_categoryapi
node_server -->|"mounts"| node_logapi
node_authapi -->|"uses"| node_protect
node_productapi -->|"uses"| node_protect
node_orderapi -->|"uses"| node_protect
node_productapi -->|"reads and writes"| node_products
node_cartapi -->|"reads and writes"| node_carts
node_cartapi -->|"reads"| node_products
node_orderapi -->|"reads and writes"| node_orders
node_orderapi -->|"clears"| node_carts
node_orderapi -->|"adjusts stock"| node_products
node_authapi -->|"reads and writes"| node_users
node_categoryapi -->|"reads"| node_categories
node_logapi -->|"reads"| node_logs
node_logapi -->|"checks access"| node_protect
node_productapi -->|"records events"| node_logwriter
node_cartapi -->|"records events"| node_logwriter
node_orderapi -->|"records events"| node_logwriter
node_authapi -->|"records events"| node_logwriter

click node_app "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/App.js"
click node_catalog "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/products/products.js"
click node_item "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/productsItem/ProductsItem.js"
click node_cartui "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/cart/cart.js"
click node_cartstate "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/context/CartContext.js"
click node_checkout "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/checkoutPage/checkoutPage.js"
click node_delivery "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/deliveryAddressForm/deliveryAddressForm.js"
click node_authui "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/login/index.js"
click node_userstate "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/context/UserContext.js"
click node_ordersui "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/ordersPage/ordersPage.js"
click node_profile "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/profilePage/profilePage.js"
click node_authapi "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/userRoutes.js"
click node_protect "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/middlewares/protect.js"
click node_productapi "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/productRoutes.js"
click node_cartapi "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/cartRoutes.js"
click node_orderapi "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/ordersRoutes.js"
click node_categoryapi "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/categoryRoutes.js"
click node_adminproduct "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/addOrUpdateProduct/addOrUpdateProduct.js"
click node_logsui "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/logsPage/logsPage.js"
click node_logapi "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/logRoute.js"
click node_logwriter "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/utils/createLog.js"
click node_server "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/server.js"
click node_users "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/models/user.js"
click node_products "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/models/products.js"
click node_carts "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/models/cart.js"
click node_orders "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/models/orders.js"
click node_categories "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/models/category.js"
click node_logs "https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/models/logs.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_catalog,node_item,node_cartui,node_cartstate,node_checkout,node_delivery toneBlue
class node_authui,node_userstate,node_ordersui,node_profile toneAmber
class node_authapi,node_protect,node_productapi,node_cartapi,node_orderapi,node_categoryapi,node_server toneMint
class node_adminproduct,node_logsui,node_logapi,node_logwriter toneRose
class node_mongo,node_users,node_products,node_carts,node_orders,node_categories,node_logs,node_shopper,node_admin toneIndigo
```

## Components

### Storefront

- [Route shell](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Product catalog](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/products/products.js): `frontend/src/components/products/products.js`
- [Product detail](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/productsItem/ProductsItem.js): `frontend/src/components/productsItem/ProductsItem.js`
- [Cart page](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/cart/cart.js): `frontend/src/components/cart/cart.js`
- [Cart state](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/context/CartContext.js): `frontend/src/context/CartContext.js`
- [Checkout](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/checkoutPage/checkoutPage.js): `frontend/src/components/checkoutPage/checkoutPage.js`
- [Delivery address](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/deliveryAddressForm/deliveryAddressForm.js): `frontend/src/components/deliveryAddressForm/deliveryAddressForm.js`

### Customer account

- [Login and signup](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/login/index.js): `frontend/src/components/login/index.js`
- [User state](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/context/UserContext.js): `frontend/src/context/UserContext.js`
- [Order history](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/ordersPage/ordersPage.js): `frontend/src/components/ordersPage/ordersPage.js`
- [Profile page](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/profilePage/profilePage.js): `frontend/src/components/profilePage/profilePage.js`

### Commerce API

- [User routes](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/userRoutes.js): `backend/routes/userRoutes.js`
- [JWT protection](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/middlewares/protect.js): `backend/middlewares/protect.js`
- [Product routes](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/productRoutes.js): `backend/routes/productRoutes.js`
- [Cart routes](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/cartRoutes.js): `backend/routes/cartRoutes.js`
- [Order routes](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/ordersRoutes.js): `backend/routes/ordersRoutes.js`
- [Category routes](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/categoryRoutes.js): `backend/routes/categoryRoutes.js`
- [API server](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/server.js): `backend/server.js`

### Store management

- [Product editor](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/addOrUpdateProduct/addOrUpdateProduct.js): `frontend/src/components/addOrUpdateProduct/addOrUpdateProduct.js`
- [Audit log viewer](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/frontend/src/components/logsPage/logsPage.js): `frontend/src/components/logsPage/logsPage.js`
- [Log routes](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/routes/logRoute.js): `backend/routes/logRoute.js`
- [Audit writer](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/utils/createLog.js): `backend/utils/createLog.js`

### MongoDB data

- **MongoDB**
- [User records](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/models/user.js): `backend/models/user.js`
- [Product records](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/models/products.js): `backend/models/products.js`
- [Cart records](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/models/cart.js): `backend/models/cart.js`
- [Order records](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/models/orders.js): `backend/models/orders.js`
- [Category records](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/models/category.js): `backend/models/category.js`
- [Audit records](https://github.com/siva-242006/shopnest-e-commerce-website/blob/main/backend/models/logs.js): `backend/models/logs.js`

### Other components

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

## Connections

- Shopper → Route shell: uses (evidence: `frontend/src/App.js`)
- Administrator → Route shell: uses (evidence: `frontend/src/App.js`)
- Route shell → Product catalog: routes to (evidence: `frontend/src/App.js`)
- Route shell → Product detail: routes to (evidence: `frontend/src/App.js`)
- Route shell → Cart page: routes to (evidence: `frontend/src/App.js`)
- Route shell → Checkout: routes to (evidence: `frontend/src/App.js`)
- Route shell → Login and signup: routes to (evidence: `frontend/src/App.js`)
- Route shell → Order history: routes to (evidence: `frontend/src/App.js`)
- Route shell → Profile page: routes to (evidence: `frontend/src/App.js`)
- Route shell → Product editor: routes to (evidence: `frontend/src/App.js`)
- Route shell → Audit log viewer: routes to (evidence: `frontend/src/App.js`)
- Checkout → Delivery address: renders (evidence: `frontend/src/components/checkoutPage/checkoutPage.js`)
- Cart page → Cart state: uses (evidence: `frontend/src/components/cart/cart.js`)
- Checkout → Cart state: uses (evidence: `frontend/src/components/checkoutPage/checkoutPage.js`)
- Login and signup → User state: updates (evidence: `frontend/src/components/login/index.js`)
- Order history → User state: reads (evidence: `frontend/src/components/ordersPage/ordersPage.js`)
- Profile page → User state: reads (evidence: `frontend/src/components/profilePage/profilePage.js`)
- Product catalog → Product routes: requests catalog
- Product detail → Product routes: requests detail
- Cart page → Cart routes: requests cart
- Checkout → Order routes: submits order
- Login and signup → User routes: authenticates
- Order history → Order routes: requests orders
- Product editor → Product routes: manages products
- Audit log viewer → Log routes: requests logs
- API server → User routes: mounts (evidence: `backend/server.js`)
- API server → Product routes: mounts (evidence: `backend/server.js`)
- API server → Cart routes: mounts (evidence: `backend/server.js`)
- API server → Order routes: mounts (evidence: `backend/server.js`)
- API server → Category routes: mounts (evidence: `backend/server.js`)
- API server → Log routes: mounts (evidence: `backend/server.js`)
- User routes → JWT protection: uses (evidence: `backend/routes/userRoutes.js`)
- Product routes → JWT protection: uses (evidence: `backend/routes/productRoutes.js`)
- Order routes → JWT protection: uses (evidence: `backend/routes/ordersRoutes.js`)
- Product routes → Product records: reads and writes (evidence: `backend/routes/productRoutes.js`)
- Cart routes → Cart records: reads and writes (evidence: `backend/routes/cartRoutes.js`)
- Cart routes → Product records: reads (evidence: `backend/routes/cartRoutes.js`)
- Order routes → Order records: reads and writes (evidence: `backend/routes/ordersRoutes.js`)
- Order routes → Cart records: clears (evidence: `backend/routes/ordersRoutes.js`)
- Order routes → Product records: adjusts stock (evidence: `backend/routes/ordersRoutes.js`)
- User routes → User records: reads and writes (evidence: `backend/routes/userRoutes.js`)
- Category routes → Category records: reads (evidence: `backend/routes/categoryRoutes.js`)
- Log routes → Audit records: reads (evidence: `backend/routes/logRoute.js`)
- Log routes → JWT protection: checks access (evidence: `backend/routes/logRoute.js`)
- Product routes → Audit writer: records events (evidence: `backend/routes/productRoutes.js`)
- Cart routes → Audit writer: records events (evidence: `backend/routes/cartRoutes.js`)
- Order routes → Audit writer: records events (evidence: `backend/routes/ordersRoutes.js`)
- User routes → Audit writer: records events (evidence: `backend/routes/userRoutes.js`)
