Skip to content

feat: 환불 계좌 입력·환불 완료와 입금 반환·종결 기록, 탈퇴 차단 - #581

Merged
chanwoo7 merged 1 commit into
developfrom
feat/refund-processing
Nov 18, 2026
Merged

chanwoo7 merged 1 commit into
developfrom
feat/refund-processing

Conversation

@chanwoo7

Copy link
Copy Markdown
Member

개요

환불이 생긴 뒤의 흐름(구매자 계좌 입력 → 관리자 송금 → 완료 기록)과, 결제로 확인하지 않은 입금의 반환 연결·종결 기록, 돌려줄 돈이 남은 구매자의 탈퇴 차단을 넣습니다.

  • 구매자는 submitMyRefundAccount로 계좌를 넣고(송금 완료 전이면 덮어쓰기), 취소할 때 cancelMyOrder.refundAccount로 한 번에 넣을 수도 있습니다. 계좌가 들어오면 환불이 송금 대기가 되고 관리자에게 디스코드 알림이 갑니다.
  • 관리자는 처리 대기 허브(AD-4)에서 adminRefunds·adminRefund로 송금할 계좌를 보고 adminCompleteRefund로 완료를 기록합니다. 계좌번호 원문은 adminRefund에서만 복호화합니다.
  • 결제로 확인하지 않은 입금은 두 갈래입니다.
    • 돌려줄 입금: adminCreateDepositReturn으로 주문에 연결하면 입금 기록(RETURN)과 입금액 전액 환불이 생깁니다. 주문 상태와 관계없이 연결할 수 있고 주문·결제·정산은 바꾸지 않습니다.
    • 주인 모를 입금: adminRecordUnidentifiedDeposit으로 메모와 함께 종결합니다. 나중에 주인을 찾으면 adminLinkUnidentifiedDeposit이 같은 기록을 반환으로 바꿉니다(같은 돈을 두 번 기록하지 않습니다).
  • 진행 주문(입금 대기~제작 완료)이나 송금이 끝나지 않은 환불(종류 무관)이 있으면 deleteMyAccount가 ACCOUNT_HAS_ACTIVE_ORDERS(409)로 거절합니다.
  • 스키마는 BE-01이 만든 것을 쓰므로 마이그레이션은 없습니다.

