How 246vansh/fullstack-ecommerce-app works
This repository implements an online storefront and commerce backend. The customer journey spans catalog browsing, cart and checkout, payment, order tracking, and reviews; separate capabilities cover authentication, account management, notifications, and administration. The backend is organized around HTTP routes, controllers, domain services, and a MariaDB/Prisma store. The tree identifies broad frontend capabilities, but its runtime wiring was not sampled; the graph therefore focuses on source-supported backend relationships and marks the storefront entry as unverified.
Main entry points: orderService.js Order Management · db.js MariaDB Store · refundService.js Refunds · authService.js Authentication
Components 23
Storefront
- Storefront UI
frontend/src/pages - Frontend Services
frontend/src/services
HTTP API
- API Server
backend/server.js - Route Registry
backend/routes/index.js - Admin Routes
backend/routes/adminRoutes.js - Review Routes
backend/routes/reviewRoutes.js - Admin Catalog
backend/controllers/adminCatalogController.js - Review Controller
backend/controllers/reviewController.js - Auth Controller
backend/controllers/authController.js
Identity
- Authentication
backend/services/authService.js - Session Tokens
backend/services/refreshTokenService.js - JWT Utilities
backend/utils/jwt.js - Auth Middleware
backend/middleware/auth.js
Commerce Services
- Order Management
backend/services/orderService.js - Checkout
backend/services/checkoutService.js - Pricing
backend/services/pricingService.js - Coupons
backend/services/couponService.js - Payments
backend/services/paymentService.js - Refunds
backend/services/refundService.js - Product Reviews
backend/services/reviewService.js - Notifications
backend/services/notificationService.js
Persistence
- MariaDB Store
backend/config/db.js
Other components
- Shopper
Connections 28
- Shopper → Storefront UI: uses
- Storefront UI → Frontend Services: requests data
- Frontend Services → API Server: calls API
- API Server → Route Registry: mounts routes
backend/server.js - Route Registry → Admin Routes: registers
- Admin Routes → Admin Catalog: dispatches
backend/routes/adminRoutes.js - Admin Catalog → MariaDB Store: accesses
- Review Routes → Review Controller: dispatches
backend/routes/reviewRoutes.js - Review Controller → Product Reviews: delegates to
backend/controllers/reviewController.js - Product Reviews → MariaDB Store: reads and writes
backend/services/reviewService.js - Auth Controller → Authentication: delegates to
backend/controllers/authController.js - Authentication → Session Tokens: revokes sessions
backend/services/authService.js - Auth Controller → Session Tokens: manages tokens
backend/controllers/authController.js - Session Tokens → JWT Utilities: uses tokens
backend/services/refreshTokenService.js - Auth Middleware → JWT Utilities: verifies tokens
backend/middleware/auth.js - Auth Middleware → MariaDB Store: checks sessions
backend/middleware/auth.js - Order Management → Checkout: loads cart items
backend/services/orderService.js - Order Management → Coupons: claims coupons
backend/services/orderService.js - Order Management → Refunds: checks refund state
backend/services/orderService.js - Order Management → MariaDB Store: reads and writes
backend/services/orderService.js - Payments → Order Management: uses order service
backend/services/paymentService.js - Payments → Refunds: uses refund service
backend/services/paymentService.js - Refunds → Order Management: restores stock
backend/services/refundService.js - Refunds → Pricing: converts amounts
backend/services/refundService.js - Order Management → Pricing: prices orders
backend/services/orderService.js - Order Management → Notifications: uses notifications
backend/services/orderService.js - Coupons → Pricing: calculates discounts
backend/services/couponService.js - Authentication → MariaDB Store: accesses
backend/services/authService.js