How sathvik145/order-fulfillment-platform works
This repository implements a Spring-based commerce backend split across catalog, order, inventory, and notification services. The main workflow creates an order, looks up product details, persists the order, and publishes an order-created event; inventory reservation and notification are event-driven branches. Inventory also supports direct stock updates and records reservation outcomes through an outbox. Source excerpts establish the core order, catalog, and inventory service calls, but do not show Kafka publisher/consumer wiring in every service, so those links are marked unverified or omitted.
Main entry points: OrderService.java Order service · InventoryService.java Inventory service · ProductController.java Product API · InventoryOutboxPublisher.java Outbox publisher
Components 20
Product catalog
- Product API
services/catalog-service/src/main/java/com/sathvik/catalogservice/controller/ProductController.java - Product service
services/catalog-service/src/main/java/com/sathvik/catalogservice/service/ProductService.java - Product repository
services/catalog-service/src/main/java/com/sathvik/catalogservice/repository/ProductRepository.java
Order processing
- Order API
services/order-service/src/main/java/com/sathvik/orderservice/controller/OrderController.java - Order service
services/order-service/src/main/java/com/sathvik/orderservice/service/OrderService.java - Catalog client
services/order-service/src/main/java/com/sathvik/orderservice/client/CatalogClient.java - Order repository
services/order-service/src/main/java/com/sathvik/orderservice/repository/OrderRepository.java - Order event producer
services/order-service/src/main/java/com/sathvik/orderservice/producer/OrderEventProducer.java - Inventory event consumer
services/order-service/src/main/java/com/sathvik/orderservice/consumer/InventoryEventConsumer.java
Stock management
- Inventory API
services/inventory-service/src/main/java/com/sathvik/inventoryservice/controller/InventoryController.java - Inventory service
services/inventory-service/src/main/java/com/sathvik/inventoryservice/service/InventoryService.java - Inventory repository
services/inventory-service/src/main/java/com/sathvik/inventoryservice/repository/InventoryRepository.java - Processed events
services/inventory-service/src/main/java/com/sathvik/inventoryservice/repository/ProcessedEventRepository.java - Inventory outbox
services/inventory-service/src/main/java/com/sathvik/inventoryservice/repository/InventoryOutboxRepository.java - Outbox publisher
services/inventory-service/src/main/java/com/sathvik/inventoryservice/outbox/InventoryOutboxPublisher.java - Inventory event producer
services/inventory-service/src/main/java/com/sathvik/inventoryservice/producer/InventoryEventProducer.java
Notifications
- Order notification consumer
services/notification-service/src/main/java/com/sathvik/notificationservice/consumer/OrderCreatedConsumer.java
Other components
- API caller
- Kafka broker
- Catalog service endpoint
Connections 23
- API caller → Order API: submits orders
services/order-service/src/main/java/com/sathvik/orderservice/controller/OrderController.java - Order API → Order service: delegates requests
services/order-service/src/main/java/com/sathvik/orderservice/controller/OrderController.java - Order service → Catalog client: fetches products
services/order-service/src/main/java/com/sathvik/orderservice/service/OrderService.java - Catalog client → Catalog service endpoint: requests product
services/order-service/src/main/java/com/sathvik/orderservice/client/CatalogClient.java - Catalog service endpoint → Product API: routes to API
- API caller → Product API: manages products
services/catalog-service/src/main/java/com/sathvik/catalogservice/controller/ProductController.java - Product API → Product service: delegates requests
services/catalog-service/src/main/java/com/sathvik/catalogservice/controller/ProductController.java - Product service → Product repository: reads and saves
services/catalog-service/src/main/java/com/sathvik/catalogservice/service/ProductService.java - Order service → Order repository: saves and reads
services/order-service/src/main/java/com/sathvik/orderservice/service/OrderService.java - Order service → Order event producer: publishes order event
services/order-service/src/main/java/com/sathvik/orderservice/service/OrderService.java - Order event producer → Kafka broker: sends events
- Kafka broker → Inventory event consumer: delivers inventory events
- Inventory event consumer → Order service: updates order status
- API caller → Inventory API: updates stock
services/inventory-service/src/main/java/com/sathvik/inventoryservice/controller/InventoryController.java - Inventory API → Inventory service: updates stock
services/inventory-service/src/main/java/com/sathvik/inventoryservice/controller/InventoryController.java - Kafka broker → Inventory service: delivers order events
- Inventory service → Inventory repository: reads and saves
services/inventory-service/src/main/java/com/sathvik/inventoryservice/service/InventoryService.java - Inventory service → Processed events: checks and records
services/inventory-service/src/main/java/com/sathvik/inventoryservice/service/InventoryService.java - Inventory service → Inventory outbox: writes outcomes
services/inventory-service/src/main/java/com/sathvik/inventoryservice/service/InventoryService.java - Outbox publisher → Inventory outbox: reads pending events
- Outbox publisher → Inventory event producer: dispatches events
- Inventory event producer → Kafka broker: sends outcomes
- Kafka broker → Order notification consumer: delivers order events
services/notification-service/src/main/java/com/sathvik/notificationservice/consumer/OrderCreatedConsumer.java