# princex0/hunarhub_v2 architecture

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

- Interactive diagram: https://gitdiagram.com/princex0/hunarhub_v2
- Repository: https://github.com/princex0/hunarhub_v2

## Overview

HunarHub is a role-based artisan marketplace for physical craft sales and custom service bookings. Buyers browse products, maintain a locally persisted cart, and place orders; customers can also request artisan services. Sellers manage listings and incoming requests, while admins oversee artisans, categories, orders, and platform analytics. The React client routes these experiences and calls Express API route modules, which enforce authentication and use MongoDB models. Some major capability modules are unsampled, so those branches follow README descriptions and indexed route references; unverified wiring is omitted.

Main entry points: [`client/src/App.jsx`](https://github.com/princex0/hunarhub_v2/blob/main/client/src/App.jsx) (Route Shell), [`server/server.js`](https://github.com/princex0/hunarhub_v2/blob/main/server/server.js) (Express API), [`client/src/context/AuthContext.jsx`](https://github.com/princex0/hunarhub_v2/blob/main/client/src/context/AuthContext.jsx) (Auth State), [`server/middleware/auth.js`](https://github.com/princex0/hunarhub_v2/blob/main/server/middleware/auth.js) (JWT & Role Guard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Marketplace Client"]
  node_app["Route Shell<br/>[App.jsx]"]
  node_home["Marketplace Discovery<br/>[HomePage.jsx]"]
end

subgraph group_identity["Identity &amp; Roles"]
  node_authui["Auth State<br/>[AuthContext.jsx]"]
  node_authpages["Login &amp; Registration<br/>[LoginPage.jsx]"]
  node_profile["User Profile<br/>[ProfilePage.jsx]"]
  node_authroutes["Auth Routes<br/>[auth.js]"]
  node_authmw["JWT &amp; Role Guard<br/>[auth.js]"]
end

subgraph group_commerce["Product Commerce"]
  node_market["Product Browsing"]
  node_productdetail["Product Detail"]
  node_productcard["Product Card<br/>[ProductCard.jsx]"]
  node_cartstate["Cart State<br/>[CartContext.jsx]"]
  node_cartpage["Cart &amp; Checkout<br/>[CartPage.jsx]"]
  node_sellerui["Seller Dashboard"]
  node_productroutes["Product Routes<br/>[products.js]"]
  node_orderroutes["Order Routes<br/>[orders.js]"]
end

subgraph group_services["Service Bookings"]
  node_requestui["Request a Service<br/>[RequestService.jsx]"]
  node_manageui["Manage Requests"]
  node_categoryroutes["Category Routes<br/>[categories.js]"]
  node_serviceroutes["Service Request Routes<br/>[serviceRequests.js]"]
end

subgraph group_platform["Platform API &amp; Data"]
  node_adminui["Admin Console<br/>[AdminDashboard.jsx]"]
  node_api["Express API<br/>[server.js]"]
  node_adminroutes["Admin Routes<br/>[admin.js]"]
  node_users[("User Records<br/>[User.js]")]
  node_products[("Product Records<br/>[Product.js]")]
  node_orders[("Order Records<br/>[Order.js]")]
  node_reviews[("Review Records<br/>[Review.js]")]
  node_categories[("Category Records<br/>[Category.js]")]
  node_servicerequests[("Service Request Records<br/>[ServiceRequest.js]")]
  node_mongo[("MongoDB<br/>[db.js]")]
end

node_visitor(("Buyer / Artisan / Admin"))

node_visitor -->|"uses"| node_app
node_app -->|"provides"| node_authui
node_app -->|"routes"| node_home
node_app -->|"routes"| node_market
node_app -->|"routes"| node_productdetail
node_app -->|"routes"| node_sellerui
node_app -->|"routes"| node_profile
node_app -->|"routes"| node_authpages
node_app -->|"routes"| node_cartpage
node_app -->|"routes"| node_adminui
node_app -->|"routes"| node_requestui
node_app -->|"routes"| node_manageui
node_home -->|"renders"| node_productcard
node_market -->|"renders"| node_productcard
node_productdetail -->|"updates"| node_cartstate
node_cartpage -->|"uses"| node_cartstate
node_authpages -->|"authenticates"| node_authui
node_profile -->|"uses"| node_authui
node_sellerui -->|"uses"| node_authui
node_adminui -->|"uses"| node_authui
node_requestui -->|"uses"| node_authui
node_manageui -->|"uses"| node_authui
node_authui -->|"calls API"| node_authroutes
node_manageui -->|"requests"| node_serviceroutes
node_app -.->|"calls API"| node_api
node_api -->|"mounts"| node_authroutes
node_api -->|"mounts"| node_productroutes
node_api -->|"mounts"| node_orderroutes
node_api -->|"mounts"| node_adminroutes
node_api -->|"mounts"| node_categoryroutes
node_api -->|"mounts"| node_serviceroutes
node_authroutes -->|"guards"| node_authmw
node_productroutes -->|"guards"| node_authmw
node_orderroutes -->|"guards"| node_authmw
node_adminroutes -->|"guards"| node_authmw
node_categoryroutes -->|"guards"| node_authmw
node_serviceroutes -->|"guards"| node_authmw
node_authmw -->|"loads user"| node_users
node_authroutes -->|"reads/writes"| node_users
node_productroutes -->|"reads/writes"| node_products
node_productroutes -->|"reads/writes"| node_reviews
node_orderroutes -->|"reads/writes"| node_orders
node_orderroutes -->|"reads"| node_products
node_adminroutes -->|"manages"| node_users
node_adminroutes -->|"manages"| node_categories
node_adminroutes -->|"tracks"| node_orders
node_adminroutes -->|"tracks"| node_servicerequests
node_categoryroutes -->|"reads/writes"| node_categories

click node_app "https://github.com/princex0/hunarhub_v2/blob/main/client/src/App.jsx"
click node_authui "https://github.com/princex0/hunarhub_v2/blob/main/client/src/context/AuthContext.jsx"
click node_authpages "https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/LoginPage.jsx"
click node_home "https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/HomePage.jsx"
click node_market "https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/MarketplacePage.jsx"
click node_productdetail "https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/ProductDetailPage.jsx"
click node_productcard "https://github.com/princex0/hunarhub_v2/blob/main/client/src/components/ProductCard.jsx"
click node_cartstate "https://github.com/princex0/hunarhub_v2/blob/main/client/src/context/CartContext.jsx"
click node_cartpage "https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/CartPage.jsx"
click node_sellerui "https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/SellerDashboard.jsx"
click node_profile "https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/ProfilePage.jsx"
click node_adminui "https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/AdminDashboard.jsx"
click node_requestui "https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/RequestService.jsx"
click node_manageui "https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/ManageServiceRequests.jsx"
click node_api "https://github.com/princex0/hunarhub_v2/blob/main/server/server.js"
click node_authroutes "https://github.com/princex0/hunarhub_v2/blob/main/server/routes/auth.js"
click node_authmw "https://github.com/princex0/hunarhub_v2/blob/main/server/middleware/auth.js"
click node_productroutes "https://github.com/princex0/hunarhub_v2/blob/main/server/routes/products.js"
click node_orderroutes "https://github.com/princex0/hunarhub_v2/blob/main/server/routes/orders.js"
click node_adminroutes "https://github.com/princex0/hunarhub_v2/blob/main/server/routes/admin.js"
click node_categoryroutes "https://github.com/princex0/hunarhub_v2/blob/main/server/routes/categories.js"
click node_serviceroutes "https://github.com/princex0/hunarhub_v2/blob/main/server/routes/serviceRequests.js"
click node_users "https://github.com/princex0/hunarhub_v2/blob/main/server/models/User.js"
click node_products "https://github.com/princex0/hunarhub_v2/blob/main/server/models/Product.js"
click node_orders "https://github.com/princex0/hunarhub_v2/blob/main/server/models/Order.js"
click node_reviews "https://github.com/princex0/hunarhub_v2/blob/main/server/models/Review.js"
click node_categories "https://github.com/princex0/hunarhub_v2/blob/main/server/models/Category.js"
click node_servicerequests "https://github.com/princex0/hunarhub_v2/blob/main/server/models/ServiceRequest.js"
click node_mongo "https://github.com/princex0/hunarhub_v2/blob/main/server/config/db.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_home toneBlue
class node_authui,node_authpages,node_profile,node_authroutes,node_authmw toneAmber
class node_market,node_productdetail,node_productcard,node_cartstate,node_cartpage,node_sellerui,node_productroutes,node_orderroutes toneMint
class node_requestui,node_manageui,node_categoryroutes,node_serviceroutes toneRose
class node_adminui,node_api,node_adminroutes,node_users,node_products,node_orders,node_reviews,node_categories,node_servicerequests,node_mongo,node_visitor toneIndigo
```

## Components

### Marketplace Client

- [Route Shell](https://github.com/princex0/hunarhub_v2/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Marketplace Discovery](https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/HomePage.jsx): `client/src/pages/HomePage.jsx`

### Identity & Roles

- [Auth State](https://github.com/princex0/hunarhub_v2/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Login & Registration](https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/LoginPage.jsx): `client/src/pages/LoginPage.jsx`
- [User Profile](https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/ProfilePage.jsx): `client/src/pages/ProfilePage.jsx`
- [Auth Routes](https://github.com/princex0/hunarhub_v2/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [JWT & Role Guard](https://github.com/princex0/hunarhub_v2/blob/main/server/middleware/auth.js): `server/middleware/auth.js`

### Product Commerce

- [Product Browsing](https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/MarketplacePage.jsx): `client/src/pages/MarketplacePage.jsx`
- [Product Detail](https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/ProductDetailPage.jsx): `client/src/pages/ProductDetailPage.jsx`
- [Product Card](https://github.com/princex0/hunarhub_v2/blob/main/client/src/components/ProductCard.jsx): `client/src/components/ProductCard.jsx`
- [Cart State](https://github.com/princex0/hunarhub_v2/blob/main/client/src/context/CartContext.jsx): `client/src/context/CartContext.jsx`
- [Cart & Checkout](https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/CartPage.jsx): `client/src/pages/CartPage.jsx`
- [Seller Dashboard](https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/SellerDashboard.jsx): `client/src/pages/SellerDashboard.jsx`
- [Product Routes](https://github.com/princex0/hunarhub_v2/blob/main/server/routes/products.js): `server/routes/products.js`
- [Order Routes](https://github.com/princex0/hunarhub_v2/blob/main/server/routes/orders.js): `server/routes/orders.js`

### Service Bookings

- [Request a Service](https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/RequestService.jsx): `client/src/pages/RequestService.jsx`
- [Manage Requests](https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/ManageServiceRequests.jsx): `client/src/pages/ManageServiceRequests.jsx`
- [Category Routes](https://github.com/princex0/hunarhub_v2/blob/main/server/routes/categories.js): `server/routes/categories.js`
- [Service Request Routes](https://github.com/princex0/hunarhub_v2/blob/main/server/routes/serviceRequests.js): `server/routes/serviceRequests.js`

### Platform API & Data

- [Admin Console](https://github.com/princex0/hunarhub_v2/blob/main/client/src/pages/AdminDashboard.jsx): `client/src/pages/AdminDashboard.jsx`
- [Express API](https://github.com/princex0/hunarhub_v2/blob/main/server/server.js): `server/server.js`
- [Admin Routes](https://github.com/princex0/hunarhub_v2/blob/main/server/routes/admin.js): `server/routes/admin.js`
- [User Records](https://github.com/princex0/hunarhub_v2/blob/main/server/models/User.js): `server/models/User.js`
- [Product Records](https://github.com/princex0/hunarhub_v2/blob/main/server/models/Product.js): `server/models/Product.js`
- [Order Records](https://github.com/princex0/hunarhub_v2/blob/main/server/models/Order.js): `server/models/Order.js`
- [Review Records](https://github.com/princex0/hunarhub_v2/blob/main/server/models/Review.js): `server/models/Review.js`
- [Category Records](https://github.com/princex0/hunarhub_v2/blob/main/server/models/Category.js): `server/models/Category.js`
- [Service Request Records](https://github.com/princex0/hunarhub_v2/blob/main/server/models/ServiceRequest.js): `server/models/ServiceRequest.js`
- [MongoDB](https://github.com/princex0/hunarhub_v2/blob/main/server/config/db.js): `server/config/db.js`

### Other components

- **Buyer / Artisan / Admin**

## Connections

- Buyer / Artisan / Admin → Route Shell: uses (evidence: `client/src/App.jsx`)
- Route Shell → Auth State: provides (evidence: `client/src/App.jsx`)
- Route Shell → Marketplace Discovery: routes (evidence: `client/src/App.jsx`)
- Route Shell → Product Browsing: routes (evidence: `client/src/App.jsx`)
- Route Shell → Product Detail: routes (evidence: `client/src/App.jsx`)
- Route Shell → Seller Dashboard: routes (evidence: `client/src/App.jsx`)
- Route Shell → User Profile: routes (evidence: `client/src/App.jsx`)
- Route Shell → Login & Registration: routes (evidence: `client/src/App.jsx`)
- Route Shell → Cart & Checkout: routes (evidence: `client/src/App.jsx`)
- Route Shell → Admin Console: routes (evidence: `client/src/App.jsx`)
- Route Shell → Request a Service: routes (evidence: `client/src/App.jsx`)
- Route Shell → Manage Requests: routes (evidence: `client/src/App.jsx`)
- Marketplace Discovery → Product Card: renders (evidence: `client/src/pages/HomePage.jsx`)
- Product Browsing → Product Card: renders (evidence: `client/src/pages/MarketplacePage.jsx`)
- Product Detail → Cart State: updates (evidence: `client/src/pages/ProductDetailPage.jsx`)
- Cart & Checkout → Cart State: uses (evidence: `client/src/pages/CartPage.jsx`)
- Login & Registration → Auth State: authenticates (evidence: `client/src/pages/LoginPage.jsx`)
- User Profile → Auth State: uses (evidence: `client/src/pages/ProfilePage.jsx`)
- Seller Dashboard → Auth State: uses (evidence: `client/src/pages/SellerDashboard.jsx`)
- Admin Console → Auth State: uses (evidence: `client/src/pages/AdminDashboard.jsx`)
- Request a Service → Auth State: uses (evidence: `client/src/pages/RequestService.jsx`)
- Manage Requests → Auth State: uses (evidence: `client/src/pages/ManageServiceRequests.jsx`)
- Auth State → Auth Routes: calls API (evidence: `client/src/context/AuthContext.jsx`)
- Manage Requests → Service Request Routes: requests (evidence: `client/src/pages/ManageServiceRequests.jsx`)
- Route Shell → Express API: calls API
- Express API → Auth Routes: mounts (evidence: `server/server.js`)
- Express API → Product Routes: mounts (evidence: `server/server.js`)
- Express API → Order Routes: mounts (evidence: `server/server.js`)
- Express API → Admin Routes: mounts (evidence: `server/server.js`)
- Express API → Category Routes: mounts (evidence: `server/server.js`)
- Express API → Service Request Routes: mounts (evidence: `server/server.js`)
- Auth Routes → JWT & Role Guard: guards (evidence: `server/routes/auth.js`)
- Product Routes → JWT & Role Guard: guards (evidence: `server/routes/products.js`)
- Order Routes → JWT & Role Guard: guards (evidence: `server/routes/orders.js`)
- Admin Routes → JWT & Role Guard: guards (evidence: `server/routes/admin.js`)
- Category Routes → JWT & Role Guard: guards (evidence: `server/routes/categories.js`)
- Service Request Routes → JWT & Role Guard: guards (evidence: `server/routes/serviceRequests.js`)
- JWT & Role Guard → User Records: loads user (evidence: `server/middleware/auth.js`)
- Auth Routes → User Records: reads/writes (evidence: `server/routes/auth.js`)
- Product Routes → Product Records: reads/writes (evidence: `server/routes/products.js`)
- Product Routes → Review Records: reads/writes (evidence: `server/routes/products.js`)
- Order Routes → Order Records: reads/writes (evidence: `server/routes/orders.js`)
- Order Routes → Product Records: reads (evidence: `server/routes/orders.js`)
- Admin Routes → User Records: manages (evidence: `server/routes/admin.js`)
- Admin Routes → Category Records: manages (evidence: `server/routes/admin.js`)
- Admin Routes → Order Records: tracks (evidence: `server/routes/admin.js`)
- Admin Routes → Service Request Records: tracks (evidence: `server/routes/admin.js`)
- Category Routes → Category Records: reads/writes (evidence: `server/routes/categories.js`)
