How vaibhavgobre08/distrubuted-ecommerce works
OrderFlow is a distributed e-commerce backend. A client request reaches the API Gateway and Order Service, which records a pending order and an outbox event; Kafka carries the event to the Saga Orchestrator, which coordinates inventory, payment, and shipping. Order confirmation or cancellation then drives lifecycle updates and notifications. Authentication issues JWTs that the gateway validates. README documents the broader event flow; source excerpts and the index support selected internal calls, but unsampled Kafka wiring is represented only where the README documents it.
Main entry points: OrderEventConsumer.java Saga orchestrator · OrderService.java Order lifecycle · ApiGatewayApplication.java API Gateway · InventoryService.java Inventory and reservations
Components 17
Access and identity
- API Gateway
api-gateway/src/main/java/com/ecommerce/gateway/ApiGatewayApplication.java - Authentication
auth-service/src/main/java/com/ecommerce/auth_service/controller/AuthController.java - JWT issuance
auth-service/src/main/java/com/ecommerce/auth_service/security/JwtService.java
Order lifecycle
- Order API
order-service/src/main/java/com/ecommerce/order/controller/OrderController.java - Order lifecycle
order-service/src/main/java/com/ecommerce/order/service/OrderService.java - Order database
order-service/src/main/java/com/ecommerce/order/repository/OrderRepository.java - Transactional outbox
order-service/src/main/java/com/ecommerce/order/entity/OutboxEvent.java - Outbox publisher
order-service/src/main/java/com/ecommerce/order/outbox/OutboxEventPublisher.java
Saga coordination
- Saga orchestrator
saga-orchestrator/src/main/java/com/ecommerce/saga/consumer/OrderEventConsumer.java
Fulfillment services
- Inventory and reservations
inventory-service/src/main/java/com/ecommerce/inventory/service/InventoryService.java - Inventory database
inventory-service/src/main/java/com/ecommerce/inventory/repository/ProductRepository.java - Payment processing
payment-service/src/main/java/com/ecommerce/payment/service/PaymentService.java - Shipping management
shipping-service/src/main/java/com/ecommerce/shipping/service/ShippingService.java
Events and notifications
- Kafka
- Order notifications
notification-service/src/main/java/com/ecommerce/notification/service/NotificationService.java - Notification database
notification-service/src/main/java/com/ecommerce/notification/repository/NotificationRepository.java
Other components
- Client
Connections 22
- Client → API Gateway: sends requests
- API Gateway → Order API: routes orders
- Client → Authentication: registers or logs in
- Authentication → JWT issuance: issues token
- API Gateway → JWT issuance: validates token
- Order API → Order lifecycle: delegates
order-service/src/main/java/com/ecommerce/order/controller/OrderController.java - Order lifecycle → Order database: saves order
order-service/src/main/java/com/ecommerce/order/service/OrderService.java - Order lifecycle → Transactional outbox: records event
order-service/src/main/java/com/ecommerce/order/service/OrderService.java - Outbox publisher → Kafka: publishes event
- Transactional outbox → Outbox publisher: supplies pending events
- Kafka → Saga orchestrator: delivers order event
- Saga orchestrator → Inventory and reservations: requests reservation
- Inventory and reservations → Inventory database: reads and updates stock
inventory-service/src/main/java/com/ecommerce/inventory/service/InventoryService.java - Inventory and reservations → Kafka: reports reservation
- Saga orchestrator → Payment processing: requests payment
- Payment processing → Kafka: reports payment result
- Saga orchestrator → Shipping management: requests shipment
- Shipping management → Kafka: reports shipment
- Saga orchestrator → Kafka: publishes order outcome
- Kafka → Order lifecycle: signals confirmation or cancellation
- Kafka → Order notifications: delivers order outcome
- Order notifications → Notification database: saves notification
notification-service/src/main/java/com/ecommerce/notification/service/NotificationService.java