feat(keywordusage): 新增关键词使用记录并归位店铺管理菜单
V175 把品牌Gating库从数据管理组迁到店铺管理组(排序85),并在其后新增 关键词使用记录独立菜单(排序86)。后端新增只读查询模块,按公司范围读取 keyword_usage/keyword_add_log/keyword_delete_log,前端提供使用/删除记录、 统计卡与筛选。
This commit is contained in:
@@ -13,6 +13,8 @@ const MIGRATION = join(process.cwd(), '..', 'backend-java', 'src', 'main', 'reso
|
||||
'V143__company_and_users_company_id.sql')
|
||||
const BRAND_GATING_MIGRATION = join(process.cwd(), '..', 'backend-java', 'src', 'main', 'resources', 'db',
|
||||
'V174__restore_admin_brand_gating_menu.sql')
|
||||
const KEYWORD_USAGE_MIGRATION = join(process.cwd(), '..', 'backend-java', 'src', 'main', 'resources', 'db',
|
||||
'V175__move_gating_and_add_keyword_usage_menu.sql')
|
||||
|
||||
interface MigrationMenu {
|
||||
name: string
|
||||
@@ -74,3 +76,22 @@ test('V174 恢复的「品牌Gating库」菜单 key 必须在路由注册表登
|
||||
assert.equal(page.title, gating.name, '页面标题应与菜单名一致')
|
||||
assert.equal(page.companyScoped, false, 'Gating 库全平台共享,不参与公司 tab')
|
||||
})
|
||||
|
||||
test('V175 新增的关键词使用记录菜单 key 必须在路由注册表登记', () => {
|
||||
const sql = readFileSync(KEYWORD_USAGE_MIGRATION, 'utf8')
|
||||
const menus = menusInsertedBy(sql)
|
||||
const insertCount = (sql.match(/INSERT INTO `columns`/g) || []).length
|
||||
assert.ok(menus.length > 0, 'V175 应当插入后台菜单,一条都没解析出来说明正则失效')
|
||||
assert.equal(menus.length, insertCount, `解析到 ${menus.length} 条,但迁移有 ${insertCount} 条 INSERT INTO columns`)
|
||||
|
||||
const menu = menus.find((item) => item.columnKey === 'admin_keyword_usage')
|
||||
assert.ok(menu, 'V175 必须插入 admin_keyword_usage 菜单')
|
||||
const page = adminPages.find((item) => item.menuKey === 'admin_keyword_usage')
|
||||
assert.ok(page, 'routes.ts 必须有 admin_keyword_usage 页面,否则菜单点进去 404')
|
||||
assert.equal(page.title, menu.name, '页面标题应与菜单名一致')
|
||||
assert.equal(page.companyScoped, true, '关键词记录按公司 tab 取数')
|
||||
|
||||
// 品牌Gating库由数据管理组迁到店铺管理组,排序 85;关键词记录 86,紧随其后。
|
||||
assert.ok(sql.includes('SET col.`parent_id` = grp.`id`'), 'V175 必须把品牌Gating库迁到店铺管理组')
|
||||
assert.ok(sql.includes('col.`sort_order` = 85'), '品牌Gating库排序应为 85')
|
||||
})
|
||||
|
||||
@@ -227,6 +227,14 @@ const COMPANY_ID_SOURCE_PINS: Readonly<Record<string, readonly CompanyIdPin[]>>
|
||||
// 批次 3 的两页同样由 SEND_POINTS 现算(撞款控制台三处发送口 = 三条钉)。
|
||||
admin_shop_data_duplicate_check: pinsFor('admin_shop_data_duplicate_check'),
|
||||
admin_shop_data_crawl_tasks: pinsFor('admin_shop_data_crawl_tasks'),
|
||||
// 2026-10-25 关键词使用记录:三个 GET 共用 toQuery,company_id 只许取函数自己的 params.companyId。
|
||||
admin_keyword_usage: [
|
||||
{
|
||||
file: 'src/pages/tasks/keyword-usage-api.ts',
|
||||
shape: /company_id\s*=\s*params\.companyId\b/,
|
||||
note: 'toQuery 是白名单构造,公司值只能来自调用方传入的 params.companyId(页面从 companyTab.requestCompanyId 取)',
|
||||
},
|
||||
],
|
||||
admin_users: pinsFor('admin_users'),
|
||||
// 批次 5(店铺密钥)同样由 SEND_POINTS 现算:这一页只有一个发送口(列表),
|
||||
// 新增/编辑/删除/白名单检测四支都不带公司参数——归属由后端从操作者会话推导(writeCompanyId 闸门)。
|
||||
|
||||
@@ -0,0 +1,59 @@
|
||||
import test from 'node:test'
|
||||
import assert from 'node:assert/strict'
|
||||
import {
|
||||
createKeywordUsageFilter,
|
||||
keywordUsageCountsText,
|
||||
keywordUsageSceneLabel,
|
||||
parseKeywordUsageOverview,
|
||||
parseKeywordUsagePage,
|
||||
} from '../src/pages/tasks/keyword-usage-model.ts'
|
||||
|
||||
test('keyword_usage_filter_defaults_and_scene_labels', () => {
|
||||
assert.deepEqual(createKeywordUsageFilter(), { user: '', country: '', keyword: '', scene: '' })
|
||||
assert.equal(keywordUsageSceneLabel('复制关键词'), '已使用(复制)')
|
||||
assert.equal(keywordUsageSceneLabel('添加关键词'), '添加关键词')
|
||||
assert.equal(keywordUsageSceneLabel('删除关键词'), '删除关键词')
|
||||
assert.equal(keywordUsageSceneLabel(''), '—')
|
||||
})
|
||||
|
||||
test('keyword_usage_page_parses_counts_and_skips_invalid_rows', () => {
|
||||
const page = parseKeywordUsagePage({
|
||||
total: 7,
|
||||
rows: [
|
||||
{ userName: 'alice', country: '英国', keyword: 'dress', scene: '复制关键词', time: '2026-10-25T10:00:00' },
|
||||
null,
|
||||
{ userName: 'bob', keyword: 'shoes', scene: '添加关键词', time: '2026-10-25T11:00:00' },
|
||||
],
|
||||
counts: { copy: 5, copyExisting: 4, copyDeleted: 1, add: 2 },
|
||||
})
|
||||
assert.equal(page.total, 7)
|
||||
assert.equal(page.rows.length, 2)
|
||||
assert.equal(page.rows[1].country, '')
|
||||
assert.deepEqual(page.counts, { copy: 5, copyExisting: 4, copyDeleted: 1, add: 2 })
|
||||
})
|
||||
|
||||
test('keyword_usage_page_tolerates_missing_fields', () => {
|
||||
const page = parseKeywordUsagePage({})
|
||||
assert.equal(page.total, 0)
|
||||
assert.deepEqual(page.rows, [])
|
||||
assert.deepEqual(page.counts, { copy: 0, copyExisting: 0, copyDeleted: 0, add: 0 })
|
||||
})
|
||||
|
||||
test('keyword_usage_overview_parses_stats_and_options', () => {
|
||||
const overview = parseKeywordUsageOverview({
|
||||
stats: { used: 10, exist: 7, deletedKw: 3, added: 2, totalUse: 12, deletes: 1 },
|
||||
users: ['alice', '', 3],
|
||||
countries: ['英国', '德国'],
|
||||
})
|
||||
assert.equal(overview.stats.used, 10)
|
||||
assert.equal(overview.stats.totalUse, 12)
|
||||
assert.deepEqual(overview.users, ['alice', '3'])
|
||||
assert.deepEqual(overview.countries, ['英国', '德国'])
|
||||
})
|
||||
|
||||
test('keyword_usage_counts_text_matches_desktop_formula', () => {
|
||||
assert.equal(
|
||||
keywordUsageCountsText({ copy: 5, copyExisting: 4, copyDeleted: 1, add: 2 }, 7),
|
||||
'复制关键词 5 = 现存词 4 + 已删除词 1 · 添加关键词 2 · 合计 7 条',
|
||||
)
|
||||
})
|
||||
Reference in New Issue
Block a user