81 lines
4.3 KiB
TypeScript
81 lines
4.3 KiB
TypeScript
import { test } from 'node:test'
|
||
import assert from 'node:assert/strict'
|
||
import { existsSync, readFileSync } from 'node:fs'
|
||
import { join } from 'node:path'
|
||
|
||
/** v1.4 AC-1 用户端入口契约(蓝图 docs/ITERATION_PLAN.md §3.2 / §4 Phase 5)。
|
||
*
|
||
* 「京东采集」以工具台卡片 + 路由 + endpoints 组三件接入用户端(照工具台既有形状):
|
||
* 工具卡必须声明非空 permissionKeys(用户端工具按后端 app 菜单 column_key 过滤显隐),
|
||
* 路由 /jd-collect,endpoints.ts 有 jdCollect 组。Pending 期整组 skip;
|
||
* Phase 5 落地后去掉 skip 跑绿。
|
||
*/
|
||
|
||
const ROUTER = join(process.cwd(), 'src', 'router', 'index.ts')
|
||
const TOOL_CATALOG = join(process.cwd(), 'src', 'pages', 'amazon', 'tool-catalog.ts')
|
||
const ENDPOINTS = join(process.cwd(), 'src', 'shared', 'api', 'endpoints.ts')
|
||
|
||
function readIfExists(path: string, what: string): string {
|
||
assert.ok(existsSync(path), `${what} 尚未落地(蓝图 §4 Phase 5):${path}`)
|
||
return readFileSync(path, 'utf8')
|
||
}
|
||
|
||
test('路由注册京东采集页', () => {
|
||
assert.ok(readIfExists(ROUTER, 'router/index.ts').includes('/jd-collect'),
|
||
'router 缺 /jd-collect 路由')
|
||
})
|
||
|
||
test('工具台卡片声明京东工具且带权限键', () => {
|
||
const catalog = readIfExists(TOOL_CATALOG, 'tool-catalog.ts')
|
||
assert.ok(catalog.includes('jd-collect') || catalog.includes('京东采集'),
|
||
'TOOL_GROUPS 缺京东采集工具卡')
|
||
assert.ok(/jd[\s\S]{0,400}permissionKeys/.test(catalog),
|
||
'京东工具卡必须声明非空 permissionKeys(显隐按后端 app 菜单 key 过滤)')
|
||
})
|
||
|
||
test('endpoints 注册 jdCollect 端点组', () => {
|
||
assert.ok(readIfExists(ENDPOINTS, 'endpoints.ts').includes('jdCollect'),
|
||
'endpoints.ts 缺 jdCollect 端点组(建单/心跳/回传三件)')
|
||
})
|
||
|
||
/** 2026-11-14 真机实录:建单请求体写成 `user_id` 时后端回一句「user_id 不合法」直接拒,
|
||
* 管理员点「一键获取店铺数据」永远失败——Java 侧 DTO 是 camelCase `userId`(无 snake 命名
|
||
* 策略),snake 键会被静默丢掉。进度接口的 `?user_id=` 是 @RequestParam,那个名字不改。
|
||
* 射程只圈 createJdCollectTask 函数段:面板段的 `params: { user_id }` 是 @RequestParam
|
||
* 形状(deleteJdCollectTask 等与外观专利同形),不是请求体,不该被这条守卫误伤。 */
|
||
test('建单请求体用 camelCase userId,不是 user_id', () => {
|
||
const api = readIfExists(
|
||
join(process.cwd(), 'src', 'shared', 'api', 'types', 'modules', 'jd-collect.ts'),
|
||
'jd-collect.ts',
|
||
)
|
||
const start = api.indexOf('createJdCollectTask')
|
||
const end = api.indexOf('export interface JdCollectDashboardVo')
|
||
assert.ok(start > 0 && end > start, 'jd-collect.ts 缺 createJdCollectTask 或面板段形状变了')
|
||
const body = api.slice(start, end)
|
||
assert.ok(/userId:\s*getCurrentUserId\(\)/.test(body),
|
||
'createJdCollectTask 请求体必须传 camelCase `userId`(传 user_id 会被后端丢掉⇒「user_id 不合法」)')
|
||
assert.ok(!/[^_a-z]user_id:\s*getCurrentUserId\(\)/.test(body),
|
||
'建单请求体不得再传 snake_case `user_id`')
|
||
})
|
||
|
||
/** 2026-11-14 真机实录(task 34399):页面建完单直接推客户端,任务还是 PENDING ⇒ 客户端
|
||
* 第一个分片被「任务不在运行中(PENDING),回传被拒」、心跳回 alive=false 让客户端收手,
|
||
* 采集白跑一轮。修法是建单后先激活(PENDING→RUNNING)再推队列——顺序反了等于没修。 */
|
||
test('建单后先激活再推客户端队列', () => {
|
||
const page = readIfExists(
|
||
join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'),
|
||
'JdCollectTab.vue',
|
||
)
|
||
assert.ok(page.includes('activateJdCollectTask'),
|
||
'JdCollectTab.vue 必须调用 activateJdCollectTask(漏掉这一步客户端分片全被拒)')
|
||
const startAt = page.indexOf('async function startCollect')
|
||
assert.ok(startAt > 0, 'JdCollectTab.vue 缺 startCollect')
|
||
const body = page.slice(startAt)
|
||
const activateAt = body.indexOf('activateTask(vo.taskId)')
|
||
const pushAt = body.indexOf('pushToClientQueue(vo.taskId')
|
||
assert.ok(activateAt > 0, 'startCollect 必须先调用 activateTask(vo.taskId)')
|
||
assert.ok(pushAt > 0, 'startCollect 应继续推送本机队列')
|
||
assert.ok(activateAt < pushAt,
|
||
'激活必须排在推送之前(PENDING 状态下推给客户端=分片全被拒)')
|
||
})
|