From 3702c83c60922aa82a23e101e1014128dbd97c17 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Sat, 21 Nov 2026 03:56:11 +0800 Subject: [PATCH] =?UTF-8?q?feat(phase-2):=20=E4=BA=AC=E4=B8=9C=E6=95=B0?= =?UTF-8?q?=E6=8D=AE=E5=BA=93=E4=BE=A7=E6=A0=8F=E7=BB=84=E4=BB=B6=E2=80=94?= =?UTF-8?q?=E2=80=94=E5=95=86=E5=93=81=E7=9B=AE=E5=BD=95=E6=A0=91=E8=AE=A1?= =?UTF-8?q?=E6=95=B0=E5=BE=BD=E6=A0=87/=E6=A0=91=E5=A4=96=E5=85=9C?= =?UTF-8?q?=E5=BA=95=EF=BC=8B=E5=BA=97=E9=93=BA=E5=88=86=E7=B1=BB=E5=8F=8C?= =?UTF-8?q?=20Tab=EF=BC=88additive=EF=BC=8C=E9=A1=B5=E9=9D=A2=20Phase=205?= =?UTF-8?q?=20=E6=8E=A5=E7=BA=BF=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../src/pages/jd/JdCategorySidebar.vue | 450 ++++++++++++++++++ .../mount/jd-category-sidebar.mount.test.ts | 233 +++++++++ 2 files changed, 683 insertions(+) create mode 100644 admin-frontend-vue/src/pages/jd/JdCategorySidebar.vue create mode 100644 admin-frontend-vue/tests/mount/jd-category-sidebar.mount.test.ts diff --git a/admin-frontend-vue/src/pages/jd/JdCategorySidebar.vue b/admin-frontend-vue/src/pages/jd/JdCategorySidebar.vue new file mode 100644 index 000000000..647c7eb2c --- /dev/null +++ b/admin-frontend-vue/src/pages/jd/JdCategorySidebar.vue @@ -0,0 +1,450 @@ + + + + + diff --git a/admin-frontend-vue/tests/mount/jd-category-sidebar.mount.test.ts b/admin-frontend-vue/tests/mount/jd-category-sidebar.mount.test.ts new file mode 100644 index 000000000..6c9495f66 --- /dev/null +++ b/admin-frontend-vue/tests/mount/jd-category-sidebar.mount.test.ts @@ -0,0 +1,233 @@ +/** + * 京东数据库侧栏(JdCategorySidebar,v1.6 蓝图 Phase 2)的挂载契约。 + * + * 纯展示组件:取数与失败兜底全在页面(props 流入、emit 流出),本文件零 api mock—— + * 钉的是「徽标数=点节点后列表命中的行数」(jdCategoryCountTree 同源)、双 Tab 切换、 + * 点节点 emit 形状(树内带路径/树外兜底 path 空/全部商品 null)、可写档分档入口。 + * + * 跑法:`npx vitest run tests/mount/jd-category-sidebar.mount.test.ts` + */ +import { beforeEach, describe, expect, it } from 'vitest' +import { flushPromises, mount, type VueWrapper } from '@vue/test-utils' + +import JdCategorySidebar from '@/pages/jd/JdCategorySidebar.vue' + +import type { JdProductCategoryOption, JdProductGroup } from '@/pages/jd/jd-product-api.ts' + +/** 类目计数夹具:树内名(连衣裙支+同名跨支短裤)+树外历史名,读数与 Phase 1 + * 纯函数测试同源——服饰内衣根徽标 20(子树去重)、全部商品 37、兜底 12。 */ +const CATEGORY_OPTIONS: JdProductCategoryOption[] = [ + { name: '连衣裙', productCount: 7 }, + { name: '短袖连衣裙', productCount: 4 }, + { name: '艺考形体服', productCount: 5 }, + { name: '短裤', productCount: 9 }, + { name: '已下架历史类目', productCount: 12 }, +] + +const CATEGORIES: JdProductGroup[] = [ + { id: 7, name: '裙装', ownerGroupId: 11, sortOrder: 0, productCount: 3 }, + { id: 8, name: '裤装', ownerGroupId: 11, sortOrder: 1, productCount: 1 }, +] + +interface MountOptions { + editable?: boolean + selectedCategory?: { name: string; path: string[] } | null + selectedGroupId?: number | null +} + +function mountSidebar(options: MountOptions = {}): VueWrapper { + return mount(JdCategorySidebar, { + props: { + categoryOptions: CATEGORY_OPTIONS, + categories: CATEGORIES, + editable: options.editable ?? true, + selectedCategory: options.selectedCategory ?? null, + selectedGroupId: options.selectedGroupId ?? null, + }, + }) +} + +/** 在指定 Tab 体内按文案找行(两个 Tab 体 v-show 共存于 DOM,必须先圈定范围)。 */ +function rowByText(scope: VueWrapper, text: string) { + const row = scope.findAll('.jd-side-row').find((node) => node.text().includes(text)) + expect(row, `应存在文案含「${text}」的侧栏行`).toBeTruthy() + return row! +} + +beforeEach(() => { + // 纯展示组件无副作用;占位保持与页面 mount 测试同构。 +}) + +describe('商品目录 Tab(京麦授权类目树+计数徽标)', () => { + it('出厂停在商品目录 Tab;徽标与 Phase 1 聚合同源(根=子树去重和、全部商品=计数行总和)', () => { + const wrapper = mountSidebar() + const catalog = wrapper.get('.jd-side-catalog') + const all = catalog.get('.jd-side-all') + expect(all.text()).toContain('全部商品') + expect(all.text()).toContain('37', '全部商品徽标=5 条计数行求和(7+4+5+9+12)') + expect(rowByText(catalog, '服饰内衣').text()).toContain('20', + '服饰内衣根徽标=子树去重和(连衣裙7+短袖4+短裤9,短裤跨支同名只记一次)') + expect(rowByText(catalog, '母婴').text()).toContain('0', '无词条一级归 0 不缺节点') + expect(rowByText(catalog, '运动户外').text()).toContain('5') + wrapper.unmount() + }) + + it('一级默认展开(二级首屏可见);逐级展开后末级行点行 emit {name, path}', async () => { + const wrapper = mountSidebar() + const catalog = wrapper.get('.jd-side-catalog') + const women = rowByText(catalog, '女装') + expect(women.classes()).toContain('depth-1', '一级默认展开 ⇒ 二级行(depth-1 缩进)首屏可见') + // 末级艺考形体服在 depth-2:其父(舞蹈体操鞋服/装备)未展开时不可见。 + expect(catalog.findAll('.jd-side-row').some((node) => node.text().includes('艺考形体服'))).toBe(false) + await catalog.get('[aria-label="展开或收起 舞蹈体操鞋服/装备"]').trigger('click') + await flushPromises() + const yikao = rowByText(catalog, '艺考形体服') + expect(yikao.classes()).toContain('depth-2', '艺考形体服是 level 3(depth 2 缩进)') + await yikao.trigger('click') + await flushPromises() + expect(wrapper.emitted('select-category')).toEqual([[{ name: '艺考形体服', path: ['运动户外', '舞蹈体操鞋服/装备', '艺考形体服'] }]]) + wrapper.unmount() + }) + + it('点二级节点 emit 完整路径(页面按子树展开 IN);箭头只折展不选中', async () => { + const wrapper = mountSidebar() + const catalog = wrapper.get('.jd-side-catalog') + // 女装行未展开时,其子行(连衣裙)不可见。 + expect(catalog.findAll('.jd-side-row').some((node) => node.text().includes('连衣裙'))).toBe(false) + const women = rowByText(catalog, '女装') + await women.trigger('click') + await flushPromises() + expect(wrapper.emitted('select-category')).toEqual([[{ name: '女装', path: ['服饰内衣', '女装'] }]], + '点行=选中即筛,emit 完整名称路径') + // 点行顺手展开(下钻感):子行现在可见。 + expect(wrapper.emitted('select-category')).toHaveLength(1) + expect(catalog.findAll('.jd-side-row').some((node) => node.text().includes('连衣裙'))).toBe(true, + '非末级行点行后展开子级') + + // 箭头(role=button, aria-label)只折展:点它不得触发 select-category。 + const before = wrapper.emitted('select-category')?.length ?? 0 + await catalog.get('[aria-label="展开或收起 女装"]').trigger('click') + await flushPromises() + expect(wrapper.emitted('select-category')?.length).toBe(before, '箭头点击不选中(click.stop 防冒泡)') + expect(catalog.findAll('.jd-side-row').some((node) => node.text().includes('连衣裙'))).toBe(false, + '再点箭头=收起(子行隐藏)') + wrapper.unmount() + }) + + it('「全部商品」行 emit null(页面清类目筛选重查);挂载即带选中态时祖先自动展开并高亮', async () => { + const wrapper = mountSidebar({ selectedCategory: { name: '连衣裙', path: ['服饰内衣', '女装', '连衣裙'] } }) + const catalog = wrapper.get('.jd-side-catalog') + const dress = rowByText(catalog, '连衣裙') + expect(dress.classes()).toContain('selected', '外部选中态回显高亮') + expect(dress.classes()).toContain('depth-2', '挂载即带选中 ⇒ watch immediate 展开祖先(女装已展开,行可见)') + + await wrapper.setProps({ selectedCategory: null }) + expect(catalog.get('.jd-side-all').classes()).toContain('selected', 'null=全部商品高亮') + await catalog.get('.jd-side-all').trigger('click') + await flushPromises() + expect(wrapper.emitted('select-category')).toEqual([[null]], '点全部商品=清选') + wrapper.unmount() + }) +}) + +describe('树外兜底组(树上对不上的历史行,单名等值出口)', () => { + it('兜底组头渲染计数和=extraTotal;行点击 emit {name, path:[]}(页面按单名等值回落)', async () => { + const wrapper = mountSidebar() + const catalog = wrapper.get('.jd-side-catalog') + const head = catalog.get('.jd-side-extra-head') + expect(head.text()).toContain('树外兜底') + expect(head.text()).toContain('12', '兜底组头徽标=extraTotal(历史行求和)') + const extra = rowByText(catalog, '已下架历史类目') + await extra.trigger('click') + await flushPromises() + expect(wrapper.emitted('select-category')).toEqual([[{ name: '已下架历史类目', path: [] }]], + '树外名 path 空数组=无路径序列化(单名等值旧形状,不静默丢筛选)') + wrapper.unmount() + }) + + it('全部是树内名时兜底组整体不渲染(不占一条空组)', () => { + const wrapper = mount(JdCategorySidebar, { + props: { + categoryOptions: [{ name: '连衣裙', productCount: 7 }], + categories: CATEGORIES, + editable: true, + selectedCategory: null, + selectedGroupId: null, + }, + }) + expect(wrapper.find('.jd-side-extra').exists()).toBe(false) + wrapper.unmount() + }) +}) + +describe('店铺分类 Tab(当前分组分类平铺+入口分档)', () => { + it('点店铺分类切 Tab;分类行带计数;点行 emit id、再点已选中的 emit null(toggle 清选)', async () => { + const wrapper = mountSidebar() + const tabs = wrapper.findAll('.jd-sidebar-tab') + expect(tabs.map((tab) => tab.text())).toEqual(['商品目录', '店铺分类']) + await tabs[1]!.trigger('click') + await flushPromises() + expect(tabs[1]!.classes()).toContain('active') + + const custom = wrapper.get('.jd-side-custom') + const skirt = rowByText(custom, '裙装') + expect(skirt.text()).toContain('3', '分类行计数徽标') + await skirt.trigger('click') + await flushPromises() + expect(wrapper.emitted('select-group')).toEqual([[7]]) + await wrapper.setProps({ selectedGroupId: 7 }) + expect(rowByText(custom, '裙装').classes()).toContain('selected', '选中态回显') + await rowByText(custom, '裙装').trigger('click') + await flushPromises() + expect(wrapper.emitted('select-group')?.at(-1)).toEqual([null], '再点已选中=清选回全部分类') + wrapper.unmount() + }) + + it('可写档出「新建分类」行:emit 分类名并清输入,空名按钮置灰;只读档不渲染该行', async () => { + const editable = mountSidebar({ editable: true }) + const custom = editable.get('.jd-side-custom') + const input = custom.get('[aria-label="新分类名称"]') + const createBtn = custom.findAll('button').find((b) => b.text() === '新建分类')! + expect(createBtn.attributes('disabled')).toBeDefined() + await input.setValue('上新区') + await createBtn.trigger('click') + await flushPromises() + expect(editable.emitted('create-category')).toEqual([['上新区']], + '侧栏只 emit,建分类的 API 调用与刷新在页面(Phase 5 接线)') + expect((input.element as HTMLInputElement).value).toBe('', '提交即清输入') + await input.setValue(' ') + expect(createBtn.attributes('disabled')).toBeDefined(), '纯空白名按钮置灰' + editable.unmount() + + const readonly = mountSidebar({ editable: false }) + expect(readonly.get('.jd-side-custom').find('[aria-label="新分类名称"]').exists()).toBe(false, + '只读档不渲染新建行') + readonly.unmount() + }) + + it('「分类管理」入口对所有人渲染(同组普通号只读可看 V203),点击 emit manage-categories', async () => { + for (const editable of [true, false]) { + const wrapper = mountSidebar({ editable }) + const manage = wrapper.get('.jd-side-custom').get('.jd-side-manage') + expect(manage.text()).toBe('分类管理') + await manage.trigger('click') + await flushPromises() + expect(wrapper.emitted('manage-categories')).toHaveLength(1) + wrapper.unmount() + } + }) + + it('空分类空态文案分档:可写档引导新建,只读档直说', () => { + const writable = mount(JdCategorySidebar, { + props: { categoryOptions: [], categories: [], editable: true, selectedCategory: null, selectedGroupId: null }, + }) + expect(writable.get('.jd-side-empty').text()).toBe('本组暂无分类,先新建一个') + writable.unmount() + + const readonly = mount(JdCategorySidebar, { + props: { categoryOptions: [], categories: [], editable: false, selectedCategory: null, selectedGroupId: null }, + }) + expect(readonly.get('.jd-side-empty').text()).toBe('本组暂无分类') + readonly.unmount() + }) +})