# hossam1416/full-stack-setupstore architecture

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

- Interactive diagram: https://gitdiagram.com/hossam1416/full-stack-setupstore
- Repository: https://github.com/hossam1416/full-stack-setupstore

## Overview

SetupStore is a PC-components e-commerce application with a Next.js storefront and an Express/MongoDB API. The main customer journey is browsing products, adding items to a cart, checking out, and viewing orders; a separate PC-builder workflow checks compatibility and saves builds. Admins manage catalog data and orders. The README documents the frontend/API/database boundaries; source excerpts and the SOURCE INDEX confirm selected routes, controller calls, and model access. Some frontend-to-API and unsampled feature wiring is documented rather than directly excerpted.

Main entry points: [`setupstore-backend/server.js`](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/server.js) (Express API), [`setupstore-backend/controllers/orderController.js`](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/orderController.js) (Order processing), [`setupstore-frontend/src/lib/api.js`](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-frontend/src/lib/api.js) (API client), [`setupstore-backend/models/Product.js`](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/models/Product.js) (Products)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_storefront_pages["Store pages"]
  node_header["Header<br/>[Header.jsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
  node_cart_hook["Add-to-cart hook<br/>[useAddToCart.js]"]
end

subgraph group_account["Account and admin"]
  node_auth_ui["Authentication pages<br/>[page.js]"]
  node_account_ui["Account pages"]
  node_admin_ui["Admin pages"]
  node_auth_context["Auth state<br/>[AuthContext.js]"]
end

subgraph group_api["API and domain logic"]
  node_api_client["API client<br/>[api.js]"]
  node_api_server["Express API<br/>[server.js]"]
  node_auth["Authentication<br/>[authController.js]"]
  node_product["Product catalog"]
  node_category["Categories"]
  node_cart["Cart operations<br/>[cartController.js]"]
  node_orders["Order processing<br/>[orderController.js]"]
  node_compare["Product comparison"]
  node_builder["PC builder"]
  node_auth_middleware["Route authorization<br/>[authMiddleware.js]"]
end

subgraph group_data["Persistence"]
  node_products_data["Products<br/>[Product.js]"]
  node_categories_data["Categories<br/>[Category.js]"]
  node_cart_data["Carts<br/>[Cart.js]"]
  node_orders_data["Orders<br/>[Order.js]"]
  node_users_data["Users<br/>[User.js]"]
  node_builds_data["Saved builds<br/>[Build.js]"]
end

node_customer(("Customer"))
node_admin(("Admin"))
node_mongo[("MongoDB")]

node_customer -->|"browses and shops"| node_storefront_pages
node_customer -->|"registers or logs in"| node_auth_ui
node_admin -->|"manages store"| node_admin_ui
node_storefront_pages -.->|"requests data"| node_api_client
node_auth_ui -.->|"sets session"| node_auth_context
node_auth_context -->|"restores session"| node_api_client
node_header -->|"reads user state"| node_auth_context
node_cart_hook -->|"checks user"| node_auth_context
node_cart_hook -->|"posts cart item"| node_api_client
node_storefront_pages -.->|"adds products"| node_cart_hook
node_api_client -->|"calls REST API"| node_api_server
node_api_server -->|"routes auth"| node_auth
node_api_server -->|"routes products"| node_product
node_api_server -->|"routes categories"| node_category
node_api_server -->|"routes cart"| node_cart
node_api_server -->|"routes orders"| node_orders
node_api_server -->|"routes compare"| node_compare
node_api_server -->|"routes builder"| node_builder
node_api_server -->|"connects database"| node_mongo
node_product -->|"queries products"| node_products_data
node_product -->|"resolves category"| node_categories_data
node_category -->|"manages categories"| node_categories_data
node_cart -->|"reads and updates"| node_cart_data
node_cart -->|"looks up products"| node_products_data
node_orders -->|"creates from cart"| node_cart_data
node_orders -->|"creates and queries"| node_orders_data
node_orders -->|"updates stock"| node_products_data
node_builder -->|"checks components"| node_products_data
node_builder -->|"saves builds"| node_builds_data
node_auth -->|"authenticates users"| node_users_data
node_auth_middleware -->|"loads user"| node_users_data
node_auth_middleware -->|"protects order routes"| node_orders
node_admin_ui -.->|"manages catalog and orders"| node_api_client
node_compare -.->|"compares products"| node_products_data
node_api_server -->|"routes user endpoints"| node_users_data
node_api_server -.->|"route guards"| node_auth_middleware
node_footer -.->|"supports site pages"| node_storefront_pages

click node_storefront_pages "https://github.com/hossam1416/full-stack-setupstore/tree/main/setupstore-frontend/src/app"
click node_header "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-frontend/src/components/Header.jsx"
click node_footer "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-frontend/src/components/Footer.jsx"
click node_auth_ui "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-frontend/src/app/login/page.js"
click node_account_ui "https://github.com/hossam1416/full-stack-setupstore/tree/main/setupstore-frontend/src/app/account"
click node_admin_ui "https://github.com/hossam1416/full-stack-setupstore/tree/main/setupstore-frontend/src/app/admin"
click node_auth_context "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-frontend/src/context/AuthContext.js"
click node_api_client "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-frontend/src/lib/api.js"
click node_cart_hook "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-frontend/src/lib/useAddToCart.js"
click node_api_server "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/server.js"
click node_auth "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/authController.js"
click node_product "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/productController.js"
click node_category "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/categoryController.js"
click node_cart "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/cartController.js"
click node_orders "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/orderController.js"
click node_compare "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/compareController.js"
click node_builder "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/builderController.js"
click node_auth_middleware "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/middleware/authMiddleware.js"
click node_products_data "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/models/Product.js"
click node_categories_data "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/models/Category.js"
click node_cart_data "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/models/Cart.js"
click node_orders_data "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/models/Order.js"
click node_users_data "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/models/User.js"
click node_builds_data "https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/models/Build.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_storefront_pages,node_header,node_footer,node_cart_hook toneBlue
class node_auth_ui,node_account_ui,node_admin_ui,node_auth_context,node_mongo toneAmber
class node_api_client,node_api_server,node_auth,node_product,node_category,node_cart,node_orders,node_compare,node_builder,node_auth_middleware toneMint
class node_products_data,node_categories_data,node_cart_data,node_orders_data,node_users_data,node_builds_data toneRose
class node_customer,node_admin toneIndigo
```

## Components

### Storefront

- [Store pages](https://github.com/hossam1416/full-stack-setupstore/tree/main/setupstore-frontend/src/app): `setupstore-frontend/src/app`
- [Header](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-frontend/src/components/Header.jsx): `setupstore-frontend/src/components/Header.jsx`
- [Footer](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-frontend/src/components/Footer.jsx): `setupstore-frontend/src/components/Footer.jsx`
- [Add-to-cart hook](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-frontend/src/lib/useAddToCart.js): `setupstore-frontend/src/lib/useAddToCart.js`

### Account and admin

- [Authentication pages](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-frontend/src/app/login/page.js): `setupstore-frontend/src/app/login/page.js`
- [Account pages](https://github.com/hossam1416/full-stack-setupstore/tree/main/setupstore-frontend/src/app/account): `setupstore-frontend/src/app/account`
- [Admin pages](https://github.com/hossam1416/full-stack-setupstore/tree/main/setupstore-frontend/src/app/admin): `setupstore-frontend/src/app/admin`
- [Auth state](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-frontend/src/context/AuthContext.js): `setupstore-frontend/src/context/AuthContext.js`

### API and domain logic

- [API client](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-frontend/src/lib/api.js): `setupstore-frontend/src/lib/api.js`
- [Express API](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/server.js): `setupstore-backend/server.js`
- [Authentication](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/authController.js): `setupstore-backend/controllers/authController.js`
- [Product catalog](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/productController.js): `setupstore-backend/controllers/productController.js`
- [Categories](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/categoryController.js): `setupstore-backend/controllers/categoryController.js`
- [Cart operations](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/cartController.js): `setupstore-backend/controllers/cartController.js`
- [Order processing](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/orderController.js): `setupstore-backend/controllers/orderController.js`
- [Product comparison](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/compareController.js): `setupstore-backend/controllers/compareController.js`
- [PC builder](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/controllers/builderController.js): `setupstore-backend/controllers/builderController.js`
- [Route authorization](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/middleware/authMiddleware.js): `setupstore-backend/middleware/authMiddleware.js`

### Persistence

- [Products](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/models/Product.js): `setupstore-backend/models/Product.js`
- [Categories](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/models/Category.js): `setupstore-backend/models/Category.js`
- [Carts](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/models/Cart.js): `setupstore-backend/models/Cart.js`
- [Orders](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/models/Order.js): `setupstore-backend/models/Order.js`
- [Users](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/models/User.js): `setupstore-backend/models/User.js`
- [Saved builds](https://github.com/hossam1416/full-stack-setupstore/blob/main/setupstore-backend/models/Build.js): `setupstore-backend/models/Build.js`

### Other components

- **Customer**
- **Admin**
- **MongoDB**

## Connections

- Customer → Store pages: browses and shops (evidence: `README.md`)
- Customer → Authentication pages: registers or logs in (evidence: `README.md`)
- Admin → Admin pages: manages store (evidence: `README.md`)
- Store pages → API client: requests data (evidence: `README.md`)
- Authentication pages → Auth state: sets session (evidence: `README.md`)
- Auth state → API client: restores session (evidence: `setupstore-frontend/src/context/AuthContext.js`)
- Header → Auth state: reads user state (evidence: `setupstore-frontend/src/components/Header.jsx`)
- Add-to-cart hook → Auth state: checks user (evidence: `setupstore-frontend/src/lib/useAddToCart.js`)
- Add-to-cart hook → API client: posts cart item (evidence: `setupstore-frontend/src/lib/useAddToCart.js`)
- Store pages → Add-to-cart hook: adds products (evidence: `README.md`)
- API client → Express API: calls REST API (evidence: `README.md`)
- Express API → Authentication: routes auth (evidence: `setupstore-backend/server.js`)
- Express API → Product catalog: routes products (evidence: `setupstore-backend/server.js`)
- Express API → Categories: routes categories (evidence: `setupstore-backend/server.js`)
- Express API → Cart operations: routes cart (evidence: `setupstore-backend/server.js`)
- Express API → Order processing: routes orders (evidence: `setupstore-backend/server.js`)
- Express API → Product comparison: routes compare (evidence: `setupstore-backend/server.js`)
- Express API → PC builder: routes builder (evidence: `setupstore-backend/server.js`)
- Express API → MongoDB: connects database (evidence: `setupstore-backend/server.js`)
- Product catalog → Products: queries products (evidence: `setupstore-backend/controllers/productController.js`)
- Product catalog → Categories: resolves category (evidence: `setupstore-backend/controllers/productController.js`)
- Categories → Categories: manages categories (evidence: `setupstore-backend/controllers/categoryController.js`)
- Cart operations → Carts: reads and updates (evidence: `setupstore-backend/controllers/cartController.js`)
- Cart operations → Products: looks up products (evidence: `setupstore-backend/controllers/cartController.js`)
- Order processing → Carts: creates from cart (evidence: `setupstore-backend/controllers/orderController.js`)
- Order processing → Orders: creates and queries (evidence: `setupstore-backend/controllers/orderController.js`)
- Order processing → Products: updates stock (evidence: `setupstore-backend/controllers/orderController.js`)
- PC builder → Products: checks components (evidence: `setupstore-backend/controllers/builderController.js`)
- PC builder → Saved builds: saves builds (evidence: `setupstore-backend/controllers/builderController.js`)
- Authentication → Users: authenticates users (evidence: `setupstore-backend/controllers/authController.js`)
- Route authorization → Users: loads user (evidence: `setupstore-backend/middleware/authMiddleware.js`)
- Route authorization → Order processing: protects order routes (evidence: `setupstore-backend/routes/orderRoutes.js`)
- Admin pages → API client: manages catalog and orders (evidence: `README.md`)
- Product comparison → Products: compares products
- Express API → Users: routes user endpoints (evidence: `setupstore-backend/server.js`)
- Express API → Route authorization: route guards
- Footer → Store pages: supports site pages
