diff --git a/.forge/LEGACY-REV-1783823015-attempt-1.md b/.forge/LEGACY-REV-1783823015-attempt-1.md deleted file mode 100644 index ed64c7e..0000000 --- a/.forge/LEGACY-REV-1783823015-attempt-1.md +++ /dev/null @@ -1,3 +0,0 @@ -# LEGACY-REV-1783823015-attempt-1 - -Forge 이슈 작업 브랜치 `forge/LEGACY-REV-1783823015-attempt-1`. diff --git a/docs/legacy-payment-contract.md b/docs/legacy-payment-contract.md deleted file mode 100644 index 7dcf621..0000000 --- a/docs/legacy-payment-contract.md +++ /dev/null @@ -1,60 +0,0 @@ -# 레거시 결제 처리 전환 계약 문서 - -## 1. 입력 계약 - -- **고객 요청 정보** - - `사용자 ID`: 고객을 식별하는 고유한 값 - - `결제 금액`: 고객이 결제하고자 하는 금액 - - `결제 방법`: 카드, 송금, 기타 - -## 2. 출력 계약 - -- **결제 처리 결과** - - `결제 상태`: 성공, 실패 - - `오류 코드`: 결제 실패 시 오류를 설명하는 코드(예: 101, 102) - - `거래 ID`: 결제 거래의 고유 식별자 - -## 3. 트랜잭션 경계 - -- **시작**: 사용자가 결제 요청을 제출할 때 -- **종료**: 결제가 성공적으로 처리되거나 오류가 발생하여 롤백 될 때 - -## 4. 오류 매핑 - -| 오류 코드 | 오류 설명 | 해결 방법 | -|------------|--------------------|-------------------------------| -| 101 | 결제 금액 부족 | 금액을 확인 후 재시도 | -| 102 | 카드 정보 오류 | 카드 정보를 다시 확인하기 | -| 103 | 시스템 오류 | 고객 지원에 문의 | - -## 5. 외부 연동 - -- **결제 Gateway 연동** - - 결제 Gateway API를 호출하여 결제를 처리 - - 사용자 인증 및 결제 정보를 API에 전달 -- **고객 알림 서비스 연동** - - 결제 결과를 고객에게 SMS/이메일로 통지 - -## 6. Spring service/repository 매핑 - -- **Service Layer** - - `PaymentService`: 결제 처리를 담당 - - 메서드: `processPayment(request: PaymentRequest): PaymentResponse` -- **Repository Layer** - - `PaymentRepository`: 결제 정보를 DB에 저장 - - 메서드: `save(payment: Payment): void` - -## 7. 검증 체크리스트 - -- [ ] 입력 값이 유효한지 확인 -- [ ] 결제 금액이 0보다 큰지 확인 -- [ ] 결제 방법이 지원되는지 확인 -- [ ] 외부 API 호출 전후에 예외 처리 확인 -- [ ] 결제 처리 내역이 DB에 정상 저장되는지 확인 - ---- - -### 명확하지 않은 가정 -- 고객 요청 정보의 모든 필드는 필수로 제공된다고 가정함 -- 결제 처리 중 발생할 수 있는 각 오류에 대한 구체적인 대응 방안은 추후 논의 필요 -