修复接单平台并发、分页与补资料

This commit is contained in:
yml2213
2026-07-28 10:15:44 +08:00
parent a2587eda01
commit f0ba0fe17f
22 changed files with 1096 additions and 145 deletions
@@ -18,6 +18,8 @@ const DEPLOYMENT_ONLY_ENV_NAMES = [
'CADDY_SITE_ADDR', 'CADDY_SITE_ADDR',
'CHOKIDAR_USEPOLLING', 'CHOKIDAR_USEPOLLING',
'KUASHOU_INDUSTRY_RATE_LIMIT_MAX', 'KUASHOU_INDUSTRY_RATE_LIMIT_MAX',
'MINIO_API_PORT',
'MINIO_CONSOLE_PORT',
'MINIO_ROOT_PASSWORD', 'MINIO_ROOT_PASSWORD',
'MINIO_ROOT_USER', 'MINIO_ROOT_USER',
'NPM_CONFIG_REGISTRY', 'NPM_CONFIG_REGISTRY',
@@ -119,13 +119,13 @@ ALTER TABLE worker_wallet_ledgers
ADD CONSTRAINT fk_worker_wallet_ledgers_work_order ADD CONSTRAINT fk_worker_wallet_ledgers_work_order
FOREIGN KEY (related_work_order_id) REFERENCES work_orders(id) ON DELETE SET NULL; FOREIGN KEY (related_work_order_id) REFERENCES work_orders(id) ON DELETE SET NULL;
COMMENT ON TABLE worker_levels IS '接单员等级与权限配置'; COMMENT ON TABLE worker_levels IS '打手等级与权限配置';
COMMENT ON COLUMN worker_levels.permission_json IS '等级权限:免押额度、最大同时接单量等'; COMMENT ON COLUMN worker_levels.permission_json IS '等级权限:免押额度、最大同时接单量等';
COMMENT ON TABLE worker_users IS '接单员账号,注册后需后台审核'; COMMENT ON TABLE worker_users IS '打手账号,注册后需后台审核';
COMMENT ON TABLE worker_wallets IS '接单员余额与冻结押金汇总'; COMMENT ON TABLE worker_wallets IS '打手余额与冻结押金汇总';
COMMENT ON TABLE worker_wallet_ledgers IS '接单员钱包流水,人工充值、冻结、解冻、结算均记录'; COMMENT ON TABLE worker_wallet_ledgers IS '打手钱包流水,人工充值、冻结、解冻、结算均记录';
COMMENT ON TABLE work_categories IS '接单大厅分类'; COMMENT ON TABLE work_categories IS '接单大厅分类';
COMMENT ON TABLE work_orders IS '接单平台工单,独立于现有履约任务状态机'; COMMENT ON TABLE work_orders IS '接单平台工单,独立于现有履约任务状态机';
COMMENT ON COLUMN work_orders.reward_amount IS '接单员看到并结算的金额,单位分'; COMMENT ON COLUMN work_orders.reward_amount IS '打手看到并结算的金额,单位分';
COMMENT ON COLUMN work_orders.required_deposit_amount IS '单笔工单所需冻结押金,单位分'; COMMENT ON COLUMN work_orders.required_deposit_amount IS '单笔工单所需冻结押金,单位分';
COMMENT ON TABLE work_order_events IS '接单工单状态与操作流水'; COMMENT ON TABLE work_order_events IS '接单工单状态与操作流水';
@@ -63,5 +63,5 @@ COMMENT ON COLUMN file_assets.object_key IS '对象存储 key';
COMMENT ON COLUMN file_assets.thumbnail_object_key IS '缩略图对象 key'; COMMENT ON COLUMN file_assets.thumbnail_object_key IS '缩略图对象 key';
COMMENT ON COLUMN file_assets.medium_object_key IS '中图对象 key'; COMMENT ON COLUMN file_assets.medium_object_key IS '中图对象 key';
COMMENT ON TABLE work_product_rules IS '接单平台物品规则:决定哪些源订单商品生成接单工单'; COMMENT ON TABLE work_product_rules IS '接单平台物品规则:决定哪些源订单商品生成接单工单';
COMMENT ON COLUMN work_product_rules.reward_amount IS '后台发布给接单员的单笔金额,单位分'; COMMENT ON COLUMN work_product_rules.reward_amount IS '后台发布给打手的单笔金额,单位分';
COMMENT ON COLUMN work_product_rules.auto_create IS '源订单入库后是否自动创建接单工单'; COMMENT ON COLUMN work_product_rules.auto_create IS '源订单入库后是否自动创建接单工单';
@@ -0,0 +1,27 @@
import assert from 'node:assert/strict'
import test from 'node:test'
import { resolveOutstandingDepositAmount } from './worker-platform-repo.js'
test('resolveOutstandingDepositAmount deducts released and deducted history', () => {
assert.equal(
resolveOutstandingDepositAmount({
frozen_amount: 20_000,
released_amount: 5_000,
deducted_amount: 3_000,
}),
12_000,
)
})
test('resolveOutstandingDepositAmount never returns a negative deposit', () => {
assert.equal(
resolveOutstandingDepositAmount({
frozen_amount: 10_000,
released_amount: 12_000,
deducted_amount: 1_000,
}),
0,
)
assert.equal(resolveOutstandingDepositAmount(null), 0)
})
@@ -104,6 +104,22 @@ export type WorkOrderRow = {
worker_display_name?: string worker_display_name?: string
} }
export type ProblemWorkOrderResolutionAction =
| 'return_to_worker'
| 'reopen'
| 'cancel_release'
| 'cancel_deduct'
export type GrabWorkOrderFailureReason =
| 'worker_active_order_limit'
| 'worker_deposit_insufficient'
| 'work_order_not_open'
export type GrabWorkOrderResult = {
order: WorkOrderRow | null
failureReason: GrabWorkOrderFailureReason | null
}
type ListInput = { type ListInput = {
page?: number page?: number
pageSize?: number pageSize?: number
@@ -317,6 +333,25 @@ export async function updateWorkerUser(
return getWorkerUserById(workerId) return getWorkerUserById(workerId)
} }
export async function incrementWorkerSessionVersion(
workerId: number | string,
now: string,
): Promise<WorkerUserRow | null> {
const result = await query<{ id: number }>(
`
UPDATE worker_users
SET session_version = session_version + 1, updated_at = $2
WHERE id = $1
RETURNING id
`,
[Number(workerId), now],
)
if (!result.rows[0]) {
return null
}
return getWorkerUserById(workerId)
}
export async function listWorkerUsers({ export async function listWorkerUsers({
page = 1, page = 1,
pageSize = 20, pageSize = 20,
@@ -604,6 +639,18 @@ export async function findPendingMaterialWorkOrderByPlatformOrderId(
return result.rows[0] || null return result.rows[0] || null
} }
export async function listPendingMaterialWorkOrdersByPlatformOrderId(
platformOrderId: string,
): Promise<WorkOrderRow[]> {
const result = await query<WorkOrderRow>(
`${WORK_ORDER_SELECT}
WHERE wo.platform_order_id = $1 AND wo.status = 'pending_material'
ORDER BY wo.id ASC`,
[String(platformOrderId || '').trim()],
)
return result.rows
}
export async function listWorkOrders({ export async function listWorkOrders({
page = 1, page = 1,
pageSize = 20, pageSize = 20,
@@ -690,14 +737,26 @@ export async function grabWorkOrder(input: {
workOrderId: number workOrderId: number
workerId: number workerId: number
depositAmount: number depositAmount: number
maxActiveOrders: number
now: string now: string
}): Promise<WorkOrderRow | null> { }): Promise<GrabWorkOrderResult> {
return withTransaction(async (client) => { return withTransaction(async (client) => {
await ensureWorkerWalletWithClient(client, input.workerId, input.now) await ensureWorkerWalletWithClient(client, input.workerId, input.now)
const wallet = await getWorkerWalletWithClient(client, input.workerId) const wallet = await getWorkerWalletWithClient(client, input.workerId)
const activeOrderCount = await countWorkerActiveOrdersWithClient(client, input.workerId)
if (activeOrderCount >= input.maxActiveOrders) {
return {
order: null,
failureReason: 'worker_active_order_limit',
}
}
const available = Number(wallet?.available_amount || 0) const available = Number(wallet?.available_amount || 0)
if (available < input.depositAmount) { if (available < input.depositAmount) {
return null return {
order: null,
failureReason: 'worker_deposit_insufficient',
}
} }
const result = await client.query<{ id: number }>( const result = await client.query<{ id: number }>(
@@ -716,7 +775,10 @@ export async function grabWorkOrder(input: {
[input.workerId, input.now, input.workOrderId], [input.workerId, input.now, input.workOrderId],
) )
if (!result.rows[0]) { if (!result.rows[0]) {
return null return {
order: null,
failureReason: 'work_order_not_open',
}
} }
if (input.depositAmount > 0) { if (input.depositAmount > 0) {
@@ -759,7 +821,10 @@ export async function grabWorkOrder(input: {
now: input.now, now: input.now,
}) })
return getWorkOrderByIdWithClient(client, input.workOrderId) return {
order: await getWorkOrderByIdWithClient(client, input.workOrderId),
failureReason: null,
}
}) })
} }
@@ -796,18 +861,8 @@ export async function acceptWorkOrderAndSettle(input: {
if (workerId > 0) { if (workerId > 0) {
await ensureWorkerWalletWithClient(client, workerId, input.now) await ensureWorkerWalletWithClient(client, workerId, input.now)
const wallet = await getWorkerWalletWithClient(client, workerId) const wallet = await getWorkerWalletWithClient(client, workerId)
const frozenLedgerResult = await client.query<{ amount: number }>(
`
SELECT COALESCE(ABS(SUM(amount)), 0)::int AS amount
FROM worker_wallet_ledgers
WHERE worker_id = $1
AND related_work_order_id = $2
AND ledger_type = 'deposit_freeze'
`,
[workerId, input.workOrderId],
)
const releaseAmount = Math.min( const releaseAmount = Math.min(
Number(frozenLedgerResult.rows[0]?.amount || 0), await getOutstandingDepositAmountWithClient(client, workerId, input.workOrderId),
Number(wallet?.frozen_deposit_amount || 0), Number(wallet?.frozen_deposit_amount || 0),
) )
const rewardAmount = Number(workOrder.reward_amount || 0) const rewardAmount = Number(workOrder.reward_amount || 0)
@@ -867,6 +922,124 @@ export async function acceptWorkOrderAndSettle(input: {
}) })
} }
export async function resolveProblemWorkOrder(input: {
workOrderId: number
action: ProblemWorkOrderResolutionAction
note: string
now: string
}): Promise<WorkOrderRow | null> {
return withTransaction(async (client) => {
const currentResult = await client.query<WorkOrderRow>(
`
SELECT *
FROM work_orders
WHERE id = $1
AND status = 'problem'
FOR UPDATE
`,
[input.workOrderId],
)
const workOrder = currentResult.rows[0] || null
if (!workOrder) return null
const shouldReleaseDeposit = ['reopen', 'cancel_release'].includes(input.action)
const shouldDeductDeposit = input.action === 'cancel_deduct'
const workerId = Number(workOrder.assigned_worker_id || 0)
let resolvedDepositAmount = 0
if (workerId > 0 && (shouldReleaseDeposit || shouldDeductDeposit)) {
await ensureWorkerWalletWithClient(client, workerId, input.now)
const wallet = await getWorkerWalletWithClient(client, workerId)
resolvedDepositAmount = Math.min(
await getOutstandingDepositAmountWithClient(client, workerId, input.workOrderId),
Number(wallet?.frozen_deposit_amount || 0),
)
if (resolvedDepositAmount > 0) {
const nextAvailable =
Number(wallet?.available_amount || 0) + (shouldReleaseDeposit ? resolvedDepositAmount : 0)
const nextFrozen = Math.max(
0,
Number(wallet?.frozen_deposit_amount || 0) - resolvedDepositAmount,
)
const ledgerType = shouldReleaseDeposit ? 'deposit_release' : 'deposit_deduction'
const ledgerAmount = shouldReleaseDeposit ? resolvedDepositAmount : -resolvedDepositAmount
const ledgerNote = shouldReleaseDeposit ? '问题单处置释放押金' : '问题单处置扣除押金'
await client.query(
`
UPDATE worker_wallets
SET available_amount = $1, frozen_deposit_amount = $2, updated_at = $3
WHERE worker_id = $4
`,
[nextAvailable, nextFrozen, input.now, workerId],
)
await client.query(
`
INSERT INTO worker_wallet_ledgers (
worker_id, ledger_type, amount, balance_after, frozen_after,
related_work_order_id, note, payload_json, created_at
) VALUES ($1, $2, $3, $4, $5, $6, $7, $8::jsonb, $9)
`,
[
workerId,
ledgerType,
ledgerAmount,
nextAvailable,
nextFrozen,
input.workOrderId,
ledgerNote,
JSON.stringify({ action: input.action, note: input.note }),
input.now,
],
)
}
}
const targetStatus =
input.action === 'return_to_worker'
? 'in_progress'
: input.action === 'reopen'
? 'open'
: 'cancelled'
const shouldClearAssignment = input.action === 'reopen'
const shouldClearSubmission = ['return_to_worker', 'reopen'].includes(input.action)
await client.query(
`
UPDATE work_orders
SET
status = $1,
assigned_worker_id = CASE WHEN $2 THEN NULL ELSE assigned_worker_id END,
assigned_at = CASE WHEN $2 THEN NULL ELSE assigned_at END,
acceptance_json = CASE WHEN $3 THEN '{}'::jsonb ELSE acceptance_json END,
submitted_at = CASE WHEN $3 THEN NULL ELSE submitted_at END,
problem_note = CASE WHEN $2 THEN '' ELSE problem_note END,
updated_at = $4
WHERE id = $5
`,
[targetStatus, shouldClearAssignment, shouldClearSubmission, input.now, input.workOrderId],
)
await createWorkOrderEventWithClient(client, {
workOrderId: input.workOrderId,
actorType: 'admin',
actorId: '',
eventType: `problem_${input.action}`,
fromStatus: 'problem',
toStatus: targetStatus,
payloadJson: JSON.stringify({
action: input.action,
note: input.note,
depositAmount: resolvedDepositAmount,
}),
now: input.now,
})
return getWorkOrderByIdWithClient(client, input.workOrderId)
})
}
export async function countWorkerActiveOrders(workerId: number | string): Promise<number> { export async function countWorkerActiveOrders(workerId: number | string): Promise<number> {
const result = await query<{ total: number }>( const result = await query<{ total: number }>(
` `
@@ -955,12 +1128,67 @@ async function getWorkerWalletWithClient(
workerId: number, workerId: number,
): Promise<WorkerWalletRow | null> { ): Promise<WorkerWalletRow | null> {
const result = await client.query<WorkerWalletRow>( const result = await client.query<WorkerWalletRow>(
'SELECT * FROM worker_wallets WHERE worker_id = $1 LIMIT 1', 'SELECT * FROM worker_wallets WHERE worker_id = $1 LIMIT 1 FOR UPDATE',
[workerId], [workerId],
) )
return result.rows[0] || null return result.rows[0] || null
} }
async function getOutstandingDepositAmountWithClient(
client: PoolClient,
workerId: number,
workOrderId: number,
) {
const result = await client.query<{
frozen_amount: number
released_amount: number
deducted_amount: number
}>(
`
SELECT
COALESCE(SUM(CASE WHEN ledger_type = 'deposit_freeze' THEN ABS(amount) ELSE 0 END), 0)::int AS frozen_amount,
COALESCE(SUM(CASE WHEN ledger_type = 'deposit_release' THEN ABS(amount) ELSE 0 END), 0)::int AS released_amount,
COALESCE(SUM(CASE WHEN ledger_type = 'deposit_deduction' THEN ABS(amount) ELSE 0 END), 0)::int AS deducted_amount
FROM worker_wallet_ledgers
WHERE worker_id = $1
AND related_work_order_id = $2
`,
[workerId, workOrderId],
)
return resolveOutstandingDepositAmount(result.rows[0])
}
async function countWorkerActiveOrdersWithClient(client: PoolClient, workerId: number): Promise<number> {
const result = await client.query<{ total: number }>(
`
SELECT COUNT(*)::int AS total
FROM work_orders
WHERE assigned_worker_id = $1
AND status IN ('in_progress', 'pending_acceptance', 'problem')
`,
[workerId],
)
return Number(result.rows[0]?.total || 0)
}
export function resolveOutstandingDepositAmount(
totals:
| {
frozen_amount?: number
released_amount?: number
deducted_amount?: number
}
| null
| undefined,
) {
return Math.max(
0,
Number(totals?.frozen_amount || 0) -
Number(totals?.released_amount || 0) -
Number(totals?.deducted_amount || 0),
)
}
async function getWorkerUserByIdWithClient( async function getWorkerUserByIdWithClient(
client: PoolClient, client: PoolClient,
workerId: number | string, workerId: number | string,
@@ -12,6 +12,7 @@ import {
listAdminWorkOrders, listAdminWorkOrders,
markAdminWorkOrderProblem, markAdminWorkOrderProblem,
publishAdminWorkOrder, publishAdminWorkOrder,
resolveAdminProblemWorkOrder,
reviewAdminWorkerUser, reviewAdminWorkerUser,
saveAdminWorkCategory, saveAdminWorkCategory,
saveAdminWorkProductRule, saveAdminWorkProductRule,
@@ -117,7 +118,7 @@ router.get(
requireAdminRoles(['admin', 'operator', 'support']), requireAdminRoles(['admin', 'operator', 'support']),
createJsonHandler((req) => listAdminWorkerUsers(req.query), { createJsonHandler((req) => listAdminWorkerUsers(req.query), {
successMessage: 'ok', successMessage: 'ok',
errorMessage: '读取接单员列表失败', errorMessage: '读取打手列表失败',
scope: '[admin/worker-platform/workers]', scope: '[admin/worker-platform/workers]',
}), }),
) )
@@ -128,8 +129,8 @@ router.post(
createJsonHandler( createJsonHandler(
(req) => reviewAdminWorkerUser(String(req.params.workerId || ''), req.body || {}), (req) => reviewAdminWorkerUser(String(req.params.workerId || ''), req.body || {}),
{ {
successMessage: '接单员审核状态已更新', successMessage: '打手审核状态已更新',
errorMessage: '审核接单员失败', errorMessage: '审核打手失败',
scope: '[admin/worker-platform/workers/:workerId/review]', scope: '[admin/worker-platform/workers/:workerId/review]',
audit: (req, data) => ({ audit: (req, data) => ({
action: 'worker_reviewed', action: 'worker_reviewed',
@@ -147,7 +148,7 @@ router.post(
createJsonHandler( createJsonHandler(
(req) => creditAdminWorkerWallet(String(req.params.workerId || ''), req.body || {}), (req) => creditAdminWorkerWallet(String(req.params.workerId || ''), req.body || {}),
{ {
successMessage: '接单员余额已增加', successMessage: '打手余额已增加',
errorMessage: '人工充值失败', errorMessage: '人工充值失败',
scope: '[admin/worker-platform/workers/:workerId/wallet-credit]', scope: '[admin/worker-platform/workers/:workerId/wallet-credit]',
audit: (req, data) => ({ audit: (req, data) => ({
@@ -256,6 +257,25 @@ router.post(
), ),
) )
router.post(
'/worker-platform/orders/:workOrderId/problem/resolve',
requireAdminRoles(['admin', 'operator']),
createJsonHandler(
(req) => resolveAdminProblemWorkOrder(String(req.params.workOrderId || ''), req.body || {}),
{
successMessage: '问题单已处置',
errorMessage: '处置问题单失败',
scope: '[admin/worker-platform/orders/:workOrderId/problem/resolve]',
audit: (req, data) => ({
action: 'work_order_problem_resolved',
targetType: 'work_order',
targetId: String(req.params.workOrderId || ''),
data: data && typeof data === 'object' ? (data as Record<string, unknown>) : {},
}),
},
),
)
router.post( router.post(
'/worker-platform/orders/:workOrderId/accept', '/worker-platform/orders/:workOrderId/accept',
requireAdminRoles(['admin', 'operator']), requireAdminRoles(['admin', 'operator']),
+4 -1
View File
@@ -7,7 +7,10 @@ const router = Router()
router.get('/object', async (req, res) => { router.get('/object', async (req, res) => {
try { try {
const object = await getStoredFileObject(req.query.key, req.query.variant) const object = await getStoredFileObject(req.query.key, req.query.variant, {
expires: req.query.expires,
signature: req.query.signature,
})
res.setHeader('Content-Type', object.contentType || 'application/octet-stream') res.setHeader('Content-Type', object.contentType || 'application/octet-stream')
res.setHeader('Cache-Control', 'private, max-age=300') res.setHeader('Cache-Control', 'private, max-age=300')
res.setHeader('X-Content-Type-Options', 'nosniff') res.setHeader('X-Content-Type-Options', 'nosniff')
+4 -2
View File
@@ -10,11 +10,13 @@ import {
listWorkerHallOrders, listWorkerHallOrders,
listWorkerMyOrders, listWorkerMyOrders,
loginWorker, loginWorker,
logoutWorkerSession,
registerWorker, registerWorker,
submitWorkerOrderAcceptance, submitWorkerOrderAcceptance,
} from '../services/worker-platform/worker-platform-service.js' } from '../services/worker-platform/worker-platform-service.js'
import { buildNotFoundPayload, createRouteHandler } from '../utils/http.js' import { buildNotFoundPayload, createRouteHandler } from '../utils/http.js'
import { import {
extractOptionalWorkerBearerToken,
extractWorkerBearerToken, extractWorkerBearerToken,
getRequiredWorkerSession, getRequiredWorkerSession,
requireActiveWorker, requireActiveWorker,
@@ -64,7 +66,7 @@ router.get(
router.post( router.post(
'/auth/logout', '/auth/logout',
createRouteHandler(() => ({ success: true }), { createRouteHandler((req) => logoutWorkerSession(extractOptionalWorkerBearerToken(req)), {
successMessage: '已退出登录', successMessage: '已退出登录',
errorMessage: '退出失败', errorMessage: '退出失败',
scope: '[worker/auth/logout]', scope: '[worker/auth/logout]',
@@ -77,7 +79,7 @@ router.get(
'/profile', '/profile',
createRouteHandler((req) => getWorkerProfile(getRequiredWorkerSession(req)), { createRouteHandler((req) => getWorkerProfile(getRequiredWorkerSession(req)), {
successMessage: 'ok', successMessage: 'ok',
errorMessage: '读取接单员信息失败', errorMessage: '读取打手信息失败',
scope: '[worker/profile]', scope: '[worker/profile]',
}), }),
) )
+10 -5
View File
@@ -37,14 +37,19 @@ export function getRequiredWorkerSession(req: Request): WorkerSession {
} }
export function extractWorkerBearerToken(req: Request): string { export function extractWorkerBearerToken(req: Request): string {
const authorization = String(req.headers.authorization || '').trim() const token = extractOptionalWorkerBearerToken(req)
const matched = authorization.match(/^Bearer\s+(.+)$/i) if (token) {
if (!matched?.[1]) { return token
}
throw createHttpError('未登录或登录已失效', { throw createHttpError('未登录或登录已失效', {
statusCode: 401, statusCode: 401,
errorCode: 'worker_auth_required', errorCode: 'worker_auth_required',
}) })
} }
return matched[1].trim() export function extractOptionalWorkerBearerToken(req: Request): string {
const authorization = String(req.headers.authorization || '').trim()
const matched = authorization.match(/^Bearer\s+(.+)$/i)
return matched?.[1]?.trim() || ''
} }
@@ -0,0 +1,52 @@
import assert from 'node:assert/strict'
import test from 'node:test'
import {
buildFileUrl,
normalizeStoredFileUrl,
refreshStoredFileUrl,
verifyFileAccessSignature,
} from './file-storage-service.js'
const NOW_SECONDS = 1_800_000_000
const OBJECT_KEY = 'worker-acceptance/2026/07/26/example.jpg'
test('file access URL carries a valid short-lived signature', () => {
const url = buildFileUrl(OBJECT_KEY, NOW_SECONDS)
const parsed = new URL(url, 'http://localhost')
assert.equal(parsed.searchParams.get('key'), OBJECT_KEY)
assert.doesNotThrow(() =>
verifyFileAccessSignature(
OBJECT_KEY,
parsed.searchParams.get('expires'),
parsed.searchParams.get('signature'),
NOW_SECONDS + 899,
),
)
})
test('file access URL rejects expired and tampered signatures', () => {
const parsed = new URL(buildFileUrl(OBJECT_KEY, NOW_SECONDS), 'http://localhost')
const expires = parsed.searchParams.get('expires')
const signature = parsed.searchParams.get('signature')
assert.throws(() => verifyFileAccessSignature(OBJECT_KEY, expires, signature, NOW_SECONDS + 901))
assert.throws(() =>
verifyFileAccessSignature(`${OBJECT_KEY}.changed`, expires, signature, NOW_SECONDS),
)
})
test('stored file URL drops signatures and refreshes them for responses', () => {
const signedUrl = buildFileUrl(OBJECT_KEY, NOW_SECONDS)
const storedUrl = normalizeStoredFileUrl(signedUrl)
const refreshedUrl = refreshStoredFileUrl(storedUrl)
assert.equal(storedUrl, `/api/v1/files/object?key=${encodeURIComponent(OBJECT_KEY)}`)
assert.match(refreshedUrl, /[?&]expires=\d+/)
assert.match(refreshedUrl, /[?&]signature=/)
assert.equal(
refreshStoredFileUrl('https://example.com/image.jpg'),
'https://example.com/image.jpg',
)
})
@@ -13,6 +13,7 @@ const IMAGE_VARIANT_THUMB = 'thumb'
const IMAGE_VARIANT_MEDIUM = 'medium' const IMAGE_VARIANT_MEDIUM = 'medium'
const THUMB_MAX_SIDE = 480 const THUMB_MAX_SIDE = 480
const MEDIUM_MAX_SIDE = 1280 const MEDIUM_MAX_SIDE = 1280
const FILE_URL_TTL_SECONDS = 15 * 60
const ALLOWED_CONTENT_TYPES = new Set(['image/jpeg', 'image/png', 'image/webp', 'application/pdf']) const ALLOWED_CONTENT_TYPES = new Set(['image/jpeg', 'image/png', 'image/webp', 'application/pdf'])
@@ -98,9 +99,9 @@ export async function uploadFileAsset(input: UploadFileAssetInput) {
} }
const now = nowIso() const now = nowIso()
const fileUrl = buildFileUrl(objectKey) const fileUrl = buildUnsignedFileUrl(objectKey)
const thumbnailUrl = thumbnailObjectKey ? buildFileUrl(thumbnailObjectKey) : fileUrl const thumbnailUrl = thumbnailObjectKey ? buildUnsignedFileUrl(thumbnailObjectKey) : fileUrl
const mediumUrl = mediumObjectKey ? buildFileUrl(mediumObjectKey) : fileUrl const mediumUrl = mediumObjectKey ? buildUnsignedFileUrl(mediumObjectKey) : fileUrl
const asset = await createFileAsset({ const asset = await createFileAsset({
objectKey, objectKey,
scene, scene,
@@ -134,8 +135,13 @@ export async function uploadFileAsset(input: UploadFileAssetInput) {
} }
} }
export async function getStoredFileObject(key: unknown, variant: unknown = '') { export async function getStoredFileObject(
key: unknown,
variant: unknown = '',
access: { expires?: unknown; signature?: unknown } = {},
) {
const objectKey = normalizeObjectKey(key) const objectKey = normalizeObjectKey(key)
verifyFileAccessSignature(objectKey, access.expires, access.signature)
const variantName = normalizeVariant(variant) const variantName = normalizeVariant(variant)
const candidates = variantName ? imageVariantFallbackKeys(objectKey, variantName) : [objectKey] const candidates = variantName ? imageVariantFallbackKeys(objectKey, variantName) : [objectKey]
let lastError: unknown = null let lastError: unknown = null
@@ -159,8 +165,67 @@ export function getMaxUploadSizeBytes() {
return Math.max(1, Number(runtimeConfig.storage.maxUploadSizeMb || 10)) * 1024 * 1024 return Math.max(1, Number(runtimeConfig.storage.maxUploadSizeMb || 10)) * 1024 * 1024
} }
export function buildFileUrl(objectKey: string) { export function buildFileUrl(objectKey: string, nowSeconds = Math.floor(Date.now() / 1000)) {
return `/api/v1/files/object?key=${encodeURIComponent(objectKey)}` const normalizedKey = normalizeObjectKey(objectKey)
const expires = nowSeconds + FILE_URL_TTL_SECONDS
const signature = createFileAccessSignature(normalizedKey, expires)
return `${buildUnsignedFileUrl(normalizedKey)}&expires=${expires}&signature=${encodeURIComponent(signature)}`
}
export function refreshStoredFileUrl(value: unknown, fallbackObjectKey = '') {
const rawUrl = String(value || '').trim()
const objectKey = extractObjectKeyFromFileUrl(rawUrl) || String(fallbackObjectKey || '').trim()
return objectKey ? buildFileUrl(objectKey) : rawUrl
}
export function normalizeStoredFileUrl(value: unknown, fallbackObjectKey = '') {
const rawUrl = String(value || '').trim()
const objectKey = extractObjectKeyFromFileUrl(rawUrl) || String(fallbackObjectKey || '').trim()
return objectKey ? buildUnsignedFileUrl(objectKey) : rawUrl
}
export function refreshUploadedFileUrls(value: unknown) {
const source =
value && typeof value === 'object' && !Array.isArray(value)
? (value as Record<string, unknown>)
: {}
const objectKey = String(source.objectKey || source.object_key || '').trim()
if (!objectKey) return source
return {
...source,
objectKey,
url: buildFileUrl(objectKey),
thumbnailUrl: refreshStoredFileUrl(source.thumbnailUrl || source.thumbnail_url, objectKey),
mediumUrl: refreshStoredFileUrl(source.mediumUrl || source.medium_url, objectKey),
}
}
export function verifyFileAccessSignature(
objectKey: string,
expiresValue: unknown,
signatureValue: unknown,
nowSeconds = Math.floor(Date.now() / 1000),
) {
const expires = Number(expiresValue || 0)
const signature = String(signatureValue || '').trim()
if (!Number.isSafeInteger(expires) || expires < nowSeconds || !signature) {
throw createHttpError('文件访问链接无效或已过期', {
statusCode: 403,
errorCode: 'file_access_expired',
})
}
const expected = createFileAccessSignature(normalizeObjectKey(objectKey), expires)
const expectedBuffer = Buffer.from(expected)
const actualBuffer = Buffer.from(signature)
if (
expectedBuffer.length !== actualBuffer.length ||
!crypto.timingSafeEqual(expectedBuffer, actualBuffer)
) {
throw createHttpError('文件访问签名不正确', {
statusCode: 403,
errorCode: 'file_access_signature_invalid',
})
}
} }
export function imageVariantKey(objectKey: string, variant: string) { export function imageVariantKey(objectKey: string, variant: string) {
@@ -183,15 +248,45 @@ function mapUploadedFile(
): UploadedFileDto { ): UploadedFileDto {
return { return {
objectKey: asset?.object_key || fallback.objectKey, objectKey: asset?.object_key || fallback.objectKey,
url: asset?.url || fallback.fileUrl, url: buildFileUrl(asset?.object_key || fallback.objectKey),
thumbnailUrl: asset?.thumbnail_url || fallback.thumbnailUrl, thumbnailUrl: buildFileUrl(
mediumUrl: asset?.medium_url || fallback.mediumUrl, asset?.thumbnail_object_key ||
extractObjectKeyFromFileUrl(fallback.thumbnailUrl) ||
fallback.objectKey,
),
mediumUrl: buildFileUrl(
asset?.medium_object_key ||
extractObjectKeyFromFileUrl(fallback.mediumUrl) ||
fallback.objectKey,
),
filename: asset?.original_filename || fallback.filename, filename: asset?.original_filename || fallback.filename,
contentType: asset?.content_type || fallback.contentType, contentType: asset?.content_type || fallback.contentType,
size: Number(asset?.size_bytes || fallback.size || 0), size: Number(asset?.size_bytes || fallback.size || 0),
} }
} }
function buildUnsignedFileUrl(objectKey: string) {
return `/api/v1/files/object?key=${encodeURIComponent(normalizeObjectKey(objectKey))}`
}
function createFileAccessSignature(objectKey: string, expires: number) {
const secret =
String(runtimeConfig.admin.sessionSecret || '').trim() ||
String(runtimeConfig.storage.secretAccessKey || '').trim()
return crypto.createHmac('sha256', secret).update(`${objectKey}\n${expires}`).digest('base64url')
}
function extractObjectKeyFromFileUrl(value: string) {
if (!value) return ''
try {
const parsed = new URL(value, 'http://localhost')
if (parsed.pathname !== '/api/v1/files/object') return ''
return normalizeObjectKey(parsed.searchParams.get('key'))
} catch {
return ''
}
}
function normalizeContentType(mimeType: unknown, data: Buffer) { function normalizeContentType(mimeType: unknown, data: Buffer) {
const detected = detectContentType(data) const detected = detectContentType(data)
if (detected) { if (detected) {
@@ -0,0 +1,85 @@
import assert from 'node:assert/strict'
import test from 'node:test'
import type { WorkOrderRow } from '../../repositories/worker-platform-repo.js'
import { resolveCollectSubmitTargetWorkOrder } from './worker-platform-service.js'
function buildWorkOrderRow(
overrides: Partial<WorkOrderRow> = {},
): WorkOrderRow {
return {
id: 1,
work_order_no: 'WO0001',
order_id: 101,
order_item_id: 201,
task_id: null,
platform_order_id: 'ORDER-001',
product_name: '测试商品',
category_id: null,
status: 'pending_material',
reward_amount: 2500,
required_deposit_amount: 0,
deposit_threshold_amount: 20000,
assigned_worker_id: null,
material_json: '{}',
requirement_json: '{"fields":[]}',
acceptance_json: '{}',
problem_note: '',
published_at: null,
assigned_at: null,
submitted_at: null,
accepted_at: null,
created_at: '2026-07-28T00:00:00.000Z',
updated_at: '2026-07-28T00:00:00.000Z',
...overrides,
}
}
test('resolveCollectSubmitTargetWorkOrder returns the only pending work order when no id is provided', () => {
const workOrder = buildWorkOrderRow()
const selected = resolveCollectSubmitTargetWorkOrder('ORDER-001', [workOrder], '')
assert.equal(selected.id, workOrder.id)
})
test('resolveCollectSubmitTargetWorkOrder requires explicit work order id when multiple orders are pending', () => {
const workOrders = [
buildWorkOrderRow({ id: 1, work_order_no: 'WO0001' }),
buildWorkOrderRow({ id: 2, work_order_no: 'WO0002', order_item_id: 202 }),
]
assert.throws(
() => resolveCollectSubmitTargetWorkOrder('ORDER-001', workOrders, ''),
(error: unknown) =>
Boolean(
error &&
typeof error === 'object' &&
(error as { statusCode?: number }).statusCode === 409 &&
(error as { errorCode?: string }).errorCode === 'collect_work_order_required',
),
)
})
test('resolveCollectSubmitTargetWorkOrder returns the matching work order when workOrderId is provided', () => {
const workOrders = [
buildWorkOrderRow({ id: 1, work_order_no: 'WO0001' }),
buildWorkOrderRow({ id: 2, work_order_no: 'WO0002', order_item_id: 202 }),
]
const selected = resolveCollectSubmitTargetWorkOrder('ORDER-001', workOrders, '2')
assert.equal(selected.id, 2)
})
test('resolveCollectSubmitTargetWorkOrder rejects unknown workOrderId', () => {
const workOrders = [buildWorkOrderRow({ id: 1, work_order_no: 'WO0001' })]
assert.throws(
() => resolveCollectSubmitTargetWorkOrder('ORDER-001', workOrders, 999),
(error: unknown) =>
Boolean(
error &&
typeof error === 'object' &&
(error as { statusCode?: number }).statusCode === 404 &&
(error as { errorCode?: string }).errorCode === 'collect_work_order_not_found',
),
)
})
@@ -11,21 +11,19 @@ import {
createWorkOrder, createWorkOrder,
createWorkOrderEvent, createWorkOrderEvent,
createWorkerUser, createWorkerUser,
findPendingMaterialWorkOrderByPlatformOrderId, incrementWorkerSessionVersion,
getWorkCategoryByKey,
getWorkOrderById, getWorkOrderById,
getWorkOrderByOrderItemId, getWorkOrderByOrderItemId,
getWorkerLevelById,
getWorkerLevelByKey,
getWorkerUserById, getWorkerUserById,
getWorkerUserByUsername, getWorkerUserByUsername,
listAllWorkCategories, listAllWorkCategories,
listPendingMaterialWorkOrdersByPlatformOrderId,
grabWorkOrder, grabWorkOrder,
listWorkCategories,
listWorkOrders, listWorkOrders,
listWorkProductRules, listWorkProductRules,
listWorkerLevels, listWorkerLevels,
listWorkerUsers, listWorkerUsers,
resolveProblemWorkOrder,
updateWorkOrder, updateWorkOrder,
updateWorkerUser, updateWorkerUser,
upsertWorkCategory, upsertWorkCategory,
@@ -36,6 +34,8 @@ import {
type WorkProductRuleRow, type WorkProductRuleRow,
type WorkerLevelRow, type WorkerLevelRow,
type WorkerUserRow, type WorkerUserRow,
type GrabWorkOrderFailureReason,
type ProblemWorkOrderResolutionAction,
} from '../../repositories/worker-platform-repo.js' } from '../../repositories/worker-platform-repo.js'
import type { JsonObject } from '../../types/json.js' import type { JsonObject } from '../../types/json.js'
import type { OrderItemRow, OrderRow } from '../../types/repository/rows.js' import type { OrderItemRow, OrderRow } from '../../types/repository/rows.js'
@@ -43,6 +43,11 @@ import { createHttpError } from '../../utils/http.js'
import { randomId } from '../../utils/random.js' import { randomId } from '../../utils/random.js'
import { nowIso, addHours } from '../../utils/time.js' import { nowIso, addHours } from '../../utils/time.js'
import { normalizePage, normalizePageSize, safeParseJson } from '../admin/admin-query-utils.js' import { normalizePage, normalizePageSize, safeParseJson } from '../admin/admin-query-utils.js'
import {
normalizeStoredFileUrl,
refreshStoredFileUrl,
refreshUploadedFileUrls,
} from '../file-storage/file-storage-service.js'
export type WorkerSession = { export type WorkerSession = {
sessionId: string sessionId: string
@@ -56,12 +61,19 @@ export type WorkerSession = {
const DEFAULT_LEVEL_KEY = 'regular' const DEFAULT_LEVEL_KEY = 'regular'
const DEFAULT_CATEGORY_KEY = 'default' const DEFAULT_CATEGORY_KEY = 'default'
const DEFAULT_DEPOSIT_THRESHOLD_AMOUNT = 20_000 const DEFAULT_DEPOSIT_THRESHOLD_AMOUNT = 20_000
const IGNORABLE_WORKER_AUTH_ERROR_CODES = new Set([
'worker_auth_required',
'worker_auth_invalid',
'worker_auth_expired',
'worker_auth_user_invalid',
'worker_auth_stale',
])
export async function ensureWorkerPlatformDefaults() { export async function ensureWorkerPlatformDefaults() {
const now = nowIso() const now = nowIso()
const level = await upsertWorkerLevel({ const level = await upsertWorkerLevel({
levelKey: DEFAULT_LEVEL_KEY, levelKey: DEFAULT_LEVEL_KEY,
name: '普通接单员', name: '普通打手',
sortOrder: 100, sortOrder: 100,
status: 'active', status: 'active',
permissionJson: JSON.stringify({ permissionJson: JSON.stringify({
@@ -152,6 +164,27 @@ export async function loginWorker(username: unknown, password: unknown) {
return createWorkerSession(worker) return createWorkerSession(worker)
} }
export async function logoutWorkerSession(token: unknown) {
const normalizedToken = String(token || '').trim()
if (!normalizedToken) {
return { success: true, revoked: false }
}
try {
const session = await verifyWorkerSessionToken(normalizedToken)
const revokedWorker = await incrementWorkerSessionVersion(session.workerId, nowIso())
return {
success: true,
revoked: Boolean(revokedWorker),
}
} catch (error) {
if (isIgnorableWorkerAuthError(error)) {
return { success: true, revoked: false }
}
throw error
}
}
export async function verifyWorkerSessionToken(token: unknown): Promise<WorkerSession> { export async function verifyWorkerSessionToken(token: unknown): Promise<WorkerSession> {
ensureWorkerAuthConfigured() ensureWorkerAuthConfigured()
const normalizedToken = String(token || '').trim() const normalizedToken = String(token || '').trim()
@@ -301,16 +334,14 @@ export async function grabWorkerHallOrder(workOrderId: number | string, session:
workOrderId: Number(workOrder.id), workOrderId: Number(workOrder.id),
workerId: Number(worker.id), workerId: Number(worker.id),
depositAmount: freezeAmount, depositAmount: freezeAmount,
maxActiveOrders: permissions.maxActiveOrders,
now: nowIso(), now: nowIso(),
}) })
if (!grabbed) { if (!grabbed.order) {
throw createHttpError('抢单失败,订单可能已被抢走', { throwGrabWorkOrderFailure(grabbed.failureReason)
statusCode: 409,
errorCode: 'work_order_grab_conflict',
})
} }
return { order: mapWorkOrderForWorker(grabbed, permissions) } return { order: mapWorkOrderForWorker(grabbed.order, permissions) }
} }
export async function listWorkerMyOrders(query: JsonObject = {}, session: WorkerSession) { export async function listWorkerMyOrders(query: JsonObject = {}, session: WorkerSession) {
@@ -404,16 +435,25 @@ export async function collectLookupWorkOrder(payload: JsonObject = {}) {
errorCode: 'collect_order_no_required', errorCode: 'collect_order_no_required',
}) })
} }
const workOrder = await findPendingMaterialWorkOrderByPlatformOrderId(orderNo) const workOrders = await listPendingMaterialWorkOrdersByPlatformOrderId(orderNo)
if (!workOrder) { if (workOrders.length === 0) {
throw createHttpError('未找到待完善订单,请确认订单号是否正确', {
statusCode: 404,
errorCode: 'collect_order_not_found',
})
}
const [primaryOrder] = workOrders
if (!primaryOrder) {
throw createHttpError('未找到待完善订单,请确认订单号是否正确', { throw createHttpError('未找到待完善订单,请确认订单号是否正确', {
statusCode: 404, statusCode: 404,
errorCode: 'collect_order_not_found', errorCode: 'collect_order_not_found',
}) })
} }
return { return {
order: mapWorkOrderPublic(workOrder), order: mapWorkOrderPublic(primaryOrder),
fields: resolveRequirementFields(workOrder), fields: resolveRequirementFields(primaryOrder),
orders: workOrders.map(mapCollectLookupOrder),
pendingCount: workOrders.length,
} }
} }
@@ -425,13 +465,18 @@ export async function collectSubmitWorkOrder(payload: JsonObject = {}) {
errorCode: 'collect_order_no_required', errorCode: 'collect_order_no_required',
}) })
} }
const workOrder = await findPendingMaterialWorkOrderByPlatformOrderId(orderNo) const workOrders = await listPendingMaterialWorkOrdersByPlatformOrderId(orderNo)
if (!workOrder) { if (workOrders.length === 0) {
throw createHttpError('未找到待完善订单,请确认订单号是否正确', { throw createHttpError('未找到待完善订单,请确认订单号是否正确', {
statusCode: 404, statusCode: 404,
errorCode: 'collect_order_not_found', errorCode: 'collect_order_not_found',
}) })
} }
const workOrder = resolveCollectSubmitTargetWorkOrder(
orderNo,
workOrders,
payload.workOrderId || payload.work_order_id,
)
const fields = resolveRequirementFields(workOrder) const fields = resolveRequirementFields(workOrder)
const submittedFields = normalizeSubmittedFields(payload.fields || payload.material || payload) const submittedFields = normalizeSubmittedFields(payload.fields || payload.material || payload)
@@ -499,7 +544,7 @@ export async function saveAdminWorkCategory(payload: JsonObject = {}) {
export async function saveAdminWorkerLevel(payload: JsonObject = {}) { export async function saveAdminWorkerLevel(payload: JsonObject = {}) {
const now = nowIso() const now = nowIso()
const levelKey = String(payload.levelKey || payload.level_key || '').trim() || DEFAULT_LEVEL_KEY const levelKey = String(payload.levelKey || payload.level_key || '').trim() || DEFAULT_LEVEL_KEY
const name = String(payload.name || '').trim() || '普通接单员' const name = String(payload.name || '').trim() || '普通打手'
const permissions = { const permissions = {
depositFreeAmount: normalizeAmountFen( depositFreeAmount: normalizeAmountFen(
payload.depositFreeAmount ?? payload.depositFreeAmountYuan, payload.depositFreeAmount ?? payload.depositFreeAmountYuan,
@@ -844,6 +889,42 @@ export async function markAdminWorkOrderProblem(
return { order: mapWorkOrderAdmin(updated || workOrder) } return { order: mapWorkOrderAdmin(updated || workOrder) }
} }
export async function resolveAdminProblemWorkOrder(
workOrderId: number | string,
payload: JsonObject = {},
) {
const workOrder = await getRequiredWorkOrder(workOrderId)
if (workOrder.status !== WORK_ORDER_STATUS.PROBLEM) {
throw createHttpError('只有问题单可以执行处置', {
statusCode: 409,
errorCode: 'work_order_problem_resolution_status_invalid',
})
}
const action = normalizeProblemResolutionAction(payload.action)
const note = String(payload.note || '').trim()
if (!note) {
throw createHttpError('请填写处置备注', {
statusCode: 400,
errorCode: 'work_order_problem_resolution_note_required',
})
}
const updated = await resolveProblemWorkOrder({
workOrderId: workOrder.id,
action,
note,
now: nowIso(),
})
if (!updated) {
throw createHttpError('问题单处置失败,订单状态可能已变化', {
statusCode: 409,
errorCode: 'work_order_problem_resolution_conflict',
})
}
return { order: mapWorkOrderAdmin(updated) }
}
export async function acceptAdminWorkOrder(workOrderId: number | string) { export async function acceptAdminWorkOrder(workOrderId: number | string) {
const workOrder = await getRequiredWorkOrder(workOrderId) const workOrder = await getRequiredWorkOrder(workOrderId)
if (workOrder.status !== WORK_ORDER_STATUS.PENDING_ACCEPTANCE) { if (workOrder.status !== WORK_ORDER_STATUS.PENDING_ACCEPTANCE) {
@@ -989,6 +1070,41 @@ function createWorkerSession(worker: WorkerUserRow) {
} }
} }
export function resolveCollectSubmitTargetWorkOrder(
orderNo: string,
workOrders: WorkOrderRow[],
requestedWorkOrderId: unknown,
): WorkOrderRow {
const workOrderId = normalizeOptionalId(requestedWorkOrderId)
if (workOrderId) {
const matched = workOrders.find((item) => Number(item.id) === workOrderId)
if (matched) {
return matched
}
throw createHttpError('待完善订单不存在或已更新,请刷新后重试', {
statusCode: 404,
errorCode: 'collect_work_order_not_found',
context: { orderNo, workOrderId },
})
}
if (workOrders.length === 1) {
const [singleWorkOrder] = workOrders
if (singleWorkOrder) {
return singleWorkOrder
}
}
throw createHttpError('该订单存在多个待完善商品,请逐个提交资料', {
statusCode: 409,
errorCode: 'collect_work_order_required',
context: {
orderNo,
pendingCount: workOrders.length,
},
})
}
function ensureWorkerAuthConfigured() { function ensureWorkerAuthConfigured() {
if (String(runtimeConfig.admin?.sessionSecret || '').trim()) { if (String(runtimeConfig.admin?.sessionSecret || '').trim()) {
return return
@@ -1197,7 +1313,7 @@ function mapWorkOrderAdmin(workOrder: WorkOrderRow) {
), ),
material: safeParseJson(workOrder.material_json), material: safeParseJson(workOrder.material_json),
requirement: safeParseJson(workOrder.requirement_json), requirement: safeParseJson(workOrder.requirement_json),
acceptance: safeParseJson(workOrder.acceptance_json), acceptance: mapAcceptanceForResponse(workOrder.acceptance_json),
problemNote: workOrder.problem_note || '', problemNote: workOrder.problem_note || '',
worker: workOrder.assigned_worker_id worker: workOrder.assigned_worker_id
? { ? {
@@ -1219,14 +1335,17 @@ function mapWorkOrderForWorker(
workOrder: WorkOrderRow, workOrder: WorkOrderRow,
permissions: { depositFreeAmount: number }, permissions: { depositFreeAmount: number },
) { ) {
const mapped = mapWorkOrderAdmin(workOrder)
const { requiredDepositAmount, depositThresholdAmount, worker: _worker, ...visibleOrder } = mapped
return { return {
...mapWorkOrderAdmin(workOrder), ...visibleOrder,
freezeDepositAmount: resolveFreezeDepositAmount(workOrder, permissions), freezeDepositAmount: resolveFreezeDepositAmount(workOrder, permissions),
} }
} }
function mapWorkOrderPublic(workOrder: WorkOrderRow) { function mapWorkOrderPublic(workOrder: WorkOrderRow) {
return { return {
workOrderId: Number(workOrder.id),
workOrderNo: workOrder.work_order_no, workOrderNo: workOrder.work_order_no,
platformOrderId: workOrder.platform_order_id, platformOrderId: workOrder.platform_order_id,
productName: workOrder.product_name, productName: workOrder.product_name,
@@ -1234,6 +1353,14 @@ function mapWorkOrderPublic(workOrder: WorkOrderRow) {
} }
} }
function mapCollectLookupOrder(workOrder: WorkOrderRow) {
return {
...mapWorkOrderPublic(workOrder),
fields: resolveRequirementFields(workOrder),
values: resolveCollectSubmittedFieldValues(workOrder),
}
}
function mapWallet(wallet: Awaited<ReturnType<typeof addWorkerWalletCredit>>) { function mapWallet(wallet: Awaited<ReturnType<typeof addWorkerWalletCredit>>) {
return { return {
workerId: Number(wallet?.worker_id || 0), workerId: Number(wallet?.worker_id || 0),
@@ -1406,9 +1533,12 @@ function normalizeUploadedFiles(value: unknown) {
if (!objectKey && !url) return null if (!objectKey && !url) return null
return { return {
objectKey, objectKey,
url, url: normalizeStoredFileUrl(url, objectKey),
thumbnailUrl: String(source.thumbnailUrl || source.thumbnail_url || url).trim(), thumbnailUrl: normalizeStoredFileUrl(
mediumUrl: String(source.mediumUrl || source.medium_url || url).trim(), source.thumbnailUrl || source.thumbnail_url || url,
objectKey,
),
mediumUrl: normalizeStoredFileUrl(source.mediumUrl || source.medium_url || url, objectKey),
filename: String(source.filename || '').trim(), filename: String(source.filename || '').trim(),
contentType: String(source.contentType || source.content_type || '').trim(), contentType: String(source.contentType || source.content_type || '').trim(),
size: normalizeInteger(source.size, 0), size: normalizeInteger(source.size, 0),
@@ -1429,12 +1559,66 @@ function normalizeUploadedFiles(value: unknown) {
) )
} }
function mapAcceptanceForResponse(value: unknown) {
const acceptance = safeParseJson(value)
const files = normalizeUploadedFiles(acceptance.files).map((file) =>
refreshUploadedFileUrls(file),
)
const imageUrls = normalizeStringArray(acceptance.imageUrls).map((url) =>
refreshStoredFileUrl(url),
)
return {
...acceptance,
files,
imageUrls,
}
}
function resolveCollectSubmittedFieldValues(workOrder: WorkOrderRow) {
const material = safeParseJson(workOrder.material_json)
const collect =
material.collect && typeof material.collect === 'object' && !Array.isArray(material.collect)
? safeParseJson(material.collect)
: {}
return normalizeSubmittedFields(collect.fields)
}
function normalizeReviewStatus(value: unknown) { function normalizeReviewStatus(value: unknown) {
const status = String(value || '').trim() const status = String(value || '').trim()
if (['active', 'rejected', 'disabled', 'pending_review'].includes(status)) return status if (['active', 'rejected', 'disabled', 'pending_review'].includes(status)) return status
return 'pending_review' return 'pending_review'
} }
function normalizeProblemResolutionAction(value: unknown): ProblemWorkOrderResolutionAction {
const action = String(value || '').trim()
if (['return_to_worker', 'reopen', 'cancel_release', 'cancel_deduct'].includes(action)) {
return action as ProblemWorkOrderResolutionAction
}
throw createHttpError('问题单处置方式不正确', {
statusCode: 400,
errorCode: 'work_order_problem_resolution_action_invalid',
})
}
function throwGrabWorkOrderFailure(failureReason: GrabWorkOrderFailureReason | null): never {
if (failureReason === 'worker_active_order_limit') {
throw createHttpError('已达到当前等级最大同时接单量', {
statusCode: 409,
errorCode: 'worker_active_order_limit',
})
}
if (failureReason === 'worker_deposit_insufficient') {
throw createHttpError('余额不足,无法冻结所需押金', {
statusCode: 409,
errorCode: 'worker_deposit_insufficient',
})
}
throw createHttpError('抢单失败,订单可能已被抢走', {
statusCode: 409,
errorCode: 'work_order_grab_conflict',
})
}
function normalizeEnabledStatus(value: unknown) { function normalizeEnabledStatus(value: unknown) {
return String(value || 'active').trim() === 'disabled' ? 'disabled' : 'active' return String(value || 'active').trim() === 'disabled' ? 'disabled' : 'active'
} }
@@ -1520,3 +1704,9 @@ function normalizeAmountFen(value: unknown, fallback: number): number {
if (!Number.isFinite(parsed) || parsed < 0) return fallback if (!Number.isFinite(parsed) || parsed < 0) return fallback
return Math.round(parsed * 100) return Math.round(parsed * 100)
} }
function isIgnorableWorkerAuthError(error: unknown) {
return IGNORABLE_WORKER_AUTH_ERROR_CODES.has(
String((error as { errorCode?: string })?.errorCode || '').trim(),
)
}
+1 -1
View File
@@ -25,7 +25,7 @@ export default function WorkerLayout() {
const navigate = useNavigate() const navigate = useNavigate()
const location = useLocation() const location = useLocation()
const { message } = App.useApp() const { message } = App.useApp()
const username = getWorkerUsername() || '接单员' const username = getWorkerUsername() || '打手'
const status = getWorkerStatus() const status = getWorkerStatus()
async function submitLogout() { async function submitLogout() {
@@ -42,6 +42,7 @@ import {
fetchAdminWorkOrders, fetchAdminWorkOrders,
markAdminWorkOrderProblem, markAdminWorkOrderProblem,
publishAdminWorkOrder, publishAdminWorkOrder,
resolveAdminProblemWorkOrder,
reviewAdminWorkerUser, reviewAdminWorkerUser,
saveAdminWorkCategory, saveAdminWorkCategory,
saveAdminWorkProductRule, saveAdminWorkProductRule,
@@ -58,13 +59,17 @@ import type {
WorkerLevel, WorkerLevel,
WorkerUser, WorkerUser,
} from '@/types/worker-platform' } from '@/types/worker-platform'
import {
ADMIN_DEFAULT_PAGE_SIZE,
buildAdminTablePagination,
} from '@/utils/admin-pagination'
export default function AdminWorkerPlatformPage() { export default function AdminWorkerPlatformPage() {
return ( return (
<section className="page-stack"> <section className="page-stack">
<PageHeader <PageHeader
title="接单平台" title="接单平台"
description="管理接单员、接单工单、等级权限和本地 Mock 工单。" description="管理打手、接单工单、等级权限和本地 Mock 工单。"
/> />
<SummaryCards /> <SummaryCards />
<Tabs <Tabs
@@ -73,7 +78,7 @@ export default function AdminWorkerPlatformPage() {
{ key: 'orders', label: '接单工单', children: <WorkOrdersPanel /> }, { key: 'orders', label: '接单工单', children: <WorkOrdersPanel /> },
{ key: 'rules', label: '物品规则', children: <ProductRulesPanel /> }, { key: 'rules', label: '物品规则', children: <ProductRulesPanel /> },
{ key: 'categories', label: '分类', children: <CategoriesPanel /> }, { key: 'categories', label: '分类', children: <CategoriesPanel /> },
{ key: 'workers', label: '接单员', children: <WorkersPanel /> }, { key: 'workers', label: '打手', children: <WorkersPanel /> },
{ key: 'levels', label: '等级权限', children: <LevelsPanel /> }, { key: 'levels', label: '等级权限', children: <LevelsPanel /> },
]} ]}
/> />
@@ -92,7 +97,7 @@ function SummaryCards() {
<div className="metric-grid four"> <div className="metric-grid four">
<Card> <Card>
<Statistic <Statistic
title="待审核接单员" title="待审核打手"
value={summary?.pendingWorkerCount || 0} value={summary?.pendingWorkerCount || 0}
/> />
</Card> </Card>
@@ -116,15 +121,20 @@ function WorkOrdersPanel() {
const { message } = App.useApp() const { message } = App.useApp()
const queryClient = useQueryClient() const queryClient = useQueryClient()
const [status, setStatus] = useState('') const [status, setStatus] = useState('')
const [page, setPage] = useState(1)
const [pageSize, setPageSize] = useState(ADMIN_DEFAULT_PAGE_SIZE)
const [problemOrder, setProblemOrder] = useState<WorkOrder | null>(null) const [problemOrder, setProblemOrder] = useState<WorkOrder | null>(null)
const [resolutionOrder, setResolutionOrder] = useState<WorkOrder | null>(null)
const [materialOrder, setMaterialOrder] = useState<WorkOrder | null>(null) const [materialOrder, setMaterialOrder] = useState<WorkOrder | null>(null)
const [problemForm] = Form.useForm() const [problemForm] = Form.useForm()
const [resolutionForm] = Form.useForm()
const [materialForm] = Form.useForm() const [materialForm] = Form.useForm()
const ordersQuery = useQuery({ const ordersQuery = useQuery({
queryKey: ['admin-worker-platform-orders', status], queryKey: ['admin-worker-platform-orders', status, page, pageSize],
queryFn: () => fetchAdminWorkOrders({ status }), queryFn: () => fetchAdminWorkOrders({ status, page, pageSize }),
}) })
const ordersPagination = ordersQuery.data?.data.pagination
async function refreshAll() { async function refreshAll() {
await Promise.all([ await Promise.all([
@@ -145,25 +155,47 @@ function WorkOrdersPanel() {
await action() await action()
message.success(successMessage) message.success(successMessage)
await refreshAll() await refreshAll()
return true
} catch (error) { } catch (error) {
message.error(error instanceof Error ? error.message : '操作失败') message.error(error instanceof Error ? error.message : '操作失败')
return false
} }
} }
async function submitProblem(values: { note?: string }) { async function submitProblem(values: { note?: string }) {
if (!problemOrder) return if (!problemOrder) return
await runAction( const succeeded = await runAction(
() => () =>
markAdminWorkOrderProblem(problemOrder.workOrderId, values.note || ''), markAdminWorkOrderProblem(problemOrder.workOrderId, values.note || ''),
'已标记问题单', '已标记问题单',
) )
if (!succeeded) return
setProblemOrder(null) setProblemOrder(null)
problemForm.resetFields() problemForm.resetFields()
} }
async function submitResolution(values: {
action?: 'return_to_worker' | 'reopen' | 'cancel_release' | 'cancel_deduct'
note?: string
}) {
if (!resolutionOrder || !values.action) return
const action = values.action
const succeeded = await runAction(
() =>
resolveAdminProblemWorkOrder(resolutionOrder.workOrderId, {
action,
note: values.note || '',
}),
'问题单已处置',
)
if (!succeeded) return
setResolutionOrder(null)
resolutionForm.resetFields()
}
async function submitMaterial(values: { fields?: Record<string, string> }) { async function submitMaterial(values: { fields?: Record<string, string> }) {
if (!materialOrder) return if (!materialOrder) return
await runAction( const succeeded = await runAction(
() => () =>
submitAdminWorkOrderMaterial( submitAdminWorkOrderMaterial(
materialOrder.workOrderId, materialOrder.workOrderId,
@@ -171,6 +203,7 @@ function WorkOrdersPanel() {
), ),
'订单资料已保存', '订单资料已保存',
) )
if (!succeeded) return
setMaterialOrder(null) setMaterialOrder(null)
materialForm.resetFields() materialForm.resetFields()
} }
@@ -227,7 +260,7 @@ function WorkOrdersPanel() {
), ),
}, },
{ {
title: '接单员', title: '打手',
width: 140, width: 140,
render: (_, row) => render: (_, row) =>
row.worker?.displayName || row.worker?.username || '-', row.worker?.displayName || row.worker?.username || '-',
@@ -297,6 +330,11 @@ function WorkOrdersPanel() {
</Button> </Button>
) : null} ) : null}
{row.status === 'problem' ? (
<Button icon={<FormOutlined />} onClick={() => setResolutionOrder(row)}>
</Button>
) : null}
</Space> </Space>
), ),
}, },
@@ -342,8 +380,12 @@ function WorkOrdersPanel() {
{ value: 'pending_acceptance', label: '待验收' }, { value: 'pending_acceptance', label: '待验收' },
{ value: 'problem', label: '问题单' }, { value: 'problem', label: '问题单' },
{ value: 'accepted', label: '已验收' }, { value: 'accepted', label: '已验收' },
{ value: 'cancelled', label: '已取消' },
]} ]}
onChange={setStatus} onChange={(nextStatus) => {
setStatus(nextStatus)
setPage(1)
}}
/> />
<Button <Button
icon={<ReloadOutlined />} icon={<ReloadOutlined />}
@@ -361,7 +403,15 @@ function WorkOrdersPanel() {
loading={ordersQuery.isLoading} loading={ordersQuery.isLoading}
dataSource={ordersQuery.data?.data.items || []} dataSource={ordersQuery.data?.data.items || []}
columns={columns} columns={columns}
pagination={false} pagination={buildAdminTablePagination({
current: ordersPagination?.page || page,
pageSize: ordersPagination?.pageSize || pageSize,
total: ordersPagination?.total || 0,
onChange: (nextPage, nextPageSize) => {
setPage(nextPage)
setPageSize(nextPageSize)
},
})}
scroll={{ x: 1100 }} scroll={{ x: 1100 }}
/> />
</Card> </Card>
@@ -369,7 +419,10 @@ function WorkOrdersPanel() {
<Modal <Modal
title="标记问题单" title="标记问题单"
open={Boolean(problemOrder)} open={Boolean(problemOrder)}
onCancel={() => setProblemOrder(null)} onCancel={() => {
setProblemOrder(null)
problemForm.resetFields()
}}
onOk={() => problemForm.submit()} onOk={() => problemForm.submit()}
destroyOnHidden destroyOnHidden
> >
@@ -384,10 +437,53 @@ function WorkOrdersPanel() {
</Form> </Form>
</Modal> </Modal>
<Modal
title="处置问题单"
open={Boolean(resolutionOrder)}
onCancel={() => {
setResolutionOrder(null)
resolutionForm.resetFields()
}}
onOk={() => resolutionForm.submit()}
destroyOnHidden
>
<Form
form={resolutionForm}
layout="vertical"
initialValues={{ action: 'return_to_worker' }}
onFinish={submitResolution}
>
<Form.Item
label="处置方式"
name="action"
rules={[{ required: true, message: '请选择处置方式' }]}
>
<Select
options={[
{ value: 'return_to_worker', label: '退回打手继续代练' },
{ value: 'reopen', label: '释放押金并重新放回大厅' },
{ value: 'cancel_release', label: '取消订单并退还押金' },
{ value: 'cancel_deduct', label: '取消订单并扣除押金' },
]}
/>
</Form.Item>
<Form.Item
label="处置备注"
name="note"
rules={[{ required: true, message: '请填写处置备注' }]}
>
<Input.TextArea rows={4} />
</Form.Item>
</Form>
</Modal>
<Modal <Modal
title="人工补充资料" title="人工补充资料"
open={Boolean(materialOrder)} open={Boolean(materialOrder)}
onCancel={() => setMaterialOrder(null)} onCancel={() => {
setMaterialOrder(null)
materialForm.resetFields()
}}
onOk={() => materialForm.submit()} onOk={() => materialForm.submit()}
destroyOnHidden destroyOnHidden
> >
@@ -804,13 +900,16 @@ function WorkersPanel() {
const { message } = App.useApp() const { message } = App.useApp()
const queryClient = useQueryClient() const queryClient = useQueryClient()
const [status, setStatus] = useState('') const [status, setStatus] = useState('')
const [page, setPage] = useState(1)
const [pageSize, setPageSize] = useState(ADMIN_DEFAULT_PAGE_SIZE)
const [creditWorker, setCreditWorker] = useState<WorkerUser | null>(null) const [creditWorker, setCreditWorker] = useState<WorkerUser | null>(null)
const [creditForm] = Form.useForm() const [creditForm] = Form.useForm()
const workersQuery = useQuery({ const workersQuery = useQuery({
queryKey: ['admin-worker-platform-workers', status], queryKey: ['admin-worker-platform-workers', status, page, pageSize],
queryFn: () => fetchAdminWorkerUsers({ status }), queryFn: () => fetchAdminWorkerUsers({ status, page, pageSize }),
}) })
const workersPagination = workersQuery.data?.data.pagination
async function refreshWorkers() { async function refreshWorkers() {
await Promise.all([ await Promise.all([
@@ -826,7 +925,7 @@ function WorkersPanel() {
async function review(worker: WorkerUser, nextStatus: string) { async function review(worker: WorkerUser, nextStatus: string) {
try { try {
await reviewAdminWorkerUser(worker.workerId, { status: nextStatus }) await reviewAdminWorkerUser(worker.workerId, { status: nextStatus })
message.success('接单员状态已更新') message.success('打手状态已更新')
await refreshWorkers() await refreshWorkers()
} catch (error) { } catch (error) {
message.error(error instanceof Error ? error.message : '操作失败') message.error(error instanceof Error ? error.message : '操作失败')
@@ -851,7 +950,7 @@ function WorkersPanel() {
const columns: TableColumnsType<WorkerUser> = [ const columns: TableColumnsType<WorkerUser> = [
{ {
title: '接单员', title: '打手',
minWidth: 220, minWidth: 220,
render: (_, row) => ( render: (_, row) => (
<div className="cell-stack"> <div className="cell-stack">
@@ -901,7 +1000,7 @@ function WorkersPanel() {
return ( return (
<Card <Card
title="接单员" title="打手"
extra={ extra={
<Space> <Space>
<Select <Select
@@ -914,7 +1013,10 @@ function WorkersPanel() {
{ value: 'rejected', label: '已拒绝' }, { value: 'rejected', label: '已拒绝' },
{ value: 'disabled', label: '已停用' }, { value: 'disabled', label: '已停用' },
]} ]}
onChange={setStatus} onChange={(nextStatus) => {
setStatus(nextStatus)
setPage(1)
}}
/> />
<Button <Button
icon={<ReloadOutlined />} icon={<ReloadOutlined />}
@@ -932,14 +1034,25 @@ function WorkersPanel() {
loading={workersQuery.isLoading} loading={workersQuery.isLoading}
dataSource={workersQuery.data?.data.items || []} dataSource={workersQuery.data?.data.items || []}
columns={columns} columns={columns}
pagination={false} pagination={buildAdminTablePagination({
current: workersPagination?.page || page,
pageSize: workersPagination?.pageSize || pageSize,
total: workersPagination?.total || 0,
onChange: (nextPage, nextPageSize) => {
setPage(nextPage)
setPageSize(nextPageSize)
},
})}
scroll={{ x: 1000 }} scroll={{ x: 1000 }}
/> />
<Modal <Modal
title="人工增加余额" title="人工增加余额"
open={Boolean(creditWorker)} open={Boolean(creditWorker)}
onCancel={() => setCreditWorker(null)} onCancel={() => {
setCreditWorker(null)
creditForm.resetFields()
}}
onOk={() => creditForm.submit()} onOk={() => creditForm.submit()}
destroyOnHidden destroyOnHidden
> >
@@ -1010,7 +1123,7 @@ function LevelsPanel() {
layout="inline" layout="inline"
initialValues={{ initialValues={{
levelKey: 'regular', levelKey: 'regular',
name: '普通接单员', name: '普通打手',
depositFreeAmount: 0, depositFreeAmount: 0,
maxActiveOrders: 3, maxActiveOrders: 3,
}} }}
+68 -31
View File
@@ -3,51 +3,45 @@ import { App, Button, Card, Form, Input, Result, Space, Typography } from 'antd'
import { useState } from 'react' import { useState } from 'react'
import { lookupCollectOrder, submitCollectOrder } from '@/services/worker' import { lookupCollectOrder, submitCollectOrder } from '@/services/worker'
import type { CollectField } from '@/types/worker-platform' import type { CollectLookupOrder } from '@/types/worker-platform'
type LookupOrder = {
workOrderNo: string
platformOrderId: string
productName: string
status: string
}
export default function CollectPage() { export default function CollectPage() {
const { message } = App.useApp() const { message } = App.useApp()
const [orderNo, setOrderNo] = useState('') const [orderNo, setOrderNo] = useState('')
const [order, setOrder] = useState<LookupOrder | null>(null) const [lookupOrders, setLookupOrders] = useState<CollectLookupOrder[]>([])
const [fields, setFields] = useState<CollectField[]>([])
const [lookupLoading, setLookupLoading] = useState(false) const [lookupLoading, setLookupLoading] = useState(false)
const [submitLoading, setSubmitLoading] = useState(false) const [submittingWorkOrderId, setSubmittingWorkOrderId] = useState(0)
const [complete, setComplete] = useState(false) const [complete, setComplete] = useState(false)
async function submitLookup(values: { orderNo: string }) { async function submitLookup(values: { orderNo: string }) {
setLookupLoading(true) setLookupLoading(true)
setComplete(false) setComplete(false)
try { try {
const response = await lookupCollectOrder(values.orderNo) const nextOrderNo = String(values.orderNo || '').trim()
setOrderNo(values.orderNo) setOrderNo(nextOrderNo)
setOrder(response.data.order) await refreshLookupOrders(nextOrderNo)
setFields(response.data.fields)
} catch (error) { } catch (error) {
setOrder(null) setLookupOrders([])
setFields([])
message.error(error instanceof Error ? error.message : '查询失败') message.error(error instanceof Error ? error.message : '查询失败')
} finally { } finally {
setLookupLoading(false) setLookupLoading(false)
} }
} }
async function submitMaterial(values: Record<string, string>) { async function submitMaterial(order: CollectLookupOrder, values: Record<string, string>) {
setSubmitLoading(true) setSubmittingWorkOrderId(order.workOrderId)
try { try {
const response = await submitCollectOrder({ orderNo, fields: values }) const response = await submitCollectOrder({
setComplete(response.data.complete) orderNo,
message.success(response.data.complete ? '资料已完善' : '资料已提交') workOrderId: order.workOrderId,
fields: values,
})
message.success(response.data.complete ? '当前商品资料已完善' : '当前商品资料已提交')
await refreshLookupOrders(orderNo, { allowCompleteWhenNotFound: true })
} catch (error) { } catch (error) {
message.error(error instanceof Error ? error.message : '提交失败') message.error(error instanceof Error ? error.message : '提交失败')
} finally { } finally {
setSubmitLoading(false) setSubmittingWorkOrderId(0)
} }
} }
@@ -78,13 +72,30 @@ export default function CollectPage() {
<Result status="success" title="资料已提交完成" subTitle="订单已进入待分配状态,请等待处理。" /> <Result status="success" title="资料已提交完成" subTitle="订单已进入待分配状态,请等待处理。" />
) : null} ) : null}
{order && !complete ? ( {!complete && lookupOrders.length > 1 ? (
<Card className="platform-section-gap" title={order.productName} size="small"> <Typography.Paragraph type="secondary" className="platform-section-gap">
<Typography.Paragraph type="secondary"> {lookupOrders.length}
{order.platformOrderId}
</Typography.Paragraph> </Typography.Paragraph>
<Form layout="vertical" onFinish={submitMaterial}> ) : null}
{fields.map((field) => (
{lookupOrders.map((currentOrder) => (
<Card
key={currentOrder.workOrderId}
className="platform-section-gap"
title={currentOrder.productName}
extra={<Typography.Text type="secondary">{currentOrder.workOrderNo}</Typography.Text>}
size="small"
>
<Typography.Paragraph type="secondary">
{currentOrder.platformOrderId}
</Typography.Paragraph>
<Form
key={currentOrder.workOrderId}
layout="vertical"
initialValues={currentOrder.values || {}}
onFinish={(values) => submitMaterial(currentOrder, values)}
>
{currentOrder.fields.map((field) => (
<Form.Item <Form.Item
key={field.key} key={field.key}
label={field.label} label={field.label}
@@ -94,13 +105,39 @@ export default function CollectPage() {
<Input /> <Input />
</Form.Item> </Form.Item>
))} ))}
<Button type="primary" htmlType="submit" loading={submitLoading}> <Button
type="primary"
htmlType="submit"
loading={submittingWorkOrderId === currentOrder.workOrderId}
>
</Button> </Button>
</Form> </Form>
</Card> </Card>
) : null} ))}
</Card> </Card>
</main> </main>
) )
async function refreshLookupOrders(
currentOrderNo: string,
options: { allowCompleteWhenNotFound?: boolean } = {},
) {
try {
const response = await lookupCollectOrder(currentOrderNo)
setLookupOrders(response.data.orders || [])
setComplete(false)
} catch (error) {
if (options.allowCompleteWhenNotFound && isCollectOrderNotFoundError(error)) {
setLookupOrders([])
setComplete(true)
return
}
throw error
}
}
}
function isCollectOrderNotFoundError(error: unknown) {
return String((error as { errorCode?: string })?.errorCode || '').trim() === 'collect_order_not_found'
} }
@@ -1,6 +1,6 @@
import { ReloadOutlined, SearchOutlined } from '@ant-design/icons' import { ReloadOutlined, SearchOutlined } from '@ant-design/icons'
import { useQuery, useQueryClient } from '@tanstack/react-query' import { useQuery, useQueryClient } from '@tanstack/react-query'
import { App, Button, Card, Empty, Input, Space, Spin, Tag, Typography } from 'antd' import { App, Button, Card, Empty, Input, Pagination, Space, Spin, Tag, Typography } from 'antd'
import { useState } from 'react' import { useState } from 'react'
import { fetchWorkerHallOrders, grabWorkerOrder } from '@/services/worker' import { fetchWorkerHallOrders, grabWorkerOrder } from '@/services/worker'
@@ -9,16 +9,20 @@ import type { WorkOrder } from '@/types/worker-platform'
export default function WorkerHallPage() { export default function WorkerHallPage() {
const { message } = App.useApp() const { message } = App.useApp()
const queryClient = useQueryClient() const queryClient = useQueryClient()
const [keywordInput, setKeywordInput] = useState('')
const [keyword, setKeyword] = useState('') const [keyword, setKeyword] = useState('')
const [page, setPage] = useState(1)
const [pageSize, setPageSize] = useState(20)
const [grabbingId, setGrabbingId] = useState(0) const [grabbingId, setGrabbingId] = useState(0)
const ordersQuery = useQuery({ const ordersQuery = useQuery({
queryKey: ['worker-hall-orders', keyword], queryKey: ['worker-hall-orders', keyword, page, pageSize],
queryFn: () => fetchWorkerHallOrders({ keyword }), queryFn: () => fetchWorkerHallOrders({ keyword, page, pageSize }),
retry: false, retry: false,
}) })
const orders = ordersQuery.data?.data.items || [] const orders = ordersQuery.data?.data.items || []
const pagination = ordersQuery.data?.data.pagination
async function submitGrab(order: WorkOrder) { async function submitGrab(order: WorkOrder) {
setGrabbingId(order.workOrderId) setGrabbingId(order.workOrderId)
@@ -33,6 +37,11 @@ export default function WorkerHallPage() {
} }
} }
function applyKeywordSearch() {
setKeyword(keywordInput.trim())
setPage(1)
}
return ( return (
<section className="page-stack"> <section className="page-stack">
<div className="worker-page-head"> <div className="worker-page-head">
@@ -40,13 +49,31 @@ export default function WorkerHallPage() {
<Space.Compact> <Space.Compact>
<Input <Input
allowClear allowClear
value={keyword} value={keywordInput}
placeholder="搜索商品或订单号" placeholder="搜索商品或订单号"
prefix={<SearchOutlined />} prefix={<SearchOutlined />}
onChange={(event) => setKeyword(event.target.value)} onChange={(event) => {
onPressEnter={() => void ordersQuery.refetch()} const nextKeyword = event.target.value
setKeywordInput(nextKeyword)
if (!nextKeyword.trim()) {
setKeyword('')
setPage(1)
}
}}
onPressEnter={applyKeywordSearch}
/> />
<Button icon={<ReloadOutlined />} loading={ordersQuery.isFetching} onClick={() => ordersQuery.refetch()}> <Button
icon={<SearchOutlined />}
loading={ordersQuery.isFetching}
onClick={applyKeywordSearch}
>
</Button>
<Button
icon={<ReloadOutlined />}
loading={ordersQuery.isFetching}
onClick={() => ordersQuery.refetch()}
>
</Button> </Button>
</Space.Compact> </Space.Compact>
@@ -79,7 +106,7 @@ export default function WorkerHallPage() {
{formatMoney(order.rewardAmount)} {formatMoney(order.rewardAmount)}
</Typography.Title> </Typography.Title>
<Typography.Text type="secondary"> <Typography.Text type="secondary">
{formatMoney(order.freezeDepositAmount ?? order.requiredDepositAmount)} {formatMoney(order.freezeDepositAmount)}
</Typography.Text> </Typography.Text>
<Button <Button
type="primary" type="primary"
@@ -93,6 +120,21 @@ export default function WorkerHallPage() {
))} ))}
</div> </div>
)} )}
{(pagination?.total || 0) > 0 ? (
<Pagination
current={pagination?.page || page}
pageSize={pagination?.pageSize || pageSize}
total={pagination?.total || 0}
showSizeChanger
pageSizeOptions={[10, 20, 50, 100]}
showTotal={(total) => `${total}`}
onChange={(nextPage, nextPageSize) => {
setPage(nextPage)
setPageSize(nextPageSize)
}}
/>
) : null}
</section> </section>
) )
} }
@@ -26,21 +26,25 @@ const STATUS_OPTIONS = [
{ value: 'pending_acceptance', label: '待验收' }, { value: 'pending_acceptance', label: '待验收' },
{ value: 'problem', label: '问题单' }, { value: 'problem', label: '问题单' },
{ value: 'accepted', label: '已验收' }, { value: 'accepted', label: '已验收' },
{ value: 'cancelled', label: '已取消' },
] ]
export default function WorkerOrdersPage() { export default function WorkerOrdersPage() {
const { message } = App.useApp() const { message } = App.useApp()
const queryClient = useQueryClient() const queryClient = useQueryClient()
const [status, setStatus] = useState('') const [status, setStatus] = useState('')
const [page, setPage] = useState(1)
const [pageSize, setPageSize] = useState(20)
const [submittingOrder, setSubmittingOrder] = useState<WorkOrder | null>(null) const [submittingOrder, setSubmittingOrder] = useState<WorkOrder | null>(null)
const [acceptanceFiles, setAcceptanceFiles] = useState<UploadedFile[]>([]) const [acceptanceFiles, setAcceptanceFiles] = useState<UploadedFile[]>([])
const [form] = Form.useForm() const [form] = Form.useForm()
const ordersQuery = useQuery({ const ordersQuery = useQuery({
queryKey: ['worker-my-orders', status], queryKey: ['worker-my-orders', status, page, pageSize],
queryFn: () => fetchWorkerMyOrders({ status }), queryFn: () => fetchWorkerMyOrders({ status, page, pageSize }),
retry: false, retry: false,
}) })
const pagination = ordersQuery.data?.data.pagination
async function submitAcceptance(values: { note?: string }) { async function submitAcceptance(values: { note?: string }) {
if (!submittingOrder) return if (!submittingOrder) return
@@ -121,6 +125,7 @@ export default function WorkerOrdersPage() {
onClick={() => { onClick={() => {
setSubmittingOrder(row) setSubmittingOrder(row)
setAcceptanceFiles([]) setAcceptanceFiles([])
form.resetFields()
}} }}
> >
@@ -138,7 +143,10 @@ export default function WorkerOrdersPage() {
value={status} value={status}
options={STATUS_OPTIONS} options={STATUS_OPTIONS}
style={{ width: 140 }} style={{ width: 140 }}
onChange={setStatus} onChange={(nextStatus) => {
setStatus(nextStatus)
setPage(1)
}}
/> />
<Button <Button
icon={<ReloadOutlined />} icon={<ReloadOutlined />}
@@ -155,7 +163,18 @@ export default function WorkerOrdersPage() {
loading={ordersQuery.isLoading} loading={ordersQuery.isLoading}
dataSource={ordersQuery.data?.data.items || []} dataSource={ordersQuery.data?.data.items || []}
columns={columns} columns={columns}
pagination={false} pagination={{
current: pagination?.page || page,
pageSize: pagination?.pageSize || pageSize,
total: pagination?.total || 0,
showSizeChanger: true,
pageSizeOptions: [10, 20, 50, 100],
showTotal: (total) => `${total}`,
onChange: (nextPage, nextPageSize) => {
setPage(nextPage)
setPageSize(nextPageSize)
},
}}
scroll={{ x: 900 }} scroll={{ x: 900 }}
/> />
@@ -165,6 +184,7 @@ export default function WorkerOrdersPage() {
onCancel={() => { onCancel={() => {
setSubmittingOrder(null) setSubmittingOrder(null)
setAcceptanceFiles([]) setAcceptanceFiles([])
form.resetFields()
}} }}
onOk={() => form.submit()} onOk={() => form.submit()}
destroyOnHidden destroyOnHidden
@@ -210,12 +230,14 @@ function formatStatus(status: string) {
pending_acceptance: '待验收', pending_acceptance: '待验收',
problem: '问题单', problem: '问题单',
accepted: '已验收', accepted: '已验收',
cancelled: '已取消',
} }
return labels[status] || status return labels[status] || status
} }
function resolveStatusColor(status: string) { function resolveStatusColor(status: string) {
if (status === 'accepted') return 'green' if (status === 'accepted') return 'green'
if (status === 'cancelled') return 'default'
if (status === 'problem') return 'red' if (status === 'problem') return 'red'
if (status === 'pending_acceptance') return 'gold' if (status === 'pending_acceptance') return 'gold'
return 'blue' return 'blue'
@@ -22,7 +22,7 @@ export default function WorkerProfilePage() {
</Button> </Button>
</div> </div>
{!worker && !profileQuery.isLoading ? <Empty description="暂无接单员信息" /> : null} {!worker && !profileQuery.isLoading ? <Empty description="暂无打手信息" /> : null}
{worker ? ( {worker ? (
<> <>
@@ -164,6 +164,19 @@ export function markAdminWorkOrderProblem(workOrderId: number, note: string) {
) )
} }
export function resolveAdminProblemWorkOrder(
workOrderId: number,
payload: {
action: 'return_to_worker' | 'reopen' | 'cancel_release' | 'cancel_deduct'
note: string
},
) {
return apiPost<{ order: WorkOrder }>(
`/api/v1/admin/worker-platform/orders/${workOrderId}/problem/resolve`,
payload,
)
}
export function acceptAdminWorkOrder(workOrderId: number) { export function acceptAdminWorkOrder(workOrderId: number) {
return apiPost<{ order: WorkOrder }>( return apiPost<{ order: WorkOrder }>(
`/api/v1/admin/worker-platform/orders/${workOrderId}/accept`, `/api/v1/admin/worker-platform/orders/${workOrderId}/accept`,
+3 -8
View File
@@ -1,6 +1,6 @@
import { apiGet, apiPost } from '@/lib/http' import { apiGet, apiPost } from '@/lib/http'
import type { import type {
CollectField, CollectLookupResponse,
UploadedFile, UploadedFile,
WorkOrder, WorkOrder,
WorkerListResponse, WorkerListResponse,
@@ -70,17 +70,12 @@ export function submitWorkerAcceptance(
} }
export function lookupCollectOrder(orderNo: string) { export function lookupCollectOrder(orderNo: string) {
return apiPost<{ return apiPost<CollectLookupResponse>('/api/v1/collect/lookup', { orderNo })
order: Pick<
WorkOrder,
'workOrderNo' | 'platformOrderId' | 'productName' | 'status'
>
fields: CollectField[]
}>('/api/v1/collect/lookup', { orderNo })
} }
export function submitCollectOrder(payload: { export function submitCollectOrder(payload: {
orderNo: string orderNo: string
workOrderId?: number
fields: Record<string, string> fields: Record<string, string>
}) { }) {
return apiPost<{ complete: boolean; order: Record<string, unknown> }>( return apiPost<{ complete: boolean; order: Record<string, unknown> }>(
+22 -2
View File
@@ -98,8 +98,8 @@ export type WorkOrder = {
categoryName: string categoryName: string
status: WorkOrderStatus status: WorkOrderStatus
rewardAmount: number rewardAmount: number
requiredDepositAmount: number requiredDepositAmount?: number
depositThresholdAmount: number depositThresholdAmount?: number
freezeDepositAmount?: number freezeDepositAmount?: number
material: Record<string, unknown> material: Record<string, unknown>
requirement: Record<string, unknown> requirement: Record<string, unknown>
@@ -146,3 +146,23 @@ export type CollectField = {
label: string label: string
required: boolean required: boolean
} }
export type CollectLookupOrder = {
workOrderId: number
workOrderNo: string
platformOrderId: string
productName: string
status: string
fields: CollectField[]
values?: Record<string, string>
}
export type CollectLookupResponse = {
order: Pick<
WorkOrder,
'workOrderId' | 'workOrderNo' | 'platformOrderId' | 'productName' | 'status'
>
fields: CollectField[]
orders: CollectLookupOrder[]
pendingCount: number
}