How bala177/retailx works
RetailX is a multi-tenant commerce platform with a customer storefront, store-admin panel, and Express API. The main customer journey selects a store, browses products or services, manages a cart, checks out, and reaches order confirmation; service stores also expose booking-oriented experiences. Store staff manage catalog and operations, while platform owners manage tenants and users. The API resolves tenant context and handles commerce and administration requests against MongoDB-backed models. Several backend handlers and pages were not sampled, so those subsystem links reflect documented capabilities and routing, not inspection of their implementations.
Main entry points: src/App.jsx Store routes · storeRoutes.js Store endpoints · api.js Store API client · src/App.jsx Admin routes
Components 26
Customer storefront
- Store routes
storefront/src/App.jsx - Store selection
storefront/src/context/StoreContext.jsx - Store API client
storefront/src/services/api.js - Browse catalog
storefront/src/pages/Products.jsx - Service storefront
storefront/src/pages/ServiceHome.jsx - Cart state
storefront/src/context/CartContext.jsx - Checkout
storefront/src/pages/Checkout.jsx - Order confirmation
storefront/src/pages/OrderConfirmation.jsx
Store administration
- Admin routes
admin/src/App.jsx - Admin identity
admin/src/context/AuthContext.jsx - Tenant workspace
admin/src/context/TenantContext.jsx - Admin API client
admin/src/services/api.js - Store operations
admin/src/pages/Orders.jsx - Platform management
admin/src/pages/SuperAdminStores.jsx
Backend API
- HTTP application
backend/src/app.js - Store endpoints
backend/src/routes/storeRoutes.js - Platform endpoints
backend/src/routes/platformRoutes.js - Commerce handlers
backend/src/controllers/productController.js - Review handling
backend/src/controllers/reviewController.js - Platform handlers
backend/src/controllers/superAdminController.js - Tenant resolution
backend/src/middleware/tenant.js - Authentication
backend/src/controllers/authController.js
Tenant data
- MongoDB connection
backend/src/config/database.js - Commerce models
backend/src/models
Other components
- Shopper
- MongoDB
Connections 30
- Shopper → Store routes: uses
storefront/src/App.jsx - Store routes → Store selection: checks store
storefront/src/App.jsx - Store selection → Store API client: loads store
storefront/src/context/StoreContext.jsx - Store routes → Browse catalog: routes to
storefront/src/App.jsx - Store routes → Service storefront: routes to
storefront/src/App.jsx - Browse catalog → Store API client: requests catalog
storefront/src/services/api.js - Store routes → Cart state: routes to
storefront/src/App.jsx - Store routes → Checkout: routes to
storefront/src/App.jsx - Store routes → Order confirmation: routes to
storefront/src/App.jsx - Checkout → Store API client: submits order
- Store API client → Store endpoints: calls API
- Admin routes → Admin identity: guards routes
admin/src/App.jsx - Admin routes → Tenant workspace: selects tenant
admin/src/App.jsx - Tenant workspace → Admin API client: loads tenant
admin/src/context/TenantContext.jsx - Admin routes → Store operations: routes to
admin/src/App.jsx - Admin routes → Platform management: routes to
admin/src/App.jsx - HTTP application → Store endpoints: mounts routes
backend/src/app.js - Store endpoints → Commerce handlers: routes requests
backend/src/routes/storeRoutes.js - Store endpoints → Review handling: routes reviews
backend/src/routes/storeRoutes.js - HTTP application → Platform endpoints: mounts routes
- Platform endpoints → Platform handlers: routes requests
- Commerce handlers → Commerce models: queries products
backend/src/controllers/productController.js - Review handling → Commerce models: queries reviews
backend/src/controllers/reviewController.js - Platform handlers → Commerce models: queries tenants
backend/src/controllers/superAdminController.js - Store endpoints → Tenant resolution: resolves tenant
- Admin identity → Admin API client: auth requests
admin/src/context/AuthContext.jsx - MongoDB connection → MongoDB: connects
backend/src/config/database.js - Commerce models → MongoDB: persists records
- Store API client → HTTP application: sends requests
- Admin API client → HTTP application: sends requests