Home

Payment Platform Wiki

결제 플랫폼 프로젝트의 각 단계별 설계 결정, 구현 세부 내용, 트레이드오프를 기록한 공간이다.

---

🏗 아키텍처

• Architecture — 4서비스 MSA + hexagonal 6패키지 구조, 통신·인프라 토폴로지

---

🌐 MSA & 메시징

• MSA 전환 — 모놀리스에서 4서비스 분해, 끊은 결합 ↔ 새로 만든 자산
• 이벤트 드리븐 코레오그래피 — Kafka 토픽 카탈로그와 3자 시퀀스
• 재고 캐시 보상 회복 — Lua atomic — 보상 실패의 Kafka native 회복 + dedupe lease 폐기 (Lua 설계는 Phase 6 초기 모델)
  • 재고 선차감 게이트 상품 단위 분해 — 캐시 샤딩을 전제로 원자성 경계를 상품 단위로 내린 현재 모델
• Outbox 패턴 — 트랜잭션과 발행을 한 RDB로 묶는 발행 보장 (2 모델 비교)
  • Outbox 채널 디스패치 — pg-service 패턴 B 상세 (in-memory channel + OTel/MDC 핸드오프)
• 메시지 전달 보장 + dedupe — at-least-once + 도메인별 멱등 소비 + DLQ
• 결제 복구 모델 — 멈춘 결제를 되살리는 복구 스케줄러, 되돌리기의 도착지, 덮어쓰기를 막는 두 자리
• PG 결제 확인 흐름 — pg-service 가 확인 명령 한 건을 받아 결과 이벤트로 회신하는 한 사이클
• MySQL Index Merge 데드락 — 서로 다른 주문의 UPDATE 충돌 재현, 복합 인덱스 교체와 완료 p99 개선
• 분산 트레이싱 — OTel + Kafka 헤더 + 가상 스레드 컨텍스트 전파

---

📋 개발 여정

Phase	목표	문서
Phase 1	데이터 정합성 확립	교차 검증 연동
Phase 2	결합도 해소 및 자가 복구력	트랜잭션 범위 최소화 · 상태 기반 복구 모델 및 재시도 로직
Phase 3	운영 가시성 및 안정성	시나리오 테스트 · 구조화된 로깅 · 결제 이력 추적 및 모니터링
Phase 4	데이터 정합성 심화 및 중복 제어	보상 TX 실패 대응 · Checkout 멱등성 보장
Phase 5	비동기 결제 아키텍처 전환	비동기 Outbox · 가상 스레드 기반 결제 플로우 · 도메인 상태 머신과 백오프 기반 재시도
Phase 6	MSA 분리 + Kafka 양방향 + 분산 트레이싱	MSA 전환 · 이벤트 드리븐 코레오그래피 · 재고 캐시 보상 회복 — Lua atomic · 재고 선차감 게이트 상품 단위 분해 · Outbox 패턴 · 메시지 전달 보장 + dedupe · 결제 복구 모델 · PG 결제 확인 흐름 · 분산 트레이싱
ETC	설계 유연성	전략 패턴 기반 멀티 PG 연동
ETC	AI 기반 개발 워크플로우	서브에이전트 기반 4단계 워크플로우

---

• Benchmark-Report — Phase 5 모놀리스의 Sync vs Async 전략 TPS·레이턴시 정량 비교
• MSA 승인 결과 저장 데드락 개선 — 완료 p99 73.10초 → 9.28초, payment·PG 각 2대 / 주 부하 40건/초 / 각 조건 1회