Commerce MSA

• 상품 조회부터 결제 완료까지의 주문 플로우를 여러 독립 서비스가 협력해 처리하는 이벤트 기반 커머스 MSA 시스템
• Kafka 기반 이벤트 흐름, 재고 예약, 결제 승인, 멱등 처리 등 실제 커머스 환경의 문제를 직접 구현하며 검증하는 프로젝트

---

기술 스택

• Language Java 21
• Framework Spring Boot 3.5, Spring Cloud Stream
• Build Gradle (Kotlin DSL, Multi-module)
• Database PostgreSQL 16 (서비스별 스키마 분리)
• Messaging Apache Kafka (KRaft)
• Persistence Spring Data JPA, QueryDSL
• API Docs Springdoc OpenAPI (Swagger UI)

---

서비스 구성

Service	Port	역할
product-service	20101	상품 등록 / 조회 / 상태 관리
inventory-service	20102	재고 등록 / 수량 관리
order-service	20103	주문 생성 / 상태 추적
payment-service	20104	결제 초기화 / 승인 처리

공유 라이브러리 shared/common은 예외 계층, 이벤트 유틸리티, 웹 에러 처리를 Spring Boot Auto-configuration으로 제공

---

아키텍처

DDD 레이어 구조

각 서비스는 동일한 패키지 구조를 따름.

dev.labs.commerce.{service}
├─ api/ # HTTP 계층 (Controller, Request/Response DTO)
├─ core/
│ └─ {domain}/
│     ├─ application/ # UseCase (트랜잭션 경계), CommandService, QueryService
│     ├─ domain/ # 모델, 도메인 예외, 이벤트, Repository 인터페이스
│     └─ infra/ # Kafka Publisher/Consumer, QueryDSL
├─ config/ # Spring 빈 설정
└─ *Application

레이어 간 의존성 규칙:

• api → application만 호출 (Repository, Kafka 직접 접근 금지)
• domain → Spring/Infra 의존 없음 (순수 비즈니스 로직)
• application → domain 인터페이스만 사용
• infra → domain 계약만 참조 (api/application 참조 금지)

---

로컬 실행

사전 요구사항

• Java 21
• Docker & Docker Compose

1. 인프라 시작

cd deploy && docker compose up -d

Service	Host Port
PostgreSQL	20011
Redis	20021
Kafka	20023

2. 서비스 실행

각 서비스를 개별 터미널에서 실행.

./gradlew :service:product-service:bootRun
./gradlew :service:inventory-service:bootRun
./gradlew :service:order-service:bootRun
./gradlew :service:payment-service:bootRun

3. 시나리오 실행

service/http/scenario.http를 IntelliJ HTTP Client로 순서대로 실행.

단계	요청	서비스
1	상품 등록 POST /api/v1/products	product-service
2	상품 활성화 PATCH /api/v1/products/{id}/status	product-service
3	재고 적재 PATCH /api/v1/inventories/{id}/quantity	inventory-service
4	주문 생성 POST /api/v1/orders	order-service
5	결제 초기화 POST /api/v1/payments	payment-service
6	PG 콜백 시뮬레이션 GET /payments/mock-pay/success	payment-service

Docker Compose로 전체 실행 (인프라 + 서비스 일괄 기동)

인프라와 4개 서비스를 한 번에 빌드·실행한다.

docker compose -f docker-compose.app.yml up --build

백그라운드 실행:

docker compose -f docker-compose.app.yml up --build -d

종료 및 정리:

# 컨테이너 중지·제거
docker compose -f docker-compose.app.yml down

# 볼륨(DB 데이터)까지 삭제
docker compose -f docker-compose.app.yml down -v

---

문서

• 주문 흐름 / 상태 전이
• Kafka 토픽
• 주요 컴포넌트 (만료 스케줄러, Mock PG)