395 lines
12 KiB
TypeScript
395 lines
12 KiB
TypeScript
/**
|
|
* 履约渠道 v2 路由:待分类队列、运营指定渠道、渠道规则、管道触发。
|
|
*
|
|
* 与成本中心的分工:
|
|
* · 这里只处理「渠道」;
|
|
* · 商品归一、成本版本、异常处置仍在成本中心的既有页面里。
|
|
*/
|
|
import { Router } from 'express'
|
|
|
|
import {
|
|
assignChannelByInternalSku,
|
|
assignChannelBySku,
|
|
assignChannelToOrderItems,
|
|
deleteChannelRule,
|
|
deleteChannelRules,
|
|
listChannelRulesPage,
|
|
listPendingChannelGroups,
|
|
switchChannelForOrderItems,
|
|
unlockChannel,
|
|
upsertChannelRule,
|
|
} from '../../services/fulfillment/channel-assign-service.js'
|
|
import {
|
|
deleteInternalSkuMapping,
|
|
listInternalSkuMappingsPage,
|
|
upsertInternalSkuMapping,
|
|
type InternalSkuMappingMatchType,
|
|
} from '../../services/fulfillment/internal-sku-mapping-service.js'
|
|
import { listExceptionQueue } from '../../services/cost-center/cost-exception-service.js'
|
|
import { retryPendingWorkOrderRouting } from '../../services/fulfillment/pending-channel-repair-service.js'
|
|
import {
|
|
runFinancePipelineOnce,
|
|
runSingleFinancePipeline,
|
|
} from '../../services/scheduler/finance-pipeline-jobs.js'
|
|
import {
|
|
getFinancePipelineStatus,
|
|
isFinancePipelineName,
|
|
} from '../../services/scheduler/finance-pipeline-status.js'
|
|
import { bodyOf } from './request-helpers.js'
|
|
import { createJsonHandler, requireAdminPermission, requireAdminRoles } from './session.js'
|
|
|
|
const router = Router()
|
|
|
|
router.use('/fulfillment', requireAdminRoles(['admin', 'operator', 'finance', 'support']))
|
|
|
|
router.get(
|
|
'/fulfillment/pending',
|
|
requireAdminPermission('finance.view'),
|
|
createJsonHandler(
|
|
(req) =>
|
|
listPendingChannelGroups({
|
|
page: Number(req.query.page),
|
|
pageSize: Number(req.query.pageSize),
|
|
keyword: String(req.query.keyword || ''),
|
|
}),
|
|
{
|
|
successMessage: 'ok',
|
|
errorMessage: '读取待分类队列失败',
|
|
scope: '[admin/fulfillment/pending]',
|
|
},
|
|
),
|
|
)
|
|
|
|
router.post(
|
|
'/fulfillment/pending/retry-work-orders',
|
|
requireAdminPermission('finance.config'),
|
|
createJsonHandler(
|
|
(req) => {
|
|
const body = bodyOf(req)
|
|
return retryPendingWorkOrderRouting({
|
|
internalSku: String(body.internalSku || ''),
|
|
limit: Number(body.limit),
|
|
})
|
|
},
|
|
{
|
|
successMessage: '接单模板重新匹配完成',
|
|
errorMessage: '接单模板重新匹配失败',
|
|
scope: '[admin/fulfillment/pending/retry-work-orders]',
|
|
audit: (req, data) => ({
|
|
action: 'fulfillment.retry_pending_work_orders',
|
|
targetType: 'order_items',
|
|
targetId: String(bodyOf(req).internalSku || ''),
|
|
data: data as Record<string, unknown>,
|
|
}),
|
|
},
|
|
),
|
|
)
|
|
|
|
router.get(
|
|
'/fulfillment/internal-sku-mappings',
|
|
requireAdminPermission('finance.view'),
|
|
createJsonHandler(
|
|
(req) =>
|
|
listInternalSkuMappingsPage({
|
|
keyword: String(req.query.keyword || ''),
|
|
provider: String(req.query.provider || ''),
|
|
shopId: String(req.query.shopId || ''),
|
|
matchType: String(req.query.matchType || ''),
|
|
page: Number(req.query.page),
|
|
pageSize: Number(req.query.pageSize),
|
|
}),
|
|
{
|
|
successMessage: 'ok',
|
|
errorMessage: '读取 SKU 映射失败',
|
|
scope: '[admin/fulfillment/internal-sku-mappings]',
|
|
},
|
|
),
|
|
)
|
|
|
|
router.post(
|
|
'/fulfillment/internal-sku-mappings',
|
|
requireAdminPermission('finance.config'),
|
|
createJsonHandler(
|
|
async (req) => {
|
|
const body = bodyOf(req)
|
|
const id = await upsertInternalSkuMapping({
|
|
provider: String(body.provider || ''),
|
|
shopId: String(body.shopId || ''),
|
|
matchType: String(body.matchType || 'sku_code') as InternalSkuMappingMatchType,
|
|
matchValue: String(body.matchValue || ''),
|
|
internalSku: String(body.internalSku || ''),
|
|
priority: Number(body.priority),
|
|
source: String(body.source || 'manual'),
|
|
note: String(body.note || ''),
|
|
enabled: body.enabled !== false,
|
|
})
|
|
return { id }
|
|
},
|
|
{
|
|
successMessage: 'SKU 映射已保存',
|
|
errorMessage: '保存 SKU 映射失败',
|
|
scope: '[admin/fulfillment/internal-sku-mappings/save]',
|
|
audit: (req, data) => ({
|
|
action: 'fulfillment.upsert_internal_sku_mapping',
|
|
targetType: 'internal_sku_mapping',
|
|
targetId: String((data as { id?: number })?.id || ''),
|
|
data: { payload: bodyOf(req) },
|
|
}),
|
|
},
|
|
),
|
|
)
|
|
|
|
router.delete(
|
|
'/fulfillment/internal-sku-mappings/:id',
|
|
requireAdminPermission('finance.config'),
|
|
createJsonHandler((req) => deleteInternalSkuMapping(Number(req.params.id)), {
|
|
successMessage: 'SKU 映射已删除',
|
|
errorMessage: '删除 SKU 映射失败',
|
|
scope: '[admin/fulfillment/internal-sku-mappings/delete]',
|
|
}),
|
|
)
|
|
|
|
router.get(
|
|
'/fulfillment/exceptions',
|
|
requireAdminPermission('finance.view'),
|
|
createJsonHandler(
|
|
(req) =>
|
|
listExceptionQueue({
|
|
reason: String(req.query.reason || ''),
|
|
status: String(req.query.status || 'open'),
|
|
page: Number(req.query.page),
|
|
pageSize: Number(req.query.pageSize),
|
|
}),
|
|
{
|
|
successMessage: 'ok',
|
|
errorMessage: '读取问题队列失败',
|
|
scope: '[admin/fulfillment/exceptions]',
|
|
},
|
|
),
|
|
)
|
|
|
|
router.post(
|
|
'/fulfillment/assign',
|
|
requireAdminPermission('finance.config'),
|
|
createJsonHandler(
|
|
async (req) => {
|
|
const body = bodyOf(req)
|
|
const channel = String(body.channel || '').trim()
|
|
const adminUserId = req.adminSession?.userId ?? null
|
|
const note = String(body.note || '')
|
|
|
|
if (body.internalSku) {
|
|
return assignChannelByInternalSku({
|
|
internalSku: String(body.internalSku),
|
|
channel,
|
|
adminUserId,
|
|
note,
|
|
createRule: body.createRule !== false,
|
|
})
|
|
}
|
|
|
|
if (body.skuCode) {
|
|
return assignChannelBySku({
|
|
provider: String(body.provider || ''),
|
|
shopId: String(body.shopId || ''),
|
|
skuCode: String(body.skuCode),
|
|
channel,
|
|
adminUserId,
|
|
note,
|
|
createRule: body.createRule !== false,
|
|
})
|
|
}
|
|
|
|
const ids = Array.isArray(body.orderItemIds)
|
|
? body.orderItemIds.map((value: unknown) => Number(value))
|
|
: [Number(body.orderItemId)].filter((value) => Number.isInteger(value) && value > 0)
|
|
|
|
return assignChannelToOrderItems({ orderItemIds: ids, channel, adminUserId, note })
|
|
},
|
|
{
|
|
successMessage: '已指定渠道',
|
|
errorMessage: '指定渠道失败',
|
|
scope: '[admin/fulfillment/assign]',
|
|
audit: (req, data) => ({
|
|
action: 'fulfillment.assign_channel',
|
|
targetType: 'order_item',
|
|
targetId: String(bodyOf(req).skuCode || bodyOf(req).orderItemId || ''),
|
|
data: { payload: bodyOf(req), result: data as Record<string, unknown> },
|
|
}),
|
|
},
|
|
),
|
|
)
|
|
|
|
router.post(
|
|
'/fulfillment/unlock',
|
|
requireAdminPermission('finance.config'),
|
|
createJsonHandler(
|
|
async (req) => {
|
|
const body = bodyOf(req)
|
|
const ids = Array.isArray(body.orderItemIds)
|
|
? body.orderItemIds.map((value: unknown) => Number(value))
|
|
: []
|
|
return unlockChannel(ids)
|
|
},
|
|
{
|
|
successMessage: '已解锁',
|
|
errorMessage: '解锁失败',
|
|
scope: '[admin/fulfillment/unlock]',
|
|
},
|
|
),
|
|
)
|
|
|
|
router.post(
|
|
'/fulfillment/switch',
|
|
requireAdminPermission('finance.config'),
|
|
createJsonHandler(
|
|
(req) => {
|
|
const body = bodyOf(req)
|
|
return switchChannelForOrderItems({
|
|
orderItemIds: Array.isArray(body.orderItemIds)
|
|
? body.orderItemIds.map((value: unknown) => Number(value))
|
|
: [Number(body.orderItemId)],
|
|
channel: String(body.channel || ''),
|
|
adminUserId: req.adminSession?.userId ?? null,
|
|
note: String(body.note || ''),
|
|
})
|
|
},
|
|
{
|
|
successMessage: '履约渠道已切换',
|
|
errorMessage: '切换履约渠道失败',
|
|
scope: '[admin/fulfillment/switch]',
|
|
audit: (req, data) => ({
|
|
action: 'fulfillment.switch_channel',
|
|
targetType: 'order_item',
|
|
targetId: String(bodyOf(req).orderItemId || ''),
|
|
data: { payload: bodyOf(req), result: data as Record<string, unknown> },
|
|
}),
|
|
},
|
|
),
|
|
)
|
|
|
|
router.get(
|
|
'/fulfillment/rules',
|
|
requireAdminPermission('finance.view'),
|
|
createJsonHandler(
|
|
(req) =>
|
|
listChannelRulesPage({
|
|
channel: String(req.query.channel || ''),
|
|
source: String(req.query.source || ''),
|
|
keyword: String(req.query.keyword || ''),
|
|
page: Number(req.query.page),
|
|
pageSize: Number(req.query.pageSize),
|
|
...(req.query.enabled === undefined
|
|
? {}
|
|
: { enabled: String(req.query.enabled) !== 'false' }),
|
|
}),
|
|
{
|
|
successMessage: 'ok',
|
|
errorMessage: '读取渠道规则失败',
|
|
scope: '[admin/fulfillment/rules]',
|
|
},
|
|
),
|
|
)
|
|
|
|
router.post(
|
|
'/fulfillment/rules',
|
|
requireAdminPermission('finance.config'),
|
|
createJsonHandler(
|
|
async (req) => {
|
|
const body = bodyOf(req)
|
|
return upsertChannelRule({
|
|
...(body.id ? { id: Number(body.id) } : {}),
|
|
matchKeyType: String(body.matchKeyType || 'internal_sku'),
|
|
matchKey: String(body.matchKey || ''),
|
|
channel: String(body.channel || ''),
|
|
priority: Number(body.priority),
|
|
source: String(body.source || 'operator'),
|
|
enabled: body.enabled !== false,
|
|
note: String(body.note || ''),
|
|
adminUserId: req.adminSession?.userId ?? null,
|
|
})
|
|
},
|
|
{
|
|
successMessage: '规则已保存',
|
|
errorMessage: '保存渠道规则失败',
|
|
scope: '[admin/fulfillment/rules]',
|
|
audit: (req, data) => ({
|
|
action: 'fulfillment.upsert_rule',
|
|
targetType: 'internal_sku_channel',
|
|
targetId: String((data as { id?: number })?.id || ''),
|
|
data: { payload: bodyOf(req) },
|
|
}),
|
|
},
|
|
),
|
|
)
|
|
|
|
router.delete(
|
|
'/fulfillment/rules/:id',
|
|
requireAdminPermission('finance.config'),
|
|
createJsonHandler((req) => deleteChannelRule(Number(req.params.id)), {
|
|
successMessage: '规则已删除',
|
|
errorMessage: '删除渠道规则失败',
|
|
scope: '[admin/fulfillment/rules]',
|
|
}),
|
|
)
|
|
|
|
router.post(
|
|
'/fulfillment/rules/batch-delete',
|
|
requireAdminPermission('finance.config'),
|
|
createJsonHandler((req) => deleteChannelRules(Array.isArray(req.body?.ids) ? req.body.ids : []), {
|
|
successMessage: '渠道规则已批量删除',
|
|
errorMessage: '批量删除渠道规则失败',
|
|
scope: '[admin/fulfillment/rules/batch-delete]',
|
|
audit: (_req, data) => ({
|
|
action: 'fulfillment.batch_delete_rules',
|
|
targetType: 'internal_sku_channel',
|
|
targetId: '',
|
|
data: data as Record<string, unknown>,
|
|
}),
|
|
}),
|
|
)
|
|
|
|
router.get(
|
|
'/fulfillment/pipeline/status',
|
|
requireAdminPermission('finance.view'),
|
|
createJsonHandler(() => getFinancePipelineStatus(), {
|
|
successMessage: 'ok',
|
|
errorMessage: '读取管道状态失败',
|
|
scope: '[admin/fulfillment/pipeline/status]',
|
|
}),
|
|
)
|
|
|
|
router.post(
|
|
'/fulfillment/pipeline/run',
|
|
requireAdminPermission('finance.config'),
|
|
createJsonHandler(
|
|
async (req) => {
|
|
const body = bodyOf(req)
|
|
const days = Number(body.days)
|
|
// 指定 pipeline 时只跑单步,便于排障与补跑。
|
|
if (body.pipeline) {
|
|
if (!isFinancePipelineName(body.pipeline)) {
|
|
throw new Error(`未知管道:${String(body.pipeline)}`)
|
|
}
|
|
return runSingleFinancePipeline(body.pipeline, {
|
|
config: Number.isFinite(days) ? { days } : {},
|
|
})
|
|
}
|
|
return runFinancePipelineOnce({ days: Number.isFinite(days) ? days : 3 })
|
|
},
|
|
{
|
|
successMessage: '管道已执行',
|
|
errorMessage: '执行管道失败',
|
|
scope: '[admin/fulfillment/pipeline]',
|
|
audit: (req, data) => ({
|
|
action: 'fulfillment.run_pipeline',
|
|
targetType: 'pipeline',
|
|
targetId: 'finance',
|
|
data: { payload: bodyOf(req), result: data as Record<string, unknown> },
|
|
}),
|
|
},
|
|
),
|
|
)
|
|
|
|
export default router
|