.forge/SPRING-ARC-SPLIT-1783827796-attempt-2.md

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

docs/architecture/adr-payment-boundary.md

@@ -0,0 +1,15 @@
+# Architecture Decision Record: Payment Boundary
+
+## Context
+결제 시스템의 경계를 정의하여 서비스 간의 의존성을 명확히 하고, 결제 처리의 안정성을 높이기 위함.
+
+## Decision
+결제 서비스는 직접적으로 레포지토리에 접근하지 않고, 도메인 모델을 통해 간접적으로 접근하도록 한다.
+
+## Alternatives
+1. 서비스가 레포지토리에 직접 접근하는 방법
+2. 도메인 모델을 통한 간접 접근 방법 (선택)
+
+## Consequences
+- 서비스와 레포지토리 간의 의존성이 줄어들어 테스트 용이성이 증가함.
+- 도메인 모델을 통해 비즈니스 로직이 명확해짐.

docs/architecture/package-map.md

@@ -0,0 +1,7 @@
+| 패키지       | 책임                                   | 금지 의존성          |
+|--------------|--------------------------------------|--------------------|
+| controller   | 사용자 요청 처리                      | service -> repository |
+| service      | 비즈니스 로직 처리                    | repository -> service |
+| repository   | 데이터 저장 및 조회                   | 없음                |
+| domain       | 도메인 모델 정의                     | 없음                |
+| integration   | 외부 시스템과의 통신                 | 없음                |

docs/architecture/transaction-sequence.md

@@ -0,0 +1,25 @@
+```mermaid
+sequenceDiagram
+    participant User
+    participant PaymentService
+    participant DomainModel
+    participant Repository
+
+    User->>PaymentService: 결제 요청
+    PaymentService->>DomainModel: 결제 처리
+    DomainModel->>Repository: 데이터 저장
+    Repository-->>DomainModel: 저장 성공
+    DomainModel-->>PaymentService: 처리 완료
+    PaymentService-->>User: 결제 성공
+
+    alt 외부 실패
+        PaymentService-->>User: 결제 실패
+    end
+
+    alt DB 실패
+        DomainModel->>Repository: 데이터 저장 실패
+        Repository-->>DomainModel: 저장 실패
+        DomainModel-->>PaymentService: 롤백
+        PaymentService-->>User: 결제 실패
+    end
+```