.forge/SPRING-ARC-GATE-1783823993-attempt-1.md

@@ -0,0 +1,3 @@
+# SPRING-ARC-GATE-1783823993-attempt-1
+
+Forge 이슈 작업 브랜치 `forge/SPRING-ARC-GATE-1783823993-attempt-1`.

docs/architecture/adr-payment-boundary.md

@@ -0,0 +1,16 @@
+# 결제 경계 아키텍처 결정 기록 (ADR)
+
+## Context
+결제 시스템의 경계를 정의하고, 외부 결제 게이트웨이와의 상호작용을 관리하기 위한 아키텍처를 설정합니다. 도메인 모델이 외부 어댑터를 직접 참조하지 않도록 하여, 의존성을 줄이고 테스트 용이성을 높입니다.
+
+## Decision
+도메인 레이어는 외부 결제 게이트웨이와의 상호작용을 위해 포트 인터페이스를 사용하고, 어댑터는 인프라 레이어에서 구현합니다. 이를 통해 도메인 로직은 외부 시스템에 대한 의존성을 가지지 않게 됩니다.
+
+## Alternatives
+1. 도메인에서 직접 외부 결제 게이트웨이를 호출하는 방법
+2. 서비스 레이어에서 외부 게이트웨이를 호출하는 방법
+
+## Consequences
+- 도메인 모델의 독립성이 증가하여 테스트가 용이해짐
+- 외부 시스템 변경 시 도메인 로직에 영향을 미치지 않음
+- 아키텍처가 더 명확해짐

docs/architecture/package-map.md

@@ -0,0 +1,7 @@
+| 패키지      | 책임                                      | 금지 의존성           |
+|-------------|-----------------------------------------|---------------------|
+| controller  | 사용자 요청 처리 및 응답 반환                  | domain, service     |
+| service     | 비즈니스 로직 처리 및 트랜잭션 관리            | repository           |
+| repository  | 데이터 저장소와의 상호작용                    | domain              |
+| domain      | 비즈니스 규칙 및 도메인 모델 정의              | integration          |
+| integration  | 외부 시스템과의 통신 (예: 결제 게이트웨이)    | domain              |

docs/architecture/transaction-sequence.md

@@ -0,0 +1,25 @@
+```mermaid
+sequenceDiagram
+    participant User
+    participant Controller
+    participant Service
+    participant Repository
+    participant PaymentGateway
+
+    User->>Controller: 결제 요청
+    Controller->>Service: 결제 처리 요청
+    Service->>Repository: 트랜잭션 시작
+    alt 정상 흐름
+        Service->>PaymentGateway: 결제 요청
+        PaymentGateway-->>Service: 결제 성공
+        Service->>Repository: 트랜잭션 커밋
+    else 외부 실패
+        Service->>PaymentGateway: 결제 요청
+        PaymentGateway-->>Service: 결제 실패
+        Service->>Repository: 트랜잭션 롤백
+    else DB 실패
+        Service->>Repository: 트랜잭션 시작
+        Service->>Repository: DB 오류 발생
+        Service->>Repository: 트랜잭션 롤백
+    end
+```