feat(jd-database): v1.7 前端骨架——合并搜索+筛选弹层+回显条+自绘分页条+已选条

This commit is contained in:
2026-11-21 16:30:35 +08:00
parent 085c285446
commit 6685491fcb
6 changed files with 837 additions and 169 deletions
@@ -1,15 +1,20 @@
<script setup lang="ts">
/** 京东公共商品库(v1.6 蓝图 Phase 5 重写装配:侧栏+卡片网格+居中详情弹窗)。
* V203(2026-11-16 用户口径):分类按「数据权限分组」隔离——不同组看不到彼此的分类,
* 能看多组的人用筛选行「分组」下拉切换当前组(只有一组时锁定显示)。
* 能看多组的人用「分组」下拉切换当前组(只有一组时锁定显示)。
* 2026-11-17 用户口径:店铺分类弹窗下线,工具栏「归入分类」——勾选商品(翻页累计记忆)
* 后选目标分类归入或取消归属;建/改名/删分类收进侧栏「分类管理」对话框(带名称搜索)。
* v1.6 形态(2026-11-21 蓝图):类目筛选(京麦授权类目树+计数徽标+树外兜底)与店铺
* 分类平铺收进左侧栏 JdCategorySidebar;列表改卡片网格 JdProductCard(商城款式);
* 详情由侧滑抽屉改居中弹窗 JdProductDetailModal(Phase 4 壳,行级编辑/删除入口随
* 操作列下线收进弹窗顶部动作区)。旧表格/级联面板/详情抽屉三件随本 Phase 退役。
* 2026-11-21 用户口径「放到上面筛选框」红框整体上移:筛选行+批量按钮条离开主面板,
* 提到页面最顶(操作提示条正下方、通栏整行拉通);主面板只剩卡片网格与分页。 */
* v1.7(2026-11-21 对齐原型《商品数据商城》):
* ① 搜索合并——顶部单搜索框(商品编码 OR 标题,OR 语义在后端 SQL;旧两框退役),
* Enter 查询、× 清除即查;
* ② 筛选收弹层——「筛选」按钮下方浮层(价格区间+同步起止+重置/应用),分组下拉与
* 归属三档保留顶部(v1.6 用户口径的两件保留不动);
* ③ 筛选回显条——主面板顶部条件芯片(类目/分类/店铺/价格/同步区间+共 N 条+清除筛选,
* 清除保留分组作用域),无激活筛选不渲染;
* ④ 顶部分页——「第 X/Y 页 · 共 N 条」+首页/上一页/刷新/下一页/末页+档位
* 50/100/200/500/1000(与后端 MAX_PAGE_SIZE=1000 逐字同步),底部 OldPagination 从本页
* 撤下(组件本体不动,他页在用);
* ⑤ 底部已选条——主面板底部常驻「已选 N 件」悬浮条(能勾选的档才渲染)。 */
import { computed, onMounted, reactive, ref } from 'vue'
import {
batchAssignJdProductGroup,
@@ -23,7 +28,12 @@ import {
type JdProductCategoryOption,
type JdProductGroup,
} from './jd-product-api.ts'
import { createJdProductFilterState, JD_PRODUCT_PAGE_SIZE_OPTIONS } from './jd-product-filter.ts'
import {
createJdProductFilterState,
finitePriceOrNull,
jdProductFilterActive,
JD_PRODUCT_PAGE_SIZE_OPTIONS,
} from './jd-product-filter.ts'
import { JD_PRODUCT_DEFAULT_SIZE, type JdProductItem } from './jd-product-model.ts'
import JdCategorySidebar from './JdCategorySidebar.vue'
import JdProductCard from './JdProductCard.vue'
@@ -31,7 +41,6 @@ import JdProductDetailModal from './JdProductDetailModal.vue'
import JdProductEditDrawer from './JdProductEditDrawer.vue'
import JdBatchAssignDialog from './JdBatchAssignDialog.vue'
import JdCategoryManageDialog from './JdCategoryManageDialog.vue'
import OldPagination from '@/components/OldPagination.vue'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
import { openAdminConfirm } from '@/components/admin-confirm'
import { loadFailureMessage } from '@/components/load-failure-model'
@@ -46,7 +55,7 @@ import { orderedPair } from '@/utils/datetime'
* 由 scope 的每组 editable 决定(本组管理员/公司超管/平台超管),与本档无关。 */
const session = useAdminSessionStore()
const canWriteProducts = computed(() => isAdminRole(session.user?.role))
/** 分组筛选(同日用户口径「超管可以有分组筛选,管理员及以下则没有」):筛选行「分组」控件
/** 分组筛选(同日用户口径「超管可以有分组筛选,管理员及以下则没有」):顶部「分组」控件
* (下拉+单组锁定芯片)只对超管档(超级管理员/公司超级管理员)渲染;管理员及以下
* 不出现,其分类面固定落在作用域默认分组上。 */
const canFilterGroup = computed(() => session.isSuperAdmin || isCompanySuperAdminRole(session.user?.role))
@@ -56,7 +65,7 @@ const loadFailure = ref('')
const rows = ref<JdProductItem[]>([])
const total = ref(0)
const page = ref(1)
/** 每页条数默认 50(v1.6 Phase 1 新契约),档位 20/50/100 收敛在 filter 层单一出处。 */
/** 每页条数默认 50(v1.6 Phase 1 新契约),档位 50/100/200/500/1000(v1.7)收敛在 filter 层单一出处。 */
const pageSize = ref(JD_PRODUCT_DEFAULT_SIZE)
const filter = reactive(createJdProductFilterState())
/** 分类作用域(V203):可见分组 + 每组可写标记。失败静默回空作用域(分类面全空但商品照常)。 */
@@ -79,10 +88,13 @@ const batchEditVisible = ref(false)
/** 分类管理对话框(2026-11-17 第二刀:独立子菜单页并进来,建/改名/删+搜索)。 */
const manageVisible = ref(false)
/** 行级编辑抽屉(2026-11-15 用户口径「每一条数据后面 需要编辑或者删除」):入口随操作列
* 下线收进详情弹窗顶部动作区(Phase 4 Modal emit edit),删除走 removeOne 同一条链。 */
* 下线收进详情弹窗顶部动作区(Modal emit edit),删除走 removeOne 同一条链。 */
const editItem = ref<JdProductItem | null>(null)
const editVisible = ref(false)
/** 筛选弹层(v1.7 对齐原型):「筛选」按钮下方浮层,价格区间+同步起止+重置/应用。 */
const filterPopVisible = ref(false)
/** 当前分组的下拉项(带 editable)——分类写入口与侧栏新建分类行的可写档都读它。 */
const currentGroupOption = computed<JdCategoryGroupOption | null>(() =>
categoryScope.value.find((group) => group.id === ownerGroupId.value) || null)
@@ -104,6 +116,35 @@ const selectedGroupIdNum = computed(() => {
return Number.isFinite(id) && id > 0 ? id : null
})
/** 是否有任一激活筛选条件(回显条渲染判据;分组作用域不在判定里)。 */
const filterActive = computed(() => jdProductFilterActive(filter))
/** 回显条芯片(v1.7 对齐原型):类目/分类/店铺/价格区间/同步区间/归属档,各带人话前缀;
* 归属三档只回显偏离出厂默认(未分类)的档位——默认档不是激活筛选。 */
const activeFilterChips = computed(() => {
const chips: { key: string; label: string }[] = []
const keyword = (filter.keyword || '').trim()
if (keyword) chips.push({ key: 'keyword', label: `搜索:${keyword}` })
if ((filter.category || '').trim()) chips.push({ key: 'category', label: `类目:${filter.category}` })
const shopName = (filter.shopName || '').trim()
if (shopName) chips.push({ key: 'shop', label: `店铺:${shopName}` })
if ((filter.groupId || '').trim()) {
const group = groupOptions.value.find((option) => String(option.id) === filter.groupId)
chips.push({ key: 'group', label: `分类:${group?.name || filter.groupId}` })
}
if (filter.classified === 'classified') chips.push({ key: 'classified', label: '已分类' })
else if (filter.classified === '') chips.push({ key: 'classified', label: '全部分类状态' })
const minPrice = finitePriceOrNull(filter.minPrice)
const maxPrice = finitePriceOrNull(filter.maxPrice)
if (minPrice != null || maxPrice != null) {
chips.push({ key: 'price', label: `价格:${minPrice ?? ''} ~ ${maxPrice ?? ''}` })
}
if (filter.syncedFrom || filter.syncedTo) {
chips.push({ key: 'synced', label: `同步:${filter.syncedFrom || '…'} ~ ${filter.syncedTo || '…'}` })
}
return chips
})
/** 侧栏选类目:树内节点带完整路径(序列化按子树展开 IN 下发)、树外兜底名 path 空=
* 单名等值旧形状;null=「全部商品」清选重查。选中即查(回第一页)。 */
function onSelectCategory(value: { name: string; path: string[] } | null): void {
@@ -137,6 +178,35 @@ function clampJdSyncedRange(): void {
filter.syncedTo = e
}
function toggleFilterPopover(): void {
filterPopVisible.value = !filterPopVisible.value
}
/** 清除搜索词(× 即查):空词不重发(首屏没搜过就别白发一条)。 */
function clearKeyword(): void {
if (!filter.keyword) return
filter.keyword = ''
apply()
}
/** 弹层「应用」:价格倒挡先在门口挡住(后端同文案兜底),过了才关弹层查询。 */
function applyFromPopover(): void {
const minPrice = finitePriceOrNull(filter.minPrice)
const maxPrice = finitePriceOrNull(filter.maxPrice)
if (minPrice != null && maxPrice != null && minPrice > maxPrice) {
showAdminFeedback('价格区间最小值不能大于最大值', 'error')
return
}
filterPopVisible.value = false
apply()
}
/** 弹层「重置」:筛选面回出厂空态并查询(与回显条「清除筛选」同一条链,保留分组作用域)。 */
function resetFromPopover(): void {
filterPopVisible.value = false
reset()
}
const totalPages = computed(() => Math.max(1, Math.ceil(total.value / pageSize.value)))
/** 作用域 → 分组列表 → 该组分类:失败一律静默降级(分类只是筛选/归类面,不拦首屏行集)。 */
@@ -250,12 +320,14 @@ async function load(): Promise<void> {
const result = await fetchJdProductList({
page: page.value,
pageSize: pageSize.value,
productCode: filter.productCode,
titleKeyword: filter.titleKeyword,
keyword: filter.keyword,
category: filter.category,
categoryPath: filter.categoryPath,
shopName: filter.shopName,
groupId: filter.groupId,
classified: filter.classified,
minPrice: filter.minPrice,
maxPrice: filter.maxPrice,
ownerGroupId: ownerGroupId.value,
syncedFrom: filter.syncedFrom,
syncedTo: filter.syncedTo,
@@ -279,7 +351,9 @@ function apply(): void {
void load()
}
/** 重置:筛选面回出厂空态(类目/分类选中随 filter 回空=侧栏高亮自动清),回第一页重取。 */
/** 重置:筛选面回出厂空态(搜索词/类目/店铺/价格/日期随 filter 回空=侧栏高亮自动清,
* 归属三档回默认未分类档),回第一页重取;分组作用域(ownerGroupId)不在 filter 里,
* 天然保留(AC-4)。 */
function reset(): void {
Object.assign(filter, createJdProductFilterState())
page.value = 1
@@ -292,6 +366,15 @@ function changePage(next: number): void {
void load()
}
/** 顶部分页(v1.7 对齐原型):首/末页按钮复用 changePage 的边界检查(越界页码静默忽略)。 */
function goFirstPage(): void {
changePage(1)
}
function goLastPage(): void {
changePage(totalPages.value)
}
function changeSize(size: number) {
pageSize.value = size
page.value = 1
@@ -320,7 +403,7 @@ async function copyProductCode(row: JdProductItem): Promise<void> {
}
}
/** 详情弹窗顶部「编辑/删除」(Phase 4 emit):先关弹窗再走既有链,与旧操作列同源。 */
/** 详情弹窗顶部「编辑/删除」(Modal emit):先关弹窗再走既有链,与旧操作列同源。 */
function onDetailEdit(): void {
const item = detailItem.value
closeDetail()
@@ -422,18 +505,89 @@ onMounted(async () => {
<template>
<div class="jd-database-view">
<!-- 顶部通栏面板(2026-11-21 用户口径「放到上面筛选框」红框整体上移):筛选行+
批量按钮条离开右侧主面板,提到页面最顶(操作提示条正下方、通栏整行拉通)——
通栏宽度下字段不再折行,侧栏与卡片网格整排下移;主面板只剩网格与分页。 -->
<!-- 顶部通栏面板(2026-11-21 用户口径「放到上面筛选框」红框整体上移+同日 v1.7 对齐
原型):单搜索框+筛选弹层+分组下拉+归属三档住通栏整行;批量按钮条随筛选行
留在顶部通栏(红框上移口径不动)。主面板只剩回显条+卡片网格+分页条+已选条。 -->
<section class="panel-box jd-top-panel">
<div class="jd-filter-row">
<div class="form-group">
<label>商品编码</label>
<input v-model="filter.productCode" type="text" placeholder="输入商品编码" @keyup.enter="apply" />
<!-- 合并搜索(v1.7 对齐原型):一个框同时搜商品编码与标题(OR 语义在后端 SQL,
前端不拆词);Enter 查询;有词时出 × 清除按钮(清除即查)。 -->
<div class="jd-search-wrap">
<input
v-model="filter.keyword"
class="jd-search-input"
type="text"
placeholder="搜索商品编码或标题"
aria-label="搜索商品"
@keyup.enter="apply"
/>
<button
v-if="filter.keyword"
class="jd-search-clear"
type="button"
aria-label="清除搜索"
@click="clearKeyword"
>×</button>
</div>
<div class="form-group">
<label>标题关键字</label>
<input v-model="filter.titleKeyword" type="text" placeholder="输入标题关键字" @keyup.enter="apply" />
<!-- 筛选弹层(v1.7 对齐原型):低频条件(价格区间+同步起止)收进按钮下方浮层,
重置/应用在浮层底部;常驻的分组下拉与归属三档留在搜索行(v1.6 用户口径保留件)。 -->
<div class="jd-filter-anchor">
<button
class="btn btn-secondary"
type="button"
:class="{ 'jd-filter-open': filterPopVisible }"
@click="toggleFilterPopover"
>筛选</button>
<div v-if="filterPopVisible" class="jd-filter-popover">
<div class="jd-pop-row">
<label>价格区间</label>
<div class="jd-pop-fields">
<!-- 价格输入用 text+inputmode(不用 type=number):Vue 的 v-model 对
type=number 会 looseToNumber 把 state 写成数字,filter 契约(字符串
进、序列化层转 number)就断了;数字合法性由 finitePriceOrNull 在
序列化口收口,倒挡校验在「应用」门口。 -->
<input
v-model="filter.minPrice"
type="text"
inputmode="decimal"
placeholder="最低价"
aria-label="最低价格"
/>
<span class="jd-pop-sep">~</span>
<input
v-model="filter.maxPrice"
type="text"
inputmode="decimal"
placeholder="最高价"
aria-label="最高价格"
/>
</div>
</div>
<div class="jd-pop-row">
<label>同步日期</label>
<div class="jd-pop-fields">
<input
v-model="filter.syncedFrom"
type="date"
:max="filter.syncedTo"
aria-label="同步开始日期"
@change="clampJdSyncedRange"
/>
<span class="jd-pop-sep">~</span>
<input
v-model="filter.syncedTo"
type="date"
:min="filter.syncedFrom"
aria-label="同步结束日期"
@change="clampJdSyncedRange"
/>
</div>
</div>
<div class="jd-pop-actions">
<button class="btn btn-secondary" type="button" @click="resetFromPopover">重置</button>
<button class="btn" type="button" @click="applyFromPopover">应用</button>
</div>
</div>
</div>
<div v-if="canFilterGroup && categoryScope.length" class="form-group">
<label>分组</label>
@@ -454,18 +608,6 @@ onMounted(async () => {
</el-select>
<span v-else class="jd-group-locked" title="你的数据权限内只有这一个分组">{{ currentGroupName }}</span>
</div>
<div class="form-group">
<label>同步开始日期</label>
<input v-model="filter.syncedFrom" type="date" :max="filter.syncedTo" @change="clampJdSyncedRange" />
</div>
<div class="form-group">
<label>同步结束日期</label>
<input v-model="filter.syncedTo" type="date" :min="filter.syncedFrom" @change="clampJdSyncedRange" />
</div>
<div class="jd-filter-actions">
<button class="btn" type="button" @click="apply">查询</button>
<button class="btn btn-secondary" type="button" @click="reset">重置</button>
</div>
<!-- 归属三档快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」+同日收敛
「默认卡在未分类上就行」;2026-11-18 用户口径「加个全部选项」恢复全量档):
已分类=当前分组下有分类(V203 归属表,与侧栏分类选中同形);三档下拉、
@@ -541,6 +683,14 @@ onMounted(async () => {
<section class="panel-box jd-main-panel">
<LoadFailureBar v-if="loadFailure" :message="loadFailure" @retry="load" />
<!-- 筛选回显条(v1.7 F5 对齐原型):有激活筛选才渲染;芯片按当前筛选态逐条回显,
「共 N 条」给行集规模,「清除筛选」回出厂空态(保留分组作用域,AC-4)。 -->
<div v-if="filterActive" class="jd-filter-chips">
<span v-for="chip in activeFilterChips" :key="chip.key" class="jd-chip">{{ chip.label }}</span>
<span class="jd-chip-total">共 {{ total }} 条</span>
<button class="jd-chip-clear" type="button" @click="reset">清除筛选</button>
</div>
<!-- 卡片网格(v1.6):商城款式;卡片整体点击=开详情弹窗,勾选/复制 @click.stop 防冒泡。 -->
<div class="jd-card-grid">
<template v-if="rows.length">
@@ -559,15 +709,36 @@ onMounted(async () => {
<div v-else class="jd-empty-tip">暂无京东商品数据</div>
</div>
<!-- 每页条数档位 20/50/100(v1.6 Phase 1 契约)随分页条下发。 -->
<OldPagination
:total="total"
:page="page"
:page-size="pageSize"
:sizes="[...JD_PRODUCT_PAGE_SIZE_OPTIONS]"
@change="changePage"
@size-change="changeSize"
/>
<!-- 顶部分页条(v1.7 F4 对齐原型):「第 X/Y 页 · 共 N 条」+首页/上一页/刷新/
下一页/末页+每页条数档位(50/100/200/500/1000,与后端上限逐字同步)。
本页底部 OldPagination 随 v1.7 撤下(组件本体不动,他页在用)。 -->
<div class="jd-page-bar">
<span class="jd-page-info">第 {{ page }} / {{ totalPages }} 页 · 共 {{ total }} 条</span>
<div class="jd-page-btns">
<button class="jd-page-btn" type="button" :disabled="page <= 1" @click="goFirstPage">首页</button>
<button class="jd-page-btn" type="button" :disabled="page <= 1" @click="changePage(page - 1)">上一页</button>
<button class="jd-page-btn" type="button" aria-label="刷新列表" @click="load">刷新</button>
<button class="jd-page-btn" type="button" :disabled="page >= totalPages" @click="changePage(page + 1)">下一页</button>
<button class="jd-page-btn" type="button" :disabled="page >= totalPages" @click="goLastPage">末页</button>
</div>
<el-select
class="page-size-select"
:model-value="pageSize"
aria-label="每页条数"
@change="changeSize"
>
<el-option
v-for="size in JD_PRODUCT_PAGE_SIZE_OPTIONS"
:key="size"
:value="size"
:label="`${size}条/页`"
/>
</el-select>
</div>
<!-- 底部已选条(v1.7 F7 骨架):常驻悬浮(不随勾选数显隐);只对有勾选面的档渲染
(普通员工没有勾选框,已选恒 0 无意义)。 -->
<div v-if="hasSelection" class="jd-select-bar">已选 {{ selectedCount }} 件</div>
</section>
</div>
@@ -1,10 +1,14 @@
/* 京东数据库页样式(v1.6 蓝图 Phase 5 重写装配):顶部通栏(筛选行+工具栏)+横排体
(左侧栏类目树/分类平铺+主面板:卡片网格+旧式分页)。旧自绘表格样式随操作列/表格
退役整体摘除;列表字段映射收进 JdProductCard scoped 样式,本文件只管页面装配层。
/* 京东数据库页样式(v1.6 蓝图 Phase 5 重写装配 → v1.7 对齐原型):顶部通栏(搜索行+
工具栏)+横排体(左侧栏类目树/分类平铺+主面板:回显条+卡片网格+分页条+已选条)。
旧自绘表格样式随操作列/表格退役整体摘除;列表字段映射收进 JdProductCard scoped 样式,
本文件只管页面装配层。
2026-11-21 用户口径四件:①面板删标题行(筛选往上摆,原型顶栏直接开始);
②筛选行收窄字段宽让归属三档并入一行;③左右高度对齐——stretch 让侧栏随主面板拉满;
④「放到上面筛选框」红框整体上移——筛选行+批量按钮条离开主面板、提到页面最顶
(提示条正下方、通栏整行),外层改纵向排:顶部通栏在上,侧栏+主面板横排在下。 */
(提示条正下方、通栏整行),外层改纵向排:顶部通栏在上,侧栏+主面板横排在下。
v1.7(同日对齐原型《商品数据商城》)追加五件:合并搜索框(× 清除)、筛选按钮下方
absolute 浮层(价格区间+同步起止+重置/应用)、筛选回显条(条件芯片+共 N 条+
清除筛选)、自绘顶部分页条(OldPagination 从本页撤下)、底部已选条(sticky 悬浮)。 */
.jd-database-view {
font-family: inherit;
color: var(--c-text, #24384d);
@@ -43,8 +47,8 @@
min-width: 0;
}
.jd-filter-row {
/* 可换行流式布局:固定网格在窄面板下最小宽超出容器,把查询/重置挤出面板右缘。
flex-wrap 让放不下的项自然折行。 */
/* 可换行流式布局:固定网格在窄面板下最小宽超出容器,把尾部的归属下拉挤出面板右缘。
flex-wrap 让放不下的项自然折行。v1.7 起内容=搜索框+筛选弹层锚点+分组+归属三档。 */
display: flex;
flex-wrap: wrap;
gap: 10px;
@@ -52,18 +56,238 @@
margin-bottom: 12px;
}
.jd-filter-row .form-group {
/* 收窄字段宽(2026-11-21「这些可以往上摆」):min 132×5+归属下拉 150+查询/重置
在常规面板宽(≥1130px)下一行放得下,不再让「未分类」单独折一行。 */
flex: 1 1 132px;
min-width: 132px;
/* 「分组」表单组(label+下拉/锁定芯片):固定宽不再吃 flex(搜索框独占主弹性,
分组收窄到内容宽)。 */
flex: 0 1 auto;
min-width: 150px;
max-width: 220px;
}
.jd-filter-actions {
/* 合并搜索框(v1.7 对齐原型):吃掉搜索行的主弹性;relative 壳给 × 清除按钮定位。 */
.jd-search-wrap {
position: relative;
flex: 1 1 260px;
min-width: 220px;
max-width: 420px;
}
.jd-search-input {
width: 100%;
box-sizing: border-box;
min-height: 42px;
padding: 8px 34px 8px 12px;
border: 1px solid #cbd9e6;
border-radius: 9px;
background: #f8fbfd;
color: #24384d;
font-size: 13.5px;
font-family: inherit;
outline: none;
transition: border-color 160ms ease, box-shadow 160ms ease, background 160ms ease;
}
.jd-search-input:hover {
border-color: #9fb7cd;
}
.jd-search-input:focus {
background: #ffffff;
border-color: #5f85ad;
box-shadow: 0 0 0 3px rgba(95, 133, 173, 0.16);
}
.jd-search-clear {
position: absolute;
right: 6px;
top: 50%;
transform: translateY(-50%);
width: 24px;
height: 24px;
padding: 0;
border: none;
border-radius: 50%;
background: #dbe7f1;
color: #5b6f83;
font-size: 15px;
line-height: 1;
cursor: pointer;
transition: background 120ms ease, color 120ms ease;
}
.jd-search-clear:hover {
background: #c7d9e8;
color: #2f5d8b;
}
/* 筛选弹层锚点:relative 给浮层「按钮下方 absolute」定位(v1.7 对齐原型)。 */
.jd-filter-anchor {
position: relative;
flex-shrink: 0;
}
/* 筛选按钮激活态(弹层开着时描一圈主色,提示当前条件挂在它下面)。 */
.jd-filter-anchor .jd-filter-open {
border-color: #5f85ad;
color: #2f5d8b;
background: #edf5fb;
}
.jd-filter-popover {
position: absolute;
top: calc(100% + 8px);
left: 0;
z-index: 30;
width: 300px;
padding: 14px;
border: 1px solid #d8e3ee;
border-radius: 12px;
background: #ffffff;
box-shadow: 0 18px 42px -22px rgba(39, 67, 94, 0.45);
display: flex;
flex-direction: column;
gap: 12px;
}
.jd-pop-row {
display: flex;
flex-direction: column;
gap: 6px;
}
.jd-pop-row > label {
color: #5b6f83;
font-size: 12.5px;
font-weight: 600;
}
.jd-pop-fields {
display: flex;
gap: 10px;
align-items: center;
gap: 8px;
}
.jd-pop-fields input {
flex: 1 1 0;
min-width: 0;
min-height: 36px;
padding: 6px 10px;
border: 1px solid #cbd9e6;
border-radius: 8px;
background: #f8fbfd;
color: #24384d;
font-size: 13px;
font-family: inherit;
color-scheme: light;
outline: none;
transition: border-color 160ms ease, box-shadow 160ms ease, background 160ms ease;
}
.jd-pop-fields input:focus {
background: #ffffff;
border-color: #5f85ad;
box-shadow: 0 0 0 3px rgba(95, 133, 173, 0.16);
}
.jd-pop-sep {
color: #8293a5;
font-size: 12.5px;
}
.jd-pop-actions {
display: flex;
justify-content: flex-end;
gap: 10px;
}
.jd-pop-actions .btn {
min-height: 34px;
padding: 5px 14px;
}
/* 筛选回显条(v1.7 F5):条件芯片+共 N 条+清除筛选;无激活筛选不渲染(v-if 在模板)。 */
.jd-filter-chips {
display: flex;
flex-wrap: wrap;
align-items: center;
gap: 8px;
padding: 8px 10px;
margin-bottom: 12px;
border: 1px solid #e3ecf4;
border-radius: 9px;
background: #f6fafd;
}
.jd-chip {
padding: 3px 10px;
border-radius: 999px;
background: #e8f1f9;
color: #3d5a77;
font-size: 12.5px;
white-space: nowrap;
}
.jd-chip-total {
color: #5b6f83;
font-size: 12.5px;
white-space: nowrap;
}
.jd-chip-clear {
margin-left: auto;
padding: 2px 6px;
border: none;
border-radius: 6px;
background: transparent;
color: #4f78a5;
font-size: 12.5px;
font-family: inherit;
cursor: pointer;
text-decoration: underline;
white-space: nowrap;
}
.jd-chip-clear:hover {
color: #2f5d8b;
}
/* 顶部分页条(v1.7 F4):页码信息+五键+档位下拉;OldPagination 从本页撤下后的替身。 */
.jd-page-bar {
display: flex;
flex-wrap: wrap;
align-items: center;
gap: 12px;
}
.jd-page-info {
color: #5b6f83;
font-size: 13px;
white-space: nowrap;
}
.jd-page-btns {
display: flex;
align-items: center;
gap: 6px;
}
.jd-page-btn {
min-height: 32px;
padding: 4px 12px;
border: 1px solid #c7d7e5;
border-radius: 8px;
background: #ffffff;
color: #5b6f83;
font-size: 12.5px;
font-family: inherit;
cursor: pointer;
white-space: nowrap;
transition: background 120ms ease, color 120ms ease, border-color 120ms ease;
}
.jd-page-btn:hover:not(:disabled) {
background: #edf5fb;
color: #2f5d8b;
border-color: #95b1cb;
}
.jd-page-btn:disabled {
cursor: not-allowed;
opacity: 0.5;
}
/* 档位下拉:42px 外壳由全局 .el-select.admin-filter 皮肤出——这里只补宽度与左侧外距。
.page-size-select 定位类保留(旧分页条的定位约定,测试与人工定位都认它)。 */
.jd-page-bar > .el-select.admin-filter,
.jd-page-bar > .page-size-select {
width: 120px;
margin-left: auto;
}
/* 底部已选条(v1.7 F7 骨架):主面板底部 sticky 悬浮,滚动到列表深处也看得见勾选规模。 */
.jd-select-bar {
position: sticky;
bottom: 8px;
z-index: 10;
margin-top: 12px;
padding: 9px 16px;
border: 1px solid #cfdff0;
border-radius: 10px;
background: #eef6fd;
color: #2f5d8b;
font-size: 13px;
font-weight: 600;
box-shadow: 0 -6px 18px -14px rgba(39, 67, 94, 0.5);
}
.form-group {
display: flex;
flex-direction: column;
@@ -1,10 +1,10 @@
/** 京东数据库查询适配(v1.4 Phase 5):GET /api/admin/jd-products + 删除(DELETE /{id} +
* POST /batch-delete)+ 分组端点 /api/admin/jd-product-groups。
/** 京东数据库查询适配(v1.4 Phase 5 → v1.7 对齐原型):GET /api/admin/jd-products +
* 删除(DELETE /{id} + POST /batch-delete)+ CSV 导出(POST /export,2026-11-21 拍板
* 「只恢复 CSV」)+ 分组端点 /api/admin/jd-product-groups。
* 公司口径(2026-11-16 用户定案「删除掉公司 tab,参考品牌数据库」):全页零公司维度——
* 只读列表与类目下拉的 company_id 发送口已随公司 tab 摘除(后端读侧谓词同窗撤,重上时
* 从 git 历史找回),详情/编辑/删除/分组管理本就不带;行 company_id 列仍是同步来源标记、
* 随详情下发。反向钉在 company-tab-wiring「公司维度不得回流」清单。
* 导出发送口已随 2026-11-15 客户口径「导出也不用」从前端下线(后端 /export 端点保留)。 */
* 随详情下发。反向钉在 company-tab-wiring「公司维度不得回流」清单。 */
import { http } from '@/api/http'
import { errorTextOf, unwrap } from '../../api/envelope.ts'
import {
@@ -25,12 +25,14 @@ export async function fetchJdProductList(
): Promise<JdProductPageResult> {
const query = toJdProductListParams(
{
productCode: params.productCode ?? '',
titleKeyword: params.titleKeyword ?? '',
keyword: params.keyword ?? '',
category: params.category ?? '',
categoryPath: params.categoryPath ?? [],
shopName: params.shopName ?? '',
groupId: params.groupId ?? '',
classified: (params.classified ?? '') as '' | 'classified' | 'ungrouped',
minPrice: params.minPrice ?? '',
maxPrice: params.maxPrice ?? '',
syncedFrom: params.syncedFrom ?? '',
syncedTo: params.syncedTo ?? '',
},
@@ -142,13 +144,16 @@ export async function uploadJdProductImage(
return parseJdProductDetail(data)
}
/** 分组行(GET 列表返回:[{id,name,ownerGroupId,sortOrder,productCount}])。 */
/** 分组行(GET 列表返回:[{id,name,ownerGroupId,sortOrder,productCount,shops}])。
* shops=该分类下的店铺名单(v1.7 V214 店铺名单维度,后端列表响应每行带;可选字段——
* 旧夹具/消费方不传按空名单处理,Phase 3 侧栏名单交互读它)。 */
export interface JdProductGroup {
id: number
name: string
ownerGroupId: number
sortOrder: number
productCount: number
shops?: string[]
}
/** 分组管理的写入负载(POST / PUT body:{name, sortOrder, ownerGroupId?})。 */
@@ -204,12 +209,19 @@ export async function fetchJdProductGroups(ownerGroupId?: number | null): Promis
const record = raw as Record<string, unknown>
const id = numberOr(record.id, 0)
if (id <= 0) continue
// 店铺名单(v1.7 V214):后端按店名升序给数组;前端只滤空白不重排(排序语义在服务端)。
const shops = Array.isArray(record.shops)
? record.shops
.filter((shop): shop is string => typeof shop === 'string' && shop.trim() !== '')
.map((shop) => shop.trim())
: []
out.push({
id,
name: typeof record.name === 'string' ? record.name.trim() : '',
ownerGroupId: numberOr(record.ownerGroupId ?? record.owner_group_id, 0),
sortOrder: numberOr(record.sortOrder ?? record.sort_order, 0),
productCount: numberOr(record.productCount ?? record.product_count, 0),
shops,
})
}
return out
@@ -311,3 +323,52 @@ export async function batchAssignJdProductGroup(
const { data } = await http.post<unknown>(`${JD_PRODUCT_ENDPOINT}/batch-assign-group`, body)
return groupDataOf<number>(data)
}
/** CSV 导出的本地兜底文件名(yyyyMMddHHmm,与后端导出文件名同一格式;秒位不要——
* 同一分钟内的两次导出覆盖旧文件是可接受语义,别拿毫秒名刷屏下载目录)。 */
function csvFilenameTimestamp(): string {
const now = new Date()
const pad = (n: number) => String(n).padStart(2, '0')
return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}` +
`${pad(now.getHours())}${pad(now.getMinutes())}`
}
/** 从 Content-Disposition 里取 filename*=UTF-8'' 中文名(DownloadHeaderUtil 的形状:
* `attachment; filename="ascii回退"; filename*=UTF-8''%E4%BA%AC...`);取不到回 null。 */
function csvFilenameFromDisposition(disposition: unknown): string | null {
if (typeof disposition !== 'string') return null
const match = disposition.match(/filename\*=(?:UTF-8|utf-8)''([^;]+)/)
if (!match) return null
try {
return decodeURIComponent(match[1].trim())
} catch {
return null
}
}
/** 导出勾选商品为 CSV(v1.7 恢复导出,2026-11-21 拍板「只恢复 CSV」;2026-11-15 客户口径
* 「导出也不用」被本窗推翻):POST /api/admin/jd-products/export body {ids}(上限 1000,
* 后端 requireJdAccess 读闸),blob 下载 jd_products_<yyyyMMddHHmm>.csv——文件名优先取
* 后端 Content-Disposition 的 filename*(服务端是唯一出处),取不到回落本地同名格式。
* 文件头带 UTF-8 BOM,Excel 直开中文不乱码(AC-1)。业务失败(空勾选/超限)后端回
* JSON 信封但 HTTP 200 ⇒ blob 里是错误负载,交给调用方按非 CSV 内容提示(页面统一走
* try/catch 文案,此处只管传输与落盘)。 */
export async function exportJdProductsCsv(ids: number[]): Promise<void> {
const response = await http.post<Blob>(`${JD_PRODUCT_ENDPOINT}/export`, { ids }, { responseType: 'blob' })
const blob = response.data instanceof Blob
? response.data
: new Blob([response.data as BlobPart], { type: 'text/csv;charset=UTF-8' })
const filename = csvFilenameFromDisposition(response.headers?.['content-disposition'])
?? `jd_products_${csvFilenameTimestamp()}.csv`
const url = URL.createObjectURL(blob)
try {
const link = document.createElement('a')
link.href = url
link.download = filename
document.body.appendChild(link)
link.click()
link.remove()
} finally {
URL.revokeObjectURL(url)
}
}
@@ -1,13 +1,18 @@
/** 京东数据库页筛选纯函数(v1.4 Phase 5):商品编码/标题关键字/类目/分组/同步起止 + snake 分页参数。
* 产出与后端契约 §列表 query 逐字对撞:`page`/`page_size`(默认 50、上限 100)、
* `product_code`、`title_keyword`、`category`(京麦末级类目等值过滤,2026-11-15 增)、
/** 京东数据库页筛选纯函数(v1.7 对齐原型《商品数据商城》):合并搜索/类目/店铺/分组/
* 归属三档/价格区间/同步起止 + snake 分页参数。
* 产出与后端契约 §列表 query 逐字对撞:`page`/`page_size`(默认 50、上限 1000——v1.7
* 与后端 JdProductQueryService.MAX_PAGE_SIZE 逐字同步放宽,契约测试钉着这两个数)、
* `keyword`(v1.7 合并搜索:后端 `product_code LIKE OR title LIKE`,OR 语义在 SQL 段;
* 旧 `product_code`/`title_keyword` 两参数后端保留兼容但前端停发)、`shop_name`
* (v1.7 店铺名单点选,精确 eq)、`min_price`/`max_price`(v1.7 价格区间:商品区间完全
* 落在筛选区间内)、`category`(京麦末级类目等值过滤,2026-11-15 增)、
* `group_id`(当前分组下的分类 id)、`owner_group_id`(当前数据权限分组,V203)、
* `synced_from`/`synced_to`(ISO yyyy-MM-dd;空白不下发)。
* 商品状态筛选与导出(2026-11-15 客户口径「这两个不要/导出也不用」)已从前端下线;
* 店铺筛选同日客户口径「店铺不需要」从前端下线(后端 shop_name 参数同窗撤,DB 列与详情不动)。
* 后端 `sale_status` 参数与 `/export` 端点保留(无 UI 入口),重上时从 git 历史找回取值口。
* 商品状态筛选与 json/txt 导出(2026-11-15 客户口径)仍从前端下线;CSV 导出 v1.7 恢复
* (jd-product-api.ts 的 exportJdProductsCsv,2026-11-21 拍板「只恢复 CSV」)。
* 分页钳制(铁律 15):page < 1 归 1、上限 10_000(后端 CR-18 同值),(page-1)*page_size
* 最大 999_900,Number.MAX_SAFE_INTEGER 也不会把乘积顶出安全整数。纯逻辑,node --test 直测。
* 最大 999_900 档在 10×1000 时为 9_999_000,Number.MAX_SAFE_INTEGER 也顶不出去。
* 纯逻辑,node --test 直测。
* 公司维已整页摘除(2026-11-16 用户定案「删除掉公司 tab,参考品牌数据库」):归一化构造器
* 与入参类型都不认识 company_id——读侧发送口已随公司 tab 撤下(品牌库 2026-10-06 先例同形)。
* 日期默认空字符串:同步台账是累计数据,默认当天会让首屏只剩今天同步的行
@@ -15,32 +20,41 @@
import { validIsoDateOrUndefined } from '../asin/asin-filter.ts'
import { jdCategoryNamesUnder } from './jd-category-tree.ts'
/** 每页条数默认 50(v1.6 蓝图 Phase 1 新契约,商城款式一屏 50),上限 100。
* v1.4 §3.4 的默认 20 由 2026-11-21 蓝图拍板放宽;页面装配层 ref(20) 的旧硬编码
* 随 Phase 5 重写改挂本常量,纯函数层先把新契约钉住。 */
/** 每页条数默认 50(v1.6 蓝图 Phase 1 新契约,商城款式一屏 50),上限 1000
* (v1.7 对齐原型档位 50/100/200/500/1000,与后端 MAX_PAGE_SIZE 逐字同步——契约
* 测试两侧钉着,改这里必须同窗改 JdProductQueryService.MAX_PAGE_SIZE)。 */
export const JD_PRODUCT_PAGE_SIZE = 50
export const JD_PRODUCT_MAX_PAGE_SIZE = 100
/** 每页条数档位(v1.6 新契约 20/50/100):页面装配层的档位选择器从这里取数,
* 不再各写各的字面量(Phase 5 接线;旧全局 OldPagination 默认档 10/20/50/100 不动)。 */
export const JD_PRODUCT_PAGE_SIZE_OPTIONS = [20, 50, 100] as const
export const JD_PRODUCT_MAX_PAGE_SIZE = 1000
/** 每页条数档位(v1.7 对齐原型:50/100/200/500/1000,原 20 档退役):页面装配层的
* 档位选择器从这里取数,不再各写各的字面量。 */
export const JD_PRODUCT_PAGE_SIZE_OPTIONS = [50, 100, 200, 500, 1000] as const
/** 页码上限:与后端 MAX_PAGE(CR-18 先例,外观专利同值)对齐,两侧不漂。 */
export const JD_PRODUCT_MAX_PAGE = 10_000
/** 分类状态快筛的出厂档位(2026-11-17 用户口径「不需要全部分类 默认卡在未分类上就行」):
* 首屏/重置都卡它;「筛选激活」判定也以「是否偏离它」为准。 */
export const JD_PRODUCT_DEFAULT_CLASSIFIED = 'ungrouped' as const
/** 价格输入 → 有限数:空白/非数字回 null(不下发,后端 BigDecimal 侧也不认脏值)。 */
export function finitePriceOrNull(raw: string): number | null {
const text = (raw || '').trim()
if (!text) return null
const value = Number(text)
return Number.isFinite(value) ? value : null
}
export interface JdProductFilterState {
/** 商品编码,空串不限。 */
productCode: string
/** 标题关键字,空串不限。 */
titleKeyword: string
/** 类目(京麦类目名,末级或父级;选项来自级联面板),空串=全部类目。 */
/** 合并搜索词(v1.7 对齐原型:一个框同时搜商品编码与标题,OR 语义在后端 SQL)。
* 旧 productCode/titleKeyword 两框随 v1.7 前端下线(后端参数保留兼容在飞请求)。 */
keyword: string
/** 类目(京麦类目名,末级或父级;选项来自侧栏商品目录树),空串=全部类目。 */
category: string
/** 选中节点的名称路径(2026-11-18 一级/二级类目可选中):非空时序列化按
* jdCategoryNamesUnder 展开为子树类目名集合下发(后端 IN);空=末级/树外行,
* 按单名等值下发(旧形状)。 */
categoryPath?: string[]
/** 分组 id 文本(分组管理里那一行),空串=全部分组。 */
/** 店铺名(v1.7 店铺名单维度:侧栏点店铺行下发,精确 eq;空串不限)。 */
shopName: string
/** 分类 id 文本(侧栏店铺分类 Tab 里那一行),空串=全部分类。 */
groupId: string
/** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」,同日定默认卡未分类;
* 2026-11-18 用户口径「加个全部选项」恢复全量档):'classified'=已分类(当前分组下有
@@ -50,6 +64,10 @@ export interface JdProductFilterState {
* 旧 grouped/ungrouped 参数(那两档读已停用的 biz_jd_product.group_id 列,后端仍拒收)。
* ''(全部档)序列化时不带 classified 参数=后端跳过谓词查全部;脏值同走该兜底。 */
classified?: '' | 'classified' | 'ungrouped'
/** 价格区间下限(v1.7;空串不限,非法数字不下发)。 */
minPrice: string
/** 价格区间上限(v1.7;空串不限,非法数字不下发)。 */
maxPrice: string
/** 同步开始日期(ISO yyyy-MM-dd;空串不限)。 */
syncedFrom: string
/** 同步结束日期(ISO yyyy-MM-dd;空串不限)。 */
@@ -59,18 +77,31 @@ export interface JdProductFilterState {
export function createJdProductFilterState(): JdProductFilterState {
// 分类状态出厂卡「未分类」(2026-11-17 用户口径「默认卡在未分类上就行」,2026-11-18
// 加「全部」档后默认不动):首屏与「重置」都带 classified=false 查,全量走「全部」档。
return { productCode: '', titleKeyword: '', category: '', categoryPath: [], groupId: '', classified: JD_PRODUCT_DEFAULT_CLASSIFIED, syncedFrom: '', syncedTo: '' }
return {
keyword: '',
category: '',
categoryPath: [],
shopName: '',
groupId: '',
classified: JD_PRODUCT_DEFAULT_CLASSIFIED,
minPrice: '',
maxPrice: '',
syncedFrom: '',
syncedTo: '',
}
}
/** 是否有任一激活筛选条件。 */
/** 是否有任一激活筛选条件(回显条「清除筛选」的渲染判据;分组作用域 ownerGroupId
* 不在其中——它是作用域不是筛选条件,清除不得碰)。 */
export function jdProductFilterActive(state: JdProductFilterState): boolean {
if ((state.productCode || '').trim()) return true
if ((state.titleKeyword || '').trim()) return true
if ((state.keyword || '').trim()) return true
if ((state.category || '').trim()) return true
if ((state.shopName || '').trim()) return true
if ((state.groupId || '').trim()) return true
// 出厂默认本身卡未分类档(2026-11-17 用户口径),所以只有「偏离默认档」才算激活筛选,
// 否则首屏就永远处于"有筛选"状态,空结果提示会误导用户去重置一个没动过的筛选。
if (state.classified && state.classified !== JD_PRODUCT_DEFAULT_CLASSIFIED) return true
if (finitePriceOrNull(state.minPrice) != null || finitePriceOrNull(state.maxPrice) != null) return true
if (validIsoDateOrUndefined(state.syncedFrom) || validIsoDateOrUndefined(state.syncedTo)) return true
return false
}
@@ -79,16 +110,21 @@ export function jdProductFilterActive(state: JdProductFilterState): boolean {
export interface JdProductQuery {
page: number
page_size: number
product_code?: string
title_keyword?: string
/** 合并搜索词(v1.7:后端 product_code LIKE OR title LIKE)。 */
keyword?: string
/** 京麦类目名集合 IN 过滤(后端 JdProductQueryService.Filter.categories,
* 2026-11-18 一级/二级类目可选中:父级展开为子树类目名集合;末级/树外=单元素)。 */
category?: string[]
/** 店铺名精确过滤(v1.7 店铺名单点选;后端 eq 谓词,铁律 1/20 SQL 下推)。 */
shop_name?: string
/** 自定义分类 id(当前分组下的一个分类;V203 起按归属表 EXISTS 过滤)。 */
group_id?: number
/** 分类状态快筛(2026-11-17):true=已分类、false=未分类,缺省不下发=全部。
* 后端按「当前分组」(owner_group_id)的归属表 EXISTS/NOT EXISTS 在 SQL 侧下推。 */
classified?: boolean
/** 价格区间(v1.7):商品区间完全落在筛选区间内(price_min >= X AND price_max <= Y)。 */
min_price?: number
max_price?: number
/** 当前数据权限分组 id(分类列/分类筛选都按它取;V203「不同组不能看到跨组的分类」)。 */
owner_group_id?: number
synced_from?: string
@@ -99,27 +135,30 @@ export interface JdProductQuery {
export interface JdProductListParams {
page: number
pageSize: number
productCode?: string
titleKeyword?: string
keyword?: string
category?: string
/** 选中类目节点路径(见 JdProductFilterState.categoryPath;空=单名等值)。 */
categoryPath?: string[]
shopName?: string
groupId?: string
/** 分类状态快筛(''/缺省=全部,'classified'/'ungrouped' 见 JdProductFilterState)。 */
classified?: string
/** 价格区间(v1.7;空串不限)。 */
minPrice?: string
maxPrice?: string
/** 当前分组(数据权限分组 id):分类列/分类筛选的作用域,非筛选条件(重置不清它)。 */
ownerGroupId?: number | null
syncedFrom?: string
syncedTo?: string
}
/** 过滤态 → 过滤面参数(snake_case,仅下发非空字段)。 */
/** 过滤态 → 过滤面参数(snake_case,仅下发非空字段)。
* 旧 `product_code`/`title_keyword` v1.7 起前端停发(合并进 keyword),反钉在
* jd-product-group.test.ts「参数面不再出现」。 */
function toJdProductFilterQuery(state: JdProductFilterState): Omit<JdProductQuery, 'page' | 'page_size'> {
const query: Omit<JdProductQuery, 'page' | 'page_size'> = {}
const productCode = (state.productCode || '').trim()
if (productCode) query.product_code = productCode
const titleKeyword = (state.titleKeyword || '').trim()
if (titleKeyword) query.title_keyword = titleKeyword
const keyword = (state.keyword || '').trim()
if (keyword) query.keyword = keyword
const category = (state.category || '').trim()
if (category) {
// 2026-11-18 一级/二级类目可选中:带路径=按子树展开类目名集合(后端 IN);
@@ -129,12 +168,18 @@ function toJdProductFilterQuery(state: JdProductFilterState): Omit<JdProductQuer
: null
query.category = expanded && expanded.length ? expanded : [category]
}
const shopName = (state.shopName || '').trim()
if (shopName) query.shop_name = shopName
const groupId = Number.parseInt((state.groupId || '').trim(), 10)
if (Number.isFinite(groupId) && groupId > 0) query.group_id = groupId
// 分类状态快筛:只认两个显式档位,其余值(含脏值)按「全部」不下发——后端 classified
// 只收 true/false/缺省,不拿脏值冒充档位。
if (state.classified === 'classified') query.classified = true
else if (state.classified === 'ungrouped') query.classified = false
const minPrice = finitePriceOrNull(state.minPrice)
if (minPrice != null) query.min_price = minPrice
const maxPrice = finitePriceOrNull(state.maxPrice)
if (maxPrice != null) query.max_price = maxPrice
const syncedFrom = validIsoDateOrUndefined(state.syncedFrom)
if (syncedFrom) query.synced_from = syncedFrom
const syncedTo = validIsoDateOrUndefined(state.syncedTo)
@@ -142,7 +187,7 @@ function toJdProductFilterQuery(state: JdProductFilterState): Omit<JdProductQuer
return query
}
/** 过滤态 + 分页 → 列表查询参数;空白/非法日期不下发,分页钳制在此单出口(不含公司维)。
/** 过滤态 + 分页 → 列表查询参数;空白/非法日期/非法价格不下发,分页钳制在此单出口(不含公司维)。
* {@code ownerGroupId} 是「当前分组」(分类列/分类筛选作用域,V203),不是筛选条件:
* >0 时下发 `owner_group_id`,缺省/0 不下发=后端按作用域默认分组取。 */
export function toJdProductListParams(
@@ -1,17 +1,20 @@
/**
* 京东数据库页纯逻辑契约(v1.4 Phase 5)—— node --test 直跑(纯函数零依赖)。
* 京东数据库页纯逻辑契约(v1.4 Phase 5 → v1.7 对齐原型《商品数据商城》)——
* node --test 直跑(纯函数零依赖)。
*
* 不用 readFileSync/readSource/globSync 读点:source-pin-ratchet 对台账外新文件带读点即红,
* 本文件只 import 被测纯函数。
*
* 覆盖:
* 1. **snake 参数形状**:toJdProductListParams 产出 `page`/`page_size`(默认 50、上限 100、
* 档位 20/50/100〔v1.6 蓝图 Phase 1 新契约〕)、
* `product_code`/`title_keyword`/`group_id`/`owner_group_id`/`synced_from`/`synced_to`
* (ISO yyyy-MM-dd;空白不下发;groupId 空串→不带、有值→snake group_id;ownerGroupId>0 才带、
* 0/null/NaN 一律不带=后端按作用域默认分组取,V203);分页钳制(铁律 15)。
* 商品状态筛选与导出参数口已随 2026-11-15 客户口径下线,不再出现在参数面;
* 店铺筛选同日客户口径「店铺不需要」下线(shop_name 也不在参数面)。
* 1. **snake 参数形状**:toJdProductListParams 产出 `page`/`page_size`(默认 50、上限 1000、
* 档位 50/100/200/500/1000〔v1.7 对齐原型,上限与后端 JdProductQueryService.MAX_PAGE_SIZE
* 逐字同步〕)、`keyword`(v1.7 合并搜索:商品编码 OR 标题,OR 语义在后端 SQL)、
* `shop_name`(v1.7 店铺名单点选,精确 eq)、`min_price`/`max_price`(v1.7 价格区间)、
* `group_id`/`owner_group_id`/`synced_from`/`synced_to`(ISO yyyy-MM-dd;空白/非法不下发;
* groupId 空串→不带、有值→snake group_id;ownerGroupId>0 才带、0/null/NaN 一律不带=
* 后端按作用域默认分组取,V203);分页钳制(铁律 15)。
* 旧 `product_code`/`title_keyword` 两参数 v1.7 起前端停发(合并进 keyword;后端参数
* 保留兼容在飞请求);商品状态筛选与 json/txt 导出参数口仍随 2026-11-15 客户口径下线。
* 2. **详情解析**:parseJdProductDetail 解析 attrGroups/images(camel 为正 snake 容错、缺 url 弃行),
* attrGroups 解析不出时 attrJsonRaw 原文兜底;列表行解析缺 id 弃行。
*
@@ -54,11 +57,13 @@ test('类目级联静态导航树——服饰内衣二级与京麦面板样本
}
})
test('京东列表参数——snake 形状:groupId 空→不带、有值→group_id,日期空白/非法不下发', () => {
test('京东列表参数——snake 形状:keyword/店铺/价格下发,旧编码标题两框停发、日期空白/非法不下发', () => {
const full = toJdProductListParams(
{
productCode: ' JD-10086 ',
titleKeyword: ' 保温杯 ',
keyword: ' 保温杯 ',
shopName: ' 绿屿街道店 ',
minPrice: ' 100 ',
maxPrice: 'abc',
groupId: ' 7 ',
syncedFrom: '2026-11-01',
syncedTo: '2026-11-09',
@@ -71,29 +76,43 @@ test('京东列表参数——snake 形状:groupId 空→不带、有值→gro
assert.deepEqual(full, {
page: 2,
page_size: 20,
product_code: 'JD-10086',
title_keyword: '保温杯',
keyword: '保温杯',
shop_name: '绿屿街道店',
min_price: 100,
group_id: 7,
owner_group_id: 11,
synced_from: '2026-11-01',
synced_to: '2026-11-09',
})
assert.equal('shop_name' in full, false, '店铺筛选已下线,参数面不再出现 shop_name')
}, 'keyword/店铺 trim 后下发;非法价格(abc)不下发,合法价格转 number')
// 旧两框 v1.7 起前端停发(合并进 keyword):参数面不再出现(后端参数保留兼容在飞请求)。
assert.equal('product_code' in full, false, 'product_code 前端停发(合并搜索替代)')
assert.equal('title_keyword' in full, false, 'title_keyword 前端停发(合并搜索替代)')
assert.equal('sale_status' in full, false, '商品状态筛选已下线,参数面不再出现 sale_status')
// 出厂态=分页两项+默认未分类档(classified:false,2026-11-17 用户口径「默认卡在未分类上就行」);
// 脏值(非数字分组、非法日期)同罪不下发。
// 脏值(非数字分组、非法日期、非法价格)同罪不下发。
const blank = toJdProductListParams(createJdProductFilterState(), 1, 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(
{ productCode: '', titleKeyword: '', groupId: 'abc', syncedFrom: '2026/11/01', syncedTo: 'not-a-date' },
{ ...createJdProductFilterState(), groupId: 'abc', syncedFrom: '2026/11/01', syncedTo: 'not-a-date', minPrice: 'abc', maxPrice: ' ' },
1,
20,
)
assert.deepEqual(dirty, { page: 1, page_size: 20 }, '脏值不下发')
assert.equal('sale_status' in full, false, '商品状态筛选已下线,参数面不再出现 sale_status')
assert.deepEqual(dirty, { page: 1, page_size: 20, classified: false },
'脏值(分组/日期/价格)不下发;出厂态仍带 classified:false(默认未分类档)')
// 价格区间(v1.7 F2):合法上下限转 number 下发(后端 price_min >= X AND price_max <= Y)。
const priced = toJdProductListParams(
{ ...createJdProductFilterState(), minPrice: ' 100.5 ', maxPrice: '200' },
1,
20,
)
assert.deepEqual({ min_price: priced.min_price, max_price: priced.max_price }, { min_price: 100.5, max_price: 200 },
'价格区间合法值转 number 下发(字符串不发给后端 BigDecimal)')
// 当前分组非法值(0/NaN/null)一律不下发:0 是「不属于任何组」的哨兵,不能当组 id 发出去。
for (const bad of [0, null, undefined, Number.NaN]) {
assert.equal('owner_group_id' in toJdProductListParams(createJdProductFilterState(), 1, 20, bad), false,
@@ -105,24 +124,25 @@ test('京东列表参数——page 钳制防 (page-1)*page_size 溢出(铁律
const low = toJdProductListParams(createJdProductFilterState(), 0, 0)
assert.equal(low.page, 1, 'page<1 归 1')
assert.equal(low.page_size, 50, 'page_size 非法回默认 50(v1.6 新契约)')
const big = toJdProductListParams(createJdProductFilterState(), 3, 500)
assert.equal(big.page_size, 100, 'page_size 上限 100')
const big = toJdProductListParams(createJdProductFilterState(), 3, 5000)
assert.equal(big.page_size, 1000, 'page_size 上限 1000(v1.7 对齐原型档位放宽)')
const extreme = toJdProductListParams(createJdProductFilterState(), Number.MAX_SAFE_INTEGER, 100)
const extreme = toJdProductListParams(createJdProductFilterState(), Number.MAX_SAFE_INTEGER, 1000)
assert.equal(extreme.page, JD_PRODUCT_MAX_PAGE)
const offset = (extreme.page - 1) * extreme.page_size
assert.equal(Number.isSafeInteger(offset), true, `(page-1)*page_size=${offset} 必须留在安全整数域`)
assert.equal(offset, 999_900)
assert.equal(offset, 9_999_000, '10_000 页 × 1000 条仍在 Number.MAX_SAFE_INTEGER 内')
})
/** v1.6 蓝图 Phase 1 新契约:首屏默认 50、档位 20/50/100;model 侧默认与 filter 侧
* 同值不漂(页面装配层 Phase 5 改挂常量,两处字面量从此只剩常量出处)。 */
test('分页档位——默认 50、档位 20/50/100、上限 100 不放宽', () => {
assert.deepEqual([...JD_PRODUCT_PAGE_SIZE_OPTIONS], [20, 50, 100], '档位清单逐字同(新契约)')
/** v1.7 契约:首屏默认 50、档位 50/100/200/500/1000、上限 1000;model 侧默认与 filter 侧
* 同值不漂(页面装配层挂常量,两处字面量从此只剩常量出处;上限与后端
* JdProductQueryService.MAX_PAGE_SIZE 逐字同步——契约测试两侧钉着这个数)。 */
test('分页档位——默认 50、档位 50/100/200/500/1000、上限 1000(v1.7 对齐原型)', () => {
assert.deepEqual([...JD_PRODUCT_PAGE_SIZE_OPTIONS], [50, 100, 200, 500, 1000], '档位清单逐字同(v1.7 新契约)')
assert.ok(JD_PRODUCT_PAGE_SIZE_OPTIONS.includes(JD_PRODUCT_PAGE_SIZE), '默认值必须是档位之一')
assert.equal(JD_PRODUCT_PAGE_SIZE, 50, '默认档 50(v1.6 拍板放宽,v1.4 §3.4 的 20 已废)')
assert.equal(JD_PRODUCT_DEFAULT_SIZE, JD_PRODUCT_PAGE_SIZE, 'model 侧默认与 filter 侧同值')
assert.equal(JD_PRODUCT_MAX_PAGE_SIZE, 100, '上限 100 不放宽(后端 CR-18 同值)')
assert.equal(JD_PRODUCT_MAX_PAGE_SIZE, 1000, '上限 1000(v1.7 对齐原型,与后端 MAX_PAGE_SIZE 逐字同步)')
})
/** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」,同日定默认卡未分类;
@@ -1,12 +1,15 @@
/**
* 京东数据库页(v1.6 装配:侧栏+卡片网格+居中详情弹窗)的挂载契约。
* 京东数据库页(v1.6 装配 → v1.7 对齐原型《商品数据商城》)的挂载契约。
*
* 形态:顶部通栏面板(筛选行:编码/标题/分组/同步起止/归属三档 + 工具栏:全选本页/
* 取消本页/归入分类/取消归属/删除商品(N),2026-11-21 用户口径「放到上面筛选框」红框
* 整体上移,不再住主面板)+横排体 .jd-body(左侧栏 JdCategorySidebar:商品目录=
* 京麦授权类目树+计数徽标+树外兜底/店铺分类=当前分组分类平铺+新建+分类管理入口
* +主面板:卡片网格 JdProductCard + OldPagination)+居中详情弹窗(编辑/删除入口
* 收进弹窗顶部)。
* 形态:顶部通栏面板(v1.7 搜索行:合并搜索框+「筛选」按钮+弹层锚点+分组+归属三档
* +工具栏:全选本页/取消本页/归入分类/取消归属/删除商品(N),2026-11-21 用户口径
* 「放到上面筛选框」红框整体上移,不再住主面板)+横排体 .jd-body(左侧栏
* JdCategorySidebar:商品目录=京麦授权类目树+计数徽标+树外兜底/店铺分类=当前分组
* 分类平铺+新建+分类管理入口+主面板:回显条+卡片网格 JdProductCard+自绘分页条
* .jd-page-bar+底部已选条)+居中详情弹窗(编辑/删除入口收进弹窗顶部)。
* v1.7 五件:合并搜索(旧编码/标题两框退役)、筛选弹层(价格区间+同步起止+重置/应用)、
* 筛选回显条(芯片+共 N 条+清除筛选保留分组)、自绘顶部分页条(OldPagination 从本页
* 撤下,组件本体他页在用)、底部已选条(常驻悬浮)。
* 旧表格/类目级联面板/详情抽屉三件随 v1.6 Phase 5 退役(反向钉在本文件顶部用例)。
* 批量归类对话框与分类管理对话框是 v1.6 之前的既有组件(另有专属 mount 契约文件),
* 本文件只钉页面接线(勾选累计/三参提交/打开路径/changed 重取)。
@@ -23,7 +26,6 @@ import { ElOption, ElSelect } from 'element-plus'
import JdDatabasePage from '@/pages/jd/JdDatabasePage.vue'
import JdProductEditDrawer from '@/pages/jd/JdProductEditDrawer.vue'
import OldPagination from '@/components/OldPagination.vue'
import { useAdminSessionStore } from '@/stores/admin-session'
@@ -195,6 +197,15 @@ async function pickSelectOption(wrapper: VueWrapper<Element>, label: string, opt
await flushPromises()
}
/** 打开筛选弹层(v1.7):点「筛选」按钮 toggle,返回弹层节点(弹层必须在 DOM)。 */
async function openFilterPopover(wrapper: VueWrapper<Element>): Promise<DOMWrapper<Element>> {
const trigger = wrapper.findAll('button').find((b) => b.text() === '筛选')
expect(trigger, '顶部应存在「筛选」按钮').toBeTruthy()
await trigger!.trigger('click')
await flushPromises()
return wrapper.get('.jd-filter-popover')
}
/** 详情弹窗取数 mock(已由 parseJdProductDetail 归一的形状)。 */
function detailPayload(id = 1) {
return {
@@ -213,7 +224,7 @@ function detailPayload(id = 1) {
}
describe('京东数据库页(v1.6 装配:侧栏+卡片网格)', () => {
it('挂载后按首屏分页参数取列表(pageSize 默认 50、档位 20/50/100、不带公司维度),卡片数=本页条数', async () => {
it('挂载后按首屏分页参数取列表(pageSize 默认 50、档位 50/100/200/500/1000、不带公司维度),卡片数=本页条数', async () => {
const wrapper = await mountWith({ items: [item(1), item(2), item(3)], total: 42, page: 1, pageSize: 50 })
expect(jdApi.fetchJdProductList).toHaveBeenCalledTimes(1)
const firstCall = jdApi.fetchJdProductList.mock.calls[0][0]
@@ -222,8 +233,8 @@ describe('京东数据库页(v1.6 装配:侧栏+卡片网格)', () => {
// 公司维度 2026-11-16 整页摘除:入参层不再有 companyId 键(单参 toHaveProperty 才是「键不存在」的真判据)。
expect(firstCall).not.toHaveProperty('companyId')
expect(wrapper.findAll('.jd-card')).toHaveLength(3)
// 档位 20/50/100 收敛在 filter 层常量:分页条下拉按它出选项。
expect(wrapper.findComponent(OldPagination).props('sizes')).toEqual([20, 50, 100])
// 档位 50/100/200/500/1000(v1.7 对齐原型)收敛在 filter 层常量:分页条下拉按它出选项。
expect(optionLabels(wrapper, '每页条数')).toEqual(['50条/页', '100条/页', '200条/页', '500条/页', '1000条/页'])
})
it('旧装配反钉:自绘表格/类目级联面板/详情抽屉三件已退役,批量入口改「归入分类」', async () => {
@@ -263,11 +274,12 @@ describe('京东数据库页(v1.6 装配:侧栏+卡片网格)', () => {
})
})
/** 布局钉(2026-11-21 用户口径「放到上面筛选框」红框整体上移):筛选行+批量按钮条
* 离开右侧主面板、提到页面最顶(操作提示条正下方、通栏整行);侧栏与主面板(只剩
* 网格+分页)归入横排体 .jd-body。反向钉死「改回主面板内」与「横排体散架」两种回归。 */
/** 布局钉(2026-11-21 用户口径「放到上面筛选框」红框整体上移;v1.7 主面板加回显条+
* 自绘分页条+已选条):筛选行+批量按钮条离开右侧主面板、提到页面最顶(操作提示条
* 正下方、通栏整行);侧栏与主面板(回显条+网格+分页条+已选条)归入横排体 .jd-body。
* 反向钉死「改回主面板内」与「横排体散架」两种回归。 */
describe('布局:筛选行+工具栏上移顶部通栏(2026-11-21 用户口径红框整体上移)', () => {
it('筛选行与工具栏同住顶部通栏面板且先于横排体;主面板只剩加载失败条+卡片网格+分页', async () => {
it('筛选行与工具栏同住顶部通栏面板且先于横排体;主面板=回显条+卡片网格+自绘分页条+已选条', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 50 })
const topPanel = wrapper.get('.jd-top-panel')
expect(topPanel.find('.jd-filter-row').exists()).toBe(true, '筛选行住顶部通栏面板')
@@ -277,7 +289,10 @@ describe('布局:筛选行+工具栏上移顶部通栏(2026-11-21 用户
expect(mainPanel.find('.jd-filter-row').exists()).toBe(false, '筛选行改回主面板即红')
expect(mainPanel.find('.jd-toolbar').exists()).toBe(false, '工具栏改回主面板即红')
expect(mainPanel.find('.jd-card-grid').exists()).toBe(true, '主面板=卡片网格')
expect(mainPanel.findComponent(OldPagination).exists()).toBe(true, '主面板=分页条')
expect(mainPanel.find('.jd-page-bar').exists()).toBe(true, '主面板=自绘分页条(v1.7 对齐原型)')
expect(mainPanel.find('.jd-select-bar').exists()).toBe(true, '主面板=底部已选条(v1.7 常驻)')
expect(mainPanel.text()).toContain('已选 0 件', '已选条常驻:0 件也显示(不随勾选数显隐)')
expect(mainPanel.find('.jd-filter-chips').exists()).toBe(false, '出厂态(默认未分类档)无激活筛选,回显条不渲染')
// 顺序与归属:页面根下先是顶部通栏面板、后是横排体;侧栏与主面板都在横排体里。
const viewChildren = [...wrapper.get('.jd-database-view').element.children]
@@ -502,11 +517,12 @@ describe('归属三档快筛(三档,默认卡未分类)', () => {
wrapper.unmount()
})
it('「重置」不放开筛选,而是回默认未分类档', async () => {
it('「重置」(弹层里)不放开筛选,而是回默认未分类档', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 50 })
await pickSelectOption(wrapper, '筛选分类状态', '已分类')
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0].classified).toBe('classified')
await openFilterPopover(wrapper)
await wrapper.findAll('button').find((b) => b.text() === '重置')!.trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0].classified).toBe('ungrouped',
@@ -858,82 +874,113 @@ describe('详情弹窗(抽屉退役后的详情入口)', () => {
})
})
describe('筛选与分页(AC-9:列表 HTTP 参数与 v1.4 逐字等价)', () => {
it('筛选生效:编码/关键字/分组分类/起止日期,查询回第一页重发(店铺/商品状态/导出已下线)', async () => {
describe('筛选与分页(v1.7:合并搜索+筛选弹层;AC-2/AC-4)', () => {
it('合并搜索+弹层条件生效:keyword/分组分类/起止日期一次下发,查询回第一页重发(旧两框停发)', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue(GROUPS)
const wrapper = await mountWith({ items: [], total: 0, page: 1, pageSize: 50 })
const textInputs = wrapper.findAll('.form-group input[type="text"]')
expect(textInputs).toHaveLength(2, '商品编码+标题关键字两个文本筛选框(类目进侧栏、店铺/商品状态已下线)')
await textInputs[0].setValue('JD-1001')
await textInputs[1].setValue('保温杯')
// 分类筛选现在从侧栏店铺分类 Tab 来(旧「筛选店铺分类」下拉退役)。
// 合并搜索框(v1.7):一个框同时承载商品编码与标题(OR 语义在后端 SQL)。
const searchBox = wrapper.get('[aria-label="搜索商品"]')
expect(searchBox.attributes('placeholder')).toBe('搜索商品编码或标题')
await searchBox.setValue('保温杯')
// 分类筛选从侧栏店铺分类 Tab 来(旧「筛选店铺分类」下拉退役)。
await pickSideTab(wrapper, '店铺分类')
await sideRowBy(sideCustom(wrapper), '裙装').trigger('click')
await flushPromises()
// 同步起止收进筛选弹层(v1.7):开弹层→填日期→「应用」。
await openFilterPopover(wrapper)
const dateInputs = wrapper.findAll('input[type="date"]')
expect(dateInputs).toHaveLength(2, '弹层里同步起止两个日期框')
await dateInputs[0].setValue('2026-11-01')
await dateInputs[1].setValue('2026-11-09')
await wrapper.findAll('button').find((b) => b.text() === '查询')!.trigger('click')
await wrapper.findAll('button').find((b) => b.text() === '应用')!.trigger('click')
await flushPromises()
const last = jdApi.fetchJdProductList.mock.calls.at(-1)![0]
expect(last).toMatchObject({
productCode: 'JD-1001',
titleKeyword: '保温杯',
keyword: '保温杯',
groupId: '7',
syncedFrom: '2026-11-01',
syncedTo: '2026-11-09',
page: 1,
})
// 单参 toHaveProperty 才是「键不存在」的真判据(第二参会稀释成值断言):
// 页面 load() 入参已不带这三个键(店铺/商品状态筛选下线、公司维度 2026-11-16 摘除)。
expect(last).not.toHaveProperty('shopName')
// 旧编码/标题两框 v1.7 前端停发(合并进 keyword)、商品状态筛选下线、公司维度摘除。
// shopName 键 v1.7 随店铺名单回归页面入参层(空串=不限,序列化层不下发 shop_name)。
expect(last).not.toHaveProperty('productCode')
expect(last).not.toHaveProperty('titleKeyword')
expect(last.shopName).toBe('', '店铺入参空串=不限(Phase 3 侧栏点店铺行才带值)')
expect(last).not.toHaveProperty('saleStatus')
expect(last).not.toHaveProperty('companyId')
expect(wrapper.find('.jd-filter-popover').exists()).toBe(false, '「应用」后弹层收起')
wrapper.unmount()
})
it('重置把筛选面回空并回第一页重取(归属三档回未分类档、侧栏选中态清空)', async () => {
it('价格区间从弹层下发(AC-2):min/max 合法值随「应用」走查询;倒挡在门口拦下不发请求', async () => {
const wrapper = await mountWith({ items: [item(1)], total: 1, page: 1, pageSize: 50 })
const callsBefore = jdApi.fetchJdProductList.mock.calls.length
await openFilterPopover(wrapper)
await wrapper.get('[aria-label="最低价格"]').setValue('100')
await wrapper.get('[aria-label="最高价格"]').setValue('200')
await wrapper.findAll('button').find((b) => b.text() === '应用')!.trigger('click')
await flushPromises()
let last = jdApi.fetchJdProductList.mock.calls.at(-1)![0]
expect(last).toMatchObject({ minPrice: '100', maxPrice: '200', page: 1 },
'价格区间随「应用」下发(序列化层转 snake min_price/max_price)')
// 倒挡(100 > 200 形状反过来填):在弹层门口拦下,不发请求、弹层不收。
await openFilterPopover(wrapper)
await wrapper.get('[aria-label="最低价格"]').setValue('300')
await wrapper.get('[aria-label="最高价格"]').setValue('200')
const beforeInvalid = jdApi.fetchJdProductList.mock.calls.length
await wrapper.findAll('button').find((b) => b.text() === '应用')!.trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.length).toBe(beforeInvalid, '倒挡不发请求')
expect(wrapper.find('.jd-filter-popover').exists()).toBe(true, '倒挡时弹层不收(让用户改数)')
expect(document.body.textContent).toContain('价格区间最小值不能大于最大值')
wrapper.unmount()
})
it('重置把筛选面回空并回第一页重取(入口在弹层里;归属三档回未分类档、侧栏选中态清空)', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue(GROUPS)
const wrapper = await mountWith({ items: [], total: 0, page: 1, pageSize: 50 })
const textInputs = wrapper.findAll('.form-group input[type="text"]')
await textInputs[0].setValue('JD-1001')
await textInputs[1].setValue('保温杯')
await wrapper.get('[aria-label="搜索商品"]').setValue('保温杯')
await pickSideTab(wrapper, '店铺分类')
await sideRowBy(sideCustom(wrapper), '裙装').trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0]).toMatchObject({ groupId: '7' })
const callsBefore = jdApi.fetchJdProductList.mock.calls.length
await openFilterPopover(wrapper)
await wrapper.findAll('button').find((b) => b.text() === '重置')!.trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.length).toBeGreaterThan(callsBefore)
const last = jdApi.fetchJdProductList.mock.calls.at(-1)![0]
expect(last).toMatchObject({ productCode: '', titleKeyword: '', groupId: '', category: '', page: 1 }, '重置后筛选全空、回第一页')
expect(last).toMatchObject({ keyword: '', groupId: '', category: '', page: 1 }, '重置后筛选全空、回第一页')
expect(wrapper.find('.jd-filter-popover').exists()).toBe(false, '重置后弹层收起')
expect(sideCustom(wrapper).findAll('.jd-side-row.selected')).toHaveLength(0, '侧栏分类选中态随重置清空')
expect(sideCustom(wrapper).findAll('.jd-side-row')).toHaveLength(2,
'重置只清筛选面:侧栏分类清单(当前组)保留,清选语义=再点已选行')
wrapper.unmount()
})
it('翻页与改每页条数都重发请求,改条数回第一页', async () => {
// total=120(50/页下三页):第 2 页的「下一页」要有第 3 页可去。
const wrapper = await mountWith({ items: [item(1)], total: 120, page: 2, pageSize: 50 })
it('翻页与改每页条数都重发请求,改条数回第一页(档位 50/100/200/500/1000)', async () => {
// total=520(50/页下 11 页):第 2 页的「下一页」要有第 3 页可去。
const wrapper = await mountWith({ items: [item(1)], total: 520, page: 2, pageSize: 50 })
await wrapper.findAll('button').find((b) => b.text() === '下一页')!.trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList).toHaveBeenCalledTimes(2)
expect(jdApi.fetchJdProductList.mock.calls[1][0].page).toBe(3)
// 每页条数下拉随分页条换 el-select(OldPagination 内局部注册):
// 点开→点选项,不再走原生 setValue;档位 20/50/100(v1.6 契约)。
// 每页条数下拉随自绘分页条(v1.7):点开→点选项,不走原生 setValue。
expect(wrapper.find('.page-size-select').exists()).toBe(true, '分页条下拉保留 .page-size-select 定位类')
await pickSelectOption(wrapper, '每页条数', '20条/页')
await pickSelectOption(wrapper, '每页条数', '200条/页')
await flushPromises()
const last = jdApi.fetchJdProductList.mock.calls.at(-1)![0]
expect(last.pageSize).toBe(20)
expect(last.pageSize).toBe(200)
expect(last.page).toBe(1, '改每页条数后回第一页')
wrapper.unmount()
})
@@ -946,6 +993,105 @@ describe('筛选与分页(AC-9:列表 HTTP 参数与 v1.4 逐字等价)',
wrapper.unmount()
})
it('顶部分页五键(v1.7 F4):首页/上一页/刷新/下一页/末页边界置灰,刷新重发当前页', async () => {
// 夹具回显请求的 page:load() 会把服务端回的 page 写回页面态(result.page>=1 即采信),
// 固定 page:2 的夹具会把「首页」点击后的页面态拉回第 2 页、刷新就不是当前页语义了。
jdApi.fetchJdProductList.mockImplementation((params: { page: number }) =>
Promise.resolve({ items: [item(params.page)], total: 120, page: params.page, pageSize: 50 }))
const wrapper = mount(JdDatabasePage, { global: { plugins: [pinia, ElSelect, ElOption] } })
await flushPromises()
await flushPromises()
// 先翻到第 2 页再验五键。
await wrapper.findAll('button').find((b) => b.text() === '下一页')!.trigger('click')
await flushPromises()
const bar = wrapper.get('.jd-page-bar')
expect(bar.get('.jd-page-info').text()).toBe('第 2 / 3 页 · 共 120 条', '页码信息条文案逐字同')
const btn = (text: string) => [...bar.findAll('button')].find((b) => b.text() === text)
expect(btn('首页')!.attributes('disabled')).toBeUndefined('第 2 页可回首')
expect(btn('上一页')!.attributes('disabled')).toBeUndefined()
expect(btn('下一页')!.attributes('disabled')).toBeUndefined()
expect(btn('末页')!.attributes('disabled')).toBeUndefined()
await btn('首页')!.trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0].page).toBe(1)
// 第 1 页:首页/上一页置灰;刷新重发当前页。
const callsBefore = jdApi.fetchJdProductList.mock.calls.length
await btn('刷新')!.trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.length).toBe(callsBefore + 1, '刷新重发当前页')
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0].page).toBe(1)
expect(btn('首页')!.attributes('disabled')).toBeDefined('第 1 页首页置灰')
expect(btn('上一页')!.attributes('disabled')).toBeDefined()
await btn('末页')!.trigger('click')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0].page).toBe(3, '末页直达第 3 页')
expect(btn('下一页')!.attributes('disabled')).toBeDefined('末页上下一页置灰')
expect(btn('末页')!.attributes('disabled')).toBeDefined()
wrapper.unmount()
})
it('筛选回显条(v1.7 F5):激活筛选出芯片+共 N 条+清除筛选;清除保留分组作用域(AC-4)', async () => {
jdApi.fetchJdProductGroups.mockResolvedValue(GROUPS)
const wrapper = await mountWith({ items: [item(1)], total: 7, page: 1, pageSize: 50 })
expect(wrapper.find('.jd-filter-chips').exists()).toBe(false, '出厂态(默认未分类档)不渲染回显条')
// 激活一批筛选:搜索词+侧栏分类+弹层价格区间+同步区间。
await wrapper.get('[aria-label="搜索商品"]').setValue('保温杯')
await pickSideTab(wrapper, '店铺分类')
await sideRowBy(sideCustom(wrapper), '裙装').trigger('click')
await flushPromises()
await openFilterPopover(wrapper)
await wrapper.get('[aria-label="最低价格"]').setValue('100')
await wrapper.get('[aria-label="最高价格"]').setValue('200')
await wrapper.get('[aria-label="同步开始日期"]').setValue('2026-11-01')
await wrapper.get('[aria-label="同步结束日期"]').setValue('2026-11-09')
await wrapper.findAll('button').find((b) => b.text() === '应用')!.trigger('click')
await flushPromises()
const chips = wrapper.get('.jd-filter-chips')
const chipText = chips.text()
expect(chipText).toContain('搜索:保温杯')
expect(chipText).toContain('分类:裙装', '侧栏分类选中按分类名回显(groupOptions 里查名,不裸显 id)')
expect(chipText).toContain('价格:100 ~ 200')
expect(chipText).toContain('同步:2026-11-01 ~ 2026-11-09')
expect(chipText).toContain('共 7 条', '「共 N 条」给行集规模')
expect(chips.get('.jd-chip-clear').text()).toBe('清除筛选')
// 清除筛选:筛选面回出厂(含三档回未分类),分组作用域保留。
await chips.get('.jd-chip-clear').trigger('click')
await flushPromises()
const last = jdApi.fetchJdProductList.mock.calls.at(-1)![0]
expect(last).toMatchObject({ keyword: '', groupId: '', minPrice: '', maxPrice: '', syncedFrom: '', syncedTo: '' },
'清除筛选后筛选面回空')
expect(last.ownerGroupId).toBe(11, '清除筛选保留分组作用域(分组是作用域不是筛选条件)')
expect(last.classified).toBe('ungrouped', '归属三档回默认未分类档')
expect(wrapper.find('.jd-filter-chips').exists()).toBe(false, '清除后回显条消失(无激活筛选)')
expect(sideCustom(wrapper).findAll('.jd-side-row.selected')).toHaveLength(0, '侧栏分类选中态随清除清空')
wrapper.unmount()
})
it('底部已选条(v1.7 F7 骨架):勾选随卡片勾选框累计,「已选 N 件」实时可见', async () => {
const wrapper = await mountWith({ items: [item(1), item(2)], total: 2, page: 1, pageSize: 50 })
const bar = wrapper.get('.jd-select-bar')
expect(bar.text()).toBe('已选 0 件')
await cardBoxes(wrapper)[0].setValue(true)
expect(wrapper.get('.jd-select-bar').text()).toBe('已选 1 件')
await cardBoxes(wrapper)[1].setValue(true)
expect(wrapper.get('.jd-select-bar').text()).toBe('已选 2 件')
// 批量删除成功清勾选后回 0(条常驻不消失)。
jdApi.deleteJdProducts.mockResolvedValueOnce({ deleted: 2, imagesDeleted: 0, objectsDeleted: 0, objectsKept: 0, objectsSkipped: 0 })
await toolbarBtn(wrapper, '全选本页').trigger('click')
await wrapper.get('.jd-delete-btn').trigger('click')
await flushPromises()
await flushPromises()
expect(wrapper.get('.jd-select-bar').text()).toBe('已选 0 件')
wrapper.unmount()
})
it('空态与加载失败条(失败给重试,不把整页打死)', async () => {
const empty = await mountWith({ items: [], total: 0, page: 1, pageSize: 50 })
const tip = empty.find('.jd-empty-tip')
@@ -1129,7 +1275,7 @@ describe('京东数据库分类按数据权限分组隔离(V203)', () => {
wrapper.unmount()
})
it('分组住进筛选行但仍是作用域不是筛选条件:重置只清筛选面,分组保持当前组', async () => {
it('分组住进筛选行但仍是作用域不是筛选条件:重置(弹层里)只清筛选面,分组保持当前组', async () => {
jdApi.fetchJdCategoryScope.mockResolvedValue({
platformSuperAdmin: true,
defaultGroupId: 11,
@@ -1142,6 +1288,7 @@ describe('京东数据库分类按数据权限分组隔离(V203)', () => {
await pickSelectOption(wrapper, '当前分组', '甲公司 / B组')
await flushPromises()
expect(jdApi.fetchJdProductList.mock.calls.at(-1)![0]).toMatchObject({ ownerGroupId: 12 })
await openFilterPopover(wrapper)
await wrapper.findAll('button').find((b) => b.text() === '重置')!.trigger('click')
await flushPromises()
expect(selectByLabel(wrapper, '当前分组').props('modelValue')).toBe(12, '重置不清当前分组(作用域语义,搬进筛选行也不变)')