import { test } from 'node:test' import assert from 'node:assert/strict' import { adminPages } from '../src/router/routes.ts' import { jdPriceRange, jdSkuDimensions, jdSkuSummary, parseJdProductDetail, toJdProductItem, } from '../src/pages/jd/jd-product-model.ts' /** v1.4「京东数据库」后管页契约(蓝图 docs/ITERATION_PLAN.md §3.4 / §4 Phase 5)。 * * 只用 import 断言 routes 注册表——readSource 台账(source-pin-ratchet)钉住 * tests/ 里 readFileSync/globSync 读取点逐文件只许减,新读源码文件会撞棘轮; * V196 迁移 / company-scope / operation-guides 的接线由既有护栏在 Phase 5 收口时 * 自动覆盖(company-menu-route 把 V196 加进迁移清单、align-operation-guide、 * company-tab-wiring),本文件不重复 fs 断言。 * Pending 期整组 skip;Phase 5 落地后去掉 skip 跑绿。 */ const MENU_KEY = 'admin_jd_database' const ROUTE = 'jd-center/database' test('routes 注册表出现京东数据库页面且退出公司 tab(2026-11-16 参考品牌数据库定案)', () => { const page = adminPages.find((item) => item.menuKey === MENU_KEY) assert.ok(page, `routes.ts 缺 menuKey=${MENU_KEY} 的注册行`) assert.equal(page.path, ROUTE, 'route_path 必须与 V196 菜单一侧一致') assert.equal(page.title, '京东数据库', '菜单标题以「京东数据库」为准') // 数据全平台公共(2026-11-15「不区分公司」→ 2026-11-16「删除掉公司 tab,参考品牌数据库」): // meta.companyScoped 必须 false——true 会画出公司 tab,而取数口已不带 company_id(点了没反应)。 assert.equal(page.companyScoped, false, '京东数据库全平台公共,不画公司 tab(AC-6 已被 11-15/11-16 口径推翻)') }) /** 2026-11-17 用户口径「京东分类管理并到京东数据库分类编辑里」:V204 独立子菜单页下线 * (分类建/改名/删收进京东数据库页工具栏「分类管理」对话框),路由注册表不得再登记该 key。 */ test('routes 注册表不再登记京东分类管理独立页(V204 页并入京东数据库页,残留=404 入口)', () => { assert.ok(!adminPages.some((item) => item.menuKey === 'admin_jd_category_manage'), 'admin_jd_category_manage 注册行必须已删(页面并入京东数据库页)') assert.ok(!adminPages.some((item) => item.path === 'jd-center/categories'), 'jd-center/categories 路由必须下线') }) /** 详情面的 SKU 矩阵解析(V198):后端下发 camelCase,snake 容错;坏行不炸整块。 */ test('详情负载的 skus 归一化成矩阵行:skuId 为身份、销售属性维度按首次出现排序', () => { const detail = parseJdProductDetail({ id: 1, productCode: '10036442942137', skus: [ { skuId: '10238877506570', skuName: '上衣 S', skuSeq: '1', price: 162.0, stock: 200, sortNo: 0, saleAttrs: [{ name: '颜色', value: '上衣' }, { name: '尺码', value: 'S' }] }, { skuId: '10238877506580', sku_name: '半裙 S', sku_seq: '3', price: '168.00', stock: 80, sort_no: 2, sale_attrs: [{ name: '颜色', value: '半裙' }, { name: '尺码', value: 'S' }] }, ], }) assert.equal(detail.skus.length, 2) assert.equal(detail.skus[0].skuId, '10238877506570') assert.equal(detail.skus[0].price, '162', 'BigDecimal 序列化成 number 也要能读') assert.equal(detail.skus[1].price, '168', '字符串价去尾零') assert.equal(detail.skus[1].sortNo, 2, 'snake 容错') assert.deepEqual(jdSkuDimensions(detail.skus), ['颜色', '尺码'], '维度名按首次出现顺序') assert.equal(jdSkuSummary(detail.skus), '2 个 SKU · ¥162 ~ ¥168 · 库存 280') }) test('缺 skuId 的行弃掉、空 skus 回空数组(旧数据不渲染空表)', () => { const detail = parseJdProductDetail({ id: 2, skus: [{ skuName: '没有 skuId' }, { skuId: 'A1', price: 1, stock: 0 }], }) assert.equal(detail.skus.length, 1) assert.equal(jdSkuSummary(detail.skus), '1 个 SKU · ¥1 · 库存 0') assert.equal(parseJdProductDetail({ id: 3 }).skus.length, 0) assert.equal(jdSkuSummary([]), '') }) /** 列表行价格(2026-11-16 修「采集到了却全显示 -」):后端 BigDecimal 序列化成 JSON number, * 解析层必须数值/字符串都收——text() 只认字符串=价格在解析层被丢成空串的生产实录 * (生产库 273/273 行 price_min 全有值、界面价格列全「-」,用户报「价格没采集到」的真因)。 */ test('列表行价格:BigDecimal 的 JSON number 形状与字符串形状都归一成展示文本', () => { const numeric = toJdProductItem({ id: 9, productCode: '10036368647085', priceMin: 107.64, priceMax: 109.26 }) assert.ok(numeric, '只缺价格之外的字段不弃行') assert.equal(numeric.priceMin, '107.64', 'number 形状不许丢成空串') assert.equal(jdPriceRange(numeric), '107.64 ~ 109.26', 'number 形状价格列不许显示 -') const single = toJdProductItem({ id: 10, priceMin: 64.8, priceMax: 64.8 }) assert.ok(single) assert.equal(jdPriceRange(single), '64.8', '单值价(min==max)不拼区间') const stringShape = toJdProductItem({ id: 11, priceMin: '12.90', priceMax: '' }) assert.ok(stringShape) assert.equal(stringShape.priceMin, '12.9', '字符串形状仍收(去尾零,与详情 SKU 价同口径)') assert.equal(jdPriceRange(stringShape), '12.9') const missing = toJdProductItem({ id: 12 }) assert.ok(missing) assert.equal(jdPriceRange(missing), '', '两侧都空回空串(列表显示 -)') }) /** 类目筛选(2026-11-15 末级等值;2026-11-18 一级/二级可选中=子树展开集合 IN): * 空串不下发;无路径=单元素集合(等值旧形状);带路径=jdCategoryNamesUnder 展开。 */ test('类目筛选参数序列化:空串不下发、末级单值、父级展开子树集合', async () => { const { createJdProductFilterState, toJdProductListParams, jdProductFilterActive } = await import('../src/pages/jd/jd-product-filter.ts') const empty = createJdProductFilterState() assert.equal('category' in toJdProductListParams(empty, 1, 20), false, '全部类目不下发 category') assert.equal(jdProductFilterActive(empty), false) const leaf = { ...empty, category: ' 艺考形体服 ' } assert.deepEqual(toJdProductListParams(leaf, 1, 20).category, ['艺考形体服'], '无路径=去空白单元素集合(等值旧形状,后端 IN 单值等价)') assert.equal(jdProductFilterActive(leaf), true, '选中类目算激活筛选') const parent = { ...empty, category: '女装', categoryPath: ['服饰内衣', '女装'] } const expanded = toJdProductListParams(parent, 1, 20).category as string[] assert.ok(Array.isArray(expanded) && expanded.length > 20, '一级/二级选中=子树展开集合') assert.ok(expanded.includes('女装'), '集合含节点自身名(实际末级可能就在这一级)') assert.ok(expanded.includes('连衣裙') && expanded.includes('短袖连衣裙'), '含后代各级名') assert.ok(!expanded.includes('艺考形体服'), '不越出子树(艺考形体服在运动户外支)') const stale = { ...empty, category: '已下架历史类目', categoryPath: ['不存在', '的路径'] } assert.deepEqual(toJdProductListParams(stale, 1, 20).category, ['已下架历史类目'], '路径失效(树外历史名)回落单名等值,不静默丢筛选') }) test('自定义分类使用 group_id,不发送分类状态参数', async () => { const { createJdProductFilterState, toJdProductListParams } = await import('../src/pages/jd/jd-product-filter.ts') const query = toJdProductListParams({ ...createJdProductFilterState(), groupId: '7' }, 1, 20) assert.equal(query.group_id, 7) assert.equal('grouped' in query, false) assert.equal('ungrouped' in query, false) })