feat(admin): 收口人工履约入口并修复履约筛选

This commit is contained in:
yml2213
2026-10-24 17:42:07 +08:00
parent faf56e567e
commit 790de676c6
27 changed files with 495 additions and 1327 deletions
@@ -0,0 +1,222 @@
/**
* 确认人工履约弹窗(订单列表 / 订单详情共用)。
*
* 口径(2026-10-24):
* * 渠道与消耗积分在成本中心提前配好,客服不选、不填;
* * 固定成本 → 直接确认;
* * 成本不固定(消耗积分 = 0)→ 只填本次实际成本;
* * 确认后扣对应平台积分/备用金并写成本快照。
*
* 原「人工履约待办」页面已下线,入口收敛到订单界面。
*/
import { CheckOutlined } from '@ant-design/icons'
import {
Alert,
App,
Form,
Input,
InputNumber,
Modal,
Select,
Space,
Statistic,
Tag,
Typography,
} from 'antd'
import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'
import { useEffect, useState } from 'react'
import { confirmAdminManualFulfillment, fetchAdminManualFulfillmentPending } from '@/services/admin'
import type { ManualFulfillmentPendingItem } from '@/types/admin'
type ConfirmFormValues = {
costYuan?: number
payeeName?: string
note?: string
}
const PLATFORM_TAG_COLORS: Record<string, string> = {
nanhang: 'blue',
lewan: 'purple',
rock: 'cyan',
fund_cash: 'orange',
}
export type ManualFulfillmentConfirmModalProps = {
open: boolean
orderId: number | null
initialOrderItemId?: number | null
onClose: () => void
onConfirmed?: () => void
}
export function ManualFulfillmentConfirmModal({
open,
orderId,
initialOrderItemId = null,
onClose,
onConfirmed,
}: ManualFulfillmentConfirmModalProps) {
const { message } = App.useApp()
const queryClient = useQueryClient()
const [form] = Form.useForm<ConfirmFormValues>()
const [selectedId, setSelectedId] = useState<number | null>(null)
const pendingQuery = useQuery({
queryKey: ['admin-manual-fulfillment-pending', 'order', orderId],
queryFn: () =>
fetchAdminManualFulfillmentPending({
orderId: orderId || undefined,
status: 'pending',
page: 1,
pageSize: 20,
}),
enabled: open && Boolean(orderId),
})
const items = pendingQuery.data?.data.items || []
const selected =
items.find((item) => item.orderItemId === selectedId) ||
items.find((item) => item.orderItemId === initialOrderItemId) ||
items[0] ||
null
useEffect(() => {
if (!open) return
setSelectedId(initialOrderItemId || null)
form.resetFields()
}, [open, initialOrderItemId, form])
const confirmMutation = useMutation({
mutationFn: (values: ConfirmFormValues) =>
confirmAdminManualFulfillment({
orderItemId: selected?.orderItemId || 0,
costFen: values.costYuan === undefined ? undefined : Math.round(values.costYuan * 100),
payeeName: values.payeeName || '',
note: values.note || '',
}),
onSuccess: (response) => {
const result = response.data
message.success(
`履约已确认,扣 ${result.creditQuantity} 积分,成本 ¥${(result.costFen / 100).toFixed(2)}`,
)
void queryClient.invalidateQueries({ queryKey: ['admin-manual-fulfillment-pending'] })
void queryClient.invalidateQueries({ queryKey: ['admin-order-detail'] })
void queryClient.invalidateQueries({ queryKey: ['admin-orders'] })
void queryClient.invalidateQueries({ queryKey: ['admin-fund-my'] })
void queryClient.invalidateQueries({ queryKey: ['admin-fund-accounts'] })
void queryClient.invalidateQueries({ queryKey: ['admin-platform-credit-accounts'] })
void queryClient.invalidateQueries({ queryKey: ['admin-platform-credit-entries'] })
onConfirmed?.()
onClose()
},
onError: (error) => {
message.error(error instanceof Error ? error.message : '确认履约失败')
},
})
const showCostInput = selected?.costFen === null
return (
<Modal
open={open}
title="确认人工履约"
okText="确认履约"
okButtonProps={{ icon: <CheckOutlined />, disabled: !selected }}
cancelText="取消"
confirmLoading={confirmMutation.isPending}
onOk={() => {
void form.validateFields().then((values) => confirmMutation.mutate(values))
}}
onCancel={onClose}
destroyOnHidden
width={560}
>
{pendingQuery.isLoading ? (
<Typography.Text type="secondary">正在读取待履约商品…</Typography.Text>
) : items.length === 0 ? (
<Alert
type="warning"
showIcon
message="该订单没有待确认的人工履约项"
description="可能已履约,或该商品还没有在「商品与成本 → 人工 SKU 配置」里配置履约渠道。"
/>
) : (
<Space direction="vertical" size={12} style={{ width: '100%' }}>
{items.length > 1 ? (
<Select
value={selected?.orderItemId}
onChange={(value) => setSelectedId(value)}
options={items.map((item) => ({
value: item.orderItemId,
label: `${item.skuName || item.skuCode} · ${item.internalSku || item.skuCode}`,
}))}
style={{ width: '100%' }}
/>
) : null}
<div>
<Typography.Text type="secondary">商品:</Typography.Text>
<Typography.Text strong>
{selected?.skuName || selected?.skuCode || '-'}
</Typography.Text>
</div>
<div>
<Typography.Text type="secondary">内部 SKU:</Typography.Text>
<Typography.Text copyable={{ text: selected?.internalSku || '' }}>
{selected?.internalSku || '-'}
</Typography.Text>
</div>
<div>
<Typography.Text type="secondary">履约渠道:</Typography.Text>
<Tag color={PLATFORM_TAG_COLORS[selected?.platformKey || ''] || 'default'}>
{selected?.platformLabel || '-'}
</Tag>
{selected && !selected.isFundCash ? (
<Typography.Text>消耗 {selected.creditQuantity} 积分</Typography.Text>
) : null}
</div>
<div>
<Typography.Text type="secondary">订单金额:</Typography.Text>
<Typography.Text>¥{((selected?.revenueFen || 0) / 100).toFixed(2)}</Typography.Text>
</div>
{showCostInput ? (
<Alert type="warning" showIcon message="该商品成本不固定,请填写本次实际成本" />
) : (
<Statistic
title="本次成本"
value={(selected?.costFen || 0) / 100}
precision={2}
prefix="¥"
/>
)}
<Form<ConfirmFormValues> form={form} layout="vertical">
{showCostInput ? (
<Form.Item
name="costYuan"
label="实际成本(元)"
rules={[{ required: true, message: '请填写实际成本' }]}
>
<InputNumber
min={0.01}
precision={2}
style={{ width: '100%' }}
placeholder="例如 12.50"
prefix="¥"
/>
</Form.Item>
) : null}
<Form.Item name="payeeName" label="收款方 / 处理人">
<Input placeholder="例如:客服小王、上游商家" maxLength={120} />
</Form.Item>
<Form.Item name="note" label="备注">
<Input.TextArea rows={2} maxLength={300} showCount />
</Form.Item>
</Form>
</Space>
)}
</Modal>
)
}