yml/order_site
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

把 task 的 helper独立出来了

Browse Source
This commit is contained in:
yml2213
2026-04-14 10:12:11 +08:00
parent 335eb44104
commit 9ca15fc503
21 changed files with 1202 additions and 824 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/backend/src/routes/admin/dashboard.js
+2
View File
@@ -1,3 +1,5 @@
// @ts-check
import { Router } from 'express'
import { getAdminDashboardSummary } from '../../services/admin/admin-dashboard-service.js'
apps/backend/src/routes/admin/inventory.js
+37 -18
View File
@@ -1,3 +1,5 @@
// @ts-check
import { Router } from 'express'
import {
@@ -12,12 +14,20 @@ import {
} from '../../services/admin/admin-read-service.js'
import { createJsonHandler, requireAdminRoles } from './shared.js'
/** @typedef {import('../../types/admin-route-inputs.js').AdminInventoryCreateRouteBody} AdminInventoryCreateRouteBody */
/** @typedef {import('../../types/admin-route-inputs.js').AdminInventoryImportRouteBody} AdminInventoryImportRouteBody */
/** @typedef {import('../../types/admin-route-inputs.js').AdminInventoryInvalidateRouteBody} AdminInventoryInvalidateRouteBody */
/** @typedef {import('../../types/admin-route-inputs.js').AdminInventoryRouteParams} AdminInventoryRouteParams */
/** @typedef {import('../../types/admin-route-inputs.js').AdminInventoryRouteQuery} AdminInventoryRouteQuery */
/** @typedef {import('../../types/admin-route-inputs.js').AdminInventorySkuSuggestionRouteQuery} AdminInventorySkuSuggestionRouteQuery */
/** @typedef {import('../../types/admin-write-models.js').AdminInventoryMutationResponse} AdminInventoryMutationResponse */
const router = Router()
router.use('/inventory', requireAdminRoles(['admin', 'operator']))
router.get('/inventory', createJsonHandler(
(req) => getAdminInventoryItems(req.query),
(req) => getAdminInventoryItems(/** @type {AdminInventoryRouteQuery} */ (req.query)),
{
successMessage: 'ok',
errorMessage: '读取库存列表失败',
@@ -26,7 +36,7 @@ router.get('/inventory', createJsonHandler(
))
router.get('/inventory/sku-suggestions', createJsonHandler(
(req) => getAdminInventorySkuSuggestions(req.query),
(req) => getAdminInventorySkuSuggestions(/** @type {AdminInventorySkuSuggestionRouteQuery} */ (req.query)),
{
successMessage: 'ok',
errorMessage: '读取内部 SKU 建议失败',
@@ -35,7 +45,7 @@ router.get('/inventory/sku-suggestions', createJsonHandler(
))
router.post('/inventory', createJsonHandler(
(req) => createAdminInventoryItem(req.body),
(req) => createAdminInventoryItem(/** @type {AdminInventoryCreateRouteBody} */ (req.body)),
{
successMessage: '库存项已新增',
errorMessage: '新增库存项失败',
@@ -44,7 +54,7 @@ router.post('/inventory', createJsonHandler(
))
router.post('/inventory/import', createJsonHandler(
(req) => importAdminInventoryItems(req.body),
(req) => importAdminInventoryItems(/** @type {AdminInventoryImportRouteBody} */ (req.body)),
{
successMessage: '导入完成',
errorMessage: '导入库存凭据失败',
@@ -53,40 +63,49 @@ router.post('/inventory/import', createJsonHandler(
))
router.post('/inventory/:inventoryItemId/release', requireAdminRoles(['admin']), createJsonHandler(
(req) => releaseAdminInventoryItem(req.params.inventoryItemId),
(req) => releaseAdminInventoryItem((/** @type {AdminInventoryRouteParams} */ (req.params)).inventoryItemId),
{
successMessage: '库存项已释放',
errorMessage: '释放库存项失败',
scope: '[admin/inventory/:inventoryItemId/release]',
audit: (req, data) => ({
audit: (req, data) => {
const result = /** @type {AdminInventoryMutationResponse} */ (data)
return {
action: 'inventory_item_released',
targetType: 'inventory_item',
targetId: String(req.params.inventoryItemId),
targetId: String((/** @type {AdminInventoryRouteParams} */ (req.params)).inventoryItemId),
data: {
inventoryItemId: data.inventoryItem?.inventoryItemId,
skuCode: data.inventoryItem?.skuCode,
displayValue: data.inventoryItem?.displayValue,
inventoryItemId: result.inventoryItem?.inventoryItemId,
skuCode: result.inventoryItem?.skuCode,
displayValue: result.inventoryItem?.displayValue,
},
}),
}
},
},
))
router.post('/inventory/:inventoryItemId/invalidate', requireAdminRoles(['admin']), createJsonHandler(
(req) => invalidateAdminInventoryItem(req.params.inventoryItemId, req.body),
(req) => invalidateAdminInventoryItem(
(/** @type {AdminInventoryRouteParams} */ (req.params)).inventoryItemId,
/** @type {AdminInventoryInvalidateRouteBody} */ (req.body),
),
{
successMessage: '库存项已作废',
errorMessage: '作废库存项失败',
scope: '[admin/inventory/:inventoryItemId/invalidate]',
audit: (req, data) => ({
audit: (req, data) => {
const result = /** @type {AdminInventoryMutationResponse} */ (data)
return {
action: 'inventory_item_invalidated',
targetType: 'inventory_item',
targetId: String(req.params.inventoryItemId),
targetId: String((/** @type {AdminInventoryRouteParams} */ (req.params)).inventoryItemId),
data: {
inventoryItemId: data.inventoryItem?.inventoryItemId,
skuCode: data.inventoryItem?.skuCode,
invalidReason: data.inventoryItem?.invalidReason,
inventoryItemId: result.inventoryItem?.inventoryItemId,
skuCode: result.inventoryItem?.skuCode,
invalidReason: result.inventoryItem?.invalidReason,
},
}),
}
},
},
))
apps/backend/src/routes/admin/message-deliveries.js
+5 -1
View File
@@ -1,12 +1,16 @@
// @ts-check
import { Router } from 'express'
import { getAdminMessageDeliveries } from '../../services/admin/admin-message-delivery-service.js'
import { createJsonHandler } from './shared.js'
/** @typedef {import('../../types/admin-route-inputs.js').AdminMessageDeliveryRouteQuery} AdminMessageDeliveryRouteQuery */
const router = Router()
router.get('/message-deliveries', createJsonHandler(
(req) => getAdminMessageDeliveries(req.query),
(req) => getAdminMessageDeliveries(/** @type {AdminMessageDeliveryRouteQuery} */ (req.query)),
{
successMessage: 'ok',
errorMessage: '读取消息发送记录失败',
apps/backend/src/routes/admin/orders.js
+7 -2
View File
@@ -1,12 +1,17 @@
// @ts-check
import { Router } from 'express'
import { getAdminOrderDetail, getAdminOrders } from '../../services/admin/admin-read-service.js'
import { createJsonHandler } from './shared.js'
/** @typedef {import('../../types/admin-route-inputs.js').AdminOrderRouteParams} AdminOrderRouteParams */
/** @typedef {import('../../types/admin-route-inputs.js').AdminOrderRouteQuery} AdminOrderRouteQuery */
const router = Router()
router.get('/orders', createJsonHandler(
(req) => getAdminOrders(req.query),
(req) => getAdminOrders(/** @type {AdminOrderRouteQuery} */ (req.query)),
{
successMessage: 'ok',
errorMessage: '读取订单列表失败',
@@ -15,7 +20,7 @@ router.get('/orders', createJsonHandler(
))
router.get('/orders/:orderId', createJsonHandler(
(req) => getAdminOrderDetail(req.params.orderId),
(req) => getAdminOrderDetail((/** @type {AdminOrderRouteParams} */ (req.params)).orderId),
{
successMessage: 'ok',
errorMessage: '读取订单详情失败',
apps/backend/src/routes/admin/platform-config.js
+52 -36
View File
@@ -1,3 +1,5 @@
// @ts-check
import { Router } from 'express'
import {
@@ -9,6 +11,11 @@ import {
} from '../../services/admin/admin-platform-config-service.js'
import { createJsonHandler, requireAdminRoles } from './shared.js'
/** @typedef {import('../../types/admin-route-inputs.js').AdminAgisoShopConfigRouteBody} AdminAgisoShopConfigRouteBody */
/** @typedef {import('../../types/admin-route-inputs.js').AdminFulfillmentBindingConfigRouteBody} AdminFulfillmentBindingConfigRouteBody */
/** @typedef {import('../../types/admin-route-inputs.js').AdminFulfillmentBindingLookupRouteBody} AdminFulfillmentBindingLookupRouteBody */
/** @typedef {import('../../types/admin-write-models.js').AdminAgisoShopConfigSaveResponse} AdminAgisoShopConfigSaveResponse */
const router = Router()
router.use('/platform-config', requireAdminRoles(['admin']))
@@ -23,20 +30,23 @@ router.get('/platform-config/agiso-shops', createJsonHandler(
))
router.post('/platform-config/agiso-shops', createJsonHandler(
(req) => updateAdminAgisoShopConfigs(req.body),
(req) => updateAdminAgisoShopConfigs(/** @type {AdminAgisoShopConfigRouteBody} */ (req.body)),
{
successMessage: 'Agiso 店铺配置已保存',
errorMessage: '保存 Agiso 店铺配置失败',
scope: '[admin/platform-config/agiso-shops]',
audit: (_req, data) => ({
action: 'platform_shop_config_updated',
targetType: 'platform_config',
targetId: 'agiso_shops',
data: {
shopCount: data.shops.length,
filePath: data.filePath,
},
}),
audit: (_req, data) => {
const result = /** @type {AdminAgisoShopConfigSaveResponse} */ (data)
return {
action: 'platform_shop_config_updated',
targetType: 'platform_config',
targetId: 'agiso_shops',
data: {
shopCount: result.shops.length,
filePath: result.filePath,
},
}
},
},
))
@@ -50,44 +60,50 @@ router.get('/platform-config/fulfillment-bindings', createJsonHandler(
))
router.post('/platform-config/fulfillment-bindings/lookup-order', createJsonHandler(
(req) => lookupAdminFulfillmentBindingOrder(req.body),
(req) => lookupAdminFulfillmentBindingOrder(/** @type {AdminFulfillmentBindingLookupRouteBody} */ (req.body)),
{
successMessage: '订单商品查询成功',
errorMessage: '手动查询订单商品失败',
scope: '[admin/platform-config/fulfillment-bindings/lookup-order]',
audit: (req, data) => ({
action: 'platform_fulfillment_order_lookup',
targetType: 'platform_config',
targetId: [
data.order?.provider || 'unknown',
data.order?.platform || 'unknown',
data.order?.shopId || 'unknown',
data.order?.platformOrderId || 'unknown',
].join(':'),
data: {
itemCount: Array.isArray(data.items) ? data.items.length : 0,
shopId: data.order?.shopId || String(req.body?.shopId || '').trim(),
platformOrderId: data.order?.platformOrderId || String(req.body?.platformOrderId || '').trim(),
},
}),
audit: (req, data) => {
const result = /** @type {{ order?: { provider?: string, platform?: string, shopId?: string, platformOrderId?: string }, items?: unknown[] }} */ (data)
return {
action: 'platform_fulfillment_order_lookup',
targetType: 'platform_config',
targetId: [
result.order?.provider || 'unknown',
result.order?.platform || 'unknown',
result.order?.shopId || 'unknown',
result.order?.platformOrderId || 'unknown',
].join(':'),
data: {
itemCount: Array.isArray(result.items) ? result.items.length : 0,
shopId: result.order?.shopId || String((/** @type {AdminFulfillmentBindingLookupRouteBody} */ (req.body))?.shopId || '').trim(),
platformOrderId: result.order?.platformOrderId || String((/** @type {AdminFulfillmentBindingLookupRouteBody} */ (req.body))?.platformOrderId || '').trim(),
},
}
},
},
))
router.post('/platform-config/fulfillment-bindings', createJsonHandler(
(req) => updateAdminFulfillmentBindingConfigs(req.body),
(req) => updateAdminFulfillmentBindingConfigs(/** @type {AdminFulfillmentBindingConfigRouteBody} */ (req.body)),
{
successMessage: '履约配置已保存',
errorMessage: '保存履约配置失败',
scope: '[admin/platform-config/fulfillment-bindings]',
audit: (_req, data) => ({
action: 'platform_fulfillment_config_updated',
targetType: 'platform_config',
targetId: 'fulfillment_bindings',
data: {
bindingCount: data.bindings.length,
filePath: data.filePath,
},
}),
audit: (_req, data) => {
const result = /** @type {{ bindings?: unknown[], filePath?: string }} */ (data)
return {
action: 'platform_fulfillment_config_updated',
targetType: 'platform_config',
targetId: 'fulfillment_bindings',
data: {
bindingCount: Array.isArray(result.bindings) ? result.bindings.length : 0,
filePath: result.filePath || '',
},
}
},
},
))
apps/backend/src/routes/admin/shared.js
+45
View File
@@ -1,8 +1,45 @@
// @ts-check
import { requireAdminRole, verifyAdminSessionToken } from '../../services/admin/admin-auth-service.js'
import { writeAdminAuditLog } from '../../services/admin/admin-audit-service.js'
import { buildSuccessPayload, createHttpError, sendRouteError } from '../../utils/http.js'
import { logWarn } from '../../utils/logger.js'
/** @typedef {import('express').NextFunction} NextFunction */
/** @typedef {import('express').Request} ExpressRequest */
/** @typedef {import('express').Response} ExpressResponse */
/** @typedef {import('../../types/admin-route-inputs.js').AdminRouteAdminSession} AdminRouteAdminSession */
/** @typedef {ExpressRequest & { adminSession?: AdminRouteAdminSession | null }} AdminExpressRequest */
/**
* @typedef {{
* action?: string
* targetType?: string
* targetId?: string
* data?: Record<string, unknown>
* }} AdminAuditPayload
*/
/**
* @typedef {{
* successMessage?: string
* errorMessage?: string
* scope?: string
* audit?: (req: AdminExpressRequest, data: unknown) => (AdminAuditPayload | null | undefined)
* }} AdminJsonHandlerOptions
*/
/**
* @typedef {{
* errorMessage?: string
* scope?: string
* }} AdminFileHandlerOptions
*/
/**
* @param {(req: AdminExpressRequest, res: ExpressResponse) => unknown | Promise<unknown>} action
* @param {AdminJsonHandlerOptions} [options]
*/
export function createJsonHandler(action, { successMessage = 'ok', errorMessage, scope, audit } = {}) {
return async (req, res) => {
try {
@@ -15,6 +52,10 @@ export function createJsonHandler(action, { successMessage = 'ok', errorMessage,
}
}
/**
* @param {(req: AdminExpressRequest, res: ExpressResponse) => string | Promise<string>} action
* @param {AdminFileHandlerOptions} [options]
*/
export function createFileHandler(action, { errorMessage, scope } = {}) {
return async (req, res) => {
try {
@@ -26,6 +67,9 @@ export function createFileHandler(action, { errorMessage, scope } = {}) {
}
}
/** @param {AdminExpressRequest} req */
/** @param {ExpressResponse} res */
/** @param {NextFunction} next */
export async function requireAdminSession(req, res, next) {
try {
req.adminSession = await verifyAdminSessionToken(extractBearerToken(req))
@@ -35,6 +79,7 @@ export async function requireAdminSession(req, res, next) {
}
}
/** @param {string[]} allowedRoles */
export function requireAdminRoles(allowedRoles) {
return (req, res, next) => {
try {
apps/backend/src/routes/admin/tasks.js
+123 -64
View File
@@ -1,3 +1,5 @@
// @ts-check
import { Router } from 'express'
import {
@@ -18,10 +20,21 @@ import {
} from '../../services/admin/admin-read-service.js'
import { createFileHandler, createJsonHandler, requireAdminRoles } from './shared.js'
/** @typedef {import('../../types/admin-route-inputs.js').AdminRouteAdminSession} AdminRouteAdminSession */
/** @typedef {import('../../types/admin-route-inputs.js').AdminTaskManualDispatchRouteBody} AdminTaskManualDispatchRouteBody */
/** @typedef {import('../../types/admin-route-inputs.js').AdminTaskRouteParams} AdminTaskRouteParams */
/** @typedef {import('../../types/admin-route-inputs.js').AdminTaskRouteQuery} AdminTaskRouteQuery */
/** @typedef {import('../../types/admin-write-models.js').AdminTaskActionResponse} AdminTaskActionResponse */
/** @typedef {import('../../types/admin-write-models.js').AdminTaskBindingReleaseResponse} AdminTaskBindingReleaseResponse */
/** @typedef {import('../../types/admin-write-models.js').AdminTaskManualDispatchResponse} AdminTaskManualDispatchResponse */
const router = Router()
router.get('/tasks', createJsonHandler(
(req) => getAdminTasks(req.query, req.adminSession),
(req) => getAdminTasks(
/** @type {AdminTaskRouteQuery} */ (req.query),
/** @type {AdminRouteAdminSession | null} */ (req.adminSession),
),
{
successMessage: 'ok',
errorMessage: '读取任务列表失败',
@@ -30,7 +43,10 @@ router.get('/tasks', createJsonHandler(
))
router.get('/tasks/:taskId', createJsonHandler(
(req) => getAdminTaskDetail(req.params.taskId, req.adminSession),
(req) => getAdminTaskDetail(
(/** @type {AdminTaskRouteParams} */ (req.params)).taskId,
/** @type {AdminRouteAdminSession | null} */ (req.adminSession),
),
{
successMessage: 'ok',
errorMessage: '读取任务详情失败',
@@ -39,7 +55,10 @@ router.get('/tasks/:taskId', createJsonHandler(
))
router.get('/tasks/:taskId/screenshot', createFileHandler(
(req) => getAdminTaskScreenshotPath(req.params.taskId, req.adminSession),
(req) => getAdminTaskScreenshotPath(
(/** @type {AdminTaskRouteParams} */ (req.params)).taskId,
/** @type {AdminRouteAdminSession | null} */ (req.adminSession),
),
{
errorMessage: '读取任务截图失败',
scope: '[admin/tasks/:taskId/screenshot]',
@@ -47,7 +66,7 @@ router.get('/tasks/:taskId/screenshot', createFileHandler(
))
router.post('/tasks/:taskId/retry', requireAdminRoles(['admin', 'operator']), createJsonHandler(
(req) => retryAdminTask(req.params.taskId),
(req) => retryAdminTask((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
{
successMessage: '任务已重试',
errorMessage: '重试任务失败',
@@ -56,158 +75,198 @@ router.post('/tasks/:taskId/retry', requireAdminRoles(['admin', 'operator']), cr
))
router.post('/tasks/:taskId/release-inventory', requireAdminRoles(['admin']), createJsonHandler(
(req) => releaseAdminTaskInventory(req.params.taskId),
(req) => releaseAdminTaskInventory((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
{
successMessage: '库存凭据已释放',
errorMessage: '释放库存凭据失败',
scope: '[admin/tasks/:taskId/release-inventory]',
audit: (req, data) => ({
audit: (req, data) => {
const result = /** @type {AdminTaskActionResponse} */ (data)
return {
action: 'task_release_inventory',
targetType: 'task',
targetId: String(req.params.taskId),
targetId: String((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
data: {
taskId: data.task.taskId,
taskNo: data.task.taskNo,
inventoryItemId: data.task.inventoryItemId,
taskId: result.task.taskId,
taskNo: result.task.taskNo,
inventoryItemId: result.task.inventoryItemId,
},
}),
}
},
},
))
router.post('/tasks/:taskId/inventory-bindings/:bindingId/release', requireAdminRoles(['admin']), createJsonHandler(
(req) => releaseAdminTaskInventoryBinding(req.params.taskId, req.params.bindingId),
(req) => releaseAdminTaskInventoryBinding(
(/** @type {AdminTaskRouteParams} */ (req.params)).taskId,
(/** @type {AdminTaskRouteParams} */ (req.params)).bindingId,
),
{
successMessage: '库存绑定已释放',
errorMessage: '释放库存绑定失败',
scope: '[admin/tasks/:taskId/inventory-bindings/:bindingId/release]',
audit: (req, data) => ({
audit: (req, data) => {
const result = /** @type {AdminTaskBindingReleaseResponse} */ (data)
return {
action: 'task_release_inventory_binding',
targetType: 'task_inventory_binding',
targetId: String(req.params.bindingId),
targetId: String((/** @type {AdminTaskRouteParams} */ (req.params)).bindingId),
data: {
taskId: data.task.taskId,
taskNo: data.task.taskNo,
bindingId: data.bindingId,
inventoryItemId: data.inventoryItemId,
taskId: result.task.taskId,
taskNo: result.task.taskNo,
bindingId: result.bindingId,
inventoryItemId: result.inventoryItemId,
},
}),
}
},
},
))
router.post('/tasks/:taskId/regenerate-claim-link', requireAdminRoles(['admin', 'operator', 'support']), createJsonHandler(
(req) => regenerateAdminTaskClaimLink(req.params.taskId, req.adminSession),
(req) => regenerateAdminTaskClaimLink(
(/** @type {AdminTaskRouteParams} */ (req.params)).taskId,
/** @type {AdminRouteAdminSession | null} */ (req.adminSession),
),
{
successMessage: '领取链接已重新生成',
errorMessage: '重新生成领取链接失败',
scope: '[admin/tasks/:taskId/regenerate-claim-link]',
audit: (req, data) => ({
audit: (req, data) => {
const result = /** @type {AdminTaskActionResponse} */ (data)
return {
action: 'task_regenerate_claim_link',
targetType: 'task',
targetId: String(req.params.taskId),
targetId: String((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
data: {
taskId: data.task.taskId,
taskNo: data.task.taskNo,
primaryClaimTokenId: data.task.primaryClaimTokenId,
taskId: result.task.taskId,
taskNo: result.task.taskNo,
primaryClaimTokenId: result.task.primaryClaimTokenId,
},
}),
}
},
},
))
router.post('/tasks/:taskId/support-confirm-role', requireAdminRoles(['admin', 'operator', 'support']), createJsonHandler(
(req) => confirmAdminTaskAssistedRole(req.params.taskId, req.adminSession),
(req) => confirmAdminTaskAssistedRole(
(/** @type {AdminTaskRouteParams} */ (req.params)).taskId,
/** @type {AdminRouteAdminSession | null} */ (req.adminSession),
),
{
successMessage: '角色已确认',
errorMessage: '客服确认角色失败',
scope: '[admin/tasks/:taskId/support-confirm-role]',
audit: (req, data) => ({
audit: (req, data) => {
const result = /** @type {AdminTaskActionResponse} */ (data)
return {
action: 'task_support_confirm_role',
targetType: 'task',
targetId: String(req.params.taskId),
targetId: String((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
data: {
taskId: data.task.taskId,
taskNo: data.task.taskNo,
status: data.task.status,
taskId: result.task.taskId,
taskNo: result.task.taskNo,
status: result.task.status,
},
}),
}
},
},
))
router.post('/tasks/:taskId/support-redeem', requireAdminRoles(['admin', 'operator', 'support']), createJsonHandler(
(req) => redeemAdminTaskAssisted(req.params.taskId, req.adminSession),
(req) => redeemAdminTaskAssisted(
(/** @type {AdminTaskRouteParams} */ (req.params)).taskId,
/** @type {AdminRouteAdminSession | null} */ (req.adminSession),
),
{
successMessage: '兑换任务已启动',
errorMessage: '客服发起兑换失败',
scope: '[admin/tasks/:taskId/support-redeem]',
audit: (req, data) => ({
audit: (req, data) => {
const result = /** @type {AdminTaskActionResponse} */ (data)
return {
action: 'task_support_redeem',
targetType: 'task',
targetId: String(req.params.taskId),
targetId: String((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
data: {
taskId: data.task.taskId,
taskNo: data.task.taskNo,
status: data.task.status,
deliveryStatus: data.task.deliveryStatus,
taskId: result.task.taskId,
taskNo: result.task.taskNo,
status: result.task.status,
deliveryStatus: result.task.deliveryStatus,
},
}),
}
},
},
))
router.post('/tasks/:taskId/close', requireAdminRoles(['admin', 'operator']), createJsonHandler(
(req) => closeAdminTask(req.params.taskId),
(req) => closeAdminTask((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
{
successMessage: '任务已关闭',
errorMessage: '关闭任务失败',
scope: '[admin/tasks/:taskId/close]',
audit: (req, data) => ({
audit: (req, data) => {
const result = /** @type {AdminTaskActionResponse} */ (data)
return {
action: 'task_closed',
targetType: 'task',
targetId: String(req.params.taskId),
targetId: String((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
data: {
taskId: data.task.taskId,
taskNo: data.task.taskNo,
status: data.task.status,
taskId: result.task.taskId,
taskNo: result.task.taskNo,
status: result.task.status,
},
}),
}
},
},
))
router.post('/tasks/:taskId/mark-manual-review', requireAdminRoles(['admin', 'operator']), createJsonHandler(
(req) => markAdminTaskManualReview(req.params.taskId),
(req) => markAdminTaskManualReview((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
{
successMessage: '任务已转人工处理',
errorMessage: '标记人工处理失败',
scope: '[admin/tasks/:taskId/mark-manual-review]',
audit: (req, data) => ({
audit: (req, data) => {
const result = /** @type {AdminTaskActionResponse} */ (data)
return {
action: 'task_mark_manual_review',
targetType: 'task',
targetId: String(req.params.taskId),
targetId: String((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
data: {
taskId: data.task.taskId,
taskNo: data.task.taskNo,
status: data.task.status,
taskId: result.task.taskId,
taskNo: result.task.taskNo,
status: result.task.status,
},
}),
}
},
},
))
router.post('/tasks/:taskId/complete-manual-dispatch', requireAdminRoles(['admin', 'operator']), createJsonHandler(
(req) => completeAdminTaskManualDispatch(req.params.taskId, req.body, req.adminSession),
(req) => completeAdminTaskManualDispatch(
(/** @type {AdminTaskRouteParams} */ (req.params)).taskId,
/** @type {AdminTaskManualDispatchRouteBody} */ (req.body),
/** @type {AdminRouteAdminSession | null} */ (req.adminSession),
),
{
successMessage: '人工履约结果已回写',
errorMessage: '回写人工履约结果失败',
scope: '[admin/tasks/:taskId/complete-manual-dispatch]',
audit: (req, data) => ({
audit: (req, data) => {
const result = /** @type {AdminTaskManualDispatchResponse} */ (data)
return {
action: 'task_complete_manual_dispatch',
targetType: 'task',
targetId: String(req.params.taskId),
targetId: String((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
data: {
taskId: data.task.taskId,
taskNo: data.task.taskNo,
outcome: data.outcome,
deliveryStatus: data.task.deliveryStatus,
resultCode: data.task.resultCode,
taskId: result.task.taskId,
taskNo: result.task.taskNo,
outcome: result.outcome,
deliveryStatus: result.task.deliveryStatus,
resultCode: result.task.resultCode,
},
}),
}
},
},
))
apps/backend/src/routes/admin/webhook-events.js
+17 -8
View File
@@ -1,3 +1,5 @@
// @ts-check
import { Router } from 'express'
import {
@@ -9,12 +11,16 @@ import {
} from '../../services/admin/admin-read-service.js'
import { createJsonHandler, requireAdminRoles } from './shared.js'
/** @typedef {import('../../types/admin-route-inputs.js').AdminWebhookEventRouteParams} AdminWebhookEventRouteParams */
/** @typedef {import('../../types/admin-route-inputs.js').AdminWebhookEventRouteQuery} AdminWebhookEventRouteQuery */
/** @typedef {import('../../types/admin-write-models.js').AdminWebhookReplayResponse} AdminWebhookReplayResponse */
const router = Router()
router.use('/webhook-events', requireAdminRoles(['admin', 'operator']))
router.get('/webhook-events', createJsonHandler(
(req) => getAdminWebhookEvents(req.query),
(req) => getAdminWebhookEvents(/** @type {AdminWebhookEventRouteQuery} */ (req.query)),
{
successMessage: 'ok',
errorMessage: '读取 webhook 列表失败',
@@ -23,7 +29,7 @@ router.get('/webhook-events', createJsonHandler(
))
router.get('/webhook-events/:eventId', createJsonHandler(
(req) => getAdminWebhookEventDetail(req.params.eventId),
(req) => getAdminWebhookEventDetail((/** @type {AdminWebhookEventRouteParams} */ (req.params)).eventId),
{
successMessage: 'ok',
errorMessage: '读取 webhook 详情失败',
@@ -32,20 +38,23 @@ router.get('/webhook-events/:eventId', createJsonHandler(
))
router.post('/webhook-events/:eventId/replay', requireAdminRoles(['admin']), createJsonHandler(
(req) => replayAdminWebhookEvent(req.params.eventId),
(req) => replayAdminWebhookEvent((/** @type {AdminWebhookEventRouteParams} */ (req.params)).eventId),
{
successMessage: 'Webhook 已重放',
errorMessage: '重放 webhook 失败',
scope: '[admin/webhook-events/:eventId/replay]',
audit: (req, data) => ({
audit: (req, data) => {
const result = /** @type {AdminWebhookReplayResponse} */ (data)
return {
action: 'webhook_replayed',
targetType: 'webhook_event',
targetId: String(req.params.eventId),
targetId: String((/** @type {AdminWebhookEventRouteParams} */ (req.params)).eventId),
data: {
eventId: data.eventId,
replayed: data.replayed,
eventId: result.eventId,
replayed: result.replayed,
},
}),
}
},
},
))