/** * 履约渠道页:履约待办队列 + 渠道规则 + 问题队列。 * * 设计口径(2026-10-31 v2): * · 渠道由 L1 规则决定,不再由「有没有任务」反推; * · 没有命中规则的新单落在「待分类」,收入进未分类桶,不产生成本噪音; * · 第三方卡券由外部卡券库履约:不建内部任务、不发领取页,但支持平台券自动核销。 */ import { DeleteOutlined, PlusOutlined, ReloadOutlined, SearchOutlined, SyncOutlined, ThunderboltOutlined, } from '@ant-design/icons' import { Alert, Button, Card, Form, Input, InputNumber, Modal, Segmented, Select, Space, Switch, Tabs, Tag, Tooltip, Typography, message, } from 'antd' import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query' import { useEffect, useState } from 'react' import { useNavigate } from 'react-router' import PercentTable from '@/components/common/PercentTable' import FinanceSubNav from '@/components/admin/FinanceSubNav' import VoucherConsumePolicyPanel from './panels/VoucherConsumePolicyPanel' import { assignChannelByInternalSku, deletePendingChannelGroup, deleteInternalSkuMapping, deleteChannelRules, forceDeleteChannelRules, fetchChannelExceptions, fetchChannelRules, fetchInternalSkuMappings, fetchPendingChannelGroups, fetchPipelineStatus, retryPendingCarriers, retryPendingWorkOrderRouting, runFinancePipeline, unlockPendingChannelGroup, type FinancePipelineStatus, type InternalSkuMapping, type InternalSkuMappingMatchType, saveChannelRule, saveInternalSkuMapping, type ChannelRule, type FulfillmentQueueBucket, type PendingChannelGroup, } from '@/services/admin' import { formatRedeemAmount } from '@/utils/redeem' import { formatDateTime } from '@/utils/date-time' import { ADMIN_DEFAULT_PAGE_SIZE, buildAdminTablePagination } from '@/utils/admin-pagination' const CHANNEL_OPTIONS = [ { value: 'work_order', label: '接单平台' }, { value: 'affiliate_dash', label: '自动发货' }, { value: 'third_party_voucher', label: '第三方卡券' }, { value: 'manual', label: '人工客服' }, { value: 'on_account', label: '统一结算' }, ] const CHANNEL_COLOR: Record = { work_order: 'blue', affiliate_dash: 'green', third_party_voucher: 'purple', manual: 'orange', on_account: 'gold', } const CHANNEL_SOURCE_LABEL: Record = { operator: '运营配置', manual_config: '人工 SKU 配置', voucher: '第三方卡券', capability: '商品能力迁移', backfill: '历史回填', } const CHANNEL_SOURCE_FILTER_OPTIONS = [ ...Object.entries(CHANNEL_SOURCE_LABEL).map(([value, label]) => ({ value, label })), { value: 'rule', label: '规则迁移' }, ] const ENABLED_FILTER_OPTIONS = [ { value: 'true', label: '启用' }, { value: 'false', label: '停用' }, ] const MATCH_KEY_OPTIONS = [{ value: 'internal_sku', label: '内部 SKU' }] const PENDING_QUEUE_BUCKET_OPTIONS: Array<{ value: FulfillmentQueueBucket label: string }> = [ { value: 'actionable', label: '自动处理中' }, { value: 'configuration', label: '配置待补' }, { value: 'operator_review', label: '人工处理' }, { value: 'terminal', label: '售后/终止' }, ] const INTERNAL_SKU_MAPPING_TYPES: Array<{ value: InternalSkuMappingMatchType label: string }> = [ { value: 'sku_code', label: '平台 SKU 编码' }, { value: 'sku_nick', label: 'SKU 昵称' }, { value: 'out_sku_sn', label: '外部 SKU 编码' }, { value: 'spec', label: '规格值' }, { value: 'sku_name', label: '商品名称' }, ] export default function AdminFulfillmentChannelPage() { return (
}, { key: 'mappings', label: 'SKU 映射', children: }, { key: 'rules', label: '渠道规则', children: }, { key: 'exceptions', label: '问题队列', children: }, { key: 'pipelines', label: '管道状态', children: }, { key: 'voucher-consume', label: '自动核销', children: }, ]} />
) } function PendingPanel() { const queryClient = useQueryClient() const navigate = useNavigate() const [keyword, setKeyword] = useState('') const [queueBucket, setQueueBucket] = useState('actionable') const [page, setPage] = useState(1) const [pageSize, setPageSize] = useState(ADMIN_DEFAULT_PAGE_SIZE) const [selections, setSelections] = useState>({}) const [internalSkuDrafts, setInternalSkuDrafts] = useState>({}) const query = useQuery({ queryKey: ['fulfillment-pending', keyword, queueBucket, page, pageSize], queryFn: () => fetchPendingChannelGroups({ page, pageSize, keyword, queueBucket }), }) const assignMutation = useMutation({ mutationFn: (row: PendingChannelGroup) => assignChannelByInternalSku({ groupKey: row.group_key, internalSku: row.internal_sku || '', mappedInternalSku: row.internal_sku ? '' : String(internalSkuDrafts[rowKey(row)] || '').trim(), channel: selections[rowKey(row)] || '', queueBucket, }), onSuccess: (result) => { const productMessage = result.data.draftProductId ? '和标准商品' : '' if (result.data.carrierFailed > 0) { const firstFailure = result.data.carrierFailures?.[0] message.warning( `渠道${productMessage}已保存,${result.data.carrierFailed} 个订单项仍待补配置${ firstFailure?.message ? `:${firstFailure.message}` : '' }`, ) } else { message.success( `已指定 ${result.data.updated} 个订单项${productMessage ? `并创建${productMessage.slice(1)}` : ''}`, ) } void queryClient.invalidateQueries({ queryKey: ['fulfillment-pending'] }) }, onError: (error) => message.error(error instanceof Error ? error.message : '指定渠道失败'), }) const retryWorkOrderMutation = useMutation({ mutationFn: (inputSku?: string) => retryPendingWorkOrderRouting(inputSku ? { internalSku: inputSku } : {}), onSuccess: (result) => { const data = result.data const detail = [ `重试 ${data.scanned} 个订单项`, `新建工单 ${data.createdWorkOrders} 个`, `转接单平台 ${data.assigned} 个`, ].join(',') if (data.remaining > 0) { message.warning(`${detail},仍有 ${data.remaining} 个未匹配到接单模板`) } else { message.success(detail) } void queryClient.invalidateQueries({ queryKey: ['fulfillment-pending'] }) void queryClient.invalidateQueries({ queryKey: ['fulfillment-rules'] }) void queryClient.invalidateQueries({ queryKey: ['fulfillment-exceptions'] }) }, onError: (error) => message.error(error instanceof Error ? error.message : '重新匹配接单模板失败'), }) const retryCarrierMutation = useMutation({ mutationFn: (input: { row: PendingChannelGroup retryInactiveCarrier: boolean issueCodes: string[] }) => retryPendingCarriers({ internalSku: input.row.internal_sku || '', retryInactiveCarrier: input.retryInactiveCarrier, issueCodes: input.issueCodes, }), onSuccess: (result) => { const data = result.data const detail = [ `扫描 ${data.scanned} 个订单项`, `创建工单 ${data.workOrdersCreated} 个`, `创建自动任务 ${data.affiliateTasksCreated} 个`, `已分流 ${data.assigned} 个`, ].join(',') if (data.remaining > 0) { message.warning(`${detail},仍有 ${data.remaining} 个待处理`) } else { message.success(detail) } void queryClient.invalidateQueries({ queryKey: ['fulfillment-pending'] }) void queryClient.invalidateQueries({ queryKey: ['fulfillment-exceptions'] }) }, onError: (error) => message.error(error instanceof Error ? error.message : '重试履约载体失败'), }) const unlockMutation = useMutation({ mutationFn: (row: PendingChannelGroup) => unlockPendingChannelGroup({ groupKey: row.group_key, internalSku: row.internal_sku || '', queueBucket, }), onSuccess: (result) => { message.success(`已解除 ${result.data.updated} 个订单项的运营锁定`) void queryClient.invalidateQueries({ queryKey: ['fulfillment-pending'] }) }, onError: (error) => message.error(error instanceof Error ? error.message : '解除运营锁定失败'), }) const deleteMutation = useMutation({ mutationFn: (row: PendingChannelGroup) => deletePendingChannelGroup({ groupKey: row.group_key, queueBucket }), onSuccess: (result) => { const data = result.data message.success( `已忽略归档 ${data.archivedItems} 个待分类订单项,原始订单保留;财务事实已重算 ${data.refreshedDays} 天`, ) void queryClient.invalidateQueries({ queryKey: ['fulfillment-pending'] }) void queryClient.invalidateQueries({ queryKey: ['fulfillment-exceptions'] }) }, onError: (error) => message.error(error instanceof Error ? error.message : '删除失败'), }) const pipelineMutation = useMutation({ mutationFn: () => runFinancePipeline({ days: 3 }), onSuccess: () => { message.success('管道已执行') void queryClient.invalidateQueries({ queryKey: ['fulfillment-pending'] }) }, onError: () => message.error('执行管道失败'), }) const columns = [ { title: '来源', dataIndex: 'providers', width: 120, render: (value: string[] | undefined) => value?.join(' / ') || '-', }, { title: '店铺', dataIndex: 'shops', width: 210, render: (_: unknown, row: PendingChannelGroup) => { const shops = row.shops?.length > 0 ? row.shops : (row.shop_ids || []).map((shopId) => ({ id: shopId, name: shopId })) if (shops.length === 0) return '-' return ( {shops.map((shop) => ( {shop.name} {shop.name !== shop.id ? ( · {shop.id} ) : null} ))} ) }, }, { title: '内部SKU', dataIndex: 'internal_sku', width: 220, render: (value: string | null, row: PendingChannelGroup) => ( {value ? ( {value} ) : ( setInternalSkuDrafts((current) => ({ ...current, [rowKey(row)]: event.target.value, })) } /> )} {row.configured_channels?.length ? ( {row.configured_channels.map((channel) => ( {CHANNEL_OPTIONS.find((option) => option.value === channel)?.label || channel} ))} ) : null} ), }, { title: '平台SKU', dataIndex: 'sku_codes', width: 180, render: (value: string[] | undefined) => (value?.length ? value.join(' / ') : '-'), }, { title: '商品名', dataIndex: 'sku_name', ellipsis: true }, { title: '待分类原因', dataIndex: 'pending_reasons', width: 240, render: (value: string[] | undefined, row: PendingChannelGroup) => { const labels: Record = { no_internal_sku: '无内部SKU', no_channel_capability: '无渠道能力', no_carrier: '无履约载体', routing_conflict: '渠道冲突', } const subreasonLabels: Record = { carrier_task_closed: '载体已关闭', carrier_task_manual_review: '载体人工复核', carrier_not_attempted: '尚未尝试补载体', carrier_attempt_failed: '载体创建失败', carrier_task_retry_pending: '载体失败待确认重试', carrier_task_expired: '载体已过期', carrier_task_user_refund: '用户已申请退款', carrier_task_cancelled: '上游履约已取消', manual_config_missing: '缺人工配置', work_rule_missing: '缺接单模板', affiliate_mapping_missing: '缺自动发货映射', existing_carrier_conflict: '已有其它载体', carrier_config_ambiguous: '载体配置冲突', missing_internal_sku: '缺内部 SKU', missing_channel: '缺渠道配置', user_refund: '用户已申请退款', platform_cancelled: '上游履约已取消', carrier_manual_review: '载体人工复核', carrier_retry_pending: '载体失败待重试', carrier_expired: '载体已过期', carrier_closed: '载体已关闭', carrier_missing: '缺履约载体', state_inconsistent: '履约状态不一致', } const breakdown = row.issue_breakdown || [] return ( {breakdown.length > 0 ? ( breakdown.map((issue) => ( {subreasonLabels[issue.issue_code] || issue.issue_code} {issue.item_count} 项 {issue.locked_item_count > 0 ? ` · 锁定 ${issue.locked_item_count}` : ''} )) ) : ( <> {value?.length ? value.map((reason) => labels[reason] || reason).join(' / ') : '-'} {row.pending_subreasons?.length ? ( {row.pending_subreasons .map((reason) => subreasonLabels[reason] || reason) .join(' / ')} ) : null} )} {row.locked_item_count > 0 ? ( 已人工指定渠道,等待补配置 {row.locked_item_count} 项 ) : null} ) }, }, { title: '订单项', dataIndex: 'item_count', width: 90 }, { title: '收入', dataIndex: 'revenue_fen', width: 120, render: (value: number) => formatRedeemAmount(value), }, { title: '最近出现', dataIndex: 'last_seen_at', width: 160, render: (value: string) => formatDateTime(value), }, { title: '指定渠道', width: 440, render: (_: unknown, row: PendingChannelGroup) => { const issueBreakdown = row.issue_breakdown || [] const retryableIssueCodes = issueBreakdown .filter((issue) => issue.retryable) .map((issue) => issue.issue_code) const autoRetryableIssueCodes = issueBreakdown .filter((issue) => issue.auto_retryable) .map((issue) => issue.issue_code) const hasConfigIssue = Number(row.config_issue_item_count || 0) > 0 const hasManualReview = Number(row.manual_review_item_count || 0) > 0 const hasAfterSales = Number(row.after_sales_item_count || 0) > 0 const hasSystemIssue = Number(row.system_issue_item_count || 0) > 0 const hasRetryable = Number(row.retryable_unlocked_item_count || 0) > 0 const hasAutoRetryable = Number(row.auto_retryable_unlocked_item_count || 0) > 0 const hasOnlyRetryableIssues = issueBreakdown.length > 0 && issueBreakdown.every((issue) => issue.retryable) const hasOnlyAutoRetryableIssues = issueBreakdown.length > 0 && issueBreakdown.every((issue) => issue.auto_retryable) const canRunScopedActions = issueBreakdown.length <= 1 const canChangeChannel = queueBucket !== 'terminal' const hasUnlockedItems = row.locked_item_count < row.item_count return ( ) } function RulesPanel() { const queryClient = useQueryClient() const [open, setOpen] = useState(false) const [selectedRuleIds, setSelectedRuleIds] = useState([]) const [keyword, setKeyword] = useState('') const [channelFilter, setChannelFilter] = useState('') const [sourceFilter, setSourceFilter] = useState('') const [enabledFilter, setEnabledFilter] = useState('') const [page, setPage] = useState(1) const [pageSize, setPageSize] = useState(ADMIN_DEFAULT_PAGE_SIZE) const [form] = Form.useForm() const hasActiveFilters = Boolean(keyword || channelFilter || sourceFilter || enabledFilter) const query = useQuery({ queryKey: [ 'fulfillment-rules', keyword, channelFilter, sourceFilter, enabledFilter, page, pageSize, ], queryFn: () => fetchChannelRules({ keyword, channel: channelFilter, source: sourceFilter, ...(enabledFilter ? { enabled: enabledFilter === 'true' } : {}), page, pageSize, }), }) const ruleCount = query.data?.data?.total || 0 useEffect(() => { const maxPage = Math.max(1, Math.ceil(ruleCount / pageSize)) if (page > maxPage) setPage(maxPage) }, [page, pageSize, ruleCount]) const saveMutation = useMutation({ mutationFn: (values: Record) => saveChannelRule(values as never), onSuccess: () => { message.success('规则已保存') setOpen(false) form.resetFields() void queryClient.invalidateQueries({ queryKey: ['fulfillment-rules'] }) }, onError: (error) => message.error(error instanceof Error ? error.message : '保存规则失败'), }) const deleteMutation = useMutation({ mutationFn: (ids: number[]) => deleteChannelRules(ids), onSuccess: (result) => { const missingHint = result.data.missingIds.length ? `,${result.data.missingIds.length} 条已不存在` : '' message.success(`已删除 ${result.data.deletedCount} 条渠道规则${missingHint}`) setSelectedRuleIds([]) void queryClient.invalidateQueries({ queryKey: ['fulfillment-rules'] }) void queryClient.invalidateQueries({ queryKey: ['fulfillment-pending'] }) }, onError: (error) => message.error(error instanceof Error ? error.message : '删除规则失败'), }) const forceDeleteMutation = useMutation({ mutationFn: (ids: number[]) => forceDeleteChannelRules(ids), onSuccess: (result) => { const missingHint = result.data.missingIds.length ? `,${result.data.missingIds.length} 条已不存在` : '' message.success(`已强制删除 ${result.data.deletedCount} 条渠道规则${missingHint}`) setSelectedRuleIds([]) void queryClient.invalidateQueries({ queryKey: ['fulfillment-rules'] }) void queryClient.invalidateQueries({ queryKey: ['fulfillment-pending'] }) }, onError: (error) => message.error(error instanceof Error ? error.message : '强制删除规则失败'), }) function resetFilters() { setKeyword('') setChannelFilter('') setSourceFilter('') setEnabledFilter('') setPage(1) setSelectedRuleIds([]) } function confirmDeleteRules(ids: number[]) { if (ids.length === 0) return Modal.confirm({ title: ids.length === 1 ? '删除渠道规则' : `批量删除 ${ids.length} 条渠道规则`, content: '删除后会立即影响新订单的渠道判定;历史订单和成本数据不会被删除。', okText: '确认删除', okButtonProps: { danger: true }, cancelText: '取消', onOk: () => deleteMutation.mutateAsync(ids), }) } function confirmForceDeleteRules(ids: number[]) { if (ids.length === 0) return Modal.confirm({ title: ids.length === 1 ? '强制删除渠道规则' : `批量强制删除 ${ids.length} 条渠道规则`, content: '将跳过系统来源保护,只删除统一渠道规则本身。历史订单和成本数据不会被删除;对应来源后续同步时,规则仍可能重新生成。', okText: '确认强制删除', okButtonProps: { danger: true }, cancelText: '取消', onOk: () => forceDeleteMutation.mutateAsync(ids), }) } const columns = [ { title: '作用范围', width: 110, render: () => 全局 }, { title: '匹配键', dataIndex: 'match_key_type', width: 110, render: (v: string) => MATCH_KEY_OPTIONS.find((item) => item.value === v)?.label || v, }, { title: '匹配值', dataIndex: 'match_key' }, { title: '渠道', dataIndex: 'channel', width: 140, render: (value: string) => ( {CHANNEL_OPTIONS.find((item) => item.value === value)?.label || value} ), }, { title: '优先级', dataIndex: 'priority', width: 90 }, { title: '载体参数', width: 220, ellipsis: true, render: (_: unknown, row: ChannelRule) => formatCarrierParams(row), }, { title: '来源', dataIndex: 'source', width: 140, render: (value: string) => CHANNEL_SOURCE_LABEL[value] || (value.startsWith('rule:') ? '规则迁移' : value || '-'), }, { title: '启用', dataIndex: 'enabled', width: 80, render: (value: boolean) => (value ? 启用 : 停用), }, { title: '操作', width: 120, render: (_: unknown, row: ChannelRule) => { if (!canDeleteChannelRule(row)) { return ( ) } return ( ) }, }, ] return ( } > 配置按内部 SKU 全局生效,会同时影响所有平台和店铺。每条内部 SKU 只能有一个主渠道; 其他渠道请设置 90 以上优先级作为兜底。接单平台的具体模板由统一配置中的 workRuleKey 控制。 来源为商品能力迁移、人工配置、卡券或历史回填的系统规则默认受保护;确认配置错误时可使用 「强制删除」,但对应来源后续同步时仍可能重新生成。 } placeholder="搜索内部 SKU、载体参数或备注" value={keyword} onChange={(event) => { setKeyword(event.target.value) setPage(1) setSelectedRuleIds([]) }} style={{ width: 280 }} /> { setSourceFilter(value || '') setPage(1) setSelectedRuleIds([]) }} options={CHANNEL_SOURCE_FILTER_OPTIONS} style={{ width: 160 }} /> ) } function ExceptionsPanel() { const [reason, setReason] = useState('') const [page, setPage] = useState(1) const [pageSize, setPageSize] = useState(ADMIN_DEFAULT_PAGE_SIZE) const query = useQuery({ queryKey: ['fulfillment-exceptions', reason, page, pageSize], queryFn: () => fetchChannelExceptions({ reason, status: 'open', page, pageSize }), }) const REASON_OPTIONS = [ { value: '', label: '全部' }, { value: 'routing_conflict', label: '渠道冲突' }, { value: 'product_mapping_missing', label: '未归一' }, { value: 'cost_missing', label: '成本缺失' }, { value: 'manual_config_missing', label: '人工 SKU 未配置' }, { value: 'manual_cost_missing', label: '人工未确认履约' }, { value: 'carrier_missing', label: '缺少履约载体' }, ] const columns = [ { title: '类型', dataIndex: 'reason', width: 200, render: (value: string) => ( {REASON_OPTIONS.find((item) => item.value === value)?.label || value} ), }, { title: '范围', dataIndex: 'scope_key', ellipsis: true }, { title: '涉及订单项', dataIndex: 'item_count', width: 110 }, { title: '最近出现', dataIndex: 'last_seen_at', width: 160, render: (value: string) => formatDateTime(value), }, ] return (