# deepakgupta2006/nextcart architecture

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

- Interactive diagram: https://gitdiagram.com/deepakgupta2006/nextcart
- Repository: https://github.com/deepakgupta2006/nextcart

## Overview

NextCart is a fashion e-commerce application. Customers browse and filter products, manage an account cart, provide a shipping address, pay by Razorpay or COD, and track orders; administrators manage products, orders, and users. The graph separates the React storefront, Express API routing, domain controllers, and persistence/integrations. Source excerpts and the index support the shown internal links; some feature-to-API connections are documented in the README, while unsampled implementation details are not inferred.

Main entry points: [`server/src/app.js`](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/app.js) (Express API), [`client/src/App.jsx`](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/App.jsx) (Page Router), [`client/src/services/api.js`](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/services/api.js) (API Client), [`client/src/pages/Checkout/Checkout.jsx`](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/pages/Checkout/Checkout.jsx) (Checkout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["Page Router<br/>[App.jsx]"]
  node_catalog["Product Discovery<br/>[Shop.jsx]"]
  node_productdetail["Product Details<br/>[index.jsx]"]
  node_authui["Authentication UI<br/>[Auth.jsx]"]
  node_authstate["Auth Context<br/>[AuthContext.jsx]"]
  node_cartui["Cart State<br/>[CartContext.jsx]"]
  node_checkout["Checkout<br/>[Checkout.jsx]"]
  node_adminui["Admin Console"]
  node_api_client["API Client<br/>[api.js]"]
  node_productservice["Product Service<br/>[productService.js]"]
  node_cartservice["Cart Service<br/>[cartService.js]"]
  node_orderservice["Order Service<br/>[orderService.js]"]
  node_paymentservice["Payment Service<br/>[paymentService.js]"]
  node_addressservice["Address Service<br/>[addressService.js]"]
end

subgraph group_commerce["Commerce Workflow"]
end

subgraph group_api["API Routing"]
  node_express["Express API<br/>[app.js]"]
  node_authroutes["Auth Routes<br/>[auth.routes.js]"]
  node_productroutes["Product Routes<br/>[product.routes.js]"]
  node_cartroutes["Cart Routes<br/>[cart.routes.js]"]
  node_orderroutes["Order Routes<br/>[order.routes.js]"]
  node_paymentroutes["Payment Routes<br/>[payment.routes.js]"]
  node_addressroutes["Address Routes<br/>[address.routes.js]"]
  node_userroutes["User Routes<br/>[user.routes.js]"]
end

subgraph group_domain["Domain Services"]
  node_authcontroller["Account Operations<br/>[authController.js]"]
  node_productcontroller["Catalog Operations"]
  node_cartcontroller["Cart Operations<br/>[cartController.js]"]
  node_ordercontroller["Order Operations<br/>[orderController.js]"]
  node_paymentcontroller["Payment Verification"]
  node_addresscontroller["Address Operations"]
  node_usercontroller["User Administration<br/>[userController.js]"]
  node_uploadcontroller["Image Uploads"]
  node_authmiddleware["Route Authorization<br/>[auth.js]"]
  node_pricing["Order Pricing<br/>[pricing.js]"]
end

subgraph group_platform["Persistence &amp; Integrations"]
end

node_customer(("Customer"))
node_admin(("Administrator"))

node_customer -->|"browses"| node_app
node_admin -->|"manages"| node_app
node_app -->|"routes to"| node_catalog
node_app -->|"routes to"| node_productdetail
node_app -->|"routes to"| node_authui
node_app -->|"protects route"| node_checkout
node_app -->|"protects route"| node_adminui
node_authui -->|"uses"| node_authstate
node_authstate -->|"requests"| node_api_client
node_catalog -.->|"loads products"| node_productservice
node_productdetail -->|"loads product"| node_productservice
node_cartui -->|"requests cart"| node_cartservice
node_checkout -->|"places order"| node_orderservice
node_checkout -->|"starts payment"| node_paymentservice
node_checkout -.->|"uses addresses"| node_addressservice
node_productservice -->|"uses"| node_api_client
node_cartservice -->|"uses"| node_api_client
node_orderservice -->|"uses"| node_api_client
node_paymentservice -->|"uses"| node_api_client
node_addressservice -.->|"uses"| node_api_client
node_api_client -->|"sends API requests"| node_express
node_express -->|"mounts"| node_authroutes
node_express -->|"mounts"| node_productroutes
node_express -->|"mounts"| node_cartroutes
node_express -->|"mounts"| node_orderroutes
node_express -->|"mounts"| node_paymentroutes
node_express -->|"mounts"| node_addressroutes
node_express -->|"mounts"| node_userroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_productroutes -->|"dispatches"| node_productcontroller
node_productroutes -->|"dispatches"| node_uploadcontroller
node_cartroutes -->|"dispatches"| node_cartcontroller
node_orderroutes -->|"dispatches"| node_ordercontroller
node_paymentroutes -.->|"dispatches"| node_paymentcontroller
node_addressroutes -->|"dispatches"| node_addresscontroller
node_userroutes -->|"dispatches"| node_usercontroller
node_authroutes -->|"protects routes"| node_authmiddleware
node_cartroutes -->|"protects routes"| node_authmiddleware
node_orderroutes -->|"protects routes"| node_authmiddleware
node_authcontroller -.->|"authenticates"| node_authmiddleware
node_productcontroller -.->|"calculates totals"| node_pricing
node_ordercontroller -->|"calculates totals"| node_pricing
node_ordercontroller -->|"verifies payment"| node_paymentcontroller

click node_app "https://github.com/deepakgupta2006/nextcart/blob/main/client/src/App.jsx"
click node_catalog "https://github.com/deepakgupta2006/nextcart/blob/main/client/src/pages/Shop/Shop.jsx"
click node_productdetail "https://github.com/deepakgupta2006/nextcart/blob/main/client/src/pages/ProductDetail/index.jsx"
click node_authui "https://github.com/deepakgupta2006/nextcart/blob/main/client/src/pages/Auth/Auth.jsx"
click node_authstate "https://github.com/deepakgupta2006/nextcart/blob/main/client/src/context/AuthContext.jsx"
click node_cartui "https://github.com/deepakgupta2006/nextcart/blob/main/client/src/context/CartContext.jsx"
click node_checkout "https://github.com/deepakgupta2006/nextcart/blob/main/client/src/pages/Checkout/Checkout.jsx"
click node_adminui "https://github.com/deepakgupta2006/nextcart/tree/main/client/src/pages/Admin"
click node_api_client "https://github.com/deepakgupta2006/nextcart/blob/main/client/src/services/api.js"
click node_productservice "https://github.com/deepakgupta2006/nextcart/blob/main/client/src/services/productService.js"
click node_cartservice "https://github.com/deepakgupta2006/nextcart/blob/main/client/src/services/cartService.js"
click node_orderservice "https://github.com/deepakgupta2006/nextcart/blob/main/client/src/services/orderService.js"
click node_paymentservice "https://github.com/deepakgupta2006/nextcart/blob/main/client/src/services/paymentService.js"
click node_addressservice "https://github.com/deepakgupta2006/nextcart/blob/main/client/src/services/addressService.js"
click node_express "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/app.js"
click node_authroutes "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/auth.routes.js"
click node_productroutes "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/product.routes.js"
click node_cartroutes "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/cart.routes.js"
click node_orderroutes "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/order.routes.js"
click node_paymentroutes "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/payment.routes.js"
click node_addressroutes "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/address.routes.js"
click node_userroutes "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/user.routes.js"
click node_authcontroller "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/authController.js"
click node_productcontroller "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/productController.js"
click node_cartcontroller "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/cartController.js"
click node_ordercontroller "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/orderController.js"
click node_paymentcontroller "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/paymentController.js"
click node_addresscontroller "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/addressController.js"
click node_usercontroller "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/userController.js"
click node_uploadcontroller "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/uploadController.js"
click node_authmiddleware "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/middleware/auth.js"
click node_pricing "https://github.com/deepakgupta2006/nextcart/blob/main/server/src/utils/pricing.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_productdetail,node_authui,node_authstate,node_cartui,node_checkout,node_adminui,node_api_client,node_productservice,node_cartservice,node_orderservice,node_paymentservice,node_addressservice toneBlue
class node_express,node_authroutes,node_productroutes,node_cartroutes,node_orderroutes,node_paymentroutes,node_addressroutes,node_userroutes toneMint
class node_authcontroller,node_productcontroller,node_cartcontroller,node_ordercontroller,node_paymentcontroller,node_addresscontroller,node_usercontroller,node_uploadcontroller,node_authmiddleware,node_pricing toneRose
class node_customer,node_admin toneIndigo
```

## Components

### Storefront

- [Page Router](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Product Discovery](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/pages/Shop/Shop.jsx): `client/src/pages/Shop/Shop.jsx`
- [Product Details](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/pages/ProductDetail/index.jsx): `client/src/pages/ProductDetail/index.jsx`
- [Authentication UI](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/pages/Auth/Auth.jsx): `client/src/pages/Auth/Auth.jsx`
- [Auth Context](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Cart State](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/context/CartContext.jsx): `client/src/context/CartContext.jsx`
- [Checkout](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/pages/Checkout/Checkout.jsx): `client/src/pages/Checkout/Checkout.jsx`
- [Admin Console](https://github.com/deepakgupta2006/nextcart/tree/main/client/src/pages/Admin): `client/src/pages/Admin`
- [API Client](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/services/api.js): `client/src/services/api.js`
- [Product Service](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/services/productService.js): `client/src/services/productService.js`
- [Cart Service](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/services/cartService.js): `client/src/services/cartService.js`
- [Order Service](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/services/orderService.js): `client/src/services/orderService.js`
- [Payment Service](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/services/paymentService.js): `client/src/services/paymentService.js`
- [Address Service](https://github.com/deepakgupta2006/nextcart/blob/main/client/src/services/addressService.js): `client/src/services/addressService.js`

### API Routing

- [Express API](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/app.js): `server/src/app.js`
- [Auth Routes](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/auth.routes.js): `server/src/routes/auth.routes.js`
- [Product Routes](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/product.routes.js): `server/src/routes/product.routes.js`
- [Cart Routes](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/cart.routes.js): `server/src/routes/cart.routes.js`
- [Order Routes](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/order.routes.js): `server/src/routes/order.routes.js`
- [Payment Routes](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/payment.routes.js): `server/src/routes/payment.routes.js`
- [Address Routes](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/address.routes.js): `server/src/routes/address.routes.js`
- [User Routes](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/routes/user.routes.js): `server/src/routes/user.routes.js`

### Domain Services

- [Account Operations](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/authController.js): `server/src/controllers/authController.js`
- [Catalog Operations](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/productController.js): `server/src/controllers/productController.js`
- [Cart Operations](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/cartController.js): `server/src/controllers/cartController.js`
- [Order Operations](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/orderController.js): `server/src/controllers/orderController.js`
- [Payment Verification](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/paymentController.js): `server/src/controllers/paymentController.js`
- [Address Operations](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/addressController.js): `server/src/controllers/addressController.js`
- [User Administration](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/userController.js): `server/src/controllers/userController.js`
- [Image Uploads](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/controllers/uploadController.js): `server/src/controllers/uploadController.js`
- [Route Authorization](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/middleware/auth.js): `server/src/middleware/auth.js`
- [Order Pricing](https://github.com/deepakgupta2006/nextcart/blob/main/server/src/utils/pricing.js): `server/src/utils/pricing.js`

### Other components

- **Customer**
- **Administrator**

## Connections

- Customer → Page Router: browses (evidence: `client/src/App.jsx`)
- Administrator → Page Router: manages (evidence: `client/src/App.jsx`)
- Page Router → Product Discovery: routes to (evidence: `client/src/App.jsx`)
- Page Router → Product Details: routes to (evidence: `client/src/App.jsx`)
- Page Router → Authentication UI: routes to (evidence: `client/src/App.jsx`)
- Page Router → Checkout: protects route (evidence: `client/src/App.jsx`)
- Page Router → Admin Console: protects route (evidence: `client/src/App.jsx`)
- Authentication UI → Auth Context: uses (evidence: `client/src/pages/Auth/Auth.jsx`)
- Auth Context → API Client: requests (evidence: `client/src/context/AuthContext.jsx`)
- Product Discovery → Product Service: loads products
- Product Details → Product Service: loads product (evidence: `client/src/pages/ProductDetail/index.jsx`)
- Cart State → Cart Service: requests cart (evidence: `client/src/context/CartContext.jsx`)
- Checkout → Order Service: places order (evidence: `client/src/pages/Checkout/Checkout.jsx`)
- Checkout → Payment Service: starts payment (evidence: `client/src/pages/Checkout/Checkout.jsx`)
- Checkout → Address Service: uses addresses
- Product Service → API Client: uses (evidence: `client/src/services/productService.js`)
- Cart Service → API Client: uses (evidence: `client/src/services/cartService.js`)
- Order Service → API Client: uses (evidence: `client/src/services/orderService.js`)
- Payment Service → API Client: uses (evidence: `client/src/services/paymentService.js`)
- Address Service → API Client: uses
- API Client → Express API: sends API requests (evidence: `README.md`)
- Express API → Auth Routes: mounts (evidence: `server/src/app.js`)
- Express API → Product Routes: mounts (evidence: `server/src/app.js`)
- Express API → Cart Routes: mounts (evidence: `server/src/app.js`)
- Express API → Order Routes: mounts (evidence: `server/src/app.js`)
- Express API → Payment Routes: mounts (evidence: `server/src/app.js`)
- Express API → Address Routes: mounts (evidence: `server/src/app.js`)
- Express API → User Routes: mounts (evidence: `server/src/app.js`)
- Auth Routes → Account Operations: dispatches (evidence: `server/src/routes/auth.routes.js`)
- Product Routes → Catalog Operations: dispatches (evidence: `server/src/routes/product.routes.js`)
- Product Routes → Image Uploads: dispatches (evidence: `server/src/routes/product.routes.js`)
- Cart Routes → Cart Operations: dispatches (evidence: `server/src/routes/cart.routes.js`)
- Order Routes → Order Operations: dispatches (evidence: `server/src/routes/order.routes.js`)
- Payment Routes → Payment Verification: dispatches
- Address Routes → Address Operations: dispatches (evidence: `server/src/routes/address.routes.js`)
- User Routes → User Administration: dispatches (evidence: `server/src/routes/user.routes.js`)
- Auth Routes → Route Authorization: protects routes (evidence: `server/src/routes/auth.routes.js`)
- Cart Routes → Route Authorization: protects routes (evidence: `server/src/routes/cart.routes.js`)
- Order Routes → Route Authorization: protects routes (evidence: `server/src/routes/order.routes.js`)
- Account Operations → Route Authorization: authenticates
- Catalog Operations → Order Pricing: calculates totals
- Order Operations → Order Pricing: calculates totals (evidence: `server/src/controllers/orderController.js`)
- Order Operations → Payment Verification: verifies payment (evidence: `server/src/controllers/orderController.js`)
