How hossam1416/full-stack-setupstore works
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: server.js Express API · orderController.js Order processing · api.js API client · Product.js Products
Components 27
Storefront
- Store pages
setupstore-frontend/src/app - Header
setupstore-frontend/src/components/Header.jsx - Footer
setupstore-frontend/src/components/Footer.jsx - Add-to-cart hook
setupstore-frontend/src/lib/useAddToCart.js
Account and admin
- Authentication pages
setupstore-frontend/src/app/login/page.js - Account pages
setupstore-frontend/src/app/account - Admin pages
setupstore-frontend/src/app/admin - Auth state
setupstore-frontend/src/context/AuthContext.js
API and domain logic
- API client
setupstore-frontend/src/lib/api.js - Express API
setupstore-backend/server.js - Authentication
setupstore-backend/controllers/authController.js - Product catalog
setupstore-backend/controllers/productController.js - Categories
setupstore-backend/controllers/categoryController.js - Cart operations
setupstore-backend/controllers/cartController.js - Order processing
setupstore-backend/controllers/orderController.js - Product comparison
setupstore-backend/controllers/compareController.js - PC builder
setupstore-backend/controllers/builderController.js - Route authorization
setupstore-backend/middleware/authMiddleware.js
Persistence
- Products
setupstore-backend/models/Product.js - Categories
setupstore-backend/models/Category.js - Carts
setupstore-backend/models/Cart.js - Orders
setupstore-backend/models/Order.js - Users
setupstore-backend/models/User.js - Saved builds
setupstore-backend/models/Build.js
Other components
- Customer
- Admin
- MongoDB
Connections 37
- Customer → Store pages: browses and shops
README.md - Customer → Authentication pages: registers or logs in
README.md - Admin → Admin pages: manages store
README.md - Store pages → API client: requests data
README.md - Authentication pages → Auth state: sets session
README.md - Auth state → API client: restores session
setupstore-frontend/src/context/AuthContext.js - Header → Auth state: reads user state
setupstore-frontend/src/components/Header.jsx - Add-to-cart hook → Auth state: checks user
setupstore-frontend/src/lib/useAddToCart.js - Add-to-cart hook → API client: posts cart item
setupstore-frontend/src/lib/useAddToCart.js - Store pages → Add-to-cart hook: adds products
README.md - API client → Express API: calls REST API
README.md - Express API → Authentication: routes auth
setupstore-backend/server.js - Express API → Product catalog: routes products
setupstore-backend/server.js - Express API → Categories: routes categories
setupstore-backend/server.js - Express API → Cart operations: routes cart
setupstore-backend/server.js - Express API → Order processing: routes orders
setupstore-backend/server.js - Express API → Product comparison: routes compare
setupstore-backend/server.js - Express API → PC builder: routes builder
setupstore-backend/server.js - Express API → MongoDB: connects database
setupstore-backend/server.js - Product catalog → Products: queries products
setupstore-backend/controllers/productController.js - Product catalog → Categories: resolves category
setupstore-backend/controllers/productController.js - Categories → Categories: manages categories
setupstore-backend/controllers/categoryController.js - Cart operations → Carts: reads and updates
setupstore-backend/controllers/cartController.js - Cart operations → Products: looks up products
setupstore-backend/controllers/cartController.js - Order processing → Carts: creates from cart
setupstore-backend/controllers/orderController.js - Order processing → Orders: creates and queries
setupstore-backend/controllers/orderController.js - Order processing → Products: updates stock
setupstore-backend/controllers/orderController.js - PC builder → Products: checks components
setupstore-backend/controllers/builderController.js - PC builder → Saved builds: saves builds
setupstore-backend/controllers/builderController.js - Authentication → Users: authenticates users
setupstore-backend/controllers/authController.js - Route authorization → Users: loads user
setupstore-backend/middleware/authMiddleware.js - Route authorization → Order processing: protects order routes
setupstore-backend/routes/orderRoutes.js - Admin pages → API client: manages catalog and orders
README.md - Product comparison → Products: compares products
- Express API → Users: routes user endpoints
setupstore-backend/server.js - Express API → Route authorization: route guards
- Footer → Store pages: supports site pages