Files

326 lines
18 KiB
TypeScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 京东数据库页纯逻辑契约(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:<id>),四类档位互斥单值。派生(jdOwnershipSelectValue)与
* 回写(applyJdOwnershipSelection)都在 filter 层纯函数里,本组用例钉三件事:
* ① 派生档位——分类档优先于状态档(groupId 非空必须卡 cat:<id>,否则同一颗下拉会同时
* 显示「已分类」和某分类、界面说谎);② 选分类档写 groupId、清状态档、清店铺孤儿谓词
* (店铺名单挂在分类下,换分类后旧店铺词会命中别组同名店——侧栏 onSelectGroup 同纪律);
* ③ 状态档清 groupId 不动店铺词(店铺不属分类维度,与既有三档行为一致);
* 脏值按「全部」兜底,不拿脏值冒充档位。 */
test('归属筛选查询——派生档位:分类档 cat:<id> 优先于状态档、默认卡全部', () => {
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)
})