.forge/SPRING-ARC-REVIEW-1783835414-attempt-2-run-77bed2c0508e.md

@@ -1,3 +0,0 @@
-# SPRING-ARC-REVIEW-1783835414-attempt-2-run-77bed2c0508e
-
-Forge 이슈 작업 브랜치 `forge/SPRING-ARC-REVIEW-1783835414-attempt-2-run-77bed2c0508e`.

docs/architecture/transaction-sequence.md

@@ -1,21 +1,32 @@
 ```mermaid
 sequenceDiagram
-    participant A as User
+    participant User
-    participant B as Payment Processor
+    participant PaymentGateway
-    participant C as External Gateway
+    participant PaymentService
-    A->>B: 결제 요청
+    participant Database
-    B->>C: 결제 정보 전달
+
-    alt 성공
+    User->>+PaymentService: Start Payment
-        C-->>B: 성공 응답
+    PaymentService->>+PaymentGateway: Process Payment
-        B-->>A: 결제 완료
+    PaymentGateway-->>-PaymentService: Payment Success
-        note right of A: 결제 성공 처리
+    PaymentService->>Database: Record Payment
-    else 외부 실패
+    Database-->>-PaymentService: Payment Recorded
-        C-->>B: 실패 응답
+    PaymentService-->>-User: Payment Confirmed
-        B-->>A: 결제 실패
+
-        note right of A: 실패 처리 및 재시도
+    %% External Failure
-    else DB 실패
+    User->>+PaymentService: Start Payment
-        B->>B: 롤백 처리
+    PaymentService->>+PaymentGateway: Process Payment
-        B-->>A: 결제 실패
+    PaymentGateway-->>-PaymentService: Payment Failed
-        note right of A: 롤백 기록
+    PaymentService-->>-User: Payment Failed
-    end
+
+    %% DB Failure
+    User->>+PaymentService: Start Payment
+    PaymentService->>+PaymentGateway: Process Payment
+    PaymentGateway-->>-PaymentService: Payment Success
+    PaymentService->>Database: Record Payment
+    Database-->>-PaymentService: DB Failure
+    PaymentService-->>-User: Payment Processing Error
+
+    %% Commit/Rollback
+    Note over PaymentService: Commit if successful
+    Note over PaymentService: Rollback if there's an error
 ```