feat(semi-auto): 虎牙客户页登录→资料→绑定流程与返回上一步重置

This commit is contained in:
2026-11-17 20:40:12 +08:00
parent 5d0be12476
commit 23b8e4fdd3
21 changed files with 1455 additions and 558 deletions
@@ -10,6 +10,7 @@ import {
pollPublicBinding,
pollPublicLogin,
pollPublicWeiboQrLogin,
resetPublicBinding,
savePublicTaskProfile,
sendPublicHuyaSmsCode,
sendPublicWeiboSmsCode,
@@ -98,6 +99,16 @@ router.post(
),
)
router.post(
'/:orderNo/tasks/:taskId/binding/reset',
writeLimit,
createRouteHandler((req) => resetPublicBinding(req.params.orderNo, req.params.taskId), {
successMessage: '已返回修改资料',
errorMessage: '重置换绑状态失败',
scope: '[customer-fulfillment/:orderNo/tasks/:taskId/binding/reset]',
}),
)
router.post(
'/:orderNo/tasks/:taskId/binding/start',
writeLimit,
@@ -487,6 +487,23 @@ export async function confirmHuyaBinding(
)
}
/**
* 客户返回上一步修改资料:只重置绑定/换绑状态,不注销登录会话、不删除客户资料。
* 外部 Connector 通过独立 reset 端点实现;未提供时由调用方决定是否继续。
*/
export async function resetHuyaBinding(
sessionId: string,
mode: SemiAutoConnectorMode = defaultSemiAutoConnectorMode(),
): Promise<ConnectorBindingSession> {
if (mode === 'embedded') return huyaNativeConnector.resetBinding(sessionId)
if (mode === 'mock') return startHuyaBinding(sessionId, mode, {})
return callConnector<ConnectorBindingSession>(
`/api/internal/huya-semi-auto/sessions/${encodeURIComponent(sessionId)}/binding/reset`,
{ method: 'POST', body: {} },
mode,
)
}
/**
* 扫码后由项目侧主动向虎牙提交换绑确认。
* 外部 Connector 暂未提供独立端点时复用 confirm 端点(语义一致,幂等)。
@@ -1152,6 +1152,20 @@ export class HuyaNativeConnector {
)
}
/**
* 客户点「上一步修改资料」:清空本次绑定/换绑状态,保留登录会话。
* 重新提交资料后会重新查询平台角色,按新资料重新比对,不会继承旧的换绑失败状态。
*/
async resetBinding(sessionId: string): Promise<ConnectorBindingSession> {
return this.withLock(sessionId, async () => {
const session = this.requireAuthenticatedSession(sessionId)
session.binding = defaultBindingState()
session.binding.account = session.nickname
session.binding.message = '已返回上一步修改资料,提交后会重新识别平台角色'
return this.bindingView(session)
})
}
/**
* 客户点「确认绑定」:只做本地状态流转,不调用虎牙接口。
* 虎牙侧的绑定已由扫码(小程序/弹窗)完成,确认绑定只是核对三项后落库;
@@ -44,20 +44,26 @@ describe('待确认角色 UID 取数(huyaUid)', () => {
})
it('虎牙加密串角色 ID 改用 huyaUid 参与比对', () => {
const result = compareBindingRole(task('1199608910400', '大鲨鱼伊塞53', '1199608910400'), {
bindGameRole: '大鲨鱼伊塞53',
bindGameRoleId: '834ee3e75a1bfc9f65fb6b966bac7ef318e68ea',
})
const result = compareBindingRole(
task('1199608910400', '大鲨鱼伊塞53', '1199608910400', '安卓V区'),
{
bindGameRole: '大鲨鱼伊塞53',
bindGameRoleId: '834ee3e75a1bfc9f65fb6b966bac7ef318e68ea',
bindGameChannel: '安卓(android) · 微信',
},
)
assert.equal(result.verdict, 'match')
assert.equal(result.boundRoleId, '1199608910400')
})
it('没有 huyaUid 时保留原始加密串,仍判不一致', () => {
const result = compareBindingRole(task('1199608910400', '大鲨鱼伊塞53'), {
it('没有 huyaUid 时无法核对加密角色 ID,判 unknown', () => {
const result = compareBindingRole(task('1199608910400', '大鲨鱼伊塞53', '', '安卓V区'), {
bindGameRole: '大鲨鱼伊塞53',
bindGameRoleId: '834ee3e75a1bfc9f65fb6b966bac7ef318e68ea',
bindGameChannel: '安卓(android) · 微信',
})
assert.equal(result.verdict, 'mismatch')
assert.equal(result.verdict, 'unknown')
assert.match(result.message, /平台可核对角色ID/)
assert.equal(result.boundRoleId, '834ee3e75a1bfc9f65fb6b966bac7ef318e68ea')
})
})
@@ -157,7 +163,7 @@ describe('客户填写角色与平台识别角色比对', () => {
assert.equal(result.boundZone, '安卓V区')
})
it('渠道解析不出区服时跳过区服比对', () => {
it('渠道解析不出区服时判 unknown,不允许提交', () => {
const result = compareBindingRole(
task('1199608910400', '大鲨鱼伊塞53', '1199608910400', '苹果Q区'),
{
@@ -166,41 +172,51 @@ describe('客户填写角色与平台识别角色比对', () => {
bindGameChannel: '微信用户',
},
)
assert.equal(result.verdict, 'match')
assert.equal(result.verdict, 'unknown')
assert.match(result.message, /平台区服/)
assert.equal(result.boundZone, '')
})
it('两侧角色 ID 一致时允许确认', () => {
const result = compareBindingRole(task('1192083858', '巫师基尔斯84'), {
it('客户区服未填时判 unknown,不允许提交', () => {
const result = compareBindingRole(task('1199608910400', '大鲨鱼伊塞53', '1199608910400', ''), {
bindGameRole: '大鲨鱼伊塞53',
bindGameRoleId: '1199608910400',
bindGameChannel: '安卓(android) · 微信',
})
assert.equal(result.verdict, 'unknown')
assert.match(result.message, /客户区服/)
})
it('三项一致时允许提交平台绑定', () => {
const result = compareBindingRole(task('1192083858', '巫师基尔斯84', '1192083858', '安卓Q区'), {
bindGameRole: '巫师基尔斯84',
bindGameRoleId: '1192083858',
bindGameChannel: '安卓(android) · QQ',
})
assert.equal(result.verdict, 'match')
assert.equal(result.customerRoleId, '1192083858')
assert.equal(result.boundRoleId, '1192083858')
assert.match(result.message, /可提交平台绑定/)
})
it('两侧角色 ID 不一致时禁止确认', () => {
const result = compareBindingRole(task('1192083858', '巫师基尔斯84'), {
it('两侧角色 ID 不一致时禁止提交', () => {
const result = compareBindingRole(task('1192083858', '巫师基尔斯84', '', '安卓V区'), {
bindGameRole: '我是火星人2222',
bindGameRoleId: '166909256',
bindGameChannel: '安卓(android) · 微信',
})
assert.equal(result.verdict, 'mismatch')
assert.match(result.message, /不一致/)
})
it('缺少角色 ID 时退回角色名称比对', () => {
const matched = compareBindingRole(task('', '巫师基尔斯84'), {
it('任一侧缺少角色 ID 时判 unknown,不退化为只比角色名', () => {
const result = compareBindingRole(task('', '巫师基尔斯84'), {
bindGameRole: '巫师基尔斯84',
bindGameRoleId: '',
})
assert.equal(matched.verdict, 'match')
const mismatched = compareBindingRole(task('', '巫师基尔斯84'), {
bindGameRole: '我是火星人2222',
bindGameRoleId: '',
})
assert.equal(mismatched.verdict, 'mismatch')
assert.equal(result.verdict, 'unknown')
assert.match(result.message, /客户游戏编号/)
assert.match(result.message, /平台可核对角色ID/)
})
it('两侧都没有可核对信息时标记为 unknown', () => {
@@ -25,6 +25,7 @@ import {
getHuyaBindingSnapshot,
getHuyaLoginSession,
loginHuyaSms,
resetHuyaBinding,
revokeHuyaSession,
sendHuyaSmsCode,
startHuyaBinding,
@@ -178,6 +179,17 @@ function normalizeOrderNo(value: unknown): string {
return text
}
/** 客户资料以 TASK_SELECT 合并后的字段为准:优先任务表,回退工单资料。 */
export function hasCustomerProfile(
task: Pick<TaskRow, 'customer_game_id' | 'customer_game_role' | 'customer_server_zone'>,
): 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: '已取消' }
@@ -192,6 +204,9 @@ function displayStatus(task: TaskRow) {
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: '待确认绑定角色' }
}
@@ -413,16 +428,13 @@ function assertHuyaTask(task: TaskRow) {
}
/**
* 半自动订单没有工单,资料页 /c/<订单号>(虎牙)或 /d/<订单号>(微博)是唯一入口。
* 未提交区服 / 游戏编号 / 角色名时,不允许开始登录,避免后续无法比对角色。
* 半自动订单没有工单时,客户资料在登录后由 /c/<订单号> 收集;
* 任务表为空但工单素材已有资料时,TASK_SELECT 会合并回退字段。
* 进入绑定/确认/换绑前必须已有完整三项资料。
*/
function assertCustomerProfileReady(task: TaskRow) {
if (task.platform !== 'huya') return
if (
!String(task.customer_game_server_zone || '').trim() ||
!String(task.customer_game_role_id || '').trim() ||
!String(task.customer_game_role_name || '').trim()
) {
if (!hasCustomerProfile(task)) {
throw createHttpError('请先提交游戏角色资料', {
statusCode: 409,
errorCode: 'semi_auto_profile_required',
@@ -824,6 +836,13 @@ export async function savePublicTaskProfile(
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(
@@ -1003,7 +1022,7 @@ function normalizeServerZone(value: unknown): string {
/**
* 从虎牙渠道串解析区服,例如「安卓(android) · 微信」→ 安卓V区。
* 解析不出平台或登录方式时返回空串,调用方跳过区服比对。
* 解析不出平台或登录方式时返回空串,比对时按「平台区服缺失」处理(判 unknown)。
*/
export function detectServerZone(channel: unknown): string {
const text = String(channel ?? '')
@@ -1022,13 +1041,14 @@ export function detectServerZone(channel: unknown): string {
}
/**
* 客户填写角色与平台识别角色必须一致才允许确认绑定。
* 客户填写角色与平台识别角色必须完全一致才允许提交平台绑定。
*
* 区服、角色名、角色 ID 三项都要一致:
* ① 两侧都有 ID 时 ID 必须相等;
* ② 两侧都有角色名时名称必须相等(不能因为 ID 相同就放行改名);
* ③ 平台渠道能解析出区服且客户有填时,区服必须相等。
* 任一侧缺某字段时跳过该字段比对;三项都取不到才判 unknown,转客服核对。
* 区服、角色名、角色 ID 三项必须全部存在且一致:
* ① 客户游戏编号 = 虎牙账号 UID,与平台可核对角色 ID 相等;
* ② 角色名按规范化文本相等(忽略空白与大小写差异不能放行改名);
* ③ 平台渠道能解析出区服且与客户所填区服相等。
* 任一侧缺任一项(含平台只给加密 roleId 且拿不到 UID)判 unknown,转客服核对;
* 任一项不等判 mismatch,不允许提交平台绑定。
*/
export function compareBindingRole(
task: Pick<
@@ -1060,40 +1080,38 @@ export function compareBindingRole(
boundZone,
}
if (customerRoleId && boundRoleId && customerRoleId !== boundRoleId) {
return { ...base, verdict: 'mismatch', message: '两侧角色 ID 不一致,无法确认绑定' }
}
if (
customerRoleName &&
boundRoleName &&
normalizeRoleText(customerRoleName) !== normalizeRoleText(boundRoleName)
) {
return { ...base, verdict: 'mismatch', message: '两侧角色名称不一致,无法确认绑定' }
}
if (customerZone && boundZone && customerZone !== boundZone) {
return { ...base, verdict: 'mismatch', message: '两侧区服不一致,无法确认绑定' }
}
const matchedFields = [
customerRoleId && boundRoleId ? '角色 ID' : '',
customerRoleName && boundRoleName ? '角色名称' : '',
customerZone && boundZone ? '区服' : '',
].filter(Boolean)
if (matchedFields.length > 0) {
// 客户确认的口径:区服、角色名、角色 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: 'match',
message: `两侧${matchedFields.join('、')}一致,可确认绑定`,
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: 'unknown',
message: '未获取到可核对的两侧角色信息,请联系客服核对后再确认',
verdict: 'match',
message: '两侧区服、角色名称、角色 ID 一致,可提交平台绑定',
}
}
@@ -1206,7 +1224,6 @@ export async function startPublicLogin(orderNoInput: unknown, taskIdInput: unkno
const taskId = normalizeId(taskIdInput)
await ensureSemiAutoTasksForOrder(orderNo)
const task = await loadTaskForOrder(orderNo, taskId)
assertCustomerProfileReady(task)
if (task.execution_status === 'completed' || task.execution_status === 'cancelled') {
throw createHttpError('当前订单已结束,不能重新登录', {
statusCode: 409,
@@ -1340,6 +1357,7 @@ export async function startPublicBinding(
errorCode: 'semi_auto_login_required',
})
}
assertCustomerProfileReady(task)
const session =
task.platform === 'weibo'
? await getWeiboBinding(task.connector_session_id, task.connector_mode)
@@ -1351,6 +1369,81 @@ export async function startPublicBinding(
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)
@@ -1390,52 +1483,49 @@ export async function confirmPublicBinding(
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 &&
options.acceptExistingRole !== true
comparison.verdict !== 'match'
) {
// 换绑被虎牙拒绝时不直接放行,要求客户二选一:重新扫码换绑 / 仍使用原角色。
const reason = String(session.rebindConfirmMessage || '').trim()
throw createHttpError(
`${
reason ? `换绑未成功:${reason}。` : '换绑未生效:平台仍返回原绑定角色。'
}请重新扫码换绑,或确认继续使用原绑定角色「${session.bindGameRole || '原角色'}」`,
}请重新扫码换绑,或返回上一步修改资料,使资料与平台当前角色一致后再提交平台绑定`,
{
statusCode: 409,
errorCode: 'semi_auto_binding_rebind_decision_required',
},
)
}
// 已绑定角色但没有可核对的数字角色 ID:不能只按角色名放行,必须人工核实(客户页会提示联系客服)。
const boundRolePresent =
Boolean(String(session.bindGameRole || '').trim()) || session.hasExistingBinding === true
if (
task.platform === 'huya' &&
boundRolePresent &&
!isNumericBindingRoleId(session.bindGameRoleId)
) {
throw createHttpError('平台未返回可核对的角色ID,请联系客服人工核实后再确认绑定', {
statusCode: 409,
errorCode: 'semi_auto_binding_role_id_missing',
})
}
const comparison = compareBindingRole(task, session)
if (comparison.verdict === 'mismatch') {
// 三项必须全部存在且一致;信息不完整同样不能自动放行,必须转客服核实。
if (comparison.verdict !== 'match') {
throw createHttpError(comparison.message, {
statusCode: 409,
errorCode: 'semi_auto_binding_role_mismatch',
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)
? 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)
@@ -1468,6 +1558,7 @@ export async function submitPublicRebind(orderNoInput: unknown, taskIdInput: unk
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)
@@ -1483,7 +1574,6 @@ export async function sendPublicHuyaSmsCode(
const taskId = normalizeId(taskIdInput)
const task = await loadTaskForOrder(orderNo, taskId)
assertHuyaTask(task)
assertCustomerProfileReady(task)
if (task.execution_status === 'completed' || task.execution_status === 'cancelled') {
throw createHttpError('当前订单已结束,不能重新登录', {
statusCode: 409,
@@ -1633,7 +1723,6 @@ export async function loginPublicHuyaSms(
const taskId = normalizeId(taskIdInput)
const task = await loadTaskForOrder(orderNo, taskId)
assertHuyaTask(task)
assertCustomerProfileReady(task)
if (task.execution_status === 'completed' || task.execution_status === 'cancelled') {
throw createHttpError('当前订单已结束,不能重新登录', {
statusCode: 409,
@@ -1937,6 +2026,12 @@ export async function getAdminSemiAutoTask(taskIdInput: unknown) {
)
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,
@@ -9,6 +9,14 @@ import test from 'node:test'
const TEST_DATABASE_URL = String(process.env.SEMI_AUTO_TASK_TEST_DATABASE_URL || '').trim()
/** 断言领域服务抛出指定错误码,避免只匹配中文提示。 */
async function expectErrorCode(fn: () => Promise<unknown>, errorCode: string) {
await assert.rejects(fn, (error: { errorCode?: string }) => {
assert.equal(error.errorCode, errorCode)
return true
})
}
test(
'人工渠道半自动任务可由客户入口和后台列表幂等回填',
{ skip: !TEST_DATABASE_URL ? '未设置 SEMI_AUTO_TASK_TEST_DATABASE_URL' : false },
@@ -16,11 +24,15 @@ test(
process.env.DATABASE_URL = TEST_DATABASE_URL
const { closeDb, query, withTransaction } = await import('../../db/client.js')
const {
confirmPublicBinding,
ensureSemiAutoTasksForOrder,
exportAdminSemiAutoCredential,
listAdminSemiAutoTasks,
listPublicSemiAutoTasks,
requestAdminSemiAutoCustomerReauth,
resetPublicBinding,
savePublicTaskProfile,
startPublicBinding,
} = await import('./semi-auto-task-service.js')
const suffix = `${Date.now()}_${Math.floor(Math.random() * 1_000_000)}`
const orderNo = `IT-SEMI-AUTO-${suffix}`
@@ -110,6 +122,17 @@ test(
assert.equal(tasks[0]?.semiAutoConfig.pageTitle, '虎牙授权测试')
const taskId = Number(tasks[0]?.id || 0)
// 客户页流程固定为「登录 → 填写资料 → 绑定角色」:未登录不能提前写资料或开始绑定。
await expectErrorCode(
() =>
savePublicTaskProfile(orderNo, taskId, {
roleName: '集成测试角色',
roleId: '1192083858',
serverZone: '安卓V区',
}),
'semi_auto_login_required',
)
await expectErrorCode(() => startPublicBinding(orderNo, taskId), 'semi_auto_login_required')
const credential = await query<{ id: number }>(
`
INSERT INTO semi_auto_credentials (
@@ -141,11 +164,110 @@ test(
)
const authenticatedList = await listAdminSemiAutoTasks({ keyword: orderNo })
assert.equal(authenticatedList.items[0]?.loginStatus, 'authenticated')
assert.equal(authenticatedList.items[0]?.displayStatus.label, '等待客服处理')
assert.equal(authenticatedList.items[0]?.displayStatus.label, '待客户填写资料')
// 资料未填时不能开始绑定;也不能把待确认角色直接提交为平台绑定。
await expectErrorCode(() => startPublicBinding(orderNo, taskId), 'semi_auto_profile_required')
await query("UPDATE semi_auto_tasks SET binding_status = 'role_ready' WHERE id = $1", [
taskId,
])
await expectErrorCode(
() => confirmPublicBinding(orderNo, taskId),
'semi_auto_profile_required',
)
await query("UPDATE semi_auto_tasks SET binding_status = 'not_started' WHERE id = $1", [
taskId,
])
const savedProfile = await savePublicTaskProfile(orderNo, taskId, {
roleName: '集成测试角色',
roleId: '1192083858',
serverZone: '安卓V区',
})
assert.equal(savedProfile.task.customerGameRoleName, '集成测试角色')
assert.equal(savedProfile.task.customerGameRoleId, '1192083858')
assert.equal(savedProfile.task.customerServerZone, '安卓V区')
const profileReadyList = await listAdminSemiAutoTasks({ keyword: orderNo })
assert.equal(profileReadyList.items[0]?.displayStatus.label, '等待客户绑定角色')
const exported = await exportAdminSemiAutoCredential(taskId)
assert.equal(exported.credentialId, credentialId)
assert.equal(exported.platform, 'huya')
// 换绑失败后客户点「上一步修改资料」:清空绑定/换绑状态,保留登录与已填资料。
await query(
`
UPDATE semi_auto_tasks
SET binding_status = 'role_ready',
bind_game_role = '平台原角色',
bind_game_role_id = '99887766',
bind_game_channel = '微信',
binding_started_at = NOW(),
bound_at = NOW(),
last_error = '虎牙未接受本次换绑',
updated_at = NOW()
WHERE id = $1
`,
[taskId],
)
const reset = await resetPublicBinding(orderNo, taskId)
assert.equal(reset.task.bindingStatus, 'not_started')
assert.equal(reset.binding, null)
assert.equal(reset.task.customerGameRoleName, '集成测试角色')
assert.equal(reset.task.customerGameRoleId, '1192083858')
assert.equal(reset.task.customerServerZone, '安卓V区')
const resetRow = await query<{
binding_status: string
bind_game_role: string
bind_game_role_id: string
bind_game_channel: string
binding_started_at: string | null
bound_at: string | null
login_status: string
credential_id: number | null
connector_session_id: string
customer_game_role_name: string
customer_game_role_id: string
customer_game_server_zone: string
last_error: string
execution_status: string
}>(
`
SELECT binding_status, bind_game_role, bind_game_role_id, bind_game_channel,
binding_started_at, bound_at, login_status, credential_id,
connector_session_id, customer_game_role_name, customer_game_role_id,
customer_game_server_zone, last_error, execution_status
FROM semi_auto_tasks
WHERE id = $1
`,
[taskId],
)
const resetState = resetRow.rows[0]
assert.equal(resetState?.binding_status, 'not_started')
assert.equal(resetState?.bind_game_role, '')
assert.equal(resetState?.bind_game_role_id, '')
assert.equal(resetState?.bind_game_channel, '')
assert.equal(resetState?.binding_started_at, null)
assert.equal(resetState?.bound_at, null)
assert.equal(resetState?.last_error, '')
assert.equal(resetState?.execution_status, 'waiting_customer')
assert.equal(resetState?.login_status, 'authenticated')
assert.equal(Number(resetState?.credential_id), credentialId)
assert.equal(resetState?.connector_session_id, `it-huya-session-${suffix}`)
assert.equal(resetState?.customer_game_role_name, '集成测试角色')
assert.equal(resetState?.customer_game_role_id, '1192083858')
assert.equal(resetState?.customer_game_server_zone, '安卓V区')
const resetEvents = await query<{ detail_json: { reason?: string } | null }>(
`
SELECT detail_json
FROM semi_auto_task_events
WHERE task_id = $1 AND event_type = 'binding_reset'
ORDER BY id DESC
LIMIT 1
`,
[taskId],
)
assert.equal(resetEvents.rows[0]?.detail_json?.reason, 'customer_profile_edit')
const reauthorized = await requestAdminSemiAutoCustomerReauth(taskId, {
userId: 1,
role: 'support',
@@ -599,7 +721,7 @@ test(
)
test(
'客户手动触发虎牙短信登录后保存 CK 并进入等待客服',
'客户手动触发虎牙短信登录后保存 CK 并进入填写资料步骤',
{ skip: !TEST_DATABASE_URL ? '未设置 SEMI_AUTO_TASK_TEST_DATABASE_URL' : false },
async () => {
process.env.DATABASE_URL = TEST_DATABASE_URL
@@ -607,8 +729,12 @@ test(
const { closeDb, query } = await import('../../db/client.js')
const { createSemiAutoMock } = await import('../dev-mock/dev-mock-service.js')
const { resetMockSessions } = await import('../dev-mock/mock-semi-auto-connector.js')
const { listPublicSemiAutoTasks, loginPublicHuyaSms, sendPublicHuyaSmsCode } =
await import('./semi-auto-task-service.js')
const {
listPublicSemiAutoTasks,
loginPublicHuyaSms,
savePublicTaskProfile,
sendPublicHuyaSmsCode,
} = await import('./semi-auto-task-service.js')
const suffix = `${Date.now()}_${Math.floor(Math.random() * 1_000_000)}`
const orderNo = `IT-HUYA-SMS-${suffix}`
let orderId = 0
@@ -645,11 +771,21 @@ test(
})
const tasks = await listPublicSemiAutoTasks(orderNo)
assert.equal(tasks[0]?.loginStatus, 'authenticated')
assert.equal(tasks[0]?.executionStatus, 'waiting_operator')
// 虎牙登录成功后仍需客户填写资料,不能直接进入等待客服。
assert.equal(tasks[0]?.executionStatus, 'waiting_customer')
assert.equal(tasks[0]?.displayStatus.label, '待客户填写资料')
assert.equal(tasks[0]?.credentialSource, 'sms')
assert.ok(tasks[0]?.huyaUid)
assert.equal(tasks[0]?.platformNickname, 'Mock虎牙用户')
const saved = await savePublicTaskProfile(orderNo, result.taskId, {
roleName: 'Mock虎牙角色',
roleId: '1192083858',
serverZone: '安卓V区',
})
assert.equal(saved.task.executionStatus, 'waiting_customer')
assert.equal(saved.task.displayStatus.label, '等待客户绑定角色')
const stored = await query<{
id: number
credential_source: string
@@ -0,0 +1,80 @@
/**
* 寄卖相关集成测试的收尾清理。
*
* 集成测试会造打手、分类、寄卖配置、提报、库存、工单、钱包流水。以前跑完不带清理,
* 数据会永久留在目标库里(2026-11-10 就是这样在共享联调库留下了 CTIMEOUT 假单)。
*
* 清理口径:所有识别字段都必须包含本次运行的 `suffix`。suffix 由测试自己生成
* (`Date.now().toString(36)` + 随机数),真实业务数据不会命中;配合
* `integration-db-guard` 的隔离库限制,误删风险极低。
*/
import { query } from '../db/client.js'
/**
* 删除本次集成测试造出的全部数据。
*
* 必须在测试的 `finally` 里调用,删除顺序遵循外键依赖(子表 -> 主表)。
*/
export async function cleanupIntegrationRun(suffix: string) {
const token = String(suffix || '').trim()
if (!token) throw new Error('cleanupIntegrationRun 需要 suffix')
const like = `%${token}%`
const params = [like]
const workOrderScope = `SELECT id FROM work_orders WHERE work_order_no LIKE $1`
const inventoryScope = `SELECT id FROM consignment_inventories WHERE inventory_no LIKE $1`
const submissionScope = `SELECT id FROM consignment_submissions WHERE submission_no LIKE $1`
const workerScope = `SELECT id FROM worker_users WHERE username LIKE $1`
const categoryScope = `SELECT id FROM work_categories WHERE category_key LIKE $1`
const profileScope = `SELECT id FROM consignment_profiles
WHERE category_id IN (${categoryScope}) OR name LIKE $1`
// 子记录:工单 / 库存维度
await query(`DELETE FROM work_order_events WHERE work_order_id IN (${workOrderScope})`, params)
await query(`DELETE FROM work_order_shares WHERE work_order_id IN (${workOrderScope})`, params)
await query(
`DELETE FROM consignment_inventory_allocations
WHERE work_order_id IN (${workOrderScope}) OR inventory_id IN (${inventoryScope})`,
params,
)
await query(
`DELETE FROM consignment_sms_logs
WHERE work_order_id IN (${workOrderScope}) OR inventory_id IN (${inventoryScope})`,
params,
)
await query(
`DELETE FROM consignment_match_logs
WHERE work_order_no LIKE $1 OR payload_json::text LIKE $1`,
params,
)
// 钱包流水与打手会话
await query(`DELETE FROM worker_wallet_ledgers WHERE worker_id IN (${workerScope})`, params)
await query(`DELETE FROM worker_sessions WHERE worker_id IN (${workerScope})`, params)
// 主实体:先断开 库存 <-> 提报 的双向引用
await query(
`UPDATE consignment_inventories SET source_submission_id = NULL WHERE inventory_no LIKE $1`,
params,
)
await query(
`UPDATE consignment_submissions SET result_inventory_id = NULL WHERE submission_no LIKE $1`,
params,
)
await query(`DELETE FROM work_orders WHERE work_order_no LIKE $1`, params)
await query(`DELETE FROM consignment_inventories WHERE inventory_no LIKE $1`, params)
await query(`DELETE FROM consignment_submissions WHERE submission_no LIKE $1`, params)
// 配置、钱包、打手、分类
await query(
`DELETE FROM consignment_profile_versions WHERE profile_id IN (${profileScope})`,
params,
)
await query(`DELETE FROM consignment_profiles WHERE id IN (${profileScope})`, params)
await query(`DELETE FROM worker_wallets WHERE worker_id IN (${workerScope})`, params)
await query(`DELETE FROM worker_users WHERE username LIKE $1`, params)
await query(`DELETE FROM work_product_rules WHERE rule_key LIKE $1`, params)
await query(`DELETE FROM consignment_contact_supporters WHERE name LIKE $1`, params)
await query(`DELETE FROM admin_users WHERE username LIKE $1`, params)
await query(`DELETE FROM work_categories WHERE category_key LIKE $1`, params)
}
@@ -0,0 +1,84 @@
import assert from 'node:assert/strict'
import test from 'node:test'
import {
isIsolatedIntegrationDatabaseName,
resolveIntegrationDatabaseOrThrow,
resolveIsolatedIntegrationDatabaseUrl,
} from './integration-db-guard.js'
test('隔离库命名:_ctest / _itest / _test 段才放行', () => {
assert.equal(isIsolatedIntegrationDatabaseName('order_site_ctest'), true)
assert.equal(isIsolatedIntegrationDatabaseName('order_site_ctest_fresh'), true)
assert.equal(isIsolatedIntegrationDatabaseName('order_site_itest'), true)
assert.equal(isIsolatedIntegrationDatabaseName('order_site_test'), true)
assert.equal(isIsolatedIntegrationDatabaseName('ctest'), true)
})
test('共享库与系统库一律拒绝(防止再污染联调/生产)', () => {
assert.equal(isIsolatedIntegrationDatabaseName('order_site'), false)
assert.equal(isIsolatedIntegrationDatabaseName('postgres'), false)
assert.equal(isIsolatedIntegrationDatabaseName('template1'), false)
assert.equal(isIsolatedIntegrationDatabaseName(''), false)
})
test('库存名只是包含 test 字样但没有独立段时不放行', () => {
assert.equal(isIsolatedIntegrationDatabaseName('order_site_contest'), false)
assert.equal(isIsolatedIntegrationDatabaseName('latest_orders'), false)
})
test('未设置环境变量时返回 null,调用方据此跳过测试', () => {
delete process.env.ORDER_SITE_GUARD_TEST_URL
assert.equal(resolveIntegrationDatabaseOrThrow('ORDER_SITE_GUARD_TEST_URL'), null)
})
test('两个连接串不一致时直接抛错', () => {
process.env.ORDER_SITE_GUARD_TEST_URL = 'postgres://u:p@127.0.0.1:5432/order_site_ctest'
process.env.DATABASE_URL = 'postgres://u:p@127.0.0.1:5432/order_site'
assert.throws(
() => resolveIntegrationDatabaseOrThrow('ORDER_SITE_GUARD_TEST_URL'),
/必须与 DATABASE_URL 完全一致/,
)
delete process.env.ORDER_SITE_GUARD_TEST_URL
delete process.env.DATABASE_URL
})
test('指向共享库时即使两个变量一致也要拒绝', () => {
process.env.ORDER_SITE_GUARD_TEST_URL = 'postgres://u:p@192.168.10.9:5432/order_site'
process.env.DATABASE_URL = 'postgres://u:p@192.168.10.9:5432/order_site'
assert.throws(
() => resolveIntegrationDatabaseOrThrow('ORDER_SITE_GUARD_TEST_URL'),
/拒绝在非隔离库/,
)
delete process.env.ORDER_SITE_GUARD_TEST_URL
delete process.env.DATABASE_URL
})
test('指向隔离库且两值一致时返回库名', () => {
process.env.ORDER_SITE_GUARD_TEST_URL = 'postgres://u:p@127.0.0.1:5432/order_site_ctest'
process.env.DATABASE_URL = 'postgres://u:p@127.0.0.1:5432/order_site_ctest'
assert.deepEqual(resolveIntegrationDatabaseOrThrow('ORDER_SITE_GUARD_TEST_URL'), {
databaseUrl: 'postgres://u:p@127.0.0.1:5432/order_site_ctest',
databaseName: 'order_site_ctest',
})
delete process.env.ORDER_SITE_GUARD_TEST_URL
delete process.env.DATABASE_URL
})
test('只校验库名的版本:未设置返回空串,共享库抛错,隔离库原样返回', () => {
delete process.env.ORDER_SITE_GUARD_TEST_URL
assert.equal(resolveIsolatedIntegrationDatabaseUrl('ORDER_SITE_GUARD_TEST_URL'), '')
process.env.ORDER_SITE_GUARD_TEST_URL = 'postgres://u:p@192.168.10.9:5432/order_site'
assert.throws(
() => resolveIsolatedIntegrationDatabaseUrl('ORDER_SITE_GUARD_TEST_URL'),
/拒绝在非隔离库/,
)
process.env.ORDER_SITE_GUARD_TEST_URL = 'postgres://u:p@127.0.0.1:5432/order_site_ctest'
assert.equal(
resolveIsolatedIntegrationDatabaseUrl('ORDER_SITE_GUARD_TEST_URL'),
'postgres://u:p@127.0.0.1:5432/order_site_ctest',
)
delete process.env.ORDER_SITE_GUARD_TEST_URL
})
@@ -0,0 +1,100 @@
/**
* 集成测试数据库守卫。
*
* 背景:2026-11-10 寄卖超时集成测试误跑在共享联调库 `order_site` 上,留下 7 条
* `CTIMEOUT-WO-*` 假工单和 8 个假打手,后台把它们当成真实订单展示。
*
* 原来的守卫只校验 `DATABASE_URL === CONSIGNMENT_MATCHING_TEST_DATABASE_URL`,
* 两边都被指到联调库时形同虚设。这里加两道硬约束:
* 1. 目标库名必须带隔离测试标记(`_ctest` / `_itest` / `_test`);
* 2. 显式拒绝 `order_site`、`postgres` 这类共享库。
*/
/** 明确禁止运行集成测试的库名(生产/联调/系统库)。 */
const FORBIDDEN_DATABASE_NAMES = new Set([
'order_site',
'order_site_ctest_prod',
'postgres',
'template0',
'template1',
])
/** 允许的隔离库命名:包含 _ctest / _itest / _test 段(可带 _fresh 等后缀)。 */
const ISOLATED_DATABASE_PATTERN = /(^|_)(ctest|itest|test)($|_)/i
export type IntegrationDatabaseCheck = {
databaseUrl: string
databaseName: string
}
function readDatabaseName(databaseUrl: string): string {
try {
return decodeURIComponent(new URL(databaseUrl).pathname.replace(/^\/+/, '')).trim()
} catch {
return ''
}
}
/** 判断库名是否为隔离测试库;导出便于单测覆盖命名规则。 */
export function isIsolatedIntegrationDatabaseName(name: string): boolean {
const normalized = String(name || '').trim()
if (!normalized) return false
if (FORBIDDEN_DATABASE_NAMES.has(normalized.toLowerCase())) return false
return ISOLATED_DATABASE_PATTERN.test(normalized)
}
/**
* 校验并返回集成测试库地址。
*
* - 未设置 `envName` 对应变量时返回 null(调用方据此 skip);
* - 设置后要求与 `DATABASE_URL` 完全一致,且库名必须是隔离测试库,否则直接抛错中断测试。
*/
export function resolveIntegrationDatabaseOrThrow(
envName: string,
): IntegrationDatabaseCheck | null {
const databaseUrl = String(process.env[envName] || '').trim()
if (!databaseUrl) return null
const runtimeUrl = String(process.env.DATABASE_URL || '').trim()
if (runtimeUrl !== databaseUrl) {
throw new Error(
`${envName} 必须与 DATABASE_URL 完全一致,避免测试绕过连接配置连到别的库:\n` +
` ${envName}=${databaseUrl}\n DATABASE_URL=${runtimeUrl || '(未设置)'}`,
)
}
const databaseName = readDatabaseName(databaseUrl)
if (!isIsolatedIntegrationDatabaseName(databaseName)) {
throw new Error(
`拒绝在非隔离库 "${databaseName || databaseUrl}" 上运行集成测试。\n` +
'请使用专门的测试库(库名需包含 _ctest / _itest / _test,例如 order_site_ctest),' +
'否则测试会往共享环境写假工单、假打手。',
)
}
return { databaseUrl, databaseName }
}
/**
* 只校验库名、不要求和 `DATABASE_URL` 一致的版本。
*
* 给「测试自己把 `process.env.DATABASE_URL` 改写成测试库」的那批集成测试用:
* 它们在模块顶层读不到最终连接串,但仍必须保证目标库是隔离库。
*
* 未设置环境变量时返回空串(调用方据此 skip);库名不合法时直接抛错。
*/
export function resolveIsolatedIntegrationDatabaseUrl(envName: string): string {
const databaseUrl = String(process.env[envName] || '').trim()
if (!databaseUrl) return ''
const databaseName = readDatabaseName(databaseUrl)
if (!isIsolatedIntegrationDatabaseName(databaseName)) {
throw new Error(
`拒绝在非隔离库 "${databaseName || databaseUrl}" 上运行集成测试(${envName})。\n` +
'请使用专门的测试库(库名需包含 _ctest / _itest / _test,例如 order_site_ctest),' +
'否则测试中途失败时会把假工单、假打手留在共享环境。',
)
}
return databaseUrl
}