import assert from 'node:assert/strict' import test from 'node:test' import { existsSync, readFileSync, readdirSync } from 'node:fs' import { join } from 'node:path' /** v1.5 京东发布用户端契约(蓝图 docs/ITERATION_PLAN.md §1 AC-9 / §3 / §4 Phase 4)。 * * 两组: * 1. **立即生效**(AC-9 前端绊线,B113-01):`/api/jd-collect/groups` 是京东分类的 * 唯一读取口——全 src 不得出现第三个裸 URL 消费点;发布页要分类数据必须走 * endpoints.jdCollect.groups 的既有 fetch 函数(出现第二个分类口即红)。 * 2. **Phase 4 契约**(2026-11-18 随 Phase 4 落地移除 skip 正式激活):JdPublishTab * (分类→商品→改价→建单→实时面板)的 5 支验收契约,蓝图 §4 Phase 4【待激活验收测试】清单。 */ const ROOT = process.cwd() function read(relativePath: string, what: string): string { const path = join(ROOT, relativePath) assert.ok(existsSync(path), `${what} 尚未落地(蓝图 §4 Phase 4):${path}`) return readFileSync(path, 'utf8') } /** 递归收集 src 下 .ts/.vue 源文件 */ function collectSourceFiles(dir: string, acc: string[] = []): string[] { for (const entry of readdirSync(dir, { withFileTypes: true })) { const full = join(dir, entry.name) if (entry.isDirectory()) collectSourceFiles(full, acc) else if (/\.(ts|vue)$/.test(entry.name)) acc.push(full) } return acc } // ---------------------------------------------------------- AC-9 前端绊线(立即生效) test('AC-9: 京东分类读取口全 src 唯一(B113-01 绊线)', () => { const hits = collectSourceFiles(join(ROOT, 'src')) .filter((f) => readFileSync(f, 'utf8').includes('jd-collect/groups')) .map((f) => f.replace(/\\/g, '/').replace(ROOT.replace(/\\/g, '/') + '/', '')) assert.deepEqual(hits.sort(), [ 'src/shared/api/endpoints.ts', 'src/shared/api/types/modules/jd-collect.ts', ], 'B113-01:/api/jd-collect/groups 是京东分类唯一读取口——发布页要分类必须消费 endpoints.jdCollect.groups 既有出口,不得新增裸 URL 消费点') }) // ---------------------------------------------------------- Pending Phase 4 test('AC-9: JdPublishTab 分类选择消费唯一 groups 出口', () => { const tab = read('src/pages/jd/JdPublishTab.vue', '商品上架页') assert.ok(tab.includes('jdCollect'), 'JdPublishTab 的分类数据必须走 endpoints.jdCollect/groups 既有 fetch(AC-9),不得自拼 URL') assert.ok(!tab.includes('jd-collect/groups'), 'JdPublishTab 不得裸写分类 URL(B113-01 绊线)') }) test('AC-9: 商品列表只拉归属当前用户的行(owner 过滤)', () => { const tab = read('src/pages/jd/JdPublishTab.vue', '商品上架页') assert.ok(tab.includes('productIds') || tab.includes('productId'), 'JdPublishTab 建单提交必须携带勾选的商品 id 集合(服务端按 owner 校验,跨用户商品 0 返回)') }) test('建单请求体形状:categoryId + productIds + priceRule{mode,value}', () => { const tab = read('src/pages/jd/JdPublishTab.vue', '商品上架页') // 蓝图 §3 死契约:POST /api/jd-publish/tasks 请求体 {categoryId, productIds[], priceRule:{mode,value?}} assert.ok(tab.includes('categoryId'), '建单体缺 categoryId(所选自定义分类)') assert.ok(tab.includes('priceRule'), '建单体缺 priceRule(统一改价规则;mode: none|percent|fixed)') assert.ok(tab.includes("'percent'") && tab.includes("'fixed'") && tab.includes("'none'"), 'priceRule.mode 三档(none/percent/fixed)必须与蓝图 §3 同值') }) test('endpoints 注册 jdPublish 端点组(建单/items/chunk 三件)', () => { const endpoints = read('src/shared/api/endpoints.ts', 'endpoints.ts') assert.ok(endpoints.includes('jdPublish'), 'endpoints.ts 缺 jdPublish 端点组') assert.ok(endpoints.includes('/api/jd-publish/tasks'), 'jdPublish 组缺建单端点 /api/jd-publish/tasks') }) test('商品上架占位卡转正式:jd-publish 卡挂 /jd-publish 路由', () => { const catalog = read('src/pages/jd/tool-catalog.ts', 'jd/tool-catalog.ts') const router = read('src/router/index.ts', 'router/index.ts') assert.ok(/id:\s*'jd-publish'[\s\S]*?href:\s*'\/jd-publish'/.test(catalog), 'jd-publish 卡须补 href 指向 /jd-publish(转正式)') assert.ok(router.includes("path: '/jd-publish'"), 'router 缺 /jd-publish 路由') })