feat(jd): 分类状态快筛按用户口径收敛为两档默认卡未分类——去掉「全部状态」选项(界面不再提供全量档),出厂态/重置都回 ungrouped(JD_PRODUCT_DEFAULT_CLASSIFIED 单一出处);筛选激活判定改为「偏离默认档才算激活」免得首屏永远处于有筛选状态;判据:纯测试默认档 classified:false 下发+默认激活 false、挂载两档下拉在册+首屏即 ungrouped+重置回未分类不放开

This commit is contained in:
2026-11-17 18:06:14 +08:00
parent b4e97823f4
commit 6dc33ea725
4 changed files with 43 additions and 34 deletions
@@ -418,17 +418,17 @@ onMounted(async () => {
<el-option label="全部分类" value="" />
<el-option v-for="group in groupOptions" :key="group.id" :label="group.name" :value="String(group.id)" />
</el-select>
<!-- 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选,快速筛出未分类和已分类的数据」):
已分类=当前分组下有分类(V203 归属表,与列表分类列同形——筛"未分类"的行分类列必显示未分类);
选中即查(回第一页),与「全部分类」下拉同壳同语义(value='' 行=回全量出口)。 -->
<!-- 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」+同日收敛
「不需要全部分类 默认卡在未分类上就行」):已分类=当前分组下有分类
(V203 归属表,与列表分类列同形——筛"未分类"的行分类列必显示未分类);
两档下拉、出厂默认卡「未分类」,选中即查(回第一页);「重置」也回未分类档。 -->
<el-select
v-model="filter.classified"
class="admin-filter"
placeholder="全部状态"
placeholder="未分类"
aria-label="筛选分类状态"
@change="apply"
>
<el-option label="全部状态" value="" />
<el-option label="已分类" value="classified" />
<el-option label="未分类" value="ungrouped" />
</el-select>
@@ -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
}
@@ -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 弃行)', () => {
@@ -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()
})
})