diff --git a/.forge/SPRING-ARC-DONE-1783829491-attempt-1.md b/.forge/SPRING-ARC-DONE-1783829491-attempt-1.md new file mode 100644 index 0000000..dec4d0b --- /dev/null +++ b/.forge/SPRING-ARC-DONE-1783829491-attempt-1.md @@ -0,0 +1,3 @@ +# SPRING-ARC-DONE-1783829491-attempt-1 + +Forge 이슈 작업 브랜치 `forge/SPRING-ARC-DONE-1783829491-attempt-1`. diff --git a/.forge/iss-1b3092823a38-attempt-1.md b/.forge/iss-1b3092823a38-attempt-1.md new file mode 100644 index 0000000..4aa3b04 --- /dev/null +++ b/.forge/iss-1b3092823a38-attempt-1.md @@ -0,0 +1,3 @@ +# iss-1b3092823a38-attempt-1 + +Forge 이슈 작업 브랜치 `forge/iss-1b3092823a38-attempt-1`. diff --git a/docs/architecture/adr-payment-boundary.md b/docs/architecture/adr-payment-boundary.md new file mode 100644 index 0000000..297c8b9 --- /dev/null +++ b/docs/architecture/adr-payment-boundary.md @@ -0,0 +1,19 @@ +# 결제 경계 아키텍처 결정 기록 (ADR) + +## 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..e0c2676 --- /dev/null +++ b/docs/architecture/package-map.md @@ -0,0 +1,9 @@ +# 패키지 맵 + +| 패키지 | 책임 | 금지 의존성 | +|--------------|----------------------------------------------|--------------------------| +| controller | 사용자 요청을 처리하고 응답을 반환함 | domain -> integration | +| service | 비즈니스 로직을 처리하고 트랜잭션을 관리함 | repository -> integration | +| repository | 데이터 저장소와의 상호작용을 담당함 | service -> controller | +| domain | 도메인 모델과 비즈니스 규칙을 정의함 | integration -> domain | +| integration | 외부 시스템과의 통합을 담당함 | domain -> service | \ No newline at end of file diff --git a/docs/architecture/transaction-sequence.md b/docs/architecture/transaction-sequence.md new file mode 100644 index 0000000..6a43240 --- /dev/null +++ b/docs/architecture/transaction-sequence.md @@ -0,0 +1,34 @@ +sequenceDiagram + participant User + participant Payment Service + participant DB + participant External Gateway + + User->>Payment Service: Initiate Payment + activate Payment Service + Payment Service->>DB: Begin Transaction + activate DB + DB-->>Payment Service: Transaction Started + deactivate DB + Payment Service->>External Gateway: Request Payment Authorization + activate External Gateway + + alt Successful Authorization + External Gateway-->>Payment Service: Authorization Success + Payment Service->>DB: Commit Transaction + activate DB + DB-->>Payment Service: Transaction Committed + deactivate DB + Payment Service-->>User: Payment Successful + else Authorization Failed + External Gateway-->>Payment Service: Authorization Failure + Payment Service->>DB: Rollback Transaction + activate DB + DB-->>Payment Service: Transaction Rolled Back + deactivate DB + Payment Service-->>User: Payment Failed + end + +autonumber + +