import { useEffect, useState } from 'react' import { Alert, Button, Card, Col, Form, Input, Modal, Popconfirm, Row, Select, Space, Table, Tabs, Tag, Typography, message } from 'antd' import type { FormInstance } from 'antd' import { ClockCircleOutlined, CodeOutlined, CopyOutlined, DollarOutlined, FileTextOutlined, KeyOutlined, LinkOutlined, PlusOutlined, SafetyCertificateOutlined, SendOutlined, WalletOutlined, } from '@ant-design/icons' import type { ColumnsType } from 'antd/es/table' import { formatDateTime } from '../utils/time' import type { ApiClient, CallbackSubscription, FulfillmentOrder, MerchantMember, MerchantRole, MerchantProduct, PageResult, WalletAccount, WalletLedgerEntry, } from '../types' import { defaultCallbackFormValues, eventOptions, money, orderStatusOptions, orderStatusMap, pageConfig, rolePermissionText, roleText, scopeLabel, } from './merchantCenterUtils' export function SecretBlock({ appKey, secret }: { appKey?: string; secret: string }) { return ( {appKey && (
App Key {appKey}
)}
Secret {secret}
) } export function ProductsTab({ loading, products, canManage, onToggleProduct, onLoadProducts, }: { loading: boolean products: PageResult canManage: boolean onToggleProduct: (record: MerchantProduct) => void onLoadProducts: (page?: number, size?: number) => void }) { const productColumns: ColumnsType = [ { title: '商户 SKU', dataIndex: 'sku', width: 180, ellipsis: true, render: (v) => {v}, }, { title: '商品名称', dataIndex: 'display_name', width: 220, ellipsis: true, render: (_, r) => (
{r.display_name || r.product?.name || '-'}
{r.product?.category && ( {r.product.category} )}
), }, { title: '目录编码', dataIndex: ['product', 'code'], width: 150, ellipsis: true, render: (_, r) => r.product?.code ? {r.product.code} : '-', }, { title: '对外售价', dataIndex: 'price_amount', width: 120, render: (v) => {money(v)}, }, { title: '成本价', dataIndex: 'cost_amount', width: 120, render: (v) => {money(v)}, }, { title: '当前库存', dataIndex: 'stock', width: 110, render: (v) => (v < 0 ? 无限库存 : v === 0 ? 已缺货 : `${v} 件`), }, { title: '状态', dataIndex: 'status', width: 100, render: productStatusTag, }, { title: '操作', key: 'action', width: 90, fixed: 'right', render: (_, record) => canManage ? ( onToggleProduct(record)} > ) : '-', }, ] return (
商品上架与售卖管理 商户可自主上架/下架商品;下架后不可再创建该商品订单。
) } export function OrdersTab({ loading, orders, orderSource, filters, canManage, onCreateManualOrder, onOrderSourceChange, onFilterChange, onLoadOrders, onCopyLink, onOpenLink, onRevokeLink, onRestoreLink, onCancelOrder, }: { loading: boolean orders: PageResult orderSource: 'api' | 'manual' filters: { keyword: string; order_status: string } canManage: boolean onCreateManualOrder: () => void onOrderSourceChange: (source: 'api' | 'manual') => void onFilterChange: (filters: { keyword: string; order_status: string }) => void onLoadOrders: (page?: number, size?: number) => void onCopyLink: (orderNo: string) => void onOpenLink: (orderNo: string) => void onRevokeLink: (orderNo: string) => void onRestoreLink: (orderNo: string) => void onCancelOrder: (orderNo: string, reason: string) => Promise | void }) { const [keyword, setKeyword] = useState(filters.keyword) const [cancelling, setCancelling] = useState(null) const [cancelReason, setCancelReason] = useState('') const [cancelSubmitting, setCancelSubmitting] = useState(false) useEffect(() => { setKeyword(filters.keyword) }, [filters.keyword]) const submitKeyword = () => onFilterChange({ ...filters, keyword: keyword.trim() }) const submitCancel = async () => { if (!cancelling) return if (!cancelReason.trim()) { message.warning('请填写取消原因') return } setCancelSubmitting(true) try { await onCancelOrder(cancelling.order_no, cancelReason.trim()) setCancelling(null) setCancelReason('') } finally { setCancelSubmitting(false) } } const orderColumns: ColumnsType = [ { title: '平台订单号', dataIndex: 'order_no', width: 190, ellipsis: true, render: (v) => {v}, }, { title: '商户单号', dataIndex: 'client_order_no', width: 140, ellipsis: true }, { title: 'SKU', dataIndex: 'product_sku', width: 130, ellipsis: true, render: (v) => {v}, }, { title: '商品', dataIndex: 'product_name', width: 220, ellipsis: true }, { title: '基础金额', dataIndex: 'base_amount', width: 88, render: money }, { title: '手续费', dataIndex: 'service_fee_amount', width: 82, render: money }, { title: '扣款合计', dataIndex: 'amount', width: 88, render: money }, { title: '状态', dataIndex: 'order_status', width: 92, render: orderStatusTag }, { title: '链接有效期', dataIndex: 'delivery_link_expires_at', width: 140, render: (_, record) => record.delivery_link_revoked_at ? 已作废 : formatDateTime(record.delivery_link_expires_at), }, { title: '时间', dataIndex: 'created_at', width: 150, render: formatDateTime }, { title: '发货链接', key: 'delivery_link', width: 160, render: (_, record) => { if (record.order_status === 'cancelled') { return 订单已取消 } if (record.delivery_link_revoked_at) { return } return ( ) }, }, { title: '操作', key: 'action', width: 110, fixed: 'right', render: (_, record) => { if (!canManage) return '-' if (record.order_status === 'paid' || record.order_status === 'ship_failed') { return ( ) } return '-' }, }, ] return ( onOrderSourceChange(key as 'api' | 'manual')} items={[{ key: 'api', label: 'API 订单' }, { key: 'manual', label: '手动订单' }]} style={{ minWidth: 220 }} /> {canManage && ( )} setKeyword(event.target.value)} onSearch={submitKeyword} placeholder="搜索平台订单号或商户单号" allowClear onClear={() => onFilterChange({ ...filters, keyword: '' })} style={{ width: 300, maxWidth: '100%' }} /> {orderStatusOptions.map((option) => ( ))}
{ setCancelling(null) setCancelReason('') }} okText="确认取消并退款" okButtonProps={{ danger: true }} destroyOnClose > setCancelReason(e.target.value)} placeholder="请填写取消原因(必填)" /> ) } export function WalletTab({ loading, wallet, canFinance, ledger, form, onFilter, onResetFilter, onLoadLedger, }: { loading: boolean wallet: WalletAccount | null canFinance: boolean ledger: PageResult form: FormInstance onFilter: () => void onResetFilter: () => void onLoadLedger: (page: number, size: number) => void }) { const ledgerColumns: ColumnsType = [ { title: '流水号', dataIndex: 'entry_no', width: 260, render: (v) => {v} }, { title: '类型', dataIndex: 'type', width: 90, render: ledgerTypeTag }, { title: '变动积分', dataIndex: 'amount', width: 130, render: moneyWithSign }, { title: '结余积分', dataIndex: 'balance_after', width: 130, render: (v) => {money(v)} }, { title: '关联单号', dataIndex: 'reference_no', width: 200, ellipsis: true, render: (v) => v ? {v} : '-' }, { title: '备注说明', dataIndex: 'note', width: 220, ellipsis: { showTitle: false }, render: (v) => {v || '-'} }, { title: '变动时间', dataIndex: 'created_at', width: 170, render: formatDateTime }, ] return (
可用余额
{(wallet?.available_balance ?? 0).toLocaleString('zh-CN')} 积分
充值/调账 仅平台管理员可操作
冻结余额
{(wallet?.frozen_balance ?? 0).toLocaleString('zh-CN')} 积分
提现/发货预扣 0 笔预扣
结算币种与状态
{wallet?.currency || 'POINT'} 账户正常
计费方式 自动按单扣减
{canFinance && (
)} {canFinance ? (
) : ( 当前角色可查看余额,钱包流水仅财务或负责人可见。 )} ) } export function ApiKeysTab({ loading, clients, clientMax, isAdmin, canManage, form, onOpenCreate, onNavigateDocs, onNavigateDebug, onToggleClient, onDeleteClient, }: { loading: boolean clients: ApiClient[] clientMax: number isAdmin: boolean canManage: boolean form: FormInstance onOpenCreate: () => void onNavigateDocs: () => void onNavigateDebug: () => void onToggleClient: (record: ApiClient) => void onDeleteClient: (record: ApiClient) => void }) { const apiClientColumns: ColumnsType = [ { title: '名称', dataIndex: 'name', width: 140, ellipsis: true }, { title: 'App Key', dataIndex: 'app_key', width: 230, render: (v) => {v} }, { title: '签名', dataIndex: 'signature_version', width: 80, render: (v) => {v} }, { title: '权限', dataIndex: 'scopes', width: 250, render: scopesTag }, { title: '状态', dataIndex: 'status', width: 80, render: activeStatusTag }, { title: '最后使用', dataIndex: 'last_used_at', width: 170, render: formatDateTime }, { title: '操作', key: 'action', width: 150, render: (_, record) => canManage ? ( onDeleteClient(record)} > ) : '-', }, ] return ( API 密钥与开放接口鉴权 已配额 {clients.length} / {clientMax} {isAdmin && ( )} {canManage && ( )} } >
用于第三方分销系统或自建后台调用开放 API (商品查询、订单发货) 的 HMAC-SHA256 签名鉴权凭证。新生成的 App Secret 仅在创建成功时展示一次,请妥善保存。
) } export function CallbacksTab({ canManage, callback, form, onSubmit, onRotateSecret, }: { canManage: boolean callback: CallbackSubscription | null form: FormInstance onSubmit: () => void onRotateSecret: () => void }) { return ( Webhook 异步回调订阅设置 {callback?.status === 'active' ? ( 推送已启用 ) : ( 推送已禁用 )} HMAC-SHA256 签名保护 } >
重试机制
Outbox 队列 + 指数退避 (最多 16 次)
推送信道签名 Header
X-Signature (HMAC-SHA256)
推送超时标准
5000 ms 强制响应超时
} placeholder="https://your-domain.com/api/v1/webhook" allowClear />
{callback?.updated_at ? `上次保存:${formatDateTime(callback.updated_at)}` : '尚未保存回调配置'} {canManage && ( )} {canManage && ( )}
) } export function MembersTab({ loading, members, roles, canManage, form, onOpenAdd, onOpenCreateRole, onEditRole, onEditMember, onToggleMemberStatus, onRemoveMember, currentUserID, }: { loading: boolean members: MerchantMember[] roles: MerchantRole[] canManage: boolean form: FormInstance onOpenAdd: () => void onOpenCreateRole: () => void onEditRole: (role: MerchantRole) => void onEditMember: (member: MerchantMember) => void onToggleMemberStatus: (member: MerchantMember) => void onRemoveMember: (member: MerchantMember) => void currentUserID?: number }) { const roleNames = new Map(roles.map((item) => [item.code, item.name])) const memberColumns: ColumnsType = [ { title: '用户', dataIndex: ['user', 'username'], render: (_, r) => r.user?.username || `#${r.user_id}` }, { title: '昵称', dataIndex: ['user', 'nickname'], render: (_, r) => r.user?.nickname || '-' }, { title: '角色', dataIndex: 'role', width: 140, render: (value) => {roleNames.get(value) || roleText(value)} }, { title: '默认', dataIndex: 'is_default', width: 80, render: (v) => (v ? 默认 : '-') }, { title: '状态', dataIndex: 'status', width: 90, render: (v) => (v === 1 ? 启用 : 禁用) }, { title: '操作', width: 210, render: (_, member) => { const protectedMember = member.role === 'owner' || member.user_id === currentUserID if (!canManage) return '-' if (protectedMember) return 受保护 const action = member.status === 1 ? '停用' : '启用' return onToggleMemberStatus(member)}> onRemoveMember(member)} okButtonProps={{ danger: true }}> }, }, ] return ( 成员仅属于当前商户;角色和权限也在当前商户内独立配置。 {canManage && }
role.id || role.code} size="small" pagination={false} dataSource={roles} columns={[ { title: '角色', dataIndex: 'name', width: 160, render: (name, role) => {name}{role.code === 'owner' && 固定} }, { title: '权限', dataIndex: 'permissions', render: (permissions) => permissions ? permissions.split(',').map((item: string) => {rolePermissionText(item)}) : '-' }, { title: '操作', width: 90, render: (_, role) => role.code === 'owner' ? '-' : }, ]} /> ) } function moneyWithSign(value?: number | null) { const amount = Number(value || 0) if (amount > 0) { return +{money(amount)} } if (amount < 0) { return {money(amount)} } return {money(amount)} } function productStatusTag(value: string) { return value === 'active' ? ( 已上架 ) : ( 已下架 ) } function activeStatusTag(value: string) { return value === 'active' ? ( 已启用 ) : ( 已禁用 ) } function orderStatusTag(value: string) { const item = orderStatusMap[value] || { color: 'default', text: value } const tagClassMap: Record = { paid: 'status-tag--blue', delivering: 'status-tag--cyan', delivered: 'status-tag--green', ship_failed: 'status-tag--red', cancelled: 'status-tag--gray', } const tagClass = tagClassMap[value] || 'status-tag--gray' return ( {item.text} ) } function ledgerTypeTag(value: string) { const map: Record = { credit: { color: 'green', text: '入账' }, debit: { color: 'red', text: '扣款' }, refund: { color: 'purple', text: '退款' }, adjust: { color: 'blue', text: '调整' }, } const item = map[value] || { color: 'default', text: value } return {item.text} } function scopesTag(value: string) { const scopes = (value || '').split(',').filter(Boolean) if (scopes.length === 0) { return '-' } return ( {scopes.map((s) => {scopeLabel(s)})} ) }