refactor(collect): 移除旧补资料链接 token 体系

- 删除管理端生成补资料链接接口、链接仓储读写与 TTL 配置服务
- 删除补资料链接配置面板及前端相关服务、类型
- 新增迁移 113：删除 work_order_material_links 表与 work_order_material_link 配置
- 「复制补资料链接」改为本地复制 /supplement/<平台订单号>，不再请求后端

apps/backend/src/services/worker-platform/index.ts

@@ -65,4 +65,3 @@ export * from './worker-acceptance-config-service.js'
 export * from './sync-worker-orders-service.js'
 export * from './consignment-contact-service.js'
 export * from './work-order-material-link-service.js'
-export * from './worker-material-link-config-service.js'

apps/backend/src/services/worker-platform/work-order-material-link-service.test.ts

@@ -6,7 +6,6 @@ import {
   pickSubmittedMaterialFields,
   resolveMaterialResetBlockReason,
   resolvePublicMaterialOrderState,
-  resolveWorkOrderMaterialLinkOrderBlockReason,
 } from './work-order-material-link-service.js'
 
 test('公开补资料：只有待完善且未指派/无份额可提交', () => {
@@ -129,50 +128,7 @@ test('客服重置补资料：只允许待分配、未指派、无份额、未
   )
 })
 
