How trupsm/e-commerce-website- works
Vyoma is a MERN storefront supporting account and address management, product discovery, guest-to-account cart synchronization, and transactional checkout with Stripe payments and order tracking. The primary journey runs from browsing products through cart and checkout to order history/details; admins also manage catalog and order status. Edges reflect the supplied README, source excerpts, or SOURCE INDEX references; unsampled frontend pages and integrations are represented at their listed paths, but their internal calls are not inferred.
Main entry points: App.jsx SPA Routing · server.js Express API · orderController.js Order Logic · axiosInstance.js REST Transport
Components 34
Storefront
- SPA Routing
frontend/src/App.jsx - Account Pages
frontend/src/pages - Catalog Pages
frontend/src/pages/Products.jsx - Product Views
frontend/src/components/product - Cart Page
frontend/src/pages/Cart.jsx - Checkout
frontend/src/pages/Checkout.jsx - Stripe Form
frontend/src/components/payment/StripeCheckoutForm.jsx - Order Pages
frontend/src/pages/OrderHistory.jsx - Auth State
frontend/src/context/AuthContext.jsx - Cart State
frontend/src/context/CartContext.jsx - Auth Client
frontend/src/api/authApi.js - Cart Client
frontend/src/api/cartApi.js - Order Client
frontend/src/api/orderApi.js - Product Client
frontend/src/api/productApi.js - REST Transport
frontend/src/api/axiosInstance.js
Commerce API
- Express API
backend/server.js - Auth Routes
backend/routes/authRoutes.js - Catalog Routes
backend/routes/productRoutes.js - Cart Routes
backend/routes/cartRoutes.js - Order Routes
backend/routes/orderRoutes.js - Payment Routes
backend/routes/paymentRoutes.js - JWT Authentication
backend/middleware/authMiddleware.js - Role Access
backend/middleware/roleMiddleware.js
Commerce Domain
- Account Logic
backend/controllers/authController.js - Cart Logic
backend/controllers/cartController.js - Catalog Logic
backend/controllers/productController.js - Category Logic
backend/controllers/categoryController.js - Order Logic
backend/controllers/orderController.js - Payment Webhook
backend/controllers/paymentController.js
Data and Payments
- Users
backend/models/User.js - Products
backend/models/Product.js - Categories
backend/models/Category.js - Carts
backend/models/Cart.js
Other components
- Shopper
Connections 48
- Shopper → SPA Routing: uses
frontend/src/App.jsx - SPA Routing → Auth State: provides session
frontend/src/App.jsx - SPA Routing → Cart State: provides cart
frontend/src/App.jsx - SPA Routing → Account Pages: routes
frontend/src/App.jsx - SPA Routing → Catalog Pages: routes
frontend/src/App.jsx - SPA Routing → Cart Page: routes
frontend/src/App.jsx - SPA Routing → Checkout: routes
frontend/src/App.jsx - SPA Routing → Order Pages: routes
frontend/src/App.jsx - Catalog Pages → Product Views: renders
- Auth State → Auth Client: calls
frontend/src/context/AuthContext.jsx - Cart State → Cart Client: calls
frontend/src/context/CartContext.jsx - Cart Page → Cart State: uses
frontend/src/pages/Cart.jsx - Checkout → Order Client: calls
frontend/src/pages/Checkout.jsx - Checkout → Stripe Form: renders
frontend/src/pages/Checkout.jsx - Auth Client → REST Transport: uses
frontend/src/api/authApi.js - Cart Client → REST Transport: uses
frontend/src/api/cartApi.js - Order Client → REST Transport: uses
- Product Client → REST Transport: uses
- REST Transport → Express API: REST requests
- Express API → Auth Routes: mounts
backend/server.js - Express API → Catalog Routes: mounts
backend/server.js - Express API → Cart Routes: mounts
backend/server.js - Express API → Order Routes: mounts
backend/server.js - Express API → Payment Routes: mounts
backend/server.js - Auth Routes → Account Logic: routes to
backend/routes/authRoutes.js - Catalog Routes → Catalog Logic: routes to
backend/routes/productRoutes.js - Cart Routes → Cart Logic: routes to
backend/routes/cartRoutes.js - Order Routes → Order Logic: routes to
backend/routes/orderRoutes.js - Payment Routes → Payment Webhook: routes to
backend/routes/paymentRoutes.js - Auth Routes → JWT Authentication: guards
backend/routes/authRoutes.js - Cart Routes → JWT Authentication: guards
backend/routes/cartRoutes.js - Order Routes → JWT Authentication: guards
backend/routes/orderRoutes.js - Catalog Routes → JWT Authentication: guards admin
backend/routes/productRoutes.js - Catalog Routes → Role Access: checks role
backend/routes/productRoutes.js - Account Logic → Users: reads/writes
backend/controllers/authController.js - JWT Authentication → Users: loads user
backend/middleware/authMiddleware.js - Cart Logic → Carts: reads/writes
backend/controllers/cartController.js - Cart Logic → Products: checks stock
backend/controllers/cartController.js - Catalog Logic → Products: manages
backend/controllers/productController.js - Catalog Logic → Categories: queries
backend/controllers/productController.js - Category Logic → Categories: manages
backend/controllers/categoryController.js - Order Logic → Carts: loads cart
backend/controllers/orderController.js - Order Logic → Products: validates and updates
backend/controllers/orderController.js - Order Logic → Carts: clears cart
backend/controllers/orderController.js - Order Logic → Payment Webhook: payment lifecycle
- Order Logic → Payment Routes: creates intent
- Payment Webhook → Products: updates stock
backend/controllers/paymentController.js - Payment Webhook → Carts: updates cart
backend/controllers/paymentController.js