From 7e0dab084b5e7fb37893396774f544e2a2079634 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 02:39:57 +0000 Subject: [PATCH 1/4] forge: open work branch for SPRING-ARC-GATE-1783823993-attempt-1 --- .forge/SPRING-ARC-GATE-1783823993-attempt-1.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 .forge/SPRING-ARC-GATE-1783823993-attempt-1.md diff --git a/.forge/SPRING-ARC-GATE-1783823993-attempt-1.md b/.forge/SPRING-ARC-GATE-1783823993-attempt-1.md new file mode 100644 index 0000000..f376542 --- /dev/null +++ b/.forge/SPRING-ARC-GATE-1783823993-attempt-1.md @@ -0,0 +1,3 @@ +# SPRING-ARC-GATE-1783823993-attempt-1 + +Forge 이슈 작업 브랜치 `forge/SPRING-ARC-GATE-1783823993-attempt-1`. From 37f0014df1db65e2934876499f00c917cef2debf Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 02:40:31 +0000 Subject: [PATCH 2/4] =?UTF-8?q?=EA=B2=B0=EC=A0=9C=20=EC=A0=84=ED=99=98=20?= =?UTF-8?q?=EB=AA=A9=ED=91=9C=20=EC=95=84=ED=82=A4=ED=85=8D=EC=B2=98=20?= =?UTF-8?q?=EC=A0=95=EC=9D=98=20(SPRING-ARC-GATE-1783823993)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/architecture/adr-payment-boundary.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 docs/architecture/adr-payment-boundary.md diff --git a/docs/architecture/adr-payment-boundary.md b/docs/architecture/adr-payment-boundary.md new file mode 100644 index 0000000..ca86cce --- /dev/null +++ b/docs/architecture/adr-payment-boundary.md @@ -0,0 +1,16 @@ +# 결제 경계 아키텍처 결정 기록 (ADR) + +## Context +결제 시스템의 경계를 정의하고, 외부 결제 게이트웨이와의 상호작용을 관리하기 위한 아키텍처를 설정합니다. 도메인 모델이 외부 어댑터를 직접 참조하지 않도록 하여, 의존성을 줄이고 테스트 용이성을 높입니다. + +## Decision +도메인 레이어는 외부 결제 게이트웨이와의 상호작용을 위해 포트 인터페이스를 사용하고, 어댑터는 인프라 레이어에서 구현합니다. 이를 통해 도메인 로직은 외부 시스템에 대한 의존성을 가지지 않게 됩니다. + +## Alternatives +1. 도메인에서 직접 외부 결제 게이트웨이를 호출하는 방법 +2. 서비스 레이어에서 외부 게이트웨이를 호출하는 방법 + +## Consequences +- 도메인 모델의 독립성이 증가하여 테스트가 용이해짐 +- 외부 시스템 변경 시 도메인 로직에 영향을 미치지 않음 +- 아키텍처가 더 명확해짐 \ No newline at end of file From cd60c1210afd3bb656bb3c7d2e1c8060dac4c793 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 02:40:33 +0000 Subject: [PATCH 3/4] =?UTF-8?q?=EA=B2=B0=EC=A0=9C=20=EC=A0=84=ED=99=98=20?= =?UTF-8?q?=EB=AA=A9=ED=91=9C=20=EC=95=84=ED=82=A4=ED=85=8D=EC=B2=98=20?= =?UTF-8?q?=EC=A0=95=EC=9D=98=20(SPRING-ARC-GATE-1783823993)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/architecture/package-map.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 docs/architecture/package-map.md diff --git a/docs/architecture/package-map.md b/docs/architecture/package-map.md new file mode 100644 index 0000000..b2ef219 --- /dev/null +++ b/docs/architecture/package-map.md @@ -0,0 +1,7 @@ +| 패키지 | 책임 | 금지 의존성 | +|-------------|-----------------------------------------|---------------------| +| controller | 사용자 요청 처리 및 응답 반환 | domain, service | +| service | 비즈니스 로직 처리 및 트랜잭션 관리 | repository | +| repository | 데이터 저장소와의 상호작용 | domain | +| domain | 비즈니스 규칙 및 도메인 모델 정의 | integration | +| integration | 외부 시스템과의 통신 (예: 결제 게이트웨이) | domain | \ No newline at end of file From 9a043927cb724bee0c3bbffde23dbd6ac93c92b6 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 02:40:34 +0000 Subject: [PATCH 4/4] =?UTF-8?q?=EA=B2=B0=EC=A0=9C=20=EC=A0=84=ED=99=98=20?= =?UTF-8?q?=EB=AA=A9=ED=91=9C=20=EC=95=84=ED=82=A4=ED=85=8D=EC=B2=98=20?= =?UTF-8?q?=EC=A0=95=EC=9D=98=20(SPRING-ARC-GATE-1783823993)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/architecture/transaction-sequence.md | 25 +++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 docs/architecture/transaction-sequence.md diff --git a/docs/architecture/transaction-sequence.md b/docs/architecture/transaction-sequence.md new file mode 100644 index 0000000..89b6f02 --- /dev/null +++ b/docs/architecture/transaction-sequence.md @@ -0,0 +1,25 @@ +```mermaid +sequenceDiagram + participant User + participant Controller + participant Service + participant Repository + participant PaymentGateway + + User->>Controller: 결제 요청 + Controller->>Service: 결제 처리 요청 + Service->>Repository: 트랜잭션 시작 + alt 정상 흐름 + Service->>PaymentGateway: 결제 요청 + PaymentGateway-->>Service: 결제 성공 + Service->>Repository: 트랜잭션 커밋 + else 외부 실패 + Service->>PaymentGateway: 결제 요청 + PaymentGateway-->>Service: 결제 실패 + Service->>Repository: 트랜잭션 롤백 + else DB 실패 + Service->>Repository: 트랜잭션 시작 + Service->>Repository: DB 오류 발생 + Service->>Repository: 트랜잭션 롤백 + end +``` \ No newline at end of file