From 53530ee7dde748d2bacd2560c5ebe79b1daa9192 Mon Sep 17 00:00:00 2001
From: forge-bot <bot@forge.local>
Date: Sun, 12 Jul 2026 22:27:45 +0000
Subject: [PATCH] =?UTF-8?q?=EA=B2=B0=EC=A0=9C=20=ED=8A=B8=EB=9E=9C?=
 =?UTF-8?q?=EC=9E=AD=EC=85=98=20=EC=8B=9C=ED=80=80=EC=8A=A4=20=EA=B3=84?=
 =?UTF-8?q?=EC=95=BD=20=EC=A0=95=EC=9D=98=20(SPRING-ARC-SEQUENCE)?=
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..dc6c628
--- /dev/null
+++ b/docs/architecture/transaction-sequence.md
@@ -0,0 +1,29 @@
+```mermaid
+sequenceDiagram
+    participant User as User
+    participant Controller as Controller
+    participant PaymentService as PaymentService
+    participant Gateway as PaymentGateway
+    participant DB as Database
+
+    User ->> Controller: Initiate Payment
+    Controller ->> PaymentService: Process Payment
+    PaymentService ->> Gateway: Call Payment Gateway
+    alt Successful Payment
+        Gateway -->> PaymentService: Payment Success
+        PaymentService ->> DB: Save Transaction
+        DB -->> PaymentService: Transaction Saved
+        PaymentService -->> Controller: Payment Processed
+        Controller -->> User: Payment Successful
+    else External Gateway Failure
+        Gateway -->> PaymentService: Payment Failed
+        PaymentService -->> Controller: Payment Failed
+        Controller -->> User: Payment Failed
+    else DB Failure
+        Gateway -->> PaymentService: Payment Success
+        PaymentService ->> DB: Save Transaction
+        DB -->> PaymentService: DB Error
+        PaymentService ->> Controller: Rollback Transaction
+        Controller -->> User: Payment Failed
+    end
+```
\ No newline at end of file