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
@@ -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