Files
crawler-plugin/frontend-vue/tests/jd-collect-tab.test.ts
T
huangzd1997 f96d5118da feat(jd-collect): 建单页采集状态多选(售卖中/已下架)
原实现写死 tabs=['ONSALE'],已下架商品(京麦「已下架」页签,productState=10)根本进不了任务体。改为按状态勾选:
2026-11-20 22:38:57 +08:00

286 lines
18 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 即红。 */
/** 2026-11-20 装机实录:京麦登录态失效后,登录窗口只在任务失败那十几秒"顺带"出现、
* 还会被任务 finally 关掉 ⇒ 独立登录入口「登录京麦」(桥 open_jd_login → 客户端
* amazon/jd/login_window.py)。把按钮下线、分档改回全红 error、或 jd_login 不再引导
* 去「登录京麦」(用户就会去登自己的浏览器——登录态不共享,白登),即红。 */
test('登录京麦独立入口:按钮 + 桥类型 + 分档引导', () => {
const page = readIfExists(
join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'),
'JdCollectTab.vue',
)
assert.ok(page.includes('open_jd_login'), 'JdCollectTab.vue 必须经桥 open_jd_login')
assert.ok(page.includes('登录京麦'), '必须有「登录京麦」按钮(登录态失效后唯一稳定登录入口)')
assert.ok(page.includes('canLoginJd'), '老客户端(桥无该方法)置灰提示升级(与「同步分类」同口径)')
const bridge = readIfExists(
join(process.cwd(), 'src', 'shared', 'bridges', 'pywebview.ts'),
'pywebview.ts',
)
assert.ok(bridge.includes('open_jd_login'), 'pywebview.ts 必须登记 open_jd_login 桥类型')
const startAt = page.indexOf('async function openJdLogin')
assert.ok(startAt > 0, 'JdCollectTab.vue 缺 openJdLogin')
const endAt = page.indexOf('selectedShopCategories = computed', startAt)
assert.ok(endAt > startAt, 'openJdLogin 之后的锚点形状变了,请同步本判据')
const body = page.slice(startAt, endAt)
assert.ok(body.includes("code === 'jd_busy'") && body.includes("code === 'jd_login_running'")
&& body.includes("code === 'timeout'") && body.includes("code === 'window_closed'")
&& body.includes('noticeMessage.value'),
'busy/重入/超时/关窗都是设计内等待或可恢复,必须走 amber notice(超时档窗口还开着,不是失败)')
assert.ok(body.includes('successMessage.value'), '登录成功必须走绿色 success 展示')
assert.ok(body.includes('errorMessage.value = result?.error'), '仅 jd_page/未知失败走红色 error')
assert.ok(body.includes('LOGIN_UNAVAILABLE_NOTE'), '无桥必须给升级指引(与 SYNC_UNAVAILABLE_NOTE 同口径)')
const syncStart = page.indexOf('async function syncShopCategories')
const syncBody = page.slice(syncStart, page.indexOf('function clearShopCategories'))
assert.ok(syncBody.includes("code === 'jd_login'") && syncBody.includes('登录京麦'),
'「同步分类」遇 jd_login 必须引导点「登录京麦」(否则用户去登自己的浏览器=白登)')
})
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 分钟内自动领取)')
})
/** 2026-11-20 客户口径「加个状态勾选,采集售卖中或已下架的,多选」:建单页原本写死
* DEFAULT_TABS 两项全采(店里只剩已下架商品时那一档白扫)。改为页面勾选多选,默认
* 两项都勾=旧行为;选中值必须成为建单 listTabs 与推送载荷的同一真源,空选不建单
* (服务端 JdCollectTaskService 同样要求至少一个 Tab,前端空选会被后端点名拒)。 */
test('采集状态多选:售卖中/已下架可勾选,空选禁止建单', () => {
const page = readIfExists(
join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'),
'JdCollectTab.vue',
)
assert.ok(page.includes('采集状态(多选)'), '建单页必须有「采集状态(多选)」块')
assert.ok(page.includes("label: '售卖中'") && page.includes("label: '已下架'"),
'两个状态必须叫售卖中/已下架(与京麦列表页签同词表)')
assert.ok(page.includes('const selectedTabs = ref<JdListTab[]>([...DEFAULT_TABS])'),
'默认两项都勾(与旧行为一致,不得悄悄变成只采一档)')
assert.ok(page.includes(':disabled="isRunning || noTabSelected"'),
'空选必须禁用「获取」按钮(第一道)')
const startAt = page.indexOf('async function startCollect')
assert.ok(startAt > 0, 'JdCollectTab.vue 缺 startCollect')
const body = page.slice(startAt, page.indexOf('onMounted(async'))
assert.ok(body.includes('selectedTabs.value.includes(tab)'),
'startCollect 的 tabs 必须来自勾选状态(不得再写死 DEFAULT_TABS)')
assert.ok(!body.includes('const tabs = DEFAULT_TABS'),
'startCollect 不得再写死 DEFAULT_TABS(状态多选就失效了)')
assert.ok(body.includes('请至少勾选一个采集状态'),
'空选必须给「至少勾选一个」提示(按钮禁用之外的第二道)')
})