+
+ {config ? (
+
+ {config.enabled ? '返利已启用' : '返利已关闭'}
+
+ ) : null}
+ {savedAt ? 保存于 {formatDateTime(savedAt)} : null}
+ {config?.updated_at ? (
+ 服务端更新 {formatDateTime(config.updated_at)}
+ ) : null}
+
+ }
+ extra={
+ }
+ onClick={refresh}
+ loading={configQuery.isFetching}
+ disabled={!canView}
+ >
+ 刷新
+
+ }
+ />
+
+ {!canView ? (
+
+ 重试
+
+ }
+ />
+ ) : null}
+
+
+
+
+ form={form}
+ layout="vertical"
+ disabled={!canManage || saving || !config}
+ initialValues={{
+ enabled: false,
+ first_month_percent: 0,
+ second_month_percent: 0,
+ subsequent_percent: 0,
+ }}
+ >
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 比例预览
+
+ }
+ loading={saving}
+ onClick={() => void save()}
+ disabled={!canManage}
+ >
+ 保存配置
+
+ {!canManage ? (
+
+ 需要 distribution:site_manage 权限
+
+ ) : null}
+
+
+
+
+
+
+
+ 关闭开关后，新产生的订单不再计入邀请返利；历史返利流水不会回滚。
+
+
+
+
+
+ )
+}
diff --git a/frontend/src/features/admin/AdminDistributionListingsPage.tsx b/frontend/src/features/admin/AdminDistributionListingsPage.tsx
new file mode 100644
index 0000000..f0b876e
--- /dev/null
+++ b/frontend/src/features/admin/AdminDistributionListingsPage.tsx
@@ -0,0 +1,848 @@
+import { useMemo, useState } from 'react'
+import { keepPreviousData, useQuery, useQueryClient } from '@tanstack/react-query'
+import {
+ Alert,
+ App,
+ Button,
+ Form,
+ Input,
+ InputNumber,
+ Modal,
+ Select,
+ Space,
+ Tabs,
+ Tag,
+ Typography,
+ type TableColumnsType,
+} from 'antd'
+import {
+ EditOutlined,
+ PlayCircleOutlined,
+ ReloadOutlined,
+ StopOutlined,
+ TagsOutlined,
+} from '@ant-design/icons'
+
+import {
+ batchUpdateAdminAccountDisplays,
+ batchUpdateAdminAccountMarkup,
+ fetchAdminAccountDisplays,
+ fetchAdminReceivedListings,
+ updateAdminAccountDisplay,
+ updateAdminAccountMarkup,
+ updateAdminReceivedListingStatus,
+} from '@/features/admin/api'
+import { AdminPageHeader } from '@/features/admin/components/AdminPageHeader'
+import { DataTable } from '@/features/admin/components/DataTable'
+import {
+ DistributionSiteSelect,
+ useDistributionSiteSelection,
+} from '@/features/admin/components/DistributionSiteSelect'
+import { FilterBar, FilterField } from '@/features/admin/components/FilterBar'
+import { StatusTag } from '@/features/admin/components/StatusTag'
+import { readStatusMeta, type StatusMeta } from '@/features/admin/labels'
+import type {
+ AdminAccountDisplay,
+ AdminReceivedListing,
+ AdminReceivedListingQuery,
+} from '@/features/admin/types'
+import { useAdminSessionStore } from '@/stores/adminSession'
+import { formatDateTime, formatMoney, formatText, maskPhone } from '@/shared/utils/format'
+
+const listingStatusMap: Record
+
+
+
+ 首月
+ {Number(firstMonthPercent ?? 0).toFixed(2)}%
+
+
+ 次月
+ {Number(secondMonthPercent ?? 0).toFixed(2)}%
+
+
+ 第三个月起
+ {Number(subsequentPercent ?? 0).toFixed(2)}%
+
+
+ 最高比例
+ {maxPercent.toFixed(2)}%
+
+
+
+
+ 生效前提
+ 被邀请人完成实名认证
+
+
+ 首月
+ 实名校验后 30 天内
+
+
+ 次月
+ 第 31-60 天
+
+
+ 第三个月起
+ 第 61 天以后
+
+
+ 返利基数
+ 订单单边服务费
+
+
+ {formatText(row.title)}
+ {formatText(row.listing_no)}
+
+ {formatText(row.game_name)} · {formatText(row.server_region)} ·{' '}
+ {formatText(row.rank_level)}
+
+
+ ),
+ },
+ {
+ title: '号主',
+ key: 'owner',
+ width: 160,
+ render: (_, row) => (
+
+ {formatText(row.owner_nickname)}
+ {maskPhone(row.owner_phone)}
+ ID #{row.owner_id}
+
+ ),
+ },
+ {
+ title: '价格',
+ key: 'price',
+ width: 180,
+ align: 'right',
+ render: (_, row) => (
+
+ {formatMoney(row.price_cent)}
+ 卖家 {formatMoney(row.seller_total_price_cent)}
+ 押金 {formatMoney(row.deposit_amount_cent)}
+ 哈夫币 {row.haf_coin_amount}M
+
+ ),
+ },
+ {
+ title: '比例',
+ key: 'ratio',
+ width: 140,
+ align: 'right',
+ render: (_, row) => (
+
+ 卖家 {row.seller_ratio.toFixed(2)}
+ 买家 {row.buyer_ratio.toFixed(2)}
+
+ ),
+ },
+ {
+ title: '状态',
+ key: 'status',
+ width: 150,
+ render: (_, row) => (
+
+
+ ),
+ },
+ {
+ title: '时间',
+ key: 'time',
+ width: 180,
+ render: (_, row) => (
+
+ 上架 {formatDateTime(row.published_at)}
+ 创建 {formatDateTime(row.created_at)}
+
+ ),
+ },
+ {
+ title: '操作',
+ key: 'actions',
+ width: 120,
+ fixed: 'right',
+ render: (_, row) =>
+ row.status === 'offline' ? (
+ }
+ disabled={!canManage}
+ onClick={() => changeReceivedStatus(row, 'published')}
+ >
+ 上架
+
+ ) : (
+ }
+ disabled={!canManage}
+ onClick={() => changeReceivedStatus(row, 'offline')}
+ >
+ 下架
+
+ ),
+ },
+ ]
+
+ const accountColumns: TableColumnsType
+ {formatText(row.title)}
+ {formatText(row.listing_no)}
+
+ {formatText(row.game_name)} · {formatText(row.server_region)} ·{' '}
+ {formatText(row.rank_level)}
+
+
+ ),
+ },
+ {
+ title: '展示',
+ key: 'display',
+ width: 140,
+ render: (_, row) => (
+
+ 交易中 : null}
+
+ ),
+ },
+ {
+ title: '分成比例',
+ key: 'ratio',
+ width: 150,
+ align: 'right',
+ render: (_, row) => (
+
+ 基础 {Number(row.base_ratio ?? 0).toFixed(2)}
+ 站点 {Number(row.site_ratio ?? 0).toFixed(2)}
+ 调整 {Number(row.shelf_ratio_delta ?? 0).toFixed(2)} 点
+
+ ),
+ },
+ {
+ title: '价格',
+ key: 'price',
+ width: 160,
+ align: 'right',
+ render: (_, row) => (
+
+ {formatMoney(row.site_price_cent)}
+ 基础 {formatMoney(row.price_cent)}
+ 加价 {formatMoney(row.markup_amount_cent)}
+ 押金 {formatMoney(row.deposit_amount_cent)}
+
+ ),
+ },
+ {
+ title: '来源',
+ key: 'source',
+ width: 130,
+ render: (_, row) => (
+
+ {formatText(row.source_channel)}
+ 展示 ID #{row.id}
+
+ ),
+ },
+ {
+ title: '操作',
+ key: 'actions',
+ width: 190,
+ fixed: 'right',
+ render: (_, row) => (
+
+
+
+ 收货商品 {receivedQuery.data?.total ?? 0}
+
+ 账号展示 {accountRows.length}
+ {receivedQuery.isFetching || accountsQuery.isFetching ? (
+ 正在更新
+ ) : null}
+
+ }
+ extra={
+ }
+ onClick={refresh}
+ loading={receivedQuery.isFetching || accountsQuery.isFetching}
+ disabled={!canView}
+ >
+ 刷新
+
+ }
+ />
+
+ {!canView ? (
+ {
+ setTab(next)
+ setSelectedAccountIds([])
+ }}
+ items={[
+ {
+ key: 'received',
+ label: '收货商品',
+ children: (
+ <>
+ {
+ setReceivedFilters({
+ ...receivedDraft,
+ keyword: receivedDraft.keyword?.trim() || undefined,
+ })
+ setReceivedPage(1)
+ }}
+ onReset={
+ Object.values(receivedDraft).some(Boolean) ||
+ Object.values(receivedFilters).some(Boolean)
+ ? () => {
+ setReceivedDraft({})
+ setReceivedFilters({})
+ setReceivedPage(1)
+ }
+ : undefined
+ }
+ loading={receivedQuery.isFetching}
+ extra={
+
+ {receivedQuery.isPending
+ ? '加载中'
+ : `当前 ${receivedRows.length} 件`}
+
+ }
+ >
+
+
+ setReceivedDraft(current => ({
+ ...current,
+ keyword: event.target.value,
+ }))
+ }
+ />
+
+
+
+
+
+
+
+ {receivedQuery.isError ? (
+ void receivedQuery.refetch()}>
+ 重试
+
+ }
+ />
+ ) : null}
+
+
+ title="站点收货商品"
+ rowKey="listing_id"
+ columns={receivedColumns}
+ dataSource={receivedRows}
+ loading={receivedQuery.isFetching}
+ total={receivedQuery.data?.total ?? 0}
+ page={receivedPage}
+ pageSize={receivedPageSize}
+ onPageChange={(nextPage, nextSize) => {
+ setReceivedPage(nextPage)
+ setReceivedPageSize(nextSize)
+ }}
+ emptyDescription={canView ? '该站点还没有收货商品' : '当前账号没有查看权限'}
+ />
+
+ ),
+ },
+ {
+ key: 'accounts',
+ label: '账号展示',
+ children: (
+ <>
+ {
+ setAccountStatus(accountStatus || undefined)
+ setAccountPage(1)
+ }}
+ onReset={
+ accountStatus || accountKeyword
+ ? () => {
+ setAccountStatus(undefined)
+ setAccountKeyword('')
+ setAccountPage(1)
+ setSelectedAccountIds([])
+ }
+ : undefined
+ }
+ loading={accountsQuery.isFetching}
+ extra={
+ selectedAccountIds.length > 0 ? (
+
+ }
+ disabled={!canManage}
+ onClick={() => batchChangeDisplay('enabled')}
+ >
+ 批量展示
+
+ }
+ disabled={!canManage}
+ onClick={() => batchChangeDisplay('disabled')}
+ >
+ 批量隐藏
+
+ }
+ disabled={!canManage}
+ onClick={() => {
+ batchMarkupForm.setFieldsValue({ shelf_ratio_delta: 0 })
+ setBatchMarkupOpen(true)
+ }}
+ >
+ 批量加价
+
+
+ ) : (
+
+ {accountsQuery.isPending ? '加载中' : `当前 ${filteredAccounts.length} 个账号`}
+
+ )
+ }
+ >
+
+ {
+ setAccountKeyword(event.target.value)
+ setAccountPage(1)
+ }}
+ />
+
+
+
+
+
+ {accountsQuery.isError ? (
+ void accountsQuery.refetch()}>
+ 重试
+
+ }
+ />
+ ) : null}
+
+
+ title="站点账号展示"
+ rowKey="id"
+ columns={accountColumns}
+ dataSource={pagedAccounts}
+ loading={accountsQuery.isFetching}
+ total={filteredAccounts.length}
+ page={accountPage}
+ pageSize={accountPageSize}
+ onPageChange={(nextPage, nextSize) => {
+ setAccountPage(nextPage)
+ setAccountPageSize(nextSize)
+ }}
+ rowSelection={{
+ selectedRowKeys: selectedAccountIds,
+ preserveSelectedRowKeys: true,
+ onChange: keys => setSelectedAccountIds(keys.map(Number)),
+ }}
+ emptyDescription={canView ? '该站点还没有账号展示' : '当前账号没有查看权限'}
+ />
+
+ ),
+ },
+ ]}
+ />
+
+ (working ? undefined : setMarkupTarget(undefined))}
+ footer={
+
+
+
+
+ }
+ >
+
+
+ (working ? undefined : setBatchMarkupOpen(false))}
+ footer={
+
+
+
+
+ }
+ >
+
+
+ )
+}
diff --git a/frontend/src/features/admin/AdminDistributionOrdersPage.tsx b/frontend/src/features/admin/AdminDistributionOrdersPage.tsx
new file mode 100644
index 0000000..52e314c
--- /dev/null
+++ b/frontend/src/features/admin/AdminDistributionOrdersPage.tsx
@@ -0,0 +1,494 @@
+import { useMemo, useState } from 'react'
+import { keepPreviousData, useQuery } from '@tanstack/react-query'
+import {
+ Alert,
+ Button,
+ Input,
+ Select,
+ Space,
+ Tag,
+ Typography,
+ type TableColumnsType,
+} from 'antd'
+import { ReloadOutlined, ShareAltOutlined, WalletOutlined } from '@ant-design/icons'
+
+import {
+ fetchAdminDistributionOrder,
+ fetchAdminDistributionOrders,
+} from '@/features/admin/api'
+import { AdminPageHeader } from '@/features/admin/components/AdminPageHeader'
+import { DataTable } from '@/features/admin/components/DataTable'
+import {
+ DetailDrawer,
+ type DetailSection,
+} from '@/features/admin/components/DetailDrawer'
+import { FilterBar, FilterField } from '@/features/admin/components/FilterBar'
+import { StatusTag } from '@/features/admin/components/StatusTag'
+import {
+ orderStatusMap,
+ orderStatusOptions,
+ readStatusMeta,
+ refundStatusMap,
+ type StatusMeta,
+} from '@/features/admin/labels'
+import type {
+ AdminDistributionOrder,
+ AdminDistributionOrderQuery,
+} from '@/features/admin/types'
+import { useAdminSessionStore } from '@/stores/adminSession'
+import { useDistributionSiteSelection } from '@/features/admin/components/DistributionSiteSelect'
+import { formatDateTime, formatMoney, formatText, maskPhone } from '@/shared/utils/format'
+
+const modeLabels: Record
+ {row.order_no}
+ {formatText(row.title)}
+ {formatText(row.listing_no)}
+
+ ),
+ },
+ {
+ title: '站点 / 模式',
+ key: 'site',
+ width: 190,
+ render: (_, row) => (
+
+ {siteName(row.site_id)}
+ {modeLabels[row.distribution_mode] ?? formatText(row.distribution_mode)}
+ {roleLabel(row.distributor_role)}
+
+ ),
+ },
+ {
+ title: '净付款 / 退款',
+ key: 'paid',
+ width: 150,
+ align: 'right',
+ render: (_, row) => (
+
+ {formatMoney(row.net_paid_amount_cent)}
+ 实付 {formatMoney(row.gross_paid_amount_cent)}
+ 退款 {formatMoney(row.refund_amount_cent)}
+
+ ),
+ },
+ {
+ title: '利润基数 / 服务费',
+ key: 'split',
+ width: 160,
+ align: 'right',
+ render: (_, row) => (
+
+ {formatMoney(row.split_base_amount_cent)}
+ 服务费 {formatMoney(row.service_fee_cent)}
+ 加价 {formatMoney(row.markup_amount_cent)}
+
+ ),
+ },
+ {
+ title: '分站收益',
+ key: 'earning',
+ width: 150,
+ align: 'right',
+ render: (_, row) => (
+
+ {formatMoney(row.distributor_earning_cent)}
+ 加价 {formatMoney(row.distributor_markup_cent)}
+ 分成 {formatMoney(row.distributor_split_cent)}
+
+ ),
+ },
+ {
+ title: '订单状态',
+ key: 'status',
+ width: 140,
+ render: (_, row) => (
+
+
+ ),
+ },
+ {
+ title: '分销入账',
+ key: 'release',
+ width: 150,
+ render: (_, row) => (
+
+
+ ),
+ },
+ {
+ title: '下单时间',
+ dataIndex: 'created_at',
+ width: 170,
+ render: value => formatDateTime(value),
+ },
+ {
+ title: '操作',
+ key: 'actions',
+ width: 90,
+ fixed: 'right',
+ render: (_, row) => (
+
+ ),
+ },
+ ]
+
+ const applyFilters = () => {
+ setFilters({
+ site_id: draftFilters.site_id || undefined,
+ mode: draftFilters.mode,
+ status: draftFilters.status,
+ financial_status: draftFilters.financial_status,
+ keyword: draftFilters.keyword?.trim() || undefined,
+ })
+ setPage(1)
+ }
+
+ const resetFilters = () => {
+ setDraftFilters(emptyFilters)
+ setFilters(emptyFilters)
+ setPage(1)
+ }
+
+ return (
+
+
+ 共 {ordersQuery.data?.total ?? 0} 单
+ {ordersQuery.isFetching ? 正在更新 : null}
+
+ }
+ extra={
+ }
+ onClick={() => void ordersQuery.refetch()}
+ loading={ordersQuery.isFetching}
+ disabled={!canView}
+ >
+ 刷新
+
+ }
+ />
+
+ {!canView ? (
+
+ {ordersQuery.isPending ? '加载中' : `当前 ${ordersQuery.data?.items.length ?? 0} 单`}
+
+ }
+ >
+
+
+
+
+
+
+
+
+
+
+ setDraftFilters(current => ({ ...current, keyword: event.target.value }))
+ }
+ />
+
+
+
+ {ordersQuery.isError ? (
+ void ordersQuery.refetch()}>
+ 重试
+
+ }
+ />
+ ) : null}
+
+
+ title="订单快照"
+ rowKey="order_id"
+ columns={columns}
+ dataSource={ordersQuery.data?.items ?? []}
+ loading={ordersQuery.isFetching}
+ total={ordersQuery.data?.total ?? 0}
+ page={page}
+ pageSize={pageSize}
+ onPageChange={(nextPage, nextSize) => {
+ setPage(nextPage)
+ setPageSize(nextSize)
+ }}
+ emptyDescription={canView ? '没有符合条件的分销订单' : '当前账号没有查看权限'}
+ />
+
+ setDetailId(undefined)}
+ title={detailQuery.data?.order_no ?? '分销订单详情'}
+ subtitle={
+ detailQuery.data
+ ? `${siteName(detailQuery.data.site_id)} · ${
+ modeLabels[detailQuery.data.distribution_mode] ??
+ detailQuery.data.distribution_mode
+ }`
+ : undefined
+ }
+ tags={
+ detailQuery.data ? (
+
+ 退款 {readStatusMeta(refundStatusMap, detailQuery.data.refund_status).label}
+
+ ) : undefined
+ }
+ loading={detailQuery.isPending}
+ error={detailQuery.isError ? errorText(detailQuery.error) : null}
+ onRetry={() => void detailQuery.refetch()}
+ sections={detailQuery.data ? buildSections(detailQuery.data, siteName) : []}
+ width={820}
+ />
+
+ )
+}
diff --git a/frontend/src/features/admin/AdminDistributionPaymentChannelsPage.tsx b/frontend/src/features/admin/AdminDistributionPaymentChannelsPage.tsx
new file mode 100644
index 0000000..8f679c2
--- /dev/null
+++ b/frontend/src/features/admin/AdminDistributionPaymentChannelsPage.tsx
@@ -0,0 +1,368 @@
+import { useMemo, useState } from 'react'
+import { useQuery, useQueryClient } from '@tanstack/react-query'
+import {
+ Alert,
+ App,
+ Button,
+ Form,
+ InputNumber,
+ Modal,
+ Select,
+ Space,
+ Tag,
+ Typography,
+ type TableColumnsType,
+} from 'antd'
+import { DeleteOutlined, LinkOutlined, PlusOutlined, ReloadOutlined } from '@ant-design/icons'
+
+import {
+ bindAdminPaymentChannel,
+ fetchAdminPaymentChannels,
+ fetchAdminPaymentConfigOptions,
+ unbindAdminPaymentChannel,
+} from '@/features/admin/api'
+import { AdminPageHeader } from '@/features/admin/components/AdminPageHeader'
+import { DataTable } from '@/features/admin/components/DataTable'
+import {
+ DistributionSiteSelect,
+ useDistributionSiteSelection,
+} from '@/features/admin/components/DistributionSiteSelect'
+import type { AdminPaymentChannel } from '@/features/admin/types'
+import { useAdminSessionStore } from '@/stores/adminSession'
+
+interface BindFormValues {
+ config_id: number
+ priority: number
+}
+
+function errorText(error: unknown) {
+ const response = (error as { response?: { data?: { message?: string } } })?.response
+ if (response?.data?.message) return response.data.message
+ return error instanceof Error ? error.message : '请求失败，请稍后重试'
+}
+
+const providerLabels: Record
+ {config?.name || `配置 #${row.config_id}`}
+
+ {config ? providerLabels[config.provider] ?? config.provider : '未知服务商'}
+ {config?.pay_way ? ` · ${config.pay_way}` : ''}
+
+ 配置 ID {row.config_id}
+
+ )
+ },
+ },
+ {
+ title: '环境 / 状态',
+ key: 'status',
+ width: 170,
+ render: (_, row) => {
+ const config = configMap.get(row.config_id)
+ return (
+
+ {row.status}
+ {config ? (
+
+ {config.environment || '—'} · {config.status}
+
+ ) : null}
+ {config?.is_default ? 主站默认配置 : null}
+
+ )
+ },
+ },
+ {
+ title: '优先级',
+ dataIndex: 'priority',
+ width: 100,
+ align: 'right',
+ },
+ {
+ title: '操作',
+ key: 'actions',
+ width: 100,
+ fixed: 'right',
+ render: (_, row) => (
+ }
+ disabled={!canManage}
+ onClick={() => unbind(row)}
+ >
+ 解绑
+
+ ),
+ },
+ ]
+
+ return (
+
+
+ 已绑定 {channels.length} 条
+ {selection.site ? {selection.site.site_name} : null}
+ {channelsQuery.isFetching ? 正在更新 : null}
+
+ }
+ extra={
+
+ {canManage ? (
+ }
+ disabled={!siteId}
+ onClick={openBind}
+ >
+ 绑定支付配置
+
+ ) : null}
+ }
+ onClick={() => {
+ void channelsQuery.refetch()
+ void configsQuery.refetch()
+ void selection.refetch()
+ }}
+ loading={channelsQuery.isFetching}
+ disabled={!canView}
+ >
+ 刷新
+
+
+ }
+ />
+
+ {!canView ? (
+ void channelsQuery.refetch()}>
+ 重试
+
+ }
+ />
+ ) : null}
+
+
+ title="站点支付通道"
+ rowKey="id"
+ columns={columns}
+ dataSource={channels}
+ loading={channelsQuery.isFetching}
+ emptyDescription={canView ? '该站点还没有绑定支付通道' : '当前账号没有查看权限'}
+ extra={
+
+ 绑定顺序按优先级升序，未绑定时回退主站默认支付配置。
+
+ }
+ />
+
+ (binding ? undefined : setBindOpen(false))}
+ footer={
+
+
+ }
+ loading={binding}
+ onClick={() => void bind()}
+ >
+ 确认绑定
+
+
+ }
+ >
+ form={form} layout="vertical" disabled={binding}>
+ {canReadConfigs ? (
+
+
+ ) : null}
+
+
+
+
+
+
+
+ )
+}
diff --git a/frontend/src/features/admin/AdminDistributionQrCodesPage.tsx b/frontend/src/features/admin/AdminDistributionQrCodesPage.tsx
new file mode 100644
index 0000000..ce55076
--- /dev/null
+++ b/frontend/src/features/admin/AdminDistributionQrCodesPage.tsx
@@ -0,0 +1,780 @@
+import { useEffect, useMemo, useRef, useState } from 'react'
+import { keepPreviousData, useQuery, useQueryClient } from '@tanstack/react-query'
+import {
+ Alert,
+ App,
+ Button,
+ Col,
+ DatePicker,
+ Form,
+ Image,
+ Input,
+ Modal,
+ Row,
+ Select,
+ Space,
+ Switch,
+ Tag,
+ Typography,
+ Upload,
+ type TableColumnsType,
+} from 'antd'
+import {
+ DeleteOutlined,
+ EditOutlined,
+ InboxOutlined,
+ PlusOutlined,
+ ReloadOutlined,
+ StopOutlined,
+ ThunderboltOutlined,
+} from '@ant-design/icons'
+import dayjs, { type Dayjs } from 'dayjs'
+
+import {
+ batchCreateAdminDistributionQrCodes,
+ batchDeleteAdminDistributionQrCodes,
+ deleteAdminDistributionQrCode,
+ fetchAdminDistributionQrCodes,
+ fetchAdminDistributionQrCodeStats,
+ updateAdminDistributionQrCode,
+} from '@/features/admin/api'
+import { AdminPageHeader } from '@/features/admin/components/AdminPageHeader'
+import { DataTable } from '@/features/admin/components/DataTable'
+import {
+ DistributionSiteSelect,
+ useDistributionSiteSelection,
+} from '@/features/admin/components/DistributionSiteSelect'
+import { FilterBar, FilterField } from '@/features/admin/components/FilterBar'
+import { StatusTag } from '@/features/admin/components/StatusTag'
+import { readStatusMeta, type StatusMeta } from '@/features/admin/labels'
+import type {
+ AdminDistributionQrCode,
+ AdminDistributionQrCodeQuery,
+} from '@/features/admin/types'
+import { useAdminSessionStore } from '@/stores/adminSession'
+import { uploadAdminFile } from '@/shared/api/files'
+import { formatDateTime, formatText } from '@/shared/utils/format'
+
+const qrStatusMap: Record
+ {formatText(row.group_name)}
+ {formatText(row.note)}
+ ID #{row.id}
+
+ ),
+ },
+ {
+ title: '状态',
+ dataIndex: 'status',
+ width: 100,
+ render: value =>
+
+ {row.conversation_id
+ ? row.bound_conversation_title || `会话 #${row.conversation_id}`
+ : '未绑定'}
+
+ 企微改名：{row.wecom_renamed ? '是' : '否'}
+
+ ),
+ },
+ {
+ title: '有效期',
+ key: 'expire',
+ width: 190,
+ render: (_, row) => (
+
+ 过期 {formatDateTime(row.expires_at)}
+ 发放 {formatDateTime(row.used_at)}
+
+ ),
+ },
+ {
+ title: '创建时间',
+ dataIndex: 'created_at',
+ width: 170,
+ render: value => formatDateTime(value),
+ },
+ {
+ title: '操作',
+ key: 'actions',
+ width: 220,
+ fixed: 'right',
+ render: (_, row) => (
+
+
+ 待用 {stats?.unused_count ?? 0}
+ 已发放 {stats?.used_count ?? 0}
+ 已停用 {stats?.disabled_count ?? 0}
+ 总计 {stats?.total_count ?? 0}
+
+ }
+ extra={
+
+ {canManage ? (
+ }
+ disabled={!siteId}
+ onClick={() => setUploadOpen(true)}
+ >
+ 批量入池
+
+ ) : null}
+ }
+ onClick={refresh}
+ loading={listQuery.isFetching}
+ disabled={!canView}
+ >
+ 刷新
+
+
+ }
+ />
+
+ {!canView ? (
+
+ 重试
+
+ }
+ />
+ ) : null}
+
+ 0 ? (
+ } onClick={removeSelected}>
+ 删除选中 {selectedIds.length}
+
+ ) : (
+ 共 {listQuery.data?.total ?? 0} 张
+ )
+ }
+ >
+
+
+ setDraftFilters(current => ({ ...current, keyword: event.target.value }))
+ }
+ />
+
+
+
+
+
+
+
+
+
+
+ title="站点二维码"
+ rowKey="id"
+ columns={columns}
+ dataSource={rows}
+ loading={listQuery.isFetching}
+ total={listQuery.data?.total ?? 0}
+ page={page}
+ pageSize={pageSize}
+ onPageChange={(nextPage, nextSize) => {
+ setPage(nextPage)
+ setPageSize(nextSize)
+ setSelectedIds([])
+ }}
+ rowSelection={{
+ selectedRowKeys: selectedIds,
+ preserveSelectedRowKeys: true,
+ onChange: keys => setSelectedIds(keys.map(Number)),
+ }}
+ emptyDescription={canView ? '该站点码池还没有二维码' : '当前账号没有查看权限'}
+ />
+
+
+
+
+
+ }
+ >
+ = 20}
+ beforeUpload={file => {
+ addFile(file)
+ return Upload.LIST_IGNORE
+ }}
+ className="admin-qr-uploader"
+ >
+
+
+ setUploadNote(event.target.value)}
+ />
+
+
+
+ (saving ? undefined : setEditing(null))}
+ maskClosable={!saving}
+ closable={!saving}
+ footer={
+
+
+
+
+ }
+ >
+ form={editForm} layout="vertical" disabled={saving}>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ )
+}
diff --git a/frontend/src/features/admin/AdminDistributionRulesPage.tsx b/frontend/src/features/admin/AdminDistributionRulesPage.tsx
new file mode 100644
index 0000000..4b3c4af
--- /dev/null
+++ b/frontend/src/features/admin/AdminDistributionRulesPage.tsx
@@ -0,0 +1,689 @@
+import { useMemo, useState } from 'react'
+import { useQuery, useQueryClient } from '@tanstack/react-query'
+import {
+ Alert,
+ App,
+ Button,
+ Col,
+ DatePicker,
+ Form,
+ InputNumber,
+ Modal,
+ Row,
+ Select,
+ Space,
+ Switch,
+ Tag,
+ Typography,
+ type TableColumnsType,
+} from 'antd'
+import {
+ CheckCircleOutlined,
+ PlusOutlined,
+ ReloadOutlined,
+ SafetyCertificateOutlined,
+ StopOutlined,
+} from '@ant-design/icons'
+import dayjs, { type Dayjs } from 'dayjs'
+
+import {
+ createAdminDistributionRule,
+ fetchAdminDistributionRules,
+ updateAdminDistributionRuleStatus,
+} from '@/features/admin/api'
+import { AdminPageHeader } from '@/features/admin/components/AdminPageHeader'
+import { DataTable } from '@/features/admin/components/DataTable'
+import { FilterBar, FilterField } from '@/features/admin/components/FilterBar'
+import { StatusTag } from '@/features/admin/components/StatusTag'
+import { readStatusMeta, type StatusMeta } from '@/features/admin/labels'
+import type {
+ AdminDistributionRule,
+ CreateAdminDistributionRulePayload,
+} from '@/features/admin/types'
+import { useAdminSessionStore } from '@/stores/adminSession'
+import { useDistributionSiteSelection } from '@/features/admin/components/DistributionSiteSelect'
+import { formatDateTime, formatText } from '@/shared/utils/format'
+
+const modeLabels: Record
+
点击或拖拽二维码图片到这里
+支持批量选择，图片不压缩；可手动填写群名后再提交。
+
+ {pendingImages.map(item => (
+
+
+ 
+
+ setPendingImages(current =>
+ current.map(row =>
+ row.id === item.id ? { ...row, groupName: event.target.value } : row
+ )
+ )
+ }
+ />
+ }
+ disabled={uploading}
+ onClick={() => removePending(item.id)}
+ />
+
+ ))}
+
+ v{row.version}
+ {siteName(row.site_id)}
+ ID #{row.id}
+
+ ),
+ },
+ {
+ title: '模式',
+ dataIndex: 'mode',
+ width: 180,
+ render: value =>
+ {ratioSummary(row)}
+ 服务费 {serviceFeeText(row)}
+ 支付费率 {formatBps(row.payment_fee_bps)}
+
+ ),
+ },
+ {
+ title: '税费',
+ key: 'tax',
+ width: 150,
+ render: (_, row) =>
+ row.tax_enabled ? (
+
+
+ 共 {summary.total} 个版本
+ 生效中 {summary.active}
+ {summary.sites} 个作用域
+ {rulesQuery.isFetching ? 正在更新 : null}
+
+ }
+ extra={
+
+ {canManage ? (
+ } onClick={openCreate}>
+ 新建规则
+
+ ) : null}
+ }
+ onClick={() => void rulesQuery.refetch()}
+ loading={rulesQuery.isFetching}
+ disabled={!canView}
+ >
+ 刷新
+
+
+ }
+ />
+
+ {!canView ? (
+ {
+ setSiteFilter(draftSiteId)
+ setModeFilter(draftMode)
+ }}
+ onReset={
+ draftSiteId !== 'all' || draftMode || siteFilter !== 'all' || modeFilter
+ ? () => {
+ setDraftSiteId('all')
+ setDraftMode(undefined)
+ setSiteFilter('all')
+ setModeFilter(undefined)
+ }
+ : undefined
+ }
+ loading={rulesQuery.isFetching}
+ extra={
+
+ {rulesQuery.isPending ? '加载中' : `当前 ${rows.length} 个版本`}
+
+ }
+ >
+
+
+
+
+
+
+ {rulesQuery.isError ? (
+ void rulesQuery.refetch()}>
+ 重试
+
+ }
+ />
+ ) : null}
+
+
+ title="规则版本列表"
+ rowKey="id"
+ columns={columns}
+ dataSource={rows}
+ loading={rulesQuery.isFetching}
+ emptyDescription={canView ? '还没有规则版本' : '当前账号没有查看权限'}
+ />
+
+ (creating ? undefined : setEditorOpen(false))}
+ footer={
+
+
+
+
+ }
+ >
+
+ form={form}
+ layout="vertical"
+ disabled={creating}
+ initialValues={{
+ scope: 'global',
+ mode: 'two_party_distributor_receive',
+ service_fee_unit: 'percent',
+ payment_fee_bps: 50,
+ tax_enabled: false,
+ tax_rate_bps: 100,
+ ...defaultRatios('two_party_distributor_receive'),
+ }}
+ >
+
+
+
+
+
+ {
+ if (form.getFieldValue('scope') === 'site' && !value) {
+ throw new Error('请选择站点')
+ }
+ },
+ },
+ ]}
+ >
+
+
+
+
+
+
+
+
+ {mode === 'two_party_platform_receive' ? (
+
+
+
+ ) : null}
+ {mode === 'two_party_distributor_receive' ? (
+
+
+
+ ) : null}
+ {mode === 'two_party_distributor_receive' ? (
+
+
+
+ ) : null}
+ {mode === 'two_party_platform_receive' ? (
+
+
+
+ ) : null}
+ {mode === 'three_party' ? (
+ <>
+
+
+
+
+
+
+
+ ) : null}
+ {mode === 'site_self_sell' ? (
+
+
+
+ ) : null}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ )
+}
diff --git a/frontend/src/features/admin/AdminDistributionSMSPage.tsx b/frontend/src/features/admin/AdminDistributionSMSPage.tsx
new file mode 100644
index 0000000..1d3d2a9
--- /dev/null
+++ b/frontend/src/features/admin/AdminDistributionSMSPage.tsx
@@ -0,0 +1,426 @@
+import { useEffect, useState } from 'react'
+import { useQuery, useQueryClient } from '@tanstack/react-query'
+import {
+ Alert,
+ App,
+ Button,
+ Card,
+ Col,
+ Divider,
+ Form,
+ Input,
+ Row,
+ Select,
+ Space,
+ Switch,
+ Tag,
+ Typography,
+} from 'antd'
+import { MessageOutlined, ReloadOutlined, SendOutlined } from '@ant-design/icons'
+
+import {
+ fetchAdminDistributionSMSConfig,
+ testAdminDistributionSMSConfig,
+ updateAdminDistributionSMSConfig,
+} from '@/features/admin/api'
+import { AdminPageHeader } from '@/features/admin/components/AdminPageHeader'
+import {
+ DistributionSiteSelect,
+ useDistributionSiteSelection,
+} from '@/features/admin/components/DistributionSiteSelect'
+import type { UpdateAdminDistributionSMSConfigPayload } from '@/features/admin/types'
+import { useAdminSessionStore } from '@/stores/adminSession'
+import { formatDateTime } from '@/shared/utils/format'
+
+interface SMSFormValues {
+ enabled: boolean
+ provider: string
+ access_key_id: string
+ access_key_secret?: string
+ endpoint: string
+ sign_name: string
+ login_template_code: string
+ business_templates: Record
+
+ {config ? (
+
+ {config.enabled ? '已启用' : '未启用'}
+
+ ) : null}
+ {config?.has_secret ? 密钥已配置 : 密钥未配置 }
+ {updatedAt ? 保存于 {formatDateTime(updatedAt)} : null}
+
+ }
+ extra={
+ }
+ onClick={refresh}
+ loading={configQuery.isFetching}
+ disabled={!canView}
+ >
+ 刷新
+
+ }
+ />
+
+ {!canView ? (
+
+ 重试
+
+ }
+ />
+ ) : null}
+
+
+
+
+ form={form}
+ layout="vertical"
+ disabled={!canManage || saving || !config}
+ initialValues={{
+ enabled: false,
+ provider: 'aliyun',
+ business_templates: emptyBusinessTemplates,
+ }}
+ >
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 业务节点模板
+
+ 留空表示该节点回退主站模板；保存时会整体覆盖本站节点映射。
+
+ {businessNodes.map(node => (
+
+ {node.name}
+ {node.code}
+ 参考 {node.template}
+
+ }
+ extra={node.description}
+ >
+
+
+ ))}
+
+
+
+ {!canManage ? (
+
+ 需要 distribution:site_manage 权限
+
+ ) : null}
+
+
+
+
+
+
+
+ 测试将使用当前表单中的配置（含尚未保存的修改），不会写入站点配置。
+
+
+
+
+
+
+ )
+}
diff --git a/frontend/src/features/admin/AdminDistributionSettlementsPage.tsx b/frontend/src/features/admin/AdminDistributionSettlementsPage.tsx
new file mode 100644
index 0000000..2a9e7df
--- /dev/null
+++ b/frontend/src/features/admin/AdminDistributionSettlementsPage.tsx
@@ -0,0 +1,501 @@
+import { useMemo, useState } from 'react'
+import { useQuery, useQueryClient } from '@tanstack/react-query'
+import {
+ Alert,
+ App,
+ Button,
+ DatePicker,
+ Form,
+ Modal,
+ Space,
+ Table,
+ Tag,
+ Typography,
+ type TableColumnsType,
+} from 'antd'
+import {
+ CheckCircleOutlined,
+ PlusOutlined,
+ ReloadOutlined,
+ StopOutlined,
+ UnorderedListOutlined,
+} from '@ant-design/icons'
+import dayjs, { type Dayjs } from 'dayjs'
+
+import {
+ cancelAdminDistributionSettlementBatch,
+ createAdminDistributionSettlementBatch,
+ fetchAdminDistributionSettlementBatches,
+ fetchAdminDistributionSettlementItems,
+ settleAdminDistributionSettlementBatch,
+} from '@/features/admin/api'
+import { AdminPageHeader } from '@/features/admin/components/AdminPageHeader'
+import { DataTable } from '@/features/admin/components/DataTable'
+import {
+ DistributionSiteSelect,
+ useDistributionSiteSelection,
+} from '@/features/admin/components/DistributionSiteSelect'
+import { StatusTag } from '@/features/admin/components/StatusTag'
+import { readStatusMeta, type StatusMeta } from '@/features/admin/labels'
+import type {
+ AdminDistributionSettlementBatch,
+ AdminDistributionSettlementItem,
+} from '@/features/admin/types'
+import { useAdminSessionStore } from '@/stores/adminSession'
+import { formatDateTime, formatMoney } from '@/shared/utils/format'
+
+const batchStatusMap: Record
+
+
+ 服务商
+ {config?.provider || 'aliyun'}
+
+
+ 签名
+ {config?.sign_name || '未配置'}
+
+
+ 登录模板
+ {config?.login_template_code || '未配置'}
+
+
+ 入账金额：{formatMoney(batch.total_amount_cent)}
+ 释放后会立即转入站点可提现余额，人工批次不走冷却期。
+
+ ),
+ okText: '确认入账',
+ cancelText: '取消',
+ onOk: async () => {
+ setWorkingId(batch.id)
+ try {
+ await settleAdminDistributionSettlementBatch(batch.id)
+ message.success('批次已释放到站点可提现余额')
+ await Promise.all([
+ queryClient.invalidateQueries({
+ queryKey: ['admin-distribution-settlement-batches', siteId],
+ }),
+ queryClient.invalidateQueries({
+ queryKey: ['admin-distribution-settlement-items', batch.id],
+ }),
+ queryClient.invalidateQueries({
+ queryKey: ['admin-distribution-wallet', siteId],
+ }),
+ ])
+ } catch (error) {
+ message.error(errorText(error))
+ } finally {
+ setWorkingId(undefined)
+ }
+ },
+ })
+ }
+
+ const cancelBatch = (batch: AdminDistributionSettlementBatch) => {
+ modal.confirm({
+ title: `确认作废批次 ${batch.batch_no}？`,
+ content: '作废后批次内订单可重新进入自动释放或新的人工批次。',
+ okText: '确认作废',
+ okButtonProps: { danger: true },
+ cancelText: '取消',
+ onOk: async () => {
+ setWorkingId(batch.id)
+ try {
+ await cancelAdminDistributionSettlementBatch(batch.id)
+ message.success('批次已作废')
+ await queryClient.invalidateQueries({
+ queryKey: ['admin-distribution-settlement-batches', siteId],
+ })
+ } catch (error) {
+ message.error(errorText(error))
+ } finally {
+ setWorkingId(undefined)
+ }
+ },
+ })
+ }
+
+ const columns: TableColumnsType
+ {row.batch_no}
+ {batchKind(row.batch_no).label}
+
+ ),
+ },
+ {
+ title: '对账周期',
+ key: 'period',
+ width: 250,
+ render: (_, row) => (
+
+ {formatDateTime(row.period_start)} ~ {formatDateTime(row.period_end)}
+
+ ),
+ },
+ {
+ title: '入账金额',
+ dataIndex: 'total_amount_cent',
+ width: 150,
+ align: 'right',
+ render: value => {formatMoney(value)},
+ },
+ {
+ title: '状态',
+ dataIndex: 'status',
+ width: 120,
+ render: value =>
+
+ 共 {summary.total} 个批次
+ 待入账 {summary.pendingCount}
+ 待入账金额 {formatMoney(summary.pendingAmount)}
+ 已入账 {formatMoney(summary.settledAmount)}
+
+ }
+ extra={
+
+ {canManage ? (
+ }
+ disabled={!siteId}
+ onClick={openCreate}
+ >
+ 生成人工批次
+
+ ) : null}
+ }
+ onClick={refresh}
+ loading={batchesQuery.isFetching}
+ disabled={!canView}
+ >
+ 刷新
+
+
+ }
+ />
+
+ {!canView ? (
+
+ 重试
+
+ }
+ />
+ ) : null}
+
+
+ title="站点结算批次"
+ rowKey="id"
+ columns={columns}
+ dataSource={batches}
+ loading={batchesQuery.isFetching}
+ emptyDescription={canView ? '该站点还没有结算批次' : '当前账号没有查看权限'}
+ extra={
+
+ {selection.site ? `${selection.site.site_name} · ${selection.site.site_code}` : ''}
+
+ }
+ />
+
+ (creating ? undefined : setCreateOpen(false))}
+ footer={
+
+
+
+
+ }
+ >
+ form={form} layout="vertical" disabled={creating}>
+
+
+
+ 周期采用左闭右开：开始时间 ≤ 财务快照创建时间 < 结束时间。
+
+
+
+
+ setItemsBatch(undefined)}
+ footer={
+
+ }
+ >
+
+
+ {itemsBatch ? batchKind(itemsBatch.batch_no).label : '批次'}
+
+ {itemsBatch ? (
+
+ 合计 {formatMoney(itemsBatch?.total_amount_cent ?? 0)}
+
+
+
+ rowKey="id"
+ size="small"
+ columns={itemColumns}
+ dataSource={itemsQuery.data ?? []}
+ loading={itemsQuery.isFetching}
+ pagination={false}
+ scroll={{ y: 360 }}
+ locale={{ emptyText: '该批次没有明细' }}
+ />
+
+
+ )
+}
diff --git a/frontend/src/features/admin/AdminDistributionUsersPage.tsx b/frontend/src/features/admin/AdminDistributionUsersPage.tsx
new file mode 100644
index 0000000..93617c3
--- /dev/null
+++ b/frontend/src/features/admin/AdminDistributionUsersPage.tsx
@@ -0,0 +1,376 @@
+import { useMemo, useState } from 'react'
+import { keepPreviousData, useQuery } from '@tanstack/react-query'
+import {
+ Alert,
+ Avatar,
+ Button,
+ Input,
+ Select,
+ Space,
+ Tag,
+ Typography,
+ type TableColumnsType,
+} from 'antd'
+import { ReloadOutlined, TeamOutlined, UserOutlined } from '@ant-design/icons'
+
+import { fetchAdminDistributionUsers } from '@/features/admin/api'
+import { AdminPageHeader } from '@/features/admin/components/AdminPageHeader'
+import { DataTable } from '@/features/admin/components/DataTable'
+import {
+ DetailDrawer,
+ type DetailSection,
+} from '@/features/admin/components/DetailDrawer'
+import {
+ DistributionSiteSelect,
+ useDistributionSiteSelection,
+} from '@/features/admin/components/DistributionSiteSelect'
+import { FilterBar, FilterField } from '@/features/admin/components/FilterBar'
+import { StatusTag } from '@/features/admin/components/StatusTag'
+import {
+ readStatusMeta,
+ realnameStatusMap,
+ userStatusMap,
+} from '@/features/admin/labels'
+import type {
+ AdminDistributionUser,
+ AdminDistributionUserQuery,
+} from '@/features/admin/types'
+import { useAdminSessionStore } from '@/stores/adminSession'
+import {
+ formatDateTime,
+ formatMoney,
+ formatText,
+ maskPhone,
+} from '@/shared/utils/format'
+
+const sourceLabels: Record
+
+ ),
+ },
+ {
+ title: '来源',
+ dataIndex: 'source',
+ width: 130,
+ render: value => (
+
+ {formatText(row.nickname)}
+ {maskPhone(row.phone)}
+ ID #{row.id}
+
+
+
+ ),
+ },
+ {
+ title: '有效订单',
+ dataIndex: 'order_count',
+ width: 110,
+ align: 'right',
+ render: value => `${value} 单`,
+ },
+ {
+ title: '累计消费',
+ dataIndex: 'total_spent_cent',
+ width: 140,
+ align: 'right',
+ render: value => (
+ {formatMoney(value)}
+ ),
+ },
+ {
+ title: '最近下单',
+ dataIndex: 'last_order_at',
+ width: 170,
+ render: value => formatDateTime(value),
+ },
+ {
+ title: '注册时间',
+ dataIndex: 'created_at',
+ width: 170,
+ render: value => formatDateTime(value),
+ },
+ {
+ title: '最近登录',
+ dataIndex: 'last_login_at',
+ width: 170,
+ render: value => formatDateTime(value),
+ },
+ {
+ title: '操作',
+ key: 'actions',
+ width: 90,
+ fixed: 'right',
+ render: (_, row) => (
+
+ ),
+ },
+ ]
+
+ const summary = useMemo(
+ () => ({
+ totalUsers: data?.total_users ?? 0,
+ orderUsers: data?.order_users ?? 0,
+ filtered: data?.total ?? 0,
+ }),
+ [data]
+ )
+
+ const applyFilters = () => {
+ setFilters({
+ keyword: draftFilters.keyword?.trim() || undefined,
+ source: draftFilters.source === 'all' ? undefined : draftFilters.source,
+ })
+ setPage(1)
+ }
+
+ const resetFilters = () => {
+ setDraftFilters({})
+ setFilters({})
+ setPage(1)
+ }
+
+ return (
+
+
+ 本站注册 {summary.totalUsers}
+ 成交客户 {summary.orderUsers}
+ 筛选结果 {summary.filtered}
+ {usersQuery.isFetching ? 正在更新 : null}
+
+ }
+ extra={
+ }
+ onClick={() => {
+ void usersQuery.refetch()
+ void selection.refetch()
+ }}
+ loading={usersQuery.isFetching}
+ disabled={!canView}
+ >
+ 刷新
+
+ }
+ />
+
+ {!canView ? (
+
+ {usersQuery.isPending ? '加载中' : `当前 ${rows.length} 位客户`}
+
+ }
+ >
+
+
+ setDraftFilters(current => ({ ...current, keyword: event.target.value }))
+ }
+ />
+
+
+
+
+
+ {usersQuery.isError ? (
+ void usersQuery.refetch()}>
+ 重试
+
+ }
+ />
+ ) : null}
+
+
+ title="站点客户"
+ rowKey="id"
+ columns={columns}
+ dataSource={rows}
+ loading={usersQuery.isFetching}
+ total={data?.total ?? 0}
+ page={page}
+ pageSize={pageSize}
+ onPageChange={(nextPage, nextSize) => {
+ setPage(nextPage)
+ setPageSize(nextSize)
+ }}
+ emptyDescription={canView ? '该站点还没有客户' : '当前账号没有查看权限'}
+ />
+
+ setSelected(undefined)}
+ title={selected ? selected.nickname || maskPhone(selected.phone) : '分销客户'}
+ subtitle={
+ selected
+ ? `${selection.site?.site_name ?? ''} · ${sourceLabels[selected.source] ?? ''}`
+ : undefined
+ }
+ tags={
+ selected ? (
+
+
+ ) : undefined
+ }
+ sections={selected ? buildSections(selected) : []}
+ width={720}
+ />
+
+ )
+}
diff --git a/frontend/src/features/admin/AdminDistributionWalletPage.tsx b/frontend/src/features/admin/AdminDistributionWalletPage.tsx
new file mode 100644
index 0000000..bc5089b
--- /dev/null
+++ b/frontend/src/features/admin/AdminDistributionWalletPage.tsx
@@ -0,0 +1,474 @@
+import { useMemo, useState } from 'react'
+import { keepPreviousData, useQuery, useQueryClient } from '@tanstack/react-query'
+import {
+ Alert,
+ App,
+ Button,
+ Card,
+ Col,
+ Form,
+ Input,
+ Row,
+ Select,
+ Space,
+ Tag,
+ Typography,
+ type TableColumnsType,
+} from 'antd'
+import {
+ BankOutlined,
+ ClockCircleOutlined,
+ ReloadOutlined,
+ WalletOutlined,
+} from '@ant-design/icons'
+
+import {
+ applyAdminDistributionWithdrawal,
+ fetchAdminDistributionWallet,
+ fetchAdminDistributionWithdrawals,
+} from '@/features/admin/api'
+import { AdminPageHeader } from '@/features/admin/components/AdminPageHeader'
+import { DataTable } from '@/features/admin/components/DataTable'
+import {
+ DistributionSiteSelect,
+ useDistributionSiteSelection,
+} from '@/features/admin/components/DistributionSiteSelect'
+import { StatusTag } from '@/features/admin/components/StatusTag'
+import { readStatusMeta, withdrawalStatusMap } from '@/features/admin/labels'
+import type {
+ AdminDistributionWallet,
+ AdminDistributionWithdrawal,
+ ApplyAdminDistributionWithdrawalPayload,
+} from '@/features/admin/types'
+import { useAdminSessionStore } from '@/stores/adminSession'
+import { formatDateTime, formatMoney, formatText } from '@/shared/utils/format'
+import { parseYuanToCent } from '@/shared/utils/pricing'
+
+interface WithdrawalFormValues {
+ amount_yuan: string
+ account_type: 'alipay' | 'bank'
+ account_name: string
+ account_no: string
+ bank_name?: string
+ bank_branch?: string
+}
+
+const walletMetrics: Array<{
+ key: keyof Pick<
+ AdminDistributionWallet,
+ | 'available_balance_cent'
+ | 'frozen_balance_cent'
+ | 'pending_release_cent'
+ | 'total_settled_cent'
+ | 'total_withdrawn_cent'
+ >
+ label: string
+ hint: string
+ accent?: boolean
+}> = [
+ { key: 'available_balance_cent', label: '可用余额', hint: '可立即申请提现', accent: true },
+ { key: 'frozen_balance_cent', label: '冻结余额', hint: '提现审核中暂时冻结' },
+ { key: 'pending_release_cent', label: '待释放收益', hint: '订单已完成、尚未进入结算批次' },
+ { key: 'total_settled_cent', label: '累计结算', hint: '已进入结算批次的站内收益' },
+ { key: 'total_withdrawn_cent', label: '累计提现', hint: '已完成打款的历史提现' },
+]
+
+const withdrawalColumns: TableColumnsType
+ {formatMoney(row.amount_cent)}
+ 手续费 {formatMoney(row.fee_cent)}
+ 到账 {formatMoney(row.actual_amount_cent)}
+
+ ),
+ },
+ {
+ title: '收款账户',
+ key: 'account',
+ width: 230,
+ render: (_, row) => (
+
+
+ {row.account_type === 'alipay' ? '支付宝' : '银行卡'} · {formatText(row.account_name)}
+
+ {formatText(row.account_no)}
+ {row.bank_name ? (
+
+ {row.bank_name}
+ {row.bank_branch ? ` · ${row.bank_branch}` : ''}
+
+ ) : null}
+
+ ),
+ },
+ {
+ title: '状态',
+ dataIndex: 'status',
+ width: 110,
+ render: value =>
+ 审核：{formatText(row.review_remark)}
+ 打款：{formatText(row.payment_remark)}
+
+ ),
+ },
+ {
+ title: '时间',
+ key: 'time',
+ width: 180,
+ render: (_, row) => (
+
+ 申请 {formatDateTime(row.created_at)}
+ 打款 {formatDateTime(row.paid_at)}
+
+ ),
+ },
+]
+
+function errorText(error: unknown) {
+ const response = (error as { response?: { data?: { message?: string } } })?.response
+ if (response?.data?.message) return response.data.message
+ return error instanceof Error ? error.message : '请求失败，请稍后重试'
+}
+
+export function AdminDistributionWalletPage() {
+ const { message, modal } = App.useApp()
+ const queryClient = useQueryClient()
+ const [form] = Form.useForm
+ 站点：{selection.site?.site_name ?? `#${siteId}`}
+ 提现金额：{formatMoney(amountCent)}
+ 收款人：{payload.account_name}
+ 提交后对应金额会从可用余额转入冻结余额。
+
+ ),
+ okText: '确认提交',
+ cancelText: '取消',
+ onOk: async () => {
+ setSubmitting(true)
+ try {
+ await applyAdminDistributionWithdrawal(siteId, payload)
+ message.success('提现申请已提交')
+ form.resetFields(['amount_yuan'])
+ await Promise.all([
+ queryClient.invalidateQueries({ queryKey: ['admin-distribution-wallet', siteId] }),
+ queryClient.invalidateQueries({
+ queryKey: ['admin-distribution-withdrawals', siteId],
+ }),
+ ])
+ } catch (error) {
+ message.error(errorText(error))
+ } finally {
+ setSubmitting(false)
+ }
+ },
+ })
+ }
+
+ const refresh = () => {
+ void walletQuery.refetch()
+ void withdrawalsQuery.refetch()
+ void selection.refetch()
+ }
+
+ const availableHint = useMemo(() => {
+ if (!wallet) return ''
+ return `可用 ${formatMoney(wallet.available_balance_cent)}，结算冷却 ${wallet.settlement_hold_days} 天`
+ }, [wallet])
+
+ return (
+
+
+ 金额单位：分
+ {wallet ? {availableHint} : null}
+ {walletQuery.isFetching ? 正在刷新 : null}
+
+ }
+ extra={
+ }
+ onClick={refresh}
+ loading={walletQuery.isFetching || withdrawalsQuery.isFetching}
+ disabled={!canView}
+ >
+ 刷新
+
+ }
+ />
+
+ {!canView ? (
+
+ 重试
+
+ }
+ />
+ ) : null}
+
+ {canView && !siteId && !selection.isLoading ? (
+
+
+
+ 可用 {formatMoney(wallet.available_balance_cent)}
+
+ ) : null
+ }
+ >
+
+ form={form}
+ layout="vertical"
+ disabled={!canManage || submitting || !wallet}
+ initialValues={{ account_type: 'alipay' }}
+ >
+ {
+ if (!value) return
+ const cent = parseYuanToCent(value)
+ if (!Number.isFinite(cent) || cent <= 0) {
+ throw new Error('金额格式不正确')
+ }
+ if (wallet && cent > wallet.available_balance_cent) {
+ throw new Error('提现金额超过可用余额')
+ }
+ },
+ },
+ ]}
+ >
+
+
+
+
+
+
+
+
+
+
+
+ {accountType === 'bank' ? (
+ <>
+
+
+
+
+
+
+
+ ) : null}
+ }
+ loading={submitting}
+ onClick={() => void submit()}
+ >
+ 提交提现申请
+
+ {!canManage ? (
+
+ 当前账号只有查看权限，需要 distribution:settlement_manage 才能提交申请。
+
+ ) : null}
+
+
+
+
+
+ title={
+
+
+ }
+ extra={
+
+ {withdrawalsQuery.isPending ? '加载中' : `共 ${withdrawals?.total ?? 0} 笔`}
+
+ }
+ rowKey="id"
+ columns={withdrawalColumns}
+ dataSource={withdrawals?.items ?? []}
+ loading={withdrawalsQuery.isFetching}
+ total={withdrawals?.total ?? 0}
+ page={page}
+ pageSize={pageSize}
+ onPageChange={(nextPage, nextSize) => {
+ setPage(nextPage)
+ setPageSize(nextSize)
+ }}
+ emptyDescription={canView ? '该站点还没有提现记录' : '当前账号没有查看权限'}
+ />
+
+
+
+ )
+}
diff --git a/frontend/src/features/admin/AdminSiteAnnouncementsPage.tsx b/frontend/src/features/admin/AdminSiteAnnouncementsPage.tsx
new file mode 100644
index 0000000..38833a5
--- /dev/null
+++ b/frontend/src/features/admin/AdminSiteAnnouncementsPage.tsx
@@ -0,0 +1,557 @@
+import { useState } from 'react'
+import { keepPreviousData, useQuery } from '@tanstack/react-query'
+import {
+ Alert,
+ App,
+ Button,
+ Col,
+ Form,
+ Input,
+ InputNumber,
+ Modal,
+ Row,
+ Select,
+ Space,
+ Switch,
+ Tag,
+ Typography,
+ type TableColumnsType,
+} from 'antd'
+import {
+ DeleteOutlined,
+ EditOutlined,
+ InboxOutlined,
+ PlusOutlined,
+ ReloadOutlined,
+ SendOutlined,
+ StopOutlined,
+} from '@ant-design/icons'
+
+import {
+ archiveAdminSiteAnnouncement,
+ createAdminSiteAnnouncement,
+ deleteAdminSiteAnnouncement,
+ fetchAdminSiteAnnouncements,
+ publishAdminSiteAnnouncement,
+ unarchiveAdminSiteAnnouncement,
+ updateAdminSiteAnnouncement,
+} from '@/features/admin/api'
+import { AdminPageHeader } from '@/features/admin/components/AdminPageHeader'
+import { DataTable } from '@/features/admin/components/DataTable'
+import {
+ DetailDrawer,
+ type DetailSection,
+} from '@/features/admin/components/DetailDrawer'
+import {
+ DistributionSiteSelect,
+ useDistributionSiteSelection,
+} from '@/features/admin/components/DistributionSiteSelect'
+import { FilterBar, FilterField } from '@/features/admin/components/FilterBar'
+import { StatusTag } from '@/features/admin/components/StatusTag'
+import {
+ announcementCategoryMap,
+ announcementCategoryOptions,
+ announcementStatusMap,
+ announcementStatusOptions,
+ readStatusMeta,
+} from '@/features/admin/labels'
+import type {
+ AdminSiteAnnouncement,
+ AdminSiteAnnouncementPayload,
+} from '@/features/admin/types'
+import { useAdminSessionStore } from '@/stores/adminSession'
+import { formatDateTime, formatText } from '@/shared/utils/format'
+
+function errorText(error: unknown) {
+ const response = (error as { response?: { data?: { message?: string } } })?.response
+ if (response?.data?.message) return response.data.message
+ return error instanceof Error ? error.message : '请求失败，请稍后重试'
+}
+
+function buildSections(item: AdminSiteAnnouncement): DetailSection[] {
+ return [
+ {
+ key: 'content',
+ title: '公告内容',
+ icon:
+ {walletMetrics.map(metric => (
+
+ {metric.label}
+
+ {formatMoney(wallet[metric.key])}
+
+ {metric.hint}
+
+ ))}
+
+ ) : null}
+
+ {item.content}
,
+ },
+ ],
+ },
+ ]
+}
+
+export function AdminSiteAnnouncementsPage() {
+ const { message, modal } = App.useApp()
+ const [form] = Form.useForm
+
+ {row.content.slice(0, 80)}{row.content.length > 80 ? '…' : ''}
+
+ {announcementCategoryMap[row.category] ?? row.category}
+ {row.is_pinned ? 置顶 : null}
+ {row.is_important ? 重要 : null}
+ {row.is_popup ? 弹窗 : null}
+
+
+ ),
+ },
+ {
+ title: '状态',
+ dataIndex: 'status',
+ width: 110,
+ render: value =>
+
+ 共 {data?.total ?? 0} 条
+ {selection.site ? {selection.site.site_name} : null}
+ {listQuery.isFetching ? 正在更新 : null}
+
+ }
+ extra={
+
+ {canManage ? (
+ }
+ disabled={!siteId}
+ onClick={openCreate}
+ >
+ 新建公告
+
+ ) : null}
+ }
+ onClick={() => {
+ void listQuery.refetch()
+ void selection.refetch()
+ }}
+ loading={listQuery.isFetching}
+ disabled={!canView}
+ >
+ 刷新
+
+
+ }
+ />
+
+ {!canView ? (
+ setPage(1)}
+ onReset={
+ status
+ ? () => {
+ setStatus(undefined)
+ setPage(1)
+ }
+ : undefined
+ }
+ loading={listQuery.isFetching}
+ extra={
+
+ {listQuery.isPending ? '加载中' : `当前 ${rows.length} 条`}
+
+ }
+ >
+
+
+
+
+ {listQuery.isError ? (
+ void listQuery.refetch()}>
+ 重试
+
+ }
+ />
+ ) : null}
+
+
+ title="本站公告"
+ rowKey="id"
+ columns={columns}
+ dataSource={rows}
+ loading={listQuery.isFetching}
+ total={data?.total ?? 0}
+ page={page}
+ pageSize={pageSize}
+ onPageChange={(nextPage, nextSize) => {
+ setPage(nextPage)
+ setPageSize(nextSize)
+ }}
+ emptyDescription={canView ? '该站点还没有公告' : '当前账号没有查看权限'}
+ />
+
+ setDetail(undefined)}
+ title={detail?.title ?? '站点公告'}
+ subtitle={
+ detail
+ ? `${selection.site?.site_name ?? ''} · ${
+ announcementCategoryMap[detail.category] ?? detail.category
+ }`
+ : undefined
+ }
+ tags={
+ detail ? (
+
+ } onClick={() => openEdit(detail)}>
+ 编辑
+
+ } onClick={() => remove(detail)}>
+ 删除
+
+
+ ) : undefined
+ }
+ />
+
+ (submitting ? undefined : setEditorOpen(false))}
+ footer={
+
+
+
+
+ }
+ >
+ form={form} layout="vertical" disabled={submitting}>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ )
+}
diff --git a/frontend/src/features/admin/api.ts b/frontend/src/features/admin/api.ts
index c04d1ea..a31cb08 100644
--- a/frontend/src/features/admin/api.ts
+++ b/frontend/src/features/admin/api.ts
@@ -1,6 +1,7 @@
import { adminClient } from '@/shared/api/adminClient'
import type { ApiResponse } from '@/shared/api/types'
import type {
+ AdminAccountDisplay,
AdminAnnouncement,
AdminAnnouncementPage,
AdminAnnouncementPayload,
@@ -12,8 +13,30 @@ import type {
AdminDispute,
AdminDisputePage,
AdminDisputeQuery,
+ AdminDistributionInvitationConfig,
+ AdminDistributionOrder,
+ AdminDistributionOrderPage,
+ AdminDistributionOrderQuery,
+ AdminDistributionQrCode,
+ AdminDistributionQrCodePage,
+ AdminDistributionQrCodeQuery,
+ AdminDistributionQrCodeStats,
+ AdminDistributionRule,
+ AdminDistributionRuleQuery,
+ AdminDistributionSettlementBatch,
+ AdminDistributionSettlementItem,
AdminDistributionSite,
AdminDistributionSiteUpdatePayload,
+ AdminDistributionSMSConfig,
+ AdminDistributionUserPage,
+ AdminDistributionUserQuery,
+ AdminDistributionWallet,
+ AdminDistributionWithdrawal,
+ AdminDistributionWithdrawalPage,
+ AdminSiteAnnouncement,
+ AdminSiteAnnouncementPage,
+ AdminSiteAnnouncementPayload,
+ AdminSiteAnnouncementQuery,
AdminListing,
AdminListingPage,
AdminListingQuery,
@@ -21,6 +44,10 @@ import type {
AdminOrderDetail,
AdminOrderPage,
AdminOrderQuery,
+ AdminPaymentChannel,
+ AdminPaymentConfigOption,
+ AdminReceivedListingPage,
+ AdminReceivedListingQuery,
AdminSystemConfig,
AdminSystemConfigUpdatePayload,
AdminUser,
@@ -30,6 +57,10 @@ import type {
AdminWithdrawal,
AdminWithdrawalPage,
AdminWithdrawalQuery,
+ ApplyAdminDistributionWithdrawalPayload,
+ CreateAdminDistributionQrCodeItem,
+ CreateAdminDistributionRulePayload,
+ CreateAdminDistributionSettlementBatchPayload,
DashboardData,
FinanceDashboard,
FinanceDetailPage,
@@ -39,6 +70,10 @@ import type {
OperatingExpensePage,
OperatingExpensePayload,
OperatingExpenseQuery,
+ TestAdminDistributionSMSConfigPayload,
+ UpdateAdminDistributionInvitationConfigPayload,
+ UpdateAdminDistributionQrCodePayload,
+ UpdateAdminDistributionSMSConfigPayload,
} from '@/features/admin/types'
export async function fetchAdminCaptcha() {
@@ -469,6 +504,438 @@ export async function updateAdminDistributionSite(
return data.data
}
+export async function fetchAdminDistributionWallet(id: number | string) {
+ const { data } = await adminClient.get
+
+ 当前站点
+
+
+ )
+}
diff --git a/frontend/src/features/admin/types.ts b/frontend/src/features/admin/types.ts
index fab321a..6437e88 100644
--- a/frontend/src/features/admin/types.ts
+++ b/frontend/src/features/admin/types.ts
@@ -797,3 +797,462 @@ export interface OperatingExpensePayload {
remark: string
voucher_url?: string
}
+
+/** 分站钱包余额快照，金额单位全部为分。 */
+export interface AdminDistributionWallet {
+ site_id: number
+ available_balance_cent: number
+ frozen_balance_cent: number
+ pending_release_cent: number
+ total_settled_cent: number
+ total_withdrawn_cent: number
+ settlement_hold_days: number
+}
+
+export type AdminDistributionWithdrawalStatus =
+ | 'pending'
+ | 'processing'
+ | 'completed'
+ | 'rejected'
+ | 'cancelled'
+
+export interface AdminDistributionWithdrawal {
+ id: number
+ withdraw_no: string
+ site_id: number
+ amount_cent: number
+ fee_cent: number
+ actual_amount_cent: number
+ account_type: string
+ account_name: string
+ account_no: string
+ bank_name: string
+ bank_branch: string
+ status: string
+ review_remark: string
+ payment_proof_url: string
+ payment_remark: string
+ paid_at?: string | null
+ created_at: string
+}
+
+export interface AdminDistributionWithdrawalPage {
+ items: AdminDistributionWithdrawal[]
+ total: number
+ page: number
+ page_size: number
+}
+
+export interface ApplyAdminDistributionWithdrawalPayload {
+ amount_cent: number
+ account_type: 'alipay' | 'bank'
+ account_name: string
+ account_no: string
+ bank_name?: string
+ bank_branch?: string
+}
+
+export interface AdminDistributionSMSConfig {
+ enabled: boolean
+ provider: string
+ access_key_id: string
+ masked_secret: string
+ has_secret: boolean
+ endpoint: string
+ sign_name: string
+ login_template_code: string
+ business_templates: Record