How sidhantsingla0-gif/onecart works
oneCart is a MERN storefront with a separate admin dashboard. Shoppers authenticate, browse the catalog, manage a persistent cart, and place and review orders; administrators authenticate separately to add products, manage inventory, and review orders. The React applications use shared contexts for identity and shopping state, while an Express API routes requests through authorization to controllers and MongoDB models. The README documents the broad client/API/database flow; some connections below are limited to source-index references because not all implementation files were excerpted.
Main entry points: index.js Express API · src/App.jsx Storefront App · src/App.jsx Admin Dashboard · orderRoutes.js Order Routes
Components 30
Storefront
- Storefront App
frontend/src/App.jsx - User State
frontend/src/context/UserContext.jsx - Shop & Cart State
frontend/src/context/ShopContext.jsx - Catalog & Product Views
frontend/src/pages/Collections.jsx - Checkout & Orders
frontend/src/pages/PlaceOrder.jsx - Axios Client
frontend/src/config/axios.js
Admin Dashboard
- Admin Dashboard
admin/src/App.jsx - Product Management
admin/src/pages/Add.jsx - Order Management
admin/src/pages/Orders.jsx - Admin State
admin/src/context/AdminContext.jsx
Backend API
- Express API
backend/index.js - Auth & User Routes
backend/routes/authRoute.js - Product Routes
backend/routes/productRoute.js - Cart Routes
backend/routes/cartRoute.js - Order Routes
backend/routes/orderRoutes.js - Product Operations
backend/controller/productController.js - Cart Operations
backend/controller/cartController.js - Order Operations
backend/controller/orderController.js - User Lookup
backend/controller/userController.js - Razorpay Payments
backend/controller/orderController.js
Identity & Access
- Authentication Logic
backend/controller/authController.js - Access Checks
backend/middleware/isAuth.js - Admin Access
backend/middleware/adminAuth.js
Persistence & Media
- User Records
backend/model/userModel.js - Product Records
backend/model/productModel.js - Order Records
backend/model/orderModel.js - MongoDB
backend/config/db.js - Cloudinary
backend/config/cloudinary.js
Other components
- Shopper
- Administrator
Connections 37
- Shopper → Storefront App: uses
README.md - Storefront App → Catalog & Product Views: routes to
frontend/src/App.jsx - Storefront App → Checkout & Orders: routes to
frontend/src/App.jsx - Storefront App → User State: checks identity
frontend/src/App.jsx - Shop & Cart State → User State: reads identity
frontend/src/context/ShopContext.jsx - Shop & Cart State → Axios Client: requests API
frontend/src/context/ShopContext.jsx - User State → Axios Client: requests API
frontend/src/context/UserContext.jsx - Checkout & Orders → Shop & Cart State: reads cart state
frontend/src/pages/PlaceOrder.jsx - Checkout & Orders → Axios Client: submits order
frontend/src/pages/PlaceOrder.jsx - Axios Client → Express API: calls REST API
README.md - Administrator → Admin Dashboard: uses
README.md - Admin Dashboard → Product Management: routes to
admin/src/App.jsx - Admin Dashboard → Order Management: routes to
admin/src/App.jsx - Admin Dashboard → Admin State: checks access
admin/src/App.jsx - Admin State → Express API: fetches admin
admin/src/context/AdminContext.jsx - Express API → Auth & User Routes: mounts routes
backend/index.js - Express API → Product Routes: mounts routes
backend/index.js - Express API → Cart Routes: mounts routes
backend/index.js - Express API → Order Routes: mounts routes
backend/index.js - Auth & User Routes → Authentication Logic: dispatches to
backend/routes/authRoute.js - Authentication Logic → User Records: reads/writes
backend/controller/authController.js - Authentication Logic → Access Checks: issues JWT
- Cart Routes → Access Checks: guards requests
backend/routes/cartRoute.js - Cart Routes → Cart Operations: dispatches to
backend/routes/cartRoute.js - Cart Operations → User Records: reads/writes
backend/controller/cartController.js - Order Routes → Access Checks: guards user routes
backend/routes/orderRoutes.js - Order Routes → Admin Access: guards admin routes
backend/routes/orderRoutes.js - Order Routes → Order Operations: dispatches to
backend/routes/orderRoutes.js - Order Operations → Order Records: reads/writes
backend/controller/orderController.js - Order Operations → User Records: reads/writes
backend/controller/orderController.js - Order Operations → Razorpay Payments: handles payment
backend/controller/orderController.js - Product Routes → Admin Access: guards changes
backend/routes/productRoute.js - Product Routes → Product Operations: dispatches to
backend/routes/productRoute.js - Product Operations → Product Records: reads/writes
backend/controller/productController.js - Product Operations → Cloudinary: uploads images
backend/controller/productController.js - User Lookup → User Records: reads user
backend/controller/userController.js - Express API → MongoDB: connects database
backend/index.js