How arqum21/forever works
Forever is a MERN clothing storefront with a separate admin console. Customers browse and filter products, manage a cart, authenticate, place cash-on-delivery orders, and view order history; administrators sign in to manage products and orders. The backend routes requests to domain controllers, which use MongoDB models; product uploads also use Cloudinary. The frontend context implements product and cart API calls. Some UI and admin API wiring is unsampled, so those relationships are omitted or marked unverified.
Main entry points: server.js API Server · src/App.jsx Storefront Routes · src/App.jsx Admin Routes · orderRoute.js Order Routes
Components 28
Customer Storefront
- Storefront Routes
frontend/src/App.jsx - Shop State and API
frontend/src/context/ShopContext.jsx - Catalog and Product Views
frontend/src/pages/Collection.jsx - Cart and Checkout
frontend/src/pages/PlaceOrder.jsx - Customer Account and Orders
frontend/src/pages/Login.jsx - Search Interface
frontend/src/components/SearchBar.jsx
Admin Console
- Admin Routes
admin/src/App.jsx - Admin Login
admin/src/components/Login.jsx - Product Management
admin/src/pages/Add.jsx - Order Management
admin/src/pages/Orders.jsx
Backend API
- API Server
backend/server.js - User Routes
backend/routes/userRoute.js - Product Routes
backend/routes/productRoute.js - Cart Routes
backend/routes/cartRoute.js - Order Routes
backend/routes/orderRoute.js - Authentication Logic
backend/controllers/userController.js - Catalog Logic
backend/controllers/productController.js - Cart Logic
backend/controllers/cartController.js - Order Logic
backend/controllers/orderController.js - User Authorization
backend/middleware/auth.js - Admin Authorization
backend/middleware/adminAuth.js
Persistence and Media
- User and Cart Records
backend/models/userModel.js - Product Records
backend/models/productModel.js - Order Records
backend/models/orderModel.js - MongoDB
backend/config/mongodb.js - Cloudinary Images
backend/config/cloudinary.js
Other components
- Shopper
- Administrator
Connections 33
- Shopper → Storefront Routes: uses
README.md - Storefront Routes → Shop State and API: provides state
- Storefront Routes → Catalog and Product Views: routes to
frontend/src/App.jsx - Storefront Routes → Cart and Checkout: routes to
frontend/src/App.jsx - Storefront Routes → Customer Account and Orders: routes to
frontend/src/App.jsx - Storefront Routes → Search Interface: renders
frontend/src/App.jsx - Shop State and API → API Server: requests products and cart
frontend/src/context/ShopContext.jsx - Administrator → Admin Routes: uses
README.md - Admin Routes → Admin Login: renders
admin/src/App.jsx - Admin Routes → Product Management: routes to
admin/src/App.jsx - Admin Routes → Order Management: routes to
admin/src/App.jsx - Product Management → API Server: admin API calls
- Order Management → API Server: admin API calls
- API Server → MongoDB: connects
backend/server.js - API Server → Cloudinary Images: configures
backend/server.js - API Server → User Routes: mounts
backend/server.js - API Server → Product Routes: mounts
backend/server.js - API Server → Cart Routes: mounts
backend/server.js - API Server → Order Routes: mounts
backend/server.js - User Routes → Authentication Logic: dispatches
backend/routes/userRoute.js - Product Routes → Catalog Logic: dispatches
backend/routes/productRoute.js - Cart Routes → Cart Logic: dispatches
backend/routes/cartRoute.js - Order Routes → Order Logic: dispatches
backend/routes/orderRoute.js - Cart Routes → User Authorization: guards
backend/routes/cartRoute.js - Order Routes → User Authorization: guards
backend/routes/orderRoute.js - Order Routes → Admin Authorization: guards
backend/routes/orderRoute.js - Product Routes → Admin Authorization: guards
backend/routes/productRoute.js - Authentication Logic → User and Cart Records: reads and writes
backend/controllers/userController.js - Cart Logic → User and Cart Records: reads and updates
backend/controllers/cartController.js - Order Logic → Order Records: creates and queries
backend/controllers/orderController.js - Order Logic → User and Cart Records: clears cart
backend/controllers/orderController.js - Catalog Logic → Product Records: manages products
backend/controllers/productController.js - Catalog Logic → Cloudinary Images: uploads images
backend/controllers/productController.js