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