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

.forge/iss-5046557b3d46-attempt-1.md

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

.forge/iss-6f8eac22f6f0-attempt-1.md

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

docs/architecture/package-map.md

@@ -0,0 +1,9 @@
+# Package Responsibility and Forbidden Dependencies
+
+| Package         | Responsibility                                          | Forbidden Dependencies  |
+|------------------|------------------------------------------------------|--------------------------|
+| controller       | Handle user requests, validate inputs, and respond   | domain                   |
+| service          | Contain business logic and orchestration              | repository               |
+| repository       | Manage data access and persistence                     | service                  |
+| domain           | Define core business models and rules                 | integration              |
+| integration      | Interface with external systems (e.g. payment gateways) | domain, service          |

docs/architecture/transaction-sequence.md

@@ -0,0 +1,41 @@
+```mermaid
+sequenceDiagram
+    participant User
+    participant PaymentService
+    participant PaymentGateway
+    participant Database
+
+    %% 정상 흐름
+    User->>PaymentService: 결제 요청
+    PaymentService->>Database: 거래 데이터 저장
+    Database-->>PaymentService: 저장 완료
+    PaymentService->>PaymentGateway: 결제 요청
+    PaymentGateway-->>PaymentService: 결제 성공
+    PaymentService->>Database: 거래 완료 상태 업데이트
+    Database-->>PaymentService: 상태 업데이트 완료
+    PaymentService-->>User: 결제 성공 응답
+
+    %% 외부 실패 흐름
+    User->>PaymentService: 결제 요청
+    PaymentService->>Database: 거래 데이터 저장
+    Database-->>PaymentService: 저장 완료
+    PaymentService->>PaymentGateway: 결제 요청
+    PaymentGateway-->>PaymentService: 결제 실패
+    PaymentService->>Database: 거래 실패 상태 업데이트
+    Database-->>PaymentService: 상태 업데이트 완료
+    PaymentService-->>User: 결제 실패 응답
+
+    %% DB 실패 흐름
+    User->>PaymentService: 결제 요청
+    PaymentService->>Database: 거래 데이터 저장
+    Database-->>PaymentService: 저장 실패
+    PaymentService-->>User: 결제 실패 응답
+
+    %% commit 흐름
+    PaymentService->>Database: 커밋
+    Database-->>PaymentService: 커밋 완료
+
+    %% rollback 흐름
+    PaymentService->>Database: 롤백
+    Database-->>PaymentService: 롤백 완료
+```