How hirdeshpal888527/smartcommerce works
SmartCommerce is a MERN marketplace with buyer, seller, and admin portals. Buyers browse/search products, manage a cart or wishlist, check out, and track orders; sellers manage products and view analytics and orders, while admins manage users, products, and orders. The documented backend layers requests through Express routes, controllers, services, and MongoDB models, with search, caching, uploads, and mock payments as supporting capabilities. Some feature pages and integrations are unsampled, so those relationships are shown only where the README or source index supports them.
Main entry points: Product.js Product model · AppRoutes.jsx App routing · app.js Express app · productRoutes.js Product routes
Components 34
Buyer experience
- App routing
client/src/routes/AppRoutes.jsx - Auth state
client/src/store/authStore.jsx - Auth API
client/src/api/authApi.js - Order details
client/src/pages/customer/OrderDetailsPage.jsx - Order state
client/src/store/orderStore.js - Buyer commerce
client/src/pages/customer
Seller and admin
- Seller portal layout
client/src/layouts/SellerLayout.jsx - Seller management
client/src/pages/seller - Seller state
client/src/store/sellerStore.js - Admin management
client/src/pages/admin
Backend request layers
- Axios API layer
client/src/api/axios.js - Express app
server/src/app.js - Product routes
server/src/routes/productRoutes.js - Admin routes
server/src/routes/adminRoutes.js - Product controller
server/src/controllers/productController.js - Admin controller
server/src/controllers/adminController.js - Order service
server/src/services/orderServices.js - Product service
server/src/services/productServices.js - Admin service
server/src/services/adminServices.js - JWT authentication
server/src/middlewares/authMiddleware.js - Role authorization
server/src/middlewares/roleMiddleware.js - Async error wrapper
server/src/utils/asyncHandler.js
Commerce data
- Mongo connection
server/src/config/db.js - Product model
server/src/models/Product.js - Order model
server/src/models/Order.js - User model
server/src/models/User.js - Cart model
server/src/models/Cart.js
External services
- Meilisearch service
server/src/services/meiliServices.js - Meilisearch config
server/src/config/meilisearch.js - Redis caching
server/src/config/redis.js - Cloudinary uploads
server/src/config/cloudinary.js
Other components
- Buyer
- Seller
- Admin
Connections 42
- Buyer → App routing: navigates
client/src/routes/AppRoutes.jsx - App routing → Buyer commerce: routes to
client/src/routes/AppRoutes.jsx - App routing → Seller portal layout: routes to
client/src/routes/AppRoutes.jsx - App routing → Admin management: routes to
client/src/routes/AppRoutes.jsx - Auth state → Auth API: calls
client/src/store/authStore.jsx - Order details → Order state: uses
client/src/pages/customer/OrderDetailsPage.jsx - Seller → Seller portal layout: uses
- Seller portal layout → Seller management: hosts
client/src/routes/AppRoutes.jsx - Seller management → Seller state: uses
client/src/pages/seller/Dashboard.jsx - Admin → Admin management: uses
- Buyer commerce → Axios API layer: requests
README.md - Seller management → Axios API layer: requests
README.md - Admin management → Axios API layer: requests
README.md - Axios API layer → Express app: sends HTTP
README.md - Express app → Product routes: mounts
server/src/app.js - Express app → Admin routes: mounts
server/src/app.js - Product routes → JWT authentication: protects
server/src/routes/productRoutes.js - Product routes → Role authorization: authorizes
server/src/routes/productRoutes.js - Product routes → Product controller: dispatches
server/src/routes/productRoutes.js - Admin routes → JWT authentication: protects
server/src/routes/adminRoutes.js - Admin routes → Role authorization: authorizes
server/src/routes/adminRoutes.js - Admin routes → Admin controller: dispatches
server/src/routes/adminRoutes.js - Product controller → Product service: calls
server/src/controllers/productController.js - Product controller → Product model: reads
server/src/controllers/productController.js - Admin controller → Admin service: calls
server/src/controllers/adminController.js - Admin controller → Async error wrapper: wraps handlers
server/src/controllers/adminController.js - Product controller → Async error wrapper: wraps handlers
server/src/controllers/productController.js - Admin service → User model: queries
server/src/services/adminServices.js - Admin service → Product model: queries
server/src/services/adminServices.js - Admin service → Order model: queries
server/src/services/adminServices.js - Order service → Order model: reads and writes
server/src/services/orderServices.js - Order service → Cart model: reads and clears
server/src/services/orderServices.js - Order service → Product model: validates stock
server/src/services/orderServices.js - Product service → Product model: queries
server/src/services/productServices.js - Product service → Meilisearch service: searches
server/src/services/productServices.js - Meilisearch service → Meilisearch config: uses
server/src/services/meiliServices.js - Meilisearch service → Product model: indexes
server/src/services/meiliServices.js - Product service → Redis caching: caches
server/src/services/productServices.js - Express app → Cloudinary uploads: uploads images
README.md - Mongo connection → Product model: backs
README.md - Mongo connection → Order model: backs
README.md - Mongo connection → User model: backs
README.md