feat(keywordusage): 新增关键词使用记录并归位店铺管理菜单

V175 把品牌Gating库从数据管理组迁到店铺管理组(排序85),并在其后新增
关键词使用记录独立菜单(排序86)。后端新增只读查询模块,按公司范围读取
keyword_usage/keyword_add_log/keyword_delete_log,前端提供使用/删除记录、
统计卡与筛选。
This commit is contained in:
2026-10-25 22:28:17 +08:00
parent 23c1402a75
commit 9b2469ec33
24 changed files with 1623 additions and 4 deletions
@@ -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 条',
)
})