Repository navigation
feat: 환불 계좌 입력·환불 완료와 입금 반환·종결 기록, 탈퇴 차단 - #581
Conversation
① 무엇·왜
- 환불이 생기면 구매자가 돌려받을 계좌를 넣고(취소와 함께 넣을 수도 있다) 관리자가 송금한 뒤 완료로 기록한다. 계좌번호는 암호화해 두고 원문은 관리자 환불 상세에서만 푼다.
- 결제로 확인하지 않은 입금은 주문의 반환 대상으로 연결해 입금액 전액 환불을 만든다. 주문 상태와 관계없이 그 주문의 구매자에게 돌려주며 주문·결제·정산은 건드리지 않는다. 주인 모를 입금은 메모와 함께 종결 기록하고, 나중에 주인을 찾으면 같은 기록을 반환으로 바꿔 같은 돈이 두 번 기록되지 않게 한다.
- 진행 주문(입금 대기~제작 완료)이나 송금이 끝나지 않은 환불(종류 무관)이 있으면 구매자 탈퇴를 막는다. 탈퇴하면 환불 계좌를 받을 수 없다.
- 명세에 없던 결정: 종결 기록을 반환으로 바꾸는 mutation 이름은 adminLinkUnidentifiedDeposit, 오류는 DEPOSIT_RECORD_NOT_FOUND(404)·DEPOSIT_RECORD_ALREADY_LINKED(409). 환불 목록은 처리 순서(오래된 것부터), 입금 기록 목록은 최근 기록부터. 입금 기록 금액 하한(1원)을 기존 DEPOSIT_AMOUNT_INVALID로 거절하도록 메시지를 두 경로에 맞게 바꿨다.
② 변경점
- SDL: submitMyRefundAccount, CancelMyOrderInput.refundAccount(RefundAccountInput), MyOrderDetail.refunds, adminRefunds·adminRefund·adminDepositRecords, adminCompleteRefund·adminCreateDepositReturn·adminRecordUnidentifiedDeposit·adminLinkUnidentifiedDeposit, DepositRecordKindType, AdminTaskCounts.refundsAwaitingAccount·refundsAwaitingTransfer, deleteMyAccount 설명
- RefundRepository: 계좌 입력·덮어쓰기(환불 행 잠금, 송금 완료면 거절) → 송금 대기 + outbox refund.account_submitted, 송금 완료(송금 대기만) + 감사 REFUND + outbox refund.completed, 관리자 목록·상세
- DepositRecordRepository: 반환 연결(주문 잠금 → 입금 기록 → 환불 → refund.requested), 종결 기록, 종결 → 반환 전환(주문 → 입금 기록 잠금), 감사 DEPOSIT_RECORD
- OrderTransitionRepository.cancelLocked: 취소와 함께 받은 계좌로 환불을 바로 송금 대기로 만든다(환불이 없으면 버린다)
- 이벤트: refund.requested에 accountSubmitted(없던 이벤트는 false), refund.account_submitted·refund.completed 신설(공통 payload)
- 알림: 계좌가 이미 있는 refund.requested는 구매자 계좌 요청 대신 관리자 경보, refund.account_submitted도 관리자 경보(key refund-ready:{refundId}, info, /tasks/refunds 딥링크), refund.completed는 구매자 REFUND_COMPLETED 알림
- 탈퇴 차단: common 포트 WithdrawalBlockingOrderQuery(abstract class), order 구현 OrderWithdrawalBlockingRepository, auth는 첫 호출 때 ModuleRef(strict: false)로 찾고 ACCOUNT_HAS_ACTIVE_ORDERS(409, 건수)로 거절. guide §1(c)에 포트 추가
- 에러 7종(REFUND_NOT_FOUND·REFUND_NOT_READY·REFUND_ALREADY_COMPLETED·ACCOUNT_HAS_ACTIVE_ORDERS·DEPOSIT_NOTE_REQUIRED·DEPOSIT_RECORD_NOT_FOUND·DEPOSIT_RECORD_ALREADY_LINKED), 게이트: ADMIN_QUERY_COUNT 20, roles-coverage admin 74, enum-sdl-sync DepositRecordKind, module-wiring 탈퇴 차단 포트 resolve(api·ws·worker), 팩토리 createRefund
③ 테스트
- 관리자 환불: null 필터 = 전체·상태×종류 AND·키셋, 상세 원문 복호화·입금 기록, 송금 완료(처리자·메모·감사·구매자 알림), 계좌 입력 전·완료 뒤 거절과 무변경
- 입금 반환: 취소 환불과 공존·주문·결제·정산 불변, 주문 상태 6종 연결, 처리자 라벨 null 관리자, 입력 오류 6경우, 삭제된 주문
- 종결·전환: 메모 필수(빈 문자열·공백), 환불·이벤트 없음, 같은 기록 전환·감사 UPDATE, 이미 반환·없는 기록·없는 주문
- 구매자: 취소와 함께 계좌(송금 대기·암호문 복호화·accountSubmitted), 환불 없는 취소는 계좌를 버림, 계좌 형식 오류면 취소 안 함, 입력·덮어쓰기, 완료 뒤 거절, 남의·삭제된 주문 환불, 상세 refunds 순서
- 탈퇴: 상태 7종 표, 미완료 반환(계좌 입력 대기·송금 대기)·진행 주문 합산, 완료 뒤 허용·다른 구매자·삭제 주문 제외
- 소비자: 관리자 경보 key·문구·딥링크·계좌 없는 생성 미전송·억제 창, 구매자 완료 알림·계좌 있는 생성 미알림·재전달 멱등, 이벤트 파서 반증
- 반증: 탈퇴 차단 조건·OrderModule 포트 제공·계좌 있는 생성 건너뛰기를 지우면 해당 테스트 11건이 실패하는 것을 확인
|
Important Review skippedAuto reviews are disabled on base/target branches other than the default branch. Please check the settings in the CodeRabbit UI or the
|
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
🩺 NestJS Doctor — 90/100 (Excellent)진단 529건 (error 14).
architecture / security 상위 항목
|
🧹 knip — dead-code 리포트전체 리포트
|
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 21cc29a8a3
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| const blocking = await this.withdrawalBlocking().countByBuyer(accountId); | ||
| if (blocking > 0) { |
There was a problem hiding this comment.
Serialize the withdrawal check with refund creation
If an administrator creates a deposit return for a canceled order after countByBuyer() returns zero but before softDeleteAccount() commits, withdrawal still succeeds with an unfinished refund. DepositRecordRepository.createReturn() and linkToOrder() lock only the order, while account deletion runs in a separate transaction, so nothing prevents this interleaving. The buyer's sessions are then revoked, leaving an AWAITING_ACCOUNT refund whose account they can no longer submit. Coordinate the check and deletion with refund creation through a shared lock and transaction protocol; merely counting before deletion does not enforce the new withdrawal restriction.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
미반영(기록): 유효함. 막으려면 탈퇴 tx(계정 FOR UPDATE + 잠금 읽기 건수)와 입금 반환 생성(계정 FOR SHARE)이 같은 계정 행을 잠그는 auth·order 공용 잠금 프로토콜이 필요해 이 PR 범위를 넘는 새 장치. 관리자 수동 작업과 구매자 탈퇴가 같은 순간 겹쳐야 생기는 경합이라 후속 #582(탈퇴 검사 직렬화 항목)으로 넘김.
Coverage report
Show new covered files 🐣
Show files with reduced coverage 🔻
Test suite run success6234 tests passing in 433 suites. Report generated by 🧪jest coverage report action from 21cc29a |
Codecov Report❌ Patch coverage is
📢 Thoughts on this report? Let us know! |
개요
환불이 생긴 뒤의 흐름(구매자 계좌 입력 → 관리자 송금 → 완료 기록)과, 결제로 확인하지 않은 입금의 반환 연결·종결 기록, 돌려줄 돈이 남은 구매자의 탈퇴 차단을 넣습니다.
submitMyRefundAccount로 계좌를 넣고(송금 완료 전이면 덮어쓰기), 취소할 때cancelMyOrder.refundAccount로 한 번에 넣을 수도 있습니다. 계좌가 들어오면 환불이 송금 대기가 되고 관리자에게 디스코드 알림이 갑니다.adminRefunds·adminRefund로 송금할 계좌를 보고adminCompleteRefund로 완료를 기록합니다. 계좌번호 원문은adminRefund에서만 복호화합니다.adminCreateDepositReturn으로 주문에 연결하면 입금 기록(RETURN)과 입금액 전액 환불이 생깁니다. 주문 상태와 관계없이 연결할 수 있고 주문·결제·정산은 바꾸지 않습니다.adminRecordUnidentifiedDeposit으로 메모와 함께 종결합니다. 나중에 주인을 찾으면adminLinkUnidentifiedDeposit이 같은 기록을 반환으로 바꿉니다(같은 돈을 두 번 기록하지 않습니다).deleteMyAccount가ACCOUNT_HAS_ACTIVE_ORDERS(409)로 거절합니다.변경 사항
submitMyRefundAccount(input: { refundId, bankCode, accountHolder, accountNumber }): MyOrderDetail!FOR UPDATE로 잠그고 본인 주문(삭제되지 않은 것)의 환불인지 같은 문장에서 확인합니다. 아니면REFUND_NOT_FOUND(404)입니다.AWAITING_TRANSFER·account_submitted_at을 갱신합니다. 완료 뒤면REFUND_ALREADY_COMPLETED(409)입니다.refund.account_submitted를 남깁니다.CancelMyOrderInput.refundAccount: RefundAccountInputcancelLocked가 환불을 처음부터 송금 대기로 만들고, 환불이 없는 취소(입금 대기)면 계좌를 버립니다.MyOrderDetail.refunds: [OrderRefund!]!(취소 환불·입금 반환, 오래된 순). 상세 조회가 이미 환불을 읽고 있어toOrderRefund를 그대로 씁니다.normalizeBankAccount)입니다. 은행 코드(INVALID_BANK_CODE), 하이픈을 뺀 숫자 820자리(50자(INVALID_ACCOUNT_NUMBER), 예금주 1TEXT_REQUIRED·TEXT_TOO_LONG)이고, 암호화 용도(AAD)는refund-account입니다.order-refund-admin.graphql,AdminRefundService)adminRefunds(input: { limit, cursor, status, kind }): 처리 순서대로 오래된 환불부터, id 키셋입니다.status·kind가 null이면 전체입니다. 주문번호·주문자 이름·연락처(계좌 입력 대기 연락용)·첫 품목 스냅샷과 처리자 라벨·메모가 함께 옵니다.adminRefund(refundId): AdminRefundDetail { refund accountNumber depositRecord }: 계좌번호 원문과, 입금 반환이면 그 입금 기록을 줍니다. 목록 타입에 원문 칸을 두지 않으려고 상세를 감싼 타입으로 나눴습니다.adminCompleteRefund(input: { refundId, note })REFUND_NOT_READY(400), 이미 끝났으면REFUND_ALREADY_COMPLETED(409)입니다.ctx.displayLabel)·메모, 감사REFUND/STATUS_CHANGE(끝 4자리만), outboxrefund.completed를 같은 tx에 남깁니다.adminDepositRecords(input: { limit, cursor, kind }): 최근 기록부터created_at·id 복합 커서입니다([kind, created_at]인덱스).kind가 null이면 전체입니다.adminCreateDepositReturn(input: { orderId, amount, depositorName, depositedAt, note })FOR UPDATE→ 입금 기록(RETURN, 처리자 라벨 스냅샷) → 환불(DEPOSIT_RETURN, 입금액 전액, 계좌 입력 대기) → outboxrefund.requested→ 감사DEPOSIT_RECORD/CREATE순서입니다.DEPOSIT_AMOUNT_INVALID, 입금자명은 1~50자(은행 앱 표기라 결제 입금자명 20자보다 길게), 없거나 삭제된 주문은ORDER_NOT_FOUND입니다.adminRecordUnidentifiedDeposit(input: { amount, depositorName, depositedAt, note }): 메모가 비면DEPOSIT_NOTE_REQUIRED입니다. 환불·이벤트 없이 입금 기록(UNIDENTIFIED)과 감사만 남깁니다.adminLinkUnidentifiedDeposit(input: { depositRecordId, orderId })refund.requested, 감사DEPOSIT_RECORD/UPDATE(전후 스냅샷)를 남깁니다.DEPOSIT_RECORD_ALREADY_LINKED(409), 없는 기록이면DEPOSIT_RECORD_NOT_FOUND(404)입니다.AdminTaskCounts에refundsAwaitingAccount·refundsAwaitingTransfer(종류 무관)를 더했습니다.refund.requestedpayload에accountSubmitted를 더했습니다. 이 필드가 없던 이벤트는 false로 읽습니다.refund.account_submitted·refund.completed를 신설했습니다. 세 이벤트가 같은 공통 payload(환불·주문·구매자·첫 품목 스냅샷)와 파서를 씁니다.OrderAdminAlertConsumer, info): 계좌가 이미 있는refund.requested와refund.account_submitted가 '환불 송금 대기'를 보냅니다.refund-ready:{refundId}, 딥링크/tasks/refunds?refundId=(ADMIN_WEB_BASE_URL이 있을 때), 계좌번호는 싣지 않습니다.refund.requested는REFUND_ACCOUNT_REQUESTED를 만들지 않습니다.refund.completed는REFUND_COMPLETED'{주문번호} {금액}원 환불이 완료되었어요.'를 만듭니다.src/common/ports/withdrawal-blocking-order.port.ts의 abstract classWithdrawalBlockingOrderQuery.countByBuyer(accountId)입니다.OrderWithdrawalBlockingRepository로 구현합니다. 진행 주문 수와, 삭제되지 않은 주문의 송금 미완료 환불 수를 더합니다.UserProfileService가 첫 호출 때ModuleRef.get(…, { strict: false })로 찾습니다.module-wiring.spec이 api·ws·worker 역할에서 토큰이 resolve되는지 봅니다.ACCOUNT_HAS_ACTIVE_ORDERS(409)는 '진행 중인 주문 또는 환불 {count}건이 있어 탈퇴할 수 없습니다.' 함수형 메시지입니다.REFUND_NOT_FOUND(404),REFUND_NOT_READY(400),REFUND_ALREADY_COMPLETED(409),ACCOUNT_HAS_ACTIVE_ORDERS(409),DEPOSIT_NOTE_REQUIRED(400),DEPOSIT_RECORD_NOT_FOUND(404),DEPOSIT_RECORD_ALREADY_LINKED(409)DEPOSIT_AMOUNT_INVALID메시지를 입금 확인(0 허용)과 입금 기록(1 이상) 두 경로에 맞는 문장으로 바꿨습니다.admin-query-null-inputsADMIN_QUERY_COUNT18 → 20(adminRefunds·adminDepositRecords)roles-coverageadmin 접두 루트 필드 67 → 74enum-sdl-sync에DepositRecordKind↔DepositRecordKindTypecreateRefund(입금 반환이면 입금 기록 동반, 송금 대기·완료면 계좌 칸 채움)테스트
status·kindnull = 전체(오래된 순, 주문·연락처·첫 품목 스냅샷), 상태 × 종류 AND 필터와 키셋 두 페이지, 잘못된 커서drainOutbox뒤 구매자REFUND_COMPLETED알림REFUND_NOT_READY, 완료 뒤REFUND_ALREADY_COMPLETED(두 경우 모두 행·감사·outbox 무변경), 없는 환불, 메모 501자refund.requested(accountSubmitted: false),drainOutbox뒤 구매자 계좌 요청 알림DEPOSIT_NOTE_REQUIRED, 종결은 환불·이벤트 없이 기록·감사만kindnull = 전체, 같은created_at은 id 역순, 커서 두 페이지, 종류 필터, 잘못된 커서refund.requested의accountSubmitted: trueREFUND_NOT_FOUND, 계좌번호 형식 오류refunds가 취소 환불·입금 반환을 생긴 순서대로 실음submitMyRefundAccountadmin-query-null-inputs(20개 Query에 null 입력 무오류),roles-coverage,enum-sdl-sync,module-wiring,audit-write-path,model-ownership,read-boundary,seed-reset-scope,role-routes,audit-target-type-sync,removed-schema-elements통과OrderModule의 탈퇴 차단 포트 제공을 빼면module-wiring세 역할refund.requested건너뛰기를 빼면 알림 소비자 테스트dto:check(strict 포함)·docs:check·arch:check통과. 전체 jest는 pre-push에서 돕니다.플랜 대조
submitMyRefundAccount(refundId, 계좌)완료 전 덮어쓰기 허용 → AWAITING_TRANSFER, outboxrefund.account_submittedcancelMyOrder.refundAccount로 취소와 함께 계좌 입력(BE-05에서 넘어온CancelMyOrderInput.refundAccount: RefundAccountInput)adminCompleteRefund(refundId, note?)는 AWAITING_TRANSFER만(REFUND_NOT_READY) COMPLETED, outboxrefund.completedadminCreateDepositReturn(orderId, amount, depositorName, depositedAt?, note?)주문 FOR UPDATE → DepositRecord(RETURN) → Refund(DEPOSIT_RETURN, 입금액 전액, AWAITING_ACCOUNT) →refund.requested, 주문 상태·결제액·정산 불변adminRecordUnidentifiedDeposit(amount, depositorName, depositedAt?, note!)DepositRecord(UNIDENTIFIED), 감사DEPOSIT_RECORD/CREATEadminLinkUnidentifiedDeposit)src/common/ports/withdrawal-blocking-order.port.tsabstract classWithdrawalBlockingOrderQuery.countByBuyer, order 구현(진행 주문 + 미완료 환불, 종류 무관), auth는 첫 호출 때moduleRef.get(…, { strict: false })module-wiring.spec에 추가,deleteMyAccount가ACCOUNT_HAS_ACTIVE_ORDERS(409)로 거절DepositRecordKindType,SubmitMyRefundAccountInput, MutationsubmitMyRefundAccount·adminCompleteRefund·adminCreateDepositReturn·adminRecordUnidentifiedDeposit, QueryadminRefunds(status, kind, cursor)·adminRefund(refundId)·adminDepositRecords(kind, cursor)input객체)adminTaskCounts환불 필드(refundsAwaitingAccount·refundsAwaitingTransfer)ADMIN_QUERY_COUNT+2(adminRefunds·adminDepositRecords)MyOrderDetail.refundsrefund.account_submitted→ 관리자 경보(keyrefund-ready:{refundId},adminTaskLink(baseUrl, '/tasks/refunds', …), info)refund.requested소비: 계좌가 이미 있는 환불이면 구매자REFUND_ACCOUNT_REQUESTED대신 관리자 경보(BE-05에서 넘어옴)refund.completed→ 구매자REFUND_COMPLETED'{금액}원 환불이 완료되었어요.'(앞에 주문번호)refund-account용도로 암호화, 표시는 끝 4자리, 원문 복호화는adminRefund에서만INVALID_BANK_CODE), 숫자 820(50자INVALID_ACCOUNT_NUMBER), 예금주 1*_by_label_snapshot만 읽고ctx.displayLabel로 채움completed_by_label_snapshot·recorded_by_label_snapshot)admin-query-null-inputs·roles-coverage·enum-sdl-sync·module-wiring·audit-write-path등)REFUND_NOT_READY(400),REFUND_NOT_FOUND(404),REFUND_ALREADY_COMPLETED(409),ACCOUNT_HAS_ACTIVE_ORDERS(409, 함수형),DEPOSIT_NOTE_REQUIRED(400)status·kindnull 입력 = 전체admin-query-null-inputs)adminRefunds)·건수(adminTaskCounts)