82 lines
4.4 KiB
TypeScript
82 lines
4.4 KiB
TypeScript
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 路由')
|
||
})
|