4 Commits
Author SHA1 Message Date
yml2213andCursor ca291a71a9 style: 修复 AdminLayout Prettier 格式
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-15 13:49:24 +08:00
yml2213andCursor acfe7fd07e style: 修复订单与调度相关 Prettier 格式
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-15 13:48:43 +08:00
yml2213andCursor 40278a68fc chore(logging): 降噪 PDD 同步与发单消费者常态日志
将无新单/全跳过的处理完成日志降到 debug,并压缩 decisions 详情,避免 app 日志被按日切碎。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-15 13:48:30 +08:00
yml2213andCursor 40c51e1d8e fix(admin): 订单列表默认近7天并按支付时间筛选
避免无日期过滤时展示全库,关键词搜索不受日期限制;SSE 插入裁剪并尊重筛选,新单入库优先使用平台支付时间。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-15 13:41:29 +08:00
11 changed files with 398 additions and 106 deletions
@@ -15,8 +15,8 @@ test('订单列表综合筛选下推到总数和分页查询', async () => {
executorKey: 'affiliate_dash',
payStatus: 'paid',
taskStatus: 'manual_review',
dateFrom: '2026-09-01T00:00:00.000Z',
dateTo: '2026-09-02T23:59:59.999Z',
dateFrom: '2026-09-01',
dateTo: '2026-09-02',
})
assert.equal(result.total, 3)
@@ -24,25 +24,37 @@ test('订单列表综合筛选下推到总数和分页查询', async () => {
assert.match(calls[0]?.sql || '', /o\.platform_order_id.*ILIKE \$1/s)
assert.match(calls[0]?.sql || '', /oi\.sku_code.*oi\.sku_name.*ILIKE \$1/s)
assert.match(calls[0]?.sql || '', /kuaishouSendCode'.*itemTitle.*kuaishouSendCode'.*skuNick/s)
assert.match(calls[0]?.sql || '', /o\.provider = \$2/)
assert.match(calls[0]?.sql || '', /o\.pay_status = \$3/)
assert.match(calls[0]?.sql || '', /ft\.task_status = \$4/)
assert.match(calls[0]?.sql || '', /ft\.executor_key = \$5/)
assert.match(calls[0]?.sql || '', /o\.created_at >= \$6/)
assert.match(calls[0]?.sql || '', /o\.created_at <= \$7/)
assert.deepEqual(calls[0]?.params, [
'%皮肤店%',
'91kaquan',
'paid',
'manual_review',
'affiliate_dash',
'2026-09-01T00:00:00.000Z',
'2026-09-02T23:59:59.999Z',
])
assert.match(calls[1]?.sql || '', /LIMIT \$8 OFFSET \$9/)
assert.match(calls[0]?.sql || '', /o\.provider IN \('91kaquan', 'open_91', '91'\)/)
assert.match(calls[0]?.sql || '', /o\.pay_status = \$2/)
assert.match(calls[0]?.sql || '', /ft\.task_status = \$3/)
assert.match(calls[0]?.sql || '', /ft\.executor_key = \$4/)
// 有关键词时不应用日期过滤
assert.doesNotMatch(calls[0]?.sql || '', /paid_at/i)
assert.deepEqual(calls[0]?.params, ['%皮肤店%', 'paid', 'manual_review', 'affiliate_dash'])
assert.match(calls[1]?.sql || '', /LIMIT \$5 OFFSET \$6/)
assert.deepEqual(calls[1]?.params, [...(calls[0]?.params || []), 10, 10])
})
test('订单列表无关键词时按支付时间与中国时区日期筛选', async () => {
const calls: Array<{ sql: string; params: unknown[] }> = []
await listOrdersWithExecutor(createExecutor(calls, 0), {
dateFrom: '2026-09-01',
dateTo: '2026-09-07',
})
assert.match(
calls[0]?.sql || '',
/COALESCE\(o\.paid_at, o\.created_at\) >= \(\$1::date\)::timestamp AT TIME ZONE 'Asia\/Shanghai'/,
)
assert.match(
calls[0]?.sql || '',
/COALESCE\(o\.paid_at, o\.created_at\) < \(\(\$2::date \+ 1\)::timestamp AT TIME ZONE 'Asia\/Shanghai'\)/,
)
assert.deepEqual(calls[0]?.params, ['2026-09-01', '2026-09-07'])
assert.match(calls[1]?.sql || '', /ORDER BY COALESCE\(o\.paid_at, o\.created_at\) DESC/)
})
test('订单列表保留订单号和精确 SKU 旧筛选参数兼容', async () => {
const calls: Array<{ sql: string; params: unknown[] }> = []
+44 -9
View File
@@ -295,8 +295,7 @@ export async function listOrdersWithExecutor(
}
if (provider) {
params.push(provider)
filters.push(`o.provider = $${params.length}`)
appendProviderFilter(filters, params, provider)
}
if (platformOrderId) {
@@ -339,14 +338,20 @@ export async function listOrdersWithExecutor(
)
}
if (dateFrom) {
params.push(dateFrom)
filters.push(`o.created_at >= $${params.length}`)
// 有关键词时不限日期,避免默认近 N 天挡住搜单号/商品。
const applyDateFilter = Boolean(dateFrom || dateTo) && !String(keyword || '').trim()
if (applyDateFilter && dateFrom) {
params.push(String(dateFrom).trim().slice(0, 10))
filters.push(
`COALESCE(o.paid_at, o.created_at) >= ($${params.length}::date)::timestamp AT TIME ZONE 'Asia/Shanghai'`,
)
}
if (dateTo) {
params.push(dateTo)
filters.push(`o.created_at <= $${params.length}`)
if (applyDateFilter && dateTo) {
params.push(String(dateTo).trim().slice(0, 10))
filters.push(
`COALESCE(o.paid_at, o.created_at) < (($${params.length}::date + 1)::timestamp AT TIME ZONE 'Asia/Shanghai')`,
)
}
const whereClause = filters.length > 0 ? `WHERE ${filters.join(' AND ')}` : ''
@@ -362,7 +367,7 @@ export async function listOrdersWithExecutor(
SELECT o.*
FROM orders o
${whereClause}
ORDER BY o.id DESC
ORDER BY COALESCE(o.paid_at, o.created_at) DESC NULLS LAST, o.id DESC
LIMIT $${params.length - 1} OFFSET $${params.length}
`,
params,
@@ -373,3 +378,33 @@ export async function listOrdersWithExecutor(
total: Number(totalResult.rows[0]?.total || 0),
}
}
/** 来源渠道筛选:兼容历史 provider / platform 多种写法。 */
function appendProviderFilter(filters: string[], params: unknown[], provider: string) {
const normalized = String(provider || '')
.trim()
.toLowerCase()
if (!normalized) {
return
}
if (normalized === 'pdd') {
filters.push(`(o.provider = 'pdd' OR o.platform = 'pdd')`)
return
}
if (normalized === '91' || normalized === '91kaquan' || normalized === 'open_91') {
filters.push(
`(o.provider IN ('91kaquan', 'open_91', '91') OR o.platform IN ('91kaquan', '91'))`,
)
return
}
if (normalized === 'kuaishou' || normalized === 'kuaishou-industry') {
filters.push(`(o.provider LIKE 'kuaishou%' OR o.platform LIKE 'kuaishou%')`)
return
}
params.push(provider)
filters.push(`(o.provider = $${params.length} OR o.platform = $${params.length})`)
}
@@ -24,6 +24,7 @@ import { createHttpError } from '../../utils/http.js'
import { formatFenToAmount, normalizeFen } from '../../utils/money.js'
import {
normalizeDateQuery,
normalizeDateString,
normalizePage,
normalizePageSize,
safeParseJson,
@@ -94,8 +95,8 @@ export async function getAdminOrders(
payStatus: String(query.payStatus || '').trim(),
taskStatus: String(query.taskStatus || '').trim(),
skuCode: String(query.skuCode || '').trim(),
dateFrom: normalizeDateQuery(query.dateFrom),
dateTo: normalizeDateQuery(query.dateTo, true),
dateFrom: normalizeDateString(query.dateFrom),
dateTo: normalizeDateString(query.dateTo),
})
const orderIds = items.map((item) => Number(item.id)).filter((id) => id > 0)
@@ -17,7 +17,7 @@ import {
publishWorkOrderRealtimeChange,
} from '../realtime/realtime-event-service.js'
import { nowIso } from '../../utils/time.js'
import { logInfo, logIntegration, logWarn } from '../../utils/logger.js'
import { logDebug, logInfo, logIntegration, logWarn } from '../../utils/logger.js'
import { createHttpError } from '../../utils/http.js'
import type { OrderItemRow, OrderRow, TaskRow } from '../../types/repository/rows.js'
@@ -156,7 +156,8 @@ export async function upsertOrderFromSource(
: await createOrderWithExecutor(executor, {
...basePayload,
...mergedPayload,
createdAt: now,
// 优先用平台支付/成团时间,避免积压同步把历史单排成「刚刚入库」。
createdAt: String(event.paidAt || now).trim() || now,
updatedAt: now,
})
@@ -210,21 +211,14 @@ export async function upsertOrderFromSource(
source: `${sourceLabel}_order_upsert`,
autoOnly: true,
})
logInfo('[order-consumer-router]', '来源订单消费者分流完成', {
logDebug('[order-consumer-router]', '来源订单消费者分流完成(履约未就绪)', {
source: sourceLabel,
orderId: order.id,
platformOrderId: order.platform_order_id,
fulfillment: {
result: 'blocked',
reason: readiness.blockReason,
detail: readiness.reason,
orderItemIds: configuredOrderItems.map((item) => item.id),
},
workerPlatform: {
createdCount: workOrderSync.createdCount,
skippedCount: workOrderSync.skippedCount,
decisions: workOrderSync.decisions,
},
fulfillmentResult: 'blocked',
fulfillmentReason: readiness.blockReason || readiness.reason,
workerCreatedCount: workOrderSync.createdCount,
workerSkippedCount: workOrderSync.skippedCount,
})
publishSourceOrderRealtimeChanges(order.id, workOrderSync.created)
return {
@@ -352,33 +346,61 @@ function logOrderConsumerOutcome({
source: sourceLabel,
orderId: order.id,
platformOrderId: order.platform_order_id,
fulfillment: {
configuredOrderItemIds: Array.from(configuredItemIds),
taskIds: tasks.map((task) => task.id),
taskCount: tasks.length,
missingItems: missingFulfillmentItems,
},
workerPlatform: {
createdCount: workerCreatedCount,
skippedCount: workerSkippedCount,
decisions: workerDecisions,
},
dualConsumedOrderItemIds,
unhandledOrderItems,
fulfillmentTaskCount: tasks.length,
fulfillmentConfiguredCount: configuredItemIds.size,
fulfillmentMissingCount: missingFulfillmentItems.length,
workerCreatedCount,
workerSkippedCount,
workerSkipReasons: summarizeWorkerDecisionReasons(workerDecisions),
dualConsumedCount: dualConsumedOrderItemIds.length,
unhandledCount: unhandledOrderItems.length,
}
const hasSignal =
workerCreatedCount > 0 ||
tasks.length > 0 ||
missingFulfillmentItems.length > 0 ||
dualConsumedOrderItemIds.length > 0
// 常态 PDD 重拉:无履约任务、工单全跳过,仅 debug;避免 decisions 大对象撑爆日志文件。
if (hasSignal) {
logInfo('[order-consumer-router]', '来源订单消费者分流完成', detail)
} else {
logDebug('[order-consumer-router]', '来源订单消费者分流完成', detail)
}
logInfo('[order-consumer-router]', '来源订单消费者分流完成', detail)
if (missingFulfillmentItems.length > 0) {
logWarn('[order-consumer-router]', '已配置履约的订单项存在任务缺口', detail)
logWarn('[order-consumer-router]', '已配置履约的订单项存在任务缺口', {
...detail,
missingItems: missingFulfillmentItems.slice(0, 5),
})
}
if (dualConsumedOrderItemIds.length > 0) {
logWarn('[order-consumer-router]', '同一订单项被履约与发单平台消费者同时接收', detail)
logWarn('[order-consumer-router]', '同一订单项被履约与发单平台消费者同时接收', {
...detail,
dualConsumedOrderItemIds: dualConsumedOrderItemIds.slice(0, 20),
})
}
// 「未匹配接单规则」对大量 PDD 商品是常态,降到 debug;真正的缺口用上面的 missing 告警。
if (unhandledOrderItems.length > 0) {
logWarn('[order-consumer-router]', '订单项未被履约或发单平台消费者接收', detail)
logDebug('[order-consumer-router]', '订单项未被履约或发单平台消费者接收', {
...detail,
unhandledSkuCodes: unhandledOrderItems
.slice(0, 10)
.map((item) => String(item.skuCode || item.skuName || item.orderItemId)),
})
}
}
function summarizeWorkerDecisionReasons(decisions: Array<Record<string, unknown>>) {
const counts: Record<string, number> = {}
for (const decision of decisions) {
const reason = String(decision.reason || decision.result || 'unknown').trim() || 'unknown'
counts[reason] = (counts[reason] || 0) + 1
}
return Object.keys(counts).length > 0 ? JSON.stringify(counts) : ''
}
function resolveOrderItemRouteDiagnostic(item: OrderItemRow) {
const snapshot = parseOrderItemSnapshot(item.item_snapshot_json) || {}
const sendCode =
@@ -25,7 +25,7 @@ import {
import { findExistingPlatformOrderIds } from '../../../repositories/order-repo.js'
import { notifyPddCookieExpired } from '../../notification/domain-notifications.js'
import { upsertOrderFromSource } from '../../order/order-service.js'
import { logError, logInfo, logWarn } from '../../../utils/logger.js'
import { logDebug, logError, logInfo, logWarn } from '../../../utils/logger.js'
export interface SyncStoreOrdersOptions {
pageNumber?: number | undefined
@@ -44,6 +44,8 @@ export interface SyncStoreResult {
total: number
fetchedCount: number
upsertedCount: number
/** 本轮判定为库内未见过的新单数量(用于日志降噪,不等于 upsert 次数)。 */
newOrderCount: number
ignoredCount: number
failedCount: number
pagesFetched: number
@@ -108,6 +110,7 @@ export async function syncStoreOrders(
total: 0,
fetchedCount: 0,
upsertedCount: 0,
newOrderCount: 0,
ignoredCount: 0,
failedCount: 0,
pagesFetched: 0,
@@ -136,6 +139,7 @@ export async function syncStoreOrders(
let totalReported = 0
let totalFetched = 0
let totalUpserted = 0
let totalNewOrders = 0
let totalIgnored = 0
let totalFailed = 0
@@ -179,6 +183,7 @@ export async function syncStoreOrders(
const existingCountOnPage = existingOrderSns.size
const newCountOnPage = pageOrderSns.length - existingCountOnPage
totalNewOrders += Math.max(0, newCountOnPage)
const doUpsert = options.upsertFn || upsertOrderFromSource
@@ -205,7 +210,9 @@ export async function syncStoreOrders(
}
}
logInfo(
// 本页无新单时降到 debug,避免每 20s 一轮把日志打满。
const pageLog = newCountOnPage > 0 || totalFailed > 0 ? logInfo : logDebug
pageLog(
'[pdd-sync]',
`店铺 ${shopName} 第 ${currentPage} 页处理完成 (本页拉取: ${items.length}, 新单: ${newCountOnPage}, 库中已有: ${existingCountOnPage})`,
{
@@ -269,12 +276,16 @@ export async function syncStoreOrders(
totalOrders: totalReported,
}).catch(() => null)
logInfo('[pdd-sync]', `店铺 ${shopName} 同步完成 (共拉取 ${pagesFetched} 页)`, {
// 仅「真正新单 / 失败 / 多页回填」打 info;常态触达旧单后停页的空跑降到 debug。
const storeDoneLog =
totalNewOrders > 0 || totalFailed > 0 || pagesFetched > 1 ? logInfo : logDebug
storeDoneLog('[pdd-sync]', `店铺 ${shopName} 同步完成 (共拉取 ${pagesFetched} 页)`, {
shopId,
total: totalReported,
pagesFetched,
fetchedCount: totalFetched,
upsertedCount: totalUpserted,
newOrderCount: totalNewOrders,
ignoredCount: totalIgnored,
failedCount: totalFailed,
})
@@ -285,6 +296,7 @@ export async function syncStoreOrders(
total: totalReported,
fetchedCount: totalFetched,
upsertedCount: totalUpserted,
newOrderCount: totalNewOrders,
ignoredCount: totalIgnored,
failedCount: totalFailed,
pagesFetched,
@@ -319,6 +331,7 @@ export async function syncStoreOrders(
total: totalReported,
fetchedCount: totalFetched,
upsertedCount: totalUpserted,
newOrderCount: totalNewOrders,
ignoredCount: totalIgnored,
failedCount: totalFailed,
pagesFetched,
@@ -4,7 +4,7 @@
*/
import type { JsonObject } from '../../types/json.js'
import { logInfo } from '../../utils/logger.js'
import { logDebug, logInfo } from '../../utils/logger.js'
import { syncAllPddStores } from '../platforms/pdd/pdd-sync-service.js'
import { getPddSourcesConfig } from '../platforms/pdd/pdd-source-config-service.js'
@@ -39,24 +39,29 @@ export async function runPddOrderSyncJob(job: JsonObject) {
const failedCount = syncResult.results.filter((r) => Boolean(r.error)).length
const totalUpserted = syncResult.results.reduce((acc, r) => acc + r.upsertedCount, 0)
const totalFetched = syncResult.results.reduce((acc, r) => acc + r.fetchedCount, 0)
const totalNewOrders = syncResult.results.reduce((acc, r) => acc + r.newOrderCount, 0)
logInfo('[pdd-order-sync-job]', '拼多多定时拉单执行完成', {
const jobLog = totalNewOrders > 0 || failedCount > 0 ? logInfo : logDebug
jobLog('[pdd-order-sync-job]', '拼多多定时拉单执行完成', {
storeCount: syncResult.storeCount,
syncedCount: syncResult.syncedCount,
okCount,
failedCount,
totalFetched,
totalUpserted,
totalNewOrders,
})
return {
ok: failedCount === 0,
status: failedCount > 0 ? (okCount > 0 ? 'partial_error' : 'failed') : 'ok',
message: `已同步 ${syncResult.syncedCount} 个店铺,拉取 ${totalFetched} 单,入库/更新 ${totalUpserted} 单${failedCount > 0 ? `,失败 ${failedCount} 个店铺` : ''}`,
message: `已同步 ${syncResult.syncedCount} 个店铺,拉取 ${totalFetched} 单,新单 ${totalNewOrders},入库/更新 ${totalUpserted} 单${failedCount > 0 ? `,失败 ${failedCount} 个店铺` : ''}`,
accountCount: syncResult.storeCount,
checkedCount: syncResult.syncedCount,
okCount,
failedCount,
asset: totalUpserted,
asset: totalNewOrders,
totalUpserted,
totalNewOrders,
}
}
@@ -1,4 +1,4 @@
import { logError, logInfo, logWarn } from '../../utils/logger.js'
import { logDebug, logError, logInfo, logWarn } from '../../utils/logger.js'
import { createHttpError } from '../../utils/http.js'
import type { JsonObject } from '../../types/json.js'
import { getScheduledJobById, getScheduledJobsConfig } from './config-service.js'
@@ -147,10 +147,16 @@ async function runJob(job: JsonObject, { manual = false }: { manual?: boolean }
lastFailedCount: Number(summary.failedCount || 0),
lastManual: manual,
})
logInfo('[scheduler]', '定时任务执行完成', {
const status = String(summary.status || 'ok')
const failedCount = Number(summary.failedCount || 0)
// 成功且无失败的周期空跑降到 debug(PDD 约 20s 一轮),手动触发与失败仍保留 info。
const isQuietSuccess =
!manual && status === 'ok' && failedCount <= 0 && job.type !== 'data_retention'
const doneLog = isQuietSuccess ? logDebug : logInfo
doneLog('[scheduler]', '定时任务执行完成', {
jobId,
type: job.type,
status: String(summary.status || 'ok'),
status,
...(job.type === 'data_retention'
? {
rawPayloadRows: Number(summary.rawPayloadRows || 0),
@@ -20,7 +20,7 @@ import type { JsonObject } from '../../types/json.js'
import type { OrderItemRow, OrderRow } from '../../types/repository/rows.js'
import { generateWorkOrderNo, randomId } from '../../utils/random.js'
import { nowIso } from '../../utils/time.js'
import { logInfo, logWarn } from '../../utils/logger.js'
import { logDebug, logInfo, logWarn } from '../../utils/logger.js'
import { safeParseJson } from '../admin/admin-query-utils.js'
import { createWorkOrderMaterialAdminNotification } from '../admin/admin-notification-service.js'
import {
@@ -272,23 +272,29 @@ export async function syncWorkerOrdersForSourceOrder(
}
}
logInfo('[worker-order-consumer]', '发单平台消费者处理完成', {
const summary = {
source: options.source || 'source_order',
orderId: order.id,
platformOrderId: order.platform_order_id,
orderItemCount: orderItems.length,
createdCount: created.length,
skippedCount: skipped.length,
decisions,
})
skipReasons: formatDecisionReasonCounts(skipped),
}
// 常态「全跳过」每轮 PDD upsert 都会触发,降到 debug,避免日志按天被切碎。
if (created.length > 0) {
logInfo('[worker-order-consumer]', '发单平台消费者处理完成', summary)
} else {
logDebug('[worker-order-consumer]', '发单平台消费者无新建工单', summary)
}
const failedDecisions = decisions.filter((decision) => decision.result === 'failed')
if (failedDecisions.length > 0) {
logWarn('[worker-order-consumer]', '发单平台消费者存在未成功落库的订单项', {
source: options.source || 'source_order',
orderId: order.id,
platformOrderId: order.platform_order_id,
decisions: failedDecisions,
...summary,
failedCount: failedDecisions.length,
failedReasons: formatDecisionReasonCounts(failedDecisions),
})
}
@@ -323,3 +329,17 @@ function buildWorkerConsumerDecision(
...detail,
}
}
function formatDecisionReasonCounts(decisions: Array<Record<string, unknown>>) {
const counts = summarizeDecisionReasons(decisions)
return Object.keys(counts).length > 0 ? JSON.stringify(counts) : ''
}
function summarizeDecisionReasons(decisions: Array<Record<string, unknown>>) {
const counts: Record<string, number> = {}
for (const decision of decisions) {
const reason = String(decision.reason || decision.result || 'unknown').trim() || 'unknown'
counts[reason] = (counts[reason] || 0) + 1
}
return counts
}
+108 -11
View File
@@ -53,6 +53,7 @@ import {
} from '@/utils/admin-auth'
import { formatAdminDateTime } from '@/utils/admin-time'
import { useRealtimeEvents, type RealtimeEvent } from '@/hooks/useRealtimeEvents'
import dayjs from '@/lib/dayjs'
const SIDEBAR_COLLAPSED_KEY = 'react-admin-sidebar-collapsed'
const NOTIFICATION_SOUND_KEY = 'admin-notification-sound-enabled'
@@ -493,35 +494,82 @@ function patchAdminOrderCaches(
queryClient: ReturnType<typeof useQueryClient>,
event: RealtimeEvent,
) {
const item = event.data as { orderId?: unknown; platformOrderId?: unknown; payStatus?: unknown }
const item = event.data as {
orderId?: unknown
platformOrderId?: unknown
payStatus?: unknown
paidAt?: unknown
createdAt?: unknown
provider?: unknown
shopName?: unknown
itemTitle?: unknown
itemSummary?: unknown
}
for (const [queryKey, current] of queryClient.getQueriesData({ queryKey: ['admin-orders'] })) {
const params = isRecord(queryKey[1]) ? queryKey[1] : {}
const page = Number(params.page || 1)
const matches =
(!String(params.platformOrderId || '').trim() ||
String(item.platformOrderId || '') === String(params.platformOrderId || '').trim()) &&
const pageSize = Math.max(1, Number(params.pageSize || 20) || 20)
const keyword = String(params.keyword || '').trim()
const matchesFilters =
matchesAdminOrderKeyword(item, keyword) &&
matchesAdminOrderProvider(item, String(params.provider || '').trim()) &&
(!String(params.payStatus || '').trim() ||
String(item.payStatus || '') === String(params.payStatus || '').trim())
const shouldInsert = event.operation === 'upsert' && page === 1 && matches && !params.skuCode
const operation = event.operation === 'remove' || !matches ? 'remove' : 'upsert'
String(item.payStatus || '') === String(params.payStatus || '').trim()) &&
// 有关键词时不限日期;否则实时插入也要落在当前日期筛选内。
(keyword ? true : matchesAdminOrderDateRange(item, params))
const shouldInsert =
event.operation === 'upsert' && page === 1 && matchesFilters && !params.skuCode
const operation = event.operation === 'remove' || !matchesFilters ? 'remove' : 'upsert'
queryClient.setQueryData(
queryKey,
patchAdminOrderListEnvelope(current, { ...event, operation }, shouldInsert),
patchAdminOrderListEnvelope(current, { ...event, operation }, shouldInsert, pageSize),
)
}
}
function patchAdminOrderListEnvelope(current: unknown, event: RealtimeEvent, insert = false) {
function patchAdminOrderListEnvelope(
current: unknown,
event: RealtimeEvent,
insert = false,
pageSize = 20,
) {
if (!isRecord(current) || !isRecord(current.data) || !Array.isArray(current.data.items)) {
return current
}
const id = Number((event.data as { orderId?: unknown }).orderId || event.entityId)
const items = current.data.items as unknown[]
const nextItems =
const existed = items.some((entry) => Number((entry as { orderId?: unknown })?.orderId) === id)
let nextItems =
event.operation === 'remove'
? items.filter((entry) => Number((entry as { orderId?: unknown })?.orderId) !== id)
: upsertById(items, event.data, 'orderId', insert)
return { ...current, data: { ...current.data, items: nextItems } }
if (insert && nextItems.length > pageSize) {
nextItems = nextItems.slice(0, pageSize)
}
const pagination = isRecord(current.data.pagination) ? current.data.pagination : null
let nextPagination = pagination
if (pagination && insert && !existed) {
nextPagination = {
...pagination,
total: Number(pagination.total || 0) + 1,
}
} else if (pagination && event.operation === 'remove' && existed) {
nextPagination = {
...pagination,
total: Math.max(0, Number(pagination.total || 0) - 1),
}
}
return {
...current,
data: {
...current.data,
items: nextItems,
...(nextPagination ? { pagination: nextPagination } : {}),
},
}
}
function patchWorkOrderListEnvelope(current: unknown, event: RealtimeEvent, insert = false) {
@@ -560,6 +608,55 @@ function upsertById(items: unknown[], nextItem: unknown, idKey: string, insert =
return items.map((item, itemIndex) => (itemIndex === index ? nextItem : item))
}
function matchesAdminOrderKeyword(
item: {
platformOrderId?: unknown
shopName?: unknown
itemTitle?: unknown
itemSummary?: unknown
},
keyword: string,
) {
const normalizedKeyword = keyword.trim().toLowerCase()
if (!normalizedKeyword) return true
return [item.platformOrderId, item.shopName, item.itemTitle, item.itemSummary]
.map((value) => String(value || '').toLowerCase())
.some((value) => value.includes(normalizedKeyword))
}
function matchesAdminOrderProvider(item: { provider?: unknown }, provider: string) {
const normalized = provider.trim().toLowerCase()
if (!normalized) return true
const value = String(item.provider || '').toLowerCase()
if (normalized === 'pdd') return value === 'pdd'
if (normalized === '91' || normalized === '91kaquan' || normalized === 'open_91') {
return ['91kaquan', 'open_91', '91'].includes(value)
}
if (normalized === 'kuaishou' || normalized === 'kuaishou-industry') {
return value.startsWith('kuaishou')
}
return value === normalized
}
function matchesAdminOrderDateRange(
item: { paidAt?: unknown; createdAt?: unknown },
params: Record<string, unknown>,
) {
const dateFrom = String(params.dateFrom || '')
.trim()
.slice(0, 10)
const dateTo = String(params.dateTo || '')
.trim()
.slice(0, 10)
if (!dateFrom && !dateTo) return true
const raw = String(item.paidAt || item.createdAt || '').trim()
if (!raw) return false
const day = dayjs(raw).format('YYYY-MM-DD')
if (dateFrom && day < dateFrom) return false
if (dateTo && day > dateTo) return false
return true
}
function matchesWorkOrderKeyword(
item: { productName?: unknown; platformOrderId?: unknown },
keyword: string,
@@ -13,6 +13,7 @@ import { fetchAdminOrders } from '@/services/admin'
import type { AdminOrderListItem } from '@/types/admin'
import {
adminOrderExecutorOptions,
adminOrderProviderOptions,
adminPayStatusOptions,
adminTaskStatusOptions,
} from '@/utils/admin-options'
@@ -25,20 +26,46 @@ import { formatAdminDateTime } from '@/utils/admin-time'
type OrderFilterForm = {
keyword?: string
provider?: string
executorKey?: string
payStatus?: string
taskStatus?: string
dateRange?: unknown
}
/** 默认展示近 7 天(含今天)。 */
function resolveDefaultOrderDateRange() {
const today = dayjs()
return {
dateFrom: today.subtract(6, 'day').format('YYYY-MM-DD'),
dateTo: today.format('YYYY-MM-DD'),
}
}
export default function AdminOrdersPage() {
const navigate = useNavigate()
const [form] = Form.useForm<OrderFilterForm>()
const [searchParams, setSearchParams] = useSearchParams()
const page = Number(searchParams.get('page') || 1) || 1
const pageSize = resolveAdminPageSize(searchParams.get('pageSize'), ADMIN_DEFAULT_PAGE_SIZE)
// 首次进入(仅有分页参数)时写入默认近 7 天,避免一把拉出全库。
useEffect(() => {
const meaningfulKeys = [...searchParams.keys()].filter(
(key) => key !== 'page' && key !== 'pageSize',
)
if (meaningfulKeys.length > 0) {
return
}
const { dateFrom, dateTo } = resolveDefaultOrderDateRange()
setSearchParams(cleanParams({ page: 1, pageSize, dateFrom, dateTo }), { replace: true })
// 仅首屏引导默认日期,避免与后续筛选互相打架。
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [])
const filters = {
keyword: searchParams.get('keyword') || '',
provider: searchParams.get('provider') || '',
executorKey: searchParams.get('executorKey') || '',
payStatus: searchParams.get('payStatus') || '',
taskStatus: searchParams.get('taskStatus') || '',
@@ -54,20 +81,31 @@ export default function AdminOrdersPage() {
filters.executorKey,
filters.keyword,
filters.payStatus,
filters.provider,
filters.taskStatus,
page,
pageSize,
],
)
// 等待默认日期写入 URL 后再请求,避免首屏无日期打出全库。
const hasBootstrappedFilters =
Boolean(filters.dateFrom && filters.dateTo) ||
Boolean(filters.keyword) ||
searchParams.get('allTime') === '1' ||
Boolean(filters.provider || filters.executorKey || filters.payStatus || filters.taskStatus)
const query = useQuery({
queryKey: ['admin-orders', queryParams],
queryFn: () => fetchAdminOrders(queryParams),
enabled: hasBootstrappedFilters,
})
const data = query.data?.data
useEffect(() => {
form.setFieldsValue({
keyword: filters.keyword || undefined,
provider: filters.provider || undefined,
executorKey: filters.executorKey || undefined,
payStatus: filters.payStatus || undefined,
taskStatus: filters.taskStatus || undefined,
@@ -82,6 +120,7 @@ export default function AdminOrdersPage() {
filters.executorKey,
filters.keyword,
filters.payStatus,
filters.provider,
filters.taskStatus,
form,
])
@@ -185,14 +224,14 @@ export default function AdminOrdersPage() {
),
},
{
title: '金额 / 时间',
title: '金额 / 支付时间',
minWidth: 180,
render: (_, row) => (
<div className="cell-stack">
<strong>
{row.totalAmount || '0.00'} {row.currency}
</strong>
<span className="muted">{formatAdminDateTime(row.createdAt)}</span>
<span className="muted">{formatAdminDateTime(row.paidAt || row.createdAt)}</span>
</div>
),
},
@@ -200,29 +239,50 @@ export default function AdminOrdersPage() {
function applyFilters(values: OrderFilterForm) {
const { dateRange, ...restValues } = values
const [dateFrom, dateTo] = Array.isArray(dateRange)
const keyword = String(restValues.keyword || '').trim()
const [rawFrom, rawTo] = Array.isArray(dateRange)
? dateRange.map((item: { format?: (pattern: string) => string }) =>
item?.format ? item.format('YYYY-MM-DD') : '',
)
: ['', '']
setSearchParams(cleanParams({ ...restValues, dateFrom, dateTo, page: 1, pageSize }))
// 有关键词时不强制日期(后端也会忽略日期);清空日期且无关键词则查全部时间。
const dateFrom = rawFrom || ''
const dateTo = rawTo || ''
const allTime = !dateFrom && !dateTo && !keyword ? '1' : ''
setSearchParams(
cleanParams({
...restValues,
keyword,
dateFrom,
dateTo,
allTime,
page: 1,
pageSize,
}),
)
}
function resetFilters() {
const { dateFrom, dateTo } = resolveDefaultOrderDateRange()
form.setFieldsValue({
keyword: undefined,
provider: undefined,
executorKey: undefined,
payStatus: undefined,
taskStatus: undefined,
dateRange: undefined,
dateRange: [dayjs(dateFrom), dayjs(dateTo)],
})
setSearchParams(cleanParams({ page: 1, pageSize }))
setSearchParams(cleanParams({ page: 1, pageSize, dateFrom, dateTo }))
}
return (
<section className="page-stack">
<PageHeader title="订单" description="查看订单入库、商品匹配和任务拆分情况。" />
<PageHeader
title="订单"
description="默认近 7 天(按支付/成团时间)。搜单号或商品时不限日期。"
/>
<Card>
<Form<OrderFilterForm>
@@ -234,8 +294,16 @@ export default function AdminOrdersPage() {
<Form.Item name="keyword">
<Input
allowClear
placeholder="订单号 / 商品标题 / SKU 标题 / 买家 / 店铺"
style={{ width: 320 }}
placeholder="订单号 / 商品标题 / SKU / 买家 / 店铺"
style={{ width: 300 }}
/>
</Form.Item>
<Form.Item name="provider">
<Select
allowClear
placeholder="来源渠道"
options={adminOrderProviderOptions}
style={{ minWidth: 130 }}
/>
</Form.Item>
<Form.Item name="executorKey">
@@ -243,15 +311,15 @@ export default function AdminOrdersPage() {
allowClear
placeholder="履约渠道"
options={adminOrderExecutorOptions}
style={{ minWidth: 150 }}
style={{ minWidth: 140 }}
/>
</Form.Item>
<Form.Item name="payStatus">
<Select
allowClear
placeholder="支付状态"
options={adminPayStatusOptions}
style={{ minWidth: 140 }}
options={adminPayStatusOptions.filter((item) => item.value)}
style={{ minWidth: 130 }}
/>
</Form.Item>
<Form.Item name="taskStatus">
@@ -260,12 +328,12 @@ export default function AdminOrdersPage() {
showSearch
optionFilterProp="label"
placeholder="任务状态"
options={adminTaskStatusOptions}
style={{ minWidth: 170 }}
options={adminTaskStatusOptions.filter((item) => item.value)}
style={{ minWidth: 150 }}
/>
</Form.Item>
<Form.Item name="dateRange">
<AdminRangePicker />
<AdminRangePicker allowClear placeholder={['支付开始', '支付结束']} />
</Form.Item>
<Form.Item>
<Space>
@@ -283,7 +351,7 @@ export default function AdminOrdersPage() {
<Card>
<Table<AdminOrderListItem>
rowKey="orderId"
loading={query.isLoading || query.isFetching}
loading={query.isLoading || query.isFetching || !hasBootstrappedFilters}
columns={columns}
dataSource={data?.items || []}
scroll={{ x: 900 }}
@@ -292,7 +360,14 @@ export default function AdminOrdersPage() {
pageSize: data?.pagination.pageSize || pageSize,
total: data?.pagination.total || 0,
onChange: (nextPage, nextPageSize) => {
setSearchParams(cleanParams({ ...filters, page: nextPage, pageSize: nextPageSize }))
setSearchParams(
cleanParams({
...filters,
allTime: searchParams.get('allTime') || '',
page: nextPage,
pageSize: nextPageSize,
}),
)
},
})}
/>
+6
View File
@@ -6,6 +6,12 @@ export const adminPayStatusOptions = [
{ label: '已退款', value: 'refunded' },
]
export const adminOrderProviderOptions = [
{ label: '拼多多', value: 'pdd' },
{ label: '91卡券', value: '91kaquan' },
{ label: '快手', value: 'kuaishou' },
]
export const adminOrderExecutorOptions = [
{ label: '联盟发货', value: 'affiliate_dash' },
{ label: '行业凭证', value: 'kuaishou-industry' },