From 9f634a5408848672abc110abf68896e0819bf785 Mon Sep 17 00:00:00 2001
From: forge-bot <bot@forge.local>
Date: Sun, 12 Jul 2026 03:28:38 +0000
Subject: [PATCH] =?UTF-8?q?=EA=B2=B0=EC=A0=9C=20=EC=A0=84=ED=99=98=20?=
 =?UTF-8?q?=EB=AA=A9=ED=91=9C=20=EC=95=84=ED=82=A4=ED=85=8D=EC=B2=98=20?=
 =?UTF-8?q?=EC=A0=95=EC=9D=98=20(SPRING-ARC-VERIFIED-1783826844)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/architecture/transaction-sequence.md | 29 +++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 docs/architecture/transaction-sequence.md

diff --git a/docs/architecture/transaction-sequence.md b/docs/architecture/transaction-sequence.md
new file mode 100644
index 0000000..1b564ec
--- /dev/null
+++ b/docs/architecture/transaction-sequence.md
@@ -0,0 +1,29 @@
+sequenceDiagram
+    participant C as Controller
+    participant S as Service
+    participant R as Repository
+    participant DB as Database
+    participant E as External Payment Gateway
+
+    C->>S: 결제 요청 
+    S->>R: 결제 정보 요청 
+    R->>DB: 결제 정보 저장 
+    DB-->>R: 저장 성공 
+    S->>E: 결제 진행 
+    E-->>S: 결제 성공 
+    S->>C: 결제 성공 응답 
+
+    note over C: 외부 실패와 같은 경우
+    S->>E: 결제 진행 
+    E-->>S: 결제 실패 
+    S->>R: 데이터 롤백 
+    R->>DB: 롤백 처리 
+    DB-->>R: 롤백 성공 
+    S->>C: 결제 실패 응답 
+
+    note over C: DB 실패의 경우
+    S->>R: 결제 정보 요청 
+    R->>DB: 결제 정보 저장 
+    DB-->>R: 저장 실패 
+    R-->>S: 에러 응답 
+    S->>C: 결제 실패 응답