-test('管理端链接准入：待完善/待分配可用，已指派/有份额/其他状态拒绝', () => {
-  assert.equal(
-    resolveWorkOrderMaterialLinkOrderBlockReason({
-      status: 'pending_material',
-      assigned_worker_id: null,
-      active_share_quantity: 0,
-    }),
-    '',
-  )
-  assert.equal(
-    resolveWorkOrderMaterialLinkOrderBlockReason({
-      status: 'unassigned',
-      assigned_worker_id: null,
-      active_share_quantity: 0,
-    }),
-    '',
-  )
-  assert.equal(
-    resolveWorkOrderMaterialLinkOrderBlockReason({
-      status: 'open',
-      assigned_worker_id: null,
-      active_share_quantity: 0,
-    }),
-    'status',
-  )
-  assert.equal(
-    resolveWorkOrderMaterialLinkOrderBlockReason({
-      status: 'pending_material',
-      assigned_worker_id: 9,
-      active_share_quantity: 0,
-    }),
-    'assigned',
-  )
-  assert.equal(
-    resolveWorkOrderMaterialLinkOrderBlockReason({
-      status: 'pending_material',
-      assigned_worker_id: null,
-      active_share_quantity: 2,
-    }),
-    'shares',
-  )
-})
-
-test('补资料链接：提交字段只保留 requirements 白名单，额外字段被丢弃', () => {
+test('公开补资料：提交字段只保留 requirements 白名单，额外字段被丢弃', () => {
   const result = pickSubmittedMaterialFields([{ key: 'gameId' }, { key: 'gameNickname' }], {
     gameId: '123',
     gameNickname: '张三',

apps/backend/src/services/worker-platform/work-order-material-link-service.ts

@@ -1,14 +1,9 @@
-import { randomBytes } from 'node:crypto'
-
 import { withTransaction } from '../../db/client.js'
 import { WORK_ORDER_STATUS } from '../../domain/work-order-status.js'
 import {
   createWorkOrderEventWithClient,
-  createWorkOrderMaterialLinkWithClient,
-  findActiveWorkOrderMaterialLinkWithClient,
   getWorkOrderForUpdateWithClient,
   listWorkOrdersByPlatformOrderId,
-  revokeActiveWorkOrderMaterialLinksWithClient,
   updateWorkOrderMaterialWithClient,
 } from '../../repositories/worker-platform/index.js'
 import type { WorkOrderRow } from '../../repositories/worker-platform/types.js'
@@ -21,20 +16,13 @@ import { resolveAdminNotificationEntity } from '../admin/admin-notification-serv
 import { publishWorkOrderRealtimeChange } from '../realtime/realtime-event-service.js'
 import {
   mapCollectLookupOrder,
-  mapWorkOrderAdmin,
   normalizeOptionalId,
   normalizeSubmittedFields,
   normalizeUploadedFiles,
   resolveRequirementFields,
 } from './mappers.js'
-import { getWorkerMaterialLinkConfig } from './worker-material-link-config-service.js'
 import { getRequiredWorkOrder } from './worker-session-context-service.js'
 
-const ALLOWED_MATERIAL_LINK_ORDER_STATUSES = new Set<string>([
-  WORK_ORDER_STATUS.PENDING_MATERIAL,
-  WORK_ORDER_STATUS.UNASSIGNED,
-])
-
 const MAX_MATERIAL_SCREENSHOTS = 5
 
 const PUBLIC_MATERIAL_STATUS_LABELS: Record<string, string> = {
@@ -49,8 +37,6 @@ const PUBLIC_MATERIAL_STATUS_LABELS: Record<string, string> = {
   vip_evidence_pending: '待补图',
 }
 
-export type WorkOrderMaterialLinkOrderBlockReason = 'status' | 'assigned' | 'shares' | ''
-
 export type PublicMaterialOrderBlockReason =
   | 'already_submitted'
   | 'status'
@@ -154,21 +140,6 @@ export function resolveMaterialResetBlockMessage(reason: MaterialResetBlockReaso
   return '只有待分配（未指派、无份额、未发布）的工单可以重置补资料状态'
 }
 
-/**
- * 管理端生成/复用一次性链接的准入判断。
- *
- * 用户要求保留现有“复制补资料链接”按钮，所以这里仍按原口径允许
- * 待完善 / 待分配，并拒绝已指派/有份额的工单。
- */
-export function resolveWorkOrderMaterialLinkOrderBlockReason(
-  order: Pick<WorkOrderRow, 'status' | 'assigned_worker_id' | 'active_share_quantity'>,
-): WorkOrderMaterialLinkOrderBlockReason {
-  if (!ALLOWED_MATERIAL_LINK_ORDER_STATUSES.has(order.status)) return 'status'
-  if (order.assigned_worker_id) return 'assigned'
-  if (Number(order.active_share_quantity || 0) > 0) return 'shares'
-  return ''
-}
-
 /**
  * 只保留工单 requirement 里定义过的字段。
  *
@@ -196,29 +167,6 @@ function throwPublicMaterialBlocked(state: PublicMaterialOrderState): never {
   })
 }
 
-/** 管理端生成补资料链接时仍沿用旧的准入文案。 */
-function assertWorkOrderAllowedForMaterialLink(order: WorkOrderRow): void {
-  const reason = resolveWorkOrderMaterialLinkOrderBlockReason(order)
-  if (reason === 'status') {
-    throw createHttpError('当前状态不能生成补资料链接', {
-      statusCode: 409,
-      errorCode: 'material_link_status_invalid',
-    })
-  }
-  if (reason === 'assigned') {
-    throw createHttpError('订单已指派打手，不能生成补资料链接', {
-      statusCode: 409,
-      errorCode: 'material_link_status_invalid',
-    })
-  }
-  if (reason === 'shares') {
-    throw createHttpError('订单已有拼单份额，不能生成补资料链接', {
-      statusCode: 409,
-      errorCode: 'material_link_status_invalid',
-    })
-  }
-}
-
 function mapPublicOrder(order: WorkOrderRow) {
   return {
     workOrderNo: order.work_order_no,
@@ -228,12 +176,6 @@ function mapPublicOrder(order: WorkOrderRow) {
   }
 }
 
-/** PostgreSQL 返回的 timestamptz 可能是 "YYYY-MM-DD HH:mm:ss" 字符串，统一转 ISO。 */
-function toIsoTimestamp(value: string): string {
-  const date = new Date(value)
-  return Number.isNaN(date.getTime()) ? String(value || '') : date.toISOString()
-}
-
 function mapPublicMaterialOrder(order: WorkOrderRow) {
   const state = resolvePublicMaterialOrderState(order)
   const base = {
@@ -290,76 +232,6 @@ async function resolvePublicMaterialTarget(
   return orders[0]!
 }
 
-/**
- * 管理端生成/复用一次性链接。
- *
- * 用户要求保留现有“复制补资料链接”按钮，因此链接记录仍会生成；
- * 但公开页已经不再依赖它，复制出的 `/supplement/<平台订单号>` 始终可用。
- */
-export async function createAdminWorkOrderMaterialLink(
-  workOrderId: number | string,
-  actorName = '',
-) {
-  const { ttlMinutes } = getWorkerMaterialLinkConfig()
-
-  return withTransaction(async (client) => {
-    const order = await getWorkOrderForUpdateWithClient(client, workOrderId)
-    if (!order) {
-      throw createHttpError('接单订单不存在', {
-        statusCode: 404,
-        errorCode: 'work_order_not_found',
-      })
-    }
-
-    if (!mapWorkOrderAdmin(order).capabilities.canUpdateMaterial) {
-      throw createHttpError('当前状态不能生成补资料链接', {
-        statusCode: 409,
-        errorCode: 'material_link_status_invalid',
-      })
-    }
-
-    const platformOrderId = String(order.platform_order_id || '').trim()
-    if (!platformOrderId) {
-      throw createHttpError('该工单没有平台订单号，不能生成补资料链接', {
-        statusCode: 409,
-        errorCode: 'material_link_platform_order_missing',
-      })
-    }
-
-    assertWorkOrderAllowedForMaterialLink(order)
-
-    // 锁到手后再取时间，避免等锁期间旧链接过期却仍按旧时间复用。
-    const now = nowIso()
-    const existing = await findActiveWorkOrderMaterialLinkWithClient(client, order.id, now)
-    if (existing) {
-      return {
-        token: existing.token,
-        platformOrderId,
-        expiresAt: toIsoTimestamp(existing.expires_at),
-        reused: true,
-      }
-    }
-
-    await revokeActiveWorkOrderMaterialLinksWithClient(client, order.id, now)
-    const token = randomBytes(24).toString('base64url')
-    const expiresAt = new Date(Date.now() + ttlMinutes * 60 * 1000).toISOString()
-    const link = await createWorkOrderMaterialLinkWithClient(client, {
-      workOrderId: order.id,
-      token,
-      expiresAt,
-      createdBy: String(actorName || '').trim(),
-      now,
-    })
-
-    return {
-      token: link.token,
-      platformOrderId,
-      expiresAt: toIsoTimestamp(link.expires_at),
-      reused: false,
-    }
-  })
-}
-
 /**
  * 公开页按平台订单号读取补资料内容。
  *

apps/backend/src/services/worker-platform/worker-material-link-config-service.test.ts

@@ -1,41 +0,0 @@
-import assert from 'node:assert/strict'
-import test from 'node:test'
-
-import {
-  createDefaultWorkerMaterialLinkConfig,
-  normalizeWorkerMaterialLinkConfig,
-  WORK_ORDER_MATERIAL_LINK_DEFAULT_TTL_MINUTES,
-  WORK_ORDER_MATERIAL_LINK_MAX_TTL_MINUTES,
-  WORK_ORDER_MATERIAL_LINK_MIN_TTL_MINUTES,
-} from './worker-material-link-config-service.js'
-
-test('补资料链接配置：默认 30 分钟', () => {
-  assert.deepEqual(createDefaultWorkerMaterialLinkConfig(), {
-    ttlMinutes: WORK_ORDER_MATERIAL_LINK_DEFAULT_TTL_MINUTES,
-  })
-  assert.equal(WORK_ORDER_MATERIAL_LINK_DEFAULT_TTL_MINUTES, 30)
-  assert.deepEqual(normalizeWorkerMaterialLinkConfig(undefined), { ttlMinutes: 30 })
-})
-
-test('补资料链接配置：接受 ttlMinutes / ttl_minutes / 数字字符串', () => {
-  assert.deepEqual(normalizeWorkerMaterialLinkConfig({ ttlMinutes: 45 }), { ttlMinutes: 45 })
-  assert.deepEqual(normalizeWorkerMaterialLinkConfig({ ttl_minutes: '10' }), { ttlMinutes: 10 })
-  assert.deepEqual(normalizeWorkerMaterialLinkConfig({ ttlMinutes: 90.4 }), { ttlMinutes: 90 })
-})
-
-test('补资料链接配置：越界值收敛到 1 - 10080 分钟', () => {
-  assert.deepEqual(normalizeWorkerMaterialLinkConfig({ ttlMinutes: 0 }), {
-    ttlMinutes: WORK_ORDER_MATERIAL_LINK_MIN_TTL_MINUTES,
-  })
-  assert.deepEqual(normalizeWorkerMaterialLinkConfig({ ttlMinutes: -5 }), { ttlMinutes: 1 })
-  assert.deepEqual(normalizeWorkerMaterialLinkConfig({ ttlMinutes: 999999 }), {
-    ttlMinutes: WORK_ORDER_MATERIAL_LINK_MAX_TTL_MINUTES,
-  })
-  assert.equal(WORK_ORDER_MATERIAL_LINK_MAX_TTL_MINUTES, 10080)
-})
-
-test('补资料链接配置：非法输入回退默认值，不会写入 NaN', () => {
-  assert.deepEqual(normalizeWorkerMaterialLinkConfig({ ttlMinutes: 'abc' }), { ttlMinutes: 30 })
-  assert.deepEqual(normalizeWorkerMaterialLinkConfig({ ttlMinutes: null }), { ttlMinutes: 30 })
-  assert.deepEqual(normalizeWorkerMaterialLinkConfig('not-an-object'), { ttlMinutes: 30 })
-})

apps/backend/src/services/worker-platform/worker-material-link-config-service.ts

@@ -1,62 +0,0 @@
-import { APP_CONFIG_KEYS } from '../../config/app-config-keys.js'
-import type { JsonObject } from '../../types/json.js'
-import { readAppConfigEntry, saveAppConfigEntry } from '../config/app-config-store.js'
-
-/** 补资料链接默认有效期（分钟）：30 分钟。 */
-export const WORK_ORDER_MATERIAL_LINK_DEFAULT_TTL_MINUTES = 30
-/** 允许配置的最短有效期（分钟）。 */
-export const WORK_ORDER_MATERIAL_LINK_MIN_TTL_MINUTES = 1
-/** 允许配置的最长有效期（分钟）：7 天。 */
-export const WORK_ORDER_MATERIAL_LINK_MAX_TTL_MINUTES = 7 * 24 * 60
-
-export type WorkerMaterialLinkConfig = {
-  /** 新生成的补资料链接有效期，单位分钟。 */
-  ttlMinutes: number
-}
-
-/** 读取配置（内存缓存），未配置时返回默认 30 分钟。 */
-export function getWorkerMaterialLinkConfig(): WorkerMaterialLinkConfig {
-  return readAppConfigEntry({
-    configKey: APP_CONFIG_KEYS.workOrderMaterialLink,
-    fallback: createDefaultWorkerMaterialLinkConfig,
-    normalize: normalizeWorkerMaterialLinkConfig,
-  })
-}
-
-export async function saveWorkerMaterialLinkConfig(
-  rawValue: unknown,
-): Promise<WorkerMaterialLinkConfig> {
-  return saveAppConfigEntry({
-    configKey: APP_CONFIG_KEYS.workOrderMaterialLink,
-    value: rawValue,
-    normalize: normalizeWorkerMaterialLinkConfig,
-  })
-}
-
-export function createDefaultWorkerMaterialLinkConfig(): WorkerMaterialLinkConfig {
-  return { ttlMinutes: WORK_ORDER_MATERIAL_LINK_DEFAULT_TTL_MINUTES }
-}
-
-export function normalizeWorkerMaterialLinkConfig(rawValue: unknown): WorkerMaterialLinkConfig {
-  const source = isPlainObject(rawValue) ? rawValue : {}
-  const raw = source.ttlMinutes ?? source.ttl_minutes
-  if (raw === undefined || raw === null || raw === '') {
-    return createDefaultWorkerMaterialLinkConfig()
-  }
-
-  const value = Number(raw)
-  if (!Number.isFinite(value)) {
-    return createDefaultWorkerMaterialLinkConfig()
-  }
-
-  return {
-    ttlMinutes: Math.min(
-      WORK_ORDER_MATERIAL_LINK_MAX_TTL_MINUTES,
-      Math.max(WORK_ORDER_MATERIAL_LINK_MIN_TTL_MINUTES, Math.round(value)),
-    ),
-  }
-}
-
-function isPlainObject(value: unknown): value is JsonObject {
-  return Object.prototype.toString.call(value) === '[object Object]'
-}