diff --git a/admin-frontend-vue/src/pages/jd/JdDatabasePage.vue b/admin-frontend-vue/src/pages/jd/JdDatabasePage.vue index d68aca933..317ce636b 100644 --- a/admin-frontend-vue/src/pages/jd/JdDatabasePage.vue +++ b/admin-frontend-vue/src/pages/jd/JdDatabasePage.vue @@ -418,17 +418,17 @@ onMounted(async () => { - + - diff --git a/admin-frontend-vue/src/pages/jd/jd-product-filter.ts b/admin-frontend-vue/src/pages/jd/jd-product-filter.ts index d73696e00..0fff81200 100644 --- a/admin-frontend-vue/src/pages/jd/jd-product-filter.ts +++ b/admin-frontend-vue/src/pages/jd/jd-product-filter.ts @@ -19,6 +19,9 @@ export const JD_PRODUCT_PAGE_SIZE = 20 export const JD_PRODUCT_MAX_PAGE_SIZE = 100 /** 页码上限:与后端 MAX_PAGE(CR-18 先例,外观专利同值)对齐,两侧不漂。 */ export const JD_PRODUCT_MAX_PAGE = 10_000 +/** 分类状态快筛的出厂档位(2026-11-17 用户口径「不需要全部分类 默认卡在未分类上就行」): + * 首屏/重置都卡它;「筛选激活」判定也以「是否偏离它」为准。 */ +export const JD_PRODUCT_DEFAULT_CLASSIFIED = 'ungrouped' as const export interface JdProductFilterState { /** 商品编码,空串不限。 */ @@ -29,11 +32,12 @@ export interface JdProductFilterState { category: string /** 分组 id 文本(分组管理里那一行),空串=全部分组。 */ groupId: string - /** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」): - * ''/缺省=全部,'classified'=已分类(当前分组下有分类),'ungrouped'=未分类。 + /** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」,同日二档收敛 + * 「不需要全部分类 默认卡在未分类上就行」):'classified'=已分类(当前分组下有分类), + * 'ungrouped'=未分类,**出厂默认='ungrouped'**(首屏与「重置」都卡未分类档)。 * 语义按 V203 归属表(当前数据权限分组)判定,与列表分类列同形;不是 11-16 撤掉的 * 旧 grouped/ungrouped 参数(那两档读已停用的 biz_jd_product.group_id 列,后端仍拒收)。 - * 可选:既有纯测试夹具字面量不带该键仍合法,缺省按「全部」处理。 */ + * ''/缺省=「全部」仍是序列化出口的兜底语义(脏值不冒充档位),但界面不再给这一档。 */ classified?: '' | 'classified' | 'ungrouped' /** 同步开始日期(ISO yyyy-MM-dd;空串不限)。 */ syncedFrom: string @@ -42,7 +46,9 @@ export interface JdProductFilterState { } export function createJdProductFilterState(): JdProductFilterState { - return { productCode: '', titleKeyword: '', category: '', groupId: '', classified: '', syncedFrom: '', syncedTo: '' } + // 分类状态出厂卡「未分类」(2026-11-17 用户口径「默认卡在未分类上就行」): + // 首屏与「重置」都带 classified=false 查,用户要全量自己点「已分类」逐档看。 + return { productCode: '', titleKeyword: '', category: '', groupId: '', classified: JD_PRODUCT_DEFAULT_CLASSIFIED, syncedFrom: '', syncedTo: '' } } /** 是否有任一激活筛选条件。 */ @@ -51,7 +57,9 @@ export function jdProductFilterActive(state: JdProductFilterState): boolean { if ((state.titleKeyword || '').trim()) return true if ((state.category || '').trim()) return true if ((state.groupId || '').trim()) return true - if (state.classified) return true + // 出厂默认本身卡未分类档(2026-11-17 用户口径),所以只有「偏离默认档」才算激活筛选, + // 否则首屏就永远处于"有筛选"状态,空结果提示会误导用户去重置一个没动过的筛选。 + if (state.classified && state.classified !== JD_PRODUCT_DEFAULT_CLASSIFIED) return true if (validIsoDateOrUndefined(state.syncedFrom) || validIsoDateOrUndefined(state.syncedTo)) return true return false } diff --git a/admin-frontend-vue/tests/jd-product-group.test.ts b/admin-frontend-vue/tests/jd-product-group.test.ts index 12f8afa82..a670e4a35 100644 --- a/admin-frontend-vue/tests/jd-product-group.test.ts +++ b/admin-frontend-vue/tests/jd-product-group.test.ts @@ -75,9 +75,11 @@ test('京东列表参数——snake 形状:groupId 空→不带、有值→gro }) assert.equal('shop_name' in full, false, '店铺筛选已下线,参数面不再出现 shop_name') - // 全空态只有分页两项;脏值(非数字分组、非法日期)同罪不下发。 + // 出厂态=分页两项+默认未分类档(classified:false,2026-11-17 用户口径「默认卡在未分类上就行」); + // 脏值(非数字分组、非法日期)同罪不下发。 const blank = toJdProductListParams(createJdProductFilterState(), 1, 20) - assert.deepEqual(blank, { page: 1, page_size: 20 }) + assert.deepEqual(blank, { page: 1, page_size: 20, classified: false }, + '出厂默认必须带 classified:false——首屏就卡未分类,不是全量') assert.equal('group_id' in blank, false, 'groupId 空串不带 group_id') assert.equal('owner_group_id' in blank, false, '没传当前分组就不带 owner_group_id(后端按作用域默认组取)') const dirty = toJdProductListParams( @@ -108,23 +110,23 @@ test('京东列表参数——page 钳制防 (page-1)*page_size 溢出(铁律 assert.equal(offset, 999_900) }) -/** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」): - * 只认 'classified'/'ungrouped' 两档显式值,映射成布尔 `classified`;''/缺省/脏值不下发。 +/** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」,同日收敛 + * 「不需要全部分类 默认卡在未分类上就行」):界面两档,'classified'→true、'ungrouped'→false; + * 出厂默认与「重置」都卡 ungrouped。''/缺省/脏值=「全部」仍是序列化出口的兜底语义 + * (不拿脏值冒充档位),但界面不再提供这一档。 * 参数名是新档 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 与当前分组成对下发(后端按组判已/未分类)') - const no = toJdProductListParams({ ...createJdProductFilterState(), classified: 'ungrouped' }, 1, 20) - assert.equal(no.classified, false, '未分类档必须下发 false——缺省不下发=全部,两者语义不同') + assert.equal(createJdProductFilterState().classified, 'ungrouped', + '出厂态与重置都必须卡未分类档(用户口径:默认卡在未分类上)') 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)} 按「全部」处理,不拿脏值冒充档位`) + assert.equal('classified' in q, false, `classified=${String(blank)} 按「全部」兜底处理,不拿脏值冒充档位`) } - assert.deepEqual(toJdProductListParams(createJdProductFilterState(), 1, 20), { page: 1, page_size: 20 }, - '出厂空态不带 classified(重置回全部)') }) test('详情解析——attrGroups/images 结构化解析(snake 容错、缺 url 弃行)', () => { diff --git a/admin-frontend-vue/tests/mount/jd-database-page.mount.test.ts b/admin-frontend-vue/tests/mount/jd-database-page.mount.test.ts index 6d9698d84..486c1457d 100644 --- a/admin-frontend-vue/tests/mount/jd-database-page.mount.test.ts +++ b/admin-frontend-vue/tests/mount/jd-database-page.mount.test.ts @@ -262,31 +262,30 @@ describe('批量编辑分类(店铺分类弹窗 2026-11-17 下线后的替代 }) }) -/** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选,快速筛出未分类和已分类的数据」): - * 工具栏「全部分类」旁新增「筛选分类状态」下拉(全部状态/已分类/未分类),选中即查重回第一页; +/** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」+同日收敛 + * 「不需要全部分类 默认卡在未分类上就行」):工具栏「筛选分类状态」下拉只有两档 + * (已分类/未分类),出厂默认与「重置」都卡未分类;选中即查重回第一页; * 页面发的是筛选态字符串(classified/ungrouped),布尔换算收在 jd-product-filter 单一出口 - * (纯测试钉形状);重置回出厂空态不带档位。 */ -describe('分类状态快筛(已分类/未分类)', () => { - it('下拉三档在册;选「未分类」按 classified="ungrouped" 重查且回第一页', async () => { + * (纯测试钉形状)。 */ +describe('分类状态快筛(两档,默认卡未分类)', () => { + it('下拉只有两档且首屏就卡「未分类」(classified="ungrouped" 随首取下发)', async () => { const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 }) - expect(optionLabels(wrapper, '筛选分类状态')).toEqual(['全部状态', '已分类', '未分类']) - const callsBefore = jdApi.fetchJdProductList.mock.calls.length - await pickSelectOption(wrapper, '筛选分类状态', '未分类') - expect(jdApi.fetchJdProductList.mock.calls.length).toBe(callsBefore + 1, '选中即查重取列表') - expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0]).toMatchObject( - { classified: 'ungrouped', page: 1 }, '未分类档下发 ungrouped 态并回第一页') + expect(optionLabels(wrapper, '筛选分类状态')).toEqual(['已分类', '未分类']) + expect(jdApi.fetchJdProductList.mock.calls[0][0].classified).toBe('ungrouped', + '首屏默认档=未分类——用户口径「默认卡在未分类上就行」') wrapper.unmount() }) - it('选「已分类」下发 classified 态;「重置」回出厂空态重查不带档位', async () => { + it('选「已分类」下发 classified 态;「重置」不放开筛选,而是回默认未分类档', async () => { const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 20 }) await pickSelectOption(wrapper, '筛选分类状态', '已分类') expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0].classified).toBe('classified') + expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0]).toMatchObject({ page: 1 }, '选中即查回第一页') await wrapper.findAll('button').find((b) => b.text() === '重置')!.trigger('click') await flushPromises() - expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0].classified).toBe('', - '重置把筛选面回出厂空态(全部),不残留档位') + expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0].classified).toBe('ungrouped', + '重置回出厂默认档(未分类),界面没有「全部」这一档可回') wrapper.unmount() }) })