Skip to content

chore: 릴리즈 — 커스텀 주문·계좌이체 결제·정산 관리 화면 - #90

Merged
chanwoo7 merged 18 commits into
mainfrom
develop
Nov 19, 2026
Merged

chanwoo7 merged 18 commits into
mainfrom
develop

Conversation

@chanwoo7

Copy link
Copy Markdown
Member

#86~#89 릴리즈입니다. BE 릴리즈(#588 커스텀 케이크 주문·계좌이체 결제·취소·환불·정산)에 맞춘 관리자 화면 반영입니다. BE는 이미 운영에 배포돼 있고, 이 릴리즈 전까지 관리자 화면 일부(주문 강제 취소 등)는 새 계약과 맞지 않았습니다.

배포 뒤 할 일

  • 운영 '결제 설정'에 케이퀵 입금 계좌(은행·계좌번호·예금주)와 수수료율을 입력해야 결제 흐름이 켜집니다. 그 전 주문 생성은 PAYMENT_ACCOUNT_NOT_CONFIGURED입니다.

플랜 대조

플랜 실행 4단계(관리자 FE) 상태
AD-1AD-4 develop 머지(#86#89) 한 것
관리자 릴리즈 PR 한 것(이 PR)
이미지 빌드 → 배포 머지 뒤 자동 체인으로 진행

BE 커스텀·주문 흐름 릴리즈(#588, develop b2ee9d3)의 SDL을 받고 깨지는 화면을 맞춘 뒤, 관리자가 렌더러 없이 커스텀 주문과 상품 커스텀 설정을 확인할 수 있게 한다. 3D는 판매자 앱만 렌더러를 갖고 관리자는 구매자가 올린 캡처로 본다.

- 스키마: schema:pull(BE_DIR, b2ee9d3) → codegen
  - 삭제 필드 제거: AdminProduct.baseDesignImageUrl → thumbnailUrl(목록 썸네일), 옵션 그룹 optionRequires*, 템플릿 isActive, 자유 편집 cropImageUrl
  - adminCancelOrder reason 필수: 지금 다이얼로그는 사유 코드 선택이 없어 OTHER + 메모로 보낸다(메모 상한 494 → 500, '[관리자]' 접두 안내 삭제). cancelOptions 기반 다이얼로그는 다음 PR
  - 감사 대상 라벨 5종(결제 설정·정산 계좌·정산·환불·입금 기록)
- 커스텀 공용(features/custom): 방식·정렬·이미지 종류 라벨(Record + 모르는 값 원문 폴백), 문구 상태(기본 그대로/바꿈/문구 없음), 0~10000 좌표 → % 변환(범위 밖 자름), 렌더 이미지 순서(윗면 → 앞·뒤·왼·오), 글자색 견본
- 주문 상세: 3D 렌더 5장(윗면 크게), 슬롯형 합성 이미지 + 문구 자리 표(입력 문구·기본 대비·글자색·정렬), 자유 편집은 바탕 위 번호 영역 + 요청 문구 + 참고 사진. 주문 목록에 hasCustom '커스텀' 배지
- 상품 상세: '커스텀 설정' 카드(방식·자유 편집·문구 자리 표시 이름·키·기본 문구·최대 글자 수·필수·글자색·정렬, 3D 안내, 슬롯형이 아닌데 남은 템플릿 안내), 선택지 3D 연결 키 칩, '입력 필요' 경고 제거

테스트: custom-geometry(좌표 7경우·이미지 순서 5경우), 커스텀 meta(SDL enum 전수 라벨·모르는 값·프로토타입 키 폴백·문구 상태 7경우), 감사 meta(새 라벨 5종·모르는 유형), 주문 페이지(슬롯형 표·자유 편집 영역 %·3D 순서·옛 주문 2경우·비커스텀·목록 배지·취소 입력), 상품 페이지(썸네일·3D 키 칩·커스텀 카드 4경우). 반증: 크기 자르기·정렬·제자리 정렬·hasOwn 폴백·기본 문구 정규화·감사 라벨 누락을 각각 되돌리면 해당 케이스가 실패한다.
다음 PR(주문 결제 카드·정산·처리 대기 허브)이 따를 규칙을 먼저 남긴다.

- D19 처리 대기 허브 /tasks와 BE 경보 딥링크 계약(deposits?orderId·refunds?refundId·settlements?periodStart), 딥링크 시트 바로 열기·로그인 뒤 복귀, 건수 진실은 adminTaskCounts
- D20 계좌번호: 목록 마스킹, 단건 시트·상세만 전체 + 복사, 콘솔·오류·URL에 남기지 않음
- D21 커스텀 주문은 렌더러 없이 이미지·스냅샷으로 확인
- 아키텍처 §3: enum 라벨은 Record + 모르는 값 원문 폴백
지금 취소 다이얼로그는 사유 OTHER만 보내는데, 확정·제작 완료 주문은 BE가 사정(fault)을 요구해 늘 CANCEL_FAULT_REQUIRED로 거절됐다. 사정을 고르는 cancelOptions 다이얼로그가 들어올 때까지 이 상태에서는 취소 버튼을 두지 않는다. 상품 커스텀 설정 카드는 3D·없음 상품에 템플릿이 남아 있으면 '자유 편집: 허용'을 보여 3D 안내와 어긋났다. 구매자는 슬롯형에서만 템플릿을 받는다.

- 주문: isCancelable을 입금 대기·접수로 좁힘(BE가 사정 없이 받는 상태). 취소 spec fixture를 접수 주문으로 바꾸고 확정·제작 완료에는 버튼이 없음을 단언
- 상품: 자유 편집 행은 슬롯형이고 템플릿이 있을 때만. 남은 템플릿의 자유 편집 값은 '구매자에게 보이지 않습니다' 안내 아래로
- 커스텀 문구 상태: 기본 문구의 홀로 있는 CR도 LF로 맞춤(BE 저장 규칙과 같게)
- 렌더 이미지 라벨: THREE_D_ 종류에만 '3D' 접두, 모르는 종류는 원문

테스트: status 7상태 표, 주문 상세 확정·제작 완료 취소 버튼 없음 2건, 3D 렌더에 모르는 종류 1장, 커스텀 설정 카드 2경우 추가(없음+템플릿 없음, 3D+남은 템플릿), slotTextState 홀로 있는 CR 1건. 반증: 네 수정을 하나씩 되돌리면 각각 5·2·1·1건이 실패한다.
D20 이유 칸이 원문이 오는 곳을 관리자 상세 조회 3곳으로만 적어, 화면 규칙(콘솔·오류·URL 금지)이 mutation 결과에도 적용된다는 점이 빠졌다.

- 원문이 오는 곳에 adminMarkSettlementPaid(정산 상세 반환)·adminUpsertStoreSettlementAccount(정산 계좌 반환)를 더함
- 표 열 너비는 prettier가 다시 맞춤

테스트: 문서 변경만(format:check 통과).
feat: 스키마 갱신과 상품·주문 커스텀 표시
계좌이체 결제·취소 사유·노쇼·자동 전이·정산이 들어온 BE 주문을 관리자가 한 화면에서 보고 처리할 수 있게 한다. 지금 취소 다이얼로그는 사유 OTHER만 보내 확정·제작 완료 주문을 취소할 수 없었고(버튼을 숨겨 둠), 숨김 매장의 확정·제작 완료 주문은 자동 픽업 완료가 돌지 않아 관리자가 처리할 수단이 필요했다.

- 상태: 7종 라벨·톤(입금 대기 neutral, 접수 primary, 주문 확정 caution, 제작 완료 neutral, 픽업 완료 positive, 노쇼·취소 negative)을 Record로 두고 모르는 값은 원문 폴백. 목록 필터에 '진행 중' 칩(inProgress, URL 유지)
- 강제 취소: 버튼 노출과 선택지는 cancelOptions가 정한다. 사유 필수(선택지만), 사정은 BY_FAULT일 때만, 환불 금액은 구매자 사정일 때만 0~paidAmount 정수와 [전액]·[0원], 요약 문구. 입력 조립은 buildCancelInput 순수 함수, 메모는 BE처럼 코드 포인트로 500자
- 픽업 완료: 확정·제작 완료 주문에 [픽업 완료](adminCompleteOrderPickup, 메모 선택) 확인 다이얼로그를 [강제 취소]와 나란히. ORDER_STATUS_UNCHANGED·INVALID_ORDER_STATUS_TRANSITION은 버튼 맥락 문구로 알림
- 처리 뒤: 성공이든 거절이든 상세·목록을 다시 불러 바뀐 상태·선택지를 보인다
- 상세 카드: 결제(수단·상태·입금자명·입금 계좌 끝 4자리·기한·'입금했어요'·확인 처리자·메모), 취소(주체·사유·사정·환불액·환불 상태·메모), 환불 목록(종류 칩·상태·마스킹 계좌·요청/계좌 입력/송금 시각), 정산(주문 시점 수수료율·정산 예정/지급액·기준액·수수료·확정 시각·주간 정산), 요청 사항, 판매자 픽업 일시 변경 이력
- 진행 상태: 입금 대기 단계(결제 도입 전 주문은 접수부터), 노쇼 종료 표시, 자동 처리 예정(입금 기한·'입금했어요' 뒤 자동 취소 제외·확정 마감·자동 픽업 완료, 숨김 매장은 직접 처리 안내)
- 상태 이력: 주체 배지, 취소 이력의 사유·사정·환불액
- 대시보드: 주문 건수 키와 상태를 dashboard/order-count-keys.ts 한 곳에서 잇고(입금 대기·노쇼 추가) KPI 합계·상태 분포가 같이 쓴다. 주문 금액 라벨은 BE 기준대로 '취소·입금 대기 제외'
- 스키마는 BE develop(b2ee9d3) 스냅샷 그대로이고 조회 문서만 늘림(codegen)

테스트: cancel-form 표(환불 규칙 3 × 사정 3 × 금액 9 = 81건, '0' 유효, 결제액 0, 선택지 밖 사유·프로토타입 키, 메모 이모지 500자·501자), 요약 문구 9건과 요약 없음 2경우, 상태 7종 표·모르는 값, 라벨 표 전수·폴백, 수수료율 0~10000bp 전수, 자동 처리 예정 8건, 검색 inProgress 5건. 페이지: 접수 취소(사유 선택·메모 코드 포인트·이력 갱신), 확정 취소(사정 필수·판매자 사정·금액 범위·[전액]·[0원]으로 0 전송), 입금 대기 미입금 취소, 취소·픽업 불가 상태 2건, 픽업 완료 2건·거절 3건(재조회), 결제·정산 카드와 계좌 마스킹, 숨김 매장 안내, 취소·환불·정산 확정·요청 사항·픽업 변경, 결제 도입 전 주문, 목록 진행 중 칩·상태 7종, 대시보드 7개 상태 순서. 반증: 사정 규칙·금액 상한·'0' falsy·코드 포인트·선택지 밖 사유·hasOwn 폴백 2곳·픽업 완료 상태·숨김 매장·inProgress 'false'·실패 시 재조회·cancelable 게이트·계좌 마스킹을 하나씩 되돌리면 각각 30·4·2·2·2·1·6·1·1·2·4·3·1건이 실패하고, 건수 키 하나를 빼면 tsc가 깨진다.
강제 취소 다이얼로그가 폼이 됐는데 BE의 입력 거절(BAD_USER_INPUT)을 전부 토스트로 알려 오류 표시 규칙(폼 상단 알림)과 어긋났다. 거절 뒤 재조회로 선택지가 바뀌어도 고른 사유가 남아 사유 칸이 빈칸으로 보이고 버튼만 비활성이었고, 닫았다 열어도 그대로였다. 픽업 완료 메모는 공용 ReasonDialog가 UTF-16 길이로 세고 550 코드 유닛에서 잘라, BE(코드 포인트 500자)가 받는 이모지 메모를 막았다. 진행 상태의 자동 픽업 안내는 매장 조회가 오기 전·실패 때나 매장 화면에서 숨긴 직후 캐시가 옛 값일 때도 '자동으로 픽업 완료됩니다'로 단정했다.

- 강제 취소: BAD_USER_INPUT은 머리말 아래 role=alert로 보이고 입력을 바꾸거나 다시 열면 지운다. ORDER_NOT_CANCELLABLE은 재조회로 다이얼로그가 버튼과 함께 사라지므로 토스트, 그 밖 분류도 토스트
- 강제 취소: 열 때마다 입력을 비우고, 사유 Select 값은 지금 선택지에 있을 때만 넘겨 빠진 사유는 '사유 선택'으로 돌아간다
- 픽업 완료: 거절은 이미 다른 상태가 된 경우라 재조회로 다이얼로그가 사라지므로 토스트 유지(이유 주석)
- ReasonDialog: 길이 판정·카운터를 앞뒤 공백을 뺀 코드 포인트로, UTF-16 maxLength 상한 제거
- 자동 처리 예정: storeHiddenOf로 조회 중·실패·다시 조회 중이면 '…자동 픽업 완료 예정입니다. 매장이 숨김이면 자동으로 처리되지 않습니다.' 중립 문구. 상세를 열 때마다 매장 숨김 여부를 다시 조회(refetchOnMount)

테스트: storeHiddenOf 6건 표, autoTransitionNote 모름 1건. 페이지: 선택지 밖 사유 거절(폼 위 알림·사유 비움·요약 전액 환불·입력 시 알림 지움·다시 열면 초기화), 취소 불가 거절(토스트·다이얼로그 사라짐), 입력 오류가 아닌 거절은 토스트, 픽업 완료 메모 이모지 500자 통과·501자 비활성, 강제 취소 성공·픽업 완료 거절 뒤 목록 재조회 2건, 매장 조회 대기 중 중립 문구, 상세 재진입 시 숨김 재확인. 반증: 폼 알림·취소 불가 토스트·Select 값 가드·열 때 초기화·입력 시 알림 지움·코드 포인트·중립 문구·storeHiddenOf 조건·refetchOnMount·목록 무효화를 하나씩 되돌리면 각각 1·1·1·1·1·1·1·2·1·2건이 실패하고, 전부 폼 알림으로 보내면 2건이 실패한다.
feat: 주문 입금 대기·노쇼 상태와 결제·환불·정산 카드, 강제 취소 사유·환불 금액
BE가 주간 정산·월 수수료·결제 설정·매장 정산 계좌 API를 냈는데 관리자 화면이 없어 송금 완료 처리와 수수료율·입금 계좌 관리를 할 수 없었다. 판매자 정지·매장 숨기기 때는 진행 주문이 자동 취소되지 않는다는 걸 알려야 하고, 판매자 정지는 매장 숨김을 함께 할 수 있어야 한다.

- settlements feature 신설
  - /settlements: 상태·매장·정산 주(고른 날짜의 월요일) 필터, 정산 계좌 미등록 표시
  - /settlements/$settlementId: 금액·포함 주문·송금할 계좌(원문 + 복사), [송금 완료](확인 문구·메모, 409면 알리고 재조회), 계좌가 없으면 비활성 + 매장 링크, 감사 이력 링크
  - /settlements/monthly: 월 입력·이전/다음 달, 합계 + 매장별
  - /settings: 수수료율(퍼센트 소수 둘째 자리 ↔ bp를 문자열로 변환, 생성 시점 고정 안내), 케이퀵 입금 계좌(없으면 주문을 받을 수 없다는 경고), 변경은 모두 사유 필수
  - 매장 정산 계좌 카드·다이얼로그(react-hook-form + zod, 하이픈을 뺀 숫자 8~20자리)를 매장 상세 개요에 둔다
- 진행 주문 경고: 숨기기·정지 다이얼로그를 열 때 adminStoreInProgressOrderSummary로 상태별 건수와 '진행 주문 보기'(/orders?storeId&inProgress=true). 막지 않고, 조회 실패는 안내만
  - ReasonDialog에 본문 슬롯
- 판매자 정지: 경고와 '매장도 숨기기'(기본 켬). 정지 성공 뒤 같은 사유로 adminSetStoreActive(false), 숨김 실패는 토스트만 하고 정지는 유지. 이미 숨긴 매장이면 체크박스 없음
  - AccountStatusActions에 suspendExtra·afterSuspend(구매자 정지는 그대로)
- 감사 대상 링크: SETTLEMENT → 정산 상세, PAYMENT_SETTING → /settings, SETTLEMENT_ACCOUNT → 기록의 매장 상세(대상 ID가 계좌 행 번호라 화면이 없다)
- 사이드바: 운영 '정산', 설정 '결제 설정'. codegen·routeTree 갱신

테스트: 수수료율 퍼센트 → bp 표(5.55 → 555, 5.555·100.01 거절 등)와 0~10000 bp 왕복 전수, 계좌 입력·정산 검색·월 이동·라벨 폴백 표, 계좌번호 복사 토스트. 화면은 정산 목록 필터·페이지·실패, 상세 송금 완료·미등록 비활성·409 재조회·그 밖 오류·빈 칸, 월 수수료, 결제 설정(검증·전송 값·서버 거절), 매장 정산 계좌 등록·조회 실패, 숨기기 경고(건수·0건 미표시·조회 실패·다시 노출은 조회 없음), 판매자 정지 매장 숨김(성공·실패 토스트·끔·이미 숨김), 감사 대상 링크 4건. 반증: bp 상한, 문자열 변환(부동소수점 곱셈), 미등록 가드, 0건 가드, 숨김 실패 catch, 기본 켬을 하나씩 되돌리면 각각 2·1·1·2·1·3건이 실패한다.
Safari·Firefox는 month 입력을 글자 칸으로 그려 '2026-1' 같은 치다 만 값이 그대로 이동됐다. 검색 스키마가 그 값을 버려 이번 달로 덮이면서 월을 직접 칠 수 없었다. 판매자 정지의 '매장도 숨기기'는 상세 화면에 남아 있는 상태라, 끄고 정지한 뒤 해제하면 다음 정지 때도 꺼진 채로 열렸다.

- 월 수수료: 입력 중인 값은 칸에만 두고 'YYYY-MM'을 다 쳤을 때만 옮긴다. 치다 만 값은 칸을 떠나면 현재 달로 되돌리고, 이전·다음 달로 옮기면 칸도 따라간다(isMonth를 검색 스키마와 같이 쓴다)
- 판매자 정지: 계정 상태가 바뀌면 '매장도 숨기기'를 다시 켬으로 둔다. 정지하지 않고 닫았다 다시 열면 사유 초안처럼 고른 값을 유지한다
- 은행 목록 문서 이름을 AdminPaymentBanks로(문서 명명 규칙). codegen 갱신

테스트: 월 입력을 글자 칸으로 바꿔 치다 만 값이 URL에 안 실리고, 다 친 월만 옮기며, 칸을 떠나면 되돌리고, 다음 달 버튼에 칸이 따라가는 케이스. 매장도 숨기기 끄고 정지 → 해제 → 다시 열면 켜져 있는 케이스. 정산 상세(계좌 미등록)를 본 뒤 매장에서 계좌를 등록하고 돌아가면 송금 완료가 바로 열리는 케이스. 반증: 월 입력 수정·blur 되돌림·달 동기화, 상태 변경 리셋, 정산 무효화를 하나씩 되돌리면 각 케이스가 실패한다.
월 수수료 조회가 placeholderData로 이전 달 결과를 유지해, 새 달 응답이 오기 전까지 지난달 합계·매장 행이 새로 고른 달 이름 아래 보였다.

- monthlyCommissionsQueryOptions에서 placeholderData 제거(합계 —, 표 로딩)
- 테스트: 새 달 응답을 붙잡아 둔 동안 이전 달 금액·매장 링크가 없음(이전 코드에서 실패 확인)
feat: 결제 설정·주간 정산·월 수수료와 매장 정산 계좌·진행 주문 경고
① 무엇·왜
- 계좌이체 수동 입금 확인(관리자만)과 환불·정산 송금을 한 화면에서 처리한다. BE 경보 딥링크(/tasks/deposits?orderId=·/tasks/refunds?refundId=·/tasks/settlements?periodStart=)가 그 건의 시트를 바로 연다.
- 금액이 틀린 입금은 확인할 수 없어 반환 대상으로 연결하고, 주인 모를 입금은 메모와 함께 종결 기록한다. 픽업이 지난 주문은 확인을 막고 미입금 취소 뒤 반환으로 처리한다.
- 명세에 없는 결정: 탭·사이드바 배지는 지금 처리할 수 있는 건만 센다(입금 대기 전체 + 환불 송금 대기 + 정산 송금 대기). 계좌 입력 대기 환불은 구매자를 기다리므로 환불 탭 안 칩과 대시보드 타일에만 보인다.
- 명세에 없는 결정: 입금 기록 감사 링크는 단건 조회 API가 없어 입금 기록 목록으로 연다. 정산 [다음 건]은 계좌가 등록된 정산만 고른다.

② 변경점
- features/tasks 신설: adminTaskCounts(60초 폴링 + 창 포커스 재조회) 한 조회를 사이드바 '처리 대기'(운영 맨 위)·탭·대시보드 타일이 같이 쓴다.
- 입금 탭: 확인 요청(claimedOnly)·입금 대기(금액·입금자명 검색)·입금 기록(반환·종결, 종결 기록 주문 연결). 픽업 3시간 미만 caution, 지남 negative, 입금 기한 지남 표시.
- 주문 시트: [입금 확인](입금액 필수·메모 선택, 0원 주문은 0), DEPOSIT_AMOUNT_MISMATCH면 오류 문구와 함께 반환 연결을 입력 금액·입금자명으로 미리 채워 연다. [미입금 취소](PAYMENT_NOT_RECEIVED), [반환 대상으로 연결](금액·입금자명·입금 일시·메모). 상단 [주인 모를 입금 기록](메모 필수).
- 환불 탭: 송금 대기·계좌 입력 대기(연락처)·종류 칩. 시트에서 전체 계좌번호 복사, [송금 완료] 확인 문구, 계좌 입력 전이면 비활성.
- 정산 송금 탭: 송금 대기 정산, 기간 필터, 계좌 미등록이면 비활성 + 매장 링크. 시트에서 지금 정산 계좌 복사와 [송금 완료].
- 처리 성공·409면 건수·목록·단건을 다시 읽어 '처리됨'(처리자·시각)과 [다음 건 (N건 남음)]을 보인다. 409는 토스트로 알린다.
- 감사 로그 대상 링크: REFUND → 환불 시트, DEPOSIT_RECORD → 입금 기록 목록.
- 문서 이름은 AdminTasks* 접두로 다른 화면의 정산·환불 문서와 겹치지 않게 했다. 테스트 MSW 서버에 셸 공용 건수 기본 응답(0건)을 둔다.

③ 테스트
- meta·search·forms 순수 함수 표(픽업 경계 6, 다음 건 8, 금액 파싱 12, 폼 경계, 오류 분류).
- 화면: 딥링크 시트, 세션 없는 복귀, 409(입금·환불·정산), 다음 건, 입금액 불일치 → 반환 시트 금액·입금자명 채움, 종결 메모 필수, 금액·주문 ID "0", 픽업 지남 확인 차단과 미입금 취소, 종결 기록 주문 연결, 배지·탭·타일 건수.
- 반증 8건(픽업 경계, 다음 건 차감, 배지 계좌 대기 제외, Int 상한, 금액 0 truthy, 0원 입금 확인, 종결 메모 필수, 정산 다음 건 계좌 필터)이 각각 테스트를 실패시키는 것을 확인했다.
① 무엇·왜
- 시트가 열릴 때 잰 시각을 계속 써서, 열어 둔 사이 픽업이 지나도 확인 폼이 남았다. 서버가 PAYMENT_PICKUP_PASSED(409)로 거절해도 토스트만 뜨고 같은 폼이 그대로였다.
- '입금했어요'를 누른 주문은 기한이 멈춰 자동 취소되지 않는데, 확인 요청 보기의 거의 모든 주문에 빨간 '지남'이 붙어 취소 대상처럼 보였다.
- 입금 기록 보기에서 숨겨진 금액·입금자명 필터 때문에 [초기화]가 보였다.
- 목록의 keepPreviousData는 같은 키 재조회에는 필요 없고, 보기·필터를 바꿀 때 이전 조건의 행을 로딩 표시 없이 보이게 했다.

② 변경점
- 주문 시트: 지금 시각을 렌더마다 재고, PAYMENT_PICKUP_PASSED를 받으면 확인 폼을 '미입금 취소 뒤 반환 대상으로 연결' 안내로 바꾼다.
- 목록·시트의 입금 기한 지남은 buyerClaimedAt이 없는 주문에만 단다.
- [초기화] 활성 여부는 보기에 보이는 필터만 센다(입금 기록: 종류, 그 외: 금액·입금자명).
- 처리 대기 목록 쿼리에서 placeholderData를 뺀다.

③ 테스트
- 픽업 1분 전 주문의 입금 확인이 PAYMENT_PICKUP_PASSED로 거절되면 안내로 바뀌고 폼이 사라진다.
- 클릭한 주문은 기한이 지나도 픽업 지남만, 누르지 않은 주문은 목록 '지남'·시트 '기한 지남'을 단다.
- 건수 0이면 건수를 받은 뒤에도 사이드바·탭 배지가 없다. 건수는 가짜 타이머로 60초 경과·창 복귀 뒤 다시 요청한다(설정값 단언을 동작 검증으로 바꿈).
- 입금 기록 보기에서 주소의 금액 필터로는 [초기화]가 보이지 않는다.
- 반증 7건(픽업 지남 전환 제거, 목록·시트 클릭 조건 제거, 배지 0 가드 완화, 포커스 재조회 끔, 폴링 제거, 초기화 보기별 계산 되돌림)이 각각 테스트를 실패시키는 것을 확인했다.
① 무엇·왜
- 처리 대기(AD-4)는 주문(AD-2)·정산(AD-3)과 같은 기반 위에서 병렬로 만들어져 주체·환불 라벨과 정산 송금 확인·계좌 복사를 따로 들고 있었다. 주체 SYSTEM이 처리 대기에서는 '자동', 주문·정산에서는 '시스템'으로 갈렸고 환불 상태 톤도 달랐다.
- 처리 대기에서 입금 확인·취소·환불 송금을 처리해도 주문·정산·대시보드 캐시는 staleTime(15초) 동안 옛 상태를 보였고, 주문 화면의 강제 취소·정산 화면의 송금 완료 뒤에도 처리 대기 건수 배지가 다음 폴링(60초)까지 남았다.

② 변경점
- AD-3(feat/settlements-settings) 위로 옮겼다. 충돌은 사이드바 제목 표(nav.spec)·감사 로그 대상 링크(audit-links)에서 양쪽 항목을 모두 살렸고, codegen 산출물은 양쪽 문서를 합쳐 다시 생성했다. 라우트 트리는 라우터 생성기로 다시 만들어 자동 병합 결과와 같음을 확인했다.
- 라벨: tasks/meta의 주체·환불 종류·환불 상태 표를 지우고 orders 배럴의 actorLabel·refundKindLabel·refundStatusMeta를 쓴다. SYSTEM은 '시스템', 환불 상태 톤은 주문 화면 기준(계좌 입력 대기 caution, 송금 대기 primary)이다.
- 환불 종류 필터 값만 tasks에 남겼다. 주소 스키마가 모듈 평가 때 쓰는데 주문과 서로 import하는 사이라 평가 순서에 기대지 않는다.
- 정산 송금: 처리 대기 정산 시트가 settlements 배럴의 MarkPaidDialog를 쓰고 AdminTasksMarkSettlementPaid 문서를 지웠다. 확인 문구·메모 칸·토스트는 정산 화면 것을 따른다. 환불·정산 시트의 계좌 복사는 AccountNumber(아이콘 버튼)를 쓴다.
- 교차 무효화: 배럴마다 invalidateOrders·invalidateSettlements·invalidateDashboard·invalidateTasks를 내보낸다.
  - 처리 대기의 처리(입금 확인·미입금 취소·입금 반환·종결 기록·연결·환불 송금 완료)는 성공·거절과 관계없이 처리 대기·주문·정산·대시보드 요약을 다시 읽게 한다.
  - 주문 강제 취소·관리자 픽업 완료와 정산 송금 완료(409 포함)는 처리 대기를 다시 읽게 한다.
- markSettlementPaid를 try/finally로 바꿔 409에서도 다시 읽고, MarkPaidDialog의 409 분기에서 따로 하던 무효화를 뺐다.
- 명세에 없는 결정: 매장 정산 계좌 등록 뒤에도 처리 대기를 다시 읽는다. 정산 송금 탭의 계좌 등록 여부와 송금 가능 여부가 바뀐다.
- guide §3에 교차 무효화 규칙과 순환 import 주의를 더했다.

③ 테스트
- 교차 무효화 13건: 처리 대기 mutation 6종과 409 뒤 구독 중인 주문 목록·정산 목록·대시보드 요약·처리 대기 건수를 다시 요청한다. 주문 강제 취소·픽업 완료·취소 409 뒤 처리 대기 건수, 정산 송금 완료·409·계좌 등록 뒤 처리 대기 건수·정산 송금 목록을 다시 요청한다.
- 자동 취소된 주문 시트는 취소 주체를 '시스템'으로 보인다. 정산 시트의 송금 완료·409·입력 오류 흐름은 정산 문서(AdminMarkSettlementPaid)로 그대로 통과한다.
- 반증: 주문 withRefresh의 처리 대기 무효화, 처리 대기 run의 대시보드 무효화, markSettlementPaid의 처리 대기 무효화를 빼고 SYSTEM 라벨을 '자동'으로 되돌리자 해당 테스트 15건이 실패하는 것을 확인했다.
금액 필터가 ID 입력 검사를 써서 '12,000'처럼 쉼표 금액을 거절하고, Int 범위를 넘는 금액은 통과시킨 뒤 검색 스키마가 조용히 버려 필터 없는 목록을 보였다.

- IdFilterInput에 validate·invalidMessage 선택 인자 추가(기본은 ID 숫자 검사)
- 금액 필터는 parseWon으로 검사하고 정규화한 숫자를 주소에 남김
- 테스트: 쉼표 금액 적용, 범위 초과 금액은 오류를 보이고 기존 필터·요청 유지
환불·정산·주문 시트의 상세 쿼리는 폴링이 없고 앱 기본값이 포커스 재조회를 꺼 둬서, 시트를 연 사이 구매자가 계좌를 입력하거나 다른 관리자가 완료해도 옛 상태가 남았다. 이미 완료된 환불에 송금 안내와 완료 버튼이 계속 보여 중복 송금 위험이 있었다.

- 목록 폴링 옵션을 pollOptions로 이름을 바꾸고 상세 세 쿼리에도 적용(60초·창 복귀 재조회)
- 테스트: 상세 세 쿼리가 60초 뒤 다시 요청됨(이전 코드에서 실패 확인)
feat: 처리 대기 허브(입금 확인·입금 반환·환불 송금·정산 송금)
@coderabbitai

coderabbitai Bot commented Nov 19, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on this repository. 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 19, 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-19T01:07:49.096435Z 0c9e740 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

Coverage Report

Status Category Percentage Covered / Total
🟢 Lines 97.06% (🎯 96%)
⬆️ +0.99%
3312 / 3412
🟢 Statements 96.62% (🎯 95%)
⬆️ +1.08%
3639 / 3766
🟢 Functions 95.88% (🎯 94%)
⬆️ +1.59%
1420 / 1481
🟢 Branches 90.27% (🎯 88%)
⬆️ +2.20%
2794 / 3095
File Coverage
File Stmts Branches Functions Lines Uncovered Lines
Changed Files
src/app/shell/nav.ts 100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/app/shell/sidebar-nav.tsx 100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/accounts/components/account-status-actions.tsx 88.88%
⬆️ +0.42%
88.88%
🟰 ±0%
80%
🟰 ±0%
88.88%
⬆️ +0.42%
64-65, 118
src/features/audit-logs/meta.ts 100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/audit-logs/components/audit-links.tsx 100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/audit-logs/pages/audit-logs-page.tsx 89.28%
🟰 ±0%
73.33%
⬆️ +3.33%
86.36%
🟰 ±0%
88.88%
🟰 ±0%
129, 155, 224
src/features/custom/custom-geometry.ts 100% 100% 100% 100%
src/features/custom/index.ts 0% 0% 0% 0%
src/features/custom/meta.ts 100% 100% 100% 100%
src/features/custom/components/color-swatch.tsx 100% 100% 100% 100%
src/features/dashboard/index.ts 0%
🟰 ±0%
0%
🟰 ±0%
0%
🟰 ±0%
0%
🟰 ±0%
src/features/dashboard/order-count-keys.ts 100% 100% 100% 100%
src/features/dashboard/api/queries.ts 100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/dashboard/components/kpi-tiles.tsx 100%
🟰 ±0%
100%
⬆️ +14.29%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/dashboard/components/order-status-chart.tsx 88.88%
🟰 ±0%
100%
🟰 ±0%
83.33%
🟰 ±0%
85.71%
🟰 ±0%
67
src/features/dashboard/pages/dashboard-page.tsx 100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/orders/auto-transition.ts 100% 100% 100% 100%
src/features/orders/cancel-form.ts 100% 100% 100% 100%
src/features/orders/index.ts 0%
🟰 ±0%
0%
🟰 ±0%
0%
🟰 ±0%
0%
🟰 ±0%
src/features/orders/meta.ts 100% 100% 100% 100%
src/features/orders/search.ts 100%
🟰 ±0%
95.45%
⬆️ +0.45%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/orders/status.ts 100%
🟰 ±0%
100%
⬆️ +20.00%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/orders/api/queries.ts 100%
🟰 ±0%
72.22%
⬆️ +3.47%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/orders/components/cancel-order-dialog.tsx 97.72%
⬆️ +2.99%
89.65%
⬆️ +2.15%
100%
⬆️ +25.00%
100%
⬆️ +5.27%
68
src/features/orders/components/complete-pickup-dialog.tsx 100% 83.33% 100% 100%
src/features/orders/components/order-detail-sections.tsx 100%
🟰 ±0%
89.13%
⬇️ -0.87%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/orders/components/order-item-custom.tsx 100% 100% 100% 100%
src/features/orders/components/order-money-sections.tsx 100% 89.58% 100% 100%
src/features/orders/components/orders-filter-bar.tsx 76.92%
⬆️ +4.20%
70.83%
⬆️ +2.65%
66.66%
⬆️ +4.16%
76.92%
⬆️ +4.20%
50, 82-92
src/features/orders/components/orders-table.tsx 100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/orders/pages/order-detail-page.tsx 100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/products/option-rules.ts 100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/products/api/queries.ts 100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/products/components/product-custom-card.tsx 100% 94.73% 100% 100%
src/features/products/components/product-options-card.tsx 100%
🟰 ±0%
95.83%
⬇️ -4.17%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/products/components/products-table.tsx 100%
🟰 ±0%
83.33%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/products/pages/product-detail-page.tsx 100%
🟰 ±0%
85%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/sellers/components/seller-status-actions.tsx 100% 100% 100% 100%
src/features/sellers/pages/seller-detail-page.tsx 100%
🟰 ±0%
68.18%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/settlements/bank-account.ts 100% 100% 100% 100%
src/features/settlements/commission-rate.ts 100% 100% 100% 100%
src/features/settlements/index.ts 0% 0% 0% 0%
src/features/settlements/search.ts 100% 100% 100% 100%
src/features/settlements/status.ts 100% 100% 100% 100%
src/features/settlements/api/queries.ts 100% 100% 100% 100%
src/features/settlements/components/account-number.tsx 100% 100% 100% 100%
src/features/settlements/components/bank-account-dialog.tsx 100% 70% 100% 100%
src/features/settlements/components/commission-rate-dialog.tsx 100% 90% 100% 100%
src/features/settlements/components/mark-paid-dialog.tsx 100% 100% 100% 100%
src/features/settlements/components/store-settlement-account-card.tsx 100% 100% 100% 100%
src/features/settlements/pages/monthly-commissions-page.tsx 100% 100% 100% 100%
src/features/settlements/pages/payment-settings-page.tsx 100% 100% 100% 100%
src/features/settlements/pages/settlement-detail-page.tsx 100% 100% 100% 100%
src/features/settlements/pages/settlements-list-page.tsx 100% 100% 100% 100%
src/features/stores/index.ts 0%
🟰 ±0%
0%
🟰 ±0%
0%
🟰 ±0%
0%
🟰 ±0%
src/features/stores/api/queries.ts 100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/stores/components/in-progress-orders-warning.tsx 100% 100% 100% 100%
src/features/stores/components/store-active-toggle.tsx 77.77%
🟰 ±0%
93.75%
⬆️ +0.90%
100%
🟰 ±0%
77.77%
🟰 ±0%
48-49
src/features/stores/pages/store-detail-page.tsx 100%
🟰 ±0%
85.71%
🟰 ±0%
100%
🟰 ±0%
100%
🟰 ±0%
src/features/tasks/forms.ts 100% 100% 100% 100%
src/features/tasks/index.ts 0% 0% 0% 0%
src/features/tasks/meta.ts 100% 100% 100% 100%
src/features/tasks/search.ts 100% 100% 100% 100%
src/features/tasks/api/queries.ts 100% 83.33% 100% 100%
src/features/tasks/components/deposit-dialog.tsx 100% 100% 100% 100%
src/features/tasks/components/deposit-order-sheet.tsx 100% 93.33% 100% 100%
src/features/tasks/components/link-deposit-dialog.tsx 94.73% 83.33% 100% 100% 42
src/features/tasks/components/refund-sheet.tsx 100% 95.74% 100% 100%
src/features/tasks/components/settlement-sheet.tsx 100% 91.66% 100% 100%
src/features/tasks/components/task-counts.tsx 100% 100% 100% 100%
src/features/tasks/components/task-sheet.tsx 100% 90% 100% 100%
src/features/tasks/pages/deposits-page.tsx 100% 92.06% 100% 100%
src/features/tasks/pages/refunds-page.tsx 100% 91.66% 100% 100%
src/features/tasks/pages/settlements-page.tsx 96% 91.66% 95% 95.65% 72
src/routes/_authed/_shell/settings.tsx 100% 100% 100% 100%
src/routes/_authed/_shell/settlements/$settlementId.tsx 100% 100% 100% 100%
src/routes/_authed/_shell/settlements/index.tsx 100% 100% 100% 100%
src/routes/_authed/_shell/settlements/monthly.tsx 100% 100% 100% 100%
src/routes/_authed/_shell/tasks/deposits.tsx 100% 100% 100% 100%
src/routes/_authed/_shell/tasks/index.tsx 100% 100% 100% 100%
src/routes/_authed/_shell/tasks/refunds.tsx 100% 100% 100% 100%
src/routes/_authed/_shell/tasks/settlements.tsx 100% 100% 100% 100%
Generated in workflow #182 for commit 0c9e740 by the Vitest Coverage Report Action

@chanwoo7
chanwoo7 merged commit a70be7f into main Nov 19, 2026
22 checks passed
@chanwoo7
chanwoo7 deleted the develop branch November 19, 2026 01:08
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