From 49d70a9fed10bafc855c0014b7110a772aef5100 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 03:17:09 +0000 Subject: [PATCH 1/4] forge: open work branch for SPRING-ARC-RESILIENT-1783826170-attempt-3 --- .forge/SPRING-ARC-RESILIENT-1783826170-attempt-3.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 .forge/SPRING-ARC-RESILIENT-1783826170-attempt-3.md diff --git a/.forge/SPRING-ARC-RESILIENT-1783826170-attempt-3.md b/.forge/SPRING-ARC-RESILIENT-1783826170-attempt-3.md new file mode 100644 index 0000000..4d5c1bc --- /dev/null +++ b/.forge/SPRING-ARC-RESILIENT-1783826170-attempt-3.md @@ -0,0 +1,3 @@ +# SPRING-ARC-RESILIENT-1783826170-attempt-3 + +Forge 이슈 작업 브랜치 `forge/SPRING-ARC-RESILIENT-1783826170-attempt-3`. -- 2.49.1 From 087eddf4abf41c3742929eaab60ecc27d72c24dc Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 03:17:22 +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-RESILIENT-1783826170)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/architecture/adr-payment-boundary.md | 14 ++++++++++++++ 1 file changed, 14 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..4788278 --- /dev/null +++ b/docs/architecture/adr-payment-boundary.md @@ -0,0 +1,14 @@ +# 결제 경계에 대한 결정 기록 + +## Context +결제 시스템은 사용자에게 다양한 결제 수단을 제공하여 전환율을 높이는 목표를 가지고 있다. 사용자가 결제하는 동안 안정성을 보장하고, 시스템의 확장성과 유지 관리성을 확보해야 한다. + +## Decision +결제를 처리하는 주요 경계는 controller, service, repository, integration으로 정의된다. 외부 결제 게이트웨이는 포트 인터페이스 뒤에 위치해야 하며, 도메인에서 어댑터를 직접 참조하지 않는다. 이는 시스템의 결합도를 낮추고, 테스트 용이성을 높인다. + +## Alternatives +1. 모든 레이어에서 외부 서비스 직접 호출: 이는 결합도를 높이고 테스트를 복잡하게 만든다. +2. 다양한 결제 수단을 위해 여러 서브 도메인 생성: 이는 시스템을 복잡하게 한다. + +## Consequences +현재 결정된 경계에 따라, 결제 전환 목표를 달성하기 위한 기본 아키텍처가 수립됨. 그러나 외부 서비스의 변경이나 결제 방식을 추가할 때 경계가 신중하게 다루어져야 한다. -- 2.49.1 From 948de94c7998d02fb383ed275e3161194aa98660 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 03:17:23 +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-RESILIENT-1783826170)?= 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..9586c6a --- /dev/null +++ b/docs/architecture/package-map.md @@ -0,0 +1,7 @@ +| 패키지 | 책임 | 금지 의존성 | +|------------|----------------------|---------------------------| +| controller | HTTP 요청/응답 처리 | repository 직접 참조 없음 | +| service | 비즈니스 로직 처리 | repository 직접 참조 없음 | +| repository | 데이터 접근 및 저장처리 | service 직접 참조 없음 | +| domain | 비즈니스 도메인 객체 정의 | 외부 서비스 직접 호출 없음 | +| integration | 외부 서비스와의 통합 처리 | 도메인 객체에 대한 직접 의존 없음 | -- 2.49.1 From 79be1fe50756a33f48d500d2c859df6635c44c21 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 03:17:24 +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-RESILIENT-1783826170)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/architecture/transaction-sequence.md | 37 +++++++++++++++++++++++ 1 file changed, 37 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..11baf05 --- /dev/null +++ b/docs/architecture/transaction-sequence.md @@ -0,0 +1,37 @@ +sequenceDiagram + participant User + participant Controller + participant Service + participant Repository + participant Database + participant ExternalGateway + + User->>Controller: 결제 요청 + Controller->>Service: 결제 처리 요청 + Service->>Repository: 결제 정보 저장 요청 + Repository->>Database: 결제 정보 저장 + Database-->>Repository: 저장 성공 + Repository-->>Service: 저장 성공 + Service->>ExternalGateway: 외부 결제 처리 요청 + ExternalGateway-->>Service: 성공 응답 + Service-->>Controller: 결제 성공 응답 + Controller-->>User: 결제 완료 응답 + + %% DB 실패 흐름 + alt DB 실패 + Repository-->>Service: 저장 실패 응답 + Service-->>Controller: 오류 반환 + Controller-->>User: 결제 실패 응답 + end + + %% 외부 실패 흐름 + alt 외부 서비스 실패 + Service->>ExternalGateway: 외부 결제 처리 요청 + ExternalGateway-->>Service: 실패 응답 + Service-->>Controller: 오류 반환 + Controller-->>User: 결제 실패 응답 + end + + %% Commit/Rollback 경계 + note over Repository: 만약 저장이 성공하면 commit + note over Repository: 만약 저장이 실패하면 rollback \ No newline at end of file -- 2.49.1