How princex0/hunarhub_v2 works
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: App.jsx Route Shell · server.js Express API · AuthContext.jsx Auth State · auth.js JWT & Role Guard
Components 30
Marketplace Client
- Route Shell
client/src/App.jsx - Marketplace Discovery
client/src/pages/HomePage.jsx
Identity & Roles
- Auth State
client/src/context/AuthContext.jsx - Login & Registration
client/src/pages/LoginPage.jsx - User Profile
client/src/pages/ProfilePage.jsx - Auth Routes
server/routes/auth.js - JWT & Role Guard
server/middleware/auth.js
Product Commerce
- Product Browsing
client/src/pages/MarketplacePage.jsx - Product Detail
client/src/pages/ProductDetailPage.jsx - Product Card
client/src/components/ProductCard.jsx - Cart State
client/src/context/CartContext.jsx - Cart & Checkout
client/src/pages/CartPage.jsx - Seller Dashboard
client/src/pages/SellerDashboard.jsx - Product Routes
server/routes/products.js - Order Routes
server/routes/orders.js
Service Bookings
- Request a Service
client/src/pages/RequestService.jsx - Manage Requests
client/src/pages/ManageServiceRequests.jsx - Category Routes
server/routes/categories.js - Service Request Routes
server/routes/serviceRequests.js
Platform API & Data
- Admin Console
client/src/pages/AdminDashboard.jsx - Express API
server/server.js - Admin Routes
server/routes/admin.js - User Records
server/models/User.js - Product Records
server/models/Product.js - Order Records
server/models/Order.js - Review Records
server/models/Review.js - Category Records
server/models/Category.js - Service Request Records
server/models/ServiceRequest.js - MongoDB
server/config/db.js
Other components
- Buyer / Artisan / Admin
Connections 48
- Buyer / Artisan / Admin → Route Shell: uses
client/src/App.jsx - Route Shell → Auth State: provides
client/src/App.jsx - Route Shell → Marketplace Discovery: routes
client/src/App.jsx - Route Shell → Product Browsing: routes
client/src/App.jsx - Route Shell → Product Detail: routes
client/src/App.jsx - Route Shell → Seller Dashboard: routes
client/src/App.jsx - Route Shell → User Profile: routes
client/src/App.jsx - Route Shell → Login & Registration: routes
client/src/App.jsx - Route Shell → Cart & Checkout: routes
client/src/App.jsx - Route Shell → Admin Console: routes
client/src/App.jsx - Route Shell → Request a Service: routes
client/src/App.jsx - Route Shell → Manage Requests: routes
client/src/App.jsx - Marketplace Discovery → Product Card: renders
client/src/pages/HomePage.jsx - Product Browsing → Product Card: renders
client/src/pages/MarketplacePage.jsx - Product Detail → Cart State: updates
client/src/pages/ProductDetailPage.jsx - Cart & Checkout → Cart State: uses
client/src/pages/CartPage.jsx - Login & Registration → Auth State: authenticates
client/src/pages/LoginPage.jsx - User Profile → Auth State: uses
client/src/pages/ProfilePage.jsx - Seller Dashboard → Auth State: uses
client/src/pages/SellerDashboard.jsx - Admin Console → Auth State: uses
client/src/pages/AdminDashboard.jsx - Request a Service → Auth State: uses
client/src/pages/RequestService.jsx - Manage Requests → Auth State: uses
client/src/pages/ManageServiceRequests.jsx - Auth State → Auth Routes: calls API
client/src/context/AuthContext.jsx - Manage Requests → Service Request Routes: requests
client/src/pages/ManageServiceRequests.jsx - Route Shell → Express API: calls API
- Express API → Auth Routes: mounts
server/server.js - Express API → Product Routes: mounts
server/server.js - Express API → Order Routes: mounts
server/server.js - Express API → Admin Routes: mounts
server/server.js - Express API → Category Routes: mounts
server/server.js - Express API → Service Request Routes: mounts
server/server.js - Auth Routes → JWT & Role Guard: guards
server/routes/auth.js - Product Routes → JWT & Role Guard: guards
server/routes/products.js - Order Routes → JWT & Role Guard: guards
server/routes/orders.js - Admin Routes → JWT & Role Guard: guards
server/routes/admin.js - Category Routes → JWT & Role Guard: guards
server/routes/categories.js - Service Request Routes → JWT & Role Guard: guards
server/routes/serviceRequests.js - JWT & Role Guard → User Records: loads user
server/middleware/auth.js - Auth Routes → User Records: reads/writes
server/routes/auth.js - Product Routes → Product Records: reads/writes
server/routes/products.js - Product Routes → Review Records: reads/writes
server/routes/products.js - Order Routes → Order Records: reads/writes
server/routes/orders.js - Order Routes → Product Records: reads
server/routes/orders.js - Admin Routes → User Records: manages
server/routes/admin.js - Admin Routes → Category Records: manages
server/routes/admin.js - Admin Routes → Order Records: tracks
server/routes/admin.js - Admin Routes → Service Request Records: tracks
server/routes/admin.js - Category Routes → Category Records: reads/writes
server/routes/categories.js