From 040b29aa5afa0fa01fa0f7a0261506ea041319ac Mon Sep 17 00:00:00 2001
From: forge-bot <bot@forge.local>
Date: Sun, 12 Jul 2026 04:41:46 +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(2/2)=20(iss-155aa95ea6df)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/architecture/transaction-sequence.md | 37 +++++++++++++++++++++++
 1 file changed, 37 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..7aeb9e7
--- /dev/null
+++ b/docs/architecture/transaction-sequence.md
@@ -0,0 +1,37 @@
+```mermaid
+sequenceDiagram
+    participant User as User
+    participant Checkout as Checkout Service
+    participant Payment as Payment Gateway
+    participant DB as Database
+
+    %% Normal flow
+    User->>Checkout: Initiate Checkout
+    Checkout->>DB: Save Order
+    DB-->>Checkout: Order Confirmation
+    Checkout->>Payment: Process Payment
+    Payment-->>Checkout: Payment Success
+    Checkout->>User: Payment Successful
+
+    %% External failure
+    User->>Checkout: Initiate Checkout
+    Checkout->>DB: Save Order
+    DB-->>Checkout: Order Confirmation
+    Checkout->>Payment: Process Payment
+    Payment-->>Checkout: Payment Failure
+    Checkout->>DB: Rollback Order
+    DB-->>Checkout: Order Rollback
+    Checkout->>User: Payment Failed
+
+    %% DB failure
+    User->>Checkout: Initiate Checkout
+    Checkout->>DB: Save Order
+    DB-->>Checkout: Order Confirmation
+    Checkout->>Payment: Process Payment
+    Payment-->>Checkout: Payment Success
+    Checkout->>DB: Commit Order
+    DB-->>Checkout: Error
+    Checkout->>DB: Rollback Order
+    DB-->>Checkout: Order Rollback
+    Checkout->>User: Payment Successful, Order Error
+```
\ No newline at end of file