Files
crawler-plugin/frontend-vue/tests/jd-collect-tab.test.ts
T

220 lines
13 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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 组三件接入用户端:
* 2026-11-15 用户拍板——卡片不再挂在亚马逊工具台(pages/amazon/tool-catalog.ts,
* 不含京东的绊线在 amazon-tool-catalog.test.ts),收敛到首页一级「京东」工作台
* 自己的目录(pages/jd/tool-catalog.ts,显隐收口在工具台内部)。
* 路由 /jd-collect,endpoints.ts 有 jdCollect 组。Pending 期整组 skip;
* Phase 5 落地后去掉 skip 跑绿。
*/
const ROUTER = join(process.cwd(), 'src', 'router', 'index.ts')
const JD_TOOL_CATALOG = join(process.cwd(), 'src', 'pages', 'jd', '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(JD_TOOL_CATALOG, 'jd/tool-catalog.ts')
assert.ok(catalog.includes('获取店铺数据'),
'京东工作台缺「获取店铺数据」卡')
assert.ok(catalog.includes('/jd-collect'),
'「获取店铺数据」卡必须带 href 指向 /jd-collect')
})
test('endpoints 注册 jdCollect 端点组', () => {
assert.ok(readIfExists(ENDPOINTS, 'endpoints.ts').includes('jdCollect'),
'endpoints.ts 缺 jdCollect 端点组(建单/心跳/回传三件)')
})
/** 2026-11-16 建单页采集范围换成京麦「店内分类」多选(客户口径「类目不需要只要分类」
* 「选京麦的内部分类去采集」+「做成多选的」)。三处同键契约(建单请求体 / 推送载荷 /
* 历史行带回)缺一处,客户端就按全店采集跑。 */
test('endpoints 注册采集类目 categories 端点(数据面保留)', () => {
const endpoints = readIfExists(ENDPOINTS, 'endpoints.ts')
assert.ok(endpoints.includes("categories: '/api/jd-collect/categories'"),
'endpoints.ts jdCollect 组仍须登记 categories(冻结快照口径;建单页 UI 已下线,仅数据面保留)')
})
/** 2026-11-16 口径修订:客户参照系是京麦后台的「店内分类」,平台分组 chips 从本页下线
* (分组数据面归后管京东数据库与商品上架,端点与 fetch 函数保留)。
* 2026-11-19 客户口径「每一家店铺的分类都会不一样」:选项集正本从冻结快照改为按店
* 实时拉取——「同步分类」按钮 → 桥 get_jd_shop_categories → 客户端用本机已登录京麦
* profile 现拉 getShopCategoryList(执行体 amazon/jd/shop_categories.py)。 */
test('分类多选改桥实时拉取,快照与平台分组从本页退役', () => {
const endpoints = readIfExists(ENDPOINTS, 'endpoints.ts')
assert.ok(endpoints.includes("groups: '/api/jd-collect/groups'"),
'endpoints.ts jdCollect 组仍须登记 groups(冻结快照口径;建单页 UI 已下线,仅数据面保留)')
const api = readIfExists(
join(process.cwd(), 'src', 'shared', 'api', 'types', 'modules', 'jd-collect.ts'),
'jd-collect.ts',
)
assert.ok(api.includes('export function fetchJdCollectGroups'),
'jd-collect.ts 保留 fetchJdCollectGroups(上架/数据面消费,非建单页)')
const page = readIfExists(
join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'),
'JdCollectTab.vue',
)
assert.ok(page.includes('get_jd_shop_categories'),
'JdCollectTab.vue 必须经桥 get_jd_shop_categories 拉店内分类(冻结快照已退役:每家店的分类不同)')
assert.ok(page.includes('同步分类'),
'JdCollectTab.vue 必须有「同步分类」按钮(2026-11-19 用户口径:店内分类旁边加个同步按钮)')
assert.ok(!page.includes('JD_SHOP_CATEGORY_SNAPSHOT') && !page.includes('jd-shop-category'),
'JdCollectTab.vue 不得再消费冻结快照(jd-shop-category.ts 已删除:快照只对取证那一家店正确)')
assert.ok(page.includes('采集分类(可选,多选)'),
'JdCollectTab.vue 必须以「采集分类(可选,多选)」展示分类块')
assert.ok(page.includes('<el-select') && page.includes('multiple'),
'采集分类必须是下拉式多选(el-select multiple,2026-11-17 客户口径「不要全展示出来,弄个下拉式的多选」)')
assert.ok(!page.includes('shop-cat-list'),
'JdCollectTab.vue 不得再回到逐条复选框列表(旧形状 2026-11-17 下线)')
assert.ok(!page.includes('JdCategoryCascader'),
'JdCollectTab.vue 不得再引用类目级联(2026-11-16 客户口径「类目不需要」)')
assert.ok(!page.includes('fetchJdCollectGroups'),
'JdCollectTab.vue 不得再消费平台分组接口(两套「分类」并存必混)')
})
/** 同步按钮的失败分档:busy 是设计内等待(amber notice),登录失效/页面结构变更才是
* 红色 error;把 busy 塞进红色 error 即红(与推送失败 notice 通道同口径)。 */
test('同步分类失败按 code 分档:busy 走 notice,其余走 error', () => {
const page = readIfExists(
join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'),
'JdCollectTab.vue',
)
const startAt = page.indexOf('async function syncShopCategories')
assert.ok(startAt > 0, 'JdCollectTab.vue 缺 syncShopCategories')
const body = page.slice(startAt, page.indexOf('function clearShopCategories'))
assert.ok(body.includes("code === 'jd_busy'") && body.includes('noticeMessage.value'),
'同步返回 jd_busy 必须走 amber notice(京东任务在跑是设计内等待,不是错误)')
assert.ok(body.includes('errorMessage.value = result?.error'),
'jd_login/jd_page/未知失败必须走红色 error(京麦未登录要用户去登录)')
assert.ok(page.includes('SYNC_UNAVAILABLE_NOTE') && page.includes('升级到最新版'),
'无桥/老客户端点同步必须给出升级指引(按钮置灰是第一道,提示文案是兜底)')
assert.ok(!page.includes('jd-shop-category'),
'同步失败路径不得再回落到冻结快照(快照已删除,回落即编译错)')
})
/** 快照正本退役:选项集不再有仓库内的静态正本文件(每家店不同,写死必错)。 */
test('店内分类快照文件已删除,无残留引用', () => {
assert.ok(!existsSync(join(process.cwd(), 'src', 'pages', 'jd', 'jd-shop-category.ts')),
'jd-shop-category.ts 必须删除(快照只对 2026-11-16 取证那一家店正确)')
const bridge = readIfExists(
join(process.cwd(), 'src', 'shared', 'bridges', 'pywebview.ts'),
'pywebview.ts',
)
assert.ok(bridge.includes('get_jd_shop_categories'),
'pywebview.ts 必须登记 get_jd_shop_categories 桥类型(老客户端无此方法 ⇒ 按钮置灰提示升级)')
})
test('建单请求体与推送载荷都带店内分类双键', () => {
const api = readIfExists(
join(process.cwd(), 'src', 'shared', 'api', 'types', 'modules', 'jd-collect.ts'),
'jd-collect.ts',
)
const apiStart = api.indexOf('export function createJdCollectTask')
const apiEnd = api.indexOf('export interface JdCollectDashboardVo')
assert.ok(apiStart > 0 && apiEnd > apiStart, 'jd-collect.ts 缺 createJdCollectTask')
const apiBody = api.slice(apiStart, apiEnd)
assert.ok(apiBody.includes('shopCategoryNames') && apiBody.includes('shopCategoryIds'),
'createJdCollectTask 请求体必须带店内分类双键(label+id 同发:行级填充形状未取证,任一键命中即命中)')
const page = readIfExists(
join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'),
'JdCollectTab.vue',
)
assert.ok(page.includes('maxProducts: 0, shopCategoryNames, shopCategoryIds }'),
'推送载荷 data 必须带店内分类双键(与后端 JdTaskPullSpiImplTest 键集断言同键)')
assert.ok(page.includes('createJdCollectTask(shop, tabs, 0, [], shopNames, shopIds)'),
'startCollect 建单必须把选中的分类(names+ids)传给 createJdCollectTask')
})
test('重试/继续从历史行同源带回店内分类双键', () => {
const page = readIfExists(
join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'),
'JdCollectTab.vue',
)
const startAt = page.indexOf('async function retryTaskRecord')
assert.ok(startAt > 0, 'JdCollectTab.vue 缺 retryTaskRecord')
const body = page.slice(startAt, page.indexOf('/** 手动刷新'))
assert.ok(body.includes('item?.shopCategoryNames ?? []') && body.includes('item?.shopCategoryIds ?? []'),
'重试/继续重建推送载荷必须从历史行带回店内分类双键(后端 history VO 同源字段),缺了客户端会按全店采集跑')
})
/** 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 状态下推给客户端=分片全被拒)')
})
/** 2026-11-19 用户实录:建单撞上客户端升级重启窗口,推送失败被渲染成红色「推送失败」
* 横幅(兜底拉取 2 分钟后照常认领,任务没坏)。推送失败是设计内慢路径不是错误——文案
* 改中性动作句、展示走 amber notice 通道,红色 error 只留给真失败(建单/激活失败)。
* 把提示改回塞进 errorMessage 即红。 */
test('推送失败的兜底提示走 notice 通道,不占红色 error', () => {
const page = readIfExists(
join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'),
'JdCollectTab.vue',
)
assert.ok(page.includes('PUSH_FALLBACK_NOTE'),
'推送失败提示必须收敛到单一常量 PUSH_FALLBACK_NOTE(两分支各写一份会漂)')
assert.ok(page.includes('noticeMessage.value = pushError') && page.includes('noticeMessage.value = PUSH_FALLBACK_NOTE'),
'推送失败提示必须写进 noticeMessage(amber notice 通道)')
const startAt = page.indexOf('async function startCollect')
assert.ok(startAt > 0, 'JdCollectTab.vue 缺 startCollect')
assert.ok(!page.slice(startAt).includes('errorMessage.value = pushNote'),
'startCollect 不得再把推送失败提示塞进红色 error 横幅(errorMessage 只留激活/建单真失败)')
assert.ok(page.includes('class="feedback notice"'),
'模板必须有 feedback notice 档(amber),红色 error 不得再兜住推送失败')
assert.ok(!page.includes('推送本机队列失败,任务将由'), '旧「推送失败」横幅文案必须下线')
assert.ok(page.includes('约 1 分钟内自动领取'), '兜底提示必须给出预期时长(约 1 分钟内自动领取)')
})