변경 사항

  • 구매자 API
    • submitMyRefundAccount(input: { refundId, bankCode, accountHolder, accountNumber }): MyOrderDetail!
      • 환불 행을 FOR UPDATE로 잠그고 본인 주문(삭제되지 않은 것)의 환불인지 같은 문장에서 확인합니다. 아니면 REFUND_NOT_FOUND(404)입니다.
      • 송금 완료 전이면 덮어쓰고 AWAITING_TRANSFER·account_submitted_at을 갱신합니다. 완료 뒤면 REFUND_ALREADY_COMPLETED(409)입니다.
      • 같은 tx에 outbox refund.account_submitted를 남깁니다.
    • CancelMyOrderInput.refundAccount: RefundAccountInput
      • 계좌는 취소 전에 검증·암호화하므로 형식이 틀리면 취소하지 않습니다.
      • 환불이 생기는 취소(접수)면 cancelLocked가 환불을 처음부터 송금 대기로 만들고, 환불이 없는 취소(입금 대기)면 계좌를 버립니다.
    • MyOrderDetail.refunds: [OrderRefund!]!(취소 환불·입금 반환, 오래된 순). 상세 조회가 이미 환불을 읽고 있어 toOrderRefund를 그대로 씁니다.
    • 계좌 검증은 결제 설정·정산 계좌와 같은 helper(normalizeBankAccount)입니다. 은행 코드(INVALID_BANK_CODE), 하이픈을 뺀 숫자 820자리(INVALID_ACCOUNT_NUMBER), 예금주 150자(TEXT_REQUIRED·TEXT_TOO_LONG)이고, 암호화 용도(AAD)는 refund-account입니다.
  • 관리자 API(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)입니다.
      • 완료 시각·처리자 id·라벨 스냅샷(ctx.displayLabel)·메모, 감사 REFUND/STATUS_CHANGE(끝 4자리만), outbox refund.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, 입금액 전액, 계좌 입력 대기) → outbox refund.requested → 감사 DEPOSIT_RECORD/CREATE 순서입니다.
      • 연결 범위는 상태와 관계없이 그 주문입니다(미입금 취소 뒤 늦은 입금, 취소 뒤 입금, 금액이 틀린 입금, 이중 입금).
      • 입금액 1 미만은 DEPOSIT_AMOUNT_INVALID, 입금자명은 1~50자(은행 앱 표기라 결제 입금자명 20자보다 길게), 없거나 삭제된 주문은 ORDER_NOT_FOUND입니다.
    • adminRecordUnidentifiedDeposit(input: { amount, depositorName, depositedAt, note }): 메모가 비면 DEPOSIT_NOTE_REQUIRED입니다. 환불·이벤트 없이 입금 기록(UNIDENTIFIED)과 감사만 남깁니다.
    • adminLinkUnidentifiedDeposit(input: { depositRecordId, orderId })
      • 주문 → 입금 기록 순으로 잠그고 종류를 RETURN으로 바꿔 주문에 잇고, 입금액 전액 환불과 refund.requested, 감사 DEPOSIT_RECORD/UPDATE(전후 스냅샷)를 남깁니다.
      • 이미 반환이면 DEPOSIT_RECORD_ALREADY_LINKED(409), 없는 기록이면 DEPOSIT_RECORD_NOT_FOUND(404)입니다.
    • AdminTaskCounts에 refundsAwaitingAccount·refundsAwaitingTransfer(종류 무관)를 더했습니다.
  • 이벤트·알림
    • refund.requested payload에 accountSubmitted를 더했습니다. 이 필드가 없던 이벤트는 false로 읽습니다.
    • refund.account_submitted·refund.completed를 신설했습니다. 세 이벤트가 같은 공통 payload(환불·주문·구매자·첫 품목 스냅샷)와 파서를 씁니다.
    • 관리자 경보(OrderAdminAlertConsumer, info): 계좌가 이미 있는 refund.requested와 refund.account_submitted가 '환불 송금 대기'를 보냅니다.
      • key 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 class WithdrawalBlockingOrderQuery.countByBuyer(accountId)입니다.
    • order가 OrderWithdrawalBlockingRepository로 구현합니다. 진행 주문 수와, 삭제되지 않은 주문의 송금 미완료 환불 수를 더합니다.
    • OrderModule이 AuthModule을 import해 반대 방향 import는 순환이라, UserProfileService가 첫 호출 때 ModuleRef.get(…, { strict: false })로 찾습니다.
    • guide §1(c) 포트 목록에 추가했고, 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 이상) 두 경로에 맞는 문장으로 바꿨습니다.
  • 명세에 없던 결정
    • 종결 기록을 반환으로 바꾸는 경로((f) 허용)의 이름·입력·오류 코드는 위와 같이 정했습니다.
    • 환불 목록은 처리 순서(오래된 것부터), 입금 기록 목록은 기록 로그라 최근 것부터입니다.
    • 환불 상태 인덱스는 더하지 않았습니다. 플랜 데이터 모델에 없고 환불 건수가 작아 마이그레이션을 늘리지 않았습니다.
  • 게이트·팩토리
    • admin-query-null-inputs ADMIN_QUERY_COUNT 18 → 20(adminRefunds·adminDepositRecords)
    • roles-coverage admin 접두 루트 필드 67 → 74
    • enum-sdl-sync에 DepositRecordKind ↔ DepositRecordKindType
    • 팩토리 createRefund(입금 반환이면 입금 기록 동반, 송금 대기·완료면 계좌 칸 채움)
  • 크기·커밋
    • +3,349/−59줄이고 그중 spec·테스트 인프라가 +1,492줄, SDL이 +419줄입니다. 커밋은 1개입니다.
    • 플랜이 BE-06에 분할 경계를 두지 않아 나누지 않았습니다.

