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()
})
})