diff --git a/.forge/SPRING-ARC-FINAL-1783825413-attempt-1.md b/.forge/SPRING-ARC-FINAL-1783825413-attempt-1.md new file mode 100644 index 0000000..ac94a05 --- /dev/null +++ b/.forge/SPRING-ARC-FINAL-1783825413-attempt-1.md @@ -0,0 +1,3 @@ +# SPRING-ARC-FINAL-1783825413-attempt-1 + +Forge 이슈 작업 브랜치 `forge/SPRING-ARC-FINAL-1783825413-attempt-1`. diff --git a/docs/architecture/adr-payment-boundary.md b/docs/architecture/adr-payment-boundary.md new file mode 100644 index 0000000..0214243 --- /dev/null +++ b/docs/architecture/adr-payment-boundary.md @@ -0,0 +1,15 @@ +# 결제 경계 ADR + +## Context +결제 시스템의 경계를 정의하고, 외부 결제 게이트웨이와의 상호작용을 명확히 하기 위해 ADR을 작성한다. + +## Decision +결제 도메인에서 외부 결제 게이트웨이를 직접 참조하지 않고, 포트 인터페이스를 통해 의존성을 관리한다. + +## Alternatives +1. 외부 결제 게이트웨이를 직접 참조하는 방법 +2. 포트 인터페이스를 사용하여 의존성을 관리하는 방법 (선택됨) + +## Consequences +- 외부 결제 게이트웨이의 변경이 도메인에 미치는 영향을 최소화할 수 있다. +- 테스트 용이성이 증가한다. \ No newline at end of file diff --git a/docs/architecture/package-map.md b/docs/architecture/package-map.md new file mode 100644 index 0000000..746b9ae --- /dev/null +++ b/docs/architecture/package-map.md @@ -0,0 +1,7 @@ +| 패키지 | 책임 | 금지 의존성 | +|-------------|--------------------------------------------|--------------------------| +| controller | 사용자 요청 처리 및 응답 반환 | service, repository | +| service | 비즈니스 로직 처리 | controller, repository | +| repository | 데이터 저장 및 조회 | controller, service | +| domain | 도메인 모델 및 규칙 정의 | controller, service, repository | +| integration | 외부 시스템과의 통합 (예: 결제 게이트웨이) | domain | \ No newline at end of file diff --git a/docs/architecture/transaction-sequence.md b/docs/architecture/transaction-sequence.md new file mode 100644 index 0000000..a722278 --- /dev/null +++ b/docs/architecture/transaction-sequence.md @@ -0,0 +1,28 @@ +```mermaid +sequenceDiagram + participant User + participant Controller + participant Service + participant Repository + participant Gateway + + User->>Controller: 결제 요청 + Controller->>Service: 결제 처리 요청 + Service->>Repository: 트랜잭션 시작 + alt 정상 흐름 + Repository-->>Service: 트랜잭션 ID 반환 + Service->>Gateway: 결제 요청 + Gateway-->>Service: 결제 성공 + Service->>Repository: 트랜잭션 커밋 + Repository-->>Service: 커밋 성공 + else 외부 실패 + Gateway-->>Service: 결제 실패 + Service->>Repository: 트랜잭션 롤백 + Repository-->>Service: 롤백 성공 + else DB 실패 + Service->>Repository: 트랜잭션 롤백 + Repository-->>Service: 롤백 실패 + end + Service-->>Controller: 결제 결과 반환 + Controller-->>User: 결제 결과 응답 +``` \ No newline at end of file