테스트

  • 관리자 환불(real DB)
    • status·kind null = 전체(오래된 순, 주문·연락처·첫 품목 스냅샷), 상태 × 종류 AND 필터와 키셋 두 페이지, 잘못된 커서
    • 상세: 계좌번호 원문 복호화와 입금 기록, 계좌 입력 전 취소 환불은 원문·입금 기록 null, 없는 환불 404
    • 송금 완료: 상태·처리자·라벨·메모(trim)·감사(끝 4자리)·outbox, drainOutbox 뒤 구매자 REFUND_COMPLETED 알림
    • 계좌 입력 전 REFUND_NOT_READY, 완료 뒤 REFUND_ALREADY_COMPLETED(두 경우 모두 행·감사·outbox 무변경), 없는 환불, 메모 501자
  • 입금 반환(real DB)
    • 취소 환불이 있는 주문에 연결하면 두 환불이 공존하고, 주문(상태·취소 시각·정산 기준액·수수료·확정 시각)과 결제 행이 연결 전과 같음
    • 기록·환불·감사·refund.requested(accountSubmitted: false), drainOutbox 뒤 구매자 계좌 요청 알림
    • 주문 상태 6종(입금 대기~노쇼)에 연결해도 상태 불변
    • 처리자 라벨을 만들 수 없는 관리자(이름·아이디 없음)의 기록은 라벨 null
    • 입력 오류 6경우(입금액 0·음수, 입금자명 공백·51자, 메모 501자, 없는 주문)와 삭제된 주문은 기록·환불 없음
  • 종결·전환(real DB)
    • 종결 메모 빈 문자열·공백은 DEPOSIT_NOTE_REQUIRED, 종결은 환불·이벤트 없이 기록·감사만
    • 전환은 같은 기록을 RETURN으로 바꾸고 환불·감사 UPDATE(전후)·이벤트를 남김, 이미 반환·없는 기록·없는 주문 거절
    • 입금 기록 목록: kind null = 전체, 같은 created_at은 id 역순, 커서 두 페이지, 종류 필터, 잘못된 커서
  • 구매자(real DB)
    • 취소와 함께 계좌: 송금 대기·마스킹·암호문 복호화 값·refund.requested의 accountSubmitted: true
    • 환불 없는 취소(입금 대기)는 계좌를 버림, 계좌 형식 오류면 취소하지 않음
    • 계좌 입력 → 덮어쓰기(값·입력 시각 갱신, 이벤트 2건과 payload), 완료 뒤 거절(계좌·outbox 무변경)
    • 다른 계정·삭제된 주문의 환불·없는 환불은 REFUND_NOT_FOUND, 계좌번호 형식 오류
    • 상세 refunds가 취소 환불·입금 반환을 생긴 순서대로 실음
  • 탈퇴(real DB): 주문 상태 7종 표(진행 4종만 차단), 끝난 주문의 미완료 입금 반환(계좌 입력 대기·송금 대기) 차단과 진행 주문 합산 건수 메시지, 송금 완료 뒤 허용, 다른 구매자·삭제된 주문 제외
  • 소비자·이벤트
    • 관리자 경보: 계좌 있는 생성·나중 입력 두 경로의 key·문구·딥링크, 계좌 없는 생성 무전송, 같은 환불 덮어쓰기는 억제 창 안 1회·입금 반환 종류 문구, 형식 오류 반증
    • 구매자 알림 소비자: 계좌 있는 생성 무알림, 완료 알림 저장·재전달 멱등, 형식 오류 반증
    • 이벤트 생성·파싱(계좌 입력 여부 true·false·없음), 두 신설 이벤트 공통 payload와 이벤트 이름이 든 형식 오류
  • 리졸버: 환불 목록·상세·송금 완료, 입금 반환·종결·전환·입금 기록 목록, submitMyRefundAccount
  • 게이트: admin-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 통과
  • 반증: 아래를 깨면 해당 테스트 11건이 실패하는 것을 확인했습니다.
    • OrderModule의 탈퇴 차단 포트 제공을 빼면 module-wiring 세 역할
    • 탈퇴 차단 조건을 무력화하면 탈퇴 테스트 7건
    • 계좌 있는 refund.requested 건너뛰기를 빼면 알림 소비자 테스트
  • 경로 지정 실행: order·notification·auth feature 114 스위트 2,254건, 게이트 12 스위트 352건 통과. 마지막 정리 뒤 영향 스위트 5개 125건 재실행 통과
  • 정적 검사: lint·tsc·dto:check(strict 포함)·docs:check·arch:check 통과. 전체 jest는 pre-push에서 돕니다.

