Merge pull request '결제 전환 목표 아키텍처 정의 (1/2) (2/2)' (#6) from forge/iss-87190c9836ac-attempt-1 into main

.forge/iss-5a912ed79baf-attempt-1.md

@@ -1,3 +0,0 @@
-# iss-5a912ed79baf-attempt-1
-
-Forge 이슈 작업 브랜치 `forge/iss-5a912ed79baf-attempt-1`.

.forge/iss-5a912ed79baf-attempt-3.md

@@ -0,0 +1,3 @@
+# iss-5a912ed79baf-attempt-3
+
+Forge 이슈 작업 브랜치 `forge/iss-5a912ed79baf-attempt-3`.

.forge/iss-87190c9836ac-attempt-1.md

@@ -0,0 +1,3 @@
+# iss-87190c9836ac-attempt-1
+
+Forge 이슈 작업 브랜치 `forge/iss-87190c9836ac-attempt-1`.

docs/architecture/package-map.md

@@ -0,0 +1,9 @@
+# Package Responsibility Map
+
+| Package        | Responsibility                                  | Forbidden Dependencies |
+|----------------|------------------------------------------------|------------------------|
+| controller     | Handles user input and orchestrates payment    | domain                 |
+| service        | Contains business logic for payment processing  | integration            |
+| repository     | Data access layer for payment records           | service                |
+| domain         | Defines the core domain models and business rules| controller             |
+| integration     | Communicates with external payment gateways     | domain, service        |

docs/architecture/transaction-sequence.md

@@ -1,40 +1,38 @@
 ```mermaid
 sequenceDiagram
-    participant User as 유저
-    participant PaymentService as 결제 서비스
-    participant PaymentGateway as 결제 게이트웨이
-    participant Database as 데이터베이스
+    participant User
+    participant PaymentService
+    participant PaymentGateway
+    participant Database
 
-    User->>PaymentService: 결제 요청
-    PaymentService->>Database: 결제 정보 저장
-    activate Database
-    Database-->>PaymentService: 저장 완료
-    deactivate Database
+    %% Normal Flow
+    User->>PaymentService: Initiate Payment
+    PaymentService->>Database: Store Transaction
+    Database-->>PaymentService: Transaction Stored
+    PaymentService->>PaymentGateway: Process Payment
+    PaymentGateway-->>PaymentService: Payment Success
+    PaymentService->>Database: Update Transaction Status
+    Database-->>PaymentService: Transaction Updated
+    PaymentService-->>User: Payment Success
 
-    alt 정상 흐름
-        PaymentService->>PaymentGateway: 결제 요청
-        activate PaymentGateway
-        PaymentGateway-->>PaymentService: 결제 성공
-        deactivate PaymentGateway
-        PaymentService->>User: 결제 완료
+    %% External Failure Flow
+    User->>PaymentService: Initiate Payment
+    PaymentService->>Database: Store Transaction
+    Database-->>PaymentService: Transaction Stored
+    PaymentService->>PaymentGateway: Process Payment
+    PaymentGateway-->>PaymentService: Payment Failure
+    PaymentService->>Database: Rollback Transaction
+    Database-->>PaymentService: Transaction Rolled Back
+    PaymentService-->>User: Payment Failure
 
-    else 외부 실패
-        PaymentService->>PaymentGateway: 결제 요청
-        activate PaymentGateway
-        PaymentGateway-->>PaymentService: 결제 실패
-        deactivate PaymentGateway
-        PaymentService->>Database: 롤백
-        activate Database
-        Database-->>PaymentService: 롤백 완료
-        deactivate Database
-        PaymentService->>User: 결제 실패
-    end
+    %% DB Failure Flow
+    User->>PaymentService: Initiate Payment
+    PaymentService->>Database: Store Transaction
+    Database-->>PaymentService: Transaction Store Failure
+    PaymentService-->>User: Payment Failure
 
-    else DB 실패
-        PaymentService->>Database: 결제 정보 저장
-        activate Database
-        Database-->>PaymentService: 저장 실패
-        deactivate Database
-        PaymentService->>User: 저장 실패
-    end
+    %% Commit & Rollback
+    Note over User, PaymentService: 
+    commit --> PaymentService
+    rollback --> PaymentService
 ```