# viet7801/microservices architecture

> Architecture diagram of the GitHub repository viet7801/microservices, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/viet7801/microservices
- Repository: https://github.com/viet7801/microservices

## Overview

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: [`order-service/src/main/java/microservice/orderservice/service/OrderService.java`](https://github.com/viet7801/microservices/blob/main/order-service/src/main/java/microservice/orderservice/service/OrderService.java) (Order service), [`messaging/src/main/java/microservice/messaging/config/KafkaConfig.java`](https://github.com/viet7801/microservices/blob/main/messaging/src/main/java/microservice/messaging/config/KafkaConfig.java) (Kafka topics), [`inventory-service/src/main/java/microservice/inventoryservice/messaging/InventoryListener.java`](https://github.com/viet7801/microservices/blob/main/inventory-service/src/main/java/microservice/inventoryservice/messaging/InventoryListener.java) (Inventory listener), [`payment-service/src/main/java/microservice/paymentservice/messaging/PaymentListener.java`](https://github.com/viet7801/microservices/blob/main/payment-service/src/main/java/microservice/paymentservice/messaging/PaymentListener.java) (Payment listener)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Ingress and discovery"]
  node_gateway["API gateway"]
  node_eureka["Service discovery"]
end

subgraph group_order["Order coordination"]
  node_order_api["Order API"]
  node_order_service["Order service<br/>[OrderService.java]"]
  node_order_saga["Saga handler<br/>[OrderSaga.java]"]
  node_order_result["Result listener"]
  node_order_store[("Order storage")]
  node_saga_store[("Saga storage")]
end

subgraph group_fulfillment["Inventory and payment"]
  node_inventory_api["Inventory API"]
  node_inventory_service["Stock reservation"]
  node_inventory_store[("Inventory storage")]
  node_inventory_listener["Inventory listener"]
  node_payment_api["Payment API"]
  node_payment_service["Payment processing"]
  node_payment_listener["Payment listener"]
  node_payment_store[("Payment storage")]
end

subgraph group_messaging["Messaging infrastructure"]
  node_outbox[("Transactional outbox<br/>[Outbox.java]")]
  node_publisher["Outbox publisher"]
  node_kafka["Kafka topics<br/>[KafkaConfig.java]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_gateway
node_gateway -.->|"routes requests"| node_order_api
node_order_api -->|"calls"| node_order_service
node_order_service -->|"saves orders"| node_order_store
node_order_service -->|"starts saga"| node_saga_store
node_order_service -->|"writes command"| node_outbox
node_order_service -.->|"publishes via outbox"| node_kafka
node_kafka -.->|"delivers command"| node_inventory_listener
node_inventory_listener -->|"calls"| node_inventory_service
node_inventory_api -->|"calls"| node_inventory_service
node_inventory_service -->|"reads and writes"| node_inventory_store
node_inventory_listener -.->|"writes result"| node_outbox
node_kafka -.->|"delivers command"| node_payment_listener
node_payment_listener -->|"calls"| node_payment_service
node_payment_api -->|"calls"| node_payment_service
node_payment_service -->|"persists payment"| node_payment_store
node_payment_listener -.->|"writes result"| node_outbox
node_kafka -.->|"delivers result"| node_order_result
node_order_result -->|"handles result"| node_order_saga
node_publisher -.->|"publishes messages"| node_kafka

click node_gateway "https://github.com/viet7801/microservices/blob/main/gateway-service/src/main/java/microservice/gatewayservice/controller/GatewayController.java"
click node_eureka "https://github.com/viet7801/microservices/blob/main/eureka-server/src/main/java/microservice/eurekaserver/EurekaServerApplication.java"
click node_order_api "https://github.com/viet7801/microservices/blob/main/order-service/src/main/java/microservice/orderservice/controller/OrderController.java"
click node_order_service "https://github.com/viet7801/microservices/blob/main/order-service/src/main/java/microservice/orderservice/service/OrderService.java"
click node_order_saga "https://github.com/viet7801/microservices/blob/main/order-service/src/main/java/microservice/orderservice/service/OrderSaga.java"
click node_order_result "https://github.com/viet7801/microservices/blob/main/order-service/src/main/java/microservice/orderservice/messaging/OrderResultListener.java"
click node_order_store "https://github.com/viet7801/microservices/blob/main/order-service/src/main/java/microservice/orderservice/repository/OrderRepository.java"
click node_saga_store "https://github.com/viet7801/microservices/blob/main/order-service/src/main/java/microservice/orderservice/repository/SagaRepository.java"
click node_inventory_api "https://github.com/viet7801/microservices/blob/main/inventory-service/src/main/java/microservice/inventoryservice/controller/InventoryController.java"
click node_inventory_service "https://github.com/viet7801/microservices/blob/main/inventory-service/src/main/java/microservice/inventoryservice/service/InventoryService.java"
click node_inventory_store "https://github.com/viet7801/microservices/blob/main/inventory-service/src/main/java/microservice/inventoryservice/repository/InventoryRepository.java"
click node_inventory_listener "https://github.com/viet7801/microservices/blob/main/inventory-service/src/main/java/microservice/inventoryservice/messaging/InventoryListener.java"
click node_payment_api "https://github.com/viet7801/microservices/blob/main/payment-service/src/main/java/microservice/paymentservice/controller/PaymentController.java"
click node_payment_service "https://github.com/viet7801/microservices/blob/main/payment-service/src/main/java/microservice/paymentservice/service/PaymentService.java"
click node_payment_listener "https://github.com/viet7801/microservices/blob/main/payment-service/src/main/java/microservice/paymentservice/messaging/PaymentListener.java"
click node_payment_store "https://github.com/viet7801/microservices/blob/main/payment-service/src/main/java/microservice/paymentservice/repository/PaymentRepository.java"
click node_outbox "https://github.com/viet7801/microservices/blob/main/messaging/src/main/java/microservice/messaging/outbox/Outbox.java"
click node_publisher "https://github.com/viet7801/microservices/blob/main/messaging/src/main/java/microservice/messaging/outbox/OutboxPublisher.java"
click node_kafka "https://github.com/viet7801/microservices/blob/main/messaging/src/main/java/microservice/messaging/config/KafkaConfig.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gateway,node_eureka,node_client toneBlue
class node_order_api,node_order_service,node_order_saga,node_order_result,node_order_store,node_saga_store toneAmber
class node_inventory_api,node_inventory_service,node_inventory_store,node_inventory_listener,node_payment_api,node_payment_service,node_payment_listener,node_payment_store toneMint
class node_outbox,node_publisher,node_kafka toneRose
```

## Components

### Ingress and discovery

- [API gateway](https://github.com/viet7801/microservices/blob/main/gateway-service/src/main/java/microservice/gatewayservice/controller/GatewayController.java): `gateway-service/src/main/java/microservice/gatewayservice/controller/GatewayController.java`
- [Service discovery](https://github.com/viet7801/microservices/blob/main/eureka-server/src/main/java/microservice/eurekaserver/EurekaServerApplication.java): `eureka-server/src/main/java/microservice/eurekaserver/EurekaServerApplication.java`

### Order coordination

- [Order API](https://github.com/viet7801/microservices/blob/main/order-service/src/main/java/microservice/orderservice/controller/OrderController.java): `order-service/src/main/java/microservice/orderservice/controller/OrderController.java`
- [Order service](https://github.com/viet7801/microservices/blob/main/order-service/src/main/java/microservice/orderservice/service/OrderService.java): `order-service/src/main/java/microservice/orderservice/service/OrderService.java`
- [Saga handler](https://github.com/viet7801/microservices/blob/main/order-service/src/main/java/microservice/orderservice/service/OrderSaga.java): `order-service/src/main/java/microservice/orderservice/service/OrderSaga.java`
- [Result listener](https://github.com/viet7801/microservices/blob/main/order-service/src/main/java/microservice/orderservice/messaging/OrderResultListener.java): `order-service/src/main/java/microservice/orderservice/messaging/OrderResultListener.java`
- [Order storage](https://github.com/viet7801/microservices/blob/main/order-service/src/main/java/microservice/orderservice/repository/OrderRepository.java): `order-service/src/main/java/microservice/orderservice/repository/OrderRepository.java`
- [Saga storage](https://github.com/viet7801/microservices/blob/main/order-service/src/main/java/microservice/orderservice/repository/SagaRepository.java): `order-service/src/main/java/microservice/orderservice/repository/SagaRepository.java`

### Inventory and payment

- [Inventory API](https://github.com/viet7801/microservices/blob/main/inventory-service/src/main/java/microservice/inventoryservice/controller/InventoryController.java): `inventory-service/src/main/java/microservice/inventoryservice/controller/InventoryController.java`
- [Stock reservation](https://github.com/viet7801/microservices/blob/main/inventory-service/src/main/java/microservice/inventoryservice/service/InventoryService.java): `inventory-service/src/main/java/microservice/inventoryservice/service/InventoryService.java`
- [Inventory storage](https://github.com/viet7801/microservices/blob/main/inventory-service/src/main/java/microservice/inventoryservice/repository/InventoryRepository.java): `inventory-service/src/main/java/microservice/inventoryservice/repository/InventoryRepository.java`
- [Inventory listener](https://github.com/viet7801/microservices/blob/main/inventory-service/src/main/java/microservice/inventoryservice/messaging/InventoryListener.java): `inventory-service/src/main/java/microservice/inventoryservice/messaging/InventoryListener.java`
- [Payment API](https://github.com/viet7801/microservices/blob/main/payment-service/src/main/java/microservice/paymentservice/controller/PaymentController.java): `payment-service/src/main/java/microservice/paymentservice/controller/PaymentController.java`
- [Payment processing](https://github.com/viet7801/microservices/blob/main/payment-service/src/main/java/microservice/paymentservice/service/PaymentService.java): `payment-service/src/main/java/microservice/paymentservice/service/PaymentService.java`
- [Payment listener](https://github.com/viet7801/microservices/blob/main/payment-service/src/main/java/microservice/paymentservice/messaging/PaymentListener.java): `payment-service/src/main/java/microservice/paymentservice/messaging/PaymentListener.java`
- [Payment storage](https://github.com/viet7801/microservices/blob/main/payment-service/src/main/java/microservice/paymentservice/repository/PaymentRepository.java): `payment-service/src/main/java/microservice/paymentservice/repository/PaymentRepository.java`

### Messaging infrastructure

- [Transactional outbox](https://github.com/viet7801/microservices/blob/main/messaging/src/main/java/microservice/messaging/outbox/Outbox.java): `messaging/src/main/java/microservice/messaging/outbox/Outbox.java`
- [Outbox publisher](https://github.com/viet7801/microservices/blob/main/messaging/src/main/java/microservice/messaging/outbox/OutboxPublisher.java): `messaging/src/main/java/microservice/messaging/outbox/OutboxPublisher.java`
- [Kafka topics](https://github.com/viet7801/microservices/blob/main/messaging/src/main/java/microservice/messaging/config/KafkaConfig.java): `messaging/src/main/java/microservice/messaging/config/KafkaConfig.java`

### Other components

- **API client**

## Connections

- API client → API gateway: sends requests
- API gateway → Order API: routes requests
- Order API → Order service: calls (evidence: `order-service/src/main/java/microservice/orderservice/controller/OrderController.java`)
- Order service → Order storage: saves orders (evidence: `order-service/src/main/java/microservice/orderservice/service/OrderService.java`)
- Order service → Saga storage: starts saga (evidence: `order-service/src/main/java/microservice/orderservice/service/OrderService.java`)
- Order service → Transactional outbox: writes command (evidence: `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 (evidence: `inventory-service/src/main/java/microservice/inventoryservice/messaging/InventoryListener.java`)
- Inventory API → Stock reservation: calls (evidence: `inventory-service/src/main/java/microservice/inventoryservice/controller/InventoryController.java`)
- Stock reservation → Inventory storage: reads and writes (evidence: `inventory-service/src/main/java/microservice/inventoryservice/service/InventoryService.java`)
- Inventory listener → Transactional outbox: writes result (evidence: `inventory-service/src/main/java/microservice/inventoryservice/messaging/InventoryListener.java`)
- Kafka topics → Payment listener: delivers command
- Payment listener → Payment processing: calls (evidence: `payment-service/src/main/java/microservice/paymentservice/messaging/PaymentListener.java`)
- Payment API → Payment processing: calls (evidence: `payment-service/src/main/java/microservice/paymentservice/controller/PaymentController.java`)
- Payment processing → Payment storage: persists payment (evidence: `payment-service/src/main/java/microservice/paymentservice/service/PaymentService.java`)
- Payment listener → Transactional outbox: writes result (evidence: `payment-service/src/main/java/microservice/paymentservice/messaging/PaymentListener.java`)
- Kafka topics → Result listener: delivers result
- Result listener → Saga handler: handles result (evidence: `order-service/src/main/java/microservice/orderservice/messaging/OrderResultListener.java`)
- Outbox publisher → Kafka topics: publishes messages
