# arqum21/forever architecture

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

## Overview

Forever is a MERN clothing storefront with a separate admin console. Customers browse and filter products, manage a cart, authenticate, place cash-on-delivery orders, and view order history; administrators sign in to manage products and orders. The backend routes requests to domain controllers, which use MongoDB models; product uploads also use Cloudinary. The frontend context implements product and cart API calls. Some UI and admin API wiring is unsampled, so those relationships are omitted or marked unverified.

Main entry points: [`backend/server.js`](https://github.com/arqum21/forever/blob/main/backend/server.js) (API Server), [`frontend/src/App.jsx`](https://github.com/arqum21/forever/blob/main/frontend/src/App.jsx) (Storefront Routes), [`admin/src/App.jsx`](https://github.com/arqum21/forever/blob/main/admin/src/App.jsx) (Admin Routes), [`backend/routes/orderRoute.js`](https://github.com/arqum21/forever/blob/main/backend/routes/orderRoute.js) (Order Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Customer Storefront"]
  node_web_app["Storefront Routes<br/>[App.jsx]"]
  node_shop_context["Shop State and API<br/>[ShopContext.jsx]"]
  node_catalog_view["Catalog and Product Views<br/>[Collection.jsx]"]
  node_cart_checkout["Cart and Checkout<br/>[PlaceOrder.jsx]"]
  node_customer_account["Customer Account and Orders<br/>[Login.jsx]"]
  node_search_ui["Search Interface<br/>[SearchBar.jsx]"]
end

subgraph group_admin["Admin Console"]
  node_admin_app["Admin Routes<br/>[App.jsx]"]
  node_admin_login["Admin Login<br/>[Login.jsx]"]
  node_product_admin["Product Management<br/>[Add.jsx]"]
  node_order_admin["Order Management<br/>[Orders.jsx]"]
end

subgraph group_api["Backend API"]
  node_server["API Server<br/>[server.js]"]
  node_user_routes["User Routes<br/>[userRoute.js]"]
  node_product_routes["Product Routes<br/>[productRoute.js]"]
  node_cart_routes["Cart Routes<br/>[cartRoute.js]"]
  node_order_routes["Order Routes<br/>[orderRoute.js]"]
  node_user_logic["Authentication Logic<br/>[userController.js]"]
  node_product_logic["Catalog Logic"]
  node_cart_logic["Cart Logic<br/>[cartController.js]"]
  node_order_logic["Order Logic<br/>[orderController.js]"]
  node_auth_middleware["User Authorization<br/>[auth.js]"]
  node_admin_middleware["Admin Authorization<br/>[adminAuth.js]"]
end

subgraph group_data["Persistence and Media"]
  node_user_model[("User and Cart Records<br/>[userModel.js]")]
  node_product_model[("Product Records<br/>[productModel.js]")]
  node_order_model[("Order Records<br/>[orderModel.js]")]
  node_mongodb[("MongoDB<br/>[mongodb.js]")]
  node_cloudinary["Cloudinary Images<br/>[cloudinary.js]"]
end

node_shopper(("Shopper"))
node_admin_user(("Administrator"))

node_shopper -->|"uses"| node_web_app
node_web_app -.->|"provides state"| node_shop_context
node_web_app -->|"routes to"| node_catalog_view
node_web_app -->|"routes to"| node_cart_checkout
node_web_app -->|"routes to"| node_customer_account
node_web_app -->|"renders"| node_search_ui
node_shop_context -->|"requests products and cart"| node_server
node_admin_user -->|"uses"| node_admin_app
node_admin_app -->|"renders"| node_admin_login
node_admin_app -->|"routes to"| node_product_admin
node_admin_app -->|"routes to"| node_order_admin
node_product_admin -.->|"admin API calls"| node_server
node_order_admin -.->|"admin API calls"| node_server
node_server -->|"connects"| node_mongodb
node_server -->|"configures"| node_cloudinary
node_server -->|"mounts"| node_user_routes
node_server -->|"mounts"| node_product_routes
node_server -->|"mounts"| node_cart_routes
node_server -->|"mounts"| node_order_routes
node_user_routes -->|"dispatches"| node_user_logic
node_product_routes -->|"dispatches"| node_product_logic
node_cart_routes -->|"dispatches"| node_cart_logic
node_order_routes -->|"dispatches"| node_order_logic
node_cart_routes -->|"guards"| node_auth_middleware
node_order_routes -->|"guards"| node_auth_middleware
node_order_routes -->|"guards"| node_admin_middleware
node_product_routes -->|"guards"| node_admin_middleware
node_user_logic -->|"reads and writes"| node_user_model
node_cart_logic -->|"reads and updates"| node_user_model
node_order_logic -->|"creates and queries"| node_order_model
node_order_logic -->|"clears cart"| node_user_model
node_product_logic -->|"manages products"| node_product_model
node_product_logic -->|"uploads images"| node_cloudinary

click node_web_app "https://github.com/arqum21/forever/blob/main/frontend/src/App.jsx"
click node_shop_context "https://github.com/arqum21/forever/blob/main/frontend/src/context/ShopContext.jsx"
click node_catalog_view "https://github.com/arqum21/forever/blob/main/frontend/src/pages/Collection.jsx"
click node_cart_checkout "https://github.com/arqum21/forever/blob/main/frontend/src/pages/PlaceOrder.jsx"
click node_customer_account "https://github.com/arqum21/forever/blob/main/frontend/src/pages/Login.jsx"
click node_search_ui "https://github.com/arqum21/forever/blob/main/frontend/src/components/SearchBar.jsx"
click node_admin_app "https://github.com/arqum21/forever/blob/main/admin/src/App.jsx"
click node_admin_login "https://github.com/arqum21/forever/blob/main/admin/src/components/Login.jsx"
click node_product_admin "https://github.com/arqum21/forever/blob/main/admin/src/pages/Add.jsx"
click node_order_admin "https://github.com/arqum21/forever/blob/main/admin/src/pages/Orders.jsx"
click node_server "https://github.com/arqum21/forever/blob/main/backend/server.js"
click node_user_routes "https://github.com/arqum21/forever/blob/main/backend/routes/userRoute.js"
click node_product_routes "https://github.com/arqum21/forever/blob/main/backend/routes/productRoute.js"
click node_cart_routes "https://github.com/arqum21/forever/blob/main/backend/routes/cartRoute.js"
click node_order_routes "https://github.com/arqum21/forever/blob/main/backend/routes/orderRoute.js"
click node_user_logic "https://github.com/arqum21/forever/blob/main/backend/controllers/userController.js"
click node_product_logic "https://github.com/arqum21/forever/blob/main/backend/controllers/productController.js"
click node_cart_logic "https://github.com/arqum21/forever/blob/main/backend/controllers/cartController.js"
click node_order_logic "https://github.com/arqum21/forever/blob/main/backend/controllers/orderController.js"
click node_auth_middleware "https://github.com/arqum21/forever/blob/main/backend/middleware/auth.js"
click node_admin_middleware "https://github.com/arqum21/forever/blob/main/backend/middleware/adminAuth.js"
click node_user_model "https://github.com/arqum21/forever/blob/main/backend/models/userModel.js"
click node_product_model "https://github.com/arqum21/forever/blob/main/backend/models/productModel.js"
click node_order_model "https://github.com/arqum21/forever/blob/main/backend/models/orderModel.js"
click node_mongodb "https://github.com/arqum21/forever/blob/main/backend/config/mongodb.js"
click node_cloudinary "https://github.com/arqum21/forever/blob/main/backend/config/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_web_app,node_shop_context,node_catalog_view,node_cart_checkout,node_customer_account,node_search_ui toneBlue
class node_admin_app,node_admin_login,node_product_admin,node_order_admin toneAmber
class node_server,node_user_routes,node_product_routes,node_cart_routes,node_order_routes,node_user_logic,node_product_logic,node_cart_logic,node_order_logic,node_auth_middleware,node_admin_middleware toneMint
class node_user_model,node_product_model,node_order_model,node_mongodb,node_cloudinary toneRose
class node_shopper,node_admin_user toneIndigo
```

## Components

### Customer Storefront

- [Storefront Routes](https://github.com/arqum21/forever/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Shop State and API](https://github.com/arqum21/forever/blob/main/frontend/src/context/ShopContext.jsx): `frontend/src/context/ShopContext.jsx`
- [Catalog and Product Views](https://github.com/arqum21/forever/blob/main/frontend/src/pages/Collection.jsx): `frontend/src/pages/Collection.jsx`
- [Cart and Checkout](https://github.com/arqum21/forever/blob/main/frontend/src/pages/PlaceOrder.jsx): `frontend/src/pages/PlaceOrder.jsx`
- [Customer Account and Orders](https://github.com/arqum21/forever/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Search Interface](https://github.com/arqum21/forever/blob/main/frontend/src/components/SearchBar.jsx): `frontend/src/components/SearchBar.jsx`

### Admin Console

- [Admin Routes](https://github.com/arqum21/forever/blob/main/admin/src/App.jsx): `admin/src/App.jsx`
- [Admin Login](https://github.com/arqum21/forever/blob/main/admin/src/components/Login.jsx): `admin/src/components/Login.jsx`
- [Product Management](https://github.com/arqum21/forever/blob/main/admin/src/pages/Add.jsx): `admin/src/pages/Add.jsx`
- [Order Management](https://github.com/arqum21/forever/blob/main/admin/src/pages/Orders.jsx): `admin/src/pages/Orders.jsx`

### Backend API

- [API Server](https://github.com/arqum21/forever/blob/main/backend/server.js): `backend/server.js`
- [User Routes](https://github.com/arqum21/forever/blob/main/backend/routes/userRoute.js): `backend/routes/userRoute.js`
- [Product Routes](https://github.com/arqum21/forever/blob/main/backend/routes/productRoute.js): `backend/routes/productRoute.js`
- [Cart Routes](https://github.com/arqum21/forever/blob/main/backend/routes/cartRoute.js): `backend/routes/cartRoute.js`
- [Order Routes](https://github.com/arqum21/forever/blob/main/backend/routes/orderRoute.js): `backend/routes/orderRoute.js`
- [Authentication Logic](https://github.com/arqum21/forever/blob/main/backend/controllers/userController.js): `backend/controllers/userController.js`
- [Catalog Logic](https://github.com/arqum21/forever/blob/main/backend/controllers/productController.js): `backend/controllers/productController.js`
- [Cart Logic](https://github.com/arqum21/forever/blob/main/backend/controllers/cartController.js): `backend/controllers/cartController.js`
- [Order Logic](https://github.com/arqum21/forever/blob/main/backend/controllers/orderController.js): `backend/controllers/orderController.js`
- [User Authorization](https://github.com/arqum21/forever/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [Admin Authorization](https://github.com/arqum21/forever/blob/main/backend/middleware/adminAuth.js): `backend/middleware/adminAuth.js`

### Persistence and Media

- [User and Cart Records](https://github.com/arqum21/forever/blob/main/backend/models/userModel.js): `backend/models/userModel.js`
- [Product Records](https://github.com/arqum21/forever/blob/main/backend/models/productModel.js): `backend/models/productModel.js`
- [Order Records](https://github.com/arqum21/forever/blob/main/backend/models/orderModel.js): `backend/models/orderModel.js`
- [MongoDB](https://github.com/arqum21/forever/blob/main/backend/config/mongodb.js): `backend/config/mongodb.js`
- [Cloudinary Images](https://github.com/arqum21/forever/blob/main/backend/config/cloudinary.js): `backend/config/cloudinary.js`

### Other components

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

## Connections

- Shopper → Storefront Routes: uses (evidence: `README.md`)
- Storefront Routes → Shop State and API: provides state
- Storefront Routes → Catalog and Product Views: routes to (evidence: `frontend/src/App.jsx`)
- Storefront Routes → Cart and Checkout: routes to (evidence: `frontend/src/App.jsx`)
- Storefront Routes → Customer Account and Orders: routes to (evidence: `frontend/src/App.jsx`)
- Storefront Routes → Search Interface: renders (evidence: `frontend/src/App.jsx`)
- Shop State and API → API Server: requests products and cart (evidence: `frontend/src/context/ShopContext.jsx`)
- Administrator → Admin Routes: uses (evidence: `README.md`)
- Admin Routes → Admin Login: renders (evidence: `admin/src/App.jsx`)
- Admin Routes → Product Management: routes to (evidence: `admin/src/App.jsx`)
- Admin Routes → Order Management: routes to (evidence: `admin/src/App.jsx`)
- Product Management → API Server: admin API calls
- Order Management → API Server: admin API calls
- API Server → MongoDB: connects (evidence: `backend/server.js`)
- API Server → Cloudinary Images: configures (evidence: `backend/server.js`)
- 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`)
- User Routes → Authentication Logic: dispatches (evidence: `backend/routes/userRoute.js`)
- Product Routes → Catalog Logic: dispatches (evidence: `backend/routes/productRoute.js`)
- Cart Routes → Cart Logic: dispatches (evidence: `backend/routes/cartRoute.js`)
- Order Routes → Order Logic: dispatches (evidence: `backend/routes/orderRoute.js`)
- Cart Routes → User Authorization: guards (evidence: `backend/routes/cartRoute.js`)
- Order Routes → User Authorization: guards (evidence: `backend/routes/orderRoute.js`)
- Order Routes → Admin Authorization: guards (evidence: `backend/routes/orderRoute.js`)
- Product Routes → Admin Authorization: guards (evidence: `backend/routes/productRoute.js`)
- Authentication Logic → User and Cart Records: reads and writes (evidence: `backend/controllers/userController.js`)
- Cart Logic → User and Cart Records: reads and updates (evidence: `backend/controllers/cartController.js`)
- Order Logic → Order Records: creates and queries (evidence: `backend/controllers/orderController.js`)
- Order Logic → User and Cart Records: clears cart (evidence: `backend/controllers/orderController.js`)
- Catalog Logic → Product Records: manages products (evidence: `backend/controllers/productController.js`)
- Catalog Logic → Cloudinary Images: uploads images (evidence: `backend/controllers/productController.js`)
