From 720ee904d214b3afe6df99c136c100428f081eb0 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 07:21:43 +0000 Subject: [PATCH 1/6] forge: open work branch for SPRING-ARC-CONTRACT-1783840884-attempt-2-run-6c571421a404 --- ...PRING-ARC-CONTRACT-1783840884-attempt-2-run-6c571421a404.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 .forge/SPRING-ARC-CONTRACT-1783840884-attempt-2-run-6c571421a404.md diff --git a/.forge/SPRING-ARC-CONTRACT-1783840884-attempt-2-run-6c571421a404.md b/.forge/SPRING-ARC-CONTRACT-1783840884-attempt-2-run-6c571421a404.md new file mode 100644 index 0000000..411122a --- /dev/null +++ b/.forge/SPRING-ARC-CONTRACT-1783840884-attempt-2-run-6c571421a404.md @@ -0,0 +1,3 @@ +# SPRING-ARC-CONTRACT-1783840884-attempt-2-run-6c571421a404 + +Forge 이슈 작업 브랜치 `forge/SPRING-ARC-CONTRACT-1783840884-attempt-2-run-6c571421a404`. From 69c4c1689ef72ddbd9f7cbec9d90bab45412a4f1 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 07:21:55 +0000 Subject: [PATCH 2/6] forge: open work branch for SPRING-ARC-CONTRACT-1783840884-attempt-1-run-31e9254b150a --- ...PRING-ARC-CONTRACT-1783840884-attempt-1-run-31e9254b150a.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 .forge/SPRING-ARC-CONTRACT-1783840884-attempt-1-run-31e9254b150a.md 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`. From 49edb9de8015131d8b5e75345337c8185d9daef6 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 07:22:09 +0000 Subject: [PATCH 3/6] =?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(1/2)=20(SPRING-ARC-CONTRACT-1783840884)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/architecture/adr-payment-boundary.md | 19 +++++++++++++++++++ 1 file changed, 19 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..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 From 1d0f0cd757f13e535065859cbdc9252a6568b261 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 07:22:10 +0000 Subject: [PATCH 4/6] =?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(1/2)=20(SPRING-ARC-CONTRACT-1783840884)?= 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..9f6ee4c --- /dev/null +++ b/docs/architecture/package-map.md @@ -0,0 +1,7 @@ +| 패키지 | 책임 | 금지 의존성 | +|-----------|-----------------------------------------|-----------------------| +| controller | 사용자 요청 처리 및 응답 반환 | 도메인 직접 참조 | +| service | 비즈니스 로직 처리 및 트랜잭션 관리 | 외부 결제 게이트웨이 직접 참조 | +| repository | 데이터 저장소와의 상호작용 | 도메인 직접 참조 | +| domain | 비즈니스 규칙 및 도메인 모델 정의 | 외부 결제 게이트웨이 직접 참조 | +| integration | 외부 시스템과의 통합 및 상호작용 | 도메인 직접 참조 | \ No newline at end of file From ecece77a596dfe140a777530ccad7e19a8b78d3b Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 07:23:03 +0000 Subject: [PATCH 5/6] forge: open work branch for iss-3588e28b9152-attempt-2-run-110ea1627109 --- .forge/iss-3588e28b9152-attempt-2-run-110ea1627109.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 .forge/iss-3588e28b9152-attempt-2-run-110ea1627109.md 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`. From 50567469a43feb54a955d91de66331b0682bbbca Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 07:23:12 +0000 Subject: [PATCH 6/6] =?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(2/2)=20(iss-3588e28b9152)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/architecture/transaction-sequence.md | 31 +++++++++++++++++++++++ 1 file changed, 31 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..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