feat(jd): 京东店铺分类按数据权限分组隔离(V203)

用户口径:不同组不能看到跨组的分类;当前组只管理员可以编辑分类,同组普通号可以进弹窗看但不能增删;
平台超管全量可见可编辑,公司超管管本公司全部组;归类也按组隔离且不再置人工编辑锁。

数据模型:biz_jd_product_group 加 owner_group_id(NOT NULL DEFAULT 0,
uk_company_owner_name(company_id, owner_group_id, name));新增 biz_jd_product_group_assign
(product_id, owner_group_id, category_id, uk_product_owner) 承接归类,同一商品各组可各自归类;
biz_jd_product.group_id 保留但零读零写。

权限:新增 JdCategoryScopeService(GET /api/admin/jd-product-groups/scope 回可见组 + 每组 editable)
四档矩阵;分类增删改与归类走 requireWritableGroup 403;商品行写(编辑/删除)仍只平台超管。

读面:列表/筛选/详情/归类一律按 owner_group_id,分类筛选 group_id 走归属表 EXISTS 下推
(不在 Java 侧 filter);用户端 /api/jd-collect/groups 按登录用户可见组收窄。

前端:工具栏「分组」下拉(多组才渲染,单组锁定显示);店铺分类弹窗对所有有该页菜单权限的人可见,
但按 editable 隐藏新建/改名/删除/勾选/归入移出;编辑抽屉「分类」下拉下线;只读提示改为
「只读:编辑/删除仅超级管理员可用;分类由本组管理员维护」。

