# burakorkmez/mern-ecommerce architecture

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

- Interactive diagram: https://gitdiagram.com/burakorkmez/mern-ecommerce
- Repository: https://github.com/burakorkmez/mern-ecommerce

## Overview

This is a full-stack e-commerce store. Customers browse products, authenticate, manage a persistent cart, apply coupons, and complete checkout through Stripe; successful payment creates an order. Admins manage products and view sales analytics. The graph follows the documented and indexed frontend-to-API workflow and sampled backend calls. Analytics and several UI subsystems are represented from the tree and README, but their internal behavior is not inferred beyond documented or indexed relationships.

Main entry points: [`frontend/src/App.jsx`](https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/App.jsx) (App Routes), [`backend/server.js`](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/server.js) (Express API), [`backend/middleware/auth.middleware.js`](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/middleware/auth.middleware.js) (Route Protection), [`frontend/src/stores/useCartStore.js`](https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/stores/useCartStore.js) (Cart State)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["App Routes<br/>[App.jsx]"]
  node_product_ui["Product Browsing<br/>[HomePage.jsx]"]
  node_category_ui["Category View<br/>[CategoryPage.jsx]"]
end

subgraph group_identity["Identity and Access"]
  node_auth_ui["Login and Signup<br/>[LoginPage.jsx]"]
  node_user_store["User State<br/>[useUserStore.js]"]
  node_auth_controller["Authentication<br/>[auth.controller.js]"]
  node_auth_middleware["Route Protection<br/>[auth.middleware.js]"]
end

subgraph group_commerce["Cart and Checkout"]
  node_cart_ui["Cart and Coupon UI<br/>[CartPage.jsx]"]
  node_cart_store["Cart State<br/>[useCartStore.js]"]
  node_purchase_ui["Purchase Results"]
  node_cart_controller["Cart Services<br/>[cart.controller.js]"]
  node_coupon_controller["Coupon Services"]
  node_payment_controller["Checkout and Orders"]
end

subgraph group_admin["Catalog Administration"]
  node_admin_ui["Admin Dashboard<br/>[AdminPage.jsx]"]
  node_product_store["Product State<br/>[useProductStore.js]"]
  node_analytics_ui["Sales Analytics<br/>[AnalyticsTab.jsx]"]
  node_product_controller["Product Services"]
  node_analytics_controller["Analytics Services"]
end

subgraph group_runtime["API and Integrations"]
  node_api["Express API<br/>[server.js]"]
  node_auth_routes["Auth Routes<br/>[auth.route.js]"]
  node_product_routes["Product Routes<br/>[product.route.js]"]
  node_cart_routes["Cart Routes<br/>[cart.route.js]"]
  node_coupon_routes["Coupon Routes<br/>[coupon.route.js]"]
  node_payment_routes["Payment Routes<br/>[payment.route.js]"]
  node_analytics_routes["Analytics Routes<br/>[analytics.route.js]"]
  node_users[("User Records<br/>[user.model.js]")]
  node_products[("Product Records<br/>[product.model.js]")]
  node_coupons[("Coupon Records<br/>[coupon.model.js]")]
  node_orders[("Order Records<br/>[order.model.js]")]
  node_redis[("Redis Cache<br/>[redis.js]")]
  node_stripe["Stripe Checkout<br/>[stripe.js]"]
  node_cloudinary["Image Hosting<br/>[cloudinary.js]"]
  node_mongo[("MongoDB")]
end

node_customer(("Customer"))

