How vinodarokiarajv/demart works
DeMart is an e-commerce application with an Express API and browser frontend. The main customer workflow is account access, product discovery, order creation with stock reservation and address geocoding, then Stripe payment and delivery tracking; administrators also manage orders and users. The graph includes AI assistance, location/store capabilities, and persistence as distinct supporting branches. Several controller and service implementations are not excerpted, so their connections are included only where the SOURCE INDEX or shown code supports them.
Main entry points: server.js API server · paymentService.js Stripe payments · orderService.js Order management · db.js PostgreSQL
Components 28
API and access
- API server
backend/src/server.js - Auth routes
backend/src/routes/authRoutes.js - Authentication
backend/src/middleware/authMiddleware.js - Admin authorization
backend/src/middleware/adminMiddleware.js - Browser storefront
frontend/js/app.js - Admin screens
frontend/js/admin-orders.js
Shopping and orders
- Product catalog
backend/src/services/productService.js - Product API
backend/src/controllers/productController.js - Order management
backend/src/services/orderService.js - Order API
backend/src/controllers/orderController.js - Stock reservations
backend/src/repositories/inventoryReservationRepository.js - Order records
backend/src/repositories/orderRepository.js
Payments and delivery
- Payment API
backend/src/controllers/paymentController.js - Stripe payments
backend/src/services/paymentService.js - Payment records
backend/src/repositories/paymentRepository.js - Delivery tracking
backend/src/services/deliveryTrackingService.js - Delivery records
backend/src/repositories/deliveryRepository.js - Tracking records
backend/src/repositories/deliveryTrackingRepository.js
Accounts and location
- Account service
backend/src/services/authService.js - Account API
backend/src/controllers/authController.js - Location service
backend/src/services/locationService.js - Address geocoding
backend/src/services/geocodingService.js - Geoapify
backend/src/providers/geoapifyProvider.js
Assistance and data
- AI responses
backend/src/services/aiService.js - AI assistant API
backend/src/controllers/aiController.js - PostgreSQL
backend/src/db/db.js
Other components
- Customer
- Administrator
Connections 38
- Customer → Browser storefront: uses
- Administrator → Admin screens: uses
- Browser storefront → API server: requests
- Admin screens → API server: requests
- API server → Auth routes: mounts
backend/src/server.js - API server → Product API: mounts
backend/src/server.js - API server → Order API: mounts
backend/src/server.js - API server → Payment API: mounts
backend/src/server.js - API server → AI assistant API: mounts
backend/src/server.js - Auth routes → Account API: routes to
backend/src/routes/authRoutes.js - Auth routes → Authentication: protects
backend/src/routes/authRoutes.js - Product API → Product catalog: calls
backend/src/controllers/productController.js - Order API → Order management: calls
- Payment API → Stripe payments: calls
backend/src/controllers/paymentController.js - AI assistant API → AI responses: requests
backend/src/controllers/aiController.js - AI assistant API → Product catalog: queries
backend/src/controllers/aiController.js - AI assistant API → Order management: queries
backend/src/controllers/aiController.js - AI assistant API → Delivery tracking: queries
backend/src/controllers/aiController.js - Account API → Account service: calls
backend/src/controllers/authController.js - Account API → Location service: validates location
backend/src/controllers/authController.js - Account API → Address geocoding: geocodes address
backend/src/controllers/authController.js - Order management → Order records: reads and writes
backend/src/services/orderService.js - Order management → Stock reservations: reserves stock
backend/src/services/orderService.js - Order management → Address geocoding: geocodes address
backend/src/services/orderService.js - Stripe payments → Payment records: updates
backend/src/services/paymentService.js - Stripe payments → Order records: updates status
backend/src/services/paymentService.js - Stripe payments → Delivery records: creates delivery
backend/src/services/paymentService.js - Stripe payments → Stock reservations: uses reservations
backend/src/services/paymentService.js - Payment API → Payment records: records webhook
backend/src/controllers/paymentController.js - Delivery tracking → Delivery records: reads
backend/src/services/deliveryTrackingService.js - Delivery tracking → Tracking records: reads and writes
backend/src/services/deliveryTrackingService.js - Location service → PostgreSQL: persists via
- Address geocoding → Geoapify: delegates
backend/src/services/geocodingService.js - Geoapify → PostgreSQL: configured via
- Account service → PostgreSQL: queries
backend/src/services/authService.js - Authentication → PostgreSQL: checks account
backend/src/middleware/authMiddleware.js - Order management → PostgreSQL: transacts via
backend/src/services/orderService.js - Stripe payments → PostgreSQL: transacts via
backend/src/services/paymentService.js