Repository navigation
feat: 처리 대기 허브(입금 확인·입금 반환·환불 송금·정산 송금) - #89
Conversation
① 무엇·왜 - 계좌이체 수동 입금 확인(관리자만)과 환불·정산 송금을 한 화면에서 처리한다. 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건이 실패하는 것을 확인했다.
|
Important Review skippedAuto reviews are disabled on this repository. 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. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: a628a1e199
ℹ️ 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".
| <IdFilterInput | ||
| label="금액" | ||
| placeholder="원" | ||
| value={search.amount} | ||
| onCommit={(amount) => patch({ amount })} |
There was a problem hiding this comment.
Validate the amount filter as money rather than an ID
When an administrator enters a formatted amount such as 12,000, IdFilterInput rejects it through isIdText, even though parseWon explicitly supports commas. Conversely, an amount such as 2147483648 passes the ID validator but is silently discarded by wonText.catch(undefined), causing an unfiltered payment query instead of displaying a validation error. Use an amount-specific input validator consistent with parseWon so valid amounts can be searched and invalid amounts do not silently remove the filter.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
반영: 금액 필터를 ID 검사 대신 parseWon 기준으로 검사함(쉼표 허용, Int 범위 초과는 입력을 남긴 채 오류 표시). 적용 값은 정규화한 숫자로 주소에 남김. 공용 IdFilterInput에 validate·invalidMessage를 선택 인자로 추가. 쉼표 금액 적용과 범위 초과 시 필터 유지·오류 표시 테스트 추가.
Codecov Report❌ Patch coverage is
📢 Thoughts on this report? Let us know! |
금액 필터가 ID 입력 검사를 써서 '12,000'처럼 쉼표 금액을 거절하고, Int 범위를 넘는 금액은 통과시킨 뒤 검색 스키마가 조용히 버려 필터 없는 목록을 보였다. - IdFilterInput에 validate·invalidMessage 선택 인자 추가(기본은 ID 숫자 검사) - 금액 필터는 parseWon으로 검사하고 정규화한 숫자를 주소에 남김 - 테스트: 쉼표 금액 적용, 범위 초과 금액은 오류를 보이고 기존 필터·요청 유지
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: c9b06489e8
ℹ️ 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".
| queryKey: tasksKeys.refund(refundId), | ||
| queryFn: async () => (await gqlRequest(AdminTasksRefundDocument, { refundId })).adminRefund, | ||
| retry: false, |
There was a problem hiding this comment.
Refresh refund details while the processing sheet is open
When a buyer submits their account or another administrator completes a refund while its sheet is open, only the counts and list refresh; this separate detail query has no polling and inherits refetchOnWindowFocus: false from src/app/query-client.ts. Consequently, RefundBody continues showing the old account/status indefinitely: an awaiting-account refund remains disabled, or an already-completed refund still offers transfer instructions and an enabled completion button. The conflict response only arrives after the administrator has potentially sent money in the bank app. Refresh active refund details alongside the list, or invalidate them when refreshed list data indicates a status change.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
반영: 열린 시트의 상세(주문·환불·정산)도 목록과 같은 주기(60초)·창 복귀 때 다시 읽게 함. 다른 관리자의 완료·구매자 계좌 입력이 열린 시트에 반영됨. 상세 세 쿼리가 60초 뒤 다시 요청되는지 보는 테스트 추가(이전 코드에서 실패 확인).
환불·정산·주문 시트의 상세 쿼리는 폴링이 없고 앱 기본값이 포커스 재조회를 꺼 둬서, 시트를 연 사이 구매자가 계좌를 입력하거나 다른 관리자가 완료해도 옛 상태가 남았다. 이미 완료된 환불에 송금 안내와 완료 버튼이 계속 보여 중복 송금 위험이 있었다. - 목록 폴링 옵션을 pollOptions로 이름을 바꾸고 상세 세 쿼리에도 적용(60초·창 복귀 재조회) - 테스트: 상세 세 쿼리가 60초 뒤 다시 요청됨(이전 코드에서 실패 확인)
개요
관리자가 은행 앱에서 본 입금과 송금을 한 화면(
/tasks)에서 처리하는 처리 대기 허브를 만듭니다.feat/settlements-settings,6d08412) 위로 옮겨 쌓았습니다./tasks/deposits?orderId=·/tasks/refunds?refundId=·/tasks/settlements?periodStart=, guide D19)가 그 건을 바로 엽니다.변경 사항
adminTaskCounts): 한 조회를 사이드바·탭·대시보드 타일이 같이 씁니다.claimedOnly) 보입니다.DEPOSIT_AMOUNT_MISMATCH로 거절하면 오류 문구를 폼 위에 남기고, [반환 대상으로 연결]을 입력한 금액과 입금자명으로 미리 채워 엽니다.PAYMENT_PICKUP_PASSED로 거절하면 같은 안내로 바꿉니다.PAYMENT_NOT_RECEIVED와 선택 메모로 보냅니다.AccountNumber이고, 복사 알림에는 번호를 넣지 않습니다(guide D20).periodStart)입니다.MarkPaidDialog)으로 처리합니다.AdminTasks*접두로 두어 AD-3의 정산 화면 문서와 이름이 겹치지 않게 했습니다. 정산 송금 완료만 AD-3의AdminMarkSettlementPaid를 같이 씁니다.AD-2·AD-3와 통합
git rebase --onto 6d08412 3cb6f7a로 옮겼습니다.nav.spec)와 감사 로그 대상 링크(audit-links)는 양쪽 항목을 모두 살렸습니다(정산·결제 설정·정산 계좌 + 환불·입금 기록).pnpm codegen으로 다시 만들었고, 생성된 문서 목록이 양쪽 합집합과 같음을 확인했습니다.actorLabel·refundKindLabel·refundStatusMeta를 씁니다.MarkPaidDialog를 쓰고, 처리 대기 전용 송금 완료 mutation 문서를 지웠습니다.AccountNumber(아이콘 버튼, 같은 복사 알림)를 씁니다.invalidateOrders·invalidateSettlements·invalidateDashboard·invalidateTasks를 내보내고 상대가 부릅니다.settlements/status.ts, '시스템')가 따로 있습니다. 이번 통합 범위(처리 대기 쪽 중복) 밖이라 그대로 두었습니다.테스트
meta.spec: 픽업 강조 경계 6경우(지남·지금·1ms 뒤·3시간 1ms 전·3시간·하루), 다음 건 8경우(ID "0" 포함), 배지 합계, 입금 기록 종류 라벨 폴백(constructor·toString포함), 환불 종류 필터 값 순서, 오류 분류. 주체·환불 라벨은orders/meta.spec이 검사합니다.search.spec: 금액 파싱 12경우(쉼표·Int 상한·음수·소수), 금액·주문 ID "0", 입금자명 50자(코드 포인트) 자르기, 보기·상태 기본값, 기간 날짜 검증.forms.spec: 0원 입금 확인, 반환 금액 1원 이상, 입금자명 50자 경계, 종결 메모 필수(공백만은 비운 것), KST 입금 일시 → UTC, 서버 오류 위치.AdminMarkSettlementPaid)로 같은 흐름을 통과합니다.PAYMENT_PICKUP_PASSED로 거절되면 안내로 바뀌고 폼이 사라짐./tasks→ 입금 탭, 감사 링크 2종.<=→<, 다음 건 남은 수 차감 제거, 배지에 계좌 입력 대기 더하기, Int 상한 제거parseWon(...) || null(0을 버림), 입금 확인 0원 거절, 종결 메모 필수 해제, 정산 다음 건 계좌 필터 제거undefined만 거르게 완화lint·typecheck·codegen:check(커밋 뒤)·knip·format:check통과.src/features/tasks·orders·settlements·dashboard·stores·sellers·src/app33파일 706건, 충돌을 푼audit-logs2파일 82건 통과.플랜 대조
/tasks, 탭 3개(입금·환불·정산 송금)와 건수 배지adminTaskCounts한 조회를 사이드바('운영' 맨 위 '처리 대기')·탭·대시보드 타일이 같이 씀orderId·refundId·settlementId, 정산 경보의periodStart는 목록 필터claimedOnly, 픽업 3시간 미만 caution·경과 negative)DEPOSIT_AMOUNT_MISMATCH면 오류 문구와 함께 [반환 대상으로 연결]을 입력한 금액으로 미리 채워 엶accountRegistered=false면 비활성 + 매장 링크"0"MarkPaidDialog·AccountNumber