feat(jd): 普通账号在京东侧可见管理员店铺分类(2026-11-16 客户口径「管理员弄了多少店铺分类 普通账户都能看到」)——服务端新增 GET /api/jd-collect/groups 只读端点(复用 JdProductGroupService.list,requireOwnershipUserId fail-closed,与 categories 同形,无公司维度:分类是平台级全集);用户端「获取店铺数据」页加载即拉取,只读 chips 展示分类名+商品数(title 带明细),空态点名「管理员在京东数据库→店铺分类建」,拉取失败 warning 不阻塞采集主路(catch 棘轮 318→319 逐条点名);endpoints 冻结快照随带 dated 追加。判据:mvn -o test JdCollectGroupsEndpointTest 2/2;vue-tsc rc=0;node --test 定向 21/21;vitest mount 11/11(+2:chips 渲染带 count/空态提示);fast 闸门 overall=pass 四面绿;JdCollectTab.vue 791<800 棘轮线。商品上架侧落地时消费同一端点(欠账入 ops BACKLOG B113)

This commit is contained in:
2026-11-16 03:18:42 +08:00
parent 9b6f00a2dc
commit 3bccc97698
9 changed files with 250 additions and 1 deletions
@@ -87,7 +87,11 @@ const BASELINE = {
// loadCategoryOptions catch——类目选项拉取失败不阻塞建单(不选类目=全店采集的
// 主路照常),失败 ElMessage.warning 当场说给用户、原文只进 console;非静默,
// silent 一格没涨,只进 blocks。
blocks: 318,
// 319 = 318 + 1(2026-11-16 店铺分类只读块,客户口径「管理员弄了多少店铺分类 普通账户
// 都能看到」):JdCollectTab.vue 的 loadGroups catch——分类只是展示项,拉取失败
// ElMessage.warning 当场说给用户、原文只进 console,采集主路照常;非静默,
// silent 一格没涨,只进 blocks。
blocks: 319,
// 2026-10-30(ops Phase 6/可读棘轮):ApiSecretSettingsPanel.vue 1113→775 行,面板里那处
// 静默 catch(余额查询失败只 console.warn、界面留空)随 loadBalance 整块搬进
// useProxyPlan.ts。不是新增静默:面板 1→0、新文件记 1,silent 总数与 blocks 都一格没动,
+3
View File
@@ -321,9 +321,12 @@ test('test_endpoints_frozen_snapshot', () => {
// deleteTask(连带清理京东数据库该任务的行与断点游标,铁律 32 数据面)。
// 2026-11-16 类目多选:categories(公共库已落库 category_path 全集,建单页多选面板选项源,
// 鉴权照建单 requireOwnershipUserId fail-closed;后端 8b4f7a3a 同轮落)。
// 2026-11-16 店铺分类只读:groups(管理员在后管京东数据库建的分类+组内商品数,「获取店铺数据」
// 页展示给普通账号——客户口径「普通账户都能看到」;鉴权照 categories 同口径)。
"jdCollect": {
"create": "/api/jd-collect/tasks",
"categories": "/api/jd-collect/categories",
"groups": "/api/jd-collect/groups",
// activate 补录(存量漂移):8d8c88a5「补激活这一步」只改了常量表,快照没跟上,
// 本次任务面板改版全量跑才暴露(快照测试此前没在全量档里红过)。
"activate": "/api/jd-collect/tasks/{taskId}/activate",
+25
View File
@@ -48,6 +48,31 @@ test('endpoints 注册采集类目 categories 下拉端点', () => {
'endpoints.ts jdCollect 组缺 categories(建单页类目多选面板的选项源)')
})
/** 2026-11-16 客户口径「管理员弄了多少店铺分类 普通账户都能看到」:普通账号在
* 「获取店铺数据」页就能看到管理员在后管京东数据库建的分类全集与各组商品数;
* 本页只读——分类的增删改仍只在后管。「商品上架」落地后消费同一端点。 */
test('endpoints 注册店铺分类 groups 只读端点,页面加载并只读展示', () => {
const endpoints = readIfExists(ENDPOINTS, 'endpoints.ts')
assert.ok(endpoints.includes("groups: '/api/jd-collect/groups'"),
'endpoints.ts jdCollect 组缺 groups(店铺分类只读列表的选项源)')
const api = readIfExists(
join(process.cwd(), 'src', 'shared', 'api', 'types', 'modules', 'jd-collect.ts'),
'jd-collect.ts',
)
assert.ok(api.includes('export function fetchJdCollectGroups'),
'jd-collect.ts 缺 fetchJdCollectGroups(页面取分类列表的发送口)')
const page = readIfExists(
join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'),
'JdCollectTab.vue',
)
assert.ok(page.includes('fetchJdCollectGroups'),
'JdCollectTab.vue 必须调 fetchJdCollectGroups(普通账号在这里看到管理员建的分类)')
assert.ok(page.includes('店铺分类(管理员维护,只读)'),
'JdCollectTab.vue 必须有「店铺分类」只读展示块(口径点名「管理员维护,只读」)')
})
test('建单请求体与推送载荷都带 categoryPaths', () => {
const api = readIfExists(
join(process.cwd(), 'src', 'shared', 'api', 'types', 'modules', 'jd-collect.ts'),
@@ -23,6 +23,7 @@ const api = vi.hoisted(() => ({
// undefined 调用、enqueue 永远不被调用(本文件当时没跟上,红在这里)。
activateJdCollectTask: vi.fn(),
fetchJdCollectCategories: vi.fn(),
fetchJdCollectGroups: vi.fn(),
fetchJdCollectDashboard: vi.fn(),
fetchJdCollectHistory: vi.fn(),
fetchJdCollectTaskProgressBatch: vi.fn(),
@@ -36,6 +37,7 @@ vi.mock('@/shared/api/types/modules/jd-collect', () => ({
createJdCollectTask: api.createJdCollectTask,
activateJdCollectTask: api.activateJdCollectTask,
fetchJdCollectCategories: api.fetchJdCollectCategories,
fetchJdCollectGroups: api.fetchJdCollectGroups,
fetchJdCollectProgress: vi.fn(),
fetchJdCollectDashboard: api.fetchJdCollectDashboard,
fetchJdCollectHistory: api.fetchJdCollectHistory,
@@ -125,6 +127,7 @@ beforeEach(() => {
api.createJdCollectTask.mockResolvedValue({ taskId: 88, taskNo: 'JD-1', collectChannel: 'LOCAL' })
api.activateJdCollectTask.mockResolvedValue(null)
api.fetchJdCollectCategories.mockResolvedValue([])
api.fetchJdCollectGroups.mockResolvedValue([])
api.enqueue.mockResolvedValue({ success: true })
api.fetchJdCollectDashboard.mockResolvedValue(EMPTY_DASHBOARD)
api.fetchJdCollectHistory.mockResolvedValue({ items: [] })
@@ -309,4 +312,36 @@ describe('获取店铺数据:一键采集 + 任务面板', () => {
categoryPaths: ['女装'],
})
})
it('店铺分类只读块:页面加载即拉取并把管理员建的分类与商品数展示出来', async () => {
// 2026-11-16 客户口径「管理员弄了多少店铺分类 普通账户都能看到」:普通账号在
// 「获取店铺数据」页就能看到后管京东数据库建的分类全集;本页只读,不提供增删改。
api.fetchJdCollectGroups.mockResolvedValue([
{ id: 1, name: 'ASSS', sortOrder: 0, productCount: 20 },
{ id: 2, name: '家居日用', sortOrder: 1, productCount: 7 },
])
const w = await mountPage()
expect(api.fetchJdCollectGroups).toHaveBeenCalledTimes(1)
const block = w.findAll('.category-block').find((el) => el.text().includes('店铺分类'))
expect(block, '必须有「店铺分类」展示块').toBeTruthy()
expect(block!.text()).toContain('店铺分类(管理员维护,只读)')
const chips = block!.findAll('.group-chip')
expect(chips.length).toBe(2)
expect(chips[0].text()).toContain('ASSS(20)')
expect(chips[1].text()).toContain('家居日用(7)')
expect(chips[0].attributes('title')).toContain('ASSS:20 个商品')
})
it('后台还没建分类:只读块落空态提示,采集主路照常', async () => {
const w = await mountPage()
const block = w.findAll('.category-block').find((el) => el.text().includes('店铺分类'))
expect(block, '空态也要有「店铺分类」块(不能整块消失让用户以为没这功能)').toBeTruthy()
expect(block!.text()).toContain('后台还没建店铺分类')
expect(block!.text()).toContain('管理员在「京东数据库 → 店铺分类」里建的会显示在这里')
expect(block!.find('.group-chip').exists()).toBe(false)
// 拉取失败只 warning、不影响建单主路(catch 口径见 catch-silence-ratchet 319)
expect(w.find('.collect-btn').exists()).toBe(true)
})
})