How tushank99/shopify-app works
This is an event-driven e-commerce storefront with personalized recommendations and an order ledger. Customers browse and authenticate in the React app, submit orders through the Node API, and receive asynchronously processed stock and recommendation work. Checkout also writes an outbox record atomically; a relay publishes it to Kafka for idempotent ledger ingestion and query. The README documents these service boundaries; several UI/API details and ML internals are represented at subsystem level because their implementation was not sampled.
Main entry points: db.js MongoDB · orderController.js Order checkout · index.js Express API · productController.js Catalog and recs
Components 22
Storefront
- React storefront
frontend/src/main.jsx - API client
frontend/src/redux/api - Checkout UI
frontend/src/pages/Orders
Commerce API
- Express API
backend/index.js - User accounts
backend/controllers/userController.js - Catalog and recs
backend/controllers/productController.js - Order checkout
backend/controllers/orderController.js - MongoDB
backend/config/db.js
Async Work
- Cache and queue
backend/config/redis.js - Stock worker
backend/queues/stockDecrementQueue.js - Recommendation queue
backend/queues/recommendationQueue.js - ML queue
backend/queues/mlRecommendationQueue.js - Transactional outbox
backend/outbox/orderOutbox.js - Outbox relay
backend/workers/outboxRelay.js - Kafka
Recommendations
- SVD inference
ml-backend/main.py
Order Ledger
- Order event consumer
ledger-service/src/main/java/com/shopify/ledger/kafka/OrderPlacedListener.java - Ledger ingestion
ledger-service/src/main/java/com/shopify/ledger/service/LedgerService.java - PostgreSQL ledger
ledger-service/src/main/java/com/shopify/ledger/repository/LedgerEntryRepository.java - Ledger queries
ledger-service/src/main/java/com/shopify/ledger/service/LedgerQueryService.java - Ledger API
ledger-service/src/main/java/com/shopify/ledger/api/LedgerController.java
Other components
- Shopper
Connections 27
- Shopper → React storefront: browses and checks out
frontend/src/main.jsx - React storefront → Checkout UI: routes to
frontend/src/main.jsx - React storefront → API client: uses API slices
- API client → Express API: calls
- Express API → User accounts: routes requests
backend/index.js - Express API → Catalog and recs: routes requests
backend/index.js - Express API → Order checkout: routes requests
backend/index.js - User accounts → MongoDB: reads and writes
- Catalog and recs → MongoDB: reads and writes
backend/controllers/productController.js - Order checkout → MongoDB: commits order
- Order checkout → Transactional outbox: writes atomically
backend/controllers/orderController.js - Order checkout → Stock worker: enqueues decrement
backend/controllers/orderController.js - Order checkout → ML queue: enqueues work
backend/controllers/orderController.js - Stock worker → MongoDB: updates stock
backend/queues/stockDecrementQueue.js - Stock worker → Cache and queue: uses connections
backend/queues/stockDecrementQueue.js - Recommendation queue → Cache and queue: uses connections
backend/queues/recommendationQueue.js - ML queue → Cache and queue: uses connections
backend/queues/mlRecommendationQueue.js - Catalog and recs → Cache and queue: reads recommendation cache
backend/controllers/productController.js - Catalog and recs → SVD inference: requests inference
backend/controllers/productController.js - Transactional outbox → MongoDB: stores with order
- Outbox relay → MongoDB: claims outbox rows
- Outbox relay → Kafka: publishes events
- Kafka → Order event consumer: delivers events
- Order event consumer → Ledger ingestion: dispatches ingestion
- Ledger ingestion → PostgreSQL ledger: inserts idempotently
ledger-service/src/main/java/com/shopify/ledger/service/LedgerService.java - Ledger API → Ledger queries: delegates queries
ledger-service/src/main/java/com/shopify/ledger/api/LedgerController.java - Ledger queries → PostgreSQL ledger: reads entries and items
ledger-service/src/main/java/com/shopify/ledger/service/LedgerQueryService.java