From 247201bbb8864a8bd2689b1788029f7c00d09217 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 06:07:22 +0000 Subject: [PATCH 1/5] forge: open work branch for SPRING-ARC-FINDINGS-1783836352-attempt-1-run-ace3a0dc905f --- ...PRING-ARC-FINDINGS-1783836352-attempt-1-run-ace3a0dc905f.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 .forge/SPRING-ARC-FINDINGS-1783836352-attempt-1-run-ace3a0dc905f.md diff --git a/.forge/SPRING-ARC-FINDINGS-1783836352-attempt-1-run-ace3a0dc905f.md b/.forge/SPRING-ARC-FINDINGS-1783836352-attempt-1-run-ace3a0dc905f.md new file mode 100644 index 0000000..ed674e4 --- /dev/null +++ b/.forge/SPRING-ARC-FINDINGS-1783836352-attempt-1-run-ace3a0dc905f.md @@ -0,0 +1,3 @@ +# SPRING-ARC-FINDINGS-1783836352-attempt-1-run-ace3a0dc905f + +Forge 이슈 작업 브랜치 `forge/SPRING-ARC-FINDINGS-1783836352-attempt-1-run-ace3a0dc905f`. From 9b4d4734120af6b648e09e7e51c96fd4e01fa03f Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 06:07:38 +0000 Subject: [PATCH 2/5] =?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-FINDINGS-1783836352)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/architecture/adr-payment-boundary.md | 15 +++++++++++++++ 1 file changed, 15 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..fe9abda --- /dev/null +++ b/docs/architecture/adr-payment-boundary.md @@ -0,0 +1,15 @@ +# 결제 경계 ADR + +## Context +결제 시스템의 경계를 정의하고, 외부 결제 게이트웨이와의 상호작용을 명확히 하기 위해 이 문서를 작성합니다. + +## Decision +결제 도메인은 외부 결제 게이트웨이에 대한 직접적인 참조를 피하고, 포트 인터페이스를 통해서만 상호작용하도록 설계합니다. + +## Alternatives +1. 외부 결제 게이트웨이를 직접 참조하는 방법 +2. 포트 인터페이스를 사용하여 간접적으로 참조하는 방법 (선택됨) + +## Consequences +- 외부 결제 게이트웨이의 변경이 도메인에 미치는 영향을 최소화할 수 있습니다. +- 시스템의 유연성과 유지보수성을 향상시킵니다. \ No newline at end of file From 70529f3e46f04d1238c6be88d9b9967db5e91637 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 06:07:39 +0000 Subject: [PATCH 3/5] =?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-FINDINGS-1783836352)?= 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..15c43dd --- /dev/null +++ b/docs/architecture/package-map.md @@ -0,0 +1,7 @@ +| 패키지 | 책임 | 금지 의존성 | +|--------------|--------------------------------------|-----------------------------| +| controller | 사용자 요청 처리 및 응답 반환 | domain, integration 직접 참조 | +| service | 비즈니스 로직 처리 | repository 직접 참조 | +| repository | 데이터 저장 및 조회 | service 직접 참조 | +| domain | 비즈니스 규칙 및 도메인 모델 정의 | controller, service 직접 참조 | +| integration | 외부 시스템과의 통합 | domain 직접 참조 | \ No newline at end of file From 0f6a310618b0e63941a5eb0bb5f44892971d0234 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 06:19:25 +0000 Subject: [PATCH 4/5] forge: open work branch for iss-d0bdbb1b07fc-attempt-2-run-11c166a4a0e1 --- .forge/iss-d0bdbb1b07fc-attempt-2-run-11c166a4a0e1.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 .forge/iss-d0bdbb1b07fc-attempt-2-run-11c166a4a0e1.md diff --git a/.forge/iss-d0bdbb1b07fc-attempt-2-run-11c166a4a0e1.md b/.forge/iss-d0bdbb1b07fc-attempt-2-run-11c166a4a0e1.md new file mode 100644 index 0000000..5bab659 --- /dev/null +++ b/.forge/iss-d0bdbb1b07fc-attempt-2-run-11c166a4a0e1.md @@ -0,0 +1,3 @@ +# iss-d0bdbb1b07fc-attempt-2-run-11c166a4a0e1 + +Forge 이슈 작업 브랜치 `forge/iss-d0bdbb1b07fc-attempt-2-run-11c166a4a0e1`. From 9735dc34c9ff1bd7810c90d9c15a4afe9f575229 Mon Sep 17 00:00:00 2001 From: forge-bot Date: Sun, 12 Jul 2026 06:19:40 +0000 Subject: [PATCH 5/5] =?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-d0bdbb1b07fc)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/architecture/transaction-sequence.md | 35 +++++++++++++++++++++++ 1 file changed, 35 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..6c81673 --- /dev/null +++ b/docs/architecture/transaction-sequence.md @@ -0,0 +1,35 @@ +--- +# 결제 전환 아키텍처 + +## 트랜잭션 시퀀스 다이어그램 + +```mermaid +sequenceDiagram + participant User + participant PaymentGateway + participant Database + participant Application + + User->>Application: 결제 요청 + Application->>Database: 트랜잭션 시작 + Application->>PaymentGateway: 결제 요청 + alt 정상 흐름 + PaymentGateway-->>Application: 결제 성공 + Application->>Database: 트랜잭션 커밋 + Database-->>Application: 커밋 완료 + Application-->>User: 결제 완료 + else 외부 실패 + PaymentGateway-->>Application: 결제 실패 + Application->>Database: 트랜잭션 롤백 + Database-->>Application: 롤백 완료 + Application-->>User: 결제 실패 + else DB 실패 + Application->>Database: 트랜잭션 롤백 + Database-->>Application: 롤백 실패 + Application-->>User: 시스템 오류 + end +``` + +## 주의사항 +- 외부 결제 gateway는 port interface 뒤에 두고 domain에서 adapter를 직접 참조하지 않는다. +--- \ No newline at end of file