验证:后端 mvn -o test 整量 5610 例 0 失败 19 skip;后管 npx vue-tsc 绿 / node --test 1919 绿 /
vitest 132 绿;用户端 vue-tsc 绿;python scripts/_push_gate.py --fast overall=pass。
迁移实跑与真机页面验收留发版窗口(本机无 MySQL/OSS);V203 需与另一路 V202 同窗口发布。
This commit is contained in:
2026-11-16 21:09:44 +08:00
parent e621deea58
commit 61ab844e5d
39 changed files with 2330 additions and 627 deletions
@@ -1,11 +1,16 @@
<script setup lang="ts">
/** 京东公共商品库:支持店铺分类和京麦类目组合筛选,分类管理在弹窗中完成。 */
/** 京东公共商品库:支持店铺分类和京麦类目组合筛选,分类管理在弹窗中完成。
* V203(2026-11-16 用户口径):分类按「数据权限分组」隔离——不同组看不到彼此的分类,
* 组管理员可建/改/删分类并归类,同组普通号可开弹窗看但只读;平台超管全量可见可编辑;
* 能看多组的人用工具栏「分组」下拉切换当前组(只有一组时锁定显示)。 */
import { computed, onMounted, reactive, ref } from 'vue'
import {
deleteJdProducts,
fetchJdCategoryScope,
fetchJdProductCategories,
fetchJdProductGroups,
fetchJdProductList,
type JdCategoryGroupOption,
type JdProductCategoryOption,
type JdProductGroup,
} from './jd-product-api.ts'
@@ -24,9 +29,8 @@ import LoadFailureBar from '@/components/LoadFailureBar.vue'
import { useAdminSessionStore } from '@/stores/admin-session'
import { formatDateTime, orderedPair } from '@/utils/datetime'
/** 写权限口径(2026-11-16 用户口径「京东数据库只有超管有编辑删除权限」):读按菜单权限可见,
* 写(编辑/删除/勾选批量删/店铺分类与批量归类)只对平台超级管理员渲染;后端同口径兜底 403
* (公司超管不在内,判据是站点 super_admin)。 */
/** 写权限口径(2026-11-16 用户口径):商品行写(编辑/删除/勾选批量删)只对平台超级管理员渲染;
* 分类写(建/改名/删除、归类)由 scope 的每组 editable 决定(本组管理员/公司超管/平台超管)。 */
const session = useAdminSessionStore()
const isSuperAdmin = computed(() => session.isSuperAdmin)
@@ -37,8 +41,12 @@ const total = ref(0)
const page = ref(1)
const pageSize = ref(20)
const filter = reactive(createJdProductFilterState())
/** 分组下拉选项:分组全平台一份(公共),进页取一次即可;选项失败不拦列表,只回空下拉
* (可见「全部分组」)。 */
/** 分类作用域(V203):可见分组 + 每组可写标记。失败静默回空作用域(分类列全空但商品照常)。 */
const categoryScope = ref<JdCategoryGroupOption[]>([])
const scopeDefaultGroupId = ref(0)
/** 当前分组(数据权限分组 id):分类列/分类筛选/分类管理的共同作用域。 */
const ownerGroupId = ref(0)
/** 当前分组的分类下拉选项(按 ownerGroupId 取,切组即换)。 */
const groupOptions = ref<JdProductGroup[]>([])
/** 类目下拉选项(京麦末级类目):与当前行集同源(公共库全量);失败静默回空。 */
const categoryOptions = ref<JdProductCategoryOption[]>([])
@@ -50,6 +58,15 @@ const groupDialogVisible = ref(false)
const editItem = ref<JdProductItem | null>(null)
const editVisible = ref(false)
/** 当前分组的下拉项(带 editable)——分类写入口与「店铺分类」弹窗的可管理档都读它。 */
const currentGroupOption = computed<JdCategoryGroupOption | null>(() =>
categoryScope.value.find((group) => group.id === ownerGroupId.value) || null)
const currentGroupName = computed(() => currentGroupOption.value?.name || '')
/** 分类可管理(建/改名/删除/归类):本组管理员、公司超管、平台超管(后端 scope 判)。 */
const canManageCategories = computed(() => currentGroupOption.value?.editable === true)
/** 分组下拉只在能看多组时才渲染;只有一组(含无可见组)时按锁定态展示。 */
const canSwitchGroup = computed(() => categoryScope.value.length > 1)
function openEdit(item: JdProductItem): void {
editItem.value = item
editVisible.value = true
@@ -74,10 +91,26 @@ function clampJdSyncedRange(): void {
const totalPages = computed(() => Math.max(1, Math.ceil(total.value / pageSize.value)))
/** 分组选项失败静默回空——分组只是筛选项,不该让它把首屏行集一起拖死。 */
/** 作用域 → 分组列表 → 该组分类:失败一律静默降级(分类只是筛选/归类面,不拦首屏行集)。 */
async function loadCategoryScope(): Promise<void> {
try {
const scope = await fetchJdCategoryScope()
categoryScope.value = scope.groups
scopeDefaultGroupId.value = scope.defaultGroupId ?? 0
} catch {
categoryScope.value = []
scopeDefaultGroupId.value = 0
}
// 当前分组:保留用户已选(仍可见时),否则回默认(可见组第一项)。
const keep = categoryScope.value.some((group) => group.id === ownerGroupId.value)
if (!keep) ownerGroupId.value = scopeDefaultGroupId.value
await loadGroupOptions()
}
/** 当前分组的分类选项:按 ownerGroupId 取(跨组不可见);失败静默回空下拉。 */
async function loadGroupOptions(): Promise<void> {
try {
groupOptions.value = await fetchJdProductGroups()
groupOptions.value = await fetchJdProductGroups(ownerGroupId.value)
} catch {
groupOptions.value = []
}
@@ -92,7 +125,17 @@ async function loadCategoryOptions(): Promise<void> {
}
}
/** 分组管理弹窗里做过变更:分组下拉与列表都刷新(删除分组后行集的 groupName 会变)。 */
/** 切换「分组」下拉:分类筛选(属于上一组的分类)清空,分类选项换成本组,回第一页重取。 */
async function changeOwnerGroup(next: number): Promise<void> {
if (next === ownerGroupId.value) return
ownerGroupId.value = next
filter.groupId = ''
await loadGroupOptions()
page.value = 1
await load()
}
/** 分类弹窗里做过变更:分类下拉与列表都刷新(删除分类后行集的 groupName 会变)。 */
async function onGroupChanged(deletedGroupId?: number): Promise<void> {
if (deletedGroupId && filter.groupId === String(deletedGroupId)) filter.groupId = ''
await loadGroupOptions()
@@ -111,6 +154,7 @@ async function load(): Promise<void> {
titleKeyword: filter.titleKeyword,
category: filter.category,
groupId: filter.groupId,
ownerGroupId: ownerGroupId.value,
syncedFrom: filter.syncedFrom,
syncedTo: filter.syncedTo,
})
@@ -232,10 +276,12 @@ async function removeMany(picked: JdProductItem[], message: string): Promise<voi
}
}
onMounted(() => {
void loadGroupOptions()
onMounted(async () => {
// 先解析作用域再取列表:首屏的 owner_group_id 必须与分类下拉同一个组(铁律 30 同形——
// 不要先发一条不带 owner_group_id 的列表请求再补,两次请求会落在不同默认组上)。
await loadCategoryScope()
void loadCategoryOptions()
void load()
await load()
})
</script>
@@ -283,9 +329,21 @@ onMounted(() => {
<LoadFailureBar v-if="loadFailure" :message="loadFailure" @retry="load" />
<div class="jd-toolbar">
<span class="jd-summary">共 {{ total }} 条京东商品</span>
<!-- 写入口只对平台超管渲染(2026-11-16「只有超管有编辑删除权限」):非超管看到只读提示。 -->
<span v-if="!isSuperAdmin" class="jd-readonly-tip">只读:编辑/删除仅超级管理员可用</span>
<button v-if="isSuperAdmin" class="btn btn-secondary" type="button" @click="groupDialogVisible = true">店铺分类</button>
<!-- 当前分组(V203):能看多组的人(平台超管/公司超管)用下拉切换;只有一组时锁定显示组名。
分组是分类列/分类筛选/分类管理的作用域,不是筛选条件 ⇒ 「重置」不清它。 -->
<select
v-if="canSwitchGroup"
:value="ownerGroupId"
aria-label="当前分组"
@change="changeOwnerGroup(Number(($event.target as HTMLSelectElement).value))"
>
<option v-for="group in categoryScope" :key="group.id" :value="group.id">{{ group.label }}</option>
</select>
<span v-else-if="currentGroupName" class="jd-group-locked" title="你的数据权限内只有这一个分组">分组:{{ currentGroupName }}</span>
<!-- 商品行写只对平台超管;分类写由当前分组 editable 决定(本组管理员/公司超管/平台超管)。
非超管看到只读提示,但「店铺分类」弹窗照常可开(同组普通号只读查看)。 -->
<span v-if="!isSuperAdmin" class="jd-readonly-tip">只读:编辑/删除仅超级管理员可用;分类由本组管理员维护</span>
<button class="btn btn-secondary" type="button" @click="groupDialogVisible = true">店铺分类</button>
<select v-model="filter.groupId" aria-label="筛选店铺分类" @change="apply">
<option value="">全部分类</option>
<option v-for="group in groupOptions" :key="group.id" :value="String(group.id)">{{ group.name }}</option>
@@ -369,7 +427,16 @@ onMounted(() => {
<OldPagination :total="total" :page="page" :page-size="pageSize" @change="changePage" @size-change="changeSize" />
</section>
<JdProductGroupDialog :visible="groupDialogVisible" :category-options="categoryOptions" @close="groupDialogVisible = false" @changed="onGroupChanged" />
<JdProductGroupDialog
:visible="groupDialogVisible"
:category-options="categoryOptions"
:owner-group-id="ownerGroupId"
:owner-group-name="currentGroupName"
:can-manage="canManageCategories"
:can-assign="canManageCategories"
@close="groupDialogVisible = false"
@changed="onGroupChanged"
/>
<JdProductDetailDrawer
:item="detailItem"
:visible="detailVisible"
@@ -1,6 +1,9 @@
<script setup lang="ts">
/** 店铺分类弹窗右栏:按京麦类目和标题筛选商品,勾选后归入左侧目标或移出分类。
* 两种操作都会设置人工编辑锁,弹窗提示采集不再覆盖以及价格、库存停更。 */
* V203(2026-11-16 用户口径):归类写「本组」的归属行(biz_jd_product_group_assign,
* 一组一商品一行),行集与归入/移出都带当前分组 ownerGroupId,同一商品在其他组可另归一类;
* 归类不再置人工编辑锁(采集照常更新价格/库存)。`canAssign=false`(同组普通号只读)
* 时勾选列与底部两个写按钮都不渲染,只留行集浏览。 */
import { computed, onMounted, ref, watch } from 'vue'
import JdCategoryCascader from './JdCategoryCascader.vue'
import { batchAssignJdProductGroup, fetchJdProductList } from './jd-product-api.ts'
@@ -15,6 +18,10 @@ const props = defineProps<{
selectedGroup: JdProductGroup | null
categoryOptions: JdProductCategoryOption[]
refreshVersion: number
/** 当前数据权限分组:行集的分类列与归类落点都以它为作用域。 */
ownerGroupId: number
/** 本账号可归类(本组管理员/公司超管/平台超管);false=只读浏览。 */
canAssign: boolean
}>()
const emit = defineEmits<{ (event: 'changed'): void }>()
@@ -34,8 +41,9 @@ const assigning = ref(false)
const selectedCount = computed(() => selectedProductIds.value.size)
/** 归入所选分类:必须先在左侧点亮一个分类且有勾选行。 */
const removableIds = computed(() => products.value.filter(row => selectedProductIds.value.has(row.id) && row.groupId != null && row.groupId > 0).map(row => row.id))
const canAssign = computed(() => !!props.selectedGroup && selectedCount.value > 0 && !assigning.value && !productsLoading.value)
const canRemove = computed(() => removableIds.value.length > 0 && !assigning.value && !productsLoading.value)
/** 可提交「归入」(props.canAssign 是权限,这里的名字避开与 prop 同名)。 */
const canSubmitAssign = computed(() => props.canAssign && !!props.selectedGroup && selectedCount.value > 0 && !assigning.value && !productsLoading.value)
const canRemove = computed(() => props.canAssign && removableIds.value.length > 0 && !assigning.value && !productsLoading.value)
const allSelected = computed(() =>
products.value.length > 0 && products.value.every((row) => selectedProductIds.value.has(row.id)))
@@ -51,6 +59,7 @@ async function loadProducts(): Promise<void> {
pageSize: PRODUCT_PAGE_SIZE,
titleKeyword: keyword.value.trim(),
category: category.value,
ownerGroupId: props.ownerGroupId,
})
if (request !== requestVersion) return
products.value = result.items
@@ -98,14 +107,15 @@ function toggleSelectAll(checked: boolean): void {
selectedProductIds.value = checked ? new Set(products.value.map((row) => row.id)) : new Set()
}
/** 勾选行 → 归入左栏点亮的分类。成功后分类商品数(父件)与右栏行集都刷新(归类过的行离开「未分类」)。 */
/** 勾选行 → 归入左栏点亮的分类(写本组归属行)。成功后分类商品数(父件)与右栏行集都刷新
* (归类过的行离开「未分类」)。 */
async function assignToSelected(): Promise<void> {
const target = props.selectedGroup
if (!target || !canAssign.value) return
if (!target || !canSubmitAssign.value) return
assigning.value = true
productsError.value = ''
try {
const updated = await batchAssignJdProductGroup([...selectedProductIds.value], target.id)
const updated = await batchAssignJdProductGroup([...selectedProductIds.value], target.id, props.ownerGroupId)
showAdminFeedback(`已把 ${updated} 个商品归入「${target.name}」`, 'success')
emit('changed')
await loadProducts()
@@ -116,13 +126,13 @@ async function assignToSelected(): Promise<void> {
}
}
/** 勾选行 → 移出分类(group_id 置 NULL,回到未分类)。 */
/** 勾选行 → 移出本组分类(删本组归属行,商品回到未分类;别组的归类不受影响)。 */
async function removeFromCategory(): Promise<void> {
if (!canRemove.value) return
assigning.value = true
productsError.value = ''
try {
const updated = await batchAssignJdProductGroup(removableIds.value, null)
const updated = await batchAssignJdProductGroup(removableIds.value, null, props.ownerGroupId)
showAdminFeedback(`已把 ${updated} 个商品移出分类`, 'success')
emit('changed')
await loadProducts()
@@ -154,14 +164,14 @@ onMounted(() => {
<table v-if="products.length">
<thead>
<tr>
<th class="col-check"><input type="checkbox" :disabled="productsLoading || assigning" :checked="allSelected" @change="toggleSelectAll(($event.target as HTMLInputElement).checked)" /></th>
<th v-if="canAssign" class="col-check"><input type="checkbox" :disabled="productsLoading || assigning" :checked="allSelected" @change="toggleSelectAll(($event.target as HTMLInputElement).checked)" /></th>
<th>商品信息</th>
<th class="col-group">当前分类</th>
</tr>
</thead>
<tbody>
<tr v-for="row in products" :key="row.id">
<td class="col-check">
<td v-if="canAssign" class="col-check">
<input
type="checkbox"
:disabled="productsLoading || assigning"
@@ -187,10 +197,10 @@ onMounted(() => {
<p v-else-if="!productsError" class="pane-tip">没有符合条件的商品</p>
</div>
<div class="product-footer">
<div v-if="canAssign" class="product-footer">
<span class="pick-summary">已勾选 {{ selectedCount }} 个商品</span>
<div class="footer-actions">
<button class="btn btn-small" type="button" :disabled="!canAssign" @click="assignToSelected">
<button class="btn btn-small" type="button" :disabled="!canSubmitAssign" @click="assignToSelected">
{{ assigning ? '归类中...' : selectedGroup ? `归入「${selectedGroup.name}」` : '归入所选分类' }}
</button>
<button class="btn btn-danger btn-small" type="button" :disabled="!canRemove" @click="removeFromCategory">移出分类</button>
@@ -7,6 +7,9 @@
* +可选块(attrGroups 重建 attr_json 的 tabs 段、skus 按 skuId 改价格库存、deleteImageIds
* 删图——先删桶、共用对象保留)。保存即置人工编辑锁 manual_locked=1:后续采集不再覆盖该行,
* 底部常驻提示点名这件事。
* V203(2026-11-16):分类<b>不在本抽屉编辑</b>(分类按数据权限分组隔离,归属存
* biz_jd_product_group_assign,归类只走「店铺分类」弹窗)——原「分类」下拉与 groupId 负载已下线,
* 避免写遗留的 biz_jd_product.group_id 列造成「界面改了、列表分组没变」。
* 图片区拆在 JdProductImageManager 子组件(2026-11-16:× 右上角标删+替换/新增本地图,
* B109-01 落地;标删集合经 update:deleteIds 上抛进保存负载,上传立即生效由子组件自理)。
* 京东时间/信息分/商品编码只读。
@@ -14,9 +17,7 @@
import { computed, ref, watch } from 'vue'
import {
fetchJdProductDetail,
fetchJdProductGroups,
updateJdProduct,
type JdProductGroup,
} from './jd-product-api.ts'
import JdProductImageManager from './JdProductImageManager.vue'
import type {
@@ -59,7 +60,6 @@ const form = ref({
priceMax: '',
stockTotal: '' as string,
saleStatus: '',
groupId: '' as string,
})
const draftAttrGroups = ref<DraftAttrGroup[]>([])
const draftSkus = ref<JdProductSku[]>([])
@@ -68,7 +68,6 @@ const images = ref<JdProductImage[]>([])
const managerDeleteIds = ref<number[]>([])
/** attr_json 解析失败(attrJsonRaw 兜底行):属性块禁用,防保存把原文形状弄丢。 */
const attrJsonRaw = ref('')
const groupOptions = ref<JdProductGroup[]>([])
const skuDimensions = computed(() => jdSkuDimensions(draftSkus.value))
@@ -89,11 +88,7 @@ async function loadDetail(): Promise<void> {
loadFailure.value = ''
saveError.value = ''
try {
const [detail, groups] = await Promise.all([
fetchJdProductDetail(item.id),
fetchJdProductGroups().catch(() => [] as JdProductGroup[]),
])
groupOptions.value = groups
const detail = await fetchJdProductDetail(item.id)
const row = detail.item
form.value = {
title: row.title,
@@ -104,7 +99,6 @@ async function loadDetail(): Promise<void> {
priceMax: row.priceMax,
stockTotal: row.stockTotal === null ? '' : String(row.stockTotal),
saleStatus: row.saleStatus,
groupId: row.groupId === null ? '' : String(row.groupId),
}
// 深拷贝草稿:直接改副本,保存前才拼负载。
draftAttrGroups.value = detail.attrGroups.map((group: JdProductAttrGroup) => ({
@@ -145,7 +139,6 @@ async function save(): Promise<void> {
priceMax: form.value.priceMax.trim() || null,
stockTotal: form.value.stockTotal.trim() === '' ? null : Number(form.value.stockTotal),
saleStatus: form.value.saleStatus.trim() || null,
groupId: form.value.groupId === '' ? null : Number(form.value.groupId),
// 属性块:原文兜底行(解析失败)不提交,防保存把解析不出的原文形状弄丢。
attrGroups: attrJsonRaw.value
? null
@@ -175,7 +168,6 @@ async function save(): Promise<void> {
form.value.priceMax = detail.item.priceMax
form.value.stockTotal = detail.item.stockTotal === null ? '' : String(detail.item.stockTotal)
form.value.saleStatus = detail.item.saleStatus
form.value.groupId = detail.item.groupId === null ? '' : String(detail.item.groupId)
draftAttrGroups.value = detail.attrGroups.map((group) => ({
groupName: group.groupName,
attrs: group.attrs.map((attr) => ({ ...attr })),
@@ -256,15 +248,6 @@ function dash(value: string | number | null | undefined): string {
<label>总库存</label>
<input v-model="form.stockTotal" type="text" inputmode="numeric" />
</div>
<div class="edit-item">
<label>分类</label>
<select v-model="form.groupId">
<option value="">未分类</option>
<option v-for="group in groupOptions" :key="group.id" :value="String(group.id)">
{{ group.name }}
</option>
</select>
</div>
<div class="edit-item">
<label>商品编码(只读)</label>
<input type="text" :value="dash(item?.productCode)" readonly class="readonly" />
@@ -1,6 +1,8 @@
<script setup lang="ts">
/** 店铺分类弹窗:左侧管理分类和选择归类目标,右侧按京麦类目筛选商品并批量归类。
* 人工归类会设置编辑锁,采集不再覆盖商品;变更后通知页面刷新。 */
/** 店铺分类弹窗:左侧管理当前分组的分类并选择归类目标,右侧按京麦类目筛选商品并批量归类。
* V203(2026-11-16 用户口径):分类按「数据权限分组」隔离——弹窗只显示当前分组的分类;
* `canManage=false`(同组普通号)可打开看,但新建行、改名/删除按钮与归类入口都不渲染;
* 归类写归属表(biz_jd_product_group_assign),不置人工编辑锁(采集照常更新商品行)。 */
import { computed, ref, watch } from 'vue'
import {
createJdProductGroup,
@@ -17,11 +19,18 @@ import { requestErrorMessage } from '../../api/envelope.ts'
const props = defineProps<{
visible: boolean
categoryOptions: JdProductCategoryOption[]
/** 当前数据权限分组(分类的归属与可见范围);0=没有可管理/可见的组。 */
ownerGroupId: number
ownerGroupName: string
/** 本账号对当前分组分类可写(建/改名/删除);缺省 false=只读查看。 */
canManage: boolean
/** 可归类(本组管理员/公司超管/平台超管);与 canManage 同源,但分开传便于后续细分。 */
canAssign: boolean
}>()
const emit = defineEmits<{ (event: 'close'): void; (event: 'changed', deletedGroupId?: number): void }>()
// ---------------- 左栏:分类管理(分组全平台一份,界面措辞「分类」) ----------------
// ---------------- 左栏:分类管理(当前分组一份,界面措辞「分类」) ----------------
const loading = ref(false)
const errorText = ref('')
@@ -37,14 +46,27 @@ const paneRefreshVersion = ref(0)
/** 左侧点亮的分类=右栏「归入所选分类」的归类目标;删除后自动清掉。 */
const selectedGroupId = ref(0)
const canCreate = computed(() => createName.value.trim().length > 0 && !creating.value && !saving.value)
const canCreate = computed(() => props.canManage && createName.value.trim().length > 0 && !creating.value && !saving.value)
const selectedGroup = computed(() => groups.value.find((group) => group.id === selectedGroupId.value) || null)
/** 标题带当前分组名(跨组同名分类靠它区分)。 */
const dialogTitle = computed(() => props.ownerGroupName ? `店铺分类 · ${props.ownerGroupName}` : '店铺分类')
/** 空列表文案分三种:不属于任何组 / 本组还没分类(可管理)/ 本组还没分类(只读)。 */
const emptyListText = computed(() => {
if (props.ownerGroupId <= 0) return '你还不属于任何数据权限分组'
return props.canManage ? '本组暂无分类,先新建一个' : '本组暂无分类'
})
async function loadGroups(): Promise<void> {
if (props.ownerGroupId <= 0) {
groups.value = []
loading.value = false
errorText.value = ''
return
}
loading.value = true
errorText.value = ''
try {
groups.value = await fetchJdProductGroups()
groups.value = await fetchJdProductGroups(props.ownerGroupId)
} catch (error) {
errorText.value = requestErrorMessage(error) || '分类列表加载失败'
groups.value = []
@@ -62,7 +84,7 @@ async function refreshAfterChange(deletedGroupId?: number, refreshPane = false):
emit('changed', deletedGroupId)
if (refreshPane) paneRefreshVersion.value++
try {
groups.value = sortGroups(await fetchJdProductGroups())
groups.value = sortGroups(await fetchJdProductGroups(props.ownerGroupId))
} catch (error) {
errorText.value = `操作已成功,分类列表刷新失败:${requestErrorMessage(error) || '请重试'}`
}
@@ -70,11 +92,11 @@ async function refreshAfterChange(deletedGroupId?: number, refreshPane = false):
async function submitCreate(): Promise<void> {
const name = createName.value.trim()
if (!name || creating.value) return
if (!name || creating.value || !props.canManage) return
creating.value = true
errorText.value = ''
try {
await createJdProductGroup({ name, sortOrder: 0 })
await createJdProductGroup({ name, sortOrder: 0, ownerGroupId: props.ownerGroupId })
createName.value = ''
await refreshAfterChange()
} catch (error) {
@@ -132,9 +154,9 @@ async function removeGroup(group: JdProductGroup): Promise<void> {
}
}
/** 左侧点亮分类作为右栏归类目标。 */
/** 左侧点亮分类作为右栏归类目标(只读账号没有归类入口,点亮无意义 ⇒ 直接不响应)。 */
function pickGroup(group: JdProductGroup): void {
if (saving.value) return
if (saving.value || !props.canAssign) return
selectedGroupId.value = group.id
}
@@ -162,19 +184,19 @@ function onPaneChanged(): void {
<div v-if="visible" class="modal-mask" @click.self="emit('close')">
<div class="group-modal">
<div class="modal-head">
<h3>店铺分类</h3>
<h3>{{ dialogTitle }}</h3>
<button class="modal-close" type="button" aria-label="关闭" @click="emit('close')">×</button>
</div>
<p class="modal-tip">
左侧管理分类并点选目标分类;右侧勾选商品后「归入所选分类」或「移出分类」。
人工归类过的商品不再被采集自动覆盖(价格/库存等字段停更)。
<template v-if="canAssign">左侧管理本组分类并点选目标分类;右侧勾选商品后「归入所选分类」或「移出分类」。归类只记在分类归属上,不影响采集对价格/库存的更新。</template>
<template v-else>左侧是本组分类(只读);分类的新建/改名/删除与商品归类由本组管理员操作。</template>
</p>
<p v-if="errorText" class="group-error">{{ errorText }}</p>
<div class="split-body">
<!-- 左栏:分类管理 -->
<!-- 左栏:分类管理(只读账号不渲染新建行,改名/删除按钮逐行隐藏) -->
<aside class="left-pane">
<div class="group-create">
<div v-if="canManage" class="group-create">
<input
v-model="createName"
type="text"
@@ -211,18 +233,25 @@ function onPaneChanged(): void {
<template v-else>
<span class="group-name" :title="group.name">{{ group.name }}</span>
<span class="group-meta">{{ group.productCount }}</span>
<span class="group-actions" @click.stop>
<span v-if="canManage" class="group-actions" @click.stop>
<button class="btn btn-secondary btn-mini" type="button" @click="startRename(group)">改名</button>
<button class="btn btn-danger btn-mini" type="button" :disabled="saving" @click="removeGroup(group)">删除</button>
</span>
</template>
</li>
<li v-if="!loading && !groups.length && !errorText" class="pane-tip">暂无分类,先新建一个</li>
<li v-if="!loading && !groups.length && !errorText" class="pane-tip">{{ emptyListText }}</li>
</ul>
</aside>
<!-- 右栏:商品人工归类(独立件,行集/勾选/批量归类都在那里) -->
<JdProductAssignPane :selected-group="selectedGroup" :category-options="categoryOptions" :refresh-version="paneRefreshVersion" @changed="onPaneChanged" />
<!-- 右栏:商品人工归类(独立件,行集/勾选/批量归类都在那里;只读账号不含写入口) -->
<JdProductAssignPane
:selected-group="selectedGroup"
:category-options="categoryOptions"
:refresh-version="paneRefreshVersion"
:owner-group-id="ownerGroupId"
:can-assign="canAssign"
@changed="onPaneChanged"
/>
</div>
</div>
</div>
@@ -156,6 +156,12 @@ h3 {
font-size: 12.5px;
white-space: nowrap;
}
/* 只有一个可见分组时锁定的组名(不可切):与下拉同位置同字号,视觉上不跳。 */
.jd-group-locked {
color: #4e6479;
font-size: 12.5px;
white-space: nowrap;
}
.table-scroll {
width: 100%;
min-width: 0;
@@ -34,17 +34,22 @@ export async function fetchJdProductList(
},
params.page,
params.pageSize,
params.ownerGroupId ?? null,
)
const { data } = await http.get<unknown>(JD_PRODUCT_ENDPOINT, { params: query })
return parseJdProductPage(data)
}
/** 详情:GET /api/admin/jd-products/{id}(信封 data=主字段 + attrGroups + attrJsonRaw + images)。
* 公共库无公司维度,按 id 直取。 */
* 公共库无公司维度,按 id 直取;分类字段按「当前分组」(owner_group_id)取(V203)。 */
export async function fetchJdProductDetail(
id: number,
ownerGroupId?: number | null,
): Promise<ReturnType<typeof parseJdProductDetail>> {
const { data } = await http.get<unknown>(`${JD_PRODUCT_ENDPOINT}/${id}`)
const params = typeof ownerGroupId === 'number' && ownerGroupId > 0
? { owner_group_id: ownerGroupId }
: undefined
const { data } = await http.get<unknown>(`${JD_PRODUCT_ENDPOINT}/${id}`, { params })
return parseJdProductDetail(data)
}
@@ -72,7 +77,8 @@ export async function deleteJdProducts(
/** 编辑提交负载(PUT /api/admin/jd-products/{id} body,后端 JdProductUpdateRequest):
* 主字段全量提交;attrGroups/skus/deleteImageIds 可选——null=不修改该块
* (后端对 null 块零触碰)。 */
* (后端对 null 块零触碰)。分类不在本负载里(V203:分类按数据权限分组归属存
* biz_jd_product_group_assign,编辑面不写 group_id,归类只走「店铺分类」弹窗)。 */
export interface JdProductUpdatePayload {
title: string
brand: string | null
@@ -82,7 +88,6 @@ export interface JdProductUpdatePayload {
priceMax: string | null
stockTotal: number | null
saleStatus: string | null
groupId: number | null
attrGroups: { groupName: string; attrs: { key: string; label: string; value: string }[] }[] | null
skus: { skuId: string; price: string | null; stock: number | null }[] | null
deleteImageIds: number[] | null
@@ -129,17 +134,37 @@ export async function uploadJdProductImage(
return parseJdProductDetail(data)
}
/** 分组行(GET 列表返回:[{id,name,sortOrder,productCount}])。 */export interface JdProductGroup {
/** 分组行(GET 列表返回:[{id,name,ownerGroupId,sortOrder,productCount}])。 */
export interface JdProductGroup {
id: number
name: string
ownerGroupId: number
sortOrder: number
productCount: number
}
/** 分组管理的写入负载(POST / PUT body:{name, sortOrder})。 */
/** 分组管理的写入负载(POST / PUT body:{name, sortOrder, ownerGroupId?})。 */
export interface JdProductGroupPayload {
name: string
sortOrder: number
/** 新建时归属的数据权限分组(缺省=操作者自己带的组,后端 requireWritableGroup 收敛)。 */
ownerGroupId?: number | null
}
/** 「当前分组」下拉的一项(GET /scope 的 groups[],V203):editable=本账号对该组分类可写
* (建/改名/删除/归类)。跨公司的组名由后端拼进 label,前端不解析公司字段。 */
export interface JdCategoryGroupOption {
id: number
name: string
label: string
editable: boolean
}
/** 分类作用域回执(GET /api/admin/jd-product-groups/scope):分组下拉 + 平台超管标记。 */
export interface JdCategoryScope {
platformSuperAdmin: boolean
defaultGroupId: number | null
groups: JdCategoryGroupOption[]
}
/** 分组信封是 `{code, message, data}` 三段式:code 非 0 =业务失败,message 是中文文案
@@ -156,10 +181,13 @@ function numberOr(value: unknown, fallback: number): number {
return typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : fallback
}
/** 分组下拉/管理列表(分组 2026-11-15 起全平台一份,不带公司维度);失败由页面自己兜
* (分组只是筛选项,不拦首屏行集)。 */
export async function fetchJdProductGroups(): Promise<JdProductGroup[]> {
const { data } = await http.get<unknown>(JD_PRODUCT_GROUP_ENDPOINT)
/** 分组下拉/管理列表:按「当前分组」(owner_group_id)取该组的分类(V203,跨组不可见);
* 缺省=后端按作用域默认分组取。失败由页面自己兜(分类只是筛选项,不拦首屏行集)。 */
export async function fetchJdProductGroups(ownerGroupId?: number | null): Promise<JdProductGroup[]> {
const params = typeof ownerGroupId === 'number' && ownerGroupId > 0
? { owner_group_id: ownerGroupId }
: undefined
const { data } = await http.get<unknown>(JD_PRODUCT_GROUP_ENDPOINT, { params })
const core = unwrap<unknown>(data)
if (!Array.isArray(core)) return []
const out: JdProductGroup[] = []
@@ -171,6 +199,7 @@ export async function fetchJdProductGroups(): Promise<JdProductGroup[]> {
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),
})
@@ -178,6 +207,35 @@ export async function fetchJdProductGroups(): Promise<JdProductGroup[]> {
return out
}
/** 分类作用域(GET /scope):本账号可见的数据权限分组 + 每组可写标记。
* 页面用它渲染「分组」下拉、按 editable 渲染分类写入口;失败由页面自己兜(回空作用域=
* 分类列全空、弹窗提示不属于任何分组,但商品列表照常可用)。 */
export async function fetchJdCategoryScope(): Promise<JdCategoryScope> {
const { data } = await http.get<unknown>(`${JD_PRODUCT_GROUP_ENDPOINT}/scope`)
const core = groupDataOf<unknown>(data)
const record = core && typeof core === 'object' ? (core as Record<string, unknown>) : {}
const rawGroups = Array.isArray(record.groups) ? record.groups : []
const groups: JdCategoryGroupOption[] = []
for (const raw of rawGroups) {
if (!raw || typeof raw !== 'object') continue
const row = raw as Record<string, unknown>
const id = numberOr(row.id, 0)
if (id <= 0) continue
const name = typeof row.name === 'string' ? row.name.trim() : ''
groups.push({
id,
name,
label: typeof row.label === 'string' && row.label.trim() ? row.label.trim() : name,
editable: row.editable === true,
})
}
return {
platformSuperAdmin: record.platformSuperAdmin === true || record.platform_super_admin === true,
defaultGroupId: numberOr(record.defaultGroupId ?? record.default_group_id, 0) || null,
groups,
}
}
/** 类目下拉选项(GET /categories 返回 [{name, productCount}],name=京麦末级类目即
* 落库的 category_path;等值过滤)。失败由页面自己兜(类目只是筛选项,不拦首屏行集)。 */
export interface JdProductCategoryOption {
@@ -200,11 +258,15 @@ export async function fetchJdProductCategories(): Promise<JdProductCategoryOptio
return out
}
/** 新建分组(公共库无公司维度);重名等业务失败把后端中文文案抛回(页面直接展示)。 */
/** 新建分类(归属当前分组,V203):ownerGroupId 缺省=后端取操作者自己带的组;
* 同一分组内重名等业务失败把后端中文文案抛回(页面直接展示)。 */
export async function createJdProductGroup(
payload: JdProductGroupPayload,
): Promise<JdProductGroup | null> {
const body: Record<string, unknown> = { name: payload.name, sortOrder: payload.sortOrder }
if (typeof payload.ownerGroupId === 'number' && payload.ownerGroupId > 0) {
body.ownerGroupId = payload.ownerGroupId
}
const { data } = await http.post<unknown>(JD_PRODUCT_GROUP_ENDPOINT, body)
return groupDataOf<JdProductGroup | null>(data)
}
@@ -226,15 +288,17 @@ export async function deleteJdProductGroup(id: number): Promise<void> {
}
/** 批量人工归类(店铺分类弹窗 2026-11-15 + 京东数据库页工具栏「移除分类」2026-11-16):
* 勾选商品行 → 归入指定分类或移出分类。
* groupId 传 null=移出分类(后端把 group_id 置 NULL);返回实际更新的行数。
* 后端与单行编辑同口径置 manual_locked=1(归类即人工干预,采集不再覆盖/清理该行)。
* 业务失败(分类不存在等)把中文文案抛回,弹窗红条原样展示。公共库写侧无公司维度。 */
* 勾选商品行 → 归入当前分组(ownerGroupId)的指定分类或移出分类(V203:归属写
* biz_jd_product_group_assign 的 (product_id, owner_group_id) 一行,同一商品各组可各自归类)。
* groupId 传 null=移出本组分类;返回实际写入/解挂的归属行数。
* 归类<b>不再置人工编辑锁</b>(2026-11-16 用户拍板):分类不在商品行上,采集冲不掉它。
* 业务失败(分类不存在/不属于当前分组)把中文文案抛回,弹窗红条原样展示。 */
export async function batchAssignJdProductGroup(
ids: number[],
groupId: number | null,
ownerGroupId: number,
): Promise<number> {
const body: Record<string, unknown> = { ids, groupId }
const body: Record<string, unknown> = { ids, groupId, ownerGroupId }
const { data } = await http.post<unknown>(`${JD_PRODUCT_ENDPOINT}/batch-assign-group`, body)
return groupDataOf<number>(data)
}
@@ -1,7 +1,7 @@
/** 京东数据库页筛选纯函数(v1.4 Phase 5):商品编码/标题关键字/类目/分组/分类状态/同步起止 + snake 分页参数。
/** 京东数据库页筛选纯函数(v1.4 Phase 5):商品编码/标题关键字/类目/分组/同步起止 + snake 分页参数。
* 产出与后端契约 §列表 query 逐字对撞:`page`/`page_size`(默认 20、上限 100)、
* `product_code`、`title_keyword`、`category`(京麦末级类目等值过滤,2026-11-15 增)、
* `group_id`、
* `group_id`(当前分组下的分类 id)、`owner_group_id`(当前数据权限分组,V203)、
* `synced_from`/`synced_to`(ISO yyyy-MM-dd;空白不下发)。
* 商品状态筛选与导出(2026-11-15 客户口径「这两个不要/导出也不用」)已从前端下线;
* 店铺筛选同日客户口径「店铺不需要」从前端下线(后端 shop_name 参数同窗撤,DB 列与详情不动)。
@@ -57,12 +57,15 @@ export interface JdProductQuery {
title_keyword?: string
/** 京麦末级类目等值过滤(后端 JdProductQueryService.Filter.category)。 */
category?: string
/** 自定义分类 id(当前分组下的一个分类;V203 起按归属表 EXISTS 过滤)。 */
group_id?: number
/** 当前数据权限分组 id(分类列/分类筛选都按它取;V203「不同组不能看到跨组的分类」)。 */
owner_group_id?: number
synced_from?: string
synced_to?: string
}
/** api 模块的入参:筛选态 + 分页(公共库无公司维度)。 */
/** api 模块的入参:筛选态 + 分页 + 当前分组(公共库无公司维度)。 */
export interface JdProductListParams {
page: number
pageSize: number
@@ -70,6 +73,8 @@ export interface JdProductListParams {
titleKeyword?: string
category?: string
groupId?: string
/** 当前分组(数据权限分组 id):分类列/分类筛选的作用域,非筛选条件(重置不清它)。 */
ownerGroupId?: number | null
syncedFrom?: string
syncedTo?: string
}
@@ -92,18 +97,25 @@ function toJdProductFilterQuery(state: JdProductFilterState): Omit<JdProductQuer
return query
}
/** 过滤态 + 分页 → 列表查询参数;空白/非法日期不下发,分页钳制在此单出口(不含公司维)。 */
/** 过滤态 + 分页 → 列表查询参数;空白/非法日期不下发,分页钳制在此单出口(不含公司维)。
* {@code ownerGroupId} 是「当前分组」(分类列/分类筛选作用域,V203),不是筛选条件:
* >0 时下发 `owner_group_id`,缺省/0 不下发=后端按作用域默认分组取。 */
export function toJdProductListParams(
state: JdProductFilterState,
page: number,
pageSize: number,
ownerGroupId?: number | null,
): JdProductQuery {
const safePage = Math.min(Math.max(Math.floor(page) || 1, 1), JD_PRODUCT_MAX_PAGE)
const rawSize = Math.floor(pageSize) || JD_PRODUCT_PAGE_SIZE
const safeSize = Math.min(Math.max(rawSize, 1), JD_PRODUCT_MAX_PAGE_SIZE)
return {
const query: JdProductQuery = {
page: safePage,
page_size: safeSize,
...toJdProductFilterQuery(state),
}
if (typeof ownerGroupId === 'number' && Number.isFinite(ownerGroupId) && ownerGroupId > 0) {
query.owner_group_id = Math.floor(ownerGroupId)
}
return query
}