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/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