拆分快手轻量后端入口

2026-05-25 20:42:27 +08:00
parent d58d483944
commit db22ff691b
23 changed files with 1146 additions and 13 deletions
@@ -0,0 +1,34 @@
+import { Router } from "express";
+
+import authRouter from "./admin/auth.js";
+import auditLogsRouter from "./admin/audit-logs.js";
+import dashboardRouter from "./admin/dashboard.js";
+import inventoryRouter from "./admin/inventory-kuaishou.js";
+import messageDeliveriesRouter from "./admin/message-deliveries.js";
+import ordersRouter from "./admin/orders.js";
+import platformConfigRouter from "./admin/platform-config.js";
+import { requireAdminSession } from "./admin/shared.js";
+import tasksRouter from "./admin/tasks-kuaishou.js";
+import usersRouter from "./admin/users.js";
+import webhookEventsRouter from "./admin/webhook-events-kuaishou.js";
+import { buildNotFoundPayload } from "../utils/http.js";
+
+const router = Router();
+
+router.use(authRouter);
+router.use(requireAdminSession);
+router.use(dashboardRouter);
+router.use(usersRouter);
+router.use(auditLogsRouter);
+router.use(platformConfigRouter);
+router.use(ordersRouter);
+router.use(tasksRouter);
+router.use(inventoryRouter);
+router.use(messageDeliveriesRouter);
+router.use(webhookEventsRouter);
+
+router.use((req, res) => {
+  res.status(404).json(buildNotFoundPayload(req));
+});
+
+export default router;
@@ -0,0 +1,149 @@
+import { Router } from "express";
+
+import {
+  createAdminInventoryItem,
+  importAdminInventoryItems,
+  invalidateAdminInventoryItem,
+  releaseAdminInventoryItem,
+} from "../../services/admin/write/inventory.js";
+import {
+  getAdminInventoryItems,
+  getAdminInventorySkuSuggestions,
+} from "../../services/admin/admin-read-service.js";
+import { createJsonHandler, requireAdminRoles } from "./shared.js";
+import type {
+  AdminInventoryCreateRouteBody,
+  AdminInventoryImportRouteBody,
+  AdminInventoryInvalidateRouteBody,
+  AdminInventoryRouteParams,
+  AdminInventoryRouteQuery,
+  AdminInventorySkuSuggestionRouteQuery,
+} from "../../types/admin-route-inputs.js";
+import type { AdminInventoryMutationResponse } from "../../types/admin-write-models.js";
+
+const router = Router();
+
+router.use("/inventory", requireAdminRoles(["admin", "operator"]));
+
+router.get(
+  "/inventory",
+  createJsonHandler(
+    (req) =>
+      getAdminInventoryItems(
+        req.query as AdminInventoryRouteQuery,
+        req.adminSession || null
+      ),
+    {
+      successMessage: "ok",
+      errorMessage: "读取库存列表失败",
+      scope: "[admin-kuaishou/inventory]",
+    }
+  )
+);
+
+router.get(
+  "/inventory/sku-suggestions",
+  createJsonHandler(
+    (req) =>
+      getAdminInventorySkuSuggestions(
+        req.query as AdminInventorySkuSuggestionRouteQuery,
+        req.adminSession || null
+      ),
+    {
+      successMessage: "ok",
+      errorMessage: "读取内部 SKU 建议失败",
+      scope: "[admin-kuaishou/inventory/sku-suggestions]",
+    }
+  )
+);
+
+router.post(
+  "/inventory",
+  createJsonHandler(
+    (req) => createAdminInventoryItem(req.body as AdminInventoryCreateRouteBody),
+    {
+      successMessage: "库存项已新增",
+      errorMessage: "新增库存项失败",
+      scope: "[admin-kuaishou/inventory]",
+    }
+  )
+);
+
+router.post(
+  "/inventory/import",
+  createJsonHandler(
+    (req) => importAdminInventoryItems(req.body as AdminInventoryImportRouteBody),
+    {
+      successMessage: "导入完成",
+      errorMessage: "导入库存凭据失败",
+      scope: "[admin-kuaishou/inventory/import]",
+    }
+  )
+);
+
+router.post(
+  "/inventory/:inventoryItemId/release",
+  requireAdminRoles(["admin"]),
+  createJsonHandler(
+    (req) =>
+      releaseAdminInventoryItem(
+        (req.params as AdminInventoryRouteParams).inventoryItemId
+      ),
+    {
+      successMessage: "库存项已释放",
+      errorMessage: "释放库存项失败",
+      scope: "[admin-kuaishou/inventory/:inventoryItemId/release]",
+      audit: (req, data) => {
+        const result = data as AdminInventoryMutationResponse;
+
+        return {
+          action: "inventory_item_released",
+          targetType: "inventory_item",
+          targetId: String(
+            (req.params as AdminInventoryRouteParams).inventoryItemId
+          ),
+          data: {
+            inventoryItemId: result.inventoryItem?.inventoryItemId,
+            skuCode: result.inventoryItem?.skuCode,
+            displayValue: result.inventoryItem?.displayValue,
+          },
+        };
+      },
+    }
+  )
+);
+
+router.post(
+  "/inventory/:inventoryItemId/invalidate",
+  requireAdminRoles(["admin"]),
+  createJsonHandler(
+    (req) =>
+      invalidateAdminInventoryItem(
+        (req.params as AdminInventoryRouteParams).inventoryItemId,
+        req.body as AdminInventoryInvalidateRouteBody
+      ),
+    {
+      successMessage: "库存项已作废",
+      errorMessage: "作废库存项失败",
+      scope: "[admin-kuaishou/inventory/:inventoryItemId/invalidate]",
+      audit: (req, data) => {
+        const result = data as AdminInventoryMutationResponse;
+
+        return {
+          action: "inventory_item_invalidated",
+          targetType: "inventory_item",
+          targetId: String(
+            (req.params as AdminInventoryRouteParams).inventoryItemId
+          ),
+          data: {
+            inventoryItemId: result.inventoryItem?.inventoryItemId,
+            skuCode: result.inventoryItem?.skuCode,
+            invalidReason: result.inventoryItem?.invalidReason,
+          },
+        };
+      },
+    }
+  )
+);
+
+export default router;
@@ -0,0 +1,162 @@
+import type { Request } from "express";
+import { Router } from "express";
+
+import {
+  getAdminTaskDetail,
+  getAdminTasks,
+} from "../../services/admin/admin-read-service.js";
+import {
+  dispatchAdminTaskKuaishouCloudFulfillment,
+  prepareAdminTaskKuaishouCloudFulfillment,
+  refreshAdminTaskKuaishouCloudRoleInfo,
+  returnNumberAdminTaskKuaishouCloudFulfillment,
+} from "../../services/admin/write/kuaishou-cloud-actions.js";
+import {
+  createJsonHandler,
+  requireAdminRoles,
+} from "./shared.js";
+import type {
+  AdminTaskKuaishouCloudDispatchRouteBody,
+  AdminTaskRouteParams,
+  AdminTaskRouteQuery,
+} from "../../types/admin-route-inputs.js";
+import type { AdminTaskActionResponse } from "../../types/admin-write-models.js";
+
+const router = Router();
+
+function getTaskId(req: Request): string | undefined {
+  return (req.params as AdminTaskRouteParams).taskId;
+}
+
+router.get(
+  "/tasks",
+  createJsonHandler(
+    (req) =>
+      getAdminTasks(req.query as AdminTaskRouteQuery, req.adminSession || null),
+    {
+      successMessage: "ok",
+      errorMessage: "读取任务列表失败",
+      scope: "[admin-kuaishou/tasks]",
+    }
+  )
+);
+
+router.get(
+  "/tasks/:taskId",
+  createJsonHandler(
+    (req) => getAdminTaskDetail(getTaskId(req), req.adminSession || null),
+    {
+      successMessage: "ok",
+      errorMessage: "读取任务详情失败",
+      scope: "[admin-kuaishou/tasks/:taskId]",
+    }
+  )
+);
+
+router.post(
+  "/tasks/:taskId/kuaishou-cloud/prepare",
+  requireAdminRoles(["admin", "operator"]),
+  createJsonHandler(
+    (req) =>
+      prepareAdminTaskKuaishouCloudFulfillment(
+        getTaskId(req),
+        req.adminSession || null
+      ),
+    {
+      successMessage: "绑定资源已准备完成",
+      errorMessage: "准备绑定资源失败",
+      scope: "[admin-kuaishou/tasks/:taskId/kuaishou-cloud/prepare]",
+      audit: (req, data) => buildTaskAudit("task_kuaishou_cloud_prepare", req, data),
+    }
+  )
+);
+
+router.post(
+  "/tasks/:taskId/kuaishou-cloud/refresh-role-info",
+  requireAdminRoles(["admin", "operator", "support"]),
+  createJsonHandler(
+    (req) =>
+      refreshAdminTaskKuaishouCloudRoleInfo(
+        getTaskId(req),
+        req.adminSession || null
+      ),
+    {
+      successMessage: "角色信息已刷新",
+      errorMessage: "刷新角色信息失败",
+      scope: "[admin-kuaishou/tasks/:taskId/kuaishou-cloud/refresh-role-info]",
+      audit: (req, data) =>
+        buildTaskAudit("task_kuaishou_cloud_role_info_refreshed", req, data),
+    }
+  )
+);
+
+router.post(
+  "/tasks/:taskId/kuaishou-cloud/dispatch",
+  requireAdminRoles(["admin", "operator"]),
+  createJsonHandler(
+    (req) =>
+      dispatchAdminTaskKuaishouCloudFulfillment(
+        getTaskId(req),
+        req.body as AdminTaskKuaishouCloudDispatchRouteBody,
+        req.adminSession || null
+      ),
+    {
+      successMessage: "已完成绑定确认并发货",
+      errorMessage: "执行发货失败",
+      scope: "[admin-kuaishou/tasks/:taskId/kuaishou-cloud/dispatch]",
+      audit: (req, data) => {
+        const result = data as AdminTaskActionResponse;
+        const body = req.body as AdminTaskKuaishouCloudDispatchRouteBody;
+
+        return {
+          action: "task_kuaishou_cloud_dispatch",
+          targetType: "task",
+          targetId: String(getTaskId(req)),
+          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(
+        getTaskId(req),
+        req.adminSession || null
+      ),
+    {
+      successMessage: "号码已退还",
+      errorMessage: "退还号码失败",
+      scope: "[admin-kuaishou/tasks/:taskId/kuaishou-cloud/return-number]",
+      audit: (req, data) =>
+        buildTaskAudit("task_kuaishou_cloud_return_number", req, data),
+    }
+  )
+);
+
+function buildTaskAudit(action: string, req: Request, data: unknown) {
+  const result = data as AdminTaskActionResponse;
+
+  return {
+    action,
+    targetType: "task",
+    targetId: String(getTaskId(req)),
+    data: {
+      taskId: result.task.taskId,
+      taskNo: result.task.taskNo,
+      status: result.task.status,
+    },
+  };
+}
+
+export default router;
@@ -17,9 +17,9 @@ import {
 } from "../../services/admin/admin-write-service.js";
 import {
  getAdminTaskDetail,
-  getAdminTaskScreenshotPath,
  getAdminTasks,
 } from "../../services/admin/admin-read-service.js";
+import { getAdminTaskScreenshotPathWithTencentFallback } from "../../services/admin/admin-task-screenshot-service.js";
 import {
  createFileHandler,
  createJsonHandler,
@@ -77,7 +77,7 @@ router.get(
  "/tasks/:taskId/screenshot",
  createFileHandler(
    (req) =>
-      getAdminTaskScreenshotPath(getTaskId(req), req.adminSession || null),
+      getAdminTaskScreenshotPathWithTencentFallback(getTaskId(req), req.adminSession || null),
    {
      errorMessage: "读取任务截图失败",
      scope: "[admin/tasks/:taskId/screenshot]",
@@ -0,0 +1,77 @@
+import { Router } from "express";
+
+import { replayAdminWebhookEvent } from "../../services/admin/write/webhook-events.js";
+import {
+  getAdminWebhookEventDetail,
+  getAdminWebhookEvents,
+} from "../../services/admin/admin-read-service.js";
+import { createJsonHandler, requireAdminRoles } from "./shared.js";
+import type {
+  AdminWebhookEventRouteParams,
+  AdminWebhookEventRouteQuery,
+} from "../../types/admin-route-inputs.js";
+import type { AdminWebhookReplayResponse } from "../../types/admin-write-models.js";
+
+const router = Router();
+
+router.use("/webhook-events", requireAdminRoles(["admin", "operator"]));
+
+router.get(
+  "/webhook-events",
+  createJsonHandler(
+    (req) => getAdminWebhookEvents(req.query as AdminWebhookEventRouteQuery),
+    {
+      successMessage: "ok",
+      errorMessage: "读取 webhook 列表失败",
+      scope: "[admin-kuaishou/webhook-events]",
+    }
+  )
+);
+
+router.get(
+  "/webhook-events/:eventId",
+  createJsonHandler(
+    (req) =>
+      getAdminWebhookEventDetail(
+        (req.params as AdminWebhookEventRouteParams).eventId
+      ),
+    {
+      successMessage: "ok",
+      errorMessage: "读取 webhook 详情失败",
+      scope: "[admin-kuaishou/webhook-events/:eventId]",
+    }
+  )
+);
+
+router.post(
+  "/webhook-events/:eventId/replay",
+  requireAdminRoles(["admin"]),
+  createJsonHandler(
+    (req) =>
+      replayAdminWebhookEvent(
+        (req.params as AdminWebhookEventRouteParams).eventId
+      ),
+    {
+      successMessage: "Webhook 已重放",
+      errorMessage: "重放 webhook 失败",
+      scope: "[admin-kuaishou/webhook-events/:eventId/replay]",
+      audit: (req, data) => {
+        const result = data as AdminWebhookReplayResponse;
+
+        return {
+          action: "webhook_replayed",
+          targetType: "webhook_event",
+          targetId: String(
+            (req.params as AdminWebhookEventRouteParams).eventId
+          ),
+          data: {
+            eventId: result.eventId,
+            replayed: result.replayed,
+          },
+        };
+      },
+    }
+  )
+);
+
+export default router;
@@ -0,0 +1,71 @@
+import { Router } from "express";
+
+import {
+  confirmKuaishouCloudClaimRole,
+  getKuaishouCloudClaimDetail,
+  getKuaishouCloudClaimGuideAssetPath,
+  redeemKuaishouCloudClaim,
+  verifyKuaishouCloudClaimTicket,
+} from "../services/claim/kuaishou-cloud-claim-service.js";
+import {
+  buildNotFoundPayload,
+  createRouteFileHandler,
+  createRouteHandler,
+} from "../utils/http.js";
+
+const router = Router();
+
+router.get(
+  "/:token",
+  createRouteHandler((req) => getKuaishouCloudClaimDetail(req.params.token), {
+    errorMessage: "查询快手领取详情失败",
+    scope: "[claims-kuaishou/:token]",
+  })
+);
+
+router.post(
+  "/:token/kuaishou-cloud/verify-ticket",
+  createRouteHandler(
+    (req) => verifyKuaishouCloudClaimTicket(req.params.token, req.body),
+    {
+      successMessage: "核销码校验成功",
+      errorMessage: "校验核销码失败",
+      scope: "[claims-kuaishou/:token/kuaishou-cloud/verify-ticket]",
+    }
+  )
+);
+
+router.post(
+  "/:token/kuaishou-cloud/confirm-role",
+  createRouteHandler((req) => confirmKuaishouCloudClaimRole(req.params.token), {
+    successMessage: "角色已确认",
+    errorMessage: "确认角色失败",
+    scope: "[claims-kuaishou/:token/kuaishou-cloud/confirm-role]",
+  })
+);
+
+router.post(
+  "/:token/kuaishou-cloud/redeem",
+  createRouteHandler((req) => redeemKuaishouCloudClaim(req.params.token), {
+    successMessage: "兑换请求已提交",
+    errorMessage: "兑换失败",
+    scope: "[claims-kuaishou/:token/kuaishou-cloud/redeem]",
+  })
+);
+
+router.get(
+  "/assets/kuaishou-cloud/:filename",
+  createRouteFileHandler(
+    (req) => getKuaishouCloudClaimGuideAssetPath(req.params.filename),
+    {
+      errorMessage: "读取指引图片失败",
+      scope: "[claims-kuaishou/assets/kuaishou-cloud/:filename]",
+    }
+  )
+);
+
+router.use((req, res) => {
+  res.status(404).json(buildNotFoundPayload(req));
+});
+
+export default router;