From 6dc33ea7255dd0b30e1c0b98efee8f79b58f9039 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Tue, 17 Nov 2026 18:06:14 +0800 Subject: [PATCH] =?UTF-8?q?feat(jd):=20=E5=88=86=E7=B1=BB=E7=8A=B6?= =?UTF-8?q?=E6=80=81=E5=BF=AB=E7=AD=9B=E6=8C=89=E7=94=A8=E6=88=B7=E5=8F=A3?= =?UTF-8?q?=E5=BE=84=E6=94=B6=E6=95=9B=E4=B8=BA=E4=B8=A4=E6=A1=A3=E9=BB=98?= =?UTF-8?q?=E8=AE=A4=E5=8D=A1=E6=9C=AA=E5=88=86=E7=B1=BB=E2=80=94=E2=80=94?= =?UTF-8?q?=E5=8E=BB=E6=8E=89=E3=80=8C=E5=85=A8=E9=83=A8=E7=8A=B6=E6=80=81?= =?UTF-8?q?=E3=80=8D=E9=80=89=E9=A1=B9=EF=BC=88=E7=95=8C=E9=9D=A2=E4=B8=8D?= =?UTF-8?q?=E5=86=8D=E6=8F=90=E4=BE=9B=E5=85=A8=E9=87=8F=E6=A1=A3=EF=BC=89?= =?UTF-8?q?=EF=BC=8C=E5=87=BA=E5=8E=82=E6=80=81/=E9=87=8D=E7=BD=AE?= =?UTF-8?q?=E9=83=BD=E5=9B=9E=20ungrouped=EF=BC=88JD=5FPRODUCT=5FDEFAULT?= =?UTF-8?q?=5FCLASSIFIED=20=E5=8D=95=E4=B8=80=E5=87=BA=E5=A4=84=EF=BC=89?= =?UTF-8?q?=EF=BC=9B=E7=AD=9B=E9=80=89=E6=BF=80=E6=B4=BB=E5=88=A4=E5=AE=9A?= =?UTF-8?q?=E6=94=B9=E4=B8=BA=E3=80=8C=E5=81=8F=E7=A6=BB=E9=BB=98=E8=AE=A4?= =?UTF-8?q?=E6=A1=A3=E6=89=8D=E7=AE=97=E6=BF=80=E6=B4=BB=E3=80=8D=E5=85=8D?= =?UTF-8?q?=E5=BE=97=E9=A6=96=E5=B1=8F=E6=B0=B8=E8=BF=9C=E5=A4=84=E4=BA=8E?= =?UTF-8?q?=E6=9C=89=E7=AD=9B=E9=80=89=E7=8A=B6=E6=80=81=EF=BC=9B=E5=88=A4?= =?UTF-8?q?=E6=8D=AE=EF=BC=9A=E7=BA=AF=E6=B5=8B=E8=AF=95=E9=BB=98=E8=AE=A4?= =?UTF-8?q?=E6=A1=A3=20classified:false=20=E4=B8=8B=E5=8F=91=EF=BC=8B?= =?UTF-8?q?=E9=BB=98=E8=AE=A4=E6=BF=80=E6=B4=BB=20false=E3=80=81=E6=8C=82?= =?UTF-8?q?=E8=BD=BD=E4=B8=A4=E6=A1=A3=E4=B8=8B=E6=8B=89=E5=9C=A8=E5=86=8C?= =?UTF-8?q?=EF=BC=8B=E9=A6=96=E5=B1=8F=E5=8D=B3=20ungrouped=EF=BC=8B?= =?UTF-8?q?=E9=87=8D=E7=BD=AE=E5=9B=9E=E6=9C=AA=E5=88=86=E7=B1=BB=E4=B8=8D?= =?UTF-8?q?=E6=94=BE=E5=BC=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../src/pages/jd/JdDatabasePage.vue | 10 +++---- .../src/pages/jd/jd-product-filter.ts | 18 +++++++++---- .../tests/jd-product-group.test.ts | 22 ++++++++------- .../mount/jd-database-page.mount.test.ts | 27 +++++++++---------- 4 files changed, 43 insertions(+), 34 deletions(-) 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() }) })