# ashishbarwar2004-cloud/mern- architecture

> Architecture diagram of the GitHub repository ashishbarwar2004-cloud/mern-, 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/ashishbarwar2004-cloud/mern-
- Repository: https://github.com/ashishbarwar2004-cloud/mern-

## Overview

ShopNest is a full-stack commerce application. Shoppers browse products, manage a cart, authenticate, check out and view order success/profile; administrators manage catalog, orders and users. The React client routes these experiences and calls the Express API, whose controllers use MongoDB models and optional Cloudinary/email services. The graph preserves analytics and payment as documented by route wiring, but their internal behavior is unsampled; the README is empty, so those details are intentionally limited.

Main entry points: [`frontend/src/App.jsx`](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/App.jsx) (App routes), [`backend/server.js`](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/server.js) (API server), [`backend/middleware/authMiddleware.js`](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/middleware/authMiddleware.js) (Token protection), [`backend/routes/authRoutes.js`](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/routes/authRoutes.js) (Auth routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Storefront"]
  node_app["App routes<br/>[App.jsx]"]
  node_catalog_ui["Browse catalog<br/>[Shop.jsx]"]
  node_product_ui["Product detail<br/>[ProductDetail.jsx]"]
  node_cart_ui["Cart<br/>[Cart.jsx]"]
  node_checkout_ui["Checkout<br/>[Checkout.jsx]"]
  node_auth_ui["Authentication<br/>[AuthContext.jsx]"]
  node_account_ui["Account profile<br/>[Profile.jsx]"]
  node_admin_ui["Admin screens"]
end

subgraph group_server["Commerce API"]
  node_api_server["API server<br/>[server.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_product_routes["Product routes<br/>[productRoutes.js]"]
  node_order_routes["Order routes<br/>[orderRoutes.js]"]
  node_payment_routes["Payment routes<br/>[paymentRoutes.js]"]
  node_auth_controller["User auth<br/>[authController.js]"]
  node_product_controller["Catalog operations"]
  node_order_controller["Order operations<br/>[orderController.js]"]
  node_payment_controller["Payment operations"]
  node_auth_middleware["Token protection<br/>[authMiddleware.js]"]
  node_admin_middleware["Admin check<br/>[adminMiddleware.js]"]
end

subgraph group_data["Persistence and media"]
  node_user_model[("User records<br/>[User.js]")]
  node_product_model[("Product records<br/>[Product.js]")]
  node_order_model[("Order records<br/>[Order.js]")]
end

subgraph group_ops["Admin and analytics"]
  node_analytics_routes["Analytics routes<br/>[analyticsRoutes.js]"]
  node_analytics_controller["Analytics"]
end

node_shopper(("Shopper"))
node_admin_user(("Administrator"))
node_cloudinary["Cloudinary"]
node_email_service["Email delivery"]
node_payment_provider["Payment provider"]
node_mongo[("MongoDB")]

node_shopper -->|"uses"| node_app
node_admin_user -->|"uses"| node_app
node_app -->|"routes to"| node_catalog_ui
node_app -->|"routes to"| node_product_ui
node_app -->|"routes to"| node_cart_ui
node_app -->|"routes to"| node_checkout_ui
node_app -.->|"provides auth"| node_auth_ui
node_app -->|"routes to"| node_account_ui
node_app -->|"routes to"| node_admin_ui
node_app -->|"serves client"| node_api_server
node_api_server -->|"mounts"| node_auth_routes
node_api_server -->|"mounts"| node_product_routes
node_api_server -->|"mounts"| node_order_routes
node_api_server -->|"mounts"| node_payment_routes
node_api_server -->|"mounts"| node_analytics_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"protects profile"| node_auth_middleware
node_auth_routes -->|"guards users"| node_admin_middleware
node_product_routes -->|"dispatches"| node_product_controller
node_product_routes -->|"protects writes"| node_auth_middleware
node_product_routes -->|"guards writes"| node_admin_middleware
node_order_routes -->|"dispatches"| node_order_controller
node_order_routes -->|"protects orders"| node_auth_middleware
node_order_routes -->|"guards management"| node_admin_middleware
node_payment_routes -->|"dispatches"| node_payment_controller
node_analytics_routes -->|"dispatches"| node_analytics_controller
node_analytics_routes -->|"protects access"| node_auth_middleware
node_analytics_routes -->|"guards access"| node_admin_middleware
node_auth_middleware -->|"loads user"| node_user_model
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_controller -->|"sends verification"| node_email_service
node_product_controller -->|"reads and writes"| node_product_model
node_product_controller -->|"uploads image"| node_cloudinary
node_order_controller -->|"reads and writes"| node_order_model
node_order_controller -->|"sends confirmation"| node_email_service
node_checkout_ui -.->|"submits checkout"| node_api_server
node_catalog_ui -.->|"fetches products"| node_api_server
node_auth_ui -->|"requests profile"| node_api_server
node_payment_controller -.->|"processes payment"| node_payment_provider
node_api_server -->|"connects database"| node_mongo

click node_app "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/App.jsx"
click node_catalog_ui "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/pages/Shop.jsx"
click node_product_ui "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/pages/ProductDetail.jsx"
click node_cart_ui "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/pages/Cart.jsx"
click node_checkout_ui "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/pages/Checkout.jsx"
click node_auth_ui "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/context/AuthContext.jsx"
click node_account_ui "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/pages/Profile.jsx"
click node_admin_ui "https://github.com/ashishbarwar2004-cloud/mern-/tree/main/frontend/src/admin"
click node_api_server "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/server.js"
click node_auth_routes "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/routes/authRoutes.js"
click node_product_routes "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/routes/productRoutes.js"
click node_order_routes "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/routes/orderRoutes.js"
click node_payment_routes "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/routes/paymentRoutes.js"
click node_analytics_routes "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/routes/analyticsRoutes.js"
click node_auth_controller "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/controllers/authController.js"
click node_product_controller "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/controllers/productController.js"
click node_order_controller "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/controllers/orderController.js"
click node_payment_controller "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/controllers/paymentController.js"
click node_analytics_controller "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/controllers/analyticsController.js"
click node_auth_middleware "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/middleware/authMiddleware.js"
click node_admin_middleware "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/middleware/adminMiddleware.js"
click node_user_model "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/models/User.js"
click node_product_model "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/models/Product.js"
click node_order_model "https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/models/Order.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_ui,node_product_ui,node_cart_ui,node_checkout_ui,node_auth_ui,node_account_ui,node_admin_ui toneBlue
class node_api_server,node_auth_routes,node_product_routes,node_order_routes,node_payment_routes,node_auth_controller,node_product_controller,node_order_controller,node_payment_controller,node_auth_middleware,node_admin_middleware,node_mongo toneAmber
class node_user_model,node_product_model,node_order_model toneMint
class node_analytics_routes,node_analytics_controller toneRose
class node_shopper,node_admin_user,node_cloudinary,node_email_service,node_payment_provider toneIndigo
```

## Components

### Storefront

- [App routes](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Browse catalog](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/pages/Shop.jsx): `frontend/src/pages/Shop.jsx`
- [Product detail](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/pages/ProductDetail.jsx): `frontend/src/pages/ProductDetail.jsx`
- [Cart](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/pages/Cart.jsx): `frontend/src/pages/Cart.jsx`
- [Checkout](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/pages/Checkout.jsx): `frontend/src/pages/Checkout.jsx`
- [Authentication](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Account profile](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/frontend/src/pages/Profile.jsx): `frontend/src/pages/Profile.jsx`
- [Admin screens](https://github.com/ashishbarwar2004-cloud/mern-/tree/main/frontend/src/admin): `frontend/src/admin`

### Commerce API

- [API server](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Product routes](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/routes/productRoutes.js): `backend/routes/productRoutes.js`
- [Order routes](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/routes/orderRoutes.js): `backend/routes/orderRoutes.js`
- [Payment routes](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/routes/paymentRoutes.js): `backend/routes/paymentRoutes.js`
- [User auth](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Catalog operations](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/controllers/productController.js): `backend/controllers/productController.js`
- [Order operations](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/controllers/orderController.js): `backend/controllers/orderController.js`
- [Payment operations](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/controllers/paymentController.js): `backend/controllers/paymentController.js`
- [Token protection](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Admin check](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/middleware/adminMiddleware.js): `backend/middleware/adminMiddleware.js`

### Persistence and media

- [User records](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/models/User.js): `backend/models/User.js`
- [Product records](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/models/Product.js): `backend/models/Product.js`
- [Order records](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/models/Order.js): `backend/models/Order.js`

### Admin and analytics

- [Analytics routes](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/routes/analyticsRoutes.js): `backend/routes/analyticsRoutes.js`
- [Analytics](https://github.com/ashishbarwar2004-cloud/mern-/blob/main/backend/controllers/analyticsController.js): `backend/controllers/analyticsController.js`

### Other components

- **Shopper**
- **Administrator**
- **Cloudinary**
- **Email delivery**
- **Payment provider**
- **MongoDB**

## Connections

- Shopper → App routes: uses (evidence: `frontend/src/App.jsx`)
- Administrator → App routes: uses (evidence: `frontend/src/App.jsx`)
- App routes → Browse catalog: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Product detail: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Cart: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Checkout: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Authentication: provides auth
- App routes → Account profile: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Admin screens: routes to (evidence: `frontend/src/App.jsx`)
- App routes → API server: serves client (evidence: `backend/server.js`)
- API server → Auth routes: mounts (evidence: `backend/server.js`)
- API server → Product routes: mounts (evidence: `backend/server.js`)
- API server → Order routes: mounts (evidence: `backend/server.js`)
- API server → Payment routes: mounts (evidence: `backend/server.js`)
- API server → Analytics routes: mounts (evidence: `backend/server.js`)
- Auth routes → User auth: dispatches (evidence: `backend/routes/authRoutes.js`)
- Auth routes → Token protection: protects profile (evidence: `backend/routes/authRoutes.js`)
- Auth routes → Admin check: guards users (evidence: `backend/routes/authRoutes.js`)
- Product routes → Catalog operations: dispatches (evidence: `backend/routes/productRoutes.js`)
- Product routes → Token protection: protects writes (evidence: `backend/routes/productRoutes.js`)
- Product routes → Admin check: guards writes (evidence: `backend/routes/productRoutes.js`)
- Order routes → Order operations: dispatches (evidence: `backend/routes/orderRoutes.js`)
- Order routes → Token protection: protects orders (evidence: `backend/routes/orderRoutes.js`)
- Order routes → Admin check: guards management (evidence: `backend/routes/orderRoutes.js`)
- Payment routes → Payment operations: dispatches (evidence: `backend/routes/paymentRoutes.js`)
- Analytics routes → Analytics: dispatches (evidence: `backend/routes/analyticsRoutes.js`)
- Analytics routes → Token protection: protects access (evidence: `backend/routes/analyticsRoutes.js`)
- Analytics routes → Admin check: guards access (evidence: `backend/routes/analyticsRoutes.js`)
- Token protection → User records: loads user (evidence: `backend/middleware/authMiddleware.js`)
- User auth → User records: reads and writes (evidence: `backend/controllers/authController.js`)
- User auth → Email delivery: sends verification (evidence: `backend/controllers/authController.js`)
- Catalog operations → Product records: reads and writes (evidence: `backend/controllers/productController.js`)
- Catalog operations → Cloudinary: uploads image (evidence: `backend/controllers/productController.js`)
- Order operations → Order records: reads and writes (evidence: `backend/controllers/orderController.js`)
- Order operations → Email delivery: sends confirmation (evidence: `backend/controllers/orderController.js`)
- Checkout → API server: submits checkout
- Browse catalog → API server: fetches products
- Authentication → API server: requests profile (evidence: `frontend/src/context/AuthContext.jsx`)
- Payment operations → Payment provider: processes payment
- API server → MongoDB: connects database (evidence: `backend/server.js`)
