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