How viet7801/microservices works
This repository implements an order-processing microservice system with inventory reservation, payment handling, and saga coordination. The principal evidenced path begins with an order request, persists a pending order and saga state, then writes an inventory command to an outbox; listeners and result handling provide the asynchronous service stages. Inventory and payment also expose HTTP controllers. The tree includes a gateway, Eureka, and shared Kafka/outbox infrastructure, but their runtime wiring is only partly visible; dashed edges mark unverified message-broker links.
Main entry points: OrderService.java Order service · KafkaConfig.java Kafka topics · InventoryListener.java Inventory listener · PaymentListener.java Payment listener
Components 20
Ingress and discovery
- API gateway
gateway-service/src/main/java/microservice/gatewayservice/controller/GatewayController.java - Service discovery
eureka-server/src/main/java/microservice/eurekaserver/EurekaServerApplication.java
Order coordination
- Order API
order-service/src/main/java/microservice/orderservice/controller/OrderController.java - Order service
order-service/src/main/java/microservice/orderservice/service/OrderService.java - Saga handler
order-service/src/main/java/microservice/orderservice/service/OrderSaga.java - Result listener
order-service/src/main/java/microservice/orderservice/messaging/OrderResultListener.java - Order storage
order-service/src/main/java/microservice/orderservice/repository/OrderRepository.java - Saga storage
order-service/src/main/java/microservice/orderservice/repository/SagaRepository.java
Inventory and payment
- Inventory API
inventory-service/src/main/java/microservice/inventoryservice/controller/InventoryController.java - Stock reservation
inventory-service/src/main/java/microservice/inventoryservice/service/InventoryService.java - Inventory storage
inventory-service/src/main/java/microservice/inventoryservice/repository/InventoryRepository.java - Inventory listener
inventory-service/src/main/java/microservice/inventoryservice/messaging/InventoryListener.java - Payment API
payment-service/src/main/java/microservice/paymentservice/controller/PaymentController.java - Payment processing
payment-service/src/main/java/microservice/paymentservice/service/PaymentService.java - Payment listener
payment-service/src/main/java/microservice/paymentservice/messaging/PaymentListener.java - Payment storage
payment-service/src/main/java/microservice/paymentservice/repository/PaymentRepository.java
Messaging infrastructure
- Transactional outbox
messaging/src/main/java/microservice/messaging/outbox/Outbox.java - Outbox publisher
messaging/src/main/java/microservice/messaging/outbox/OutboxPublisher.java - Kafka topics
messaging/src/main/java/microservice/messaging/config/KafkaConfig.java
Other components
- API client
Connections 20
- API client → API gateway: sends requests
- API gateway → Order API: routes requests
- Order API → Order service: calls
order-service/src/main/java/microservice/orderservice/controller/OrderController.java - Order service → Order storage: saves orders
order-service/src/main/java/microservice/orderservice/service/OrderService.java - Order service → Saga storage: starts saga
order-service/src/main/java/microservice/orderservice/service/OrderService.java - Order service → Transactional outbox: writes command
order-service/src/main/java/microservice/orderservice/service/OrderService.java - Order service → Kafka topics: publishes via outbox
- Kafka topics → Inventory listener: delivers command
- Inventory listener → Stock reservation: calls
inventory-service/src/main/java/microservice/inventoryservice/messaging/InventoryListener.java - Inventory API → Stock reservation: calls
inventory-service/src/main/java/microservice/inventoryservice/controller/InventoryController.java - Stock reservation → Inventory storage: reads and writes
inventory-service/src/main/java/microservice/inventoryservice/service/InventoryService.java - Inventory listener → Transactional outbox: writes result
inventory-service/src/main/java/microservice/inventoryservice/messaging/InventoryListener.java - Kafka topics → Payment listener: delivers command
- Payment listener → Payment processing: calls
payment-service/src/main/java/microservice/paymentservice/messaging/PaymentListener.java - Payment API → Payment processing: calls
payment-service/src/main/java/microservice/paymentservice/controller/PaymentController.java - Payment processing → Payment storage: persists payment
payment-service/src/main/java/microservice/paymentservice/service/PaymentService.java - Payment listener → Transactional outbox: writes result
payment-service/src/main/java/microservice/paymentservice/messaging/PaymentListener.java - Kafka topics → Result listener: delivers result
- Result listener → Saga handler: handles result
order-service/src/main/java/microservice/orderservice/messaging/OrderResultListener.java - Outbox publisher → Kafka topics: publishes messages