220 lines
13 KiB
TypeScript
220 lines
13 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 组三件接入用户端:
|
||
* 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 分钟内自动领取)')
|
||
})
|