From f76b9c452dcf5d2f7c4f2f8028371db937ced52d Mon Sep 17 00:00:00 2001 From: yml Date: Wed, 18 Nov 2026 14:35:15 +0800 Subject: [PATCH] =?UTF-8?q?=E9=87=8D=E6=9E=84(=E5=8D=8A=E8=87=AA=E5=8A=A8?= =?UTF-8?q?=E5=B1=A5=E7=BA=A6):=20=E6=94=B6=E6=95=9B=E7=8A=B6=E6=80=81?= =?UTF-8?q?=E5=90=8C=E6=AD=A5=E5=B9=B6=E6=8B=86=E5=88=86=E4=BB=BB=E5=8A=A1?= =?UTF-8?q?=E6=9C=8D=E5=8A=A1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .env.mac-docker.example | 1 + .env.server.example | 1 + README.md | 1 + apps/backend/src/config/defaults.ts | 1 + apps/backend/src/config/env-overrides.ts | 1 + apps/backend/src/config/runtime-validation.ts | 3 + .../platform-fulfillment-integration.ts | 43 + .../semi-auto/huya-connector-client.ts | 2 + .../semi-auto/semi-auto-admin-service.ts | 898 ++++++ .../semi-auto/semi-auto-customer-service.ts | 1048 +++++++ .../services/semi-auto/semi-auto-task-core.ts | 1085 +++++++ .../semi-auto/semi-auto-task-reconciler.ts | 53 + .../semi-auto/semi-auto-task-service.ts | 2533 +---------------- .../semi-auto-task.integration.test.ts | 67 + .../semi-auto/semi-auto-trace.test.ts | 31 + .../src/services/semi-auto/semi-auto-trace.ts | 31 +- apps/backend/src/startup/bootstrap.ts | 2 + apps/backend/src/startup/shutdown.ts | 2 + apps/backend/src/types/runtime-config.ts | 1 + apps/frontend/src/layouts/AdminLayout.tsx | 4 + .../pages/admin/AdminSemiAutoTasksPage.tsx | 3 +- .../CustomerFulfillmentPage.tsx | 50 +- apps/frontend/src/types/admin/semi-auto.ts | 2 + .../src/types/customer-fulfillment.ts | 7 +- ...stomer-fulfillment-binding-compare.test.ts | 21 +- .../tests/semi-auto-sync-flow.test.ts | 20 + docker-compose.dev.yml | 1 + docker-compose.yml | 1 + docs/统一订单履约与财务模型-权威版.md | 19 +- 29 files changed, 3362 insertions(+), 2570 deletions(-) create mode 100644 apps/backend/src/services/semi-auto/semi-auto-admin-service.ts create mode 100644 apps/backend/src/services/semi-auto/semi-auto-customer-service.ts create mode 100644 apps/backend/src/services/semi-auto/semi-auto-task-core.ts create mode 100644 apps/backend/src/services/semi-auto/semi-auto-task-reconciler.ts create mode 100644 apps/backend/src/services/semi-auto/semi-auto-trace.test.ts create mode 100644 apps/frontend/tests/semi-auto-sync-flow.test.ts diff --git a/.env.mac-docker.example b/.env.mac-docker.example index 9cc52528..89acdd44 100644 --- a/.env.mac-docker.example +++ b/.env.mac-docker.example @@ -81,6 +81,7 @@ SEMI_AUTO_DEFAULT_CONNECTOR_MODE=embedded SEMI_AUTO_CONNECTOR_BASE_URL= SEMI_AUTO_CONNECTOR_API_KEY= SEMI_AUTO_CONNECTOR_TIMEOUT_MS=15000 +SEMI_AUTO_RECONCILE_SECONDS=900 # 快手行业电子凭证 KUASHOU_INDUSTRY_APP_KEY= diff --git a/.env.server.example b/.env.server.example index f339efdc..00fb6185 100644 --- a/.env.server.example +++ b/.env.server.example @@ -149,6 +149,7 @@ SEMI_AUTO_CONNECTOR_BASE_URL= SEMI_AUTO_CONNECTOR_API_KEY= SEMI_AUTO_DEFAULT_CONNECTOR_MODE=embedded SEMI_AUTO_CONNECTOR_TIMEOUT_MS=15000 +SEMI_AUTO_RECONCILE_SECONDS=900 # 快手行业电子凭证 KUASHOU_INDUSTRY_APP_KEY= diff --git a/README.md b/README.md index d5dd1b71..7f95559d 100644 --- a/README.md +++ b/README.md @@ -196,6 +196,7 @@ cp .env.server.example .env | `SEMI_AUTO_CONNECTOR_API_KEY` | 使用远程 Connector 时的内部鉴权密钥 | | `SEMI_AUTO_DEFAULT_CONNECTOR_MODE` | 新任务默认 Connector:`embedded` / `external` / `mock`,默认 `embedded` | | `SEMI_AUTO_CONNECTOR_TIMEOUT_MS` | Connector 请求超时,默认 15000 毫秒 | +| `SEMI_AUTO_RECONCILE_SECONDS` | 半自动任务低频兜底对账间隔,默认 900 秒 | ### 本地半自动履约测试 diff --git a/apps/backend/src/config/defaults.ts b/apps/backend/src/config/defaults.ts index 106aa968..16a1ef11 100644 --- a/apps/backend/src/config/defaults.ts +++ b/apps/backend/src/config/defaults.ts @@ -66,6 +66,7 @@ export function createDefaultRuntimeConfig(projectRoot: string): RuntimeConfig { connectorBaseUrl: '', connectorApiKey: '', connectorTimeoutMs: 15_000, + reconcileSeconds: 900, huya: { bindActId: 9271, outerActId: '17096', diff --git a/apps/backend/src/config/env-overrides.ts b/apps/backend/src/config/env-overrides.ts index 29c17b9c..59eb9c7d 100644 --- a/apps/backend/src/config/env-overrides.ts +++ b/apps/backend/src/config/env-overrides.ts @@ -54,6 +54,7 @@ export const ENV_OVERRIDES: readonly EnvOverride[] = [ stringEnv('SEMI_AUTO_CONNECTOR_BASE_URL', ['semiAuto', 'connectorBaseUrl']), stringEnv('SEMI_AUTO_CONNECTOR_API_KEY', ['semiAuto', 'connectorApiKey']), integerEnv('SEMI_AUTO_CONNECTOR_TIMEOUT_MS', ['semiAuto', 'connectorTimeoutMs']), + integerEnv('SEMI_AUTO_RECONCILE_SECONDS', ['semiAuto', 'reconcileSeconds']), stringEnv('SEMI_AUTO_DEFAULT_CONNECTOR_MODE', ['semiAuto', 'defaultConnectorMode']), integerEnv('HUYA_BIND_ACT_ID', ['semiAuto', 'huya', 'bindActId']), stringEnv('HUYA_OUTER_ACT_ID', ['semiAuto', 'huya', 'outerActId']), diff --git a/apps/backend/src/config/runtime-validation.ts b/apps/backend/src/config/runtime-validation.ts index e6ea59cd..21539204 100644 --- a/apps/backend/src/config/runtime-validation.ts +++ b/apps/backend/src/config/runtime-validation.ts @@ -91,6 +91,9 @@ export function validateRuntimeConfig( config.semiAuto?.connectorTimeoutMs, { min: 1 }, ) + requireOptionalInteger(issues, 'semiAuto.reconcileSeconds', config.semiAuto?.reconcileSeconds, { + min: 60, + }) requireInteger(issues, 'storage.maxUploadSizeMb', config.storage?.maxUploadSizeMb, { min: 1, max: 100, diff --git a/apps/backend/src/routes/platform-fulfillment-integration.ts b/apps/backend/src/routes/platform-fulfillment-integration.ts index b3c9772c..ce6bb364 100644 --- a/apps/backend/src/routes/platform-fulfillment-integration.ts +++ b/apps/backend/src/routes/platform-fulfillment-integration.ts @@ -3,6 +3,7 @@ import { timingSafeEqual } from 'node:crypto' import { Router } from 'express' import { applyLiveBindingStateSnapshot } from '../services/douyu-fulfillment/douyu-fulfillment-service.js' +import { applySemiAutoTaskStateSnapshot } from '../services/semi-auto/semi-auto-task-service.js' import { verifyWebhookSignature, webhookToleranceSeconds, @@ -85,4 +86,46 @@ router.post( ), ) +router.post( + '/platform-fulfillment/semi-auto/task-state', + createRouteHandler( + (req) => { + const integrationKey = String(process.env.PLATFORM_FULFILLMENT_INTEGRATION_KEY || '').trim() + const eventId = String(req.header('x-integration-event-id') || '').trim() + const timestamp = String(req.header('x-integration-timestamp') || '').trim() + const signature = String(req.header('x-integration-signature') || '').trim() + const body = req.body as Record | undefined + if ( + !verifyWebhookSignature({ + secret: integrationKey, + timestamp, + rawBody: req.rawBody || '', + signature, + toleranceSeconds: webhookToleranceSeconds(), + }) + ) { + throw createHttpError('半自动履约 Webhook 签名无效', { + statusCode: 401, + errorCode: 'integration_signature_invalid', + }) + } + if (!body || String(body.eventId || '').trim() !== eventId) { + throw createHttpError('半自动履约 Webhook 事件编号不一致', { + statusCode: 400, + errorCode: 'integration_event_id_mismatch', + }) + } + return applySemiAutoTaskStateSnapshot(body, { + eventId, + eventType: String(body.eventType || ''), + }) + }, + { + successMessage: '半自动履约状态已同步', + errorMessage: '同步半自动履约状态失败', + scope: '[integration/platform-fulfillment/semi-auto/task-state]', + }, + ), +) + export default router diff --git a/apps/backend/src/services/semi-auto/huya-connector-client.ts b/apps/backend/src/services/semi-auto/huya-connector-client.ts index e4e8c001..805a6a74 100644 --- a/apps/backend/src/services/semi-auto/huya-connector-client.ts +++ b/apps/backend/src/services/semi-auto/huya-connector-client.ts @@ -239,6 +239,7 @@ async function callConnector( durationMs: Date.now() - startedAt, requestSummary: { baseUrl: endpoint.baseUrl }, requestBody: options.body, + maskRequestCode: true, responseSummary: { bodyBytes: text.length }, responseBody: payload ?? text, always: method !== 'GET', @@ -265,6 +266,7 @@ async function callConnector( durationMs: Date.now() - startedAt, requestSummary: { baseUrl: endpoint.baseUrl }, requestBody: options.body, + maskRequestCode: true, always: true, errorMessage: error instanceof Error ? error.message : String(error), }) diff --git a/apps/backend/src/services/semi-auto/semi-auto-admin-service.ts b/apps/backend/src/services/semi-auto/semi-auto-admin-service.ts new file mode 100644 index 00000000..26c1836a --- /dev/null +++ b/apps/backend/src/services/semi-auto/semi-auto-admin-service.ts @@ -0,0 +1,898 @@ +import { query, withTransaction } from '../../db/client.js' +import { getFileAssetByObjectKey } from '../../repositories/file-asset-repo.js' +import { createHttpError } from '../../utils/http.js' +import type { AdminSession } from '../admin/admin-auth-service.js' +import { safeParseJson } from '../admin/admin-query-utils.js' +import { + confirmManualFulfillment, + runManualFulfillmentPostCommit, +} from '../finance/manual-fulfillment-service.js' +import { + buildFileUrl, + ORDER_SERVICE_SCREENSHOT_CONTENT_TYPES, + type UploadedFileDto, +} from '../file-storage/file-storage-service.js' +import { publishAdminOrderRealtimeChange } from '../realtime/realtime-event-service.js' +import { + consumeHuyaBrowserTicket, + createHuyaBrowserTicket, + revokeHuyaSession, + type ConnectorInjectionPayload, + type SemiAutoConnectorMode, +} from './huya-connector-client.js' +import { + buildSemiAutoCredentialCookieHeader, + loadSemiAutoCredential, +} from './semi-auto-credential-service.js' +import { + consumeWeiboBrowserTicket, + createWeiboBrowserTicket, + revokeWeiboSession, +} from './weibo-connector-client.js' +import { WEIBO_TICKET_PREFIX } from './weibo-native/weibo-native-connector.js' +import { querySemiAutoTraces } from './semi-auto-trace.js' +import { + appendTaskEvent, + compareBindingRole, + ensureConnectorSessionForTask, + ensureSemiAutoTasksForAdminList, + getBindingForTask, + getLoginSessionForTask, + loadTask, + loadTaskForUpdateWithClient, + mapTask, + normalizeId, + normalizeOrderNo, + publishSemiAutoTaskRealtimeChange, + resetTaskForCustomerLogin, + revokeSessionForTask, + TASK_SELECT, + updateBindingTask, + type BindingStatus, + type ExecutionStatus, + type LoginStatus, + type SemiAutoPlatform, + type TaskRow, +} from './semi-auto-task-core.js' +import { updateLoginTask } from './semi-auto-customer-service.js' + +export async function listAdminSemiAutoTasks(input: Record = {}) { + await ensureSemiAutoTasksForAdminList() + const page = Math.max(1, Math.trunc(Number(input.page) || 1)) + const pageSize = Math.min(100, Math.max(1, Math.trunc(Number(input.pageSize) || 20))) + const platform = String(input.platform || '').trim() + const status = String(input.status || '').trim() + const keyword = String(input.keyword || '').trim() + const conditions = ['1 = 1'] + const params: unknown[] = [] + if (platform === 'huya' || platform === 'weibo') { + params.push(platform) + conditions.push(`task.platform = $${params.length}`) + } + if ( + [ + 'waiting_customer', + 'waiting_operator', + 'processing', + 'completed', + 'failed', + 'cancelled', + ].includes(status) + ) { + params.push(status) + conditions.push(`task.execution_status = $${params.length}`) + } + if (keyword) { + params.push(`%${keyword.replace(/[\\%_]/g, '\\$&')}%`) + const p = `$${params.length}` + conditions.push( + `(o.platform_order_id ILIKE ${p} OR oi.sku_name ILIKE ${p} OR oi.sku_code ILIKE ${p} OR task.huya_uid ILIKE ${p} OR task.bind_game_role ILIKE ${p})`, + ) + } + const where = conditions.join(' AND ') + const count = await query<{ total: number }>( + `SELECT COUNT(*)::int AS total + FROM semi_auto_tasks task + JOIN orders o ON o.id = task.order_id + JOIN order_items oi ON oi.id = task.order_item_id + WHERE ${where}`, + params, + ) + const listParams = [...params, pageSize, (page - 1) * pageSize] + const result = await query( + `${TASK_SELECT} + WHERE ${where} + ORDER BY + CASE task.execution_status + WHEN 'waiting_operator' THEN 0 + WHEN 'waiting_customer' THEN 1 + WHEN 'processing' THEN 2 + WHEN 'failed' THEN 3 + ELSE 4 + END, + task.updated_at DESC, + task.id DESC + LIMIT $${listParams.length - 1} OFFSET $${listParams.length}`, + listParams, + ) + return { + items: result.rows.map(mapTask), + pagination: { page, pageSize, total: Number(count.rows[0]?.total || 0) }, + } +} + +export async function getAdminSemiAutoTask(taskIdInput: unknown) { + const task = await loadTask(normalizeId(taskIdInput)) + const events = await query<{ + id: number + event_type: string + actor_type: string + actor_id: string + detail_json: Record + created_at: string + }>( + `SELECT id, event_type, actor_type, actor_id, detail_json, created_at + FROM semi_auto_task_events + WHERE task_id = $1 + ORDER BY id DESC + LIMIT 200`, + [task.id], + ) + return { + task: mapTask(task), + // 管理端详情直接复用与客户页相同的三项比对口径,避免出现第二套判定。 + comparison: compareBindingRole(task, { + bindGameRole: task.bind_game_role, + bindGameRoleId: task.bind_game_role_id, + bindGameChannel: task.bind_game_channel, + }), + events: events.rows.map((event) => ({ + id: Number(event.id), + eventType: event.event_type, + actorType: event.actor_type, + actorId: event.actor_id, + detail: event.detail_json || {}, + createdAt: event.created_at, + })), + } +} + +type SemiAutoTaskEventRow = { + id: number + event_type: string + actor_type: string + actor_id: string + from_login_status: string | null + to_login_status: string | null + from_binding_status: string | null + to_binding_status: string | null + from_execution_status: string | null + to_execution_status: string | null + detail_json: Record + created_at: string +} + +/** + * 运营端「历史」:任务状态流转事件 + 全链路报文(本系统入站 + 外部平台出站)。 + * 报文只读,不做任何写操作;Cookie / Token 已在落库前脱敏。 + */ +export async function getAdminSemiAutoTaskHistory( + taskIdInput: unknown, + input: Record = {}, +) { + const task = await loadTask(normalizeId(taskIdInput)) + const eventCount = await query<{ total: number }>( + `SELECT COUNT(*)::int AS total FROM semi_auto_task_events WHERE task_id = $1`, + [task.id], + ) + const events = await query( + `SELECT * FROM ( + SELECT id, event_type, actor_type, actor_id, + from_login_status, to_login_status, + from_binding_status, to_binding_status, + from_execution_status, to_execution_status, + detail_json, created_at + FROM semi_auto_task_events + WHERE task_id = $1 + ORDER BY id DESC + LIMIT 500 + ) recent + ORDER BY id ASC`, + [task.id], + ) + const traces = await querySemiAutoTraces(task.id, { + page: Number(input.page) || 1, + pageSize: Number(input.pageSize) || 50, + channel: String(input.channel || '').trim(), + status: String(input.status || '').trim(), + requestId: String(input.requestId || '').trim(), + keyword: String(input.keyword || '').trim(), + }) + return { + task: mapTask(task), + events: events.rows.map((event) => ({ + id: Number(event.id), + eventType: event.event_type, + actorType: event.actor_type, + actorId: event.actor_id, + fromLoginStatus: event.from_login_status, + toLoginStatus: event.to_login_status, + fromBindingStatus: event.from_binding_status, + toBindingStatus: event.to_binding_status, + fromExecutionStatus: event.from_execution_status, + toExecutionStatus: event.to_execution_status, + detail: event.detail_json || {}, + createdAt: event.created_at, + })), + eventTotal: Number(eventCount.rows[0]?.total || 0), + traces, + } +} + +export async function exportAdminSemiAutoCredential(taskIdInput: unknown) { + const task = await loadTask(normalizeId(taskIdInput)) + if (!task.credential_id) { + throw createHttpError('当前任务尚未保存账号 CK', { + statusCode: 404, + errorCode: 'semi_auto_credential_not_found', + }) + } + const credential = await loadSemiAutoCredential(task.credential_id) + if (!credential || credential.platform !== task.platform) { + throw createHttpError('账号 CK 不存在或与任务平台不一致', { + statusCode: 404, + errorCode: 'semi_auto_credential_not_found', + }) + } + const config = safeParseJson(task.semi_auto_config_json) + const targets = Array.isArray(config.browserTargets) ? config.browserTargets : [] + const configuredTarget = String( + targets.find((item): item is { url?: string } => Boolean(item && typeof item === 'object')) + ?.url || '', + ).trim() + const targetUrl = /^https:\/\//i.test(configuredTarget) + ? configuredTarget + : credential.platform === 'weibo' + ? 'https://weibo.com/' + : 'https://www.huya.com/' + const cookieHeader = targetUrl + ? buildSemiAutoCredentialCookieHeader(credential.cookies, targetUrl) + : '' + return { + credentialId: credential.id, + platform: credential.platform, + platformUid: credential.platformUid, + nickname: credential.nickname, + source: credential.source, + status: credential.status, + updatedAt: credential.updatedAt, + targetUrl, + cookieHeader, + cookies: credential.cookies, + } +} + +export async function claimAdminSemiAutoTask(taskIdInput: unknown, session: AdminSession) { + const taskId = normalizeId(taskIdInput) + const adminUserId = Number(session.userId || 0) + let orderId = 0 + await withTransaction(async (client) => { + const task = await loadTaskForUpdateWithClient(client, taskId) + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + throw createHttpError('当前任务已结束,不能领取', { + statusCode: 409, + errorCode: + task.execution_status === 'completed' + ? 'semi_auto_task_completed' + : 'semi_auto_task_cancelled', + }) + } + if (task.assigned_admin_user_id && Number(task.assigned_admin_user_id) !== adminUserId) { + throw createHttpError('该任务已被其他客服领取', { + statusCode: 409, + errorCode: 'semi_auto_task_claimed', + }) + } + orderId = Number(task.order_id) + await client.query( + `UPDATE semi_auto_tasks + SET assigned_admin_user_id = $2, updated_at = NOW() + WHERE id = $1`, + [taskId, adminUserId], + ) + await appendTaskEvent(client, taskId, { + eventType: 'task_claimed', + actorType: 'admin', + actorId: String(adminUserId), + }) + }) + publishSemiAutoTaskRealtimeChange(taskId, orderId) + return getAdminSemiAutoTask(taskId) +} + +export async function syncAdminSemiAutoTask(taskIdInput: unknown) { + const taskId = normalizeId(taskIdInput) + let task = await ensureConnectorSessionForTask(await loadTask(taskId)) + if (!task.connector_session_id) return getAdminSemiAutoTask(taskId) + if ( + task.login_status !== 'authenticated' && + task.login_status !== 'failed' && + task.login_status !== 'expired' + ) { + const login = await getLoginSessionForTask(task, task.connector_session_id) + await updateLoginTask(task, login, 'connector') + task = await loadTask(taskId) + } + return getAdminSemiAutoTask(taskId) +} + +/** + * 低频兜底对账:只处理活跃且有 Connector 会话的任务,并且每次限量。 + * 正常状态变化由客户操作、Connector 回调和后台操作即时推进,这里只补漏。 + */ +export async function reconcileSemiAutoTaskStates(limitInput = 100) { + const limit = Math.min(500, Math.max(1, Math.trunc(Number(limitInput) || 100))) + const candidates = await query( + `${TASK_SELECT} + WHERE task.execution_status NOT IN ('completed', 'cancelled') + AND task.connector_session_id <> '' + ORDER BY task.updated_at ASC, task.id ASC + LIMIT $1`, + [limit], + ) + let checked = 0 + let updated = 0 + for (const candidate of candidates.rows) { + try { + let task = await ensureConnectorSessionForTask(candidate) + if (!task.connector_session_id) continue + checked += 1 + if ( + task.login_status !== 'authenticated' && + task.login_status !== 'failed' && + task.login_status !== 'expired' + ) { + const login = await getLoginSessionForTask(task, task.connector_session_id) + await updateLoginTask(task, login, 'connector') + task = await loadTask(task.id) + updated += 1 + } + if ( + task.platform === 'huya' && + task.login_status === 'authenticated' && + ['qr_pending', 'scanned', 'role_ready'].includes(task.binding_status) + ) { + const binding = await getBindingForTask(task, task.connector_session_id) + await updateBindingTask(task, binding, 'connector') + updated += 1 + } + } catch (error) { + const detail = error instanceof Error ? error.message : String(error) + await query( + `UPDATE semi_auto_tasks + SET last_error = $2, updated_at = NOW() + WHERE id = $1 + AND execution_status NOT IN ('completed', 'cancelled')`, + [candidate.id, detail.slice(0, 1000)], + ).catch(() => undefined) + } + } + return { checked, updated } +} + +const LOGIN_STATUSES = new Set([ + 'waiting_login', + 'qr_pending', + 'scanned', + 'authenticated', + 'failed', + 'expired', +]) +const BINDING_STATUSES = new Set([ + 'not_started', + 'qr_pending', + 'scanned', + 'role_ready', + 'confirmed', + 'failed', + 'expired', +]) + +function parseSnapshotStatus(value: unknown, allowed: Set, label: string): T { + const status = String(value || '').trim() as T + if (!allowed.has(status)) { + throw createHttpError(`${label}无效`, { + statusCode: 400, + errorCode: 'semi_auto_snapshot_status_invalid', + }) + } + return status +} + +/** + * 外部 Connector 的幂等状态快照入口。 + * + * Connector 只提交登录/绑定观察结果,不直接声明业务执行完成;执行状态仍由订单系统 + * 根据登录、绑定和人工确认规则推导。重复 eventId 由 integration_inbox 去重。 + */ +export async function applySemiAutoTaskStateSnapshot( + input: Record, + options: { eventId?: string; eventType?: string } = {}, +) { + const eventId = String(options.eventId || input.eventId || '').trim() + const taskId = normalizeId(input.taskId ?? input.task_id) + const orderNo = normalizeOrderNo(input.orderNo ?? input.order_no) + const loginStatus = parseSnapshotStatus( + input.loginStatus ?? input.login_status, + LOGIN_STATUSES, + '登录状态', + ) + const bindingStatus = parseSnapshotStatus( + input.bindingStatus ?? input.binding_status, + BINDING_STATUSES, + '绑定状态', + ) + if (!eventId) { + throw createHttpError('状态快照事件编号不能为空', { + statusCode: 400, + errorCode: 'semi_auto_snapshot_event_id_required', + }) + } + + const result = await withTransaction(async (client) => { + const claimed = await client.query( + `INSERT INTO integration_inbox (event_id, source, event_type, received_at, processed_at) + VALUES ($1, 'semi_auto_connector', $2, NOW(), NOW()) + ON CONFLICT (event_id) DO NOTHING + RETURNING event_id`, + [eventId, String(options.eventType || 'semi_auto.task_state')], + ) + if (claimed.rowCount === 0) return { applied: false, terminal: false } + + const task = await loadTaskForUpdateWithClient(client, taskId) + if (task.platform_order_id !== orderNo) { + throw createHttpError('状态快照与任务订单号不一致', { + statusCode: 409, + errorCode: 'semi_auto_snapshot_order_mismatch', + }) + } + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + return { applied: false, terminal: true } + } + + const executionStatus: ExecutionStatus = + loginStatus === 'authenticated' && + (task.platform === 'weibo' || bindingStatus === 'confirmed') + ? 'waiting_operator' + : 'waiting_customer' + const uid = String(input.huyaUid ?? input.huya_uid ?? '').trim() + const nickname = String(input.platformNickname ?? input.platform_nickname ?? '').trim() + const bindGameAccount = String(input.bindGameAccount ?? input.bind_game_account ?? '').trim() + const bindGameRole = String(input.bindGameRole ?? input.bind_game_role ?? '').trim() + const bindGameRoleId = String(input.bindGameRoleId ?? input.bind_game_role_id ?? '').trim() + const bindGameChannel = String(input.bindGameChannel ?? input.bind_game_channel ?? '').trim() + const message = String(input.message ?? input.lastError ?? input.last_error ?? '') + .trim() + .slice(0, 1000) + + await client.query( + `UPDATE semi_auto_tasks + SET login_status = $2, + binding_status = $3, + execution_status = $4, + huya_uid = CASE WHEN $5 <> '' THEN $5 ELSE huya_uid END, + platform_nickname = CASE WHEN $6 <> '' THEN $6 ELSE platform_nickname END, + bind_game_account = CASE WHEN $7 <> '' THEN $7 ELSE bind_game_account END, + bind_game_role = CASE WHEN $8 <> '' THEN $8 ELSE bind_game_role END, + bind_game_role_id = CASE WHEN $9 <> '' THEN $9 ELSE bind_game_role_id END, + bind_game_channel = CASE WHEN $10 <> '' THEN $10 ELSE bind_game_channel END, + authenticated_at = CASE + WHEN $2 = 'authenticated' THEN COALESCE(authenticated_at, NOW()) + ELSE authenticated_at + END, + bound_at = CASE + WHEN $3 IN ('role_ready', 'confirmed') THEN COALESCE(bound_at, NOW()) + ELSE bound_at + END, + last_error = CASE WHEN $2 IN ('failed', 'expired') OR $3 IN ('failed', 'expired') + THEN $11 ELSE '' END, + updated_at = NOW() + WHERE id = $1`, + [ + task.id, + loginStatus, + bindingStatus, + executionStatus, + uid, + nickname, + bindGameAccount, + bindGameRole, + bindGameRoleId, + bindGameChannel, + message, + ], + ) + if ( + loginStatus !== task.login_status || + bindingStatus !== task.binding_status || + executionStatus !== task.execution_status + ) { + await appendTaskEvent(client, task.id, { + eventType: 'connector_state_synced', + actorType: 'connector', + fromLoginStatus: task.login_status, + toLoginStatus: loginStatus, + fromBindingStatus: task.binding_status, + toBindingStatus: bindingStatus, + fromExecutionStatus: task.execution_status, + toExecutionStatus: executionStatus, + detail: { + eventId, + source: 'semi_auto_connector', + message, + }, + }) + } + return { + applied: true, + terminal: false, + taskId: task.id, + orderId: task.order_id, + } + }) + if (result.applied && result.taskId && result.orderId) { + publishSemiAutoTaskRealtimeChange(result.taskId, result.orderId) + } + return result +} + +export async function requestAdminSemiAutoCustomerReauth( + taskIdInput: unknown, + session: AdminSession, +) { + const taskId = normalizeId(taskIdInput) + const task = await loadTask(taskId) + if (task.execution_status === 'completed') { + throw createHttpError('已完成任务不能重新授权', { + statusCode: 409, + errorCode: 'semi_auto_task_completed', + }) + } + if (task.execution_status === 'cancelled') { + throw createHttpError('已取消任务不能重新授权', { + statusCode: 409, + errorCode: 'semi_auto_task_cancelled', + }) + } + const adminUserId = Number(session.userId || 0) + if (task.assigned_admin_user_id && Number(task.assigned_admin_user_id) !== adminUserId) { + throw createHttpError('该任务已被其他客服领取', { + statusCode: 409, + errorCode: 'semi_auto_task_claimed', + }) + } + if (task.connector_session_id) { + await revokeSessionForTask(task, task.connector_session_id).catch(() => undefined) + } + await resetTaskForCustomerLogin(task, { + actorType: 'admin', + actorId: String(adminUserId), + reason: '客服已重新发送授权链接,等待客户重新登录', + eventType: 'customer_reauth_requested', + }) + return getAdminSemiAutoTask(taskId) +} + +export async function createAdminBrowserSession( + taskIdInput: unknown, + targetUrlInput: unknown, + session: AdminSession, +) { + const taskId = normalizeId(taskIdInput) + const task = await ensureConnectorSessionForTask(await loadTask(taskId)) + const adminUserId = Number(session.userId || 0) + if (task.assigned_admin_user_id && Number(task.assigned_admin_user_id) !== adminUserId) { + throw createHttpError('该任务已被其他客服领取', { + statusCode: 409, + errorCode: 'semi_auto_task_claimed', + }) + } + if (!task.connector_session_id || task.login_status !== 'authenticated') { + throw createHttpError('客户尚未完成登录,或登录会话已失效', { + statusCode: 409, + errorCode: 'semi_auto_login_required', + }) + } + const config = safeParseJson(task.semi_auto_config_json) + const targets = Array.isArray(config.browserTargets) ? config.browserTargets : [] + const explicitTarget = String(targetUrlInput || '').trim() + const fallbackTarget = targets.find((item): item is { url?: string } => + Boolean(item && typeof item === 'object'), + )?.url + const targetUrl = explicitTarget || String(fallbackTarget || '') + const ticket = + task.platform === 'weibo' + ? await createWeiboBrowserTicket( + { sessionId: task.connector_session_id, targetUrl }, + task.connector_mode, + ) + : await createHuyaBrowserTicket( + { + sessionId: task.connector_session_id, + targetUrl, + }, + task.connector_mode, + ) + await withTransaction(async (client) => { + await client.query( + `UPDATE semi_auto_tasks + SET assigned_admin_user_id = COALESCE(assigned_admin_user_id, $2), + execution_status = CASE WHEN execution_status = 'waiting_operator' THEN 'processing' ELSE execution_status END, + updated_at = NOW() + WHERE id = $1`, + [taskId, adminUserId], + ) + await appendTaskEvent(client, taskId, { + eventType: 'browser_session_opened', + actorType: 'admin', + actorId: String(adminUserId), + detail: { targetUrl }, + }) + }) + publishSemiAutoTaskRealtimeChange(taskId, task.order_id) + return ticket +} + +/** + * 票据内的 targetUrl 只服务于创建阶段的 Cookie 序列化与审计; + * 下发给扩展时清空,指定平台页统一由前端占位页在注入成功后打开, + * 这样扩展只写 Cookie,不会再额外打开一个目标页标签。 + */ +export function buildExtensionInjectionPayload( + payload: ConnectorInjectionPayload, +): ConnectorInjectionPayload { + return { ...payload, targetUrl: '' } +} + +export async function consumeSemiAutoInjectionTicket(ticketInput: unknown) { + const ticket = String(ticketInput || '').trim() + if (!ticket) { + throw createHttpError('注入票据无效', { + statusCode: 400, + errorCode: 'semi_auto_injection_ticket_invalid', + }) + } + const payload = ticket.startsWith(WEIBO_TICKET_PREFIX) + ? await consumeWeiboBrowserTicket(ticket) + : await consumeHuyaBrowserTicket(ticket) + return buildExtensionInjectionPayload(payload) +} + +async function resolveCompletionEvidence( + screenshots: unknown, + session: AdminSession, +): Promise { + const files = Array.isArray(screenshots) ? screenshots : [] + const uploaderId = String(session.userId || session.username || '') + const result: UploadedFileDto[] = [] + for (const item of files.slice(0, 10)) { + const source = item && typeof item === 'object' ? (item as Record) : {} + const objectKey = String(source.objectKey || source.object_key || '').trim() + if (!objectKey) continue + const asset = await getFileAssetByObjectKey(objectKey) + if ( + !asset || + asset.status !== 'active' || + asset.uploader_type !== 'admin' || + asset.uploader_id !== uploaderId || + asset.scene !== 'semi-auto-evidence' || + !ORDER_SERVICE_SCREENSHOT_CONTENT_TYPES.has(String(asset.content_type || '')) + ) { + throw createHttpError('完成截图无效,请重新上传', { + statusCode: 400, + errorCode: 'semi_auto_evidence_invalid', + }) + } + result.push({ + objectKey: asset.object_key, + url: buildFileUrl(asset.object_key), + thumbnailUrl: buildFileUrl(asset.thumbnail_object_key || asset.object_key), + mediumUrl: buildFileUrl(asset.medium_object_key || asset.object_key), + filename: asset.original_filename, + contentType: asset.content_type, + size: Number(asset.size_bytes || 0), + }) + } + return result +} + +export async function completeAdminSemiAutoTask( + taskIdInput: unknown, + payload: Record, + session: AdminSession, +) { + const taskId = normalizeId(taskIdInput) + let current = await loadTask(taskId) + if (current.execution_status === 'completed') return getAdminSemiAutoTask(taskId) + current = await ensureConnectorSessionForTask(current) + if (current.execution_status === 'completed') return getAdminSemiAutoTask(taskId) + if (current.execution_status === 'cancelled') { + throw createHttpError('任务已取消,不能完成', { + statusCode: 409, + errorCode: 'semi_auto_task_cancelled', + }) + } + const screenshots = await resolveCompletionEvidence(payload.screenshots || [], session) + const note = String(payload.note || '') + .trim() + .slice(0, 1000) + const externalOrderNo = String(payload.externalOrderNo || payload.external_order_no || '') + .trim() + .slice(0, 200) + const costFenRaw = Number(payload.costFen ?? payload.cost_fen) + const costFen = + Number.isFinite(costFenRaw) && costFenRaw >= 0 ? Math.trunc(costFenRaw) : undefined + const completionNote = [note, externalOrderNo ? `外部单号:${externalOrderNo}` : ''] + .filter(Boolean) + .join(';') + const adminUserId = Number(session.userId || 0) + + // 人工财务确认、履约状态和半自动任务完成必须同事务提交: + // 任何任务更新失败都会回滚成本快照、钱包扣减和履约状态,避免“已扣钱但任务未完成”。 + const completion = await withTransaction(async (client) => { + const task = await loadTaskForUpdateWithClient(client, taskId) + if (task.execution_status === 'completed') { + return { task, completedNow: false } + } + if (task.execution_status === 'cancelled') { + throw createHttpError('任务已取消,不能完成', { + statusCode: 409, + errorCode: 'semi_auto_task_cancelled', + }) + } + if ( + task.login_status !== 'authenticated' || + !task.credential_id || + task.credential_status === 'invalid' || + task.credential_status === 'error' + ) { + throw createHttpError('客户账号 CK 尚未就绪或已失效,不能完成履约', { + statusCode: 409, + errorCode: 'semi_auto_credential_required', + }) + } + if (task.assigned_admin_user_id && Number(task.assigned_admin_user_id) !== adminUserId) { + throw createHttpError('该任务已被其他客服领取', { + statusCode: 409, + errorCode: 'semi_auto_task_claimed', + }) + } + + await confirmManualFulfillment( + { + orderItemId: task.order_item_id, + platformKey: task.manual_platform_key, + ...(costFen !== undefined ? { costFen } : {}), + note: completionNote || '半自动履约完成', + }, + session, + { client }, + ) + + const updated = await client.query<{ id: number }>( + ` + UPDATE semi_auto_tasks + SET assigned_admin_user_id = COALESCE(assigned_admin_user_id, $2), + execution_status = 'completed', + completed_quantity = target_quantity, + completed_at = NOW(), + completion_note = $3, + external_order_no = $4, + completion_evidence_json = $5::jsonb, + last_error = '', + updated_at = NOW() + WHERE id = $1 + RETURNING id + `, + [taskId, adminUserId, note, externalOrderNo, JSON.stringify({ screenshots })], + ) + if (!updated.rows[0]) { + throw createHttpError('半自动履约任务状态更新失败', { + statusCode: 500, + errorCode: 'semi_auto_task_completion_failed', + }) + } + await appendTaskEvent(client, taskId, { + eventType: 'task_completed', + actorType: 'admin', + actorId: String(adminUserId), + fromExecutionStatus: task.execution_status, + toExecutionStatus: 'completed', + detail: { + note, + externalOrderNo, + screenshotCount: screenshots.length, + }, + }) + return { task, completedNow: true } + }) + + if (!completion.completedNow) { + return getAdminSemiAutoTask(taskId) + } + await runManualFulfillmentPostCommit(completion.task.order_item_id) + if (completion.task.connector_session_id) { + await revokeSessionForTask(completion.task, completion.task.connector_session_id).catch( + () => undefined, + ) + } + publishAdminOrderRealtimeChange(Number(completion.task.order_id)) + publishSemiAutoTaskRealtimeChange(taskId, completion.task.order_id) + return getAdminSemiAutoTask(taskId) +} + +export async function cancelAdminSemiAutoTask( + taskIdInput: unknown, + payload: Record, + session: AdminSession, +) { + const taskId = normalizeId(taskIdInput) + const reason = String(payload.reason || '') + .trim() + .slice(0, 500) + const adminUserId = Number(session.userId || 0) + let orderId = 0 + const connector: { + sessionId: string + mode: SemiAutoConnectorMode + platform: SemiAutoPlatform + } = { + sessionId: '', + mode: 'embedded', + platform: 'huya', + } + await withTransaction(async (client) => { + const task = await loadTaskForUpdateWithClient(client, taskId) + orderId = Number(task.order_id) + connector.sessionId = task.connector_session_id + connector.mode = task.connector_mode + connector.platform = task.platform + if (task.execution_status === 'completed') { + throw createHttpError('已完成任务不能取消', { + statusCode: 409, + errorCode: 'semi_auto_task_completed', + }) + } + if (task.execution_status === 'cancelled') { + return + } + await client.query( + ` + UPDATE semi_auto_tasks + SET execution_status = 'cancelled', + last_error = $2, + updated_at = NOW() + WHERE id = $1 + `, + [taskId, reason], + ) + await appendTaskEvent(client, taskId, { + eventType: 'task_cancelled', + actorType: 'admin', + actorId: String(adminUserId), + fromExecutionStatus: task.execution_status, + toExecutionStatus: 'cancelled', + detail: { reason }, + }) + }) + if (connector.sessionId) { + const revoke = + connector.platform === 'weibo' + ? revokeWeiboSession(connector.sessionId, connector.mode) + : revokeHuyaSession(connector.sessionId, connector.mode) + await revoke.catch(() => undefined) + } + publishAdminOrderRealtimeChange(orderId) + publishSemiAutoTaskRealtimeChange(taskId, orderId) + return getAdminSemiAutoTask(taskId) +} diff --git a/apps/backend/src/services/semi-auto/semi-auto-customer-service.ts b/apps/backend/src/services/semi-auto/semi-auto-customer-service.ts new file mode 100644 index 00000000..1671576e --- /dev/null +++ b/apps/backend/src/services/semi-auto/semi-auto-customer-service.ts @@ -0,0 +1,1048 @@ +import { query, withTransaction } from '../../db/client.js' +import { createHttpError } from '../../utils/http.js' +import { + confirmHuyaBinding, + exportHuyaSessionCredential, + getHuyaBindingSnapshot, + loginHuyaSms, + resetHuyaBinding, + revokeHuyaSession, + sendHuyaSmsCode, + startHuyaBinding, + submitHuyaRebind, + verifyHuyaSmsChallenge, + type ConnectorBindingSession, + type ConnectorLoginSession, +} from './huya-connector-client.js' +import { + exportWeiboSessionCredential, + getWeiboBinding, + getWeiboCountryCodes, + loginWeiboSms, + revokeWeiboSession, + sendWeiboSmsCode, +} from './weibo-connector-client.js' +import { upsertSemiAutoCredentialWithClient } from './semi-auto-credential-service.js' +import { + appendTaskEvent, + assertCustomerProfileReady, + assertHuyaTask, + assertWeiboTask, + compareBindingRole, + createLoginSessionForTask, + ensureConnectorSessionForTask, + ensureSemiAutoTasksForOrder, + getBindingForTask, + getLoginSessionForTask, + hasCustomerProfile, + loadTask, + loadTaskForOrder, + loadTaskForUpdateWithClient, + mapTask, + normalizeId, + normalizeOrderNo, + publishSemiAutoTaskRealtimeChange, + resetTaskForCustomerLogin, + revokeSessionForTask, + TASK_SELECT, + updateBindingTask, + type BindingStatus, + type ExecutionStatus, + type LoginStatus, + type TaskActorType, + type TaskRow, +} from './semi-auto-task-core.js' + +export async function listPublicSemiAutoTasks(orderNoInput: unknown) { + const orderNo = normalizeOrderNo(orderNoInput) + await ensureSemiAutoTasksForOrder(orderNo) + const result = await query( + `${TASK_SELECT} + WHERE o.platform_order_id = $1 + AND task.execution_status <> 'cancelled' + ORDER BY task.id ASC`, + [orderNo], + ) + return result.rows.map(mapTask) +} + +export async function markCustomerLinkOpened(orderNoInput: unknown, taskIdInput: unknown) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + await ensureSemiAutoTasksForOrder(orderNo) + const task = await loadTaskForOrder(orderNo, taskId) + if (!task.customer_link_opened_at) { + await withTransaction(async (client) => { + await client.query( + `UPDATE semi_auto_tasks SET customer_link_opened_at = NOW(), updated_at = NOW() WHERE id = $1`, + [taskId], + ) + await appendTaskEvent(client, taskId, { + eventType: 'customer_link_opened', + actorType: 'customer', + }) + }) + } + return { ok: true } +} + +export type CustomerProfileInput = { + roleName?: unknown + roleId?: unknown + serverZone?: unknown +} + +const CUSTOMER_SERVER_ZONES = new Set(['苹果Q区', '苹果V区', '安卓Q区', '安卓V区']) + +export function normalizeCustomerProfile(input: CustomerProfileInput = {}) { + const roleName = String(input.roleName ?? '') + .trim() + .slice(0, 100) + const roleId = String(input.roleId ?? '') + .replace(/\s+/g, '') + .slice(0, 64) + const serverZone = String(input.serverZone ?? '') + .trim() + .slice(0, 100) + if (roleId && !/^\d+$/.test(roleId)) { + throw createHttpError('游戏编号 / 角色 ID 只能是数字', { + statusCode: 400, + errorCode: 'semi_auto_profile_role_id_invalid', + }) + } + if (!CUSTOMER_SERVER_ZONES.has(serverZone)) { + throw createHttpError('区服只能选择 苹果Q区 / 苹果V区 / 安卓Q区 / 安卓V区', { + statusCode: 400, + errorCode: 'semi_auto_profile_server_zone_invalid', + }) + } + if (!roleName || !roleId) { + throw createHttpError('请完整填写区服、游戏编号和角色名', { + statusCode: 400, + errorCode: 'semi_auto_profile_required', + }) + } + return { roleName, roleId, serverZone } +} + +/** + * 半自动订单没有 work_orders,客户资料只能在授权页 /c/<订单号>(虎牙)或 /d/<订单号>(微博)收集。 + * 保存后立即参与“客户填写角色 vs 平台识别角色”的比对。 + */ +export async function savePublicTaskProfile( + orderNoInput: unknown, + taskIdInput: unknown, + payload: CustomerProfileInput = {}, +) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + const task = await loadTaskForOrder(orderNo, taskId) + if (task.platform !== 'huya') { + throw createHttpError('当前平台不需要填写游戏角色', { + statusCode: 409, + errorCode: 'semi_auto_profile_not_supported', + }) + } + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + throw createHttpError('当前订单已结束,不能修改角色资料', { + statusCode: 409, + errorCode: 'semi_auto_task_closed', + }) + } + if (task.binding_status === 'confirmed') { + throw createHttpError('绑定已确认,不能修改角色资料', { + statusCode: 409, + errorCode: 'semi_auto_profile_locked', + }) + } + // 客户页流程固定为「登录 → 填写资料 → 绑定角色」;未登录不允许提前写资料。 + if (task.login_status !== 'authenticated') { + throw createHttpError('请先完成虎牙登录后再填写资料', { + statusCode: 409, + errorCode: 'semi_auto_login_required', + }) + } + const profile = normalizeCustomerProfile(payload) + await withTransaction(async (client) => { + const current = await loadTaskForUpdateWithClient(client, task.id) + if (current.execution_status === 'completed' || current.execution_status === 'cancelled') { + throw createHttpError('当前订单已结束,不能修改角色资料', { + statusCode: 409, + errorCode: 'semi_auto_task_closed', + }) + } + if (current.binding_status === 'confirmed') { + throw createHttpError('绑定已确认,不能修改角色资料', { + statusCode: 409, + errorCode: 'semi_auto_profile_locked', + }) + } + if (current.login_status !== 'authenticated') { + throw createHttpError('请先完成虎牙登录后再填写资料', { + statusCode: 409, + errorCode: 'semi_auto_login_required', + }) + } + await client.query( + ` + UPDATE semi_auto_tasks + SET customer_game_role_name = $2, + customer_game_role_id = $3, + customer_game_server_zone = $4, + updated_at = NOW() + WHERE id = $1 + `, + [current.id, profile.roleName, profile.roleId, profile.serverZone], + ) + await appendTaskEvent(client, current.id, { + eventType: 'customer_profile_saved', + actorType: 'customer', + detail: profile, + }) + }) + publishSemiAutoTaskRealtimeChange(task.id, task.order_id) + const updated = await loadTask(task.id) + return { task: mapTask(updated) } +} + +function mapLoginUpdate(session: ConnectorLoginSession) { + const statusMap: Record = { + verification_pending: 'waiting_login', + waiting_code: 'waiting_login', + waiting_scan: 'qr_pending', + scanned: 'scanned', + authenticated: 'authenticated', + expired: 'expired', + failed: 'failed', + } + return { + status: statusMap[session.status] || 'failed', + uid: String(session.huyaUid || ''), + nickname: String(session.nickname || ''), + message: String(session.message || ''), + hasCredential: session.hasCredential === true, + } +} + +export async function updateLoginTask( + task: TaskRow, + session: ConnectorLoginSession, + actorType: TaskActorType, + options: { credentialSource?: 'qr' | 'sms'; method?: 'qr' | 'sms' } = {}, +) { + const mapped = mapLoginUpdate(session) + const storedCredential = + mapped.status === 'authenticated' && mapped.hasCredential + ? task.platform === 'weibo' + ? exportWeiboSessionCredential(session.sessionId, task.connector_mode) + : await exportHuyaSessionCredential(session.sessionId, task.connector_mode) + : null + if (mapped.status === 'authenticated' && !storedCredential) { + throw createHttpError('平台登录成功但未能获取账号 CK,请联系客服处理', { + statusCode: 502, + errorCode: 'semi_auto_credential_export_failed', + }) + } + await withTransaction(async (client) => { + const current = await loadTaskForUpdateWithClient(client, task.id) + if (current.execution_status === 'completed' || current.execution_status === 'cancelled') { + return + } + // 虎牙登录成功还不算授权完成,必须等客户确认绑定角色;微博登录即授权。 + const nextExecutionStatus: ExecutionStatus = + mapped.status === 'authenticated' + ? current.platform === 'weibo' || current.binding_status === 'confirmed' + ? 'waiting_operator' + : 'waiting_customer' + : current.execution_status + const credentialId = storedCredential + ? await upsertSemiAutoCredentialWithClient(client, { + platform: current.platform, + source: options.credentialSource || 'qr', + payload: storedCredential, + }) + : null + await client.query( + ` + UPDATE semi_auto_tasks + SET login_status = $2, + credential_id = COALESCE($7, credential_id), + huya_uid = CASE WHEN $3 <> '' THEN $3 ELSE huya_uid END, + platform_nickname = CASE WHEN $4 <> '' THEN $4 ELSE platform_nickname END, + authenticated_at = CASE WHEN $2 = 'authenticated' THEN COALESCE(authenticated_at, NOW()) ELSE authenticated_at END, + execution_status = $5, + last_error = CASE WHEN $2 IN ('failed', 'expired') THEN $6 ELSE '' END, + updated_at = NOW() + WHERE id = $1 + `, + [ + current.id, + mapped.status, + mapped.uid, + mapped.nickname, + nextExecutionStatus, + mapped.message, + credentialId, + ], + ) + // 轮询会每 2 秒调用一次:状态与执行状态都没变时不写事件,避免时间线被重复项淹没。 + if ( + mapped.status !== current.login_status || + nextExecutionStatus !== current.execution_status + ) { + await appendTaskEvent(client, current.id, { + eventType: 'login_status_changed', + actorType, + fromLoginStatus: current.login_status, + toLoginStatus: mapped.status, + fromExecutionStatus: current.execution_status, + toExecutionStatus: nextExecutionStatus, + detail: { + hasCredential: mapped.hasCredential, + message: mapped.message, + method: options.method || 'qr', + }, + }) + } + }) + publishSemiAutoTaskRealtimeChange(task.id, task.order_id) +} + +export async function startPublicLogin(orderNoInput: unknown, taskIdInput: unknown) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + await ensureSemiAutoTasksForOrder(orderNo) + const task = await loadTaskForOrder(orderNo, taskId) + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + throw createHttpError('当前订单已结束,不能重新登录', { + statusCode: 409, + errorCode: 'semi_auto_task_closed', + }) + } + + let reusableSession: ConnectorLoginSession | null = null + if ( + task.connector_session_id && + task.login_status !== 'expired' && + task.login_status !== 'failed' + ) { + try { + reusableSession = await getLoginSessionForTask(task, task.connector_session_id) + } catch { + // Connector 重启或短期会话被清理后,任务里的旧 ID 已不可用;重新创建前先尽力撤销。 + await revokeSessionForTask(task, task.connector_session_id).catch(() => undefined) + } + } else if (task.connector_session_id) { + await revokeSessionForTask(task, task.connector_session_id).catch(() => undefined) + } + + if ( + reusableSession?.status === 'waiting_code' || + reusableSession?.status === 'verification_pending' + ) { + await revokeSessionForTask(task, reusableSession.sessionId).catch(() => undefined) + reusableSession = null + } + + if (reusableSession) { + await updateLoginTask(task, reusableSession, 'customer') + const refreshedTask = await loadTask(task.id) + return { + task: mapTask(refreshedTask), + login: { + status: mapLoginUpdate(reusableSession).status, + qrContent: reusableSession.qrContent, + qrImage: String(reusableSession.qrImage || ''), + expiresAt: reusableSession.expiresAt, + message: reusableSession.message, + }, + } + } + + const session = await createLoginSessionForTask(task, orderNo) + await withTransaction(async (client) => { + await client.query( + ` + UPDATE semi_auto_tasks + SET connector_session_id = $2, + login_status = 'qr_pending', + binding_status = 'not_started', + bind_game_account = '', + bind_game_role = '', + bind_game_role_id = '', + bind_game_channel = '', + binding_started_at = NULL, + bound_at = NULL, + execution_status = 'waiting_customer', + auth_started_at = COALESCE(auth_started_at, NOW()), + last_error = '', + updated_at = NOW() + WHERE id = $1 + `, + [task.id, session.sessionId], + ) + await appendTaskEvent(client, task.id, { + eventType: 'login_started', + actorType: 'customer', + fromLoginStatus: task.login_status, + toLoginStatus: 'qr_pending', + fromExecutionStatus: task.execution_status, + toExecutionStatus: 'waiting_customer', + detail: { expiresAt: session.expiresAt }, + }) + }) + const refreshedTask = await loadTask(task.id) + return { + task: mapTask(refreshedTask), + login: { + status: mapLoginUpdate(session).status, + qrContent: session.qrContent, + qrImage: String(session.qrImage || ''), + expiresAt: session.expiresAt, + message: session.message, + }, + } +} + +export async function pollPublicLogin(orderNoInput: unknown, taskIdInput: unknown) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + const task = await ensureConnectorSessionForTask(await loadTaskForOrder(orderNo, taskId)) + if (!task.connector_session_id) { + return { task: mapTask(task), login: null } + } + const session = await getLoginSessionForTask(task, task.connector_session_id) + await updateLoginTask(task, session, 'customer') + const updated = await loadTask(task.id) + return { + task: mapTask(updated), + login: { + status: mapLoginUpdate(session).status, + qrContent: session.qrContent, + qrImage: String(session.qrImage || ''), + expiresAt: session.expiresAt, + message: session.message, + }, + } +} + +export async function startPublicBinding( + orderNoInput: unknown, + taskIdInput: unknown, + input: { forceRebind?: unknown } = {}, +) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + const task = await loadTaskForOrder(orderNo, taskId) + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + throw createHttpError('当前订单已结束,不能重新绑定', { + statusCode: 409, + errorCode: 'semi_auto_task_closed', + }) + } + if (!task.connector_session_id || task.login_status !== 'authenticated') { + throw createHttpError('请先完成平台登录', { + statusCode: 409, + errorCode: 'semi_auto_login_required', + }) + } + assertCustomerProfileReady(task) + const session = + task.platform === 'weibo' + ? await getWeiboBinding(task.connector_session_id, task.connector_mode) + : await startHuyaBinding(task.connector_session_id, task.connector_mode, { + forceRebind: input.forceRebind === true, + }) + const binding = await updateBindingTask(task, session, 'customer') + const updated = await loadTask(task.id) + return { task: mapTask(updated), binding } +} + +/** + * 客户在失败/不一致页面点「上一步修改资料」: + * 清空绑定/换绑状态,保留登录会话和客户资料;重新提交资料后重新走绑定流程。 + */ +export async function resetPublicBinding(orderNoInput: unknown, taskIdInput: unknown) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + const task = await loadTaskForOrder(orderNo, taskId) + if (task.platform !== 'huya') { + throw createHttpError('当前平台不需要重置绑定状态', { + statusCode: 409, + errorCode: 'semi_auto_binding_reset_not_supported', + }) + } + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + throw createHttpError('当前订单已结束,不能返回修改资料', { + statusCode: 409, + errorCode: 'semi_auto_task_closed', + }) + } + if (task.binding_status === 'confirmed') { + throw createHttpError('绑定已确认,不能返回修改资料', { + statusCode: 409, + errorCode: 'semi_auto_profile_locked', + }) + } + if (!task.connector_session_id || task.login_status !== 'authenticated') { + throw createHttpError('请先完成平台登录', { + statusCode: 409, + errorCode: 'semi_auto_login_required', + }) + } + + // 清空 Connector 内存里的换绑失败状态;外部 Connector 尚未提供 reset 时, + // 本地状态仍重置,客户可继续修改资料,不能被旧的失败状态卡死。 + try { + await resetHuyaBinding(task.connector_session_id, task.connector_mode) + } catch { + // 仅清理本地持久化状态;下一次绑定会重新查询平台角色。 + } + + await withTransaction(async (client) => { + const current = await loadTaskForUpdateWithClient(client, task.id) + if (current.execution_status === 'completed' || current.execution_status === 'cancelled') { + throw createHttpError('当前订单已结束,不能返回修改资料', { + statusCode: 409, + errorCode: 'semi_auto_task_closed', + }) + } + if (current.binding_status === 'confirmed') { + throw createHttpError('绑定已确认,不能返回修改资料', { + statusCode: 409, + errorCode: 'semi_auto_profile_locked', + }) + } + await client.query( + ` + UPDATE semi_auto_tasks + SET binding_status = 'not_started', + bind_game_account = '', + bind_game_role = '', + bind_game_role_id = '', + bind_game_channel = '', + binding_started_at = NULL, + bound_at = NULL, + execution_status = 'waiting_customer', + last_error = '', + updated_at = NOW() + WHERE id = $1 + `, + [current.id], + ) + await appendTaskEvent(client, current.id, { + eventType: 'binding_reset', + actorType: 'customer', + fromBindingStatus: current.binding_status, + toBindingStatus: 'not_started', + fromExecutionStatus: current.execution_status, + toExecutionStatus: 'waiting_customer', + detail: { + reason: 'customer_profile_edit', + customerProfileKept: true, + }, + }) + }) + publishSemiAutoTaskRealtimeChange(task.id, task.order_id) + const updated = await loadTask(task.id) + return { task: mapTask(updated), binding: null } +} + +export async function pollPublicBinding(orderNoInput: unknown, taskIdInput: unknown) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + const task = await loadTaskForOrder(orderNo, taskId) + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + return { task: mapTask(task), binding: null } + } + if (!task.connector_session_id || task.login_status !== 'authenticated') { + return { task: mapTask(task), binding: null } + } + const session = await getBindingForTask(task, task.connector_session_id) + const binding = await updateBindingTask(task, session, 'customer') + const updated = await loadTask(task.id) + return { task: mapTask(updated), binding } +} + +export async function confirmPublicBinding( + orderNoInput: unknown, + taskIdInput: unknown, + options: { acceptExistingRole?: boolean } = {}, +) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + const task = await loadTaskForOrder(orderNo, taskId) + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + throw createHttpError('当前订单已结束,不能确认绑定', { + statusCode: 409, + errorCode: 'semi_auto_task_closed', + }) + } + if ( + !task.connector_session_id || + (task.platform !== 'weibo' && task.binding_status !== 'role_ready') + ) { + throw createHttpError('当前没有待确认的绑定角色', { + statusCode: 409, + errorCode: 'semi_auto_binding_not_ready', + }) + } + assertCustomerProfileReady(task) + // 确认绑定是纯本地动作:虎牙侧只读内存快照,不再触发角色查询或换绑提交。 + const session = + task.platform === 'huya' + ? await getHuyaBindingSnapshot(task.connector_session_id, task.connector_mode) + : await getBindingForTask(task, task.connector_session_id) + const comparison = compareBindingRole(task, session) + // 换绑被虎牙拒绝时平台仍返回原角色。若客户已把资料改成与原角色一致, + // 允许直接确认;否则要求重新扫码或返回上一步修改资料。 + if ( + task.platform === 'huya' && + session.rebindUnchanged === true && + comparison.verdict !== 'match' + ) { + const reason = String(session.rebindConfirmMessage || '').trim() + throw createHttpError( + `${ + reason ? `换绑未成功:${reason}。` : '换绑未生效:平台仍返回原绑定角色。' + }请重新扫码换绑,或返回上一步修改资料,使资料与平台当前角色一致后再提交平台绑定`, + { + statusCode: 409, + errorCode: 'semi_auto_binding_rebind_decision_required', + }, + ) + } + // 三项必须全部存在且一致;信息不完整同样不能自动放行,必须转客服核实。 + if (comparison.verdict !== 'match') { + throw createHttpError(comparison.message, { + statusCode: 409, + errorCode: + comparison.verdict === 'mismatch' + ? 'semi_auto_binding_role_mismatch' + : 'semi_auto_binding_role_unverifiable', + }) + } + // 必须调用 Connector 完成确认,否则会话仍是 role_ready,数据库也会停在待确认。 + const confirmedSession = + task.platform === 'huya' + ? await confirmHuyaBinding(task.connector_session_id, task.connector_mode, { + ...(options.acceptExistingRole === true || session.rebindUnchanged === true + ? { acceptExistingRole: true } + : {}), + }) + : session + const binding = await updateBindingTask(task, confirmedSession, 'customer') + const updated = await loadTask(task.id) + return { task: mapTask(updated), binding } +} + +/** + * 客户在微信里选好目标角色后,由项目侧主动向虎牙提交换绑确认。 + * 与「确认绑定」不同,这一步只提交换绑,不把任务标记为已确认。 + */ +export async function submitPublicRebind(orderNoInput: unknown, taskIdInput: unknown) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + const task = await loadTaskForOrder(orderNo, taskId) + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + throw createHttpError('当前订单已结束,不能提交换绑', { + statusCode: 409, + errorCode: 'semi_auto_task_closed', + }) + } + if (task.platform !== 'huya') { + throw createHttpError('当前平台不需要换绑游戏角色', { + statusCode: 409, + errorCode: 'semi_auto_rebind_not_supported', + }) + } + if (!task.connector_session_id || task.login_status !== 'authenticated') { + throw createHttpError('请先完成平台登录', { + statusCode: 409, + errorCode: 'semi_auto_login_required', + }) + } + assertCustomerProfileReady(task) + const session = await submitHuyaRebind(task.connector_session_id, task.connector_mode) + const binding = await updateBindingTask(task, session, 'customer') + const updated = await loadTask(task.id) + return { task: mapTask(updated), binding } +} + +export async function sendPublicHuyaSmsCode( + orderNoInput: unknown, + taskIdInput: unknown, + mobileInput: unknown, +) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + const task = await loadTaskForOrder(orderNo, taskId) + assertHuyaTask(task) + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + throw createHttpError('当前订单已结束,不能重新登录', { + statusCode: 409, + errorCode: 'semi_auto_task_closed', + }) + } + + const result = await sendHuyaSmsCode( + { + taskId: task.id, + orderNo, + mobile: String(mobileInput ?? '').trim(), + }, + task.connector_mode, + ) + const session = result.session + const previousSessionId = task.connector_session_id + try { + await withTransaction(async (client) => { + await client.query( + ` + UPDATE semi_auto_tasks + SET connector_session_id = $2, + login_status = 'waiting_login', + execution_status = 'waiting_customer', + auth_started_at = COALESCE(auth_started_at, NOW()), + last_error = '', + updated_at = NOW() + WHERE id = $1 + `, + [task.id, session.sessionId], + ) + await appendTaskEvent(client, task.id, { + eventType: result.challenge ? 'sms_verification_required' : 'sms_code_sent', + actorType: 'customer', + fromLoginStatus: task.login_status, + toLoginStatus: 'waiting_login', + fromExecutionStatus: task.execution_status, + toExecutionStatus: 'waiting_customer', + detail: { + method: 'sms', + expiresAt: session.expiresAt, + ...(result.challenge ? { verificationType: result.challenge.type } : {}), + }, + }) + }) + } catch (error) { + await revokeHuyaSession(session.sessionId, task.connector_mode).catch(() => undefined) + throw error + } + if (previousSessionId && previousSessionId !== session.sessionId) { + await revokeHuyaSession(previousSessionId, task.connector_mode).catch(() => undefined) + } + return { + ok: !result.challenge, + message: session.message || '验证码已发送,请注意查收', + expiresAt: session.expiresAt, + challenge: result.challenge, + } +} + +export async function verifyPublicHuyaSmsChallenge( + orderNoInput: unknown, + taskIdInput: unknown, + input: { distance?: unknown; angle?: unknown; points?: unknown } = {}, +) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + const task = await loadTaskForOrder(orderNo, taskId) + assertHuyaTask(task) + if (!task.connector_session_id) { + throw createHttpError('虎牙安全验证会话不存在,请重新发送验证码', { + statusCode: 409, + errorCode: 'huya_sms_verification_not_found', + }) + } + const distance = + input.distance === undefined || input.distance === null ? undefined : Number(input.distance) + const angle = input.angle === undefined || input.angle === null ? undefined : Number(input.angle) + const points = Array.isArray(input.points) + ? input.points.map((value) => { + const point = value && typeof value === 'object' ? (value as Record) : {} + return { x: Number(point.x), y: Number(point.y) } + }) + : undefined + if ( + (distance !== undefined && (!Number.isInteger(distance) || distance < 0)) || + (angle !== undefined && (!Number.isInteger(angle) || angle < 0 || angle > 359)) || + (points && + (points.length === 0 || + points.some((point) => !Number.isFinite(point.x) || !Number.isFinite(point.y)))) + ) { + throw createHttpError('安全验证参数无效,请重新完成', { + statusCode: 400, + errorCode: 'huya_sms_verification_solution_invalid', + }) + } + const result = await verifyHuyaSmsChallenge( + { + sessionId: task.connector_session_id, + ...(distance !== undefined ? { distance } : {}), + ...(angle !== undefined ? { angle } : {}), + ...(points ? { points } : {}), + }, + task.connector_mode, + ) + await withTransaction(async (client) => { + await client.query( + ` + UPDATE semi_auto_tasks + SET connector_session_id = $2, + login_status = 'waiting_login', + execution_status = 'waiting_customer', + last_error = '', + updated_at = NOW() + WHERE id = $1 + `, + [task.id, result.session.sessionId], + ) + await appendTaskEvent(client, task.id, { + eventType: result.challenge ? 'sms_verification_required' : 'sms_code_sent', + actorType: 'customer', + fromLoginStatus: task.login_status, + toLoginStatus: 'waiting_login', + fromExecutionStatus: task.execution_status, + toExecutionStatus: 'waiting_customer', + detail: { + method: 'sms', + verificationCompleted: !result.challenge, + }, + }) + }) + return { + ok: !result.challenge, + message: result.session.message || '验证码已发送,请注意查收', + expiresAt: result.session.expiresAt, + challenge: result.challenge, + } +} + +export async function loginPublicHuyaSms( + orderNoInput: unknown, + taskIdInput: unknown, + input: { mobile?: unknown; code?: unknown } = {}, +) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + const task = await loadTaskForOrder(orderNo, taskId) + assertHuyaTask(task) + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + throw createHttpError('当前订单已结束,不能重新登录', { + statusCode: 409, + errorCode: 'semi_auto_task_closed', + }) + } + if (!task.connector_session_id) { + throw createHttpError('请先发送虎牙短信验证码', { + statusCode: 409, + errorCode: 'huya_sms_code_required', + }) + } + + const session = await loginHuyaSms( + { + sessionId: task.connector_session_id, + taskId: task.id, + orderNo, + mobile: String(input.mobile ?? '').trim(), + code: String(input.code ?? '').trim(), + }, + task.connector_mode, + ) + const mapped = mapLoginUpdate(session) + if (session.status !== 'authenticated') { + await updateLoginTask(task, session, 'customer', { + credentialSource: 'sms', + method: 'sms', + }) + throw createHttpError(mapped.message || '虎牙短信登录失败,请重试', { + statusCode: 409, + errorCode: 'huya_login_failed', + }) + } + + await updateLoginTask(task, session, 'customer', { + credentialSource: 'sms', + method: 'sms', + }) + const updated = await loadTask(task.id) + return { + task: mapTask(updated), + login: { + status: mapped.status, + qrContent: '', + qrImage: '', + expiresAt: session.expiresAt, + message: session.message, + }, + } +} + +export async function sendPublicWeiboSmsCode( + orderNoInput: unknown, + taskIdInput: unknown, + mobileInput: unknown, + countryCodeInput: unknown = '86', + mfaIdInput: unknown = '', +) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + const task = await loadTaskForOrder(orderNo, taskId) + assertWeiboTask(task) + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + throw createHttpError('当前订单已结束,不能重新登录', { + statusCode: 409, + errorCode: 'semi_auto_task_closed', + }) + } + const result = await sendWeiboSmsCode( + { + taskId: task.id, + mobile: String(mobileInput ?? '').trim(), + countryCode: String(countryCodeInput ?? '86').trim() || '86', + mfaId: String(mfaIdInput ?? '').trim(), + }, + task.connector_mode, + ) + return { + ok: !result.mfaRequired, + message: result.mfaRequired ? '需要完成微博安全验证' : '验证码已发送,请注意查收', + ...result, + } +} + +export async function loginPublicWeiboSms( + orderNoInput: unknown, + taskIdInput: unknown, + input: { mobile?: unknown; code?: unknown; countryCode?: unknown; rid?: unknown } = {}, +) { + const orderNo = normalizeOrderNo(orderNoInput) + const taskId = normalizeId(taskIdInput) + const task = await loadTaskForOrder(orderNo, taskId) + assertWeiboTask(task) + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + throw createHttpError('当前订单已结束,不能重新登录', { + statusCode: 409, + errorCode: 'semi_auto_task_closed', + }) + } + + const previousSessionId = task.connector_session_id + const { sessionId, session } = await loginWeiboSms( + { + taskId: task.id, + orderNo, + mobile: String(input.mobile ?? '').trim(), + code: String(input.code ?? '').trim(), + countryCode: String(input.countryCode ?? '86').trim() || '86', + rid: String(input.rid ?? '').trim(), + }, + task.connector_mode, + ) + const mapped = mapLoginUpdate(session) + const storedCredential = + session.status === 'authenticated' && session.hasCredential + ? exportWeiboSessionCredential(sessionId, task.connector_mode) + : null + + if (session.status !== 'authenticated') { + await withTransaction(async (client) => { + await client.query( + ` + UPDATE semi_auto_tasks + SET connector_session_id = $2, + login_status = $3, + last_error = $4, + updated_at = NOW() + WHERE id = $1 + `, + [task.id, sessionId, mapped.status, mapped.message], + ) + await appendTaskEvent(client, task.id, { + eventType: 'login_status_changed', + actorType: 'customer', + fromLoginStatus: task.login_status, + toLoginStatus: mapped.status, + fromExecutionStatus: task.execution_status, + toExecutionStatus: task.execution_status, + detail: { method: 'sms', message: mapped.message }, + }) + }) + throw createHttpError(mapped.message || '微博登录失败,请重试', { + statusCode: 409, + errorCode: 'weibo_login_failed', + }) + } + + const nextExecutionStatus: ExecutionStatus = 'waiting_operator' + await withTransaction(async (client) => { + const credentialId = storedCredential + ? await upsertSemiAutoCredentialWithClient(client, { + platform: 'weibo', + source: 'sms', + payload: storedCredential, + }) + : null + await client.query( + ` + UPDATE semi_auto_tasks + SET connector_session_id = $2, + credential_id = COALESCE($5, credential_id), + login_status = 'authenticated', + execution_status = 'waiting_operator', + huya_uid = CASE WHEN $3 <> '' THEN $3 ELSE huya_uid END, + platform_nickname = CASE WHEN $4 <> '' THEN $4 ELSE platform_nickname END, + auth_started_at = COALESCE(auth_started_at, NOW()), + authenticated_at = COALESCE(authenticated_at, NOW()), + last_error = '', + updated_at = NOW() + WHERE id = $1 + `, + [task.id, sessionId, mapped.uid, mapped.nickname, credentialId], + ) + await appendTaskEvent(client, task.id, { + eventType: 'login_status_changed', + actorType: 'customer', + fromLoginStatus: task.login_status, + toLoginStatus: 'authenticated', + fromExecutionStatus: task.execution_status, + toExecutionStatus: nextExecutionStatus, + detail: { method: 'sms', hasCredential: mapped.hasCredential, message: mapped.message }, + }) + }) + + if (previousSessionId && previousSessionId !== sessionId) { + await revokeWeiboSession(previousSessionId, task.connector_mode).catch(() => undefined) + } + publishSemiAutoTaskRealtimeChange(task.id, task.order_id) + const updated = await loadTask(task.id) + return { + task: mapTask(updated), + login: { + status: mapped.status, + qrContent: '', + qrImage: '', + expiresAt: session.expiresAt, + message: session.message, + }, + } +} + +export async function getPublicWeiboCountryCodes(orderNoInput: unknown, taskIdInput: unknown) { + const task = await loadTaskForOrder(normalizeOrderNo(orderNoInput), normalizeId(taskIdInput)) + assertWeiboTask(task) + return { countryCodes: await getWeiboCountryCodes(task.connector_mode) } +} + +export async function startPublicWeiboQrLogin(orderNoInput: unknown, taskIdInput: unknown) { + const task = await loadTaskForOrder(normalizeOrderNo(orderNoInput), normalizeId(taskIdInput)) + assertWeiboTask(task) + return startPublicLogin(orderNoInput, taskIdInput) +} + +export async function pollPublicWeiboQrLogin(orderNoInput: unknown, taskIdInput: unknown) { + const task = await loadTaskForOrder(normalizeOrderNo(orderNoInput), normalizeId(taskIdInput)) + assertWeiboTask(task) + return pollPublicLogin(orderNoInput, taskIdInput) +} diff --git a/apps/backend/src/services/semi-auto/semi-auto-task-core.ts b/apps/backend/src/services/semi-auto/semi-auto-task-core.ts new file mode 100644 index 00000000..ef4f70b7 --- /dev/null +++ b/apps/backend/src/services/semi-auto/semi-auto-task-core.ts @@ -0,0 +1,1085 @@ +import type { PoolClient } from 'pg' + +import { query, withTransaction } from '../../db/client.js' +import type { AdminSession } from '../admin/admin-auth-service.js' +import { + confirmManualFulfillment, + runManualFulfillmentPostCommit, +} from '../finance/manual-fulfillment-service.js' +import { getFileAssetByObjectKey } from '../../repositories/file-asset-repo.js' +import { createHttpError } from '../../utils/http.js' +import { nowIso } from '../../utils/time.js' +import { safeParseJson } from '../admin/admin-query-utils.js' +import { + publishAdminOrderRealtimeChange, + publishRealtimeEvent, +} from '../realtime/realtime-event-service.js' +import { + buildFileUrl, + ORDER_SERVICE_SCREENSHOT_CONTENT_TYPES, + type UploadedFileDto, +} from '../file-storage/file-storage-service.js' +import { + defaultSemiAutoConnectorMode, + createHuyaBrowserTicket, + createHuyaLoginSession, + confirmHuyaBinding, + exportHuyaSessionCredential, + getHuyaBinding, + getHuyaBindingSnapshot, + getHuyaLoginSession, + loginHuyaSms, + resetHuyaBinding, + revokeHuyaSession, + sendHuyaSmsCode, + startHuyaBinding, + submitHuyaRebind, + consumeHuyaBrowserTicket, + verifyHuyaSmsChallenge, + type ConnectorBindingSession, + type ConnectorInjectionPayload, + type SemiAutoConnectorMode, + type ConnectorLoginSession, +} from './huya-connector-client.js' +import { + consumeWeiboBrowserTicket, + createWeiboBrowserTicket, + createWeiboLoginSession, + exportWeiboSessionCredential, + getWeiboBinding, + getWeiboCountryCodes, + getWeiboLoginSession, + loginWeiboSms, + restoreWeiboSessionFromCredential, + revokeWeiboSession, + sendWeiboSmsCode, +} from './weibo-connector-client.js' +import { WEIBO_TICKET_PREFIX } from './weibo-native/weibo-native-connector.js' +import { + buildSemiAutoCredentialCookieHeader, + loadSemiAutoCredential, + markSemiAutoCredentialCheck, + upsertSemiAutoCredentialWithClient, +} from './semi-auto-credential-service.js' +import { querySemiAutoTraces } from './semi-auto-trace.js' +import { isNumericBindingRoleId } from './binding-role-id.js' + +const SEMI_AUTO_PLATFORMS = new Set(['huya', 'weibo']) +const ADMIN_LIST_BACKFILL_INTERVAL_MS = 15_000 +export type SemiAutoPlatform = 'huya' | 'weibo' +export type LoginStatus = + | 'waiting_login' + | 'qr_pending' + | 'scanned' + | 'authenticated' + | 'failed' + | 'expired' +export type BindingStatus = + | 'not_started' + | 'qr_pending' + | 'scanned' + | 'role_ready' + | 'confirmed' + | 'failed' + | 'expired' +export type ExecutionStatus = + | 'waiting_customer' + | 'waiting_operator' + | 'processing' + | 'completed' + | 'failed' + | 'cancelled' + +export type TaskRow = { + id: number + order_id: number + order_item_id: number + fulfillment_id: number | null + manual_fulfillment_config_id: number | null + platform: SemiAutoPlatform + login_status: LoginStatus + binding_status: BindingStatus + execution_status: ExecutionStatus + connector_mode: SemiAutoConnectorMode + connector_session_id: string + credential_id: number | null + credential_status: 'unknown' | 'valid' | 'invalid' | 'error' | null + credential_source: string | null + credential_updated_at: string | null + huya_uid: string + platform_nickname: string + bind_game_account: string + bind_game_role: string + bind_game_role_id: string + bind_game_channel: string + customer_game_role_name: string + customer_game_role_id: string + customer_game_server_zone: string + customer_game_id: string + customer_game_role: string + customer_server_zone: string + target_quantity: number + completed_quantity: number + assigned_admin_user_id: number | null + assigned_admin_name?: string + customer_link_opened_at: string | null + auth_started_at: string | null + authenticated_at: string | null + binding_started_at: string | null + bound_at: string | null + completed_at: string | null + completion_note: string + external_order_no: string + completion_evidence_json: Record + last_error: string + created_at: string + updated_at: string + platform_order_id: string + provider: string + shop_id: string + sku_code: string + sku_name: string + quantity: number + product_name: string + manual_platform_key: string + manual_cost_mode: string + manual_credit_quantity: number | string + semi_auto_config_json: Record +} + +export type TaskEventInput = { + eventType: string + actorType?: 'system' | 'customer' | 'admin' | 'connector' + actorId?: string + fromLoginStatus?: LoginStatus | null + toLoginStatus?: LoginStatus | null + fromBindingStatus?: BindingStatus | null + toBindingStatus?: BindingStatus | null + fromExecutionStatus?: ExecutionStatus | null + toExecutionStatus?: ExecutionStatus | null + detail?: Record +} + +export type TaskActorType = 'system' | 'customer' | 'admin' | 'connector' + +let lastAdminListBackfillAt = 0 +let adminListBackfillInFlight: Promise | null = null + +export function publishSemiAutoTaskRealtimeChange(taskId: number, orderId: number) { + publishRealtimeEvent({ + type: 'order.changed', + entityId: Math.max(0, Number(orderId) || 0), + scopes: ['admin_semi_auto_tasks'], + operation: 'refresh', + data: { taskId: Number(taskId) || 0 }, + admin: true, + }) +} + +export async function ensureSemiAutoTasksForAdminList() { + if (adminListBackfillInFlight) return adminListBackfillInFlight + if (Date.now() - lastAdminListBackfillAt < ADMIN_LIST_BACKFILL_INTERVAL_MS) return + lastAdminListBackfillAt = Date.now() + const createdAfter = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString() + adminListBackfillInFlight = backfillSemiAutoTasks({ createdAfter, limit: 500 }) + .then(() => undefined) + .catch((error) => { + lastAdminListBackfillAt = 0 + throw error + }) + .finally(() => { + adminListBackfillInFlight = null + }) + return adminListBackfillInFlight +} + +export function normalizeId(value: unknown, label = '任务 ID'): number { + const id = Number(value) + if (!Number.isInteger(id) || id <= 0) { + throw createHttpError(`${label}无效`, { + statusCode: 400, + errorCode: 'semi_auto_task_id_invalid', + }) + } + return id +} + +export function normalizeOrderNo(value: unknown): string { + const text = String(value ?? '').trim() + if (!text) { + throw createHttpError('订单号无效,请确认订单号是否正确', { + statusCode: 404, + errorCode: 'semi_auto_order_not_found', + }) + } + return text +} + +/** 客户资料以 TASK_SELECT 合并后的字段为准:优先任务表,回退工单资料。 */ +export function hasCustomerProfile( + task: Pick, +): boolean { + return Boolean( + String(task.customer_game_id || '').trim() && + String(task.customer_game_role || '').trim() && + String(task.customer_server_zone || '').trim(), + ) +} + +export function displayStatus(task: TaskRow) { + const status = ( + key: string, + label: string, + owner: 'none' | 'customer' | 'operator' | 'system', + nextAction: string, + ) => ({ key, label, owner, nextAction }) + if (task.execution_status === 'completed') { + return status('completed', '已完成', 'none', '无需操作') + } + if (task.execution_status === 'cancelled') { + return status('cancelled', '已取消', 'none', '无需操作') + } + if (task.credential_status === 'invalid' || task.credential_status === 'error') { + return status('credential_expired', '登录已失效,需重新授权', 'operator', '重发客户授权') + } + if (task.execution_status === 'failed' || task.login_status === 'failed') { + return status('failed', '需客服处理', 'operator', '客服检查并重试') + } + if (task.execution_status === 'processing') { + return status('processing', '处理中', 'operator', '客服继续履约') + } + if (task.login_status === 'authenticated') { + // 虎牙需要客户确认绑定角色后才算授权完成;微博登录即授权。 + if (task.platform === 'weibo' || task.binding_status === 'confirmed') { + return status('waiting_operator', '等待客服处理', 'operator', '客服领取并履约') + } + if (task.platform === 'huya' && !hasCustomerProfile(task)) { + return status('waiting_profile', '待客户填写资料', 'customer', '客户填写区服、编号和角色名') + } + if (task.binding_status === 'role_ready') { + return status('binding_confirm', '待确认绑定角色', 'customer', '核对角色并提交绑定') + } + if (task.binding_status === 'expired') { + return status('binding_expired', '绑定二维码已过期', 'customer', '刷新绑定二维码') + } + if (task.binding_status === 'failed') { + return status('binding_failed', '绑定失败,需重新扫码', 'customer', '重新扫码绑定') + } + return status('waiting_binding', '等待客户绑定角色', 'customer', '客户完成角色绑定') + } + if (task.login_status === 'scanned') { + return status('login_scanned', '已扫码,确认中', 'customer', '客户在平台确认登录') + } + if (task.login_status === 'qr_pending') { + return status('waiting_login', '等待客户登录', 'customer', '客户扫码登录') + } + return status('waiting_customer', '等待客户授权', 'customer', '客户打开链接完成登录') +} + +export function mapTask(task: TaskRow) { + return { + id: Number(task.id), + orderId: Number(task.order_id), + orderItemId: Number(task.order_item_id), + fulfillmentId: task.fulfillment_id ? Number(task.fulfillment_id) : null, + platform: task.platform, + platformLabel: + task.platform === 'huya' ? '虎牙' : task.platform === 'weibo' ? '微博' : task.platform, + loginStatus: task.login_status, + bindingStatus: task.binding_status, + executionStatus: task.execution_status, + connectorMode: task.connector_mode, + displayStatus: displayStatus(task), + connectorReady: Boolean(task.connector_session_id || task.credential_id), + credentialReady: Boolean(task.credential_id), + credentialStatus: task.credential_status || 'unknown', + credentialSource: task.credential_source || '', + credentialUpdatedAt: task.credential_updated_at, + huyaUid: task.huya_uid, + platformNickname: task.platform_nickname, + bindGameAccount: task.bind_game_account, + bindGameRole: task.bind_game_role, + bindGameRoleId: task.bind_game_role_id, + bindGameChannel: task.bind_game_channel, + customerGameRoleId: task.customer_game_id || '', + customerGameRoleName: task.customer_game_role || '', + customerServerZone: task.customer_server_zone || '', + targetQuantity: Number(task.target_quantity || 1), + completedQuantity: Number(task.completed_quantity || 0), + assignedAdminUserId: task.assigned_admin_user_id ? Number(task.assigned_admin_user_id) : null, + assignedAdminName: String(task.assigned_admin_name || ''), + customerLinkOpenedAt: task.customer_link_opened_at, + authStartedAt: task.auth_started_at, + authenticatedAt: task.authenticated_at, + bindingStartedAt: task.binding_started_at, + boundAt: task.bound_at, + completedAt: task.completed_at, + completionNote: task.completion_note, + externalOrderNo: task.external_order_no, + completionEvidence: task.completion_evidence_json || {}, + lastError: task.last_error, + createdAt: task.created_at, + updatedAt: task.updated_at, + orderNo: task.platform_order_id, + provider: task.provider, + shopId: task.shop_id, + skuCode: task.sku_code, + skuName: task.sku_name, + productName: task.product_name, + quantity: Number(task.quantity || 1), + semiAutoConfig: task.semi_auto_config_json || {}, + } +} + +export type SemiAutoTaskDto = ReturnType + +export async function appendTaskEvent( + client: Pick, + taskId: number, + event: TaskEventInput, +) { + await client.query( + ` + INSERT INTO semi_auto_task_events ( + task_id, event_type, actor_type, actor_id, + from_login_status, to_login_status, + from_binding_status, to_binding_status, + from_execution_status, to_execution_status, + detail_json, created_at + ) VALUES ( + $1, $2, $3, $4, + $5, $6, + $7, $8, + $9, $10, + $11::jsonb, NOW() + ) + `, + [ + taskId, + event.eventType, + event.actorType || 'system', + event.actorId || '', + event.fromLoginStatus || null, + event.toLoginStatus || null, + event.fromBindingStatus || null, + event.toBindingStatus || null, + event.fromExecutionStatus || null, + event.toExecutionStatus || null, + JSON.stringify(event.detail || {}), + ], + ) +} + +export const TASK_SELECT = ` + SELECT + task.*, + admin.display_name AS assigned_admin_name, + o.platform_order_id, + o.provider, + o.shop_id, + oi.sku_code, + oi.sku_name, + oi.quantity, + COALESCE(NULLIF(oi.sku_name, ''), NULLIF(oi.sku_code, ''), '订单商品') AS product_name, + cfg.platform_key AS manual_platform_key, + cfg.cost_mode AS manual_cost_mode, + cfg.credit_quantity AS manual_credit_quantity, + cfg.semi_auto_config_json, + credential.credential_status, + credential.credential_source, + credential.credential_updated_at, + COALESCE( + NULLIF(task.customer_game_role_id, ''), + wo.material_json->'collect'->'fields'->>'gameId', + wo.material_json->'collect'->'fields'->>'characterId', + '' + ) AS customer_game_id, + COALESCE( + NULLIF(task.customer_game_role_name, ''), + NULLIF(wo.material_json->'collect'->'fields'->>'gameNickname', ''), + NULLIF(wo.material_json->'collect'->'fields'->>'roleName', ''), + '' + ) AS customer_game_role, + COALESCE( + NULLIF(task.customer_game_server_zone, ''), + wo.material_json->'collect'->'fields'->>'serverZone', + '' + ) AS customer_server_zone + FROM semi_auto_tasks task + JOIN orders o ON o.id = task.order_id + JOIN order_items oi ON oi.id = task.order_item_id + LEFT JOIN manual_fulfillment_configs cfg ON cfg.id = task.manual_fulfillment_config_id + LEFT JOIN admin_users admin ON admin.id = task.assigned_admin_user_id + LEFT JOIN semi_auto_credentials credential ON credential.id = task.credential_id + LEFT JOIN LATERAL ( + SELECT candidate.material_json + FROM work_orders candidate + WHERE candidate.order_item_id = task.order_item_id + OR (candidate.order_item_id IS NULL AND candidate.order_id = task.order_id) + OR (o.platform_order_id <> '' AND candidate.platform_order_id = o.platform_order_id) + ORDER BY (candidate.order_item_id = task.order_item_id) DESC NULLS LAST, + (candidate.order_id = task.order_id) DESC NULLS LAST, + candidate.id DESC + LIMIT 1 + ) wo ON TRUE +` + +export async function loadTask(taskId: number): Promise { + const result = await query(`${TASK_SELECT} WHERE task.id = $1 LIMIT 1`, [taskId]) + const task = result.rows[0] + if (!task) { + throw createHttpError('半自动履约任务不存在', { + statusCode: 404, + errorCode: 'semi_auto_task_not_found', + }) + } + return task +} + +export async function loadTaskForOrder(orderNo: string, taskId: number): Promise { + const task = await loadTask(taskId) + if (String(task.platform_order_id || '').trim() !== orderNo) { + throw createHttpError('订单号或任务无效', { + statusCode: 404, + errorCode: 'semi_auto_task_not_found', + }) + } + return task +} + +export async function loadTaskForUpdateWithClient( + client: PoolClient, + taskId: number, +): Promise { + const result = await client.query( + `${TASK_SELECT} WHERE task.id = $1 LIMIT 1 FOR UPDATE OF task`, + [taskId], + ) + const task = result.rows[0] + if (!task) { + throw createHttpError('半自动履约任务不存在', { + statusCode: 404, + errorCode: 'semi_auto_task_not_found', + }) + } + return task +} + +export function assertWeiboTask(task: TaskRow) { + if (task.platform !== 'weibo') { + throw createHttpError('当前任务不是微博任务', { + statusCode: 409, + errorCode: 'semi_auto_platform_mismatch', + }) + } +} + +export function assertHuyaTask(task: TaskRow) { + if (task.platform !== 'huya') { + throw createHttpError('当前任务不是虎牙任务', { + statusCode: 409, + errorCode: 'semi_auto_platform_mismatch', + }) + } +} + +/** + * 半自动订单没有工单时,客户资料在登录后由 /c/<订单号> 收集; + * 任务表为空但工单素材已有资料时,TASK_SELECT 会合并回退字段。 + * 进入绑定/确认/换绑前必须已有完整三项资料。 + */ +export function assertCustomerProfileReady(task: TaskRow) { + if (task.platform !== 'huya') return + if (!hasCustomerProfile(task)) { + throw createHttpError('请先提交游戏角色资料', { + statusCode: 409, + errorCode: 'semi_auto_profile_required', + }) + } +} + +export async function createLoginSessionForTask( + task: TaskRow, + orderNo: string, +): Promise { + const input = { taskId: task.id, orderNo } + return task.platform === 'weibo' + ? createWeiboLoginSession(input, task.connector_mode) + : createHuyaLoginSession(input, task.connector_mode) +} + +export async function getLoginSessionForTask( + task: TaskRow, + sessionId: string, +): Promise { + return task.platform === 'weibo' + ? getWeiboLoginSession(sessionId, task.connector_mode) + : getHuyaLoginSession(sessionId, task.connector_mode) +} + +export async function revokeSessionForTask(task: TaskRow, sessionId: string): Promise { + if (task.platform === 'weibo') { + await revokeWeiboSession(sessionId, task.connector_mode) + return + } + await revokeHuyaSession(sessionId, task.connector_mode) +} + +export async function getBindingForTask( + task: TaskRow, + sessionId: string, +): Promise { + return task.platform === 'weibo' + ? getWeiboBinding(sessionId, task.connector_mode) + : getHuyaBinding(sessionId, task.connector_mode) +} + +function errorCodeOf(error: unknown) { + return error && typeof error === 'object' + ? String((error as { errorCode?: unknown }).errorCode || '').trim() + : '' +} + +function isInvalidCredentialError(error: unknown) { + return ['weibo_credential_invalid', 'weibo_credential_account_mismatch'].includes( + errorCodeOf(error), + ) +} + +export async function resetTaskForCustomerLogin( + task: TaskRow, + input: { + actorType: TaskActorType + actorId?: string + reason: string + eventType: string + }, +) { + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { + return task + } + await withTransaction(async (client) => { + const current = await loadTaskForUpdateWithClient(client, task.id) + if (current.execution_status === 'completed' || current.execution_status === 'cancelled') { + return + } + await client.query( + ` + UPDATE semi_auto_tasks + SET connector_session_id = '', + login_status = 'waiting_login', + binding_status = 'not_started', + execution_status = 'waiting_customer', + bind_game_account = '', + bind_game_role = '', + bind_game_role_id = '', + bind_game_channel = '', + customer_link_opened_at = NULL, + auth_started_at = NULL, + authenticated_at = NULL, + binding_started_at = NULL, + bound_at = NULL, + last_error = $2, + updated_at = NOW() + WHERE id = $1 + `, + [task.id, input.reason], + ) + await appendTaskEvent(client, task.id, { + eventType: input.eventType, + actorType: input.actorType, + ...(input.actorId ? { actorId: input.actorId } : {}), + fromLoginStatus: current.login_status, + toLoginStatus: 'waiting_login', + fromBindingStatus: current.binding_status, + toBindingStatus: 'not_started', + fromExecutionStatus: current.execution_status, + toExecutionStatus: 'waiting_customer', + detail: { reason: input.reason }, + }) + }) + publishAdminOrderRealtimeChange(Number(task.order_id)) + publishSemiAutoTaskRealtimeChange(task.id, task.order_id) + return loadTask(task.id) +} + +export async function ensureConnectorSessionForTask(task: TaskRow): Promise { + if (task.execution_status === 'completed' || task.execution_status === 'cancelled') return task + if (task.connector_session_id) { + try { + const session = await getLoginSessionForTask(task, task.connector_session_id) + if (session.status === 'authenticated') return task + } catch { + // 进程重启或多实例切换后,内存会话会丢失;下面用已保存的账号 CK 恢复。 + } + } + if (task.platform !== 'weibo' || !task.credential_id) return task + const credential = await loadSemiAutoCredential(task.credential_id) + if (!credential || credential.platform !== 'weibo') return task + try { + const session = await restoreWeiboSessionFromCredential( + { + taskId: task.id, + orderNo: task.platform_order_id, + platformUid: credential.platformUid, + nickname: credential.nickname, + cookies: credential.cookies, + }, + task.connector_mode, + ) + await markSemiAutoCredentialCheck(task.credential_id, { status: 'valid' }) + await withTransaction(async (client) => { + await client.query( + ` + UPDATE semi_auto_tasks + SET connector_session_id = $2, + login_status = 'authenticated', + huya_uid = CASE WHEN $3 <> '' THEN $3 ELSE huya_uid END, + platform_nickname = CASE WHEN $4 <> '' THEN $4 ELSE platform_nickname END, + last_error = '', + updated_at = NOW() + WHERE id = $1 + `, + [task.id, session.sessionId, session.huyaUid, session.nickname], + ) + await appendTaskEvent(client, task.id, { + eventType: 'credential_session_restored', + actorType: 'connector', + detail: { + credentialId: task.credential_id, + hasCredential: session.hasCredential, + }, + }) + }) + return loadTask(task.id) + } catch (error) { + const credentialInvalid = isInvalidCredentialError(error) + await markSemiAutoCredentialCheck(task.credential_id, { + status: credentialInvalid ? 'invalid' : 'error', + error: error instanceof Error ? error.message : String(error), + }).catch(() => undefined) + if (credentialInvalid) { + return resetTaskForCustomerLogin(task, { + actorType: 'connector', + reason: '平台登录凭证已失效,需客户重新登录', + eventType: 'credential_invalidated', + }) + } + throw error + } +} + +type SemiAutoCandidate = { + order_id: number + platform_order_id: string + order_item_id: number + fulfillment_id: number + manual_fulfillment_config_id: number + platform: SemiAutoPlatform + quantity: number +} + +async function insertMissingSemiAutoTasksWithClient( + client: PoolClient, + orderNo?: string, + orderItemIds?: number[], + options: { createdAfter?: string; limit?: number } = {}, +) { + const params: unknown[] = [] + const filters: string[] = [] + if (orderNo) { + params.push(orderNo) + filters.push(`o.platform_order_id = $${params.length}`) + } + const normalizedItemIds = [ + ...new Set((orderItemIds || []).map(Number).filter((id) => Number.isInteger(id) && id > 0)), + ] + if (normalizedItemIds.length > 0) { + params.push(normalizedItemIds) + filters.push(`oi.id = ANY($${params.length}::bigint[])`) + } + if (options.createdAfter) { + params.push(options.createdAfter) + filters.push(`COALESCE(o.paid_at, o.created_at) >= $${params.length}::timestamptz`) + } + const itemFilter = filters.length > 0 ? `AND ${filters.join(' AND ')}` : '' + const limit = + Number.isInteger(options.limit) && Number(options.limit) > 0 + ? Math.min(5000, Math.trunc(Number(options.limit))) + : null + const limitSql = limit ? `LIMIT ${limit}` : '' + const candidates = await client.query( + ` + SELECT + o.id AS order_id, + o.platform_order_id, + oi.id AS order_item_id, + f.id AS fulfillment_id, + cfg.id AS manual_fulfillment_config_id, + cfg.semi_auto_platform AS platform, + GREATEST(1, COALESCE(oi.quantity, 1))::int AS quantity + FROM orders o + JOIN order_items oi ON oi.order_id = o.id + JOIN fulfillments f ON f.order_item_id = oi.id + JOIN manual_fulfillment_configs cfg ON cfg.id = f.fulfillment_config_id + WHERE f.channel = 'manual' + AND f.status = 'assigned' + AND cfg.enabled = TRUE + AND cfg.semi_auto_enabled = TRUE + AND cfg.semi_auto_platform IN ('huya', 'weibo') + ${itemFilter} + AND NOT EXISTS ( + SELECT 1 FROM semi_auto_tasks existing WHERE existing.order_item_id = oi.id + ) + ORDER BY o.id DESC, oi.id ASC + ${limitSql} + `, + params, + ) + + const createdIds: number[] = [] + const orderIds = new Set() + for (const row of candidates.rows) { + const connectorMode = row.platform === 'weibo' ? 'embedded' : defaultSemiAutoConnectorMode() + const inserted = await client.query<{ id: number }>( + ` + INSERT INTO semi_auto_tasks ( + order_id, order_item_id, fulfillment_id, manual_fulfillment_config_id, + platform, connector_mode, target_quantity, created_at, updated_at + ) VALUES ($1, $2, $3, $4, $5, $6, $7, NOW(), NOW()) + ON CONFLICT (order_item_id) DO NOTHING + RETURNING id + `, + [ + Number(row.order_id), + Number(row.order_item_id), + Number(row.fulfillment_id), + Number(row.manual_fulfillment_config_id), + row.platform, + connectorMode, + Number(row.quantity || 1), + ], + ) + const taskId = Number(inserted.rows[0]?.id || 0) + if (!taskId) continue + createdIds.push(taskId) + orderIds.add(Number(row.order_id)) + await appendTaskEvent(client, taskId, { + eventType: 'task_created', + toLoginStatus: 'waiting_login', + toBindingStatus: 'not_started', + toExecutionStatus: 'waiting_customer', + detail: { orderNo: row.platform_order_id, connectorMode }, + }) + } + return { createdIds, orderIds: [...orderIds] } +} + +export async function ensureSemiAutoTasksForOrder(orderNoInput: unknown) { + const orderNo = normalizeOrderNo(orderNoInput) + const result = await withTransaction((client) => + insertMissingSemiAutoTasksWithClient(client, orderNo), + ) + if (result.orderIds[0]) { + publishAdminOrderRealtimeChange(result.orderIds[0]) + publishSemiAutoTaskRealtimeChange(result.createdIds[0] || 0, result.orderIds[0]) + } + return { orderNo, createdIds: result.createdIds } +} + +export async function ensureSemiAutoTasksForOrderItems(input: unknown[]) { + const orderItemIds = [ + ...new Set( + (Array.isArray(input) ? input : []) + .map(Number) + .filter((id) => Number.isInteger(id) && id > 0), + ), + ] + if (orderItemIds.length === 0) return { createdIds: [], orderIds: [] } + const result = await withTransaction((client) => + insertMissingSemiAutoTasksWithClient(client, undefined, orderItemIds), + ) + for (const orderId of result.orderIds) { + publishAdminOrderRealtimeChange(orderId) + publishSemiAutoTaskRealtimeChange(result.createdIds[0] || 0, orderId) + } + return { createdIds: result.createdIds, orderIds: result.orderIds } +} + +/** + * 后台列表读取前的幂等回填。 + * + * 客户不先打开 `/c/订单号` 或 `/d/订单号` 时,任务也必须进入客服工作台;后备查询只插入缺失任务, + * 不修改已有任务状态,也不会重复写事件。 + */ +export async function backfillSemiAutoTasks( + options: { createdAfter?: string; limit?: number } = {}, +) { + const result = await withTransaction((client) => + insertMissingSemiAutoTasksWithClient(client, undefined, undefined, options), + ) + for (const orderId of result.orderIds) { + publishSemiAutoTaskRealtimeChange(result.createdIds[0] || 0, orderId) + } + return { createdIds: result.createdIds, orderIds: result.orderIds } +} + +export type BindingRoleComparison = { + verdict: 'match' | 'mismatch' | 'unknown' + customerRoleName: string + customerRoleId: string + customerZone: string + boundRoleName: string + boundRoleId: string + boundZone: string + message: string +} + +function normalizeRoleText(value: unknown): string { + return String(value ?? '') + .replace(/\s+/g, '') + .toLowerCase() +} + +function normalizeServerZone(value: unknown): string { + const text = String(value ?? '').trim() + + if (!text) return '' + + return /区$/.test(text) ? text : `${text}区` +} + +/** + * 从虎牙渠道串解析区服,例如「安卓(android) · 微信」→ 安卓V区。 + * 解析不出平台或登录方式时返回空串,比对时按「平台区服缺失」处理(判 unknown)。 + */ +export function detectServerZone(channel: unknown): string { + const text = String(channel ?? '') + .replace(/\s+/g, '') + .toLowerCase() + + if (!text) return '' + + const platform = /苹果|ios/.test(text) ? '苹果' : /安卓|android/.test(text) ? '安卓' : '' + + if (!platform) return '' + + const login = /qq|q区/.test(text) ? 'Q' : /微信|wechat|v区/.test(text) ? 'V' : '' + + return login ? `${platform}${login}区` : '' +} + +/** + * 客户填写角色与平台识别角色必须完全一致才允许提交平台绑定。 + * + * 区服、角色名、角色 ID 三项必须全部存在且一致: + * ① 客户游戏编号 = 虎牙账号 UID,与平台可核对角色 ID 相等; + * ② 角色名按规范化文本相等(忽略空白与大小写差异不能放行改名); + * ③ 平台渠道能解析出区服且与客户所填区服相等。 + * 任一侧缺任一项(含平台只给加密 roleId 且拿不到 UID)判 unknown,转客服核对; + * 任一项不等判 mismatch,不允许提交平台绑定。 + */ +export function compareBindingRole( + task: Pick< + TaskRow, + 'customer_game_id' | 'customer_game_role' | 'customer_game_server_zone' | 'huya_uid' + >, + binding: { bindGameRole?: string; bindGameRoleId?: string; bindGameChannel?: string }, +): BindingRoleComparison { + const customerRoleName = String(task.customer_game_role || '').trim() + const customerRoleId = String(task.customer_game_id || '').trim() + const customerZone = normalizeServerZone(task.customer_game_server_zone) + const boundRoleName = String(binding.bindGameRole || '').trim() + const rawBoundRoleId = String(binding.bindGameRoleId || '').trim() + // 虎牙 gameRole.roleId 是 40 位加密串,客户填写的是数值游戏编号; + // 平台侧可比对的是登录账号的数值 UID(huyaUid),不能拿加密串直接比对。 + const numericHuyaUid = /^\d+$/.test(String(task.huya_uid || '').trim()) + ? String(task.huya_uid).trim() + : '' + const boundRoleId = /^\d+$/.test(rawBoundRoleId) + ? rawBoundRoleId + : numericHuyaUid || rawBoundRoleId + const boundZone = detectServerZone(binding.bindGameChannel) + const base = { + customerRoleName, + customerRoleId, + customerZone, + boundRoleName, + boundRoleId, + boundZone, + } + + // 客户确认的口径:区服、角色名、角色 ID 三项必须全部存在且一致。 + const missing: string[] = [] + if (!customerRoleId) missing.push('客户游戏编号') + if (!customerRoleName) missing.push('客户角色名') + if (!customerZone) missing.push('客户区服') + if (!boundRoleId || !isNumericBindingRoleId(boundRoleId)) missing.push('平台可核对角色ID') + if (!boundRoleName) missing.push('平台角色名') + if (!boundZone) missing.push('平台区服') + if (missing.length > 0) { + return { + ...base, + verdict: 'unknown', + message: `缺少${missing.join('、')},无法核对绑定角色,请联系客服`, + } + } + + if (customerRoleId !== boundRoleId) { + return { ...base, verdict: 'mismatch', message: '两侧角色 ID 不一致,无法提交平台绑定' } + } + + if (normalizeRoleText(customerRoleName) !== normalizeRoleText(boundRoleName)) { + return { ...base, verdict: 'mismatch', message: '两侧角色名称不一致,无法提交平台绑定' } + } + + if (customerZone !== boundZone) { + return { ...base, verdict: 'mismatch', message: '两侧区服不一致,无法提交平台绑定' } + } + + return { + ...base, + verdict: 'match', + message: '两侧区服、角色名称、角色 ID 一致,可提交平台绑定', + } +} + +function mapBindingUpdate(session: ConnectorBindingSession) { + const statusMap: Record = { + not_started: 'not_started', + qr_pending: 'qr_pending', + scanned: 'scanned', + role_ready: 'role_ready', + confirmed: 'confirmed', + expired: 'expired', + failed: 'failed', + } + return { + status: statusMap[session.status] || 'failed', + qrImage: String(session.qrImage || ''), + qrExpiresAt: String(session.qrExpiresAt || ''), + qrUrl: String(session.qrUrl || ''), + bindGameAccount: String(session.bindGameAccount || ''), + bindGameRole: String(session.bindGameRole || ''), + bindGameRoleId: String(session.bindGameRoleId || ''), + bindGameChannel: String(session.bindGameChannel || ''), + hasExistingBinding: session.hasExistingBinding === true, + rebindRequested: session.rebindRequested === true, + rebindUnchanged: session.rebindUnchanged === true, + rebindConfirmState: session.rebindConfirmState || 'idle', + rebindConfirmMessage: String(session.rebindConfirmMessage || ''), + bindConfirmState: session.bindConfirmState || 'idle', + bindConfirmMessage: String(session.bindConfirmMessage || ''), + rebindCooldownDays: Number(session.rebindCooldownDays || 0), + nextRebindAt: String(session.nextRebindAt || ''), + platformChangeBindDay: Number(session.platformChangeBindDay || 0), + platformChangeBindTime: Number(session.platformChangeBindTime || 0), + message: String(session.message || ''), + } +} + +export async function updateBindingTask( + task: TaskRow, + session: ConnectorBindingSession, + actorType: TaskActorType, +) { + const mapped = mapBindingUpdate(session) + const roleIdVerified = isNumericBindingRoleId(mapped.bindGameRoleId) + const requiresSupport = + (Boolean(mapped.bindGameRole) || mapped.hasExistingBinding === true) && !roleIdVerified + const comparison = await withTransaction(async (client) => { + const current = await loadTaskForUpdateWithClient(client, task.id) + const currentComparison = compareBindingRole(current, mapped) + if (current.execution_status === 'completed' || current.execution_status === 'cancelled') { + return currentComparison + } + const executionStatus: ExecutionStatus = + mapped.status === 'confirmed' ? 'waiting_operator' : 'waiting_customer' + await client.query( + ` + UPDATE semi_auto_tasks + SET binding_status = $2, + bind_game_account = CASE WHEN $3 <> '' THEN $3 ELSE bind_game_account END, + bind_game_role = CASE WHEN $4 <> '' THEN $4 ELSE bind_game_role END, + bind_game_role_id = CASE WHEN $8 <> '' THEN $8 ELSE bind_game_role_id END, + bind_game_channel = CASE WHEN $5 <> '' THEN $5 ELSE bind_game_channel END, + bound_at = CASE WHEN $2 IN ('role_ready', 'confirmed') THEN COALESCE(bound_at, NOW()) ELSE bound_at END, + execution_status = $6, + last_error = CASE WHEN $2 IN ('failed', 'expired') THEN $7 ELSE '' END, + updated_at = NOW() + WHERE id = $1 + `, + [ + current.id, + mapped.status, + mapped.bindGameAccount, + mapped.bindGameRole, + mapped.bindGameChannel, + executionStatus, + mapped.message, + mapped.bindGameRoleId, + ], + ) + // 轮询会每 2 秒调用一次:只有状态/执行状态变化,或换绑被拒这类关键信号才写事件。 + const bindingChanged = + mapped.status !== current.binding_status || + executionStatus !== current.execution_status || + mapped.rebindUnchanged || + mapped.rebindConfirmState === 'rejected' + if (bindingChanged) { + await appendTaskEvent(client, current.id, { + eventType: 'binding_status_changed', + actorType, + fromBindingStatus: current.binding_status, + toBindingStatus: mapped.status, + fromExecutionStatus: current.execution_status, + toExecutionStatus: executionStatus, + detail: { + gameAccount: mapped.bindGameAccount, + gameRole: mapped.bindGameRole, + gameRoleId: mapped.bindGameRoleId, + gameChannel: mapped.bindGameChannel, + verdict: currentComparison.verdict, + rebindRequested: mapped.rebindRequested, + rebindUnchanged: mapped.rebindUnchanged, + rebindConfirmState: mapped.rebindConfirmState, + rebindConfirmMessage: mapped.rebindConfirmMessage, + bindConfirmState: mapped.bindConfirmState, + bindConfirmMessage: mapped.bindConfirmMessage, + rebindCooldownDays: mapped.rebindCooldownDays, + nextRebindAt: mapped.nextRebindAt, + changeBindDay: mapped.platformChangeBindDay, + changeBindTime: mapped.platformChangeBindTime, + message: mapped.message, + }, + }) + } + return currentComparison + }) + publishSemiAutoTaskRealtimeChange(task.id, task.order_id) + return { + status: mapped.status, + qrImage: mapped.qrImage, + qrExpiresAt: mapped.qrExpiresAt, + qrUrl: mapped.qrUrl, + bindGameAccount: mapped.bindGameAccount, + bindGameRole: mapped.bindGameRole, + bindGameRoleId: mapped.bindGameRoleId, + bindGameChannel: mapped.bindGameChannel, + roleIdVerified, + requiresSupport, + hasExistingBinding: mapped.hasExistingBinding, + rebindRequested: mapped.rebindRequested, + rebindUnchanged: mapped.rebindUnchanged, + rebindConfirmState: mapped.rebindConfirmState, + rebindConfirmMessage: mapped.rebindConfirmMessage, + bindConfirmState: mapped.bindConfirmState, + bindConfirmMessage: mapped.bindConfirmMessage, + rebindCooldownDays: mapped.rebindCooldownDays, + nextRebindAt: mapped.nextRebindAt, + platformChangeBindDay: mapped.platformChangeBindDay, + platformChangeBindTime: mapped.platformChangeBindTime, + message: mapped.message, + comparison, + } +} diff --git a/apps/backend/src/services/semi-auto/semi-auto-task-reconciler.ts b/apps/backend/src/services/semi-auto/semi-auto-task-reconciler.ts new file mode 100644 index 00000000..cecbdeb5 --- /dev/null +++ b/apps/backend/src/services/semi-auto/semi-auto-task-reconciler.ts @@ -0,0 +1,53 @@ +import { backfillSemiAutoTasks, reconcileSemiAutoTaskStates } from './semi-auto-task-service.js' +import { runtimeConfig } from '../../config/runtime.js' +import { logWarn } from '../../utils/logger.js' + +const DEFAULT_RECONCILE_SECONDS = 900 + +let timer: NodeJS.Timeout | null = null +let stopped = true + +function intervalMs() { + const value = Number(runtimeConfig.semiAuto?.reconcileSeconds) + const seconds = + Number.isFinite(value) && value > 0 + ? Math.max(60, Math.trunc(value)) + : DEFAULT_RECONCILE_SECONDS + return seconds * 1000 +} + +async function run() { + if (stopped) return + try { + const createdAfter = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString() + await backfillSemiAutoTasks({ createdAfter, limit: 500 }) + await reconcileSemiAutoTaskStates(100) + } catch (error) { + logWarn('[semi-auto]', '低频对账失败', { error }) + } finally { + if (!stopped) { + timer = setTimeout(() => { + void run() + }, intervalMs()) + } + } +} + +export function startSemiAutoTaskReconciler() { + if (timer || !stopped) return + stopped = false + timer = setTimeout( + () => { + void run() + }, + Math.min(60_000, intervalMs()), + ) +} + +export function stopSemiAutoTaskReconciler() { + stopped = true + if (timer) { + clearTimeout(timer) + timer = null + } +} diff --git a/apps/backend/src/services/semi-auto/semi-auto-task-service.ts b/apps/backend/src/services/semi-auto/semi-auto-task-service.ts index 5d06c1b2..1d8fd5f8 100644 --- a/apps/backend/src/services/semi-auto/semi-auto-task-service.ts +++ b/apps/backend/src/services/semi-auto/semi-auto-task-service.ts @@ -1,2528 +1,11 @@ -import type { PoolClient } from 'pg' - -import { query, withTransaction } from '../../db/client.js' -import type { AdminSession } from '../admin/admin-auth-service.js' -import { - confirmManualFulfillment, - runManualFulfillmentPostCommit, -} from '../finance/manual-fulfillment-service.js' -import { getFileAssetByObjectKey } from '../../repositories/file-asset-repo.js' -import { createHttpError } from '../../utils/http.js' -import { nowIso } from '../../utils/time.js' -import { safeParseJson } from '../admin/admin-query-utils.js' -import { publishAdminOrderRealtimeChange } from '../realtime/realtime-event-service.js' -import { - buildFileUrl, - ORDER_SERVICE_SCREENSHOT_CONTENT_TYPES, - type UploadedFileDto, -} from '../file-storage/file-storage-service.js' -import { - createHuyaBrowserTicket, - createHuyaLoginSession, - confirmHuyaBinding, - exportHuyaSessionCredential, - getHuyaBinding, - getHuyaBindingSnapshot, - getHuyaLoginSession, - loginHuyaSms, - resetHuyaBinding, - revokeHuyaSession, - sendHuyaSmsCode, - startHuyaBinding, - submitHuyaRebind, - consumeHuyaBrowserTicket, - verifyHuyaSmsChallenge, - type ConnectorBindingSession, - type ConnectorInjectionPayload, - type SemiAutoConnectorMode, - type ConnectorLoginSession, -} from './huya-connector-client.js' -import { - consumeWeiboBrowserTicket, - createWeiboBrowserTicket, - createWeiboLoginSession, - exportWeiboSessionCredential, - getWeiboBinding, - getWeiboCountryCodes, - getWeiboLoginSession, - loginWeiboSms, - restoreWeiboSessionFromCredential, - revokeWeiboSession, - sendWeiboSmsCode, -} from './weibo-connector-client.js' -import { WEIBO_TICKET_PREFIX } from './weibo-native/weibo-native-connector.js' -import { - buildSemiAutoCredentialCookieHeader, - loadSemiAutoCredential, - markSemiAutoCredentialCheck, - upsertSemiAutoCredentialWithClient, -} from './semi-auto-credential-service.js' -import { querySemiAutoTraces } from './semi-auto-trace.js' -import { isNumericBindingRoleId } from './binding-role-id.js' - -const SEMI_AUTO_PLATFORMS = new Set(['huya', 'weibo']) -type SemiAutoPlatform = 'huya' | 'weibo' -type LoginStatus = - | 'waiting_login' - | 'qr_pending' - | 'scanned' - | 'authenticated' - | 'failed' - | 'expired' -type BindingStatus = - | 'not_started' - | 'qr_pending' - | 'scanned' - | 'role_ready' - | 'confirmed' - | 'failed' - | 'expired' -type ExecutionStatus = - | 'waiting_customer' - | 'waiting_operator' - | 'processing' - | 'completed' - | 'failed' - | 'cancelled' - -type TaskRow = { - id: number - order_id: number - order_item_id: number - fulfillment_id: number | null - manual_fulfillment_config_id: number | null - platform: SemiAutoPlatform - login_status: LoginStatus - binding_status: BindingStatus - execution_status: ExecutionStatus - connector_mode: SemiAutoConnectorMode - connector_session_id: string - credential_id: number | null - credential_status: 'unknown' | 'valid' | 'invalid' | 'error' | null - credential_source: string | null - credential_updated_at: string | null - huya_uid: string - platform_nickname: string - bind_game_account: string - bind_game_role: string - bind_game_role_id: string - bind_game_channel: string - customer_game_role_name: string - customer_game_role_id: string - customer_game_server_zone: string - customer_game_id: string - customer_game_role: string - customer_server_zone: string - target_quantity: number - completed_quantity: number - assigned_admin_user_id: number | null - assigned_admin_name?: string - customer_link_opened_at: string | null - auth_started_at: string | null - authenticated_at: string | null - binding_started_at: string | null - bound_at: string | null - completed_at: string | null - completion_note: string - external_order_no: string - completion_evidence_json: Record - last_error: string - created_at: string - updated_at: string - platform_order_id: string - provider: string - shop_id: string - sku_code: string - sku_name: string - quantity: number - product_name: string - manual_platform_key: string - manual_cost_mode: string - manual_credit_quantity: number | string - semi_auto_config_json: Record -} - -type TaskEventInput = { - eventType: string - actorType?: 'system' | 'customer' | 'admin' | 'connector' - actorId?: string - fromLoginStatus?: LoginStatus | null - toLoginStatus?: LoginStatus | null - fromBindingStatus?: BindingStatus | null - toBindingStatus?: BindingStatus | null - fromExecutionStatus?: ExecutionStatus | null - toExecutionStatus?: ExecutionStatus | null - detail?: Record -} - -type TaskActorType = 'system' | 'customer' | 'admin' | 'connector' - -function normalizeId(value: unknown, label = '任务 ID'): number { - const id = Number(value) - if (!Number.isInteger(id) || id <= 0) { - throw createHttpError(`${label}无效`, { - statusCode: 400, - errorCode: 'semi_auto_task_id_invalid', - }) - } - return id -} - -function normalizeOrderNo(value: unknown): string { - const text = String(value ?? '').trim() - if (!text) { - throw createHttpError('订单号无效,请确认订单号是否正确', { - statusCode: 404, - errorCode: 'semi_auto_order_not_found', - }) - } - return text -} - -/** 客户资料以 TASK_SELECT 合并后的字段为准:优先任务表,回退工单资料。 */ -export function hasCustomerProfile( - task: Pick, -): boolean { - return Boolean( - String(task.customer_game_id || '').trim() && - String(task.customer_game_role || '').trim() && - String(task.customer_server_zone || '').trim(), - ) -} - -function displayStatus(task: TaskRow) { - if (task.execution_status === 'completed') return { key: 'completed', label: '已完成' } - if (task.execution_status === 'cancelled') return { key: 'cancelled', label: '已取消' } - if (task.credential_status === 'invalid' || task.credential_status === 'error') { - return { key: 'credential_expired', label: '登录已失效,需重新授权' } - } - if (task.execution_status === 'failed' || task.login_status === 'failed') { - return { key: 'failed', label: '需客服处理' } - } - if (task.login_status === 'authenticated') { - // 虎牙需要客户确认绑定角色后才算授权完成;微博登录即授权。 - if (task.platform === 'weibo' || task.binding_status === 'confirmed') { - return { key: 'waiting_operator', label: '等待客服处理' } - } - if (task.platform === 'huya' && !hasCustomerProfile(task)) { - return { key: 'waiting_profile', label: '待客户填写资料' } - } - if (task.binding_status === 'role_ready') { - return { key: 'binding_confirm', label: '待确认绑定角色' } - } - if (task.binding_status === 'expired') { - return { key: 'binding_expired', label: '绑定二维码已过期' } - } - if (task.binding_status === 'failed') { - return { key: 'binding_failed', label: '绑定失败,需重新扫码' } - } - return { key: 'waiting_binding', label: '等待客户绑定角色' } - } - if (task.login_status === 'scanned') return { key: 'login_scanned', label: '已扫码,确认中' } - if (task.login_status === 'qr_pending') return { key: 'waiting_login', label: '等待客户登录' } - return { key: 'waiting_customer', label: '等待客户授权' } -} - -function mapTask(task: TaskRow) { - return { - id: Number(task.id), - orderId: Number(task.order_id), - orderItemId: Number(task.order_item_id), - fulfillmentId: task.fulfillment_id ? Number(task.fulfillment_id) : null, - platform: task.platform, - platformLabel: - task.platform === 'huya' ? '虎牙' : task.platform === 'weibo' ? '微博' : task.platform, - loginStatus: task.login_status, - bindingStatus: task.binding_status, - executionStatus: task.execution_status, - connectorMode: task.connector_mode, - displayStatus: displayStatus(task), - connectorReady: Boolean(task.connector_session_id || task.credential_id), - credentialReady: Boolean(task.credential_id), - credentialStatus: task.credential_status || 'unknown', - credentialSource: task.credential_source || '', - credentialUpdatedAt: task.credential_updated_at, - huyaUid: task.huya_uid, - platformNickname: task.platform_nickname, - bindGameAccount: task.bind_game_account, - bindGameRole: task.bind_game_role, - bindGameRoleId: task.bind_game_role_id, - bindGameChannel: task.bind_game_channel, - customerGameRoleId: task.customer_game_id || '', - customerGameRoleName: task.customer_game_role || '', - customerServerZone: task.customer_server_zone || '', - targetQuantity: Number(task.target_quantity || 1), - completedQuantity: Number(task.completed_quantity || 0), - assignedAdminUserId: task.assigned_admin_user_id ? Number(task.assigned_admin_user_id) : null, - assignedAdminName: String(task.assigned_admin_name || ''), - customerLinkOpenedAt: task.customer_link_opened_at, - authStartedAt: task.auth_started_at, - authenticatedAt: task.authenticated_at, - bindingStartedAt: task.binding_started_at, - boundAt: task.bound_at, - completedAt: task.completed_at, - completionNote: task.completion_note, - externalOrderNo: task.external_order_no, - completionEvidence: task.completion_evidence_json || {}, - lastError: task.last_error, - createdAt: task.created_at, - updatedAt: task.updated_at, - orderNo: task.platform_order_id, - provider: task.provider, - shopId: task.shop_id, - skuCode: task.sku_code, - skuName: task.sku_name, - productName: task.product_name, - quantity: Number(task.quantity || 1), - semiAutoConfig: task.semi_auto_config_json || {}, - } -} - -export type SemiAutoTaskDto = ReturnType - -async function appendTaskEvent( - client: Pick, - taskId: number, - event: TaskEventInput, -) { - await client.query( - ` - INSERT INTO semi_auto_task_events ( - task_id, event_type, actor_type, actor_id, - from_login_status, to_login_status, - from_binding_status, to_binding_status, - from_execution_status, to_execution_status, - detail_json, created_at - ) VALUES ( - $1, $2, $3, $4, - $5, $6, - $7, $8, - $9, $10, - $11::jsonb, NOW() - ) - `, - [ - taskId, - event.eventType, - event.actorType || 'system', - event.actorId || '', - event.fromLoginStatus || null, - event.toLoginStatus || null, - event.fromBindingStatus || null, - event.toBindingStatus || null, - event.fromExecutionStatus || null, - event.toExecutionStatus || null, - JSON.stringify(event.detail || {}), - ], - ) -} - -const TASK_SELECT = ` - SELECT - task.*, - admin.display_name AS assigned_admin_name, - o.platform_order_id, - o.provider, - o.shop_id, - oi.sku_code, - oi.sku_name, - oi.quantity, - COALESCE(NULLIF(oi.sku_name, ''), NULLIF(oi.sku_code, ''), '订单商品') AS product_name, - cfg.platform_key AS manual_platform_key, - cfg.cost_mode AS manual_cost_mode, - cfg.credit_quantity AS manual_credit_quantity, - cfg.semi_auto_config_json, - credential.credential_status, - credential.credential_source, - credential.credential_updated_at, - COALESCE( - NULLIF(task.customer_game_role_id, ''), - wo.material_json->'collect'->'fields'->>'gameId', - wo.material_json->'collect'->'fields'->>'characterId', - '' - ) AS customer_game_id, - COALESCE( - NULLIF(task.customer_game_role_name, ''), - NULLIF(wo.material_json->'collect'->'fields'->>'gameNickname', ''), - NULLIF(wo.material_json->'collect'->'fields'->>'roleName', ''), - '' - ) AS customer_game_role, - COALESCE( - NULLIF(task.customer_game_server_zone, ''), - wo.material_json->'collect'->'fields'->>'serverZone', - '' - ) AS customer_server_zone - FROM semi_auto_tasks task - JOIN orders o ON o.id = task.order_id - JOIN order_items oi ON oi.id = task.order_item_id - LEFT JOIN manual_fulfillment_configs cfg ON cfg.id = task.manual_fulfillment_config_id - LEFT JOIN admin_users admin ON admin.id = task.assigned_admin_user_id - LEFT JOIN semi_auto_credentials credential ON credential.id = task.credential_id - LEFT JOIN LATERAL ( - SELECT candidate.material_json - FROM work_orders candidate - WHERE candidate.order_item_id = task.order_item_id - OR (candidate.order_item_id IS NULL AND candidate.order_id = task.order_id) - OR (o.platform_order_id <> '' AND candidate.platform_order_id = o.platform_order_id) - ORDER BY (candidate.order_item_id = task.order_item_id) DESC NULLS LAST, - (candidate.order_id = task.order_id) DESC NULLS LAST, - candidate.id DESC - LIMIT 1 - ) wo ON TRUE -` - -async function loadTask(taskId: number): Promise { - const result = await query(`${TASK_SELECT} WHERE task.id = $1 LIMIT 1`, [taskId]) - const task = result.rows[0] - if (!task) { - throw createHttpError('半自动履约任务不存在', { - statusCode: 404, - errorCode: 'semi_auto_task_not_found', - }) - } - return task -} - -async function loadTaskForOrder(orderNo: string, taskId: number): Promise { - const task = await loadTask(taskId) - if (String(task.platform_order_id || '').trim() !== orderNo) { - throw createHttpError('订单号或任务无效', { - statusCode: 404, - errorCode: 'semi_auto_task_not_found', - }) - } - return task -} - -async function loadTaskForUpdateWithClient(client: PoolClient, taskId: number): Promise { - const result = await client.query( - `${TASK_SELECT} WHERE task.id = $1 LIMIT 1 FOR UPDATE OF task`, - [taskId], - ) - const task = result.rows[0] - if (!task) { - throw createHttpError('半自动履约任务不存在', { - statusCode: 404, - errorCode: 'semi_auto_task_not_found', - }) - } - return task -} - -function assertWeiboTask(task: TaskRow) { - if (task.platform !== 'weibo') { - throw createHttpError('当前任务不是微博任务', { - statusCode: 409, - errorCode: 'semi_auto_platform_mismatch', - }) - } -} - -function assertHuyaTask(task: TaskRow) { - if (task.platform !== 'huya') { - throw createHttpError('当前任务不是虎牙任务', { - statusCode: 409, - errorCode: 'semi_auto_platform_mismatch', - }) - } -} - /** - * 半自动订单没有工单时,客户资料在登录后由 /c/<订单号> 收集; - * 任务表为空但工单素材已有资料时,TASK_SELECT 会合并回退字段。 - * 进入绑定/确认/换绑前必须已有完整三项资料。 - */ -function assertCustomerProfileReady(task: TaskRow) { - if (task.platform !== 'huya') return - if (!hasCustomerProfile(task)) { - throw createHttpError('请先提交游戏角色资料', { - statusCode: 409, - errorCode: 'semi_auto_profile_required', - }) - } -} - -async function createLoginSessionForTask( - task: TaskRow, - orderNo: string, -): Promise { - const input = { taskId: task.id, orderNo } - return task.platform === 'weibo' - ? createWeiboLoginSession(input, task.connector_mode) - : createHuyaLoginSession(input, task.connector_mode) -} - -async function getLoginSessionForTask( - task: TaskRow, - sessionId: string, -): Promise { - return task.platform === 'weibo' - ? getWeiboLoginSession(sessionId, task.connector_mode) - : getHuyaLoginSession(sessionId, task.connector_mode) -} - -async function revokeSessionForTask(task: TaskRow, sessionId: string): Promise { - if (task.platform === 'weibo') { - await revokeWeiboSession(sessionId, task.connector_mode) - return - } - await revokeHuyaSession(sessionId, task.connector_mode) -} - -async function getBindingForTask( - task: TaskRow, - sessionId: string, -): Promise { - return task.platform === 'weibo' - ? getWeiboBinding(sessionId, task.connector_mode) - : getHuyaBinding(sessionId, task.connector_mode) -} - -function errorCodeOf(error: unknown) { - return error && typeof error === 'object' - ? String((error as { errorCode?: unknown }).errorCode || '').trim() - : '' -} - -function isInvalidCredentialError(error: unknown) { - return ['weibo_credential_invalid', 'weibo_credential_account_mismatch'].includes( - errorCodeOf(error), - ) -} - -async function resetTaskForCustomerLogin( - task: TaskRow, - input: { - actorType: TaskActorType - actorId?: string - reason: string - eventType: string - }, -) { - if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { - return task - } - await withTransaction(async (client) => { - await client.query( - ` - UPDATE semi_auto_tasks - SET connector_session_id = '', - login_status = 'waiting_login', - execution_status = 'waiting_customer', - customer_link_opened_at = NULL, - auth_started_at = NULL, - authenticated_at = NULL, - binding_started_at = NULL, - bound_at = NULL, - last_error = $2, - updated_at = NOW() - WHERE id = $1 - `, - [task.id, input.reason], - ) - await appendTaskEvent(client, task.id, { - eventType: input.eventType, - actorType: input.actorType, - ...(input.actorId ? { actorId: input.actorId } : {}), - fromLoginStatus: task.login_status, - toLoginStatus: 'waiting_login', - fromExecutionStatus: task.execution_status, - toExecutionStatus: 'waiting_customer', - detail: { reason: input.reason }, - }) - }) - publishAdminOrderRealtimeChange(Number(task.order_id)) - return loadTask(task.id) -} - -async function ensureConnectorSessionForTask(task: TaskRow): Promise { - if (task.execution_status === 'completed' || task.execution_status === 'cancelled') return task - if (task.connector_session_id) { - try { - const session = await getLoginSessionForTask(task, task.connector_session_id) - if (session.status === 'authenticated') return task - } catch { - // 进程重启或多实例切换后,内存会话会丢失;下面用已保存的账号 CK 恢复。 - } - } - if (task.platform !== 'weibo' || !task.credential_id) return task - const credential = await loadSemiAutoCredential(task.credential_id) - if (!credential || credential.platform !== 'weibo') return task - try { - const session = await restoreWeiboSessionFromCredential( - { - taskId: task.id, - orderNo: task.platform_order_id, - platformUid: credential.platformUid, - nickname: credential.nickname, - cookies: credential.cookies, - }, - task.connector_mode, - ) - await markSemiAutoCredentialCheck(task.credential_id, { status: 'valid' }) - await withTransaction(async (client) => { - await client.query( - ` - UPDATE semi_auto_tasks - SET connector_session_id = $2, - login_status = 'authenticated', - huya_uid = CASE WHEN $3 <> '' THEN $3 ELSE huya_uid END, - platform_nickname = CASE WHEN $4 <> '' THEN $4 ELSE platform_nickname END, - last_error = '', - updated_at = NOW() - WHERE id = $1 - `, - [task.id, session.sessionId, session.huyaUid, session.nickname], - ) - await appendTaskEvent(client, task.id, { - eventType: 'credential_session_restored', - actorType: 'connector', - detail: { - credentialId: task.credential_id, - hasCredential: session.hasCredential, - }, - }) - }) - return loadTask(task.id) - } catch (error) { - const credentialInvalid = isInvalidCredentialError(error) - await markSemiAutoCredentialCheck(task.credential_id, { - status: credentialInvalid ? 'invalid' : 'error', - error: error instanceof Error ? error.message : String(error), - }).catch(() => undefined) - if (credentialInvalid) { - return resetTaskForCustomerLogin(task, { - actorType: 'connector', - reason: '平台登录凭证已失效,需客户重新登录', - eventType: 'credential_invalidated', - }) - } - throw error - } -} - -type SemiAutoCandidate = { - order_id: number - platform_order_id: string - order_item_id: number - fulfillment_id: number - manual_fulfillment_config_id: number - platform: SemiAutoPlatform - quantity: number -} - -async function insertMissingSemiAutoTasksWithClient( - client: PoolClient, - orderNo?: string, - orderItemIds?: number[], -) { - const params: unknown[] = [] - const filters: string[] = [] - if (orderNo) { - params.push(orderNo) - filters.push(`o.platform_order_id = $${params.length}`) - } - const normalizedItemIds = [ - ...new Set((orderItemIds || []).map(Number).filter((id) => Number.isInteger(id) && id > 0)), - ] - if (normalizedItemIds.length > 0) { - params.push(normalizedItemIds) - filters.push(`oi.id = ANY($${params.length}::bigint[])`) - } - const itemFilter = filters.length > 0 ? `AND ${filters.join(' AND ')}` : '' - const candidates = await client.query( - ` - SELECT - o.id AS order_id, - o.platform_order_id, - oi.id AS order_item_id, - f.id AS fulfillment_id, - cfg.id AS manual_fulfillment_config_id, - cfg.semi_auto_platform AS platform, - GREATEST(1, COALESCE(oi.quantity, 1))::int AS quantity - FROM orders o - JOIN order_items oi ON oi.order_id = o.id - JOIN fulfillments f ON f.order_item_id = oi.id - JOIN manual_fulfillment_configs cfg ON cfg.id = f.fulfillment_config_id - WHERE f.channel = 'manual' - AND f.status = 'assigned' - AND cfg.enabled = TRUE - AND cfg.semi_auto_enabled = TRUE - AND cfg.semi_auto_platform IN ('huya', 'weibo') - ${itemFilter} - AND NOT EXISTS ( - SELECT 1 FROM semi_auto_tasks existing WHERE existing.order_item_id = oi.id - ) - ORDER BY o.id DESC, oi.id ASC - `, - params, - ) - - const createdIds: number[] = [] - const orderIds = new Set() - for (const row of candidates.rows) { - const inserted = await client.query<{ id: number }>( - ` - INSERT INTO semi_auto_tasks ( - order_id, order_item_id, fulfillment_id, manual_fulfillment_config_id, - platform, target_quantity, created_at, updated_at - ) VALUES ($1, $2, $3, $4, $5, $6, NOW(), NOW()) - ON CONFLICT (order_item_id) DO NOTHING - RETURNING id - `, - [ - Number(row.order_id), - Number(row.order_item_id), - Number(row.fulfillment_id), - Number(row.manual_fulfillment_config_id), - row.platform, - Number(row.quantity || 1), - ], - ) - const taskId = Number(inserted.rows[0]?.id || 0) - if (!taskId) continue - createdIds.push(taskId) - orderIds.add(Number(row.order_id)) - await appendTaskEvent(client, taskId, { - eventType: 'task_created', - toLoginStatus: 'waiting_login', - toBindingStatus: 'not_started', - toExecutionStatus: 'waiting_customer', - detail: { orderNo: row.platform_order_id }, - }) - } - return { createdIds, orderIds: [...orderIds] } -} - -export async function ensureSemiAutoTasksForOrder(orderNoInput: unknown) { - const orderNo = normalizeOrderNo(orderNoInput) - const result = await withTransaction((client) => - insertMissingSemiAutoTasksWithClient(client, orderNo), - ) - if (result.orderIds[0]) { - publishAdminOrderRealtimeChange(result.orderIds[0]) - } - return { orderNo, createdIds: result.createdIds } -} - -export async function ensureSemiAutoTasksForOrderItems(input: unknown[]) { - const orderItemIds = [ - ...new Set( - (Array.isArray(input) ? input : []) - .map(Number) - .filter((id) => Number.isInteger(id) && id > 0), - ), - ] - if (orderItemIds.length === 0) return { createdIds: [], orderIds: [] } - const result = await withTransaction((client) => - insertMissingSemiAutoTasksWithClient(client, undefined, orderItemIds), - ) - for (const orderId of result.orderIds) { - publishAdminOrderRealtimeChange(orderId) - } - return { createdIds: result.createdIds, orderIds: result.orderIds } -} - -/** - * 后台列表读取前的幂等回填。 + * 半自动履约对外门面。 * - * 客户不先打开 `/c/订单号` 或 `/d/订单号` 时,任务也必须进入客服工作台;后备查询只插入缺失任务, - * 不修改已有任务状态,也不会重复写事件。 + * 具体实现按职责拆分: + * - semi-auto-task-core: 任务仓储、状态收敛、会话与物化 + * - semi-auto-customer-service: 客户登录、资料与角色绑定 + * - semi-auto-admin-service: 后台工作台、凭证、完成与对账 */ -export async function backfillSemiAutoTasks() { - const result = await withTransaction((client) => insertMissingSemiAutoTasksWithClient(client)) - return { createdIds: result.createdIds, orderIds: result.orderIds } -} - -export async function listPublicSemiAutoTasks(orderNoInput: unknown) { - const orderNo = normalizeOrderNo(orderNoInput) - await ensureSemiAutoTasksForOrder(orderNo) - const result = await query( - `${TASK_SELECT} - WHERE o.platform_order_id = $1 - AND task.execution_status <> 'cancelled' - ORDER BY task.id ASC`, - [orderNo], - ) - return result.rows.map(mapTask) -} - -export async function markCustomerLinkOpened(orderNoInput: unknown, taskIdInput: unknown) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - await ensureSemiAutoTasksForOrder(orderNo) - const task = await loadTaskForOrder(orderNo, taskId) - if (!task.customer_link_opened_at) { - await withTransaction(async (client) => { - await client.query( - `UPDATE semi_auto_tasks SET customer_link_opened_at = NOW(), updated_at = NOW() WHERE id = $1`, - [taskId], - ) - await appendTaskEvent(client, taskId, { - eventType: 'customer_link_opened', - actorType: 'customer', - }) - }) - } - return { ok: true } -} - -export type CustomerProfileInput = { - roleName?: unknown - roleId?: unknown - serverZone?: unknown -} - -const CUSTOMER_SERVER_ZONES = new Set(['苹果Q区', '苹果V区', '安卓Q区', '安卓V区']) - -export function normalizeCustomerProfile(input: CustomerProfileInput = {}) { - const roleName = String(input.roleName ?? '') - .trim() - .slice(0, 100) - const roleId = String(input.roleId ?? '') - .replace(/\s+/g, '') - .slice(0, 64) - const serverZone = String(input.serverZone ?? '') - .trim() - .slice(0, 100) - if (roleId && !/^\d+$/.test(roleId)) { - throw createHttpError('游戏编号 / 角色 ID 只能是数字', { - statusCode: 400, - errorCode: 'semi_auto_profile_role_id_invalid', - }) - } - if (!CUSTOMER_SERVER_ZONES.has(serverZone)) { - throw createHttpError('区服只能选择 苹果Q区 / 苹果V区 / 安卓Q区 / 安卓V区', { - statusCode: 400, - errorCode: 'semi_auto_profile_server_zone_invalid', - }) - } - if (!roleName || !roleId) { - throw createHttpError('请完整填写区服、游戏编号和角色名', { - statusCode: 400, - errorCode: 'semi_auto_profile_required', - }) - } - return { roleName, roleId, serverZone } -} - -/** - * 半自动订单没有 work_orders,客户资料只能在授权页 /c/<订单号>(虎牙)或 /d/<订单号>(微博)收集。 - * 保存后立即参与“客户填写角色 vs 平台识别角色”的比对。 - */ -export async function savePublicTaskProfile( - orderNoInput: unknown, - taskIdInput: unknown, - payload: CustomerProfileInput = {}, -) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - const task = await loadTaskForOrder(orderNo, taskId) - if (task.platform !== 'huya') { - throw createHttpError('当前平台不需要填写游戏角色', { - statusCode: 409, - errorCode: 'semi_auto_profile_not_supported', - }) - } - if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { - throw createHttpError('当前订单已结束,不能修改角色资料', { - statusCode: 409, - errorCode: 'semi_auto_task_closed', - }) - } - if (task.binding_status === 'confirmed') { - throw createHttpError('绑定已确认,不能修改角色资料', { - statusCode: 409, - errorCode: 'semi_auto_profile_locked', - }) - } - // 客户页流程固定为「登录 → 填写资料 → 绑定角色」;未登录不允许提前写资料。 - if (task.login_status !== 'authenticated') { - throw createHttpError('请先完成虎牙登录后再填写资料', { - statusCode: 409, - errorCode: 'semi_auto_login_required', - }) - } - const profile = normalizeCustomerProfile(payload) - await withTransaction(async (client) => { - await client.query( - ` - UPDATE semi_auto_tasks - SET customer_game_role_name = $2, - customer_game_role_id = $3, - customer_game_server_zone = $4, - updated_at = NOW() - WHERE id = $1 - `, - [task.id, profile.roleName, profile.roleId, profile.serverZone], - ) - await appendTaskEvent(client, task.id, { - eventType: 'customer_profile_saved', - actorType: 'customer', - detail: profile, - }) - }) - const updated = await loadTask(task.id) - return { task: mapTask(updated) } -} - -function mapLoginUpdate(session: ConnectorLoginSession) { - const statusMap: Record = { - verification_pending: 'waiting_login', - waiting_code: 'waiting_login', - waiting_scan: 'qr_pending', - scanned: 'scanned', - authenticated: 'authenticated', - expired: 'expired', - failed: 'failed', - } - return { - status: statusMap[session.status] || 'failed', - uid: String(session.huyaUid || ''), - nickname: String(session.nickname || ''), - message: String(session.message || ''), - hasCredential: session.hasCredential === true, - } -} - -async function updateLoginTask( - task: TaskRow, - session: ConnectorLoginSession, - actorType: TaskActorType, - options: { credentialSource?: 'qr' | 'sms'; method?: 'qr' | 'sms' } = {}, -) { - const mapped = mapLoginUpdate(session) - // 虎牙登录成功还不算授权完成,必须等客户确认绑定角色;微博登录即授权。 - const nextExecutionStatus: ExecutionStatus = - mapped.status === 'authenticated' - ? task.platform === 'weibo' || task.binding_status === 'confirmed' - ? 'waiting_operator' - : 'waiting_customer' - : task.execution_status - const storedCredential = - mapped.status === 'authenticated' && mapped.hasCredential - ? task.platform === 'weibo' - ? exportWeiboSessionCredential(session.sessionId, task.connector_mode) - : await exportHuyaSessionCredential(session.sessionId, task.connector_mode) - : null - if (mapped.status === 'authenticated' && !storedCredential) { - throw createHttpError('平台登录成功但未能获取账号 CK,请联系客服处理', { - statusCode: 502, - errorCode: 'semi_auto_credential_export_failed', - }) - } - await withTransaction(async (client) => { - const credentialId = storedCredential - ? await upsertSemiAutoCredentialWithClient(client, { - platform: task.platform, - source: options.credentialSource || 'qr', - payload: storedCredential, - }) - : null - await client.query( - ` - UPDATE semi_auto_tasks - SET login_status = $2, - credential_id = COALESCE($7, credential_id), - huya_uid = CASE WHEN $3 <> '' THEN $3 ELSE huya_uid END, - platform_nickname = CASE WHEN $4 <> '' THEN $4 ELSE platform_nickname END, - authenticated_at = CASE WHEN $2 = 'authenticated' THEN COALESCE(authenticated_at, NOW()) ELSE authenticated_at END, - execution_status = $5, - last_error = CASE WHEN $2 IN ('failed', 'expired') THEN $6 ELSE '' END, - updated_at = NOW() - WHERE id = $1 - `, - [ - task.id, - mapped.status, - mapped.uid, - mapped.nickname, - nextExecutionStatus, - mapped.message, - credentialId, - ], - ) - // 轮询会每 2 秒调用一次:状态与执行状态都没变时不写事件,避免时间线被重复项淹没。 - if (mapped.status !== task.login_status || nextExecutionStatus !== task.execution_status) { - await appendTaskEvent(client, task.id, { - eventType: 'login_status_changed', - actorType, - fromLoginStatus: task.login_status, - toLoginStatus: mapped.status, - fromExecutionStatus: task.execution_status, - toExecutionStatus: nextExecutionStatus, - detail: { - hasCredential: mapped.hasCredential, - message: mapped.message, - method: options.method || 'qr', - }, - }) - } - }) -} - -function mapBindingUpdate(session: ConnectorBindingSession) { - const statusMap: Record = { - not_started: 'not_started', - qr_pending: 'qr_pending', - scanned: 'scanned', - role_ready: 'role_ready', - confirmed: 'confirmed', - expired: 'expired', - failed: 'failed', - } - return { - status: statusMap[session.status] || 'failed', - qrImage: String(session.qrImage || ''), - qrExpiresAt: String(session.qrExpiresAt || ''), - qrUrl: String(session.qrUrl || ''), - bindGameAccount: String(session.bindGameAccount || ''), - bindGameRole: String(session.bindGameRole || ''), - bindGameRoleId: String(session.bindGameRoleId || ''), - bindGameChannel: String(session.bindGameChannel || ''), - hasExistingBinding: session.hasExistingBinding === true, - rebindRequested: session.rebindRequested === true, - rebindUnchanged: session.rebindUnchanged === true, - rebindConfirmState: session.rebindConfirmState || 'idle', - rebindConfirmMessage: String(session.rebindConfirmMessage || ''), - bindConfirmState: session.bindConfirmState || 'idle', - bindConfirmMessage: String(session.bindConfirmMessage || ''), - rebindCooldownDays: Number(session.rebindCooldownDays || 0), - nextRebindAt: String(session.nextRebindAt || ''), - platformChangeBindDay: Number(session.platformChangeBindDay || 0), - platformChangeBindTime: Number(session.platformChangeBindTime || 0), - message: String(session.message || ''), - } -} - -export type BindingRoleComparison = { - verdict: 'match' | 'mismatch' | 'unknown' - customerRoleName: string - customerRoleId: string - customerZone: string - boundRoleName: string - boundRoleId: string - boundZone: string - message: string -} - -function normalizeRoleText(value: unknown): string { - return String(value ?? '') - .replace(/\s+/g, '') - .toLowerCase() -} - -function normalizeServerZone(value: unknown): string { - const text = String(value ?? '').trim() - - if (!text) return '' - - return /区$/.test(text) ? text : `${text}区` -} - -/** - * 从虎牙渠道串解析区服,例如「安卓(android) · 微信」→ 安卓V区。 - * 解析不出平台或登录方式时返回空串,比对时按「平台区服缺失」处理(判 unknown)。 - */ -export function detectServerZone(channel: unknown): string { - const text = String(channel ?? '') - .replace(/\s+/g, '') - .toLowerCase() - - if (!text) return '' - - const platform = /苹果|ios/.test(text) ? '苹果' : /安卓|android/.test(text) ? '安卓' : '' - - if (!platform) return '' - - const login = /qq|q区/.test(text) ? 'Q' : /微信|wechat|v区/.test(text) ? 'V' : '' - - return login ? `${platform}${login}区` : '' -} - -/** - * 客户填写角色与平台识别角色必须完全一致才允许提交平台绑定。 - * - * 区服、角色名、角色 ID 三项必须全部存在且一致: - * ① 客户游戏编号 = 虎牙账号 UID,与平台可核对角色 ID 相等; - * ② 角色名按规范化文本相等(忽略空白与大小写差异不能放行改名); - * ③ 平台渠道能解析出区服且与客户所填区服相等。 - * 任一侧缺任一项(含平台只给加密 roleId 且拿不到 UID)判 unknown,转客服核对; - * 任一项不等判 mismatch,不允许提交平台绑定。 - */ -export function compareBindingRole( - task: Pick< - TaskRow, - 'customer_game_id' | 'customer_game_role' | 'customer_game_server_zone' | 'huya_uid' - >, - binding: { bindGameRole?: string; bindGameRoleId?: string; bindGameChannel?: string }, -): BindingRoleComparison { - const customerRoleName = String(task.customer_game_role || '').trim() - const customerRoleId = String(task.customer_game_id || '').trim() - const customerZone = normalizeServerZone(task.customer_game_server_zone) - const boundRoleName = String(binding.bindGameRole || '').trim() - const rawBoundRoleId = String(binding.bindGameRoleId || '').trim() - // 虎牙 gameRole.roleId 是 40 位加密串,客户填写的是数值游戏编号; - // 平台侧可比对的是登录账号的数值 UID(huyaUid),不能拿加密串直接比对。 - const numericHuyaUid = /^\d+$/.test(String(task.huya_uid || '').trim()) - ? String(task.huya_uid).trim() - : '' - const boundRoleId = /^\d+$/.test(rawBoundRoleId) - ? rawBoundRoleId - : numericHuyaUid || rawBoundRoleId - const boundZone = detectServerZone(binding.bindGameChannel) - const base = { - customerRoleName, - customerRoleId, - customerZone, - boundRoleName, - boundRoleId, - boundZone, - } - - // 客户确认的口径:区服、角色名、角色 ID 三项必须全部存在且一致。 - const missing: string[] = [] - if (!customerRoleId) missing.push('客户游戏编号') - if (!customerRoleName) missing.push('客户角色名') - if (!customerZone) missing.push('客户区服') - if (!boundRoleId || !isNumericBindingRoleId(boundRoleId)) missing.push('平台可核对角色ID') - if (!boundRoleName) missing.push('平台角色名') - if (!boundZone) missing.push('平台区服') - if (missing.length > 0) { - return { - ...base, - verdict: 'unknown', - message: `缺少${missing.join('、')},无法核对绑定角色,请联系客服`, - } - } - - if (customerRoleId !== boundRoleId) { - return { ...base, verdict: 'mismatch', message: '两侧角色 ID 不一致,无法提交平台绑定' } - } - - if (normalizeRoleText(customerRoleName) !== normalizeRoleText(boundRoleName)) { - return { ...base, verdict: 'mismatch', message: '两侧角色名称不一致,无法提交平台绑定' } - } - - if (customerZone !== boundZone) { - return { ...base, verdict: 'mismatch', message: '两侧区服不一致,无法提交平台绑定' } - } - - return { - ...base, - verdict: 'match', - message: '两侧区服、角色名称、角色 ID 一致,可提交平台绑定', - } -} - -async function updateBindingTask( - task: TaskRow, - session: ConnectorBindingSession, - actorType: TaskActorType, -) { - const mapped = mapBindingUpdate(session) - const comparison = compareBindingRole(task, mapped) - const roleIdVerified = isNumericBindingRoleId(mapped.bindGameRoleId) - const requiresSupport = - (Boolean(mapped.bindGameRole) || mapped.hasExistingBinding === true) && !roleIdVerified - const executionStatus: ExecutionStatus = - mapped.status === 'confirmed' - ? 'waiting_operator' - : task.execution_status === 'completed' || task.execution_status === 'cancelled' - ? task.execution_status - : 'waiting_customer' - await withTransaction(async (client) => { - await client.query( - ` - UPDATE semi_auto_tasks - SET binding_status = $2, - bind_game_account = CASE WHEN $3 <> '' THEN $3 ELSE bind_game_account END, - bind_game_role = CASE WHEN $4 <> '' THEN $4 ELSE bind_game_role END, - bind_game_role_id = CASE WHEN $8 <> '' THEN $8 ELSE bind_game_role_id END, - bind_game_channel = CASE WHEN $5 <> '' THEN $5 ELSE bind_game_channel END, - bound_at = CASE WHEN $2 IN ('role_ready', 'confirmed') THEN COALESCE(bound_at, NOW()) ELSE bound_at END, - execution_status = $6, - last_error = CASE WHEN $2 IN ('failed', 'expired') THEN $7 ELSE '' END, - updated_at = NOW() - WHERE id = $1 - `, - [ - task.id, - mapped.status, - mapped.bindGameAccount, - mapped.bindGameRole, - mapped.bindGameChannel, - executionStatus, - mapped.message, - mapped.bindGameRoleId, - ], - ) - // 轮询会每 2 秒调用一次:只有状态/执行状态变化,或换绑被拒这类关键信号才写事件。 - const bindingChanged = - mapped.status !== task.binding_status || - executionStatus !== task.execution_status || - mapped.rebindUnchanged || - mapped.rebindConfirmState === 'rejected' - if (bindingChanged) { - await appendTaskEvent(client, task.id, { - eventType: 'binding_status_changed', - actorType, - fromBindingStatus: task.binding_status, - toBindingStatus: mapped.status, - fromExecutionStatus: task.execution_status, - toExecutionStatus: executionStatus, - detail: { - gameAccount: mapped.bindGameAccount, - gameRole: mapped.bindGameRole, - gameRoleId: mapped.bindGameRoleId, - gameChannel: mapped.bindGameChannel, - verdict: comparison.verdict, - rebindRequested: mapped.rebindRequested, - rebindUnchanged: mapped.rebindUnchanged, - rebindConfirmState: mapped.rebindConfirmState, - rebindConfirmMessage: mapped.rebindConfirmMessage, - bindConfirmState: mapped.bindConfirmState, - bindConfirmMessage: mapped.bindConfirmMessage, - rebindCooldownDays: mapped.rebindCooldownDays, - nextRebindAt: mapped.nextRebindAt, - changeBindDay: mapped.platformChangeBindDay, - changeBindTime: mapped.platformChangeBindTime, - message: mapped.message, - }, - }) - } - }) - return { - status: mapped.status, - qrImage: mapped.qrImage, - qrExpiresAt: mapped.qrExpiresAt, - qrUrl: mapped.qrUrl, - bindGameAccount: mapped.bindGameAccount, - bindGameRole: mapped.bindGameRole, - bindGameRoleId: mapped.bindGameRoleId, - bindGameChannel: mapped.bindGameChannel, - roleIdVerified, - requiresSupport, - hasExistingBinding: mapped.hasExistingBinding, - rebindRequested: mapped.rebindRequested, - rebindUnchanged: mapped.rebindUnchanged, - rebindConfirmState: mapped.rebindConfirmState, - rebindConfirmMessage: mapped.rebindConfirmMessage, - bindConfirmState: mapped.bindConfirmState, - bindConfirmMessage: mapped.bindConfirmMessage, - rebindCooldownDays: mapped.rebindCooldownDays, - nextRebindAt: mapped.nextRebindAt, - platformChangeBindDay: mapped.platformChangeBindDay, - platformChangeBindTime: mapped.platformChangeBindTime, - message: mapped.message, - comparison, - } -} - -export async function startPublicLogin(orderNoInput: unknown, taskIdInput: unknown) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - await ensureSemiAutoTasksForOrder(orderNo) - const task = await loadTaskForOrder(orderNo, taskId) - if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { - throw createHttpError('当前订单已结束,不能重新登录', { - statusCode: 409, - errorCode: 'semi_auto_task_closed', - }) - } - - let reusableSession: ConnectorLoginSession | null = null - if ( - task.connector_session_id && - task.login_status !== 'expired' && - task.login_status !== 'failed' - ) { - try { - reusableSession = await getLoginSessionForTask(task, task.connector_session_id) - } catch { - // Connector 重启或短期会话被清理后,任务里的旧 ID 已不可用;重新创建前先尽力撤销。 - await revokeSessionForTask(task, task.connector_session_id).catch(() => undefined) - } - } else if (task.connector_session_id) { - await revokeSessionForTask(task, task.connector_session_id).catch(() => undefined) - } - - if ( - reusableSession?.status === 'waiting_code' || - reusableSession?.status === 'verification_pending' - ) { - await revokeSessionForTask(task, reusableSession.sessionId).catch(() => undefined) - reusableSession = null - } - - if (reusableSession) { - await updateLoginTask(task, reusableSession, 'customer') - const refreshedTask = await loadTask(task.id) - return { - task: mapTask(refreshedTask), - login: { - status: mapLoginUpdate(reusableSession).status, - qrContent: reusableSession.qrContent, - qrImage: String(reusableSession.qrImage || ''), - expiresAt: reusableSession.expiresAt, - message: reusableSession.message, - }, - } - } - - const session = await createLoginSessionForTask(task, orderNo) - await withTransaction(async (client) => { - await client.query( - ` - UPDATE semi_auto_tasks - SET connector_session_id = $2, - login_status = 'qr_pending', - binding_status = 'not_started', - bind_game_account = '', - bind_game_role = '', - bind_game_role_id = '', - bind_game_channel = '', - binding_started_at = NULL, - bound_at = NULL, - execution_status = 'waiting_customer', - auth_started_at = COALESCE(auth_started_at, NOW()), - last_error = '', - updated_at = NOW() - WHERE id = $1 - `, - [task.id, session.sessionId], - ) - await appendTaskEvent(client, task.id, { - eventType: 'login_started', - actorType: 'customer', - fromLoginStatus: task.login_status, - toLoginStatus: 'qr_pending', - fromExecutionStatus: task.execution_status, - toExecutionStatus: 'waiting_customer', - detail: { expiresAt: session.expiresAt }, - }) - }) - const refreshedTask = await loadTask(task.id) - return { - task: mapTask(refreshedTask), - login: { - status: mapLoginUpdate(session).status, - qrContent: session.qrContent, - qrImage: String(session.qrImage || ''), - expiresAt: session.expiresAt, - message: session.message, - }, - } -} - -export async function pollPublicLogin(orderNoInput: unknown, taskIdInput: unknown) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - const task = await ensureConnectorSessionForTask(await loadTaskForOrder(orderNo, taskId)) - if (!task.connector_session_id) { - return { task: mapTask(task), login: null } - } - const session = await getLoginSessionForTask(task, task.connector_session_id) - await updateLoginTask(task, session, 'customer') - const updated = await loadTask(task.id) - return { - task: mapTask(updated), - login: { - status: mapLoginUpdate(session).status, - qrContent: session.qrContent, - qrImage: String(session.qrImage || ''), - expiresAt: session.expiresAt, - message: session.message, - }, - } -} - -export async function startPublicBinding( - orderNoInput: unknown, - taskIdInput: unknown, - input: { forceRebind?: unknown } = {}, -) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - const task = await loadTaskForOrder(orderNo, taskId) - if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { - throw createHttpError('当前订单已结束,不能重新绑定', { - statusCode: 409, - errorCode: 'semi_auto_task_closed', - }) - } - if (!task.connector_session_id || task.login_status !== 'authenticated') { - throw createHttpError('请先完成平台登录', { - statusCode: 409, - errorCode: 'semi_auto_login_required', - }) - } - assertCustomerProfileReady(task) - const session = - task.platform === 'weibo' - ? await getWeiboBinding(task.connector_session_id, task.connector_mode) - : await startHuyaBinding(task.connector_session_id, task.connector_mode, { - forceRebind: input.forceRebind === true, - }) - const binding = await updateBindingTask(task, session, 'customer') - const updated = await loadTask(task.id) - return { task: mapTask(updated), binding } -} - -/** - * 客户在失败/不一致页面点「上一步修改资料」: - * 清空绑定/换绑状态,保留登录会话和客户资料;重新提交资料后重新走绑定流程。 - */ -export async function resetPublicBinding(orderNoInput: unknown, taskIdInput: unknown) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - const task = await loadTaskForOrder(orderNo, taskId) - if (task.platform !== 'huya') { - throw createHttpError('当前平台不需要重置绑定状态', { - statusCode: 409, - errorCode: 'semi_auto_binding_reset_not_supported', - }) - } - if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { - throw createHttpError('当前订单已结束,不能返回修改资料', { - statusCode: 409, - errorCode: 'semi_auto_task_closed', - }) - } - if (task.binding_status === 'confirmed') { - throw createHttpError('绑定已确认,不能返回修改资料', { - statusCode: 409, - errorCode: 'semi_auto_profile_locked', - }) - } - if (!task.connector_session_id || task.login_status !== 'authenticated') { - throw createHttpError('请先完成平台登录', { - statusCode: 409, - errorCode: 'semi_auto_login_required', - }) - } - - // 清空 Connector 内存里的换绑失败状态;外部 Connector 尚未提供 reset 时, - // 本地状态仍重置,客户可继续修改资料,不能被旧的失败状态卡死。 - try { - await resetHuyaBinding(task.connector_session_id, task.connector_mode) - } catch { - // 仅清理本地持久化状态;下一次绑定会重新查询平台角色。 - } - - await withTransaction(async (client) => { - await client.query( - ` - UPDATE semi_auto_tasks - SET binding_status = 'not_started', - bind_game_role = '', - bind_game_role_id = '', - bind_game_channel = '', - binding_started_at = NULL, - bound_at = NULL, - execution_status = 'waiting_customer', - last_error = '', - updated_at = NOW() - WHERE id = $1 - `, - [task.id], - ) - await appendTaskEvent(client, task.id, { - eventType: 'binding_reset', - actorType: 'customer', - fromBindingStatus: task.binding_status, - toBindingStatus: 'not_started', - fromExecutionStatus: task.execution_status, - toExecutionStatus: 'waiting_customer', - detail: { - reason: 'customer_profile_edit', - customerProfileKept: true, - }, - }) - }) - const updated = await loadTask(task.id) - return { task: mapTask(updated), binding: null } -} - -export async function pollPublicBinding(orderNoInput: unknown, taskIdInput: unknown) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - const task = await loadTaskForOrder(orderNo, taskId) - if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { - return { task: mapTask(task), binding: null } - } - if (!task.connector_session_id || task.login_status !== 'authenticated') { - return { task: mapTask(task), binding: null } - } - const session = await getBindingForTask(task, task.connector_session_id) - const binding = await updateBindingTask(task, session, 'customer') - const updated = await loadTask(task.id) - return { task: mapTask(updated), binding } -} - -export async function confirmPublicBinding( - orderNoInput: unknown, - taskIdInput: unknown, - options: { acceptExistingRole?: boolean } = {}, -) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - const task = await loadTaskForOrder(orderNo, taskId) - if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { - throw createHttpError('当前订单已结束,不能确认绑定', { - statusCode: 409, - errorCode: 'semi_auto_task_closed', - }) - } - if ( - !task.connector_session_id || - (task.platform !== 'weibo' && task.binding_status !== 'role_ready') - ) { - throw createHttpError('当前没有待确认的绑定角色', { - statusCode: 409, - errorCode: 'semi_auto_binding_not_ready', - }) - } - assertCustomerProfileReady(task) - // 确认绑定是纯本地动作:虎牙侧只读内存快照,不再触发角色查询或换绑提交。 - const session = - task.platform === 'huya' - ? await getHuyaBindingSnapshot(task.connector_session_id, task.connector_mode) - : await getBindingForTask(task, task.connector_session_id) - const comparison = compareBindingRole(task, session) - // 换绑被虎牙拒绝时平台仍返回原角色。若客户已把资料改成与原角色一致, - // 允许直接确认;否则要求重新扫码或返回上一步修改资料。 - if ( - task.platform === 'huya' && - session.rebindUnchanged === true && - comparison.verdict !== 'match' - ) { - const reason = String(session.rebindConfirmMessage || '').trim() - throw createHttpError( - `${ - reason ? `换绑未成功:${reason}。` : '换绑未生效:平台仍返回原绑定角色。' - }请重新扫码换绑,或返回上一步修改资料,使资料与平台当前角色一致后再提交平台绑定`, - { - statusCode: 409, - errorCode: 'semi_auto_binding_rebind_decision_required', - }, - ) - } - // 三项必须全部存在且一致;信息不完整同样不能自动放行,必须转客服核实。 - if (comparison.verdict !== 'match') { - throw createHttpError(comparison.message, { - statusCode: 409, - errorCode: - comparison.verdict === 'mismatch' - ? 'semi_auto_binding_role_mismatch' - : 'semi_auto_binding_role_unverifiable', - }) - } - // 必须调用 Connector 完成确认,否则会话仍是 role_ready,数据库也会停在待确认。 - const confirmedSession = - task.platform === 'huya' - ? await confirmHuyaBinding(task.connector_session_id, task.connector_mode, { - ...(options.acceptExistingRole === true || session.rebindUnchanged === true - ? { acceptExistingRole: true } - : {}), - }) - : session - const binding = await updateBindingTask(task, confirmedSession, 'customer') - const updated = await loadTask(task.id) - return { task: mapTask(updated), binding } -} - -/** - * 客户在微信里选好目标角色后,由项目侧主动向虎牙提交换绑确认。 - * 与「确认绑定」不同,这一步只提交换绑,不把任务标记为已确认。 - */ -export async function submitPublicRebind(orderNoInput: unknown, taskIdInput: unknown) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - const task = await loadTaskForOrder(orderNo, taskId) - if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { - throw createHttpError('当前订单已结束,不能提交换绑', { - statusCode: 409, - errorCode: 'semi_auto_task_closed', - }) - } - if (task.platform !== 'huya') { - throw createHttpError('当前平台不需要换绑游戏角色', { - statusCode: 409, - errorCode: 'semi_auto_rebind_not_supported', - }) - } - if (!task.connector_session_id || task.login_status !== 'authenticated') { - throw createHttpError('请先完成平台登录', { - statusCode: 409, - errorCode: 'semi_auto_login_required', - }) - } - assertCustomerProfileReady(task) - const session = await submitHuyaRebind(task.connector_session_id, task.connector_mode) - const binding = await updateBindingTask(task, session, 'customer') - const updated = await loadTask(task.id) - return { task: mapTask(updated), binding } -} - -export async function sendPublicHuyaSmsCode( - orderNoInput: unknown, - taskIdInput: unknown, - mobileInput: unknown, -) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - const task = await loadTaskForOrder(orderNo, taskId) - assertHuyaTask(task) - if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { - throw createHttpError('当前订单已结束,不能重新登录', { - statusCode: 409, - errorCode: 'semi_auto_task_closed', - }) - } - - const result = await sendHuyaSmsCode( - { - taskId: task.id, - orderNo, - mobile: String(mobileInput ?? '').trim(), - }, - task.connector_mode, - ) - const session = result.session - const previousSessionId = task.connector_session_id - try { - await withTransaction(async (client) => { - await client.query( - ` - UPDATE semi_auto_tasks - SET connector_session_id = $2, - login_status = 'waiting_login', - execution_status = 'waiting_customer', - auth_started_at = COALESCE(auth_started_at, NOW()), - last_error = '', - updated_at = NOW() - WHERE id = $1 - `, - [task.id, session.sessionId], - ) - await appendTaskEvent(client, task.id, { - eventType: result.challenge ? 'sms_verification_required' : 'sms_code_sent', - actorType: 'customer', - fromLoginStatus: task.login_status, - toLoginStatus: 'waiting_login', - fromExecutionStatus: task.execution_status, - toExecutionStatus: 'waiting_customer', - detail: { - method: 'sms', - expiresAt: session.expiresAt, - ...(result.challenge ? { verificationType: result.challenge.type } : {}), - }, - }) - }) - } catch (error) { - await revokeHuyaSession(session.sessionId, task.connector_mode).catch(() => undefined) - throw error - } - if (previousSessionId && previousSessionId !== session.sessionId) { - await revokeHuyaSession(previousSessionId, task.connector_mode).catch(() => undefined) - } - return { - ok: !result.challenge, - message: session.message || '验证码已发送,请注意查收', - expiresAt: session.expiresAt, - challenge: result.challenge, - } -} - -export async function verifyPublicHuyaSmsChallenge( - orderNoInput: unknown, - taskIdInput: unknown, - input: { distance?: unknown; angle?: unknown; points?: unknown } = {}, -) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - const task = await loadTaskForOrder(orderNo, taskId) - assertHuyaTask(task) - if (!task.connector_session_id) { - throw createHttpError('虎牙安全验证会话不存在,请重新发送验证码', { - statusCode: 409, - errorCode: 'huya_sms_verification_not_found', - }) - } - const distance = - input.distance === undefined || input.distance === null ? undefined : Number(input.distance) - const angle = input.angle === undefined || input.angle === null ? undefined : Number(input.angle) - const points = Array.isArray(input.points) - ? input.points.map((value) => { - const point = value && typeof value === 'object' ? (value as Record) : {} - return { x: Number(point.x), y: Number(point.y) } - }) - : undefined - if ( - (distance !== undefined && (!Number.isInteger(distance) || distance < 0)) || - (angle !== undefined && (!Number.isInteger(angle) || angle < 0 || angle > 359)) || - (points && - (points.length === 0 || - points.some((point) => !Number.isFinite(point.x) || !Number.isFinite(point.y)))) - ) { - throw createHttpError('安全验证参数无效,请重新完成', { - statusCode: 400, - errorCode: 'huya_sms_verification_solution_invalid', - }) - } - const result = await verifyHuyaSmsChallenge( - { - sessionId: task.connector_session_id, - ...(distance !== undefined ? { distance } : {}), - ...(angle !== undefined ? { angle } : {}), - ...(points ? { points } : {}), - }, - task.connector_mode, - ) - await withTransaction(async (client) => { - await client.query( - ` - UPDATE semi_auto_tasks - SET connector_session_id = $2, - login_status = 'waiting_login', - execution_status = 'waiting_customer', - last_error = '', - updated_at = NOW() - WHERE id = $1 - `, - [task.id, result.session.sessionId], - ) - await appendTaskEvent(client, task.id, { - eventType: result.challenge ? 'sms_verification_required' : 'sms_code_sent', - actorType: 'customer', - fromLoginStatus: task.login_status, - toLoginStatus: 'waiting_login', - fromExecutionStatus: task.execution_status, - toExecutionStatus: 'waiting_customer', - detail: { - method: 'sms', - verificationCompleted: !result.challenge, - }, - }) - }) - return { - ok: !result.challenge, - message: result.session.message || '验证码已发送,请注意查收', - expiresAt: result.session.expiresAt, - challenge: result.challenge, - } -} - -export async function loginPublicHuyaSms( - orderNoInput: unknown, - taskIdInput: unknown, - input: { mobile?: unknown; code?: unknown } = {}, -) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - const task = await loadTaskForOrder(orderNo, taskId) - assertHuyaTask(task) - if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { - throw createHttpError('当前订单已结束,不能重新登录', { - statusCode: 409, - errorCode: 'semi_auto_task_closed', - }) - } - if (!task.connector_session_id) { - throw createHttpError('请先发送虎牙短信验证码', { - statusCode: 409, - errorCode: 'huya_sms_code_required', - }) - } - - const session = await loginHuyaSms( - { - sessionId: task.connector_session_id, - taskId: task.id, - orderNo, - mobile: String(input.mobile ?? '').trim(), - code: String(input.code ?? '').trim(), - }, - task.connector_mode, - ) - const mapped = mapLoginUpdate(session) - if (session.status !== 'authenticated') { - await updateLoginTask(task, session, 'customer', { - credentialSource: 'sms', - method: 'sms', - }) - throw createHttpError(mapped.message || '虎牙短信登录失败,请重试', { - statusCode: 409, - errorCode: 'huya_login_failed', - }) - } - - await updateLoginTask(task, session, 'customer', { - credentialSource: 'sms', - method: 'sms', - }) - const updated = await loadTask(task.id) - return { - task: mapTask(updated), - login: { - status: mapped.status, - qrContent: '', - qrImage: '', - expiresAt: session.expiresAt, - message: session.message, - }, - } -} - -export async function sendPublicWeiboSmsCode( - orderNoInput: unknown, - taskIdInput: unknown, - mobileInput: unknown, - countryCodeInput: unknown = '86', - mfaIdInput: unknown = '', -) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - const task = await loadTaskForOrder(orderNo, taskId) - assertWeiboTask(task) - if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { - throw createHttpError('当前订单已结束,不能重新登录', { - statusCode: 409, - errorCode: 'semi_auto_task_closed', - }) - } - const result = await sendWeiboSmsCode( - { - taskId: task.id, - mobile: String(mobileInput ?? '').trim(), - countryCode: String(countryCodeInput ?? '86').trim() || '86', - mfaId: String(mfaIdInput ?? '').trim(), - }, - task.connector_mode, - ) - return { - ok: !result.mfaRequired, - message: result.mfaRequired ? '需要完成微博安全验证' : '验证码已发送,请注意查收', - ...result, - } -} - -export async function loginPublicWeiboSms( - orderNoInput: unknown, - taskIdInput: unknown, - input: { mobile?: unknown; code?: unknown; countryCode?: unknown; rid?: unknown } = {}, -) { - const orderNo = normalizeOrderNo(orderNoInput) - const taskId = normalizeId(taskIdInput) - const task = await loadTaskForOrder(orderNo, taskId) - assertWeiboTask(task) - if (task.execution_status === 'completed' || task.execution_status === 'cancelled') { - throw createHttpError('当前订单已结束,不能重新登录', { - statusCode: 409, - errorCode: 'semi_auto_task_closed', - }) - } - - const previousSessionId = task.connector_session_id - const { sessionId, session } = await loginWeiboSms( - { - taskId: task.id, - orderNo, - mobile: String(input.mobile ?? '').trim(), - code: String(input.code ?? '').trim(), - countryCode: String(input.countryCode ?? '86').trim() || '86', - rid: String(input.rid ?? '').trim(), - }, - task.connector_mode, - ) - const mapped = mapLoginUpdate(session) - const storedCredential = - session.status === 'authenticated' && session.hasCredential - ? exportWeiboSessionCredential(sessionId, task.connector_mode) - : null - - if (session.status !== 'authenticated') { - await withTransaction(async (client) => { - await client.query( - ` - UPDATE semi_auto_tasks - SET connector_session_id = $2, - login_status = $3, - last_error = $4, - updated_at = NOW() - WHERE id = $1 - `, - [task.id, sessionId, mapped.status, mapped.message], - ) - await appendTaskEvent(client, task.id, { - eventType: 'login_status_changed', - actorType: 'customer', - fromLoginStatus: task.login_status, - toLoginStatus: mapped.status, - fromExecutionStatus: task.execution_status, - toExecutionStatus: task.execution_status, - detail: { method: 'sms', message: mapped.message }, - }) - }) - throw createHttpError(mapped.message || '微博登录失败,请重试', { - statusCode: 409, - errorCode: 'weibo_login_failed', - }) - } - - const nextExecutionStatus: ExecutionStatus = 'waiting_operator' - await withTransaction(async (client) => { - const credentialId = storedCredential - ? await upsertSemiAutoCredentialWithClient(client, { - platform: 'weibo', - source: 'sms', - payload: storedCredential, - }) - : null - await client.query( - ` - UPDATE semi_auto_tasks - SET connector_session_id = $2, - credential_id = COALESCE($5, credential_id), - login_status = 'authenticated', - execution_status = 'waiting_operator', - huya_uid = CASE WHEN $3 <> '' THEN $3 ELSE huya_uid END, - platform_nickname = CASE WHEN $4 <> '' THEN $4 ELSE platform_nickname END, - auth_started_at = COALESCE(auth_started_at, NOW()), - authenticated_at = COALESCE(authenticated_at, NOW()), - last_error = '', - updated_at = NOW() - WHERE id = $1 - `, - [task.id, sessionId, mapped.uid, mapped.nickname, credentialId], - ) - await appendTaskEvent(client, task.id, { - eventType: 'login_status_changed', - actorType: 'customer', - fromLoginStatus: task.login_status, - toLoginStatus: 'authenticated', - fromExecutionStatus: task.execution_status, - toExecutionStatus: nextExecutionStatus, - detail: { method: 'sms', hasCredential: mapped.hasCredential, message: mapped.message }, - }) - }) - - if (previousSessionId && previousSessionId !== sessionId) { - await revokeWeiboSession(previousSessionId, task.connector_mode).catch(() => undefined) - } - const updated = await loadTask(task.id) - return { - task: mapTask(updated), - login: { - status: mapped.status, - qrContent: '', - qrImage: '', - expiresAt: session.expiresAt, - message: session.message, - }, - } -} - -export async function getPublicWeiboCountryCodes(orderNoInput: unknown, taskIdInput: unknown) { - const task = await loadTaskForOrder(normalizeOrderNo(orderNoInput), normalizeId(taskIdInput)) - assertWeiboTask(task) - return { countryCodes: await getWeiboCountryCodes(task.connector_mode) } -} - -export async function startPublicWeiboQrLogin(orderNoInput: unknown, taskIdInput: unknown) { - const task = await loadTaskForOrder(normalizeOrderNo(orderNoInput), normalizeId(taskIdInput)) - assertWeiboTask(task) - return startPublicLogin(orderNoInput, taskIdInput) -} - -export async function pollPublicWeiboQrLogin(orderNoInput: unknown, taskIdInput: unknown) { - const task = await loadTaskForOrder(normalizeOrderNo(orderNoInput), normalizeId(taskIdInput)) - assertWeiboTask(task) - return pollPublicLogin(orderNoInput, taskIdInput) -} - -export async function listAdminSemiAutoTasks(input: Record = {}) { - await backfillSemiAutoTasks() - const page = Math.max(1, Math.trunc(Number(input.page) || 1)) - const pageSize = Math.min(100, Math.max(1, Math.trunc(Number(input.pageSize) || 20))) - const platform = String(input.platform || '').trim() - const status = String(input.status || '').trim() - const keyword = String(input.keyword || '').trim() - const conditions = ['1 = 1'] - const params: unknown[] = [] - if (platform === 'huya' || platform === 'weibo') { - params.push(platform) - conditions.push(`task.platform = $${params.length}`) - } - if ( - [ - 'waiting_customer', - 'waiting_operator', - 'processing', - 'completed', - 'failed', - 'cancelled', - ].includes(status) - ) { - params.push(status) - conditions.push(`task.execution_status = $${params.length}`) - } - if (keyword) { - params.push(`%${keyword.replace(/[\\%_]/g, '\\$&')}%`) - const p = `$${params.length}` - conditions.push( - `(o.platform_order_id ILIKE ${p} OR oi.sku_name ILIKE ${p} OR oi.sku_code ILIKE ${p} OR task.huya_uid ILIKE ${p} OR task.bind_game_role ILIKE ${p})`, - ) - } - const where = conditions.join(' AND ') - const count = await query<{ total: number }>( - `SELECT COUNT(*)::int AS total - FROM semi_auto_tasks task - JOIN orders o ON o.id = task.order_id - JOIN order_items oi ON oi.id = task.order_item_id - WHERE ${where}`, - params, - ) - const listParams = [...params, pageSize, (page - 1) * pageSize] - const result = await query( - `${TASK_SELECT} - WHERE ${where} - ORDER BY - CASE task.execution_status - WHEN 'waiting_operator' THEN 0 - WHEN 'waiting_customer' THEN 1 - WHEN 'processing' THEN 2 - WHEN 'failed' THEN 3 - ELSE 4 - END, - task.updated_at DESC, - task.id DESC - LIMIT $${listParams.length - 1} OFFSET $${listParams.length}`, - listParams, - ) - return { - items: result.rows.map(mapTask), - pagination: { page, pageSize, total: Number(count.rows[0]?.total || 0) }, - } -} - -export async function getAdminSemiAutoTask(taskIdInput: unknown) { - const task = await loadTask(normalizeId(taskIdInput)) - const events = await query<{ - id: number - event_type: string - actor_type: string - actor_id: string - detail_json: Record - created_at: string - }>( - `SELECT id, event_type, actor_type, actor_id, detail_json, created_at - FROM semi_auto_task_events - WHERE task_id = $1 - ORDER BY id DESC - LIMIT 200`, - [task.id], - ) - return { - task: mapTask(task), - // 管理端详情直接复用与客户页相同的三项比对口径,避免出现第二套判定。 - comparison: compareBindingRole(task, { - bindGameRole: task.bind_game_role, - bindGameRoleId: task.bind_game_role_id, - bindGameChannel: task.bind_game_channel, - }), - events: events.rows.map((event) => ({ - id: Number(event.id), - eventType: event.event_type, - actorType: event.actor_type, - actorId: event.actor_id, - detail: event.detail_json || {}, - createdAt: event.created_at, - })), - } -} - -type SemiAutoTaskEventRow = { - id: number - event_type: string - actor_type: string - actor_id: string - from_login_status: string | null - to_login_status: string | null - from_binding_status: string | null - to_binding_status: string | null - from_execution_status: string | null - to_execution_status: string | null - detail_json: Record - created_at: string -} - -/** - * 运营端「历史」:任务状态流转事件 + 全链路报文(本系统入站 + 外部平台出站)。 - * 报文只读,不做任何写操作;Cookie / Token 已在落库前脱敏。 - */ -export async function getAdminSemiAutoTaskHistory( - taskIdInput: unknown, - input: Record = {}, -) { - const task = await loadTask(normalizeId(taskIdInput)) - const eventCount = await query<{ total: number }>( - `SELECT COUNT(*)::int AS total FROM semi_auto_task_events WHERE task_id = $1`, - [task.id], - ) - const events = await query( - `SELECT * FROM ( - SELECT id, event_type, actor_type, actor_id, - from_login_status, to_login_status, - from_binding_status, to_binding_status, - from_execution_status, to_execution_status, - detail_json, created_at - FROM semi_auto_task_events - WHERE task_id = $1 - ORDER BY id DESC - LIMIT 500 - ) recent - ORDER BY id ASC`, - [task.id], - ) - const traces = await querySemiAutoTraces(task.id, { - page: Number(input.page) || 1, - pageSize: Number(input.pageSize) || 50, - channel: String(input.channel || '').trim(), - status: String(input.status || '').trim(), - requestId: String(input.requestId || '').trim(), - keyword: String(input.keyword || '').trim(), - }) - return { - task: mapTask(task), - events: events.rows.map((event) => ({ - id: Number(event.id), - eventType: event.event_type, - actorType: event.actor_type, - actorId: event.actor_id, - fromLoginStatus: event.from_login_status, - toLoginStatus: event.to_login_status, - fromBindingStatus: event.from_binding_status, - toBindingStatus: event.to_binding_status, - fromExecutionStatus: event.from_execution_status, - toExecutionStatus: event.to_execution_status, - detail: event.detail_json || {}, - createdAt: event.created_at, - })), - eventTotal: Number(eventCount.rows[0]?.total || 0), - traces, - } -} - -export async function exportAdminSemiAutoCredential(taskIdInput: unknown) { - const task = await loadTask(normalizeId(taskIdInput)) - if (!task.credential_id) { - throw createHttpError('当前任务尚未保存账号 CK', { - statusCode: 404, - errorCode: 'semi_auto_credential_not_found', - }) - } - const credential = await loadSemiAutoCredential(task.credential_id) - if (!credential || credential.platform !== task.platform) { - throw createHttpError('账号 CK 不存在或与任务平台不一致', { - statusCode: 404, - errorCode: 'semi_auto_credential_not_found', - }) - } - const config = safeParseJson(task.semi_auto_config_json) - const targets = Array.isArray(config.browserTargets) ? config.browserTargets : [] - const configuredTarget = String( - targets.find((item): item is { url?: string } => Boolean(item && typeof item === 'object')) - ?.url || '', - ).trim() - const targetUrl = /^https:\/\//i.test(configuredTarget) - ? configuredTarget - : credential.platform === 'weibo' - ? 'https://weibo.com/' - : 'https://www.huya.com/' - const cookieHeader = targetUrl - ? buildSemiAutoCredentialCookieHeader(credential.cookies, targetUrl) - : '' - return { - credentialId: credential.id, - platform: credential.platform, - platformUid: credential.platformUid, - nickname: credential.nickname, - source: credential.source, - status: credential.status, - updatedAt: credential.updatedAt, - targetUrl, - cookieHeader, - cookies: credential.cookies, - } -} - -export async function claimAdminSemiAutoTask(taskIdInput: unknown, session: AdminSession) { - const taskId = normalizeId(taskIdInput) - const task = await loadTask(taskId) - const adminUserId = Number(session.userId || 0) - if (task.assigned_admin_user_id && Number(task.assigned_admin_user_id) !== adminUserId) { - throw createHttpError('该任务已被其他客服领取', { - statusCode: 409, - errorCode: 'semi_auto_task_claimed', - }) - } - await withTransaction(async (client) => { - await client.query( - `UPDATE semi_auto_tasks - SET assigned_admin_user_id = $2, updated_at = NOW() - WHERE id = $1`, - [taskId, adminUserId], - ) - await appendTaskEvent(client, taskId, { - eventType: 'task_claimed', - actorType: 'admin', - actorId: String(adminUserId), - }) - }) - return getAdminSemiAutoTask(taskId) -} - -export async function syncAdminSemiAutoTask(taskIdInput: unknown) { - const taskId = normalizeId(taskIdInput) - let task = await ensureConnectorSessionForTask(await loadTask(taskId)) - if (!task.connector_session_id) return getAdminSemiAutoTask(taskId) - if ( - task.login_status !== 'authenticated' && - task.login_status !== 'failed' && - task.login_status !== 'expired' - ) { - const login = await getLoginSessionForTask(task, task.connector_session_id) - await updateLoginTask(task, login, 'connector') - task = await loadTask(taskId) - } - return getAdminSemiAutoTask(taskId) -} - -export async function requestAdminSemiAutoCustomerReauth( - taskIdInput: unknown, - session: AdminSession, -) { - const taskId = normalizeId(taskIdInput) - const task = await loadTask(taskId) - if (task.execution_status === 'completed') { - throw createHttpError('已完成任务不能重新授权', { - statusCode: 409, - errorCode: 'semi_auto_task_completed', - }) - } - if (task.execution_status === 'cancelled') { - throw createHttpError('已取消任务不能重新授权', { - statusCode: 409, - errorCode: 'semi_auto_task_cancelled', - }) - } - const adminUserId = Number(session.userId || 0) - if (task.assigned_admin_user_id && Number(task.assigned_admin_user_id) !== adminUserId) { - throw createHttpError('该任务已被其他客服领取', { - statusCode: 409, - errorCode: 'semi_auto_task_claimed', - }) - } - if (task.connector_session_id) { - await revokeSessionForTask(task, task.connector_session_id).catch(() => undefined) - } - await resetTaskForCustomerLogin(task, { - actorType: 'admin', - actorId: String(adminUserId), - reason: '客服已重新发送授权链接,等待客户重新登录', - eventType: 'customer_reauth_requested', - }) - return getAdminSemiAutoTask(taskId) -} - -export async function createAdminBrowserSession( - taskIdInput: unknown, - targetUrlInput: unknown, - session: AdminSession, -) { - const taskId = normalizeId(taskIdInput) - const task = await ensureConnectorSessionForTask(await loadTask(taskId)) - const adminUserId = Number(session.userId || 0) - if (task.assigned_admin_user_id && Number(task.assigned_admin_user_id) !== adminUserId) { - throw createHttpError('该任务已被其他客服领取', { - statusCode: 409, - errorCode: 'semi_auto_task_claimed', - }) - } - if (!task.connector_session_id || task.login_status !== 'authenticated') { - throw createHttpError('客户尚未完成登录,或登录会话已失效', { - statusCode: 409, - errorCode: 'semi_auto_login_required', - }) - } - const config = safeParseJson(task.semi_auto_config_json) - const targets = Array.isArray(config.browserTargets) ? config.browserTargets : [] - const explicitTarget = String(targetUrlInput || '').trim() - const fallbackTarget = targets.find((item): item is { url?: string } => - Boolean(item && typeof item === 'object'), - )?.url - const targetUrl = explicitTarget || String(fallbackTarget || '') - const ticket = - task.platform === 'weibo' - ? await createWeiboBrowserTicket( - { sessionId: task.connector_session_id, targetUrl }, - task.connector_mode, - ) - : await createHuyaBrowserTicket( - { - sessionId: task.connector_session_id, - targetUrl, - }, - task.connector_mode, - ) - await withTransaction(async (client) => { - await client.query( - `UPDATE semi_auto_tasks - SET assigned_admin_user_id = COALESCE(assigned_admin_user_id, $2), - execution_status = CASE WHEN execution_status = 'waiting_operator' THEN 'processing' ELSE execution_status END, - updated_at = NOW() - WHERE id = $1`, - [taskId, adminUserId], - ) - await appendTaskEvent(client, taskId, { - eventType: 'browser_session_opened', - actorType: 'admin', - actorId: String(adminUserId), - detail: { targetUrl }, - }) - }) - return ticket -} - -/** - * 票据内的 targetUrl 只服务于创建阶段的 Cookie 序列化与审计; - * 下发给扩展时清空,指定平台页统一由前端占位页在注入成功后打开, - * 这样扩展只写 Cookie,不会再额外打开一个目标页标签。 - */ -export function buildExtensionInjectionPayload( - payload: ConnectorInjectionPayload, -): ConnectorInjectionPayload { - return { ...payload, targetUrl: '' } -} - -export async function consumeSemiAutoInjectionTicket(ticketInput: unknown) { - const ticket = String(ticketInput || '').trim() - if (!ticket) { - throw createHttpError('注入票据无效', { - statusCode: 400, - errorCode: 'semi_auto_injection_ticket_invalid', - }) - } - const payload = ticket.startsWith(WEIBO_TICKET_PREFIX) - ? await consumeWeiboBrowserTicket(ticket) - : await consumeHuyaBrowserTicket(ticket) - return buildExtensionInjectionPayload(payload) -} - -async function resolveCompletionEvidence( - screenshots: unknown, - session: AdminSession, -): Promise { - const files = Array.isArray(screenshots) ? screenshots : [] - const uploaderId = String(session.userId || session.username || '') - const result: UploadedFileDto[] = [] - for (const item of files.slice(0, 10)) { - const source = item && typeof item === 'object' ? (item as Record) : {} - const objectKey = String(source.objectKey || source.object_key || '').trim() - if (!objectKey) continue - const asset = await getFileAssetByObjectKey(objectKey) - if ( - !asset || - asset.status !== 'active' || - asset.uploader_type !== 'admin' || - asset.uploader_id !== uploaderId || - asset.scene !== 'semi-auto-evidence' || - !ORDER_SERVICE_SCREENSHOT_CONTENT_TYPES.has(String(asset.content_type || '')) - ) { - throw createHttpError('完成截图无效,请重新上传', { - statusCode: 400, - errorCode: 'semi_auto_evidence_invalid', - }) - } - result.push({ - objectKey: asset.object_key, - url: buildFileUrl(asset.object_key), - thumbnailUrl: buildFileUrl(asset.thumbnail_object_key || asset.object_key), - mediumUrl: buildFileUrl(asset.medium_object_key || asset.object_key), - filename: asset.original_filename, - contentType: asset.content_type, - size: Number(asset.size_bytes || 0), - }) - } - return result -} - -export async function completeAdminSemiAutoTask( - taskIdInput: unknown, - payload: Record, - session: AdminSession, -) { - const taskId = normalizeId(taskIdInput) - let current = await loadTask(taskId) - if (current.execution_status === 'completed') return getAdminSemiAutoTask(taskId) - current = await ensureConnectorSessionForTask(current) - if (current.execution_status === 'completed') return getAdminSemiAutoTask(taskId) - if (current.execution_status === 'cancelled') { - throw createHttpError('任务已取消,不能完成', { - statusCode: 409, - errorCode: 'semi_auto_task_cancelled', - }) - } - const screenshots = await resolveCompletionEvidence(payload.screenshots || [], session) - const note = String(payload.note || '') - .trim() - .slice(0, 1000) - const externalOrderNo = String(payload.externalOrderNo || payload.external_order_no || '') - .trim() - .slice(0, 200) - const costFenRaw = Number(payload.costFen ?? payload.cost_fen) - const costFen = - Number.isFinite(costFenRaw) && costFenRaw >= 0 ? Math.trunc(costFenRaw) : undefined - const completionNote = [note, externalOrderNo ? `外部单号:${externalOrderNo}` : ''] - .filter(Boolean) - .join(';') - const adminUserId = Number(session.userId || 0) - - // 人工财务确认、履约状态和半自动任务完成必须同事务提交: - // 任何任务更新失败都会回滚成本快照、钱包扣减和履约状态,避免“已扣钱但任务未完成”。 - const completion = await withTransaction(async (client) => { - const task = await loadTaskForUpdateWithClient(client, taskId) - if (task.execution_status === 'completed') { - return { task, completedNow: false } - } - if (task.execution_status === 'cancelled') { - throw createHttpError('任务已取消,不能完成', { - statusCode: 409, - errorCode: 'semi_auto_task_cancelled', - }) - } - if ( - task.login_status !== 'authenticated' || - !task.credential_id || - task.credential_status === 'invalid' || - task.credential_status === 'error' - ) { - throw createHttpError('客户账号 CK 尚未就绪或已失效,不能完成履约', { - statusCode: 409, - errorCode: 'semi_auto_credential_required', - }) - } - if (task.assigned_admin_user_id && Number(task.assigned_admin_user_id) !== adminUserId) { - throw createHttpError('该任务已被其他客服领取', { - statusCode: 409, - errorCode: 'semi_auto_task_claimed', - }) - } - - await confirmManualFulfillment( - { - orderItemId: task.order_item_id, - platformKey: task.manual_platform_key, - ...(costFen !== undefined ? { costFen } : {}), - note: completionNote || '半自动履约完成', - }, - session, - { client }, - ) - - const updated = await client.query<{ id: number }>( - ` - UPDATE semi_auto_tasks - SET assigned_admin_user_id = COALESCE(assigned_admin_user_id, $2), - execution_status = 'completed', - completed_quantity = target_quantity, - completed_at = NOW(), - completion_note = $3, - external_order_no = $4, - completion_evidence_json = $5::jsonb, - last_error = '', - updated_at = NOW() - WHERE id = $1 - RETURNING id - `, - [taskId, adminUserId, note, externalOrderNo, JSON.stringify({ screenshots })], - ) - if (!updated.rows[0]) { - throw createHttpError('半自动履约任务状态更新失败', { - statusCode: 500, - errorCode: 'semi_auto_task_completion_failed', - }) - } - await appendTaskEvent(client, taskId, { - eventType: 'task_completed', - actorType: 'admin', - actorId: String(adminUserId), - fromExecutionStatus: task.execution_status, - toExecutionStatus: 'completed', - detail: { - note, - externalOrderNo, - screenshotCount: screenshots.length, - }, - }) - return { task, completedNow: true } - }) - - if (!completion.completedNow) { - return getAdminSemiAutoTask(taskId) - } - await runManualFulfillmentPostCommit(completion.task.order_item_id) - if (completion.task.connector_session_id) { - await revokeSessionForTask(completion.task, completion.task.connector_session_id).catch( - () => undefined, - ) - } - publishAdminOrderRealtimeChange(Number(completion.task.order_id)) - return getAdminSemiAutoTask(taskId) -} - -export async function cancelAdminSemiAutoTask( - taskIdInput: unknown, - payload: Record, - session: AdminSession, -) { - const taskId = normalizeId(taskIdInput) - const task = await loadTask(taskId) - if (task.execution_status === 'completed') { - throw createHttpError('已完成任务不能取消', { - statusCode: 409, - errorCode: 'semi_auto_task_completed', - }) - } - const reason = String(payload.reason || '') - .trim() - .slice(0, 500) - const adminUserId = Number(session.userId || 0) - await withTransaction(async (client) => { - await client.query( - ` - UPDATE semi_auto_tasks - SET execution_status = 'cancelled', - last_error = $2, - updated_at = NOW() - WHERE id = $1 - `, - [taskId, reason], - ) - await appendTaskEvent(client, taskId, { - eventType: 'task_cancelled', - actorType: 'admin', - actorId: String(adminUserId), - fromExecutionStatus: task.execution_status, - toExecutionStatus: 'cancelled', - detail: { reason }, - }) - }) - if (task.connector_session_id) { - await revokeSessionForTask(task, task.connector_session_id).catch(() => undefined) - } - publishAdminOrderRealtimeChange(Number(task.order_id)) - return getAdminSemiAutoTask(taskId) -} +export * from './semi-auto-task-core.js' +export * from './semi-auto-customer-service.js' +export * from './semi-auto-admin-service.js' diff --git a/apps/backend/src/services/semi-auto/semi-auto-task.integration.test.ts b/apps/backend/src/services/semi-auto/semi-auto-task.integration.test.ts index 8ed618b4..0c2b0fb8 100644 --- a/apps/backend/src/services/semi-auto/semi-auto-task.integration.test.ts +++ b/apps/backend/src/services/semi-auto/semi-auto-task.integration.test.ts @@ -5,6 +5,7 @@ * npx tsx --test src/services/semi-auto/semi-auto-task.integration.test.ts */ import assert from 'node:assert/strict' +import { randomUUID } from 'node:crypto' import test from 'node:test' const TEST_DATABASE_URL = String(process.env.SEMI_AUTO_TASK_TEST_DATABASE_URL || '').trim() @@ -24,6 +25,7 @@ test( process.env.DATABASE_URL = TEST_DATABASE_URL const { closeDb, query, withTransaction } = await import('../../db/client.js') const { + applySemiAutoTaskStateSnapshot, confirmPublicBinding, ensureSemiAutoTasksForOrder, exportAdminSemiAutoCredential, @@ -268,6 +270,23 @@ test( ) assert.equal(resetEvents.rows[0]?.detail_json?.reason, 'customer_profile_edit') + // 已确认绑定后的重新授权必须完整退出已授权状态,不能只清登录状态。 + await query( + ` + UPDATE semi_auto_tasks + SET binding_status = 'confirmed', + bind_game_account = '集成测试虎牙账号', + bind_game_role = '集成测试角色', + bind_game_role_id = '1192083858', + bind_game_channel = '安卓(iOS) · QQ', + binding_started_at = NOW(), + bound_at = NOW(), + execution_status = 'waiting_operator', + updated_at = NOW() + WHERE id = $1 + `, + [taskId], + ) const reauthorized = await requestAdminSemiAutoCustomerReauth(taskId, { userId: 1, role: 'support', @@ -277,6 +296,11 @@ test( assert.equal(reauthorized.task.bindingStatus, 'not_started') assert.equal(reauthorized.task.executionStatus, 'waiting_customer') assert.equal(reauthorized.task.customerLinkOpenedAt, null) + assert.equal(reauthorized.task.bindGameAccount, '') + assert.equal(reauthorized.task.bindGameRole, '') + assert.equal(reauthorized.task.bindGameRoleId, '') + assert.equal(reauthorized.task.bindGameChannel, '') + assert.equal(reauthorized.task.boundAt, null) const retainedCredential = await query<{ credential_id: number }>( 'SELECT credential_id FROM semi_auto_tasks WHERE id = $1', [taskId], @@ -285,6 +309,49 @@ test( assert.ok( reauthorized.events.some((event) => event.eventType === 'customer_reauth_requested'), ) + + const snapshotEventId = randomUUID() + const snapshot = await applySemiAutoTaskStateSnapshot( + { + eventId: snapshotEventId, + taskId, + orderNo, + loginStatus: 'authenticated', + bindingStatus: 'confirmed', + huyaUid: `it-huya-${suffix}`, + bindGameAccount: '集成测试虎牙账号', + bindGameRole: '集成测试角色', + bindGameRoleId: '1192083858', + bindGameChannel: '安卓(android) · QQ', + }, + { eventId: snapshotEventId, eventType: 'semi_auto.task_state' }, + ) + assert.equal(snapshot.applied, true) + const duplicateSnapshot = await applySemiAutoTaskStateSnapshot( + { + eventId: snapshotEventId, + taskId, + orderNo, + loginStatus: 'authenticated', + bindingStatus: 'confirmed', + }, + { eventId: snapshotEventId, eventType: 'semi_auto.task_state' }, + ) + assert.equal(duplicateSnapshot.applied, false) + const synced = await query<{ + login_status: string + binding_status: string + execution_status: string + }>( + `SELECT login_status, binding_status, execution_status + FROM semi_auto_tasks WHERE id = $1`, + [taskId], + ) + assert.deepEqual(synced.rows[0], { + login_status: 'authenticated', + binding_status: 'confirmed', + execution_status: 'waiting_operator', + }) } finally { if (orderId > 0) { await query('DELETE FROM order_source_snapshots WHERE order_id = $1', [orderId]) diff --git a/apps/backend/src/services/semi-auto/semi-auto-trace.test.ts b/apps/backend/src/services/semi-auto/semi-auto-trace.test.ts new file mode 100644 index 00000000..e98dfe98 --- /dev/null +++ b/apps/backend/src/services/semi-auto/semi-auto-trace.test.ts @@ -0,0 +1,31 @@ +import assert from 'node:assert/strict' +import test from 'node:test' + +import { stringifyTraceBody } from './semi-auto-trace.js' + +test('半自动请求报文脱敏通用 code、mfa_id 和 rid', () => { + const body = stringifyTraceBody( + { + code: '123456', + mfa_id: 'mfa-secret', + rid: 'request-secret', + mobile: '13800138000', + }, + { maskRequestCode: true }, + ) + + assert.doesNotMatch(body, /123456|mfa-secret|request-secret/) + assert.match(body, /13800138000/) + assert.match(body, /"code": "\*\*\*\*\*\*"/) +}) + +test('半自动响应报文保留业务 code,只屏蔽既有敏感键', () => { + const body = stringifyTraceBody({ + code: 0, + message: 'ok', + cookie: 'SUB=secret', + }) + + assert.match(body, /"code": 0/) + assert.doesNotMatch(body, /SUB=secret/) +}) diff --git a/apps/backend/src/services/semi-auto/semi-auto-trace.ts b/apps/backend/src/services/semi-auto/semi-auto-trace.ts index 0788d1a7..a6eb4c6f 100644 --- a/apps/backend/src/services/semi-auto/semi-auto-trace.ts +++ b/apps/backend/src/services/semi-auto/semi-auto-trace.ts @@ -36,6 +36,8 @@ export type SemiAutoTraceEntry = { durationMs?: number requestSummary?: Record requestBody?: unknown + /** 请求体里的通用 `code` 字段按验证码处理;响应体中的业务 code 保持原样。 */ + maskRequestCode?: boolean responseSummary?: Record responseBody?: unknown errorMessage?: string @@ -86,6 +88,7 @@ const SENSITIVE_KEYS = new Set([ 'ticket', 'credential_payload_json', ]) +const REQUEST_ONLY_SENSITIVE_KEYS = new Set(['code', 'rid', 'mfa_id']) export function runWithSemiAutoTrace(context: SemiAutoTraceContext, fn: () => T): T { return traceStorage.run(context, fn) @@ -106,29 +109,39 @@ function normalizeKey(key: string): string { } /** 深度脱敏:Cookie / Token / 密钥字段直接替换为 ******。 */ -export function redactTraceValue(value: unknown, depth = 0): unknown { +export function redactTraceValue( + value: unknown, + depth = 0, + options: { maskRequestCode?: boolean } = {}, +): unknown { if (depth > MAX_REDACT_DEPTH) return '[max-depth]' if (value === null || value === undefined) return value if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') { return value } if (Array.isArray(value)) { - return value.slice(0, 50).map((item) => redactTraceValue(item, depth + 1)) + return value.slice(0, 50).map((item) => redactTraceValue(item, depth + 1, options)) } if (typeof value === 'object') { const source = value as Record const result: Record = {} for (const [key, current] of Object.entries(source)) { - result[key] = SENSITIVE_KEYS.has(normalizeKey(key)) - ? maskValue(current) - : redactTraceValue(current, depth + 1) + const normalizedKey = normalizeKey(key) + result[key] = + SENSITIVE_KEYS.has(normalizedKey) || + (options.maskRequestCode === true && REQUEST_ONLY_SENSITIVE_KEYS.has(normalizedKey)) + ? maskValue(current) + : redactTraceValue(current, depth + 1, options) } return result } return String(value) } -export function stringifyTraceBody(value: unknown): string { +export function stringifyTraceBody( + value: unknown, + options: { maskRequestCode?: boolean } = {}, +): string { if (value === undefined || value === null) return '' if (typeof value === 'string') { return value.length > MAX_BODY_CHARS @@ -136,7 +149,7 @@ export function stringifyTraceBody(value: unknown): string { : value } try { - const text = JSON.stringify(redactTraceValue(value), null, 2) + const text = JSON.stringify(redactTraceValue(value, 0, options), null, 2) return text.length > MAX_BODY_CHARS ? `${text.slice(0, MAX_BODY_CHARS)}\n...[truncated]` : text } catch { return String(value).slice(0, MAX_BODY_CHARS) @@ -172,7 +185,9 @@ export function recordSemiAutoTrace(entry: SemiAutoTraceEntry): void { const orderNo = entry.orderNo || context?.orderNo || '' const requestId = entry.requestId || context?.requestId || '' const status = entry.status === 'error' ? 'error' : 'ok' - const requestBody = stringifyTraceBody(entry.requestBody) + const requestBody = stringifyTraceBody(entry.requestBody, { + maskRequestCode: entry.maskRequestCode === true, + }) const responseBody = stringifyTraceBody(entry.responseBody) void query( `INSERT INTO semi_auto_trace_logs ( diff --git a/apps/backend/src/startup/bootstrap.ts b/apps/backend/src/startup/bootstrap.ts index d7ee3676..f15d9424 100644 --- a/apps/backend/src/startup/bootstrap.ts +++ b/apps/backend/src/startup/bootstrap.ts @@ -5,6 +5,7 @@ import { ensureFulfillmentCatalogBootstrapped } from '../services/bootstrap/fulf import { migrateJsonConfigFilesToDatabase } from '../services/config/json-config-migration-service.js' import { startKuaishouIndustrySendCallbackRetryWorker } from '../services/platforms/kuaishou-industry/send-code-service.js' import { startDouyuFulfillmentReconciler } from '../services/douyu-fulfillment/fulfillment-reconciler.js' +import { startSemiAutoTaskReconciler } from '../services/semi-auto/semi-auto-task-reconciler.js' import { startScheduledJobs } from '../services/scheduler/scheduler-service.js' import { logError, logInfo } from '../utils/logger.js' import { startMemoryReporter } from './memory-reporter.js' @@ -50,6 +51,7 @@ export async function bootstrapCoreServices( startKuaishouIndustrySendCallbackRetryWorker() startIntegrationOutboxWorker() startDouyuFulfillmentReconciler() + startSemiAutoTaskReconciler() startMemoryReporter() break } catch (error) { diff --git a/apps/backend/src/startup/shutdown.ts b/apps/backend/src/startup/shutdown.ts index a6a8c549..6f166512 100644 --- a/apps/backend/src/startup/shutdown.ts +++ b/apps/backend/src/startup/shutdown.ts @@ -3,6 +3,7 @@ import type { Server } from 'node:http' import { stopKuaishouIndustrySendCallbackRetryWorker } from '../services/platforms/kuaishou-industry/send-code-service.js' import { stopIntegrationOutboxWorker } from '../services/integration/outbox-worker.js' import { stopDouyuFulfillmentReconciler } from '../services/douyu-fulfillment/fulfillment-reconciler.js' +import { stopSemiAutoTaskReconciler } from '../services/semi-auto/semi-auto-task-reconciler.js' import { stopScheduledJobs } from '../services/scheduler/scheduler-service.js' import { closeDb } from '../db/client.js' import { logError, logInfo } from '../utils/logger.js' @@ -32,6 +33,7 @@ export function createShutdownController( stopKuaishouIndustrySendCallbackRetryWorker() stopIntegrationOutboxWorker() stopDouyuFulfillmentReconciler() + stopSemiAutoTaskReconciler() if (server.listening) { await new Promise((resolve) => { diff --git a/apps/backend/src/types/runtime-config.ts b/apps/backend/src/types/runtime-config.ts index e420ffc6..27accbee 100644 --- a/apps/backend/src/types/runtime-config.ts +++ b/apps/backend/src/types/runtime-config.ts @@ -67,6 +67,7 @@ export type RuntimeConfig = { connectorBaseUrl: string connectorApiKey: string connectorTimeoutMs: number + reconcileSeconds: number huya: { bindActId: number outerActId: string diff --git a/apps/frontend/src/layouts/AdminLayout.tsx b/apps/frontend/src/layouts/AdminLayout.tsx index 903a56b0..2ecda973 100644 --- a/apps/frontend/src/layouts/AdminLayout.tsx +++ b/apps/frontend/src/layouts/AdminLayout.tsx @@ -526,6 +526,10 @@ function applyAdminRealtimeEvent( if (event.type === 'order.changed' && event.scopes.includes('admin_douyu_fulfillment')) { void queryClient.invalidateQueries({ queryKey: ['admin-douyu-fulfillment'] }) } + if (event.type === 'order.changed' && event.scopes.includes('admin_semi_auto_tasks')) { + void queryClient.invalidateQueries({ queryKey: ['admin-semi-auto-tasks'] }) + void queryClient.invalidateQueries({ queryKey: ['admin-semi-auto-task'] }) + } if (event.type === 'admin_notification.changed' && isRecord(event.data)) { queryClient.setQueryData(['admin-notifications'], (current: unknown) => { diff --git a/apps/frontend/src/pages/admin/AdminSemiAutoTasksPage.tsx b/apps/frontend/src/pages/admin/AdminSemiAutoTasksPage.tsx index 72be1359..d858b063 100644 --- a/apps/frontend/src/pages/admin/AdminSemiAutoTasksPage.tsx +++ b/apps/frontend/src/pages/admin/AdminSemiAutoTasksPage.tsx @@ -128,13 +128,11 @@ export default function AdminSemiAutoTasksPage() { const listQuery = useQuery({ queryKey: ['admin-semi-auto-tasks', params], queryFn: () => fetchAdminSemiAutoTasks(params), - refetchInterval: 3000, }) const detailQuery = useQuery({ queryKey: ['admin-semi-auto-task', detailTaskId], queryFn: () => fetchAdminSemiAutoTask(Number(detailTaskId)), enabled: Boolean(detailTaskId), - refetchInterval: detailTaskId ? 3000 : false, }) const list = listQuery.data?.data?.items || [] const pagination = listQuery.data?.data?.pagination @@ -479,6 +477,7 @@ export default function AdminSemiAutoTasksPage() { render: (_, task) => ( {task.displayStatus.label} + {task.displayStatus.nextAction} {task.huyaUid ? `UID ${task.huyaUid}` : '未获取 UID'} {task.platform === 'huya' diff --git a/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx b/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx index 262a3eac..79b69091 100644 --- a/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx +++ b/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx @@ -194,11 +194,25 @@ export default function CustomerFulfillmentPage({ ) { return } + const dedicatedLoginPoll = + selectedTask.loginStatus === 'qr_pending' || selectedTask.loginStatus === 'scanned' + const dedicatedBindingPoll = + selectedTask.platform === 'huya' && + (selectedTask.bindingStatus === 'qr_pending' || selectedTask.bindingStatus === 'scanned') + if (dedicatedLoginPoll || dedicatedBindingPoll) return const timer = window.setInterval(() => { void load(true) - }, POLL_INTERVAL_MS) + }, 10_000) return () => window.clearInterval(timer) - }, [load, orderNo, selectedTask?.executionStatus, selectedTask?.id]) + }, [ + load, + orderNo, + selectedTask?.bindingStatus, + selectedTask?.executionStatus, + selectedTask?.id, + selectedTask?.loginStatus, + selectedTask?.platform, + ]) useEffect(() => { if (!selectedTask) return @@ -725,19 +739,6 @@ export default function CustomerFulfillmentPage({ } } - /** 资料变更后重新打开核对弹窗:只有三项完全一致才让客户直接提交平台绑定。 */ - function reopenBindingConfirm( - nextTask: CustomerSemiAutoTask, - nextBinding: CustomerBindingInfo | null | undefined, - ) { - if (nextTask.bindingStatus !== 'role_ready') return false - if (!nextBinding?.comparison || nextBinding.rebindUnchanged) return false - if (nextBinding.comparison.verdict !== 'match') return false - autoOpenedRoleRef.current = `${nextTask.id}:${nextBinding.bindGameRoleId || ''}` - setBindingConfirmOpen(true) - return true - } - /** * 返回第二步修改资料: * 立即切回资料表单(步骤条高亮第 2 步、隐藏绑定/换绑结果),同时调后端清空虎牙 @@ -802,15 +803,7 @@ export default function CustomerFulfillmentPage({ current.map((task) => (task.id === response.data.task.id ? response.data.task : task)), ) setProfileEditing(false) - let reopened = false - try { - const bindingResponse = await pollCustomerBinding(orderNo, selectedTask.id) - if (bindingResponse.data.binding) setBindingInfo(bindingResponse.data.binding) - reopened = reopenBindingConfirm(bindingResponse.data.task, bindingResponse.data.binding) - } catch { - // 绑定尚未开始时没有 binding,可忽略。 - } - message.success(reopened ? '资料已保存且与平台角色一致,请提交平台绑定' : '资料已保存') + message.success('资料已保存,正在重新核对平台角色') } catch (error) { message.error(error instanceof Error ? error.message : '保存角色资料失败') } finally { @@ -1460,6 +1453,15 @@ export default function CustomerFulfillmentPage({ 三项完全一致才能提交平台绑定;请重新扫码换绑,或上一步修改资料。 + {nextRebindText ? ( + 平台预计下次允许换绑:{nextRebindText} + ) : null} + {Number(bindingInfo?.rebindCooldownDays || 0) > 0 ? ( + + 当前仍处于虎牙换绑冷却期,剩余约{' '} + {Number(bindingInfo?.rebindCooldownDays || 0)} 天。 + + ) : null} } /> diff --git a/apps/frontend/src/types/admin/semi-auto.ts b/apps/frontend/src/types/admin/semi-auto.ts index 74a949ab..63d9a337 100644 --- a/apps/frontend/src/types/admin/semi-auto.ts +++ b/apps/frontend/src/types/admin/semi-auto.ts @@ -3,6 +3,8 @@ export type SemiAutoPlatform = 'huya' | 'weibo' export type SemiAutoDisplayStatus = { key: string label: string + owner: 'none' | 'customer' | 'operator' | 'system' + nextAction: string } export type SemiAutoTask = { diff --git a/apps/frontend/src/types/customer-fulfillment.ts b/apps/frontend/src/types/customer-fulfillment.ts index 161d1a70..e3a58a5e 100644 --- a/apps/frontend/src/types/customer-fulfillment.ts +++ b/apps/frontend/src/types/customer-fulfillment.ts @@ -21,7 +21,12 @@ export type CustomerSemiAutoTask = { loginStatus: string bindingStatus: string executionStatus: string - displayStatus: { key: string; label: string } + displayStatus: { + key: string + label: string + owner: 'none' | 'customer' | 'operator' | 'system' + nextAction: string + } huyaUid: string platformNickname: string bindGameAccount: string diff --git a/apps/frontend/tests/customer-fulfillment-binding-compare.test.ts b/apps/frontend/tests/customer-fulfillment-binding-compare.test.ts index 619eb758..58ffd969 100644 --- a/apps/frontend/tests/customer-fulfillment-binding-compare.test.ts +++ b/apps/frontend/tests/customer-fulfillment-binding-compare.test.ts @@ -29,12 +29,21 @@ test('资料不一致时固定提供重新扫码换绑与上一步修改资料', assert.ok(styles.includes('.customer-binding-role-actions')) }) -test('保存资料后只有三项一致才重新打开核对弹窗', () => { - assert.ok(source.includes('function reopenBindingConfirm(')) - assert.ok(source.includes("if (nextTask.bindingStatus !== 'role_ready') return false")) - assert.ok(source.includes("if (nextBinding.comparison.verdict !== 'match') return false")) - assert.ok(source.includes('reopened = reopenBindingConfirm(')) - assert.ok(source.includes('资料已保存且与平台角色一致,请提交平台绑定')) +test('保存资料后只由单一自动绑定流程推进,不再并发轮询', () => { + assert.ok(!source.includes('function reopenBindingConfirm(')) + const saveStart = source.indexOf('async function handleSaveProfile()') + assert.ok(saveStart > 0) + const saveBody = source.slice(saveStart, saveStart + 1800) + assert.ok(!saveBody.includes('pollCustomerBinding(')) + assert.ok(source.includes("message.success('资料已保存,正在重新核对平台角色')")) + assert.ok(source.includes("if (selectedTask.bindingStatus !== 'not_started'")) +}) + +test('登录和绑定专用同步阶段暂停整单轮询', () => { + assert.ok(source.includes('const dedicatedLoginPoll =')) + assert.ok(source.includes('const dedicatedBindingPoll =')) + assert.ok(source.includes('if (dedicatedLoginPoll || dedicatedBindingPoll) return')) + assert.ok(source.includes('}, 10_000)')) }) test('三项一致才出现提交平台绑定,不一致时展示原因', () => { diff --git a/apps/frontend/tests/semi-auto-sync-flow.test.ts b/apps/frontend/tests/semi-auto-sync-flow.test.ts new file mode 100644 index 00000000..f3e5b3fb --- /dev/null +++ b/apps/frontend/tests/semi-auto-sync-flow.test.ts @@ -0,0 +1,20 @@ +import assert from 'node:assert/strict' +import { readFileSync } from 'node:fs' +import { dirname, join } from 'node:path' +import { fileURLToPath } from 'node:url' +import test from 'node:test' + +const root = dirname(fileURLToPath(import.meta.url)) +const adminPage = readFileSync(join(root, '../src/pages/admin/AdminSemiAutoTasksPage.tsx'), 'utf8') +const adminLayout = readFileSync(join(root, '../src/layouts/AdminLayout.tsx'), 'utf8') + +test('半自动履约后台由 SSE 刷新,不再定时轮询列表和详情', () => { + assert.ok(!adminPage.includes('refetchInterval: 3000')) + assert.ok(adminLayout.includes("event.scopes.includes('admin_semi_auto_tasks')")) + assert.ok(adminLayout.includes("queryKey: ['admin-semi-auto-tasks']")) + assert.ok(adminLayout.includes("queryKey: ['admin-semi-auto-task']")) +}) + +test('后台状态列展示统一的后端下一步动作', () => { + assert.ok(adminPage.includes('task.displayStatus.nextAction')) +}) diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml index d57b4cfb..a725b7e6 100644 --- a/docker-compose.dev.yml +++ b/docker-compose.dev.yml @@ -132,6 +132,7 @@ services: SEMI_AUTO_CONNECTOR_BASE_URL: ${SEMI_AUTO_CONNECTOR_BASE_URL:-} SEMI_AUTO_CONNECTOR_API_KEY: ${SEMI_AUTO_CONNECTOR_API_KEY:-} SEMI_AUTO_CONNECTOR_TIMEOUT_MS: ${SEMI_AUTO_CONNECTOR_TIMEOUT_MS:-15000} + SEMI_AUTO_RECONCILE_SECONDS: ${SEMI_AUTO_RECONCILE_SECONDS:-900} logging: *json-log-rotation volumes: - ./apps/backend:/app diff --git a/docker-compose.yml b/docker-compose.yml index e3b04ae3..57c50ced 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -141,6 +141,7 @@ services: SEMI_AUTO_CONNECTOR_API_KEY: ${SEMI_AUTO_CONNECTOR_API_KEY:-} SEMI_AUTO_DEFAULT_CONNECTOR_MODE: ${SEMI_AUTO_DEFAULT_CONNECTOR_MODE:-embedded} SEMI_AUTO_CONNECTOR_TIMEOUT_MS: ${SEMI_AUTO_CONNECTOR_TIMEOUT_MS:-15000} + SEMI_AUTO_RECONCILE_SECONDS: ${SEMI_AUTO_RECONCILE_SECONDS:-900} LIVE_HUB_PLATFORM_FULFILLMENT_URL: ${LIVE_HUB_PLATFORM_FULFILLMENT_URL:-http://host.docker.internal:8800} PLATFORM_FULFILLMENT_INTEGRATION_KEY: ${PLATFORM_FULFILLMENT_INTEGRATION_KEY:-} logging: *json-log-rotation diff --git a/docs/统一订单履约与财务模型-权威版.md b/docs/统一订单履约与财务模型-权威版.md index 923411e9..aa1e2260 100644 --- a/docs/统一订单履约与财务模型-权威版.md +++ b/docs/统一订单履约与财务模型-权威版.md @@ -3,14 +3,14 @@ type: 权威架构与实施计划 description: 订单、内部 SKU、履约路由、履约执行、商品、成本与财务的唯一权威口径及重构计划。 tags: [订单, 内部SKU, 履约, 商品, 成本, 财务, 迁移] status: authoritative -version: 2.24 -updated_at: 2026-11-15 +version: 2.25 +updated_at: 2026-11-18 --- # 统一订单、履约与财务模型 > 状态:**唯一权威文档**。 -> 最后校准:2026-11-15。 +> 最后校准:2026-11-18。 > 生产基线:迁移 `166`。 > 开发基线:迁移 `167`(仅本地,尚未部署生产)。 > @@ -371,7 +371,18 @@ manual fulfillment - 客服完成半自动任务必须与 `confirmManualFulfillment` 在同一数据库事务中提交: 成本快照、钱包扣减、履约状态和 `semi_auto_tasks` 完成状态必须全部成功或全部回滚; 事务提交后才执行报表刷新、Connector 会话撤销等旁路动作。 -- 后台“任务 → 半自动履约”列表读取前必须执行幂等任务回填,不能依赖客户先打开 `/c/<订单号>`。 +- 半自动履约状态采用与斗鱼领取一致的同步原则:客户操作、Connector 回调和后台操作都是状态快照输入, + 统一由一个状态收敛服务在任务行锁内写入正式字段并追加事件;多个入口不得各自拼接或覆盖状态。 +- 外部 Connector 通过签名 Webhook `POST /api/integration/platform-fulfillment/semi-auto/task-state` + 提交登录与绑定快照,事件 ID 使用 `integration_inbox` 幂等;Connector 只提交平台观察到的事实, + 不得直接声明业务履约完成。执行状态由登录、绑定和人工确认规则推导。 +- 后台“任务 → 半自动履约”由 SSE 失效通知驱动读取,不得对列表或详情做固定秒级轮询。 + 后台列表首次读取可执行最近 30 天、最多 500 条、15 秒节流的有界兜底回填, + 不得在每次列表查询时扫描全库历史订单。 +- 客户页在登录或绑定等专用状态同步阶段只允许一个活动同步循环,不得同时轮询整单、登录和绑定。 + 非专用阶段使用低频整单同步;所有写操作完成后以服务端最新快照为准,不做客户端乐观状态拼接。 +- 半自动任务每 15 分钟执行一次限量兜底对账,只处理活跃且有 Connector 会话的任务; + 可通过 `SEMI_AUTO_RECONCILE_SECONDS` 调整,最低 60 秒。对账失败只更新最近错误,不覆盖人工完成或取消状态。 - 开发环境的半自动集成测试单必须通过正式 `upsertOrderFromSource` 入库,并继续经过 SKU 映射、 `sku_channel_routes`、渠道判定和 Carrier 补偿;不得直接写 `orders`、`order_items` 或 `fulfillments` 伪造成功。允许显式选择内置 Mock Connector,但不得用 Connector Mock 代替订单链路测试。