diff --git a/.forge/SPRING-ARC-CONTRACT-1783840884-attempt-1-run-31e9254b150a.md b/.forge/SPRING-ARC-CONTRACT-1783840884-attempt-1-run-31e9254b150a.md new file mode 100644 index 0000000..01ad977 --- /dev/null +++ b/.forge/SPRING-ARC-CONTRACT-1783840884-attempt-1-run-31e9254b150a.md @@ -0,0 +1,3 @@ +# SPRING-ARC-CONTRACT-1783840884-attempt-1-run-31e9254b150a + +Forge 이슈 작업 브랜치 `forge/SPRING-ARC-CONTRACT-1783840884-attempt-1-run-31e9254b150a`. diff --git a/.forge/iss-3588e28b9152-attempt-2-run-110ea1627109.md b/.forge/iss-3588e28b9152-attempt-2-run-110ea1627109.md new file mode 100644 index 0000000..70d88dd --- /dev/null +++ b/.forge/iss-3588e28b9152-attempt-2-run-110ea1627109.md @@ -0,0 +1,3 @@ +# iss-3588e28b9152-attempt-2-run-110ea1627109 + +Forge 이슈 작업 브랜치 `forge/iss-3588e28b9152-attempt-2-run-110ea1627109`. diff --git a/docs/architecture/adr-payment-boundary.md b/docs/architecture/adr-payment-boundary.md new file mode 100644 index 0000000..0432ee3 --- /dev/null +++ b/docs/architecture/adr-payment-boundary.md @@ -0,0 +1,19 @@ +# Architecture Decision Record: Payment Boundary + +## Context +결제 시스템의 아키텍처를 정의하기 위해, 외부 결제 게이트웨이와의 상호작용을 명확히 하고, 도메인에서 어댑터를 직접 참조하지 않도록 설계한다. + +## 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..9f6ee4c --- /dev/null +++ b/docs/architecture/package-map.md @@ -0,0 +1,7 @@ +| 패키지 | 책임 | 금지 의존성 | +|-----------|-----------------------------------------|-----------------------| +| controller | 사용자 요청 처리 및 응답 반환 | 도메인 직접 참조 | +| service | 비즈니스 로직 처리 및 트랜잭션 관리 | 외부 결제 게이트웨이 직접 참조 | +| repository | 데이터 저장소와의 상호작용 | 도메인 직접 참조 | +| domain | 비즈니스 규칙 및 도메인 모델 정의 | 외부 결제 게이트웨이 직접 참조 | +| integration | 외부 시스템과의 통합 및 상호작용 | 도메인 직접 참조 | \ 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..968a9fb --- /dev/null +++ b/docs/architecture/transaction-sequence.md @@ -0,0 +1,31 @@ +--- +# Transaction Sequence + +## Sequence Diagram + +```mermaid +sequenceDiagram + participant User + participant PaymentGateway + participant Database + + User->>PaymentGateway: 결제 요청 + alt 정상 흐름 + PaymentGateway-->>User: 결제 승인 + User->>Database: 트랜잭션 저장 + Database-->>User: 저장 완료 + Note right of User: 커밋 + else 외부 실패 + PaymentGateway-->>User: 결제 실패 + Note right of User: 롤백 + else DB 실패 + User->>Database: 트랜잭션 저장 실패 + Note right of User: 롤백 + end +``` + +## Commit and Rollback +- 정상 흐름에서 트랜잭션이 성공적으로 저장되면 커밋이 발생합니다. +- 외부 실패 또는 DB 실패 시 롤백이 발생합니다. + +--- \ No newline at end of file