How jame2026/retailer-system-dropshipping works
This is a Shopify dropshipping operations platform: administrators monitor orders, manage supplier SKU mappings and pricing, and submit sourcing requests; Shopify order events enter the backend, are held for safety checks, mapped and dispatched to CJ or Zendrop, then tracking is synchronized back to Shopify. The graph includes the documented dashboard capabilities and background billing/retry work. Some frontend wiring and background-job implementation were not sampled, so uncertain connections are omitted or marked unverified.
Main entry points: order.service.ts Order lifecycle · fulfillment.service.ts Fulfillment sync · shopify.routes.ts Shopify webhook routes · order.controller.ts Order endpoints
Components 34
Admin dashboard
- Dashboard application
client/src/App.tsx - Operations dashboard
client/src/pages/DashboardPage.tsx - Order management
client/src/pages/OrdersPage.tsx - Order inspection
client/src/pages/OrderDetailPage.tsx - Catalog mappings
client/src/pages/CatalogPage.tsx - Pricing rules
client/src/pages/PricingRulesPage.tsx - Product sourcing
client/src/pages/SourcingPage.tsx - Order data hook
client/src/hooks/useOrders.ts - Order API client
client/src/services/orderService.ts
API and webhooks
- Express API
server/app.ts - Shopify webhook routes
server/routes/webhooks/shopify.routes.ts - Webhook signature check
server/middleware/verifyShopifyHmac.ts - Webhook processing
server/controllers/webhook.controller.ts - Admin API routes
server/routes/api/order.routes.ts - Admin authentication
server/middleware/authAdmin.ts - Order endpoints
server/controllers/order.controller.ts - Catalog routes
server/routes/api/catalog.routes.ts - Sourcing routes
server/routes/api/sourcing.routes.ts
Order operations
- Order lifecycle
server/services/order.service.ts - Address normalization
server/utils/addressNormalizer.ts - PostgreSQL database
server/database/client.ts - Six-hour hold worker
server/jobs/holdBuffer.worker.ts - Billing retry job
server/jobs/retryBilling.job.ts - Tracking sync job
server/jobs/trackingSync.job.ts - Fulfillment sync
server/services/fulfillment.service.ts
Catalog and sourcing
- Supplier SKU mapping
server/services/mapping.service.ts - Dynamic pricing
server/services/pricing.service.ts - Catalog endpoints
server/controllers/catalog.controller.ts - Sourcing endpoints
server/controllers/sourcing.controller.ts
Supplier and store integrations
- Shopify
- CJ product sourcing
server/integrations/cj/cj.sourcing.ts - CJ order integration
server/integrations/cj/cj.order.ts - Zendrop integration
server/integrations/zendrop/zendrop.client.ts
Other components
- Administrator
Connections 28
- Administrator → Dashboard application: uses
- Shopify → Shopify webhook routes: sends events
README.md - Express API → Shopify webhook routes: mounts routes
server/app.ts - Shopify webhook routes → Webhook signature check: verifies requests
server/routes/webhooks/shopify.routes.ts - Shopify webhook routes → Webhook processing: routes events
server/routes/webhooks/shopify.routes.ts - Webhook processing → Order lifecycle: handles orders
server/controllers/webhook.controller.ts - Admin API routes → Admin authentication: protects endpoints
server/routes/api/order.routes.ts - Admin API routes → Order endpoints: routes requests
server/routes/api/order.routes.ts - Order endpoints → Order lifecycle: invokes operations
server/controllers/order.controller.ts - Order endpoints → PostgreSQL database: reads order detail
server/controllers/order.controller.ts - Order lifecycle → PostgreSQL database: reads and writes
server/services/order.service.ts - Order lifecycle → Address normalization: normalizes address
server/services/order.service.ts - Order lifecycle → Supplier SKU mapping: resolves SKUs
server/services/order.service.ts - Order lifecycle → CJ order integration: dispatches orders
server/services/order.service.ts - Order lifecycle → Zendrop integration: fallback dispatch
server/services/order.service.ts - Catalog routes → Catalog endpoints: routes requests
server/routes/api/catalog.routes.ts - Catalog endpoints → Supplier SKU mapping: manages mappings
server/controllers/catalog.controller.ts - Catalog endpoints → Dynamic pricing: calculates prices
server/controllers/catalog.controller.ts - Supplier SKU mapping → Dynamic pricing: calculates selling price
server/services/mapping.service.ts - Sourcing routes → Sourcing endpoints: routes requests
server/routes/api/sourcing.routes.ts - Sourcing endpoints → CJ product sourcing: searches and submits
server/controllers/sourcing.controller.ts - Six-hour hold worker → Order lifecycle: processes held orders
server/jobs/holdBuffer.worker.ts - Fulfillment sync → PostgreSQL database: reads and updates
server/services/fulfillment.service.ts - Fulfillment sync → CJ order integration: fetches tracking
server/services/fulfillment.service.ts - Fulfillment sync → Zendrop integration: fetches tracking
server/services/fulfillment.service.ts - Fulfillment sync → Shopify: pushes fulfillment
server/services/fulfillment.service.ts - Order data hook → Order API client: calls
client/src/hooks/useOrders.ts - Order API client → Express API: requests API