플랜 대조

플랜 항목 BE-06 불릿 상태
6절 환불: submitMyRefundAccount(refundId, 계좌) 완료 전 덮어쓰기 허용 → AWAITING_TRANSFER, outbox refund.account_submitted 한 것
6절 환불: cancelMyOrder.refundAccount로 취소와 함께 계좌 입력(BE-05에서 넘어온 CancelMyOrderInput.refundAccount: RefundAccountInput) 한 것
6절 환불: adminCompleteRefund(refundId, note?)는 AWAITING_TRANSFER만(REFUND_NOT_READY) COMPLETED, outbox refund.completed 한 것
6절 입금 반환: adminCreateDepositReturn(orderId, amount, depositorName, depositedAt?, note?) 주문 FOR UPDATE → DepositRecord(RETURN) → Refund(DEPOSIT_RETURN, 입금액 전액, AWAITING_ACCOUNT) → refund.requested, 주문 상태·결제액·정산 불변 한 것
6절 입금 반환 연결 범위 (c): 상태와 관계없이 그 주문, 금액은 본 입금액 전액 한 것
6절 종결: adminRecordUnidentifiedDeposit(amount, depositorName, depositedAt?, note!) DepositRecord(UNIDENTIFIED), 감사 DEPOSIT_RECORD/CREATE 한 것
6절 종결 기록의 반환 전환 (f): 기록을 골라 주문에 연결하면 RETURN으로 바뀌고 환불 요청이 생김 한 것(adminLinkUnidentifiedDeposit)
6절 탈퇴 차단: src/common/ports/withdrawal-blocking-order.port.ts abstract class WithdrawalBlockingOrderQuery.countByBuyer, order 구현(진행 주문 + 미완료 환불, 종류 무관), auth는 첫 호출 때 moduleRef.get(…, { strict: false }) 한 것
6절 탈퇴 차단: guide §1(c)와 module-wiring.spec에 추가, deleteMyAccount가 ACCOUNT_HAS_ACTIVE_ORDERS(409)로 거절 한 것
6절 SDL: DepositRecordKindType, SubmitMyRefundAccountInput, Mutation submitMyRefundAccount·adminCompleteRefund·adminCreateDepositReturn·adminRecordUnidentifiedDeposit, Query adminRefunds(status, kind, cursor)·adminRefund(refundId)·adminDepositRecords(kind, cursor) 한 것(목록 Query는 1절대로 input 객체)
adminTaskCounts 환불 필드(refundsAwaitingAccount·refundsAwaitingTransfer) 한 것
ADMIN_QUERY_COUNT +2(adminRefunds·adminDepositRecords) 한 것(18 → 20)
BE-04에서 넘어온 5절 SDL MyOrderDetail.refunds 한 것
9절 refund.account_submitted → 관리자 경보(key refund-ready:{refundId}, adminTaskLink(baseUrl, '/tasks/refunds', …), info) 한 것
9절 refund.requested 소비: 계좌가 이미 있는 환불이면 구매자 REFUND_ACCOUNT_REQUESTED 대신 관리자 경보(BE-05에서 넘어옴) 한 것
9절 refund.completed → 구매자 REFUND_COMPLETED '{금액}원 환불이 완료되었어요.'(앞에 주문번호) 한 것
8절 계좌 암호화: 환불 계좌는 refund-account 용도로 암호화, 표시는 끝 4자리, 원문 복호화는 adminRefund에서만 한 것
8절 계좌 검증: 은행 코드 상수(INVALID_BANK_CODE), 숫자 820(INVALID_ACCOUNT_NUMBER), 예금주 150자 한 것
1절 처리자 표시는 *_by_label_snapshot만 읽고 ctx.displayLabel로 채움 한 것(completed_by_label_snapshot·recorded_by_label_snapshot)
1절 목록 키셋, nullable 필터 명시적 null = 전체 한 것
1절 게이트 갱신(admin-query-null-inputs·roles-coverage·enum-sdl-sync·module-wiring·audit-write-path 등) 한 것(model-ownership·read-boundary·seed-reset-scope·audit-target-type-sync는 늘어난 대상이 없어 그대로 통과)
13절 에러 REFUND_NOT_READY(400), REFUND_NOT_FOUND(404), REFUND_ALREADY_COMPLETED(409), ACCOUNT_HAS_ACTIVE_ORDERS(409, 함수형), DEPOSIT_NOTE_REQUIRED(400) 한 것
테스트: 덮어쓰기·완료 뒤 거절 한 것
테스트: status·kind null 입력 = 전체 한 것(서비스 spec + admin-query-null-inputs)
테스트: 처리자 라벨 null인 관리자의 입금 기록 한 것
테스트: 반환이 취소 환불과 공존·주문·정산 불변 한 것
테스트: 종결 메모 필수 한 것
테스트: 탈퇴(진행·미완료 반환·완료 뒤 허용) 한 것
테스트: api·ws resolve 한 것(worker 포함)
결정 이 PR에서 한 일 상태
D11 구매자 환불 계좌 입력(취소와 함께·나중에·덮어쓰기) → 관리자 송금 → 완료 기록, 관리자 대리 입력 없음 한 것
D16 환불 계좌번호 암호화 저장, 원문은 관리자 환불 상세에서만 한 것
D25 진행 주문(입금 대기~제작 완료)이 있으면 탈퇴 거절 한 것
D26 구매자 인앱 알림: 환불 완료, 계좌를 이미 넣은 환불은 계좌 요청 생략 한 것
D27 관리자 할 일 '환불 계좌 입력됨': 디스코드 경보 + 처리 대기 목록(adminRefunds)·건수(adminTaskCounts) 한 것('매칭 실패'는 D70으로 해당 없음)
D71 돌려줄 입금을 주문에 반환 대상으로 연결해 입금액 전액 환불, 주인 모를 입금은 메모와 함께 종결 기록 한 것(금액이 틀린 입금의 입금 확인 거절은 BE-04)
D72 환불 미완료(계좌 미입력·송금 대기)도 탈퇴 거절 한 것

