From 960abdc738812412621d016a9ca0cce83534d2c0 Mon Sep 17 00:00:00 2001 From: chanwoo7 Date: Thu, 19 Nov 2026 08:52:32 +0900 Subject: [PATCH 1/2] =?UTF-8?q?feat:=20=EC=A3=BC=EB=AC=B8=20=EC=9E=85?= =?UTF-8?q?=EA=B8=88=20=EB=8C=80=EA=B8=B0=C2=B7=EB=85=B8=EC=87=BC=20?= =?UTF-8?q?=EC=83=81=ED=83=9C=EC=99=80=20=EA=B2=B0=EC=A0=9C=C2=B7=ED=99=98?= =?UTF-8?q?=EB=B6=88=C2=B7=EC=A0=95=EC=82=B0=20=EC=B9=B4=EB=93=9C,=20?= =?UTF-8?q?=EA=B0=95=EC=A0=9C=20=EC=B7=A8=EC=86=8C=20=EC=82=AC=EC=9C=A0?= =?UTF-8?q?=C2=B7=ED=99=98=EB=B6=88=20=EA=B8=88=EC=95=A1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 계좌이체 결제·취소 사유·노쇼·자동 전이·정산이 들어온 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가 깨진다. --- .../audit-logs/pages/audit-logs.spec.tsx | 15 + src/features/dashboard/api/queries.ts | 2 + .../dashboard/components/kpi-tiles.tsx | 6 +- .../components/order-status-chart.tsx | 22 +- src/features/dashboard/order-count-keys.ts | 25 + .../dashboard/pages/dashboard-page.spec.tsx | 31 +- src/features/orders/api/queries.ts | 134 ++++- src/features/orders/auto-transition.spec.ts | 67 +++ src/features/orders/auto-transition.ts | 25 + src/features/orders/cancel-form.spec.ts | 158 +++++ src/features/orders/cancel-form.ts | 82 +++ .../orders/components/cancel-order-dialog.tsx | 167 +++++- .../components/complete-pickup-dialog.tsx | 44 ++ .../components/order-detail-sections.tsx | 110 +++- .../components/order-money-sections.tsx | 188 ++++++ .../orders/components/orders-filter-bar.tsx | 20 +- src/features/orders/meta.spec.ts | 84 +++ src/features/orders/meta.ts | 74 +++ .../orders/pages/order-detail-page.tsx | 28 +- src/features/orders/pages/orders.spec.tsx | 567 +++++++++++++++++- src/features/orders/search.spec.ts | 17 + src/features/orders/search.ts | 9 +- src/features/orders/status.spec.ts | 54 +- src/features/orders/status.ts | 35 +- src/graphql/generated/gql.ts | 24 +- src/graphql/generated/graphql.ts | 161 ++++- 26 files changed, 1996 insertions(+), 153 deletions(-) create mode 100644 src/features/dashboard/order-count-keys.ts create mode 100644 src/features/orders/auto-transition.spec.ts create mode 100644 src/features/orders/auto-transition.ts create mode 100644 src/features/orders/cancel-form.spec.ts create mode 100644 src/features/orders/cancel-form.ts create mode 100644 src/features/orders/components/complete-pickup-dialog.tsx create mode 100644 src/features/orders/components/order-money-sections.tsx create mode 100644 src/features/orders/meta.spec.ts create mode 100644 src/features/orders/meta.ts diff --git a/src/features/audit-logs/pages/audit-logs.spec.tsx b/src/features/audit-logs/pages/audit-logs.spec.tsx index 6bd30bf..ae8b46a 100644 --- a/src/features/audit-logs/pages/audit-logs.spec.tsx +++ b/src/features/audit-logs/pages/audit-logs.spec.tsx @@ -316,6 +316,21 @@ describe('감사 로그', () => { updatedAt: '2026-09-27T02:34:00.000Z', items: [], statusHistories: [], + requestNote: null, + payment: null, + refunds: [], + cancellation: null, + cancelOptions: { cancelable: false, reasons: [], refundRule: null, paidAmount: 0 }, + confirmDeadlineAt: null, + autoPickupAt: null, + noShowAt: null, + pickupChanges: [], + commissionRateBps: 0, + expectedPayoutAmount: null, + settlementBaseAmount: null, + commissionAmount: null, + settlementFinalizedAt: null, + settlementId: null, }, }), ); diff --git a/src/features/dashboard/api/queries.ts b/src/features/dashboard/api/queries.ts index d4cdb5f..a14a6e2 100644 --- a/src/features/dashboard/api/queries.ts +++ b/src/features/dashboard/api/queries.ts @@ -18,10 +18,12 @@ const AdminDashboardSummaryDocument = graphql(/* GraphQL */ ` newUserCount newSellerCount orderCounts { + pendingPayment submitted confirmed made pickedUp + noShow canceled } orderAmountSum diff --git a/src/features/dashboard/components/kpi-tiles.tsx b/src/features/dashboard/components/kpi-tiles.tsx index b083e40..673a1fc 100644 --- a/src/features/dashboard/components/kpi-tiles.tsx +++ b/src/features/dashboard/components/kpi-tiles.tsx @@ -3,6 +3,7 @@ import { Link } from '@tanstack/react-router'; import { formatCount, formatKrw } from '@/shared/lib/format'; import { Card } from '@/shared/ui/card'; +import { orderCountTotal } from '../order-count-keys'; import { type DashboardSummary } from './types'; function Tile({ @@ -36,12 +37,11 @@ function Tile({ } export function KpiTiles({ summary }: { summary: DashboardSummary }) { - const c = summary.orderCounts; - const orderTotal = c.submitted + c.confirmed + c.made + c.pickedUp + c.canceled; + const orderTotal = orderCountTotal(summary.orderCounts); return (
diff --git a/src/features/dashboard/components/order-status-chart.tsx b/src/features/dashboard/components/order-status-chart.tsx index 16edf32..902b35c 100644 --- a/src/features/dashboard/components/order-status-chart.tsx +++ b/src/features/dashboard/components/order-status-chart.tsx @@ -11,24 +11,19 @@ import { } from 'recharts'; import { orderStatusMeta } from '@/features/orders'; -import { type OrderStatusType } from '@/graphql/generated/graphql'; import { formatCount } from '@/shared/lib/format'; import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/shared/ui/card'; +import { ORDER_COUNT_KEYS } from '../order-count-keys'; import { type DashboardSummary } from './types'; -// 라벨은 주문 화면과 한 벌(주문 확정 등) -const STATUS: { key: keyof DashboardSummary['orderCounts']; status: OrderStatusType }[] = [ - { key: 'submitted', status: 'SUBMITTED' }, - { key: 'confirmed', status: 'CONFIRMED' }, - { key: 'made', status: 'MADE' }, - { key: 'pickedUp', status: 'PICKED_UP' }, - { key: 'canceled', status: 'CANCELED' }, -]; +// 흐름 밖에서 끝난 상태는 회색으로 가른다 +const MUTED = new Set(['noShow', 'canceled']); -/** 기간 내 주문 상태 분포. 단일 계열(진행 단계)이라 색 1개, 취소만 회색. 표는 스크린리더·색각 보조용. */ +/** 기간 내 주문 상태 분포. 단일 계열(진행 단계)이라 색 1개, 노쇼·취소만 회색. 표는 스크린리더·색각 보조용. */ export function OrderStatusChart({ summary }: { summary: DashboardSummary }) { - const data = STATUS.map((s) => ({ + // 라벨은 주문 화면과 한 벌(주문 확정 등) + const data = ORDER_COUNT_KEYS.map((s) => ({ key: s.key, label: orderStatusMeta(s.status).label, count: summary.orderCounts[s.key], @@ -73,10 +68,7 @@ export function OrderStatusChart({ summary }: { summary: DashboardSummary }) { /> {data.map((d) => ( - + ))} = { + pendingPayment: 'PENDING_PAYMENT', + submitted: 'SUBMITTED', + confirmed: 'CONFIRMED', + made: 'MADE', + pickedUp: 'PICKED_UP', + noShow: 'NO_SHOW', + canceled: 'CANCELED', +}; + +/** 흐름 순서(차트 막대 순서) */ +export const ORDER_COUNT_KEYS = (Object.keys(STATUS_BY_KEY) as CountKey[]).map((key) => ({ + key, + status: STATUS_BY_KEY[key], +})); + +export const orderCountTotal = (counts: DashboardSummary['orderCounts']) => + ORDER_COUNT_KEYS.reduce((sum, { key }) => sum + counts[key], 0); diff --git a/src/features/dashboard/pages/dashboard-page.spec.tsx b/src/features/dashboard/pages/dashboard-page.spec.tsx index bff5430..5df2093 100644 --- a/src/features/dashboard/pages/dashboard-page.spec.tsx +++ b/src/features/dashboard/pages/dashboard-page.spec.tsx @@ -22,7 +22,15 @@ const summary = { to: 'y', newUserCount: 128, newSellerCount: 3, - orderCounts: { submitted: 21, confirmed: 34, made: 18, pickedUp: 78, canceled: 12 }, + orderCounts: { + pendingPayment: 5, + submitted: 21, + confirmed: 34, + made: 18, + pickedUp: 78, + noShow: 2, + canceled: 12, + }, orderAmountSum: 4812000, activeStoreCount: 42, activeProductCount: 517, @@ -66,7 +74,7 @@ describe('DashboardPage', () => { ); boot(); expect(await screen.findByText('4,812,000원')).toBeInTheDocument(); - expect(screen.getByText('주문 163건')).toBeInTheDocument(); + expect(screen.getByText('주문 170건')).toBeInTheDocument(); expect(screen.getByText('7건')).toBeInTheDocument(); expect(screen.getByRole('link', { name: '처리 필요' })).toHaveAttribute('href', '/reports'); const table = screen.getByRole('table', { name: '주문 상태별 건수' }); @@ -91,10 +99,12 @@ describe('DashboardPage', () => { ); it.each([ + ['입금 대기', '5건'], ['접수', '21건'], ['주문 확정', '34건'], ['제작 완료', '18건'], ['픽업 완료', '78건'], + ['노쇼', '2건'], ['취소', '12건'], ])('상태 분포 표에서 %s는 %s', async (label, count) => { server.use( @@ -107,9 +117,24 @@ describe('DashboardPage', () => { expect(header.closest('tr')).toHaveTextContent(`${label}${count}`); }); + it('상태 분포는 흐름 순서 뒤에 종료 상태로 7개 상태를 모두 싣고 주문 금액은 입금 대기를 뺀다', async () => { + server.use( + gqlOk('AdminDashboardSummary', { adminDashboardSummary: summary }), + gqlOk('AdminSearchKeywordSnapshot', { adminSearchKeywordSnapshot: snapshot }), + ); + boot(); + const table = await screen.findByRole('table', { name: '주문 상태별 건수' }); + expect( + within(table) + .getAllByRole('rowheader') + .map((h) => h.textContent), + ).toEqual(['입금 대기', '접수', '주문 확정', '제작 완료', '픽업 완료', '노쇼', '취소']); + expect(screen.getByText('주문 금액 (취소·입금 대기 제외)')).toBeInTheDocument(); + }); + // CardHeader는 grid라 flex-row를 덧붙여도 한 줄이 되지 않았다. 보조 문구는 CardDescription 자리에 둔다 it.each([ - ['주문 상태 분포', '기간 내 주문 163건'], + ['주문 상태 분포', '기간 내 주문 170건'], ['검색어 순위', '09-27 17:00 기준 집계'], ])('%s 카드의 보조 문구는 카드 설명 자리에 있다', async (title, caption) => { server.use( diff --git a/src/features/orders/api/queries.ts b/src/features/orders/api/queries.ts index cb08804..dacb707 100644 --- a/src/features/orders/api/queries.ts +++ b/src/features/orders/api/queries.ts @@ -1,7 +1,7 @@ import { type QueryClient, queryOptions } from '@tanstack/react-query'; import { graphql } from '@/graphql/generated'; -import { type AdminOrderListInput } from '@/graphql/generated/graphql'; +import { type AdminCancelOrderInput, type AdminOrderListInput } from '@/graphql/generated/graphql'; import { gqlRequest } from '@/shared/api'; import { type EntityOption } from '@/shared/ui/entity-picker'; @@ -14,7 +14,7 @@ const ordersKeys = { // 필터 선택기·링크 이름. 매장·구매자 화면의 캐시와 섞이지 않게 주문 아래에 둔다 storeOptions: (keyword: string) => [...ordersKeys.all, 'store-options', keyword] as const, buyerOptions: (keyword: string) => [...ordersKeys.all, 'buyer-options', keyword] as const, - storeName: (storeId: string) => [...ordersKeys.all, 'store-name', storeId] as const, + store: (storeId: string) => [...ordersKeys.all, 'store', storeId] as const, buyerName: (accountId: string) => [...ordersKeys.all, 'buyer-name', accountId] as const, }; @@ -57,6 +57,25 @@ const AdminOrderDocument = graphql(/* GraphQL */ ` pickupAt buyerName buyerPhone + requestNote + payment { + method + status + amount + depositorName + depositBank { + code + name + } + depositAccountNumber + depositAccountHolder + expiresAt + buyerClaimedAt + confirmedAt + confirmSource + confirmedByLabel + confirmNote + } subtotalPrice discountPrice totalPrice @@ -125,7 +144,59 @@ const AdminOrderDocument = graphql(/* GraphQL */ ` toStatus changedAt note + actorType + cancelReason + cancelFault + refundAmount + } + refunds { + id + kind + amount + status + bank { + code + name + } + accountHolder + accountNumberMasked + requestedAt + accountSubmittedAt + completedAt + } + cancellation { + actorType + reason + reasonLabel + note + fault + refundAmount + refundStatus + refundCompletedAt + canceledAt + } + cancelOptions { + cancelable + reasons + refundRule + paidAmount + } + confirmDeadlineAt + autoPickupAt + noShowAt + pickupChanges { + id + fromPickupAt + toPickupAt + changedAt + note } + commissionRateBps + expectedPayoutAmount + settlementBaseAmount + commissionAmount + settlementFinalizedAt + settlementId } } `); @@ -163,6 +234,7 @@ const AdminOrdersStoreNameDocument = graphql(/* GraphQL */ ` store { id storeName + isActive } } } @@ -188,6 +260,15 @@ const AdminCancelOrderDocument = graphql(/* GraphQL */ ` } `); +const AdminCompleteOrderPickupDocument = graphql(/* GraphQL */ ` + mutation AdminCompleteOrderPickup($input: AdminCompleteOrderPickupInput!) { + adminCompleteOrderPickup(input: $input) { + id + status + } + } +`); + export function ordersListQueryOptions(input: AdminOrderListInput) { return queryOptions({ queryKey: ordersKeys.list(input), @@ -248,12 +329,12 @@ export function buyerOptionsQueryOptions(keyword: string) { }); } -/** 주소로 들어온 매장 ID의 이름. 찾지 못하면 오류로 두고 부르는 쪽은 #ID를 보인다 */ -export function storeNameQueryOptions(storeId: string) { +/** 매장 이름·숨김 여부. 찾지 못하면 오류로 두고 부르는 쪽은 #ID를 보인다 */ +export function storeRefQueryOptions(storeId: string) { return queryOptions({ - queryKey: ordersKeys.storeName(storeId), + queryKey: ordersKeys.store(storeId), queryFn: async () => - (await gqlRequest(AdminOrdersStoreNameDocument, { storeId })).adminStore.store.storeName, + (await gqlRequest(AdminOrdersStoreNameDocument, { storeId })).adminStore.store, retry: false, }); } @@ -267,14 +348,35 @@ export function buyerNameQueryOptions(accountId: string) { }); } -/** 사유 코드 선택은 아직 없어 '기타' + 입력한 메모로 보낸다 */ -export async function cancelOrder(queryClient: QueryClient, orderId: string, note: string) { - const result = ( - await gqlRequest(AdminCancelOrderDocument, { input: { orderId, reason: 'OTHER', note } }) - ).adminCancelOrder; - await Promise.all([ - queryClient.invalidateQueries({ queryKey: ordersKeys.detail(orderId) }), - queryClient.invalidateQueries({ queryKey: ordersKeys.lists() }), - ]); - return result; +/** 처리했든 거절됐든(다른 곳에서 상태가 바뀐 경우 등) 상세·목록을 다시 불러 지금 상태와 선택지를 보인다 */ +async function withRefresh(queryClient: QueryClient, orderId: string, run: () => Promise) { + try { + return await run(); + } finally { + await Promise.all([ + queryClient.invalidateQueries({ queryKey: ordersKeys.detail(orderId) }), + queryClient.invalidateQueries({ queryKey: ordersKeys.lists() }), + ]); + } +} + +export function cancelOrder(queryClient: QueryClient, input: AdminCancelOrderInput) { + return withRefresh( + queryClient, + String(input.orderId), + async () => (await gqlRequest(AdminCancelOrderDocument, { input })).adminCancelOrder, + ); +} + +export function completeOrderPickup(queryClient: QueryClient, orderId: string, note: string) { + return withRefresh( + queryClient, + orderId, + async () => + ( + await gqlRequest(AdminCompleteOrderPickupDocument, { + input: { orderId, note: note || null }, + }) + ).adminCompleteOrderPickup, + ); } diff --git a/src/features/orders/auto-transition.spec.ts b/src/features/orders/auto-transition.spec.ts new file mode 100644 index 0000000..6290fcb --- /dev/null +++ b/src/features/orders/auto-transition.spec.ts @@ -0,0 +1,67 @@ +import { type OrderStatusType } from '@/graphql/generated/graphql'; + +import { autoTransitionNote } from './auto-transition'; + +const payment = (buyerClaimedAt: string | null) => ({ + method: 'BANK_TRANSFER' as const, + status: 'PENDING' as const, + amount: 30000, + depositorName: '김서연', + depositAccountNumber: '1002123456789', + depositAccountHolder: '케이퀵', + expiresAt: '2026-11-19T01:00:00.000Z', + buyerClaimedAt, + confirmedAt: null, + confirmSource: null, + confirmedByLabel: null, + confirmNote: null, + depositBank: { code: '020', name: '우리은행' }, +}); +const order = (status: OrderStatusType, patch: object = {}) => ({ + status, + payment: payment(null), + confirmDeadlineAt: null, + autoPickupAt: null, + ...patch, +}); +const AT = '2026-11-20T05:00:00.000Z'; + +describe('autoTransitionNote', () => { + it.each([ + [ + '입금 대기는 입금 기한', + order('PENDING_PAYMENT'), + false, + '11-19 10:00까지 입금이 확인되지 않으면 자동 취소됩니다.', + ], + [ + "'입금했어요'를 누른 입금 대기는 자동 취소에서 빠진다", + order('PENDING_PAYMENT', { payment: payment('2026-11-19T00:30:00.000Z') }), + false, + '구매자가 11-19 09:30에 입금했다고 알려 자동 취소되지 않습니다. 입금을 확인하거나 미입금으로 취소하세요.', + ], + [ + '접수는 확정 마감', + order('SUBMITTED', { confirmDeadlineAt: AT }), + true, + '11-20 14:00까지 판매자가 확정하지 않으면 자동 취소·전액 환불됩니다.', + ], + [ + '확정은 자동 픽업 완료', + order('CONFIRMED', { autoPickupAt: AT }), + false, + '11-20 14:00에 자동으로 픽업 완료됩니다.', + ], + [ + '숨김 매장의 제작 완료는 직접 처리 안내', + order('MADE', { autoPickupAt: AT }), + true, + '매장이 숨김이라 11-20 14:00에 자동 픽업 완료되지 않습니다. 픽업 완료나 강제 취소로 직접 처리하세요.', + ], + ['결제 도입 전 입금 대기는 없음', order('PENDING_PAYMENT', { payment: null }), false, null], + ['결제 도입 전 접수(마감 null)는 없음', order('SUBMITTED'), false, null], + ['종료 상태는 없음', order('PICKED_UP'), false, null], + ])('%s', (_, o, hidden, note) => { + expect(autoTransitionNote(o, hidden)).toBe(note); + }); +}); diff --git a/src/features/orders/auto-transition.ts b/src/features/orders/auto-transition.ts new file mode 100644 index 0000000..bc4166c --- /dev/null +++ b/src/features/orders/auto-transition.ts @@ -0,0 +1,25 @@ +import { type AdminOrderQuery } from '@/graphql/generated/graphql'; +import { formatKst } from '@/shared/lib/kst'; + +type Order = Pick< + AdminOrderQuery['adminOrder'], + 'status' | 'payment' | 'confirmDeadlineAt' | 'autoPickupAt' +>; + +/** 지금 상태에서 시스템이 언제 무엇을 할지. 숨김 매장은 자동 픽업 완료가 돌지 않는다 */ +export function autoTransitionNote(o: Order, storeHidden: boolean): string | null { + if (o.status === 'PENDING_PAYMENT' && o.payment) { + return o.payment.buyerClaimedAt + ? `구매자가 ${formatKst(o.payment.buyerClaimedAt)}에 입금했다고 알려 자동 취소되지 않습니다. 입금을 확인하거나 미입금으로 취소하세요.` + : `${formatKst(o.payment.expiresAt)}까지 입금이 확인되지 않으면 자동 취소됩니다.`; + } + if (o.status === 'SUBMITTED' && o.confirmDeadlineAt) { + return `${formatKst(o.confirmDeadlineAt)}까지 판매자가 확정하지 않으면 자동 취소·전액 환불됩니다.`; + } + if (o.autoPickupAt) { + return storeHidden + ? `매장이 숨김이라 ${formatKst(o.autoPickupAt)}에 자동 픽업 완료되지 않습니다. 픽업 완료나 강제 취소로 직접 처리하세요.` + : `${formatKst(o.autoPickupAt)}에 자동으로 픽업 완료됩니다.`; + } + return null; +} diff --git a/src/features/orders/cancel-form.spec.ts b/src/features/orders/cancel-form.spec.ts new file mode 100644 index 0000000..9468ee8 --- /dev/null +++ b/src/features/orders/cancel-form.spec.ts @@ -0,0 +1,158 @@ +import { type CancelRefundRuleType } from '@/graphql/generated/graphql'; + +import { + CANCEL_NOTE_MAX, + type CancelForm, + type CancelOptions, + EMPTY_CANCEL_FORM, + buildCancelInput, + cancelSummary, + noteLength, + parseRefundAmount, +} from './cancel-form'; + +const PAID = 30000; +const options = (refundRule: CancelRefundRuleType | null, paidAmount = PAID): CancelOptions => ({ + cancelable: refundRule !== null, + reasons: ['OUT_OF_MATERIALS', 'OTHER'], + refundRule, + paidAmount, +}); +const form = (patch: Partial = {}): CancelForm => ({ + ...EMPTY_CANCEL_FORM, + reason: 'OTHER', + ...patch, +}); +const base = { orderId: '0', reason: 'OTHER', note: null }; + +describe('buildCancelInput', () => { + const FAULTS = ['', 'SELLER', 'BUYER'] as const; + const AMOUNTS = ['', '0', ' 7 ', '30000', '30001', '-1', '1.5', '1e3', '3']; + + /** 기대값은 구현과 따로: BY_FAULT만 사정을 묻고, 구매자 사정만 0~결제액 정수 금액을 받는다 */ + function expected(rule: CancelRefundRuleType, fault: string, amount: string) { + if (rule !== 'BY_FAULT') return { input: base }; + if (fault === '') return { issue: 'FAULT_REQUIRED' }; + if (fault === 'SELLER') return { input: { ...base, fault: 'SELLER' } }; + if (amount === '') return { issue: 'AMOUNT_REQUIRED' }; + const ok: Record = { '0': 0, ' 7 ': 7, '30000': 30000 }; + return amount in ok + ? { input: { ...base, fault: 'BUYER', refundAmount: ok[amount] } } + : { issue: 'AMOUNT_OUT_OF_RANGE' }; + } + + const cases = (['NO_REFUND', 'FULL_REFUND', 'BY_FAULT'] as const).flatMap((rule) => + FAULTS.flatMap((fault) => + AMOUNTS.map((amount) => [rule, fault, amount, expected(rule, fault, amount)] as const), + ), + ); + + it('표는 규칙 3 × 사정 3 × 금액 9를 덮고 금액을 보내는 경우는 3개다', () => { + expect(cases).toHaveLength(81); + const withAmount = cases.filter(([, , , r]) => 'refundAmount' in (r.input ?? {})); + expect(withAmount).toHaveLength(3); + }); + + it.each(cases)('%s fault=%j 금액=%j → %j', (rule, fault, refundAmount, result) => { + // ID "0"도 그대로 보낸다 + expect(buildCancelInput('0', options(rule), form({ fault, refundAmount }))).toEqual(result); + }); + + it('결제액이 0이면 구매자 사정 금액은 0만 받는다', () => { + const o = options('BY_FAULT', 0); + expect(buildCancelInput('1', o, form({ fault: 'BUYER', refundAmount: '0' }))).toMatchObject({ + input: { refundAmount: 0 }, + }); + expect(buildCancelInput('1', o, form({ fault: 'BUYER', refundAmount: '1' }))).toEqual({ + issue: 'AMOUNT_OUT_OF_RANGE', + }); + }); + + it.each([ + ['고르지 않은 사유', { reason: '' }], + ['선택지에 없는 사유', { reason: 'PAYMENT_NOT_RECEIVED' }], + ['프로토타입 키', { reason: 'constructor' }], + ])('%s는 REASON_REQUIRED', (_, patch) => { + expect(buildCancelInput('1', options('FULL_REFUND'), form(patch))).toEqual({ + issue: 'REASON_REQUIRED', + }); + }); + + it('취소할 수 없는 주문은 입력과 관계없이 NOT_CANCELABLE', () => { + expect(buildCancelInput('1', { ...options('FULL_REFUND'), cancelable: false }, form())).toEqual( + { issue: 'NOT_CANCELABLE' }, + ); + }); + + it.each([ + ['앞뒤 공백은 빼고 보낸다', ' 재고 없음 ', '재고 없음'], + ['공백만이면 null', ' ', null], + ['이모지 500자는 받는다', '🎂'.repeat(CANCEL_NOTE_MAX), '🎂'.repeat(CANCEL_NOTE_MAX)], + ])('메모: %s', (_, note, sent) => { + expect(buildCancelInput('1', options('FULL_REFUND'), form({ note }))).toEqual({ + input: { orderId: '1', reason: 'OTHER', note: sent }, + }); + }); + + it('메모는 코드 포인트 501자부터 NOTE_TOO_LONG', () => { + expect(noteLength(` ${'🎂'.repeat(CANCEL_NOTE_MAX)} `)).toBe(CANCEL_NOTE_MAX); + expect( + buildCancelInput('1', options('NO_REFUND'), form({ note: 'a'.repeat(CANCEL_NOTE_MAX + 1) })), + ).toEqual({ issue: 'NOTE_TOO_LONG' }); + }); +}); + +describe('parseRefundAmount', () => { + it.each([ + ['0', 0], + ['007', 7], + ['30000', 30000], + ['30001', null], + ['', null], + ['1,000', null], + ['99999999999999999999', null], + ])('%j → %s', (raw, n) => { + expect(parseRefundAmount(raw, PAID)).toBe(n); + }); +}); + +describe('cancelSummary', () => { + it.each([ + ['NO_REFUND', {}, PAID, '입금 전 주문이라 환불 없이 취소합니다.'], + ['FULL_REFUND', {}, PAID, '결제액 30,000원을 전액 환불합니다.'], + ['FULL_REFUND', {}, 0, '확인된 결제액이 없어 환불 없이 취소합니다.'], + ['BY_FAULT', {}, PAID, '사정을 고르면 환불 금액이 정해집니다.'], + ['BY_FAULT', { fault: 'SELLER' }, PAID, '판매자 사정이라 결제액 30,000원을 전액 환불합니다.'], + [ + 'BY_FAULT', + { fault: 'BUYER', refundAmount: '0' }, + PAID, + '0원을 환불하고, 남은 30,000원은 수수료를 뺀 뒤 매장 정산에 포함합니다.', + ], + [ + 'BY_FAULT', + { fault: 'BUYER', refundAmount: '10000' }, + PAID, + '10,000원을 환불하고, 남은 20,000원은 수수료를 뺀 뒤 매장 정산에 포함합니다.', + ], + [ + 'BY_FAULT', + { fault: 'BUYER', refundAmount: '30000' }, + PAID, + '결제액 30,000원을 전액 환불합니다.', + ], + [ + 'BY_FAULT', + { fault: 'BUYER', refundAmount: '' }, + PAID, + '환불 금액을 0원~30,000원 사이 정수로 입력하세요.', + ], + ] as const)('%s %j 결제액 %i → %s', (rule, patch, paid, text) => { + expect(cancelSummary(options(rule, paid), form(patch))).toBe(text); + }); + + it('취소할 수 없거나 모르는 규칙이면 요약이 없다', () => { + expect(cancelSummary(options(null), form())).toBeNull(); + expect(cancelSummary(options('PARTIAL' as CancelRefundRuleType), form())).toBeNull(); + }); +}); diff --git a/src/features/orders/cancel-form.ts b/src/features/orders/cancel-form.ts new file mode 100644 index 0000000..4826dfc --- /dev/null +++ b/src/features/orders/cancel-form.ts @@ -0,0 +1,82 @@ +import { + type AdminCancelOrderInput, + type AdminOrderQuery, + type OrderCancelFaultType, +} from '@/graphql/generated/graphql'; +import { formatKrw } from '@/shared/lib/format'; + +export type CancelOptions = AdminOrderQuery['adminOrder']['cancelOptions']; + +export const CANCEL_NOTE_MAX = 500; + +export interface CancelForm { + /** '' = 고르지 않음 */ + reason: string; + fault: '' | OrderCancelFaultType; + /** 입력 원문 */ + refundAmount: string; + note: string; +} + +export const EMPTY_CANCEL_FORM: CancelForm = { reason: '', fault: '', refundAmount: '', note: '' }; + +export type CancelFormIssue = + | 'NOT_CANCELABLE' + | 'REASON_REQUIRED' + | 'NOTE_TOO_LONG' + | 'FAULT_REQUIRED' + | 'AMOUNT_REQUIRED' + | 'AMOUNT_OUT_OF_RANGE'; + +/** BE처럼 앞뒤 공백을 뺀 코드 포인트 수(이모지도 1자) */ +export const noteLength = (note: string) => [...note.trim()].length; + +/** 사정을 고르는 규칙인지. 금액 입력은 그중 구매자 사정일 때만 */ +export const asksFault = (o: CancelOptions) => o.refundRule === 'BY_FAULT'; +export const asksAmount = (o: CancelOptions, f: CancelForm) => asksFault(o) && f.fault === 'BUYER'; + +/** 구매자 사정 환불액. 0~결제액 정수만 받고 아니면 null('0'은 유효) */ +export function parseRefundAmount(raw: string, paidAmount: number): number | null { + const t = raw.trim(); + if (!/^\d+$/.test(t)) return null; + const n = Number(t); + return n <= paidAmount ? n : null; +} + +/** 다이얼로그 입력 → adminCancelOrder 입력. 규칙은 cancelOptions가 정하고 화면은 복제하지 않는다 */ +export function buildCancelInput( + orderId: string, + o: CancelOptions, + f: CancelForm, +): { input: AdminCancelOrderInput } | { issue: CancelFormIssue } { + if (!o.cancelable) return { issue: 'NOT_CANCELABLE' }; + const reason = o.reasons.find((r) => r === f.reason); + if (!reason) return { issue: 'REASON_REQUIRED' }; + if (noteLength(f.note) > CANCEL_NOTE_MAX) return { issue: 'NOTE_TOO_LONG' }; + const base = { orderId, reason, note: f.note.trim() || null }; + if (!asksFault(o)) return { input: base }; + if (f.fault === '') return { issue: 'FAULT_REQUIRED' }; + if (f.fault === 'SELLER') return { input: { ...base, fault: 'SELLER' } }; + if (f.refundAmount.trim() === '') return { issue: 'AMOUNT_REQUIRED' }; + const refundAmount = parseRefundAmount(f.refundAmount, o.paidAmount); + if (refundAmount === null) return { issue: 'AMOUNT_OUT_OF_RANGE' }; + return { input: { ...base, fault: 'BUYER', refundAmount } }; +} + +/** 확인 버튼 위 요약. 고른 사정·금액으로 무엇이 일어나는지 */ +export function cancelSummary(o: CancelOptions, f: CancelForm): string | null { + const paid = formatKrw(o.paidAmount); + const full = + o.paidAmount > 0 + ? `결제액 ${paid}을 전액 환불합니다.` + : '확인된 결제액이 없어 환불 없이 취소합니다.'; + if (o.refundRule === 'NO_REFUND') return '입금 전 주문이라 환불 없이 취소합니다.'; + if (o.refundRule === 'FULL_REFUND') return full; + if (!asksFault(o)) return null; + if (f.fault === 'SELLER') return `판매자 사정이라 ${full}`; + if (f.fault !== 'BUYER') return '사정을 고르면 환불 금액이 정해집니다.'; + const r = parseRefundAmount(f.refundAmount, o.paidAmount); + if (r === null) return `환불 금액을 0원~${paid} 사이 정수로 입력하세요.`; + if (r === o.paidAmount) return full; + return `${formatKrw(r)}을 환불하고, 남은 ${formatKrw(o.paidAmount - r)}은 수수료를 뺀 뒤 매장 정산에 포함합니다.`; +} diff --git a/src/features/orders/components/cancel-order-dialog.tsx b/src/features/orders/components/cancel-order-dialog.tsx index 779b879..e5a1f02 100644 --- a/src/features/orders/components/cancel-order-dialog.tsx +++ b/src/features/orders/components/cancel-order-dialog.tsx @@ -3,6 +3,8 @@ import { useState } from 'react'; import { toast } from 'sonner'; import { messageFor } from '@/shared/api'; +import { formatKrw } from '@/shared/lib/format'; +import { cn } from '@/shared/lib/utils'; import { Button } from '@/shared/ui/button'; import { Dialog, @@ -13,34 +15,57 @@ import { DialogTitle, DialogTrigger, } from '@/shared/ui/dialog'; +import { Input } from '@/shared/ui/input'; import { Label } from '@/shared/ui/label'; +import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/shared/ui/select'; import { Textarea } from '@/shared/ui/textarea'; import { cancelOrder } from '../api/queries'; +import { + CANCEL_NOTE_MAX, + type CancelForm, + type CancelOptions, + EMPTY_CANCEL_FORM, + asksAmount, + asksFault, + buildCancelInput, + cancelSummary, + noteLength, + parseRefundAmount, +} from '../cancel-form'; +import { cancelFaultLabel, cancelReasonLabel } from '../meta'; -const NOTE_MAX = 500; +const FAULTS = ['SELLER', 'BUYER'] as const; export function CancelOrderDialog({ orderId, orderNumber, + options, }: { orderId: string; orderNumber: string; + options: CancelOptions; }) { const queryClient = useQueryClient(); const [open, setOpen] = useState(false); - const [note, setNote] = useState(''); + const [form, setForm] = useState(EMPTY_CANCEL_FORM); const [busy, setBusy] = useState(false); - const trimmed = note.trim(); - const invalid = trimmed.length === 0 || trimmed.length > NOTE_MAX; + const set = (patch: Partial) => setForm((f) => ({ ...f, ...patch })); + const built = buildCancelInput(orderId, options, form); + const summary = cancelSummary(options, form); + const noteLen = noteLength(form.note); + const amountInvalid = + form.refundAmount.trim() !== '' && + parseRefundAmount(form.refundAmount, options.paidAmount) === null; const submit = async () => { + if (!('input' in built)) return; setBusy(true); try { - await cancelOrder(queryClient, orderId, trimmed); + await cancelOrder(queryClient, built.input); toast.success(`${orderNumber} 주문을 취소했습니다.`); setOpen(false); - setNote(''); + setForm(EMPTY_CANCEL_FORM); } catch (e) { toast.error(messageFor(e)); } finally { @@ -52,38 +77,128 @@ export function CancelOrderDialog({ - 주문을 취소할까요? + 주문을 강제 취소할까요? - {orderNumber} 주문을 취소하면 구매자에게 취소 알림을 보냅니다. 사유는 상태 이력과 감사 - 로그에 남고, 취소한 주문은 되돌릴 수 없습니다. + {orderNumber} 주문을 취소하면 구매자에게 알림이 가고, 입금이 확인된 주문이면 + 판매자에게도 알립니다. 사유는 상태 이력과 감사 로그에 남고, 취소한 주문은 되돌릴 수 + 없습니다. -
- -