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`. diff --git a/.forge/iss-d0bdbb1b07fc-attempt-2-run-11c166a4a0e1.md b/.forge/iss-d0bdbb1b07fc-attempt-2-run-11c166a4a0e1.md deleted file mode 100644 index 5bab659..0000000 --- a/.forge/iss-d0bdbb1b07fc-attempt-2-run-11c166a4a0e1.md +++ /dev/null @@ -1,3 +0,0 @@ -# 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 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 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 diff --git a/docs/architecture/transaction-sequence.md b/docs/architecture/transaction-sequence.md deleted file mode 100644 index 6c81673..0000000 --- a/docs/architecture/transaction-sequence.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -# 결제 전환 아키텍처 - -## 트랜잭션 시퀀스 다이어그램 - -```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