完整流程-调试

apps/backend/src/routes/admin/tasks.js

@@ -6,11 +6,14 @@ import {
   closeAdminTask,
   completeAdminTaskManualDispatch,
   confirmAdminTaskAssistedRole,
+  dispatchAdminTaskKuaishouCloudFulfillment,
   markAdminTaskManualReview,
+  prepareAdminTaskKuaishouCloudFulfillment,
   regenerateAdminTaskClaimLink,
   redeemAdminTaskAssisted,
   releaseAdminTaskInventoryBinding,
   releaseAdminTaskInventory,
+  returnNumberAdminTaskKuaishouCloudFulfillment,
   retryAdminTask,
 } from '../../services/admin/admin-write-service.js'
 import {
@@ -21,6 +24,7 @@ import {
 import { createFileHandler, createJsonHandler, requireAdminRoles } from './shared.js'
 
 /** @typedef {import('../../types/admin-route-inputs.js').AdminRouteAdminSession} AdminRouteAdminSession */
+/** @typedef {import('../../types/admin-route-inputs.js').AdminTaskKuaishouCloudDispatchRouteBody} AdminTaskKuaishouCloudDispatchRouteBody */
 /** @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 */
@@ -270,4 +274,83 @@ router.post('/tasks/:taskId/complete-manual-dispatch', requireAdminRoles(['admin
   },
 ))
 
+router.post('/tasks/:taskId/kuaishou-cloud/prepare', requireAdminRoles(['admin', 'operator']), createJsonHandler(
+  (req) => prepareAdminTaskKuaishouCloudFulfillment(
+    (/** @type {AdminTaskRouteParams} */ (req.params)).taskId,
+    /** @type {AdminRouteAdminSession | null} */ (req.adminSession),
+  ),
+  {
+    successMessage: '绑定资源已准备完成',
+    errorMessage: '准备绑定资源失败',
+    scope: '[admin/tasks/:taskId/kuaishou-cloud/prepare]',
+    audit: (req, data) => {
+      const result = /** @type {AdminTaskActionResponse} */ (data)
+      return {
+        action: 'task_kuaishou_cloud_prepare',
+        targetType: 'task',
+        targetId: String((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
+        data: {
+          taskId: result.task.taskId,
+          taskNo: result.task.taskNo,
+          status: result.task.status,
+        },
+      }
+    },
+  },
+))
+
+router.post('/tasks/:taskId/kuaishou-cloud/dispatch', requireAdminRoles(['admin', 'operator']), createJsonHandler(
+  (req) => dispatchAdminTaskKuaishouCloudFulfillment(
+    (/** @type {AdminTaskRouteParams} */ (req.params)).taskId,
+    /** @type {AdminTaskKuaishouCloudDispatchRouteBody} */ (req.body),
+    /** @type {AdminRouteAdminSession | null} */ (req.adminSession),
+  ),
+  {
+    successMessage: '已完成绑定确认并发货',
+    errorMessage: '执行发货失败',
+    scope: '[admin/tasks/:taskId/kuaishou-cloud/dispatch]',
+    audit: (req, data) => {
+      const result = /** @type {AdminTaskActionResponse} */ (data)
+      const body = /** @type {AdminTaskKuaishouCloudDispatchRouteBody} */ (req.body)
+      return {
+        action: 'task_kuaishou_cloud_dispatch',
+        targetType: 'task',
+        targetId: String((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
+        data: {
+          taskId: result.task.taskId,
+          taskNo: result.task.taskNo,
+          status: result.task.status,
+          deliveryStatus: result.task.deliveryStatus,
+          ticketCodeProvided: Boolean(String(body.ticketCode || '').trim()),
+        },
+      }
+    },
+  },
+))
+
+router.post('/tasks/:taskId/kuaishou-cloud/return-number', requireAdminRoles(['admin', 'operator']), createJsonHandler(
+  (req) => returnNumberAdminTaskKuaishouCloudFulfillment(
+    (/** @type {AdminTaskRouteParams} */ (req.params)).taskId,
+    /** @type {AdminRouteAdminSession | null} */ (req.adminSession),
+  ),
+  {
+    successMessage: '号码已退还',
+    errorMessage: '退还号码失败',
+    scope: '[admin/tasks/:taskId/kuaishou-cloud/return-number]',
+    audit: (req, data) => {
+      const result = /** @type {AdminTaskActionResponse} */ (data)
+      return {
+        action: 'task_kuaishou_cloud_return_number',
+        targetType: 'task',
+        targetId: String((/** @type {AdminTaskRouteParams} */ (req.params)).taskId),
+        data: {
+          taskId: result.task.taskId,
+          taskNo: result.task.taskNo,
+          status: result.task.status,
+        },
+      }
+    },
+  },
+))
+
 export default router