fix(jd-database): 归属三档默认改卡「全部」(2026-11-21 用户口径,推翻 11-17 默认未分类)

This commit is contained in:
2026-11-21 17:11:01 +08:00
parent b20f0bb44a
commit 0a769fa8d3
3 changed files with 46 additions and 41 deletions
@@ -30,9 +30,9 @@ export const JD_PRODUCT_MAX_PAGE_SIZE = 1000
export const JD_PRODUCT_PAGE_SIZE_OPTIONS = [50, 100, 200, 500, 1000] as const
/** 页码上限:与后端 MAX_PAGE(CR-18 先例,外观专利同值)对齐,两侧不漂。 */
export const JD_PRODUCT_MAX_PAGE = 10_000
/** 分类状态快筛的出厂档位(2026-11-17 用户口径「不需要全部分类 默认卡在未分类上就行」):
* 首屏/重置都卡它;「筛选激活」判定也以「是否偏离它」为准。 */
export const JD_PRODUCT_DEFAULT_CLASSIFIED = 'ungrouped' as const
/** 分类状态快筛的出厂档位(2026-11-21 用户口径「默认改成全部」,推翻 11-17「默认卡在
* 未分类上就行」;''=全部档):首屏/重置都卡它;非空档(已分类/未分类)才算激活筛选。 */
export const JD_PRODUCT_DEFAULT_CLASSIFIED = '' as const
/** 价格输入 → 有限数:空白/非数字回 null(不下发,后端 BigDecimal 侧也不认脏值)。 */
export function finitePriceOrNull(raw: string): number | null {
@@ -56,10 +56,10 @@ export interface JdProductFilterState {
shopName: string
/** 分类 id 文本(侧栏店铺分类 Tab 里那一行),空串=全部分类。 */
groupId: string
/** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」,同日定默认卡未分类;
* 2026-11-18 用户口径「加个全部选项」恢复全量档):'classified'=已分类(当前分组下有
* 分类),'ungrouped'=未分类,''=全部(当前分组下全部商品);**出厂默认仍='ungrouped'**
* (11-17 口径不动,首屏与「重置」都卡未分类档)。
/** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」;2026-11-18「加个全部
* 选项」恢复全量档;**2026-11-21 用户口径「默认改成全部」=出厂默认改卡 ''**,推翻
* 11-17「默认卡未分类」):'classified'=已分类(当前分组下有分类),'ungrouped'=
* 未分类,''=全部(当前分组下全部商品)。
* 语义按 V203 归属表(当前数据权限分组)判定,与列表分类列同形;不是 11-16 撤掉的
* 旧 grouped/ungrouped 参数(那两档读已停用的 biz_jd_product.group_id 列,后端仍拒收)。
* ''(全部档)序列化时不带 classified 参数=后端跳过谓词查全部;脏值同走该兜底。 */
@@ -75,8 +75,8 @@ export interface JdProductFilterState {
}
export function createJdProductFilterState(): JdProductFilterState {
// 分类状态出厂卡「未分类」(2026-11-17 用户口径「默认卡在未分类上就行」,2026-11-18
// 加「全部」档后默认不动):首屏与「重置」都带 classified=false 查,全量走「全部」档。
// 分类状态出厂卡「全部」(2026-11-21 用户口径「默认改成全部」,推翻 11-17「默认卡
// 未分类」):首屏与「重置」都不带 classified 参数查全量;已分类/未分类走显式选档。
return {
keyword: '',
category: '',
@@ -98,9 +98,9 @@ export function jdProductFilterActive(state: JdProductFilterState): boolean {
if ((state.category || '').trim()) return true
if ((state.shopName || '').trim()) return true
if ((state.groupId || '').trim()) return true
// 出厂默认本身卡未分类档(2026-11-17 用户口径),所以只有「偏离默认档」才算激活筛选,
// 否则首屏就永远处于"有筛选"状态,空结果提示会误导用户去重置一个没动过的筛选。
if (state.classified && state.classified !== JD_PRODUCT_DEFAULT_CLASSIFIED) return true
// 出厂默认=「全部」档(2026-11-21 用户口径),任何非空档(已分类/未分类)都算激活筛选;
// ''/缺省不激活,否则首屏就永远处于"有筛选"状态,空结果提示会误导用户去重置没动过的筛选。
if (state.classified) return true
if (finitePriceOrNull(state.minPrice) != null || finitePriceOrNull(state.maxPrice) != null) return true
if (validIsoDateOrUndefined(state.syncedFrom) || validIsoDateOrUndefined(state.syncedTo)) return true
return false
@@ -89,11 +89,12 @@ test('京东列表参数——snake 形状:keyword/店铺/价格下发,旧
assert.equal('title_keyword' in full, false, 'title_keyword 前端停发(合并搜索替代)')
assert.equal('sale_status' in full, false, '商品状态筛选已下线,参数面不再出现 sale_status')
// 出厂态=分页两项+默认未分类档(classified:false,2026-11-17 用户口径「默认卡在未分类上就行」);
// 出厂态=分页两项、不带 classified(2026-11-21 用户口径「默认改成全部」——全部档
// 序列化不带 classified 参数=后端跳过谓词查全量);
// 脏值(非数字分组、非法日期、非法价格)同罪不下发。
const blank = toJdProductListParams(createJdProductFilterState(), 1, 20)
assert.deepEqual(blank, { page: 1, page_size: 20, classified: false },
'出厂默认必须带 classified:false——首屏就卡未分类,不是全量')
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(
@@ -101,8 +102,8 @@ test('京东列表参数——snake 形状:keyword/店铺/价格下发,旧
1,
20,
)
assert.deepEqual(dirty, { page: 1, page_size: 20, classified: false },
'脏值(分组/日期/价格)不下发;出厂态仍带 classified:false(默认未分类档)')
assert.deepEqual(dirty, { page: 1, page_size: 20 },
'脏值(分组/日期/价格)不下发;出厂态查全量(默认全部档)')
// 价格区间(v1.7 F2):合法上下限转 number 下发(后端 price_min >= X AND price_max <= Y)。
const priced = toJdProductListParams(
@@ -145,20 +146,24 @@ test('分页档位——默认 50、档位 50/100/200/500/1000、上限 1000(v
assert.equal(JD_PRODUCT_MAX_PAGE_SIZE, 1000, '上限 1000(v1.7 对齐原型,与后端 MAX_PAGE_SIZE 逐字同步)')
})
/** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」,同日定默认卡未分类;
* 2026-11-18 用户口径「加个全部选项」恢复全量档):界面三档,'classified'→true、
* 'ungrouped'→false、''(全部)→ 不带 classified 参数;出厂默认与「重置」仍卡 ungrouped。
* ''/缺省/脏值同走「全部」兜底(不拿脏值冒充档位)。
/** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」;2026-11-18「加个全部
* 选项」恢复全量档;**2026-11-21 用户口径「默认改成全部」=出厂默认改卡 ''**,推翻
* 11-17「默认卡未分类」):界面三档,'classified'→true、'ungrouped'→false、
* ''(全部)→ 不带 classified 参数;出厂默认与「重置」都卡 ''(全部)。
* 缺省/脏值同走「全部」兜底(不拿脏值冒充档位)。
* 参数名是新档 classified——不是后端仍拒收的旧 grouped/ungrouped 查询参数。 */
test('京东列表参数——classified 默认卡未分类:已分类→true、未分类→false、脏值兜底不下发', () => {
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 与当前分组成对下发(后端按组判已/未分类)')
assert.equal(createJdProductFilterState().classified, 'ungrouped',
'出厂态与重置都必须卡未分类档(用户口径:默认卡在未分类上)')
const no = toJdProductListParams({ ...createJdProductFilterState(), classified: 'ungrouped' }, 1, 20, 11)
assert.equal(no.classified, false, '未分类档显式选档仍下发 classified:false')
for (const blank of ['', undefined, 'grouped', 'nonsense'] as const) {
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)} 按「全部」兜底处理,不拿脏值冒充档位`)
}
@@ -308,7 +308,7 @@ describe('布局:筛选行+工具栏上移顶部通栏(2026-11-21 用户
expect(mainPanel.find('.jd-page-bar').exists()).toBe(true, '主面板=自绘分页条(v1.7 对齐原型)')
expect(mainPanel.find('.jd-select-bar').exists()).toBe(true, '主面板=底部已选条(v1.7 常驻)')
expect(mainPanel.text()).toContain('已选 0 件', '已选条常驻:0 件也显示(不随勾选数显隐)')
expect(mainPanel.find('.jd-filter-chips').exists()).toBe(false, '出厂态(默认未分类档)无激活筛选,回显条不渲染')
expect(mainPanel.find('.jd-filter-chips').exists()).toBe(false, '出厂态(默认全部档)无激活筛选,回显条不渲染')
// 顺序与归属:页面根下先是顶部通栏面板、后是横排体;侧栏与主面板都在横排体里。
const viewChildren = [...wrapper.get('.jd-database-view').element.children]
@@ -512,20 +512,20 @@ describe('分类管理入口(V204 独立页并入侧栏「分类管理」对
})
})
describe('归属三档快筛(三档,默认卡未分类)', () => {
it('下拉三档且首屏就卡「未分类」(classified="ungrouped" 随首取下发)', async () => {
describe('归属三档快筛(三档,2026-11-21 用户口径默认改卡「全部」)', () => {
it('下拉三档且首屏就卡「全部」(首取不带 classified 键=后端跳过谓词查全量)', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 50 })
expect(optionLabels(wrapper, '筛选分类状态')).toEqual(['全部', '已分类', '未分类'])
expect(jdApi.fetchJdProductList.mock.calls[0][0].classified).toBe('ungrouped',
'首屏默认档=未分类——用户口径「默认卡在未分类上就行」')
expect(jdApi.fetchJdProductList.mock.calls[0][0]).not.toHaveProperty('classified',
'首屏默认档=全部——2026-11-21 用户口径「默认改成全部」(推翻 11-17 卡未分类)')
wrapper.unmount()
})
it('选「全部」下发不带 classified 键(查当前分组全部商品);选「已分类」下发 classified 态', async () => {
it('选「未分类」下发 classified:false;选「已分类」下发 classified 态', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 50 })
await pickSelectOption(wrapper, '筛选分类状态', '全部')
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0]).not.toHaveProperty('classified',
'value=\'\' 序列化不下发 classified 参数=后端跳过谓词查全部')
await pickSelectOption(wrapper, '筛选分类状态', '未分类')
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0].classified).toBe('ungrouped',
'未分类是显式选档(api 序列化层再转 classified:false)')
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0]).toMatchObject({ page: 1 }, '选中即查回第一页')
await pickSelectOption(wrapper, '筛选分类状态', '已分类')
@@ -533,7 +533,7 @@ describe('归属三档快筛(三档,默认卡未分类)', () => {
wrapper.unmount()
})
it('「重置」(弹层里)不放开筛选,而是回默认未分类档', async () => {
it('「重置」(弹层里)不放开筛选,而是回默认「全部」档(首取不带 classified 键)', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 50 })
await pickSelectOption(wrapper, '筛选分类状态', '已分类')
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0].classified).toBe('classified')
@@ -541,8 +541,8 @@ describe('归属三档快筛(三档,默认卡未分类)', () => {
await openFilterPopover(wrapper)
await wrapper.findAll('button').find((b) => b.text() === '重置')!.trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0].classified).toBe('ungrouped',
'重置回出厂默认档(未分类),「全部」只是可选项不接默认')
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0]).not.toHaveProperty('classified',
'重置回出厂默认档(全部=不带 classified 参数),不是回未分类')
wrapper.unmount()
})
})
@@ -958,7 +958,7 @@ describe('筛选与分页(v1.7:合并搜索+筛选弹层;AC-2/AC-4)',
wrapper.unmount()
})
it('重置把筛选面回空并回第一页重取(入口在弹层里;归属三档回未分类档、侧栏选中态清空)', async () => {
it('重置把筛选面回空并回第一页重取(入口在弹层里;归属三档回默认全部档、侧栏选中态清空)', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue(GROUPS)
const wrapper = await mountWith({ items: [], total: 0, page: 1, pageSize: 50 })
await wrapper.get('[aria-label="搜索商品"]').setValue('保温杯')
@@ -1086,7 +1086,7 @@ describe('筛选与分页(v1.7:合并搜索+筛选弹层;AC-2/AC-4)',
it('筛选回显条(v1.7 F5):激活筛选出芯片+共 N 条+清除筛选;清除保留分组作用域(AC-4)', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue(GROUPS)
const wrapper = await mountWith({ items: [item(1)], total: 7, page: 1, pageSize: 50 })
expect(wrapper.find('.jd-filter-chips').exists()).toBe(false, '出厂态(默认未分类档)不渲染回显条')
expect(wrapper.find('.jd-filter-chips').exists()).toBe(false, '出厂态(默认全部档)不渲染回显条')
// 激活一批筛选:搜索词+侧栏分类+弹层价格区间+同步区间。
await wrapper.get('[aria-label="搜索商品"]').setValue('保温杯')
@@ -1110,14 +1110,14 @@ describe('筛选与分页(v1.7:合并搜索+筛选弹层;AC-2/AC-4)',
expect(chipText).toContain('共 7 条', '「共 N 条」给行集规模')
expect(chips.get('.jd-chip-clear').text()).toBe('清除筛选')
// 清除筛选:筛选面回出厂(含三档回未分类),分组作用域保留。
// 清除筛选:筛选面回出厂(含三档回默认「全部」档),分组作用域保留。
await chips.get('.jd-chip-clear').trigger('click')
await flushPromises()
const last = jdApi.fetchJdProductList.mock.calls.at(-1)![0]
expect(last).toMatchObject({ keyword: '', groupId: '', minPrice: '', maxPrice: '', syncedFrom: '', syncedTo: '' },
'清除筛选后筛选面回空')
expect(last.ownerGroupId).toBe(11, '清除筛选保留分组作用域(分组是作用域不是筛选条件)')
expect(last.classified).toBe('ungrouped', '归属三档回默认未分类档')
expect(last).not.toHaveProperty('classified', '归属三档回默认「全部」档(不带 classified 参数)')
expect(wrapper.find('.jd-filter-chips').exists()).toBe(false, '清除后回显条消失(无激活筛选)')
expect(sideCustom(wrapper).findAll('.jd-side-row.selected')).toHaveLength(0, '侧栏分类选中态随清除清空')
wrapper.unmount()