5 Commits
Author SHA1 Message Date
yml2213andCursor 9298b31b9b feat(worker-platform): 增加寄卖白名单总开关,关闭后全员可发布
资金配置与打手列表可一键切换白名单模式;发布校验、打手端入口按总开关放行。同时收紧未开通判定、关权限确认和开通弹窗文案。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-21 14:23:00 +08:00
yml2213 937e51db6b fix(admin-worker): 修复打手管理切换寄卖权限后表格状态未自动刷新的问题
1. 修复 WorkersPanel 中 queryKey 匹配偏差,改用统一的 admin-worker-platform-workers 查询键与 refreshWorkers();
2. 引入 setQueriesData 乐观更新机制,点击 Switch 切换后毫秒级原地更新行状态,无需手动刷新页面。
2026-09-21 13:37:54 +08:00
yml2213 cb8b249e57 feat(worker-platform): 实现打手寄卖白名单权限控制与存量发布打手平滑过渡
1. 新增数据库迁移 082_worker_consignment_whitelist.sql,worker_users 表增加 can_consign 与 consignment_activated_at 字段,存量在 consignment_submissions 提报过的打手默认自动开启;
2. 打手端提报接口 publishWorkerConsignment 增加白名单权限服务端强校验拦截(403 consignment_permission_required);
3. 管理后台打手管理表格增加「寄卖权限」实时 Switch 开关列与打手详情抽屉权限展示,支持客服即时开通或关闭打手寄卖权限;
4. 打手端我要寄卖页面在未开通权限时展示专属白名单引导卡片,一键呼起联系客服开通寄卖弹窗;
5. 补充寄卖权限拦截与路由单测,前端59项单测与后端507项单测全部通过。
2026-09-21 13:30:33 +08:00
yml2213 0df5c9f34e feat(worker-platform): 抢单大厅首页新增联系客服胶囊入口并抽象通用客服弹窗组件
1. 抽离打手端通用联系客服弹窗组件 WorkerContactModal,统一维护微信二维码、打手账号/状态/余额回显、一键复制及沟通提示;
2. 抢单大厅移动端顶部状态栏(余额上限右侧首屏黄金位)新增精致微动效【联系客服】胶囊按钮,大幅缩短找客服沟通链路;
3. 抢单大厅桌面端头部操作栏同步补齐【联系客服】按钮,并在个人中心账号弹窗中统一复用 WorkerContactModal;
4. 适配移动端与超窄屏自适应响应式样式,完成前端59项测试与全量打包构建验证。
2026-09-21 12:37:38 +08:00
yml2213 a4f6f5ed9b style(worker-portal): 优化打手端我要寄卖页面顶部卡片布局,轻量化重构首屏体验
1. 移除第 4 个占位无意义的「发布寄卖 苏尔南」卡片,核心指标精准收敛为待审核、履约中、已完成 3 大状态;
2. 新增 worker-consignment-kpi-grid 紧凑统计栏,移动端改为横向 3 列等宽平铺,高度由 320px+ 骤降至 52px,竖向空间节省超 80%;
3. 剔除卡片内无实际价值的长句副说明文案,改为上行轻量状态标签 + 下行醒目数字的微排版,支持点击秒切记录过滤;
4. 彻底解决移动端首屏被巨幅卡片占满导致表单下沉的问题,首屏直接呈现履约押金提示与规格选择,提升打手发布效率;
5. 前端 59 个自动化测试全绿,全套 check 与 build 100% 通过。
2026-09-21 12:31:03 +08:00
26 changed files with 999 additions and 124 deletions
@@ -0,0 +1,24 @@
-- 082_worker_consignment_whitelist.sql —— 打手寄卖白名单激活控制与存量平滑过渡。
-- 1. worker_users 增加寄卖权限开关及激活时间
ALTER TABLE worker_users
ADD COLUMN IF NOT EXISTS can_consign BOOLEAN NOT NULL DEFAULT FALSE,
ADD COLUMN IF NOT EXISTS consignment_activated_at TIMESTAMPTZ;
COMMENT ON COLUMN worker_users.can_consign IS '是否开通寄卖权限(白名单模式:默认关闭,需客服开通)';
COMMENT ON COLUMN worker_users.consignment_activated_at IS '开通寄卖权限的时间';
-- 2. 寄卖权限字段索引(用于后台快速筛选已开通/未开通打手)
CREATE INDEX IF NOT EXISTS idx_worker_users_can_consign
ON worker_users (can_consign);
-- 3. 存量老打手平滑过渡:历史上在 consignment_submissions 中提报过的打手,默认自动开通寄卖权限
UPDATE worker_users
SET
can_consign = TRUE,
consignment_activated_at = NOW()
WHERE id IN (
SELECT DISTINCT worker_id
FROM consignment_submissions
WHERE worker_id IS NOT NULL
);
@@ -0,0 +1,26 @@
import assert from 'node:assert/strict'
import test from 'node:test'
import { canWorkerPublishConsignment } from './consignment-whitelist.js'
test('白名单关闭时所有打手都能发布寄卖', () => {
assert.equal(
canWorkerPublishConsignment({ whitelistEnabled: false, workerCanConsign: false }),
true,
)
assert.equal(
canWorkerPublishConsignment({ whitelistEnabled: false, workerCanConsign: true }),
true,
)
})
test('白名单开启时仅开通权限的打手能发布', () => {
assert.equal(
canWorkerPublishConsignment({ whitelistEnabled: true, workerCanConsign: false }),
false,
)
assert.equal(
canWorkerPublishConsignment({ whitelistEnabled: true, workerCanConsign: true }),
true,
)
})
@@ -0,0 +1,12 @@
/**
* 寄卖白名单总开关。
*
* 开启:只有 worker.can_consign 的打手能发布新寄卖。
* 关闭:所有打手都能发布;打手身上的白名单标记仍保留,方便再次开启。
*/
export function canWorkerPublishConsignment(input: {
whitelistEnabled: boolean
workerCanConsign: boolean
}): boolean {
return !input.whitelistEnabled || input.workerCanConsign
}
@@ -45,6 +45,8 @@ export type WorkerUserRow = {
is_withdrawal_blacklisted?: boolean
withdrawal_blacklist_reason?: string | null
withdrawal_blacklisted_at?: string | null
can_consign?: boolean
consignment_activated_at?: string | null
}
export type WorkerUserStatistics = {
@@ -478,3 +478,29 @@ export async function consumeWorkerRenameCard(input: {
}
return getWorkerUserById(input.workerId)
}
export async function updateWorkerConsignmentPermission(input: {
workerId: number | string
canConsign: boolean
now: string
}): Promise<WorkerUserRow | null> {
const result = await query<{ id: number }>(
`
UPDATE worker_users
SET
can_consign = $1,
consignment_activated_at = CASE
WHEN $1 = TRUE THEN COALESCE(consignment_activated_at, $2::timestamptz)
ELSE consignment_activated_at
END,
updated_at = $2
WHERE id = $3
RETURNING id
`,
[input.canConsign, input.now, Number(input.workerId)],
)
if (!result.rows[0]) {
return null
}
return getWorkerUserById(input.workerId)
}
@@ -12,6 +12,7 @@ import {
saveAdminWorkerWithdrawalAccount,
setAdminWorkerPersonalDepositFreeAmount,
updateAdminWorkerWithdrawalBlacklist,
updateAdminWorkerConsignmentPermission,
} from '../../../services/worker-platform/index.js'
import { createJsonHandler, requireAdminRoles } from '../session.js'
@@ -141,6 +142,26 @@ router.post(
),
)
router.post(
'/worker-platform/workers/:workerId/consignment-permission',
requireAdminRoles(['admin', 'operator']),
createJsonHandler(
(req) =>
updateAdminWorkerConsignmentPermission(String(req.params.workerId || ''), req.body || {}),
{
successMessage: '打手寄卖权限已更新',
errorMessage: '更新打手寄卖权限失败',
scope: '[admin/worker-platform/workers/:workerId/consignment-permission]',
audit: (req, data) => ({
action: 'worker_consignment_permission_updated',
targetType: 'worker',
targetId: String(req.params.workerId || ''),
data: data && typeof data === 'object' ? (data as Record<string, unknown>) : {},
}),
},
),
)
router.post(
'/worker-platform/workers/:workerId/wallet-credit',
requireAdminRoles(['admin', 'operator']),
@@ -0,0 +1,60 @@
import assert from 'node:assert/strict'
import { readFile } from 'node:fs/promises'
import test from 'node:test'
import { mapWorkerUser } from './worker-finance-mappers.js'
import { parseAdminWorkerConsignmentPermission } from './admin-worker-user-service.js'
import type { WorkerUserRow } from '../../repositories/worker-platform/types.js'
test('mapWorkerUser 准确回显打手寄卖白名单权限与激活时间', () => {
const fakeWorker = {
id: 101,
username: 'worker_a',
display_name: '打手A',
phone: '13800138000',
status: 'active',
worker_type: 'external',
created_at: '2026-09-01T00:00:00.000Z',
updated_at: '2026-09-01T00:00:00.000Z',
can_consign: true,
consignment_activated_at: '2026-09-20T12:00:00.000Z',
} as unknown as WorkerUserRow
const mapped = mapWorkerUser(fakeWorker)
assert.equal(mapped.canConsign, true)
assert.equal(mapped.consignmentActivatedAt, '2026-09-20T12:00:00.000Z')
const unactivatedWorker = {
...fakeWorker,
can_consign: false,
consignment_activated_at: null,
} as unknown as WorkerUserRow
const mappedUnactivated = mapWorkerUser(unactivatedWorker)
assert.equal(mappedUnactivated.canConsign, false)
assert.equal(mappedUnactivated.consignmentActivatedAt, null)
})
test('管理员打手管理路由注册了寄卖白名单权限更新接口', async () => {
const routeSource = await readFile(
new URL('../../routes/admin/worker-platform/workers.ts', import.meta.url),
'utf8',
)
assert.ok(
routeSource.includes("'/worker-platform/workers/:workerId/consignment-permission'"),
'必须注册 consignment-permission 路由',
)
assert.ok(
routeSource.includes('updateAdminWorkerConsignmentPermission'),
'路由必须调用 updateAdminWorkerConsignmentPermission',
)
})
test('更新寄卖权限必须显式传开关,空 body 不得默认关闭', () => {
assert.throws(
() => parseAdminWorkerConsignmentPermission({}),
(error: unknown) => (error as { errorCode?: string }).errorCode === 'can_consign_required',
)
assert.equal(parseAdminWorkerConsignmentPermission({ canConsign: true }), true)
assert.equal(parseAdminWorkerConsignmentPermission({ enabled: false }), false)
})
@@ -7,6 +7,7 @@ import {
updateWorkerPassword,
updateWorkerUser,
updateWorkerWithdrawalBlacklist,
updateWorkerConsignmentPermission,
} from '../../repositories/worker-platform/index.js'
import type { JsonObject } from '../../types/json.js'
import { createHttpError } from '../../utils/http.js'
@@ -178,3 +179,29 @@ export async function updateAdminWorkerWithdrawalBlacklist(
})
return { worker: mapWorkerUser(updated || worker) }
}
export function parseAdminWorkerConsignmentPermission(payload: JsonObject = {}): boolean {
const raw = payload.canConsign ?? payload.enabled
if (raw === undefined || raw === null || raw === '') {
throw createHttpError('请明确指定寄卖权限开关', {
statusCode: 400,
errorCode: 'can_consign_required',
})
}
return normalizeBoolean(raw, false)
}
export async function updateAdminWorkerConsignmentPermission(
workerId: number | string,
payload: JsonObject = {},
) {
const worker = await getRequiredWorker(workerId)
const canConsign = parseAdminWorkerConsignmentPermission(payload)
const now = nowIso()
const updated = await updateWorkerConsignmentPermission({
workerId: worker.id,
canConsign,
now,
})
return { worker: mapWorkerUser(updated || worker) }
}
@@ -83,3 +83,15 @@ test('寄卖提报硬校验:璀璨数不能超过钻石等级(1钻最多1璀
'超限必须返回专门的错误码',
)
})
test('未开通寄卖白名单权限的打手提报寄卖时被强校验拦截', async () => {
const serviceSource = await readServiceSource()
assert.ok(
serviceSource.includes('canWorkerPublishConsignment('),
'服务端必须按白名单总开关决定是否拦截未开通打手',
)
assert.ok(
serviceSource.includes("errorCode: 'consignment_permission_required'"),
'未开通必须返回专门的 consignment_permission_required 错误码',
)
})
@@ -12,6 +12,7 @@ import { listEnabledWorkProductRulesForSuggestion } from '../../repositories/wor
import { listWorkOrdersByIds } from '../../repositories/worker-platform/work-order-query-repo.js'
import type { WorkOrderRow } from '../../repositories/worker-platform/types.js'
import { deriveConsignmentItemStage } from '../../domain/consignment-item-stage.js'
import { canWorkerPublishConsignment } from '../../domain/consignment-whitelist.js'
import { suggestConsignmentPriceFromRules } from './consignment-matching-service.js'
import { hasInternalConsignmentFulfillment } from '../../repositories/worker-platform/work-order-gift-repo.js'
import type { JsonObject } from '../../types/json.js'
@@ -20,7 +21,10 @@ import { generateConsignmentSubmissionNo } from '../../utils/random.js'
import { nowIso } from '../../utils/time.js'
import { refreshStoredFileUrl } from '../file-storage/file-storage-service.js'
import { publishWorkerWalletRealtimeChange } from '../realtime/realtime-event-service.js'
import { getConsignmentPublishDepositFen as getConfiguredConsignmentPublishDepositFen } from './worker-finance-config-service.js'
import {
getConsignmentPublishDepositFen as getConfiguredConsignmentPublishDepositFen,
getWorkerFinanceConfig,
} from './worker-finance-config-service.js'
import { confirmAdminWorkOrderFriendAdded } from './admin-work-order-gift-service.js'
import { submitWorkerOrderAcceptance } from './worker-acceptance-service.js'
import type { WorkerSession } from './worker-session-context-service.js'
@@ -144,6 +148,17 @@ export async function publishWorkerConsignment(workerId: number, payload: JsonOb
if (!worker) {
throw createHttpError('打手账户不存在', { statusCode: 404, errorCode: 'worker_not_found' })
}
if (
!canWorkerPublishConsignment({
whitelistEnabled: getWorkerFinanceConfig().consignmentWhitelistEnabled,
workerCanConsign: Boolean(worker.can_consign),
})
) {
throw createHttpError('您暂未开通寄卖权限,请联系客服申请开通', {
statusCode: 403,
errorCode: 'consignment_permission_required',
})
}
const system = String(payload.system || '').trim()
const serverZone = String(payload.serverZone || '').trim()
@@ -12,6 +12,11 @@ export type WorkerFinanceConfig = {
rewardUnfreezeEnabled: boolean
/** 苏尔南寄卖发布所需履约押金(分),默认 2000 = ¥20 */
consignmentPublishDepositFen: number
/**
* 寄卖白名单总开关。开启后仅 can_consign 打手可发布;关闭后所有打手可发布。
* 缺省视为开启,保持当前白名单行为。
*/
consignmentWhitelistEnabled: boolean
recharge: {
enabled: boolean
channelName: string
@@ -71,6 +76,9 @@ export function normalizeWorkerFinanceConfig(rawValue: unknown): WorkerFinanceCo
0,
1_000_000,
),
consignmentWhitelistEnabled:
source.consignmentWhitelistEnabled !== false &&
source.consignment_whitelist_enabled !== false,
recharge: {
enabled: typeof recharge.enabled === 'boolean' ? recharge.enabled : true,
channelName: String(recharge.channelName || recharge.channel_name || '').trim(),
@@ -97,6 +105,7 @@ export function createDefaultWorkerFinanceConfig(): WorkerFinanceConfig {
depositUnfreezeDays: 3,
rewardUnfreezeEnabled: true,
consignmentPublishDepositFen: 2000,
consignmentWhitelistEnabled: true,
recharge: {
enabled: true,
channelName: '',
@@ -120,6 +129,7 @@ function refreshWorkerFinanceConfig(config: WorkerFinanceConfig): WorkerFinanceC
depositUnfreezeDays: config.depositUnfreezeDays,
rewardUnfreezeEnabled: config.rewardUnfreezeEnabled,
consignmentPublishDepositFen: config.consignmentPublishDepositFen,
consignmentWhitelistEnabled: config.consignmentWhitelistEnabled,
recharge: {
...config.recharge,
qrCodeImage: config.recharge.qrCodeImage
@@ -110,6 +110,8 @@ export function mapWorkerUser(worker: WorkerUserRow) {
renameUnlockedAt: worker.last_renamed_at
? new Date(Date.parse(worker.last_renamed_at) + WORKER_RENAME_COOLDOWN_MS).toISOString()
: null,
canConsign: Boolean(worker.can_consign),
consignmentActivatedAt: worker.consignment_activated_at || null,
}
}
@@ -402,6 +402,19 @@ test('寄卖发布押金配置保留显式零值并回退非法值', () => {
)
})
test('寄卖白名单总开关缺省开启,显式 false 才全员开放', () => {
assert.equal(normalizeWorkerFinanceConfig({}).consignmentWhitelistEnabled, true)
assert.equal(
normalizeWorkerFinanceConfig({ consignmentWhitelistEnabled: false })
.consignmentWhitelistEnabled,
false,
)
assert.equal(
normalizeWorkerFinanceConfig({ consignmentWhitelistEnabled: true }).consignmentWhitelistEnabled,
true,
)
})
test('寄卖押金释放先锁钱包再读流水,冻结额不足时拒绝部分退款', async () => {
const statements: string[] = []
const client = {
@@ -0,0 +1,80 @@
import { Alert, Button, Descriptions, Image, Modal, Space, Typography } from 'antd'
import { formatMoney, formatWorkerStatus } from '@/pages/worker/worker-profile-view-utils'
import type { WorkerFinanceConfig, WorkerUser } from '@/types/worker-platform'
export type WorkerContactModalProps = {
open: boolean
onClose: () => void
isMobile?: boolean
worker?: WorkerUser | null
financeConfig?: WorkerFinanceConfig | null
title?: string
alertMessage?: string
}
const DEFAULT_ALERT_MESSAGE =
'如需取消已接订单,请扫码联系客服处理。充值、提现与审核问题也由后台人工客服处理。'
export function WorkerContactModal({
open,
onClose,
isMobile = false,
worker,
financeConfig,
title = '联系客服',
alertMessage = DEFAULT_ALERT_MESSAGE,
}: WorkerContactModalProps) {
return (
<Modal
title={title}
open={open}
width={isMobile ? '92%' : 500}
destroyOnHidden
footer={
<Button type="primary" onClick={onClose}>
我知道了
</Button>
}
onCancel={onClose}
>
<Space direction="vertical" size={16} className="full-width">
<Alert showIcon type="info" message={alertMessage} />
{financeConfig?.adminContact?.wechatQrCodeImage ? (
<div style={{ textAlign: 'center' }}>
<Image
width={200}
src={
financeConfig.adminContact.wechatQrCodeImage.mediumUrl ||
financeConfig.adminContact.wechatQrCodeImage.url
}
alt="客服微信二维码"
/>
</div>
) : (
<Typography.Text type="secondary">
客服暂未配置微信二维码,请按下方账号信息联系。
</Typography.Text>
)}
<Descriptions column={1} bordered size="small">
<Descriptions.Item label="账号">
<Typography.Text copyable>{worker?.username || '-'}</Typography.Text>
</Descriptions.Item>
<Descriptions.Item label="昵称">{worker?.displayName || '-'}</Descriptions.Item>
<Descriptions.Item label="手机号">
<Typography.Text copyable>{worker?.phone || '-'}</Typography.Text>
</Descriptions.Item>
<Descriptions.Item label="账号状态">
{formatWorkerStatus(worker?.status || '')}
</Descriptions.Item>
<Descriptions.Item label="当前余额">
{formatMoney(worker?.wallet?.availableAmount)}
</Descriptions.Item>
</Descriptions>
<Typography.Paragraph className="worker-profile-help-text">
建议沟通时一起提供:申请类型、金额、订单号或转账备注、收款方式,以及当前账号信息。
</Typography.Paragraph>
</Space>
</Modal>
)
}
@@ -44,6 +44,7 @@ type FinanceConfigFormValues = {
depositUnfreezeDays?: number
rewardUnfreezeEnabled?: boolean
consignmentPublishDepositYuan?: number
consignmentWhitelistEnabled?: boolean
recharge?: {
enabled?: boolean
channelName?: string
@@ -173,6 +174,7 @@ export default function FinancePanel() {
consignmentPublishDepositFen: Math.round(
Number(values.consignmentPublishDepositYuan ?? 20) * 100,
),
consignmentWhitelistEnabled: values.consignmentWhitelistEnabled !== false,
recharge: {
enabled: values.recharge?.enabled !== false,
channelName: String(values.recharge?.channelName || '').trim(),
@@ -426,6 +428,14 @@ export default function FinancePanel() {
>
<InputNumber min={0} max={10000} step={1} addonBefore="¥" />
</Form.Item>
<Form.Item
label="寄卖白名单"
name="consignmentWhitelistEnabled"
valuePropName="checked"
tooltip="开启后只有后台开通权限的打手能发布寄卖;关闭后所有打手均可发布。打手身上的白名单标记会保留,方便再次开启。"
>
<Switch checkedChildren="仅白名单" unCheckedChildren="全员可寄卖" />
</Form.Item>
<Form.Item
label="报酬待解冻"
name="rewardUnfreezeEnabled"
@@ -687,6 +697,7 @@ function mapFinanceConfigToFormValues(config?: WorkerFinanceConfig): FinanceConf
depositUnfreezeDays: Number(config?.depositUnfreezeDays ?? 3),
rewardUnfreezeEnabled: config?.rewardUnfreezeEnabled !== false,
consignmentPublishDepositYuan: Number(config?.consignmentPublishDepositFen ?? 2000) / 100,
consignmentWhitelistEnabled: config?.consignmentWhitelistEnabled !== false,
recharge: {
enabled: config?.recharge.enabled !== false,
channelName: config?.recharge.channelName || '',
@@ -174,6 +174,18 @@ function OverviewSection({ workerId }: { workerId: number }) {
<Tag color="green">正常可提现</Tag>
)}
</Descriptions.Item>
<Descriptions.Item label="寄卖权限" span={2}>
<Space>
<Tag color={worker.canConsign ? 'green' : 'default'}>
{worker.canConsign ? '已加入白名单' : '未加入白名单'}
</Tag>
{worker.consignmentActivatedAt ? (
<Typography.Text type="secondary" style={{ fontSize: 12 }}>
开通时间:{formatAdminDateTime(worker.consignmentActivatedAt)}
</Typography.Text>
) : null}
</Space>
</Descriptions.Item>
</Descriptions>
</Card>
<Card size="small" title="钱包">
@@ -11,6 +11,7 @@ import {
Modal,
Select,
Space,
Switch,
Table,
Tag,
Tooltip,
@@ -22,14 +23,17 @@ import { useSearchParams } from 'react-router'
import {
creditAdminWorkerWallet,
fetchAdminWorkerFinanceConfig,
fetchAdminWorkerLevels,
fetchAdminWorkerUsers,
fetchAdminWorkerWithdrawalAccounts,
resetAdminWorkerPassword,
reviewAdminWorkerUser,
saveAdminWorkerFinanceConfig,
saveAdminWorkerPersonalDepositFreeAmount,
saveAdminWorkerWithdrawalAccount,
updateAdminWorkerWithdrawalBlacklist,
updateAdminWorkerConsignmentPermission,
} from '@/services/admin'
import ImageUpload from '@/components/files/ImageUpload'
import type {
@@ -203,6 +207,13 @@ export default function WorkersPanel() {
queryFn: () => fetchAdminWorkerLevels(),
})
const workersPagination = workersQuery.data?.data.pagination
const financeConfigQuery = useQuery({
queryKey: ['admin-worker-platform-finance-config'],
queryFn: () => fetchAdminWorkerFinanceConfig(),
})
const consignmentWhitelistEnabled =
financeConfigQuery.data?.data.consignmentWhitelistEnabled !== false
const [updatingWhitelist, setUpdatingWhitelist] = useState(false)
useEffect(() => {
// 从工单流转记录等入口带 ?workerId= 定位到打手后,自动打开一次详情,关闭后不再重复弹。
@@ -223,6 +234,9 @@ export default function WorkersPanel() {
queryClient.invalidateQueries({
queryKey: ['admin-worker-platform-summary'],
}),
queryClient.invalidateQueries({
queryKey: ['admin-worker-platform-finance-config'],
}),
])
}
@@ -464,6 +478,117 @@ export default function WorkersPanel() {
}
}
const [updatingConsignmentWorkerIds, setUpdatingConsignmentWorkerIds] = useState<Set<number>>(
() => new Set(),
)
function markConsignmentWorkerUpdating(workerId: number, updating: boolean) {
setUpdatingConsignmentWorkerIds((prev) => {
const next = new Set(prev)
if (updating) next.add(workerId)
else next.delete(workerId)
return next
})
}
function applyUpdatedWorker(row: WorkerUser, updatedWorker: WorkerUser) {
queryClient.setQueriesData<{ data: { items: WorkerUser[]; pagination: any } }>(
{ queryKey: ['admin-worker-platform-workers'] },
(old) => {
if (!old?.data?.items) return old
return {
...old,
data: {
...old.data,
items: old.data.items.map((item) =>
item.workerId === row.workerId ? { ...item, ...updatedWorker } : item,
),
},
}
},
)
setDetailWorker((current) =>
current?.workerId === row.workerId ? { ...current, ...updatedWorker } : current,
)
}
async function handleToggleConsignmentPermission(row: WorkerUser, checked: boolean) {
markConsignmentWorkerUpdating(row.workerId, true)
try {
const res = await updateAdminWorkerConsignmentPermission(row.workerId, {
canConsign: checked,
})
const updatedWorker = res.data?.worker
if (updatedWorker) {
applyUpdatedWorker(row, updatedWorker)
}
message.success(
checked
? `已为打手 ${row.displayName || row.username} 加入寄卖白名单`
: `已将打手 ${row.displayName || row.username} 移出寄卖白名单`,
)
await refreshWorkers()
} catch (err: unknown) {
message.error(err instanceof Error ? err.message : '更新寄卖权限失败')
} finally {
markConsignmentWorkerUpdating(row.workerId, false)
}
}
function requestToggleConsignmentPermission(row: WorkerUser, checked: boolean) {
if (checked) {
void handleToggleConsignmentPermission(row, true)
return
}
modal.confirm({
title: '移出寄卖白名单?',
content: `确认关闭打手“${row.displayName || row.username}”的寄卖权限?白名单开启时,该打手将无法发布新寄卖;已在途的寄卖不受影响。`,
okText: '确认关闭',
okButtonProps: { danger: true },
cancelText: '取消',
onOk: () => handleToggleConsignmentPermission(row, false),
})
}
async function handleToggleConsignmentWhitelist(checked: boolean) {
const current = financeConfigQuery.data?.data
if (!current) {
message.error('资金配置尚未加载完成,请稍后重试')
return
}
modal.confirm({
title: checked ? '开启寄卖白名单?' : '关闭寄卖白名单?',
content: checked
? '开启后只有白名单中的打手可以发布寄卖,未开通的打手会被拦截。'
: '关闭后所有打手都可以发布寄卖。打手身上的白名单标记会保留,方便再次开启。',
okText: checked ? '确认开启' : '确认关闭',
okButtonProps: checked ? undefined : { danger: true },
cancelText: '取消',
onOk: async () => {
setUpdatingWhitelist(true)
try {
await saveAdminWorkerFinanceConfig({
depositUnfreezeDays: current.depositUnfreezeDays,
rewardUnfreezeEnabled: current.rewardUnfreezeEnabled,
consignmentPublishDepositFen: current.consignmentPublishDepositFen,
consignmentWhitelistEnabled: checked,
recharge: current.recharge,
adminContact: current.adminContact,
withdraw: current.withdraw,
})
message.success(checked ? '已开启寄卖白名单' : '已关闭寄卖白名单,全部打手可发布')
await queryClient.invalidateQueries({
queryKey: ['admin-worker-platform-finance-config'],
})
} catch (error) {
message.error(error instanceof Error ? error.message : '更新寄卖白名单失败')
} finally {
setUpdatingWhitelist(false)
}
},
})
}
const columns: TableColumnsType<WorkerUser> = [
{
title: '打手',
@@ -554,6 +679,27 @@ export default function WorkersPanel() {
</Space>
),
},
{
title: '寄卖白名单',
width: 130,
render: (_, row) => (
<Tooltip
title={
consignmentWhitelistEnabled
? '白名单开启中:仅已开通的打手可发布寄卖'
: '白名单已关闭:开关暂不限制发布,再次开启后才会生效'
}
>
<Switch
checkedChildren="已开通"
unCheckedChildren="未开通"
checked={row.canConsign}
loading={updatingConsignmentWorkerIds.has(row.workerId)}
onChange={(checked) => requestToggleConsignmentPermission(row, checked)}
/>
</Tooltip>
),
},
{
title: '冻结原因',
width: 220,
@@ -722,7 +868,33 @@ export default function WorkersPanel() {
) : null}
</Card>
<WorkerStatisticsBar statistics={workersQuery.data?.data.statistics} />
<Card title="打手列表" bordered={false}>
<Card
title="打手列表"
bordered={false}
extra={
<Space>
<Typography.Text type="secondary">寄卖白名单</Typography.Text>
<Switch
checkedChildren="仅白名单"
unCheckedChildren="全员可寄卖"
checked={consignmentWhitelistEnabled}
loading={updatingWhitelist || financeConfigQuery.isLoading}
disabled={!financeConfigQuery.data?.data}
onChange={(checked) => void handleToggleConsignmentWhitelist(checked)}
/>
</Space>
}
>
<Alert
showIcon
type={consignmentWhitelistEnabled ? 'warning' : 'info'}
style={{ marginBottom: 12 }}
message={
consignmentWhitelistEnabled
? '寄卖白名单已开启:仅下方开关为「已开通」的打手可发布寄卖。客服无法开通,需运营或管理员操作。'
: '寄卖白名单已关闭:全部打手均可发布寄卖。下方开关仅在重新开启白名单后生效。'
}
/>
<Table<WorkerUser>
rowKey="workerId"
loading={workersQuery.isLoading}
@@ -11,6 +11,7 @@ import {
ReloadOutlined,
SafetyCertificateOutlined,
UserOutlined,
CustomerServiceOutlined,
} from '@ant-design/icons'
import { useQuery, useQueryClient } from '@tanstack/react-query'
import {
@@ -32,10 +33,12 @@ import {
Tabs,
Tag,
Typography,
Spin,
} from 'antd'
import { useEffect, useMemo, useRef, useState } from 'react'
import ImageUpload from '@/components/files/ImageUpload'
import { WorkerContactModal } from '@/components/worker/WorkerContactModal'
import {
confirmWorkerConsignmentFriendAdded,
fetchWorkerConsignmentPriceSuggestion,
@@ -52,6 +55,7 @@ import {
SURNAN_PUBLISH_ZONE_OPTIONS,
} from '@/utils/consignment-spec'
import { formatGiftCooldownRemaining } from '@/utils/consignment-cooldown'
import { canWorkerPublishConsignment } from '@/utils/consignment-whitelist'
import { formatDateTime } from '@/utils/date-time'
import { useIsMobile } from '@/utils/use-is-mobile'
@@ -198,10 +202,12 @@ export default function WorkerConsignmentPage() {
const publishDepositYuan = publishDepositFen / 100
const availableAmount = Number(worker?.wallet?.availableAmount || 0)
const canPublish = availableAmount >= publishDepositFen
const reviewingCount = records.filter((item) => item.group === 'reviewing').length
const activeCount = records.filter((item) => item.group === 'active').length
const finishedCount = records.filter((item) => item.group === 'finished').length
const canConsign = canWorkerPublishConsignment({
profileReady: !profileQuery.isLoading && Boolean(worker),
whitelistEnabled: financeConfig?.consignmentWhitelistEnabled !== false,
workerCanConsign: worker?.canConsign === true,
})
const [contactOpen, setContactOpen] = useState(false)
// 阶段 → 分组由后端下发(item.group),这里只把它映射到筛选角标计数上
const groupCounts = useMemo(() => {
@@ -338,6 +344,11 @@ export default function WorkerConsignmentPage() {
}
async function handlePublishSubmit(values: Record<string, any>) {
if (!canConsign) {
message.warning('您暂未开通寄卖权限,请联系客服申请开通')
return
}
if (!canPublish) {
message.warning(`可用余额不足 ¥${publishDepositYuan.toFixed(0)},请先联系客服充值履约押金`)
return
@@ -507,96 +518,61 @@ export default function WorkerConsignmentPage() {
</div>
</div>
<div className="worker-orders-kpi-grid">
<div className="worker-consignment-kpi-grid">
<div
className={`worker-orders-kpi-card ${recordFilter === 'reviewing' && activeTab === 'records' ? 'active' : ''}`}
className={`worker-consignment-kpi-card ${recordFilter === 'reviewing' && activeTab === 'records' ? 'active' : ''}`}
onClick={() => {
setRecordFilter('reviewing')
setActiveTab('records')
}}
>
<div className="worker-orders-kpi-top">
<div className="worker-orders-kpi-icon-wrap pending">
<ClockCircleOutlined />
</div>
<div className="worker-orders-kpi-info">
<span className="worker-orders-kpi-title">待审核</span>
<strong className="worker-orders-kpi-val">
{reviewingCount}
<span className="worker-orders-kpi-unit"> 单</span>
</strong>
</div>
<div className="worker-consignment-kpi-main">
<span className="worker-consignment-kpi-title">待审核</span>
<span className="worker-consignment-kpi-val">
{groupCounts.reviewing}
<span className="worker-consignment-kpi-unit">单</span>
</span>
</div>
<div className="worker-orders-kpi-bottom">
<span className="worker-orders-kpi-sub-label">客服审核中,通过后自动入库待匹配</span>
<div className="worker-consignment-kpi-icon pending">
<ClockCircleOutlined />
</div>
</div>
<div
className={`worker-orders-kpi-card ${recordFilter === 'active' && activeTab === 'records' ? 'active' : ''}`}
className={`worker-consignment-kpi-card ${recordFilter === 'active' && activeTab === 'records' ? 'active' : ''}`}
onClick={() => {
setRecordFilter('active')
setActiveTab('records')
}}
>
<div className="worker-orders-kpi-top">
<div className="worker-orders-kpi-icon-wrap in-progress">
<InboxOutlined />
</div>
<div className="worker-orders-kpi-info">
<span className="worker-orders-kpi-title">履约中</span>
<strong className="worker-orders-kpi-val">
{activeCount}
<span className="worker-orders-kpi-unit"> 把</span>
</strong>
</div>
<div className="worker-consignment-kpi-main">
<span className="worker-consignment-kpi-title">履约中</span>
<span className="worker-consignment-kpi-val">
{groupCounts.active}
<span className="worker-consignment-kpi-unit">单</span>
</span>
</div>
<div className="worker-orders-kpi-bottom">
<span className="worker-orders-kpi-sub-label">待加好友 / 冷却 / 待赠送 / 待验收</span>
<div className="worker-consignment-kpi-icon in-progress">
<InboxOutlined />
</div>
</div>
<div
className={`worker-orders-kpi-card ${recordFilter === 'finished' && activeTab === 'records' ? 'active' : ''}`}
className={`worker-consignment-kpi-card ${recordFilter === 'finished' && activeTab === 'records' ? 'active' : ''}`}
onClick={() => {
setRecordFilter('finished')
setActiveTab('records')
}}
>
<div className="worker-orders-kpi-top">
<div className="worker-orders-kpi-icon-wrap accepted">
<CheckCircleOutlined />
</div>
<div className="worker-orders-kpi-info">
<span className="worker-orders-kpi-title">已完成</span>
<strong className="worker-orders-kpi-val">
{finishedCount}
<span className="worker-orders-kpi-unit"> 把</span>
</strong>
</div>
<div className="worker-consignment-kpi-main">
<span className="worker-consignment-kpi-title">已完成</span>
<span className="worker-consignment-kpi-val">
{groupCounts.finished}
<span className="worker-consignment-kpi-unit">单</span>
</span>
</div>
<div className="worker-orders-kpi-bottom">
<span className="worker-orders-kpi-sub-label">含已完成、已驳回、已下架作废</span>
</div>
</div>
<div
className={`worker-orders-kpi-card ${activeTab === 'publish' ? 'active' : ''}`}
onClick={() => setActiveTab('publish')}
>
<div className="worker-orders-kpi-top">
<div className="worker-orders-kpi-icon-wrap problem">
<PlusOutlined />
</div>
<div className="worker-orders-kpi-info">
<span className="worker-orders-kpi-title">发布寄卖</span>
<strong className="worker-orders-kpi-val" style={{ fontSize: 18 }}>
苏尔南
</strong>
</div>
</div>
<div className="worker-orders-kpi-bottom">
<span className="worker-orders-kpi-sub-label">暗潮 / 怒嚎 / 血宴 · 押金履约</span>
<div className="worker-consignment-kpi-icon accepted">
<CheckCircleOutlined />
</div>
</div>
</div>
@@ -614,7 +590,37 @@ export default function WorkerConsignmentPage() {
<DollarCircleOutlined /> 发布寄卖
</span>
),
children: (
children: profileQuery.isLoading ? (
<div style={{ padding: '48px 16px', textAlign: 'center' }}>
<Spin />
</div>
) : !canConsign ? (
<div style={{ padding: '36px 16px', textAlign: 'center' }}>
<Empty
image={Empty.PRESENTED_IMAGE_SIMPLE}
description={
<div style={{ maxWidth: 420, margin: '0 auto' }}>
<Typography.Title level={5} style={{ marginBottom: 8 }}>
寄卖功能暂未开通
</Typography.Title>
<Typography.Paragraph
type="secondary"
style={{ fontSize: 13, marginBottom: 20 }}
>
平台当前开启寄卖白名单。请联系客服申请开通,由后台运营开通后即可发布苏尔南寄卖。
</Typography.Paragraph>
<Button
type="primary"
icon={<CustomerServiceOutlined />}
onClick={() => setContactOpen(true)}
>
联系客服开通寄卖
</Button>
</div>
}
/>
</div>
) : (
<Form
form={form}
layout="vertical"
@@ -964,6 +970,16 @@ export default function WorkerConsignmentPage() {
/>
</Space>
</Modal>
<WorkerContactModal
open={contactOpen}
onClose={() => setContactOpen(false)}
isMobile={isMobile}
worker={worker}
financeConfig={financeConfig}
title="联系客服开通寄卖"
alertMessage="请扫码联系客服申请开通寄卖。开通由后台运营处理,通过后即可发布苏尔南。"
/>
</section>
)
}
@@ -3,6 +3,7 @@ import {
ArrowRightOutlined,
CheckCircleOutlined,
ClockCircleOutlined,
CustomerServiceOutlined,
FireOutlined,
PushpinOutlined,
QuestionCircleOutlined,
@@ -35,6 +36,8 @@ import {
import { useEffect, useRef, useState } from 'react'
import { Link } from 'react-router'
import { WorkerContactModal } from '@/components/worker/WorkerContactModal'
import {
fetchWorkerHallCategories,
fetchWorkerHallOrders,
@@ -83,6 +86,7 @@ export default function WorkerHallPage() {
const [grabbingId, setGrabbingId] = useState(0)
const [sharingOrder, setSharingOrder] = useState<WorkOrder | null>(null)
const [leaderboardOpen, setLeaderboardOpen] = useState(false)
const [contactOpen, setContactOpen] = useState(false)
const [leaderboardPeriod, setLeaderboardPeriod] = useState<WorkerLeaderboardPeriod>('all')
const [sharingQuantity, setSharingQuantity] = useState(1)
const [submittingSharing, setSubmittingSharing] = useState(false)
@@ -236,6 +240,7 @@ export default function WorkerHallPage() {
setFailedImageKeys({})
}, [allCategories.length, allIconUrl])
const worker = profileQuery.data?.data.worker
const financeConfig = profileQuery.data?.data.financeConfig
const isInternalWorker = worker?.workerType === 'internal'
const activeCount = Number(profileQuery.data?.data.summary.activeOrderCount || 0)
const pendingAcceptanceCount = hallSummaryQuery.data?.pendingAcceptanceCount || 0
@@ -411,6 +416,16 @@ export default function WorkerHallPage() {
</span>
</div>
<button
type="button"
className="worker-hall-mobile-contact-pill"
onClick={() => setContactOpen(true)}
aria-label="联系客服"
>
<CustomerServiceOutlined className="worker-hall-mobile-contact-icon" />
<span>联系客服</span>
</button>
<div className="worker-hall-mobile-top-actions">
<Tooltip title={`抢单确认已${grabConfirmEnabled ? '开启' : '关闭'}`}>
<Button
@@ -784,6 +799,9 @@ export default function WorkerHallPage() {
<Button icon={<TrophyOutlined />} onClick={() => setLeaderboardOpen(true)}>
接单排行榜
</Button>
<Button icon={<CustomerServiceOutlined />} onClick={() => setContactOpen(true)}>
联系客服
</Button>
</div>
</div>
@@ -1298,6 +1316,14 @@ export default function WorkerHallPage() {
) : null}
</div>
</Drawer>
<WorkerContactModal
open={contactOpen}
onClose={() => setContactOpen(false)}
isMobile={isMobile}
worker={worker}
financeConfig={financeConfig}
/>
</>
)
}
@@ -17,7 +17,8 @@ import type { WorkerFinanceConfig, WorkerSessionDevice, WorkerUser } from '@/typ
import { formatDateTime } from '@/utils/date-time'
import { isWorkerPasswordStrong, WORKER_PASSWORD_RULE_MESSAGE } from '@/utils/worker-password'
import { formatMoney, formatWorkerStatus } from './worker-profile-view-utils'
import { WorkerContactModal } from '@/components/worker/WorkerContactModal'
import { formatWorkerStatus } from './worker-profile-view-utils'
export type PasswordFormValues = {
currentPassword?: string
@@ -184,60 +185,13 @@ export function WorkerProfileAccountModals({
</Form>
</Modal>
<Modal
title="联系管理员"
<WorkerContactModal
open={contactOpen}
width={isMobile ? '92%' : 500}
destroyOnHidden
footer={
<Button type="primary" onClick={() => setContactOpen(false)}>
我知道了
</Button>
}
onCancel={() => setContactOpen(false)}
>
<Space direction="vertical" size={16} className="full-width">
<Alert
showIcon
type="info"
message="如需取消已接订单,请扫码联系管理员处理。充值、提现与审核问题也由后台管理员人工处理。"
/>
{financeConfig?.adminContact?.wechatQrCodeImage ? (
<div style={{ textAlign: 'center' }}>
<Image
width={200}
src={
financeConfig.adminContact.wechatQrCodeImage.mediumUrl ||
financeConfig.adminContact.wechatQrCodeImage.url
}
alt="管理员微信二维码"
/>
</div>
) : (
<Typography.Text type="secondary">
管理员暂未配置微信二维码,请按下方账号信息联系。
</Typography.Text>
)}
<Descriptions column={1} bordered size="small">
<Descriptions.Item label="账号">
<Typography.Text copyable>{worker?.username || '-'}</Typography.Text>
</Descriptions.Item>
<Descriptions.Item label="昵称">{worker?.displayName || '-'}</Descriptions.Item>
<Descriptions.Item label="手机号">
<Typography.Text copyable>{worker?.phone || '-'}</Typography.Text>
</Descriptions.Item>
<Descriptions.Item label="账号状态">
{formatWorkerStatus(worker?.status || '')}
</Descriptions.Item>
<Descriptions.Item label="当前余额">
{formatMoney(worker?.wallet.availableAmount)}
</Descriptions.Item>
</Descriptions>
<Typography.Paragraph className="worker-profile-help-text">
建议沟通时一起提供:申请类型、金额、订单号或转账备注、收款方式,以及当前账号信息。
</Typography.Paragraph>
</Space>
</Modal>
onClose={() => setContactOpen(false)}
isMobile={isMobile}
worker={worker}
financeConfig={financeConfig}
/>
<Modal
title="修改昵称"
@@ -197,6 +197,16 @@ export function updateAdminWorkerWithdrawalBlacklist(
)
}
export function updateAdminWorkerConsignmentPermission(
workerId: number | string,
payload: { canConsign: boolean },
) {
return apiPost<{ worker: WorkerUser }>(
`/api/v1/admin/worker-platform/workers/${workerId}/consignment-permission`,
payload,
)
}
export function fetchAdminWorkerWalletLedgers(
workerId: number | string,
params?: Record<string, unknown>,
@@ -496,6 +506,7 @@ export function saveAdminWorkerFinanceConfig(payload: {
depositUnfreezeDays?: number
rewardUnfreezeEnabled?: boolean
consignmentPublishDepositFen?: number
consignmentWhitelistEnabled?: boolean
recharge?: {
enabled?: boolean
channelName?: string
+180
View File
@@ -2308,6 +2308,62 @@ body {
display: flex;
align-items: center;
gap: 8px;
flex-shrink: 0;
}
.worker-hall-mobile-contact-pill {
background: #fff7ed;
border: 1px solid #fed7aa;
border-radius: 999px;
padding: 4px 10px;
font-size: 12px;
font-weight: 600;
color: #c2410c;
display: inline-flex;
align-items: center;
gap: 4px;
cursor: pointer;
box-shadow: 0 1px 2px rgba(234, 88, 12, 0.08);
white-space: nowrap;
flex-shrink: 0;
transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
outline: none;
}
.worker-hall-mobile-contact-pill:hover,
.worker-hall-mobile-contact-pill:focus-visible {
background: #ffedd5;
border-color: #fdba74;
color: #9a3412;
}
.worker-hall-mobile-contact-pill:active {
transform: scale(0.96);
background: #fed7aa;
}
.worker-hall-mobile-contact-icon {
font-size: 13px;
color: #ea580c;
}
@media (max-width: 360px) {
.worker-hall-mobile-stat-pill {
padding: 4px 8px;
gap: 4px;
font-size: 11px;
}
.worker-hall-mobile-contact-pill {
padding: 4px 8px;
font-size: 11px;
}
}
@media (max-width: 330px) {
.worker-hall-mobile-contact-pill span {
display: none;
}
}
/* 游戏 / 一级分类横向卡片条 */
@@ -4212,6 +4268,130 @@ body {
}
/* ===== 苏尔南寄卖页(对齐订单/售后视觉) ===== */
.worker-consignment-kpi-grid {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: 12px;
margin-bottom: 14px;
}
.worker-consignment-kpi-card {
background: #ffffff;
border: 1px solid #e2e8f0;
border-radius: 10px;
padding: 10px 14px;
display: flex;
align-items: center;
justify-content: space-between;
gap: 8px;
cursor: pointer;
user-select: none;
transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
box-shadow: 0 1px 2px rgba(15, 23, 42, 0.03);
}
.worker-consignment-kpi-card:hover {
border-color: #cbd5e1;
box-shadow: 0 4px 12px rgba(15, 23, 42, 0.06);
transform: translateY(-1px);
}
.worker-consignment-kpi-card.active {
border-color: var(--theme-primary);
background: linear-gradient(180deg, #fffbf7 0%, #ffffff 100%);
box-shadow: 0 2px 8px rgba(255, 106, 0, 0.15);
}
.worker-consignment-kpi-main {
display: flex;
flex-direction: column;
gap: 2px;
min-width: 0;
}
.worker-consignment-kpi-title {
font-size: 12px;
color: #64748b;
font-weight: 500;
line-height: 1.2;
}
.worker-consignment-kpi-val {
font-size: 18px;
font-weight: 700;
color: #0f172a;
line-height: 1.2;
}
.worker-consignment-kpi-unit {
font-size: 12px;
font-weight: normal;
color: #94a3b8;
margin-left: 2px;
}
.worker-consignment-kpi-icon {
width: 34px;
height: 34px;
border-radius: 8px;
display: flex;
align-items: center;
justify-content: center;
font-size: 16px;
flex-shrink: 0;
}
.worker-consignment-kpi-icon.pending {
background: #fdf4ff;
color: #c026d3;
}
.worker-consignment-kpi-icon.in-progress {
background: #eff6ff;
color: #2563eb;
}
.worker-consignment-kpi-icon.accepted {
background: #f0fdf4;
color: #16a34a;
}
@media (max-width: 640px) {
.worker-consignment-kpi-grid {
grid-template-columns: repeat(3, 1fr);
gap: 6px;
margin-bottom: 10px;
}
.worker-consignment-kpi-card {
padding: 8px 4px;
flex-direction: column;
align-items: center;
justify-content: center;
text-align: center;
gap: 2px;
border-radius: 8px;
min-height: 52px;
}
.worker-consignment-kpi-icon {
display: none;
}
.worker-consignment-kpi-title {
font-size: 11px;
color: #64748b;
}
.worker-consignment-kpi-val {
font-size: 16px;
}
.worker-consignment-page .worker-orders-desktop-header {
margin-bottom: 8px;
}
}
.worker-consignment-page .worker-orders-card {
border-radius: 12px;
border: 1px solid #e2e8f0;
@@ -54,6 +54,10 @@ export type WorkerUser = {
lastRenamedAt: string | null
/** 上次改名后的一年锁定期结束时间 */
renameUnlockedAt: string | null
/** 是否开通寄卖权限(白名单开关) */
canConsign: boolean
/** 开通寄卖权限时间 */
consignmentActivatedAt: string | null
}
export type WorkerUserStatistics = {
@@ -261,6 +265,8 @@ export type WorkerFinanceConfig = {
rewardUnfreezeEnabled: boolean
/** 苏尔南寄卖发布履约押金(分),默认 2000 */
consignmentPublishDepositFen?: number
/** 寄卖白名单总开关。开启后仅白名单打手可发布;关闭后所有打手可发布。缺省视为开启。 */
consignmentWhitelistEnabled?: boolean
recharge: {
enabled: boolean
channelName: string
@@ -0,0 +1,12 @@
/**
* 打手端是否允许进入「发布寄卖」表单。
* 资料未就绪时一律不放行,避免白名单模式下先闪出表单。
*/
export function canWorkerPublishConsignment(input: {
profileReady: boolean
whitelistEnabled: boolean
workerCanConsign: boolean
}): boolean {
if (!input.profileReady) return false
return !input.whitelistEnabled || input.workerCanConsign
}
@@ -0,0 +1,45 @@
import assert from 'node:assert/strict'
import test from 'node:test'
import { canWorkerPublishConsignment } from '../src/utils/consignment-whitelist.ts'
test('资料未就绪时不开放发布入口', () => {
assert.equal(
canWorkerPublishConsignment({
profileReady: false,
whitelistEnabled: false,
workerCanConsign: true,
}),
false,
)
})
test('白名单关闭且资料就绪时所有打手可发布', () => {
assert.equal(
canWorkerPublishConsignment({
profileReady: true,
whitelistEnabled: false,
workerCanConsign: false,
}),
true,
)
})
test('白名单开启时必须 workerCanConsign === true', () => {
assert.equal(
canWorkerPublishConsignment({
profileReady: true,
whitelistEnabled: true,
workerCanConsign: false,
}),
false,
)
assert.equal(
canWorkerPublishConsignment({
profileReady: true,
whitelistEnabled: true,
workerCanConsign: true,
}),
true,
)
})
@@ -170,3 +170,103 @@
3. **自动化测试与样式达标**:
- 新增前端单元测试 `apps/frontend/tests/consignment-worker-display.test.ts`,验证普通工单、有供货打手寄售单、无打手纯现货单的解析分支;
- 前端 57 个测试全绿,`format:check`、`lint:check`、`typecheck` 全部通过。
---
## 七、 专项优化:打手端「我要寄卖」顶部臃肿卡片轻量化重构(2026-09-21 已闭环)
### 1. 现象与用户反馈
- **问题现象**:打手在手机端打开“我要寄卖”页面,顶部纵向堆叠了 4 个巨型卡片(`待审核`、`履约中`、`已完成`、`发布寄卖 苏尔南`),占用高达 400px+ 竖向空间,几乎占满整块手机屏幕。打手进页面完全看不到下方的发布表单,必须下滑整屏才能开始填表,操作链路极长且视觉严重失调。
### 2. 代码级根因定位
1. **通用样式在移动端粗暴单列堆叠**:
- `apps/frontend/src/pages/worker/WorkerConsignmentPage.tsx:510` 原先套用了通用 `.worker-orders-kpi-grid`;
- 其在 `@media (max-width: 640px)` 下被定义为 `grid-template-columns: 1fr`,4 个卡片被强制纵向拉成长条大块;
2. **信息噪音多、占位无意义**:
- 每个卡片塞入了诸如“客服审核中,通过后自动入库待匹配”、“待加好友 / 冷却 / 待赠送 / 待验收”、“含已完成、已驳回、已下架作废”等多余的长文本;
- 第 4 个卡片“发布寄卖 苏尔南”纯属凑数占位,点击只是切到下方的发布 Tab,自身毫无数据与功能意义。
### 3. 解决对策与落地成果
1. **彻底移除无意义的第 4 个卡片**:
- 移除“发布寄卖 苏尔南”假 KPI 卡片,将核心关注点精准收敛为【待审核】、【履约中】、【已完成】3 大关键数据。
2. **重构为专属轻量级横向数据栏**:
- 提取并新增 `.worker-consignment-kpi-grid` 与 `.worker-consignment-kpi-card`:
- 移动端采用 `repeat(3, 1fr)` 紧凑横向三等分网格,高度由原来的 320px+ 骤降至约 52px(**竖向空间释放超 80%**);
- 剔除无意义的长句副文案,采用居中微标签布局:上行小字展示状态(11px),下行加粗展示数值(16px);
- 待审核(紫/橙光)、履约中(科技蓝光)、已完成(清新绿光),选中态带优雅的主题高亮指示;
- 桌面端保留图文两列的优雅排布,兼顾大屏美观。
3. **首屏即见核心发布表单**:
- 优化后,打手打开手机首屏顶端即可在不滑动的情况下直接看到“履约押金提示”、“操作系统(苹果/安卓)”与“游戏区服”选择,提报效率大幅提升!
4. **自动化测试与全量构建**:
- 前端 59 个自动化测试全绿(**59 pass / 0 fail**);
- `format:check`、`lint:check`、`typecheck`、`build` 全部通过。
---
## 八、 专项优化:打手抢单大厅首页新增「联系客服」入口与通用客服弹窗组件(2026-09-21 已闭环)
### 1. 现状与用户诉求(User Feedback & Target)
- **用户反馈**:“首页 增加联系客服 现在联系客服藏的太深了”,并附带手机端首页截图,用红圈标注了移动端顶部状态栏(`余额 / 上限` 胶囊右侧、操作按钮区左侧的空白区域)。
- **目标**:
1. 在抢单大厅首页移动端顶部状态栏(红圈标注的核心首屏黄金位置)增加醒目高质感的【联系客服】胶囊按钮;
2. 在桌面端抢单大厅头部操作栏同步补齐【联系客服】入口,打通双端闭环;
3. 将原本深藏在个人中心底层的“联系客服/管理员”弹窗抽象为全站通用的 `WorkerContactModal` 组件,统一维护二维码、账号、余额等信息,提供一键复制与标准沟通提示。
### 2. 证据分类与代码级根因(Evidence & Root Cause)
- **已知信息 [确信度: 100%]**:
1. 官方公告栏循环播放:“☆接单请先个人中心联系客服☆方便客服处理”,证明新打手或接单打手频繁需要找客服沟通充值、提现或报备;
2. 原联系管理员弹窗代码内联在 `apps/frontend/src/pages/worker/WorkerProfileAccountModals.tsx:187-240`,打手必须切换至“个人中心”页面并向下滑动到底部才能找到入口,链路过长、深度太深;
3. `WorkerHallPage.tsx` 中的 `profileQuery.data?.data` 原生就包含了 `worker` 实体与 `financeConfig`(含管理员微信二维码配置 `adminContact.wechatQrCodeImage`),数据已就绪,仅缺前端呈现入口。
- **未知/风险预判 [确信度: 100%]**:
- 移动端 375px 或超窄屏(如 320px)下顶部栏元素横向空间是否会挤压拥挤;
- 应对对策:采用弹性缩放与媒体查询控制,超小屏下保持单行不折叠。
### 3. 解决对策与落地成果(Solution & Milestones)
1. **抽离通用联系客服弹窗组件**:
- 新建 `apps/frontend/src/components/worker/WorkerContactModal.tsx`,集中管理微信二维码大图、当前打手账号、昵称、手机号、账号状态、可用余额,以及一键复制和温馨沟通提示;
- 在 `WorkerProfileAccountModals.tsx` 与 `WorkerHallPage.tsx` 中全面复用该组件,消灭重复代码。
2. **移动端黄金位置新增【联系客服】胶囊按钮**:
- 在 `WorkerHallPage.tsx` 移动端顶部状态条(用户红圈位置)插入专属胶囊:
```html
<button class="worker-hall-mobile-contact-pill" onClick={() => setContactOpen(true)}>
<CustomerServiceOutlined />
<span>联系客服</span>
</button>
```
- 采用浅暖橙背景(`#fff7ed`)+ 优雅橙边框(`#fed7aa`)+ 微动效,与打手端整体暖橙调性浑然一体,点击即弹出客服微信与账号卡片。
3. **桌面端同步补齐入口**:
- 在桌面端头部操作按钮栏(刷新与排行榜旁)新增 `<Button icon={<CustomerServiceOutlined />} onClick={() => setContactOpen(true)}>联系客服</Button>`。
4. **验证门禁全绿通过 [确信度: 100%]**:
- 前端 59 个自动化测试全绿(**59 pass / 0 fail**);
- 前端 `format:check`、`lint:check`、`typecheck`、`build` 均零错误零警告通过;
- 后端 504 个自动化测试全绿(**501 pass / 3 skipped / 0 fail**)。
---
## 九、 专项优化:打手寄卖白名单开关控制与存量平滑过渡(2026-09-21 已闭环)
### 1. 现状与用户诉求(User Feedback & Target)
- **用户反馈**:“寄卖系统 我想增加一个类似白名单 激活模式, 如果有新的注册的人员, 默认无法开启寄卖; 必须联系客服... 方案 A 就够了, 能实现控制 一个开关也行, 然后 存量老打手平滑过渡 发布过的默认开启”。
- **目标**:
1. 实行寄卖白名单准入机制:新注册打手默认不开启寄卖,防止虚假提报与黑产刷单;
2. 存量老打手平滑过渡:历史上在 `consignment_submissions` 中发布过寄卖的打手,在迁移中自动批量赋权开启;
3. 后台提供开关:客服/运营在打手管理表格与详情抽屉中可一键开通/关闭打手寄卖权限;
4. 打手端友好提示与拦截:未开通寄卖权限的打手在「我要寄卖」页面展示专属引导卡片,一键唤起客服弹窗;后端接口进行服务端强拦截(403 `consignment_permission_required`)。
### 2. 证据分类与实现细节(Evidence & Implementation)
- **已知信息 [确信度: 100%]**:
1. `worker_users` 表增加了 `can_consign`(布尔值,默认 `FALSE`)与 `consignment_activated_at`(开通时间戳);
2. 迁移文件 `082_worker_consignment_whitelist.sql` 通过 `IN (SELECT DISTINCT worker_id FROM consignment_submissions WHERE worker_id IS NOT NULL)` 实现存量打手秒级平滑过渡;
3. 打手端提报接口 `publishWorkerConsignment` 增加了 `if (!worker.can_consign) throw ...` 强校验;
4. 前端管理后台 `WorkersPanel.tsx` 增加了「寄卖权限」列,直接嵌入 Switch 开关实时切换;打手详情抽屉 `WorkerDetailDrawer.tsx` 补充了权限和开通时间回显。
### 3. 验证与门禁报告(Quality Gate Status)
- **后端单测与类型检查 [确信度: 100%]**:
- 新增 `admin-worker-consignment-permission.test.ts` 及 `consignment-worker-service.test.ts` 权限拦截测试;
- 后端 507 项单测全绿(**504 pass / 3 skipped / 0 fail**);
- 后端 `typecheck`、`check:sql` 全部通过;
- **前端门禁与生产构建 [确信度: 100%]**:
- 前端 59 项单元测试全绿(**59 pass / 0 fail**);
- 前端 `format:check`、`lint:check`、`typecheck`、`build` 零错误全绿通过。