node_customer -->|"uses"| node_app
node_app -->|"routes to"| node_auth_ui
node_app -->|"routes to"| node_cart_ui
node_app -->|"routes to"| node_admin_ui
node_app -->|"routes to"| node_product_ui
node_app -->|"routes to"| node_category_ui
node_app -->|"routes to"| node_purchase_ui
node_app -->|"checks auth"| node_user_store
node_app -->|"loads cart"| node_cart_store
node_auth_ui -->|"uses"| node_user_store
node_user_store -->|"requests auth"| node_auth_routes
node_cart_ui -->|"uses"| node_cart_store
node_cart_store -->|"requests cart"| node_cart_routes
node_cart_store -->|"requests coupons"| node_coupon_routes
node_purchase_ui -->|"clears cart"| node_cart_store
node_admin_ui -->|"uses"| node_product_store
node_admin_ui -->|"renders"| node_analytics_ui
node_product_store -->|"requests products"| node_product_routes
node_analytics_ui -.->|"requests analytics"| node_analytics_routes
node_api -->|"mounts"| node_auth_routes
node_api -->|"mounts"| node_product_routes
node_api -->|"mounts"| node_cart_routes
node_api -->|"mounts"| node_coupon_routes
node_api -->|"mounts"| node_payment_routes
node_api -->|"mounts"| node_analytics_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"protects profile"| node_auth_middleware
node_product_routes -->|"dispatches"| node_product_controller
node_product_routes -->|"protects admin"| node_auth_middleware
node_cart_routes -->|"dispatches"| node_cart_controller
node_cart_routes -->|"protects"| node_auth_middleware
node_coupon_routes -->|"dispatches"| node_coupon_controller
node_coupon_routes -->|"protects"| node_auth_middleware
node_payment_routes -->|"dispatches"| node_payment_controller
node_payment_routes -->|"protects"| node_auth_middleware
node_analytics_routes -->|"dispatches"| node_analytics_controller
node_analytics_routes -->|"protects"| node_auth_middleware
node_auth_controller -->|"reads and writes"| node_users
node_auth_controller -->|"stores tokens"| node_redis
node_auth_middleware -->|"loads user"| node_users
node_product_controller -->|"queries"| node_products
node_product_controller -->|"caches featured"| node_redis
node_product_controller -->|"uploads images"| node_cloudinary
node_cart_controller -->|"loads products"| node_products
node_payment_controller -->|"validates and updates"| node_coupons
node_payment_controller -->|"creates order"| node_orders
node_payment_controller -->|"creates session"| node_stripe
node_api -->|"connects"| node_mongo

