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`. diff --git a/.forge/iss-3588e28b9152-attempt-1-run-7b6e6bd83c54.md b/.forge/iss-3588e28b9152-attempt-1-run-7b6e6bd83c54.md deleted file mode 100644 index 0f73c0f..0000000 --- a/.forge/iss-3588e28b9152-attempt-1-run-7b6e6bd83c54.md +++ /dev/null @@ -1,3 +0,0 @@ -# iss-3588e28b9152-attempt-1-run-7b6e6bd83c54 - -Forge 이슈 작업 브랜치 `forge/iss-3588e28b9152-attempt-1-run-7b6e6bd83c54`. 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`. 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 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 diff --git a/docs/architecture/transaction-sequence.md b/docs/architecture/transaction-sequence.md index 1c070f8..968a9fb 100644 --- a/docs/architecture/transaction-sequence.md +++ b/docs/architecture/transaction-sequence.md @@ -1,37 +1,31 @@ +--- +# Transaction Sequence + +## Sequence Diagram + ```mermaid sequenceDiagram - participant User as 사용자 - participant PaymentGateway as 결제 게이트웨이 - participant Banking as 은행 - participant System as 시스템 + participant User + participant PaymentGateway + participant Database - User->>System: 결제 요청 - activate System - System->>PaymentGateway: 결제 처리 요청 - activate PaymentGateway - - alt 성공 - PaymentGateway-->>System: 결제 성공 - activate System - System->>Banking: 금액 이체 요청 - activate Banking - Banking-->>System: 이체 성공 - deactivate Banking - System-->>User: 결제 완료 - deactivate System + User->>PaymentGateway: 결제 요청 + alt 정상 흐름 + PaymentGateway-->>User: 결제 승인 + User->>Database: 트랜잭션 저장 + Database-->>User: 저장 완료 + Note right of User: 커밋 else 외부 실패 - PaymentGateway-->>System: 결제 실패 - deactivate PaymentGateway - System-->>User: 결제 실패 메시지 - deactivate System + PaymentGateway-->>User: 결제 실패 + Note right of User: 롤백 else DB 실패 - PaymentGateway-->>System: 결제 처리 중 오류 발생 - deactivate PaymentGateway - System->>System: 롤백 처리 - System-->>User: 결제 처리 실패 및 복원 - deactivate System + User->>Database: 트랜잭션 저장 실패 + Note right of User: 롤백 end +``` - deactivate PaymentGateway - deactivate System -``` \ No newline at end of file +## Commit and Rollback +- 정상 흐름에서 트랜잭션이 성공적으로 저장되면 커밋이 발생합니다. +- 외부 실패 또는 DB 실패 시 롤백이 발생합니다. + +--- \ No newline at end of file