README.md

Saga Pattern

이 프로젝트는 MSA 환경에서 주문 요청 후 결제 처리 과정에서 문제가 발생할 경우, 보상 트랜잭션을 사용하여 트랜잭션을 롤백하는 Saga 패턴을 구현한 예제입니다. 패키지 구조는 Hexagonal Architecture로 구성되어 있으며, Kotlin을 사용하여 구현했습니다.

프로젝트의 주요 목표는 MSA 환경에서의 트랜잭션 관리 방식을 이해하고, Kotlin과 Hexagonal Architecture를 활용하여 설계 및 구현하는 것입니다.

사용 기술

• Kotlin, Spring Boot, H2, JPA

주요 기능

• 사용자는 상품을 주문할 수 있으며, 결제가 실패할 경우 해당 주문은 자동으로 취소됩니다. 이와 동시에, 해당 상품의 재고는 이전 상태로 복구됩니다.

프로젝트 상세

1. Saga Pattern

Choreography-based:

• 각 서비스가 이벤트를 통해 독립적으로 상호작용하며, 중앙 조정자 없이 분산된 형태로 동작합니다.

보상 트랜잭션:

• 트랜잭션 실패 시 원래 상태로 되돌리기 위한 보상 트랜잭션을 사용합니다.

2. Hexagonal Architecture

각 구성 요소가 독립적으로 동작할 수 있도록 설계하여 코드의 응집도를 높이고 결합도를 낮췄습니다.

Sequence Diagram

sequenceDiagram
    actor User as User
    participant OrderService as Order Service
    participant StockService as Stock Service
    participant PaymentService as Payment Service
    participant Kafka as Kafka
    User ->> OrderService: 상품 주문
    OrderService ->> OrderService: 주문 생성
    OrderService ->> Kafka: 주문 생성 이벤트 발행
    Kafka ->> StockService: 주문 생성 이벤트 수신
    StockService ->> StockService: 재고 감소
    StockService ->> Kafka: 재고 감소 이벤트 발행
    Kafka ->> PaymentService: 재고 감소 이벤트 수신
    PaymentService ->> PaymentService: 결제 시도
    alt 결제 실패
        PaymentService -->> Kafka: 재고 롤백 이벤트 발행
        Kafka ->> StockService: 재고 롤백 이벤트 수신
        StockService ->> StockService: 재고 롤백
        StockService -->> Kafka: 주문 롤백 이벤트 발행
        Kafka ->> OrderService: 주문 롤백 이벤트 수신
        OrderService ->> OrderService: 주문 롤백
    end

Loading