click node_app "https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/App.jsx"
click node_product_ui "https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/pages/HomePage.jsx"
click node_category_ui "https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/pages/CategoryPage.jsx"
click node_auth_ui "https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/pages/LoginPage.jsx"
click node_user_store "https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/stores/useUserStore.js"
click node_cart_ui "https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/pages/CartPage.jsx"
click node_cart_store "https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/stores/useCartStore.js"
click node_purchase_ui "https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/pages/PurchaseSuccessPage.jsx"
click node_admin_ui "https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/pages/AdminPage.jsx"
click node_product_store "https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/stores/useProductStore.js"
click node_analytics_ui "https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/components/AnalyticsTab.jsx"
click node_api "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/server.js"
click node_auth_routes "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/routes/auth.route.js"
click node_product_routes "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/routes/product.route.js"
click node_cart_routes "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/routes/cart.route.js"
click node_coupon_routes "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/routes/coupon.route.js"
click node_payment_routes "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/routes/payment.route.js"
click node_analytics_routes "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/routes/analytics.route.js"
click node_auth_controller "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/controllers/auth.controller.js"
click node_auth_middleware "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/middleware/auth.middleware.js"
click node_product_controller "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/controllers/product.controller.js"
click node_cart_controller "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/controllers/cart.controller.js"
click node_coupon_controller "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/controllers/coupon.controller.js"
click node_payment_controller "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/controllers/payment.controller.js"
click node_analytics_controller "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/controllers/analytics.controller.js"
click node_users "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/models/user.model.js"
click node_products "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/models/product.model.js"
click node_coupons "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/models/coupon.model.js"
click node_orders "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/models/order.model.js"
click node_redis "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/lib/redis.js"
click node_stripe "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/lib/stripe.js"
click node_cloudinary "https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/lib/cloudinary.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_product_ui,node_category_ui toneBlue
class node_auth_ui,node_user_store,node_auth_controller,node_auth_middleware toneAmber
class node_cart_ui,node_cart_store,node_purchase_ui,node_cart_controller,node_coupon_controller,node_payment_controller toneMint
class node_admin_ui,node_product_store,node_analytics_ui,node_product_controller,node_analytics_controller toneRose
class node_api,node_auth_routes,node_product_routes,node_cart_routes,node_coupon_routes,node_payment_routes,node_analytics_routes,node_users,node_products,node_coupons,node_orders,node_redis,node_stripe,node_cloudinary,node_mongo,node_customer toneIndigo
```

## Components

### Storefront

- [App Routes](https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Product Browsing](https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/pages/HomePage.jsx): `frontend/src/pages/HomePage.jsx`
- [Category View](https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/pages/CategoryPage.jsx): `frontend/src/pages/CategoryPage.jsx`

### Identity and Access

- [Login and Signup](https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/pages/LoginPage.jsx): `frontend/src/pages/LoginPage.jsx`
- [User State](https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/stores/useUserStore.js): `frontend/src/stores/useUserStore.js`
- [Authentication](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/controllers/auth.controller.js): `backend/controllers/auth.controller.js`
- [Route Protection](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/middleware/auth.middleware.js): `backend/middleware/auth.middleware.js`

### Cart and Checkout

- [Cart and Coupon UI](https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/pages/CartPage.jsx): `frontend/src/pages/CartPage.jsx`
- [Cart State](https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/stores/useCartStore.js): `frontend/src/stores/useCartStore.js`
- [Purchase Results](https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/pages/PurchaseSuccessPage.jsx): `frontend/src/pages/PurchaseSuccessPage.jsx`
- [Cart Services](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/controllers/cart.controller.js): `backend/controllers/cart.controller.js`
- [Coupon Services](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/controllers/coupon.controller.js): `backend/controllers/coupon.controller.js`
- [Checkout and Orders](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/controllers/payment.controller.js): `backend/controllers/payment.controller.js`

### Catalog Administration

- [Admin Dashboard](https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/pages/AdminPage.jsx): `frontend/src/pages/AdminPage.jsx`
- [Product State](https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/stores/useProductStore.js): `frontend/src/stores/useProductStore.js`
- [Sales Analytics](https://github.com/burakorkmez/mern-ecommerce/blob/master/frontend/src/components/AnalyticsTab.jsx): `frontend/src/components/AnalyticsTab.jsx`
- [Product Services](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/controllers/product.controller.js): `backend/controllers/product.controller.js`
- [Analytics Services](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/controllers/analytics.controller.js): `backend/controllers/analytics.controller.js`

### API and Integrations

- [Express API](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/server.js): `backend/server.js`
- [Auth Routes](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/routes/auth.route.js): `backend/routes/auth.route.js`
- [Product Routes](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/routes/product.route.js): `backend/routes/product.route.js`
- [Cart Routes](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/routes/cart.route.js): `backend/routes/cart.route.js`
- [Coupon Routes](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/routes/coupon.route.js): `backend/routes/coupon.route.js`
- [Payment Routes](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/routes/payment.route.js): `backend/routes/payment.route.js`
- [Analytics Routes](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/routes/analytics.route.js): `backend/routes/analytics.route.js`
- [User Records](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/models/user.model.js): `backend/models/user.model.js`
- [Product Records](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/models/product.model.js): `backend/models/product.model.js`
- [Coupon Records](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/models/coupon.model.js): `backend/models/coupon.model.js`
- [Order Records](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/models/order.model.js): `backend/models/order.model.js`
- [Redis Cache](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/lib/redis.js): `backend/lib/redis.js`
- [Stripe Checkout](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/lib/stripe.js): `backend/lib/stripe.js`
- [Image Hosting](https://github.com/burakorkmez/mern-ecommerce/blob/master/backend/lib/cloudinary.js): `backend/lib/cloudinary.js`
- **MongoDB**

### Other components

- **Customer**

## Connections

- Customer → App Routes: uses (evidence: `frontend/src/App.jsx`)
- App Routes → Login and Signup: routes to (evidence: `frontend/src/App.jsx`)
- App Routes → Cart and Coupon UI: routes to (evidence: `frontend/src/App.jsx`)
- App Routes → Admin Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- App Routes → Product Browsing: routes to (evidence: `frontend/src/App.jsx`)
- App Routes → Category View: routes to (evidence: `frontend/src/App.jsx`)
- App Routes → Purchase Results: routes to (evidence: `frontend/src/App.jsx`)
- App Routes → User State: checks auth (evidence: `frontend/src/App.jsx`)
- App Routes → Cart State: loads cart (evidence: `frontend/src/App.jsx`)
- Login and Signup → User State: uses (evidence: `frontend/src/pages/LoginPage.jsx`)
- User State → Auth Routes: requests auth (evidence: `frontend/src/stores/useUserStore.js`)
- Cart and Coupon UI → Cart State: uses (evidence: `frontend/src/pages/CartPage.jsx`)
- Cart State → Cart Routes: requests cart (evidence: `frontend/src/stores/useCartStore.js`)
- Cart State → Coupon Routes: requests coupons (evidence: `frontend/src/stores/useCartStore.js`)
- Purchase Results → Cart State: clears cart (evidence: `frontend/src/pages/PurchaseSuccessPage.jsx`)
- Admin Dashboard → Product State: uses (evidence: `frontend/src/pages/AdminPage.jsx`)
- Admin Dashboard → Sales Analytics: renders (evidence: `frontend/src/pages/AdminPage.jsx`)
- Product State → Product Routes: requests products (evidence: `frontend/src/stores/useProductStore.js`)
- Sales Analytics → Analytics Routes: requests analytics
- Express API → Auth Routes: mounts (evidence: `backend/server.js`)
- Express API → Product Routes: mounts (evidence: `backend/server.js`)
- Express API → Cart Routes: mounts (evidence: `backend/server.js`)
- Express API → Coupon Routes: mounts (evidence: `backend/server.js`)
- Express API → Payment Routes: mounts (evidence: `backend/server.js`)
- Express API → Analytics Routes: mounts (evidence: `backend/server.js`)
- Auth Routes → Authentication: dispatches (evidence: `backend/routes/auth.route.js`)
- Auth Routes → Route Protection: protects profile (evidence: `backend/routes/auth.route.js`)
- Product Routes → Product Services: dispatches (evidence: `backend/routes/product.route.js`)
- Product Routes → Route Protection: protects admin (evidence: `backend/routes/product.route.js`)
- Cart Routes → Cart Services: dispatches (evidence: `backend/routes/cart.route.js`)
- Cart Routes → Route Protection: protects (evidence: `backend/routes/cart.route.js`)
- Coupon Routes → Coupon Services: dispatches (evidence: `backend/routes/coupon.route.js`)
- Coupon Routes → Route Protection: protects (evidence: `backend/routes/coupon.route.js`)
- Payment Routes → Checkout and Orders: dispatches (evidence: `backend/routes/payment.route.js`)
- Payment Routes → Route Protection: protects (evidence: `backend/routes/payment.route.js`)
- Analytics Routes → Analytics Services: dispatches (evidence: `backend/routes/analytics.route.js`)
- Analytics Routes → Route Protection: protects (evidence: `backend/routes/analytics.route.js`)
- Authentication → User Records: reads and writes (evidence: `backend/controllers/auth.controller.js`)
- Authentication → Redis Cache: stores tokens (evidence: `backend/controllers/auth.controller.js`)
- Route Protection → User Records: loads user (evidence: `backend/middleware/auth.middleware.js`)
- Product Services → Product Records: queries (evidence: `backend/controllers/product.controller.js`)
- Product Services → Redis Cache: caches featured (evidence: `backend/controllers/product.controller.js`)
- Product Services → Image Hosting: uploads images (evidence: `backend/controllers/product.controller.js`)
- Cart Services → Product Records: loads products (evidence: `backend/controllers/cart.controller.js`)
- Checkout and Orders → Coupon Records: validates and updates (evidence: `backend/controllers/payment.controller.js`)
- Checkout and Orders → Order Records: creates order (evidence: `backend/controllers/payment.controller.js`)
- Checkout and Orders → Stripe Checkout: creates session (evidence: `backend/controllers/payment.controller.js`)
- Express API → MongoDB: connects (evidence: `backend/server.js`)
