/** * 京东数据库页纯逻辑契约(v1.4 Phase 5 → v1.7 对齐原型《商品数据商城》)—— * node --test 直跑(纯函数零依赖)。 * * 不用 readFileSync/readSource/globSync 读点:source-pin-ratchet 对台账外新文件带读点即红, * 本文件只 import 被测纯函数。 * * 覆盖: * 1. **snake 参数形状**:toJdProductListParams 产出 `page`/`page_size`(默认 50、上限 1000、 * 档位 50/100/200/500/1000〔v1.7 对齐原型,上限与后端 JdProductQueryService.MAX_PAGE_SIZE * 逐字同步〕)、`keyword`(v1.7 合并搜索:商品编码 OR 标题,OR 语义在后端 SQL)、 * `shop_name`(v1.7 店铺名单点选,精确 eq)、`min_price`/`max_price`(v1.7 价格区间)、 * `group_id`/`owner_group_id`/`synced_from`/`synced_to`(ISO yyyy-MM-dd;空白/非法不下发; * groupId 空串→不带、有值→snake group_id;ownerGroupId>0 才带、0/null/NaN 一律不带= * 后端按作用域默认分组取,V203);分页钳制(铁律 15)。 * 旧 `product_code`/`title_keyword` 两参数 v1.7 起前端停发(合并进 keyword;后端参数 * 保留兼容在飞请求);商品状态筛选与 json/txt 导出参数口仍随 2026-11-15 客户口径下线。 * 2. **详情解析**:parseJdProductDetail 解析 attrGroups/images(camel 为正 snake 容错、缺 url 弃行), * attrGroups 解析不出时 attrJsonRaw 原文兜底;列表行解析缺 id 弃行。 * * 跑法:`node --test tests/jd-product-group.test.ts` */ import { test } from 'node:test' import assert from 'node:assert/strict' import { JD_OWNERSHIP_CATEGORY_PREFIX, JD_PRODUCT_MAX_PAGE, JD_PRODUCT_MAX_PAGE_SIZE, JD_PRODUCT_PAGE_SIZE, JD_PRODUCT_PAGE_SIZE_OPTIONS, applyJdOwnershipSelection, createJdProductFilterState, jdOwnershipSelectValue, toJdProductListParams, } from '../src/pages/jd/jd-product-filter.ts' import { jdCategoryChildren, jdCategoryRoots, } from '../src/pages/jd/jd-category-tree.ts' import { JD_PRODUCT_DEFAULT_SIZE, jdPriceRange, parseJdProductDetail, parseJdProductPage, toJdProductItem, } from '../src/pages/jd/jd-product-model.ts' test('类目级联静态导航树——服饰内衣二级与京麦面板样本逐字同源,一级集非空且无重名', () => { // 京麦面板真机样本(2026-11-16 客户截图):服饰内衣下就是这五个二级,改名即红。 assert.deepEqual(jdCategoryChildren(['服饰内衣']).map(node => node.name), ['服饰配件', '内衣', '女装', '男装', '定制服装/工装']) assert.deepEqual(jdCategoryChildren(['不存在的类目']), [], '未知一级回落空子级(面板不出第二栏)') const roots = jdCategoryRoots().map(node => node.name) assert.deepEqual(roots, ['服饰内衣', '母婴', '运动户外'], '一级导航与京麦授权类目一致') assert.equal(new Set(roots).size, roots.length, '一级类目名不得重复') for (const root of roots) { const children = jdCategoryChildren([root]).map(node => node.name) assert.equal(new Set(children).size, children.length, `${root} 的二级不得重复`) } }) test('京东列表参数——snake 形状:keyword/店铺/价格下发,旧编码标题两框停发、日期空白/非法不下发', () => { const full = toJdProductListParams( { keyword: ' 保温杯 ', shopName: ' 绿屿街道店 ', minPrice: ' 100 ', maxPrice: 'abc', groupId: ' 7 ', syncedFrom: '2026-11-01', syncedTo: '2026-11-09', }, 2, 20, // V203 第 4 参=当前数据权限分组(分类列/分类筛选的作用域,不是筛选条件)。 11, ) assert.deepEqual(full, { page: 2, page_size: 20, keyword: '保温杯', shop_name: '绿屿街道店', min_price: 100, group_id: 7, owner_group_id: 11, synced_from: '2026-11-01', synced_to: '2026-11-09', }, 'keyword/店铺 trim 后下发;非法价格(abc)不下发,合法价格转 number') // 旧两框 v1.7 起前端停发(合并进 keyword):参数面不再出现(后端参数保留兼容在飞请求)。 assert.equal('product_code' in full, false, 'product_code 前端停发(合并搜索替代)') assert.equal('title_keyword' in full, false, 'title_keyword 前端停发(合并搜索替代)') assert.equal('sale_status' in full, false, '商品状态筛选已下线,参数面不再出现 sale_status') // 出厂态=分页两项、不带 classified(2026-11-21 用户口径「默认改成全部」——全部档 // 序列化不带 classified 参数=后端跳过谓词查全量); // 脏值(非数字分组、非法日期、非法价格)同罪不下发。 const blank = toJdProductListParams(createJdProductFilterState(), 1, 20) assert.deepEqual(blank, { page: 1, page_size: 20 }, '出厂默认不带 classified 键——首屏查全量(默认全部档),不再卡未分类') assert.equal('group_id' in blank, false, 'groupId 空串不带 group_id') assert.equal('owner_group_id' in blank, false, '没传当前分组就不带 owner_group_id(后端按作用域默认组取)') const dirty = toJdProductListParams( { ...createJdProductFilterState(), groupId: 'abc', syncedFrom: '2026/11/01', syncedTo: 'not-a-date', minPrice: 'abc', maxPrice: ' ' }, 1, 20, ) assert.deepEqual(dirty, { page: 1, page_size: 20 }, '脏值(分组/日期/价格)不下发;出厂态查全量(默认全部档)') // 价格区间(v1.7 F2):合法上下限转 number 下发(后端 price_min >= X AND price_max <= Y)。 const priced = toJdProductListParams( { ...createJdProductFilterState(), minPrice: ' 100.5 ', maxPrice: '200' }, 1, 20, ) assert.deepEqual({ min_price: priced.min_price, max_price: priced.max_price }, { min_price: 100.5, max_price: 200 }, '价格区间合法值转 number 下发(字符串不发给后端 BigDecimal)') // 当前分组非法值(0/NaN/null)一律不下发:0 是「不属于任何组」的哨兵,不能当组 id 发出去。 for (const bad of [0, null, undefined, Number.NaN]) { assert.equal('owner_group_id' in toJdProductListParams(createJdProductFilterState(), 1, 20, bad), false, `ownerGroupId=${String(bad)} 不得下发 owner_group_id`) } }) test('京东列表参数——page 钳制防 (page-1)*page_size 溢出(铁律 15)', () => { const low = toJdProductListParams(createJdProductFilterState(), 0, 0) assert.equal(low.page, 1, 'page<1 归 1') assert.equal(low.page_size, 50, 'page_size 非法回默认 50(v1.6 新契约)') const big = toJdProductListParams(createJdProductFilterState(), 3, 5000) assert.equal(big.page_size, 1000, 'page_size 上限 1000(v1.7 对齐原型档位放宽)') const extreme = toJdProductListParams(createJdProductFilterState(), Number.MAX_SAFE_INTEGER, 1000) assert.equal(extreme.page, JD_PRODUCT_MAX_PAGE) const offset = (extreme.page - 1) * extreme.page_size assert.equal(Number.isSafeInteger(offset), true, `(page-1)*page_size=${offset} 必须留在安全整数域`) assert.equal(offset, 9_999_000, '10_000 页 × 1000 条仍在 Number.MAX_SAFE_INTEGER 内') }) /** v1.7 契约:首屏默认 50、档位 50/100/200/500/1000、上限 1000;model 侧默认与 filter 侧 * 同值不漂(页面装配层挂常量,两处字面量从此只剩常量出处;上限与后端 * JdProductQueryService.MAX_PAGE_SIZE 逐字同步——契约测试两侧钉着这个数)。 */ test('分页档位——默认 50、档位 50/100/200/500/1000、上限 1000(v1.7 对齐原型)', () => { assert.deepEqual([...JD_PRODUCT_PAGE_SIZE_OPTIONS], [50, 100, 200, 500, 1000], '档位清单逐字同(v1.7 新契约)') assert.ok(JD_PRODUCT_PAGE_SIZE_OPTIONS.includes(JD_PRODUCT_PAGE_SIZE), '默认值必须是档位之一') assert.equal(JD_PRODUCT_PAGE_SIZE, 50, '默认档 50(v1.6 拍板放宽,v1.4 §3.4 的 20 已废)') assert.equal(JD_PRODUCT_DEFAULT_SIZE, JD_PRODUCT_PAGE_SIZE, 'model 侧默认与 filter 侧同值') assert.equal(JD_PRODUCT_MAX_PAGE_SIZE, 1000, '上限 1000(v1.7 对齐原型,与后端 MAX_PAGE_SIZE 逐字同步)') }) /** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」;2026-11-18「加个全部 * 选项」恢复全量档;**2026-11-21 用户口径「默认改成全部」=出厂默认改卡 ''**,推翻 * 11-17「默认卡未分类」):界面三档,'classified'→true、'ungrouped'→false、 * ''(全部)→ 不带 classified 参数;出厂默认与「重置」都卡 ''(全部)。 * 缺省/脏值同走「全部」兜底(不拿脏值冒充档位)。 * 参数名是新档 classified——不是后端仍拒收的旧 grouped/ungrouped 查询参数。 */ test('京东列表参数——classified 默认全部:已分类→true、未分类→false、脏值兜底不下发', () => { const yes = toJdProductListParams({ ...createJdProductFilterState(), classified: 'classified' }, 1, 20, 11) assert.equal(yes.classified, true) assert.equal(yes.owner_group_id, 11, 'classified 与当前分组成对下发(后端按组判已/未分类)') const no = toJdProductListParams({ ...createJdProductFilterState(), classified: 'ungrouped' }, 1, 20, 11) assert.equal(no.classified, false, '未分类档显式选档仍下发 classified:false') assert.equal(createJdProductFilterState().classified, '', '出厂态与重置都必须卡「全部」档(2026-11-21 用户口径:默认改成全部)') for (const blank of [undefined, 'grouped', 'nonsense'] as const) { const q = toJdProductListParams({ ...createJdProductFilterState(), classified: blank }, 1, 20) assert.equal('classified' in q, false, `classified=${String(blank)} 按「全部」兜底处理,不拿脏值冒充档位`) } }) /** 归属筛选查询(2026-11-22 用户口径「还要加个归属筛选查询」):归属下拉在状态三档之外 * 追加「按分类查询」组(cat:),四类档位互斥单值。派生(jdOwnershipSelectValue)与 * 回写(applyJdOwnershipSelection)都在 filter 层纯函数里,本组用例钉三件事: * ① 派生档位——分类档优先于状态档(groupId 非空必须卡 cat:,否则同一颗下拉会同时 * 显示「已分类」和某分类、界面说谎);② 选分类档写 groupId、清状态档、清店铺孤儿谓词 * (店铺名单挂在分类下,换分类后旧店铺词会命中别组同名店——侧栏 onSelectGroup 同纪律); * ③ 状态档清 groupId 不动店铺词(店铺不属分类维度,与既有三档行为一致); * 脏值按「全部」兜底,不拿脏值冒充档位。 */ test('归属筛选查询——派生档位:分类档 cat: 优先于状态档、默认卡全部', () => { assert.equal(jdOwnershipSelectValue(createJdProductFilterState()), '', '出厂态(groupId 空+classified 全部)下拉派生「全部」档') assert.equal( jdOwnershipSelectValue({ ...createJdProductFilterState(), classified: 'ungrouped' }), 'ungrouped', '状态档原样派生', ) const state = { ...createJdProductFilterState(), classified: 'classified', groupId: '7' } assert.equal(jdOwnershipSelectValue(state), `${JD_OWNERSHIP_CATEGORY_PREFIX}7`, 'groupId 非空时分类档优先——下拉只显示分类,不显示状态档(否则界面说谎)') }) test('归属筛选查询——选分类档写 groupId 清状态档清店铺词;状态档清 groupId 不动店铺词', () => { // 选分类档:groupId 写入、状态档清空、店铺词清空(孤儿谓词纪律) const catState = { ...createJdProductFilterState(), classified: 'classified', shopName: '绿屿街道店' } applyJdOwnershipSelection(catState, `${JD_OWNERSHIP_CATEGORY_PREFIX}7`) assert.equal(catState.groupId, '7', '选分类=按归属表查该分类(group_id EXISTS 下推)') assert.equal(catState.classified, '', '分类档与状态档互斥——同一颗下拉选了分类就清状态档') assert.equal(catState.shopName, '', '换分类必须清店铺词:旧店铺词是孤儿谓词(侧栏 onSelectGroup 同形)') // 状态档:清 groupId、店铺词不动(店铺不属分类维度) const stateState = { ...createJdProductFilterState(), groupId: '7', shopName: '绿屿街道店' } applyJdOwnershipSelection(stateState, 'ungrouped') assert.equal(stateState.groupId, '', '状态档与分类档互斥——选状态档清 groupId') assert.equal(stateState.classified, 'ungrouped') assert.equal(stateState.shopName, '绿屿街道店', '状态档不动店铺词(与既有三档行为一致)') // 「全部」档:两字段都清 const allState = { ...createJdProductFilterState(), groupId: '7', classified: 'classified' } applyJdOwnershipSelection(allState, '') assert.equal(allState.groupId, '', '全部档清分类档') assert.equal(allState.classified, '', '全部档清状态档') // 脏值兜底:未知前缀/非数字 id 都按「全部」档,不拿脏值冒充档位 for (const dirty of ['cat:abc', 'cat:0', 'cat:-1', 'shop:9', 'nonsense']) { const dirtyState = { ...createJdProductFilterState(), groupId: '7', classified: 'classified' } applyJdOwnershipSelection(dirtyState, dirty) assert.equal(dirtyState.groupId, '', `脏值 ${dirty} 按「全部」兜底清分类档`) assert.equal(dirtyState.classified, '', `脏值 ${dirty} 按「全部」兜底清状态档`) } }) test('详情解析——attrGroups/images 结构化解析(snake 容错、缺 url 弃行)', () => { const detail = parseJdProductDetail({ code: 0, message: 'ok', data: { id: 42, title: '304不锈钢保温杯', sale_status: '上架中', attrGroups: [ { groupName: '规格', attrs: [ { key: 'capacity', label: '容量', value: '500ml' }, { key: 'material', label: '', value: '304不锈钢' }, ], }, { group_name: '其他', attrs: [{ key: 'color', label: '颜色', value: '白色' }] }, ], images: [ { imageType: 'MAIN', attrName: '', sortNo: 1, url: 'https://img.example/main.jpg', width: 800, height: 800 }, { image_type: 'ATTR', attrName: '白色', sortNo: 2, url: 'https://img.example/white.jpg' }, { imageType: 'ATTR', attrName: '', sortNo: 3, url: 'https://img.example/attr2.jpg' }, { imageType: 'DETAIL', sortNo: 4, url: '' }, // 缺 url 弃行 ], }, }) assert.equal(detail.item.id, 42) assert.equal(detail.item.title, '304不锈钢保温杯') assert.equal(detail.item.saleStatus, '上架中', 'snake 容错') assert.equal(detail.attrGroups.length, 2, '两个属性块') assert.equal(detail.attrGroups[0].groupName, '规格') assert.equal(detail.attrGroups[0].attrs[0].label, '容量') assert.equal(detail.attrGroups[1].groupName, '其他', 'group_name snake 容错') assert.equal(detail.images.length, 3, '缺 url 的 DETAIL 图弃行') assert.equal(detail.images[1].imageType, 'ATTR', 'image_type snake 容错') assert.equal(detail.images[1].attrName, '白色') assert.equal(detail.images[1].sortNo, 2) assert.equal(detail.images[2].attrName, '', 'attrName 缺省空串') assert.equal(detail.attrJsonRaw, '', '结构化解析成功时不需要原文兜底') }) test('详情解析——attrGroups 缺失时 attrJsonRaw 原文兜底;信封外裸负载同口径', () => { const raw = '{"规格":{"容量":"500ml"}}' const detail = parseJdProductDetail({ id: 7, attrJsonRaw: raw }) assert.equal(detail.item.id, 7) assert.deepEqual(detail.attrGroups, [], 'attrGroups 解析不出为空') assert.equal(detail.attrJsonRaw, raw, '原文兜底字段原样透传(界面展示,不静默吞)') assert.deepEqual(detail.images, []) // 非法负载不抛:整包垃圾回空详情(id 0),attrJsonRaw 留空。 const junk = parseJdProductDetail('not-an-object') assert.equal(junk.item.id, 0) assert.equal(junk.attrJsonRaw, '') }) test('列表行解析——camel 为正 snake 容错、缺 id 弃行、价格区间拼装', () => { const page = parseJdProductPage({ success: true, data: { items: [ { id: 1, shopId: 3, shopName: '旗舰自营店', productCode: 'JD-10086', priceMin: '12.90', priceMax: '15.90', stockTotal: 500, saleStatus: '上架中', groupId: 7, groupName: '甲组', syncedAt: '2026-11-12 09:00:00', }, { id: 'not-a-number', title: '缺 id 弃行' }, { shop_name: 'snake 行也缺 id,弃' }, ], total: 1, page: 1, page_size: 20, }, }) assert.equal(page.items.length, 1, '三条原始行里两条缺有效 id,只留 1 行') const row = page.items[0] assert.equal(row.shopName, '旗舰自营店') assert.equal(row.groupId, 7) assert.equal(row.groupName, '甲组') // 2026-11-16 价格改走 decimalText(数值/字符串都收)后同口径去尾零,与详情 SKU 价一致。 assert.equal(jdPriceRange(row), '12.9 ~ 15.9', 'min/max 都有给区间(去尾零)') assert.equal(jdPriceRange({ priceMin: '12.90', priceMax: '' }), '12.9', '只空一侧给单值') assert.equal(jdPriceRange({ priceMin: '', priceMax: '' }), '', '全空为空串(界面展示 -)') // snake 行同口径 + 缺省回默认。 const snakePage = parseJdProductPage({ data: { items: [{ id: 9, shop_name: 'B店', main_image_url: 'https://img/x.jpg' }], total: 1, page: 2, page_size: 5 } }) const snakeRow = toJdProductItem({ id: 9, shop_name: 'B店', main_image_url: 'https://img/x.jpg' }) assert.equal(snakeRow?.mainImageUrl, 'https://img/x.jpg') assert.equal(snakePage.pageSize, 5) })