优化后端目录命名与模块归位

apps/backend/src/routes/admin.ts

@@ -5,7 +5,7 @@ import auditLogsRouter from "./admin/audit-logs.js";
 import dashboardRouter from "./admin/dashboard.js";
 import ordersRouter from "./admin/orders.js";
 import platformConfigRouter from "./admin/platform-config.js";
-import { requireAdminSession } from "./admin/shared.js";
+import { requireAdminSession } from "./admin/session.js";
 import tasksRouter from "./admin/tasks.js";
 import usersRouter from "./admin/users.js";
 import { buildNotFoundPayload } from "../utils/http.js";

apps/backend/src/routes/admin/audit-logs.ts

@@ -1,7 +1,7 @@
 import { Router } from 'express'
 
 import { getAdminAuditLogs } from '../../services/admin/admin-audit-service.js'
-import { createJsonHandler, requireAdminRoles } from './shared.js'
+import { createJsonHandler, requireAdminRoles } from './session.js'
 
 type AdminAuditLogRouteQuery = Record<string, any>
 

apps/backend/src/routes/admin/auth.ts

@@ -2,7 +2,7 @@ import { Router } from 'express'
 
 import { createRateLimitMiddleware, getBodyFieldRateLimitKey } from '../../middleware/rate-limit.js'
 import { getAdminSessionSummary, loginAdmin } from '../../services/admin/admin-auth-service.js'
-import { createJsonHandler, extractBearerToken } from './shared.js'
+import { createJsonHandler, extractBearerToken } from './session.js'
 
 const router = Router()
 

apps/backend/src/routes/admin/dashboard.ts

@@ -1,7 +1,7 @@
 import { Router } from 'express'
 
 import { getAdminDashboardSummary } from '../../services/admin/admin-dashboard-service.js'
-import { createJsonHandler } from './shared.js'
+import { createJsonHandler } from './session.js'
 
 const router = Router()
 

apps/backend/src/routes/admin/orders.ts

@@ -1,7 +1,7 @@
 import { Router } from 'express'
 
 import { getAdminOrderDetail, getAdminOrders } from '../../services/admin/admin-read-service.js'