① 무엇·왜
- 환불이 생기면 구매자가 돌려받을 계좌를 넣고(취소와 함께 넣을 수도 있다) 관리자가 송금한 뒤 완료로 기록한다. 계좌번호는 암호화해 두고 원문은 관리자 환불 상세에서만 푼다.
- 결제로 확인하지 않은 입금은 주문의 반환 대상으로 연결해 입금액 전액 환불을 만든다. 주문 상태와 관계없이 그 주문의 구매자에게 돌려주며 주문·결제·정산은 건드리지 않는다. 주인 모를 입금은 메모와 함께 종결 기록하고, 나중에 주인을 찾으면 같은 기록을 반환으로 바꿔 같은 돈이 두 번 기록되지 않게 한다.
- 진행 주문(입금 대기~제작 완료)이나 송금이 끝나지 않은 환불(종류 무관)이 있으면 구매자 탈퇴를 막는다. 탈퇴하면 환불 계좌를 받을 수 없다.
- 명세에 없던 결정: 종결 기록을 반환으로 바꾸는 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건이 실패하는 것을 확인
@coderabbitai

coderabbitai Bot commented Nov 18, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-18T21:57:30.813085Z 21cc29a PR opened
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions

Copy link
Copy Markdown

🩺 NestJS Doctor — 90/100 (Excellent)

진단 529건 (error 14).

Category error warning info
architecture 2 2 46
correctness 0 285 0
performance 0 44 29
schema 0 0 87
security 12 22 0
architecture / security 상위 항목
  • error security/security/no-hardcoded-secrets: Variable 'SEED_PASSWORD' appears to contain a hardcoded secret.
  • error architecture/architecture/no-manual-instantiation: Manual instantiation of 'AccountNumberReencryptRepository' detected. Use dependency injection instead.
  • warning security/security/no-weak-crypto: Weak hashing algorithm 'md5' used in createHash().
  • error architecture/architecture/no-manual-instantiation: Manual instantiation of 'OutboxRepository' detected. Use dependency injection instead.
  • info architecture/architecture/no-barrel-export-internals: Barrel file re-exports internal type 'IAuditLogRepository'.
  • warning security/security/no-exposed-env-vars: Direct 'process.env.NODE_ENV' access in 'AuthController'. Use ConfigService instead.
  • warning security/security/require-guards-on-endpoints: Endpoint 'start' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'callback' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'refresh' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'logout' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'sellerLogin' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'sellerRefresh' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'sellerLogout' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'devIssueToken' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'adminLogin' has no @UseGuards() at class or method level.

