diff --git a/.forge/SPRING-ARC-FINDINGS-1783836352-attempt-1-run-ace3a0dc905f.md b/.forge/SPRING-ARC-FINDINGS-1783836352-attempt-1-run-ace3a0dc905f.md deleted file mode 100644 index ed674e4..0000000 --- a/.forge/SPRING-ARC-FINDINGS-1783836352-attempt-1-run-ace3a0dc905f.md +++ /dev/null @@ -1,3 +0,0 @@ -# SPRING-ARC-FINDINGS-1783836352-attempt-1-run-ace3a0dc905f - -Forge 이슈 작업 브랜치 `forge/SPRING-ARC-FINDINGS-1783836352-attempt-1-run-ace3a0dc905f`. 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`. diff --git a/docs/architecture/adr-payment-boundary.md b/docs/architecture/adr-payment-boundary.md deleted file mode 100644 index fe9abda..0000000 --- a/docs/architecture/adr-payment-boundary.md +++ /dev/null @@ -1,15 +0,0 @@ -# 결제 경계 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 deleted file mode 100644 index 15c43dd..0000000 --- a/docs/architecture/package-map.md +++ /dev/null @@ -1,7 +0,0 @@ -| 패키지 | 책임 | 금지 의존성 | -|--------------|--------------------------------------|-----------------------------| -| controller | 사용자 요청 처리 및 응답 반환 | domain, integration 직접 참조 | -| service | 비즈니스 로직 처리 | repository 직접 참조 | -| repository | 데이터 저장 및 조회 | service 직접 참조 | -| domain | 비즈니스 규칙 및 도메인 모델 정의 | controller, service 직접 참조 | -| integration | 외부 시스템과의 통합 | domain 직접 참조 | \ 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..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