-import { createJsonHandler } from './shared.js'
+import { createJsonHandler } from './session.js'
 import type {
   AdminOrderRouteParams,
   AdminOrderRouteQuery,

apps/backend/src/routes/admin/platform-config.ts

@@ -1,6 +1,6 @@
 import { Router } from "express";
 
-import { requireAdminRoles } from "./shared.js";
+import { requireAdminRoles } from "./session.js";
 import cloudtentaclesRouter from "./platform-config/cloudtentacles.js";
 import kuaishouCloudFulfillmentRouter from "./platform-config/kuaishou-cloud-fulfillment.js";
 import kuaishouEticketRouter from "./platform-config/kuaishou-eticket.js";

apps/backend/src/routes/admin/platform-config/cloudtentacles.ts

@@ -33,8 +33,8 @@ import type {
   AdminCloudtentaclesValidateSessionRouteBody,
   AdminCloudtentaclesVirtualNumberRouteBody,
 } from "../../../types/admin-route-inputs.js";
-import { createJsonHandler } from "../shared.js";
+import { createJsonHandler } from "../session.js";
-import type { JsonRecord } from "./shared.js";
+import type { JsonRecord } from "../../../types/json.js";
 
 const router = Router();
 

apps/backend/src/routes/admin/platform-config/kuaishou-cloud-fulfillment.ts

@@ -5,8 +5,8 @@ import {
   updateAdminKuaishouCloudFulfillmentConfig,
 } from "../../../services/admin/platform-config/kuaishou-cloud-fulfillment-service.js";
 import type { AdminKuaishouCloudFulfillmentConfigRouteBody } from "../../../types/admin-route-inputs.js";
-import { createJsonHandler } from "../shared.js";
+import { createJsonHandler } from "../session.js";
-import type { JsonRecord } from "./shared.js";
+import type { JsonRecord } from "../../../types/json.js";
 
 const router = Router();
 

apps/backend/src/routes/admin/platform-config/kuaishou-eticket.ts

@@ -13,8 +13,8 @@ import type {
   AdminKuaishouEticketShopInfoRouteBody,
   AdminKuaishouEticketSourceConfigRouteBody,
 } from "../../../types/admin-route-inputs.js";
-import { createJsonHandler } from "../shared.js";
+import { createJsonHandler } from "../session.js";
-import type { JsonRecord } from "./shared.js";
+import type { JsonRecord } from "../../../types/json.js";
 
 const router = Router();
 

apps/backend/src/routes/admin/platform-config/ninetyone.ts

@@ -6,8 +6,8 @@ import {
   retryAdminNinetyoneOrder,
 } from "../../../services/admin/platform-config/ninetyone-service.js";
 import type { AdminEntityRouteParams } from "../../../types/admin-route-inputs.js";
-import { createJsonHandler } from "../shared.js";
+import { createJsonHandler } from "../session.js";
-import type { JsonRecord } from "./shared.js";
+import type { JsonRecord } from "../../../types/json.js";
 
 const router = Router();
 

apps/backend/src/routes/admin/platform-config/notifications.ts

@@ -14,8 +14,8 @@ import type {
   AdminNotificationTestRouteBody,
   AdminScheduledJobsConfigRouteBody,
 } from "../../../types/admin-route-inputs.js";
-import { createJsonHandler } from "../shared.js";
+import { createJsonHandler } from "../session.js";
-import type { JsonRecord } from "./shared.js";
+import type { JsonRecord } from "../../../types/json.js";
 
 const router = Router();
 

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

@@ -14,7 +14,7 @@ import {
 import {
   createJsonHandler,
   requireAdminRoles,
-} from "./shared.js";
+} from "./session.js";
 import type {
   AdminTaskKuaishouCloudDispatchRouteBody,
   AdminTaskRouteParams,

apps/backend/src/routes/admin/users.ts

@@ -7,7 +7,7 @@ import {
   updateManagedAdminUserRole,
   updateManagedAdminUserStatus,
 } from '../../services/admin/admin-auth-service.js'
-import { createJsonHandler, getRequiredAdminSession, requireAdminRoles } from './shared.js'
+import { createJsonHandler, getRequiredAdminSession, requireAdminRoles } from './session.js'
 
 type AdminUserMutationResult = {
   user: {

apps/backend/src/services/admin/write-helpers.ts

@@ -1,10 +1,10 @@
-import { buildClaimUrl, createTaskClaimToken } from '../../claim/claim-service.js'
+import { buildClaimUrl, createTaskClaimToken } from '../claim/claim-service.js'
 import {
   maskCode as maskCodeValue,
   maskPhone as maskPhoneValue,
-} from '../../../utils/masking.js'
+} from '../../utils/masking.js'
 
-import type { TaskRow } from '../../../types/repository-rows.js'
+import type { TaskRow } from '../../types/repository-rows.js'
 
 type TaskClaimLink = {
   token: string

apps/backend/src/services/admin/write/kuaishou-cloud-actions.ts

@@ -32,7 +32,7 @@ import {
   getTaskClaimExpiresAt,
   maskCode,
   maskPhone,
-} from './shared.js'
+} from '../write-helpers.js'
 import {
   isKuaishouCloudTask,
   normalizeKuaishouCloudFlow,

apps/backend/src/services/claim/kuaishou-cloud-claim-service.ts

@@ -17,7 +17,7 @@ import {
   normalizeKuaishouCloudFlow,
   prepareKuaishouCloudFulfillmentTask,
   refreshKuaishouCloudTaskRoleInfo,
-} from '../fulfillment/kuaishou-cloud-task-service.js'
+} from '../fulfillment/kuaishou-cloud/index.js'
 import { buildClaimDetailPayload, getClaimContext } from './kuaishou-cloud-claim-context.js'
 import { syncKuaishouCloudRoleInfo } from './kuaishou-cloud-sync-service.js'
 import type { TaskRow } from '../../types/repository-rows.js'

apps/backend/src/services/claim/kuaishou-cloud-sync-service.ts

@@ -3,7 +3,7 @@ import {
   prepareKuaishouCloudFulfillmentTask,
   probeKuaishouCloudTaskBindUrl,
   refreshKuaishouCloudTaskRoleInfo,
-} from '../fulfillment/kuaishou-cloud-task-service.js'
+} from '../fulfillment/kuaishou-cloud/index.js'
 import type { TaskRow } from '../../types/repository-rows.js'
 
 export async function syncKuaishouCloudRoleInfo(task: TaskRow) {

apps/backend/src/services/fulfillment/kuaishou-cloud/domain.ts

@@ -1,4 +1,4 @@
-import { resolveCloudtentaclesConfig } from "../../platforms/cloudtentacles/shared.js";
+import { resolveCloudtentaclesConfig } from "../../platforms/cloudtentacles/helpers.js";
 import {
   maskCode as maskCodeValue,
   maskPhone as maskPhoneValue,

apps/backend/src/services/fulfillment/kuaishou-cloud/index.ts

@@ -1,24 +1,24 @@
-import { createTaskEvent } from "../../repositories/task-event-repo.js";
+import { createTaskEvent } from "../../../repositories/task-event-repo.js";
-import { updateTask } from "../../repositories/task-repo.js";
+import { updateTask } from "../../../repositories/task-repo.js";
-import { buildClaimUrl, createTaskClaimToken } from "../claim/claim-service.js";
+import { buildClaimUrl, createTaskClaimToken } from "../../claim/claim-service.js";
 import {
   buyCloudtentaclesSku,
   getCloudtentaclesAsset,
   listCloudtentaclesSku,
-} from "../platforms/cloudtentacles/catalog-service.js";
+} from "../../platforms/cloudtentacles/catalog-service.js";
-import { getCloudtentaclesKnapsack } from "../platforms/cloudtentacles/knapsack-service.js";
+import { getCloudtentaclesKnapsack } from "../../platforms/cloudtentacles/knapsack-service.js";
 import {
   backCloudtentaclesVirtualNumber,
   getCloudtentaclesBindInfo,
   probeCloudtentaclesBindUrl,
-} from "../platforms/cloudtentacles/virtual-number-service.js";
+} from "../../platforms/cloudtentacles/virtual-number-service.js";
-import { resolveCloudtentaclesConfig } from "../platforms/cloudtentacles/shared.js";
+import { resolveCloudtentaclesConfig } from "../../platforms/cloudtentacles/helpers.js";
 import {
   notifyKuaishouCloudAssetNotEnough,
   notifyKuaishouCloudBindUrlRefreshFailed,
-} from "../notification/domain-notifications.js";
+} from "../../notification/domain-notifications.js";
-import { createHttpError } from "../../utils/http.js";
+import { createHttpError } from "../../../utils/http.js";
-import { nowIso } from "../../utils/time.js";
+import { nowIso } from "../../../utils/time.js";
 import {
   KUAISHOU_CLOUD_FIXED_VN_KEY,
   isKuaishouCloudBindUrlFresh,
@@ -28,22 +28,22 @@ import {
   normalizeKuaishouCloudRoleInfo,
   resolveKuaishouCloudBindUrlExpiresAt,
   type JsonObject,
-} from "./kuaishou-cloud/domain.js";
+} from "./domain.js";
 import {
   prepareKuaishouCloudBindResourceWithFallback,
   resolveKuaishouCloudBindingResources,
   resolveKuaishouCloudVnKeyCandidates,
-} from "./kuaishou-cloud/binding-resources.js";
+} from "./binding-resources.js";
 import {
   resolvePersistedCloudtentaclesContextWithFallback,
-} from "./kuaishou-cloud/cloudtentacles-context.js";
+} from "./cloudtentacles-context.js";
 import {
   getTaskClaimExpiresAt,
   isClaimExpired,
   normalizeActor,
   parseTaskContext,
-} from "./kuaishou-cloud/task-context.js";
+} from "./task-context.js";
-import type { TaskRow } from "../../types/repository-rows.js";
+import type { TaskRow } from "../../../types/repository-rows.js";
 
 export {
   isKuaishouCloudBindUrlFresh,
@@ -53,11 +53,11 @@ export {
   normalizeKuaishouCloudFlow,
   normalizeKuaishouCloudRoleInfo,
   resolveKuaishouCloudBindUrlExpiresAt,
-} from "./kuaishou-cloud/domain.js";
+} from "./domain.js";
 export {
   resolvePersistedCloudtentaclesContext,
   resolvePersistedCloudtentaclesContextWithFallback,
-} from "./kuaishou-cloud/cloudtentacles-context.js";
+} from "./cloudtentacles-context.js";
 
 export async function ensureTaskClaimLink(task: TaskRow) {
   const tokenStatus = String(task?.primary_claim_token_status || "").trim();
@@ -775,4 +775,4 @@ export async function refreshKuaishouCloudTaskRoleInfo(
 export {
   dispatchKuaishouCloudFulfillmentTask,
   returnKuaishouCloudFulfillmentTask,
-} from "./kuaishou-cloud/task-finalization.js";
+} from "./task-finalization.js";

apps/backend/src/services/open-91/order-query-service.ts

@@ -1,7 +1,7 @@
 import { findOrderByPlatformOrderId } from '../../repositories/order-repo.js'
 import { listTasksByOrderId } from '../../repositories/task-repo.js'
 import { buildClaimUrl } from '../claim/claim-service.js'
-import { ensureTaskClaimLink } from '../fulfillment/kuaishou-cloud-task-service.js'
+import { ensureTaskClaimLink } from '../fulfillment/kuaishou-cloud/index.js'
 import { logIntegration } from '../../utils/logger.js'
 import {
   OPEN_91_MANUAL_FAILED_STATUS,

apps/backend/src/services/platforms/cloudtentacles/catalog-service.ts

@@ -1,6 +1,6 @@
 import { createHttpError } from '../../../utils/http.js'
 import { cloudtentaclesRequest } from './http-client.js'
-import { resolveCloudtentaclesConfig } from './shared.js'
+import { resolveCloudtentaclesConfig } from './helpers.js'
 
 type JsonObject = Record<string, any>
 

apps/backend/src/services/platforms/cloudtentacles/crypto-service.ts

@@ -1,7 +1,7 @@
 import { createHash, constants, publicEncrypt } from 'node:crypto'
 
 import { createHttpError } from '../../../utils/http.js'
-import { resolveCloudtentaclesConfig } from './shared.js'
+import { resolveCloudtentaclesConfig } from './helpers.js'
 
 type JsonObject = Record<string, any>
 

apps/backend/src/services/platforms/cloudtentacles/http-client.ts

@@ -4,7 +4,7 @@ import https from 'node:https'
 import { createHttpError } from '../../../utils/http.js'
 import { logInfo } from '../../../utils/logger.js'
 import { notifyCloudtentaclesAuthExpired } from '../../notification/domain-notifications.js'
-import { buildCloudtentaclesHeaders, buildCloudtentaclesUrl, resolveCloudtentaclesConfig } from './shared.js'
+import { buildCloudtentaclesHeaders, buildCloudtentaclesUrl, resolveCloudtentaclesConfig } from './helpers.js'
 
 type JsonObject = Record<string, any>
 type HeaderAdapter = {

apps/backend/src/services/platforms/cloudtentacles/knapsack-service.ts

@@ -1,6 +1,6 @@
 import { createHttpError } from '../../../utils/http.js'
 import { cloudtentaclesRequest } from './http-client.js'
-import { resolveCloudtentaclesConfig } from './shared.js'
+import { resolveCloudtentaclesConfig } from './helpers.js'
 
 type JsonObject = Record<string, any>
 

apps/backend/src/services/platforms/cloudtentacles/session-service.ts

@@ -2,7 +2,7 @@ import { createHttpError } from '../../../utils/http.js'
 import { logInfo } from '../../../utils/logger.js'
 import { encryptCloudtentaclesPayload, md5CloudtentaclesPassword } from './crypto-service.js'
 import { cloudtentaclesRequest } from './http-client.js'
-import { resolveCloudtentaclesConfig } from './shared.js'
+import { resolveCloudtentaclesConfig } from './helpers.js'
 
 type JsonObject = Record<string, any>
 

apps/backend/src/services/platforms/cloudtentacles/virtual-number-service.ts

@@ -3,7 +3,7 @@ import https from 'node:https'
 
 import { createHttpError } from '../../../utils/http.js'
 import { cloudtentaclesRequest } from './http-client.js'
-import { resolveCloudtentaclesConfig } from './shared.js'
+import { resolveCloudtentaclesConfig } from './helpers.js'
 
 const BIND_URL_PROBE_MAX_BODY_BYTES = 64 * 1024
 const AMS_SIGNATURE_EXPIRED_CODE = '99998'

apps/backend/src/services/platforms/kuaishou-eticket/consume-service.ts

@@ -1,6 +1,6 @@
 import { createHttpError } from '../../../utils/http.js'
 import { kuaishouEticketRequest } from './http-client.js'
-import { resolveKuaishouEticketConfig } from './shared.js'
+import { resolveKuaishouEticketConfig } from './helpers.js'
 
 type JsonObject = Record<string, any>
 

apps/backend/src/services/platforms/kuaishou-eticket/http-client.ts

@@ -5,7 +5,7 @@ import type { IncomingHttpHeaders } from 'node:http'
 import { parseJsonObject } from '../../../utils/json.js'
 import { createHttpError } from '../../../utils/http.js'
 import { logInfo } from '../../../utils/logger.js'
-import { buildKuaishouEticketHeaders, buildKuaishouEticketUrl, resolveKuaishouEticketConfig } from './shared.js'
+import { buildKuaishouEticketHeaders, buildKuaishouEticketUrl, resolveKuaishouEticketConfig } from './helpers.js'
 
 type JsonObject = Record<string, any>
 

apps/backend/src/services/platforms/kuaishou-eticket/info-service.ts

@@ -1,6 +1,6 @@
 import { createHttpError } from '../../../utils/http.js'
 import { kuaishouEticketRequest } from './http-client.js'
-import { resolveKuaishouEticketConfig } from './shared.js'
+import { resolveKuaishouEticketConfig } from './helpers.js'
 
 type JsonObject = Record<string, any>
 

apps/frontend/src/services/admin.ts

@@ -1 +0,0 @@
-export * from './admin/index'