오탐 포함 가능 · 기준 docs/guide/architecture-conventions.md

@github-actions

Copy link
Copy Markdown

🧹 knip — dead-code 리포트

Unused exports (1)
Unused exported types (3)
전체 리포트
Unused exports (1)
effectiveLeadTimeMinutes  src/features/store/index.ts:12:10
Unused exported types (3)
ProductCustomIssue  type  src/features/product/index.ts:11:8
ThreeDDesignSource  type  src/features/product/index.ts:16:8
ThreeDDesignV1      type  src/features/product/index.ts:17:8

청소 후보(오탐 가능) · 기준 docs/guide/architecture-conventions.md

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 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".

Comment on lines +201 to +202
const blocking = await this.withdrawalBlocking().countByBuyer(accountId);
if (blocking > 0) {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge 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 👍 / 👎.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

미반영(기록): 유효함. 막으려면 탈퇴 tx(계정 FOR UPDATE + 잠금 읽기 건수)와 입금 반환 생성(계정 FOR SHARE)이 같은 계정 행을 잠그는 auth·order 공용 잠금 프로토콜이 필요해 이 PR 범위를 넘는 새 장치. 관리자 수동 작업과 구매자 탈퇴가 같은 순간 겹쳐야 생기는 경합이라 후속 #582(탈퇴 검사 직렬화 항목)으로 넘김.

@github-actions

Copy link
Copy Markdown

Coverage report

St.❔
Category Percentage Covered / Total
🟢 Statements
98.38% (+0.04% 🔼)
12724/12934
🟢 Branches
93.97% (+0.18% 🔼)
5001/5322
🟢 Functions
97.96% (+0.01% 🔼)
2547/2600
🟢 Lines
98.86% (+0.02% 🔼)
11579/11713
Show new covered files 🐣
St.❔
File Statements Branches Functions Lines
🟢
... / withdrawal-blocking-order.port.ts
100% 100% 100% 100%
🟢
... / deposit-record.repository.ts
100% 100% 100% 100%
🟢
... / refund.repository.ts
100% 100% 100% 100%
🟢
... / refund-account-submitted.event.ts
100% 100% 100% 100%
🟢
... / refund-completed.event.ts
100% 100% 100% 100%
🟢
... / order-withdrawal-blocking.repository.ts
100% 100% 100% 100%
🟢
... / refund-account.input.ts
100% 100% 100% 100%
🟢
... / submit-my-refund-account.input.ts
100% 100% 100% 100%
🟢
... / order-refund-admin-mutation.resolver.ts
100% 100% 100% 100%
🟢
... / admin-complete-refund.input.ts
100% 100% 100% 100%
🟢
... / admin-create-deposit-return.input.ts
100% 100% 100% 100%
🟢
... / admin-link-unidentified-deposit.input.ts
100% 100% 100% 100%
🟢
... / admin-record-unidentified-deposit.input.ts
100% 100% 100% 100%
🟢
... / order-refund-admin.service.ts
100% 100% 100% 100%
🟢
... / order-refund-mappers.helper.ts
100% 100% 100% 100%
🟢
... / order-refund-admin-query.resolver.ts
100% 100% 100% 100%
🟢
... / admin-deposit-record-list.input.ts
100% 100% 100% 100%
🟢
... / admin-refund-list.input.ts
100% 100% 100% 100%
Show files with reduced coverage 🔻
St.❔
File Statements Branches Functions Lines
🟢
... / cancel-my-order.input.ts
87.5% (-12.5% 🔻)
100%
0% (-100% 🔻)
87.5% (-12.5% 🔻)

Test suite run success

6234 tests passing in 433 suites.

Report generated by 🧪jest coverage report action from 21cc29a

@codecov

codecov Bot commented Nov 18, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 99.71591% with 1 line in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
...features/order/dto/inputs/cancel-my-order.input.ts 80.00% 1 Missing ⚠️

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant