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
@@ -0,0 +1,101 @@
-- =============================================================
-- 迁移 V175__move_gating_and_add_keyword_usage_menu
--
-- 1. 变更目的(2026-10-25 控制方截图定案):
-- a) 「品牌Gating库」从数据管理组迁到店铺管理组 admin_group_shop,排序 85,
-- 紧跟「店铺数据重复检查」(84);
-- b) 新增「关键词使用记录」独立菜单 admin_keyword_usage,挂在店铺管理组,排序 86。
--
-- 2. 口径:
-- - 两行都按每家公司一套菜单树维护:company_id=1 为模板行,其余公司(含停用公司)
-- 逐家复制;子行 parent_id 必须认本公司 admin_group_shop 组行,严禁跨公司认父。
-- - 品牌Gating库行由 V174 恢复,V175 只改 parent_id/sort_order,不重建、不删授权。
-- - 关键词使用记录只读页面,默认不预授 user_column_permission;管理员角色链可直进,
-- 普通账号由管理员在「菜单权限配置」里按公司分配。
-- - 幂等守卫按 (company_id, column_key) 判存,同时防 (menu_type, route_path) 唯一键
-- uk_company_menu_type_route_path 撞行。
--
-- 3. 影响表与数据量:columns 更新 N 行 + 新增 N 行(N = 公司数),字典小表,毫秒级。
--
-- 4. 【可重跑性】UPDATE 重复执行结果一致;两段 INSERT 都带 NOT EXISTS 守卫,重跑逐条 no-op。
-- =============================================================
-- ---------- 1. 品牌Gating库归位:店铺管理组、排序 85 ----------
UPDATE `columns` col
JOIN `columns` grp
ON grp.`company_id` = col.`company_id`
AND grp.`column_key` = 'admin_group_shop'
SET col.`parent_id` = grp.`id`,
col.`sort_order` = 85
WHERE col.`column_key` = 'admin_brand_gating';
-- ---------- 2. 公司 1 模板行:关键词使用记录 ----------
INSERT INTO `columns` (`name`, `column_key`, `menu_type`, `route_path`, `sort_order`, `parent_id`, `company_id`)
SELECT '关键词使用记录', 'admin_keyword_usage', 'admin', 'keyword-usage', 86, grp.`id`, 1
FROM `columns` grp
WHERE grp.`company_id` = 1 AND grp.`column_key` = 'admin_group_shop'
AND NOT EXISTS (
SELECT 1 FROM `columns`
WHERE `company_id` = 1
AND (`column_key` = 'admin_keyword_usage'
OR (`menu_type` = 'admin' AND `route_path` = 'keyword-usage'))
);
-- ---------- 3. 复制到其余公司(含停用公司),各自认本公司店铺管理组行 ----------
INSERT INTO `columns` (`name`, `column_key`, `menu_type`, `route_path`, `sort_order`, `parent_id`, `company_id`)
SELECT '关键词使用记录', 'admin_keyword_usage', 'admin', 'keyword-usage', 86, grp.`id`, c.`id`
FROM `company` c
JOIN `columns` grp ON grp.`company_id` = c.`id` AND grp.`column_key` = 'admin_group_shop'
WHERE c.`id` <> 1
AND NOT EXISTS (
SELECT 1 FROM `columns` col
WHERE col.`company_id` = c.`id`
AND (col.`column_key` = 'admin_keyword_usage'
OR (col.`menu_type` = 'admin' AND col.`route_path` = 'keyword-usage'))
);
-- ---------- 4. 自检闸门:不为 0 就抛 1048(列 must_be_zero NOT NULL) ----------
CREATE TEMPORARY TABLE IF NOT EXISTS `_v175_gate` (`must_be_zero` INT NOT NULL);
-- 闸门 1:每家公司恰好一行品牌Gating库,且父必须是本公司店铺管理组、排序 85
INSERT INTO `_v175_gate`
SELECT IF(COUNT(*) = 0, 0, NULL)
FROM (
SELECT c.`id`
FROM `company` c
LEFT JOIN `columns` col ON col.`company_id` = c.`id` AND col.`column_key` = 'admin_brand_gating'
LEFT JOIN `columns` grp ON grp.`id` = col.`parent_id`
AND grp.`company_id` = c.`id` AND grp.`column_key` = 'admin_group_shop'
GROUP BY c.`id`
HAVING COUNT(col.`id`) <> 1 OR COUNT(grp.`id`) <> 1 OR MAX(col.`sort_order`) <> 85
) bad;
-- 闸门 2:每家公司恰好一行关键词使用记录,且父必须是本公司店铺管理组、排序 86
INSERT INTO `_v175_gate`
SELECT IF(COUNT(*) = 0, 0, NULL)
FROM (
SELECT c.`id`
FROM `company` c
LEFT JOIN `columns` col ON col.`company_id` = c.`id` AND col.`column_key` = 'admin_keyword_usage'
LEFT JOIN `columns` grp ON grp.`id` = col.`parent_id`
AND grp.`company_id` = c.`id` AND grp.`column_key` = 'admin_group_shop'
GROUP BY c.`id`
HAVING COUNT(col.`id`) <> 1 OR COUNT(grp.`id`) <> 1 OR MAX(col.`sort_order`) <> 86
) bad;
-- 闸门 3:两条路由不允许被别的 column_key 占行
INSERT INTO `_v175_gate`
SELECT IF(COUNT(*) = 0, 0, NULL)
FROM `columns` col
WHERE col.`menu_type` = 'admin'
AND col.`route_path` IN ('brand-gating', 'keyword-usage')
AND col.`column_key` NOT IN ('admin_brand_gating', 'admin_keyword_usage');
-- 闸门 4:两个 key 的 route_path 必须各自保持原值(防止历史行被别的迁移改名)
INSERT INTO `_v175_gate`
SELECT IF(COUNT(*) = 0, 0, NULL)
FROM `columns` col
WHERE (col.`column_key` = 'admin_brand_gating' AND col.`route_path` <> 'brand-gating')
OR (col.`column_key` = 'admin_keyword_usage' AND col.`route_path` <> 'keyword-usage');
DROP TEMPORARY TABLE `_v175_gate`;
@@ -0,0 +1,158 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.nanri.aiimage.modules.keywordusage.mapper.KeywordUsageAdminMapper">
<!-- 关键词使用记录(管理后台只读视图)。四张表由桌面端/keywordshare 模块维护,这里只查不写;
筛选值一律 #{} 占位符,LIKE 由 CONCAT 拼通配符,不拼接用户输入。 -->
<sql id="usageConds">
<if test="f.companyId != null">AND k.company_id = #{f.companyId}</if>
<if test="f.user != null and f.user != ''">AND k.user_name = #{f.user}</if>
<if test="f.country != null and f.country != ''">AND k.country = #{f.country}</if>
<if test="f.keyword != null and f.keyword != ''">
AND k.keyword LIKE CONCAT('%', #{f.keyword}, '%')
</if>
</sql>
<sql id="addConds">
<if test="f.companyId != null">AND a.company_id = #{f.companyId}</if>
<if test="f.user != null and f.user != ''">AND a.user_name = #{f.user}</if>
<if test="f.country != null and f.country != ''">AND a.country = #{f.country}</if>
<if test="f.keyword != null and f.keyword != ''">
AND a.keyword LIKE CONCAT('%', #{f.keyword}, '%')
</if>
</sql>
<sql id="deleteConds">
<if test="f.companyId != null">AND d.company_id = #{f.companyId}</if>
<if test="f.user != null and f.user != ''">AND d.user_name = #{f.user}</if>
<if test="f.country != null and f.country != ''">AND d.country = #{f.country}</if>
<if test="f.keyword != null and f.keyword != ''">
AND d.keyword LIKE CONCAT('%', #{f.keyword}, '%')
</if>
</sql>
<select id="countUsageRows" resultType="long">
SELECT
<choose>
<when test="f.includeCopy and f.includeAdd">
(SELECT COUNT(*) FROM keyword_usage k WHERE 1=1 <include refid="usageConds"/>)
+ (SELECT COUNT(*) FROM keyword_add_log a WHERE 1=1 <include refid="addConds"/>)
</when>
<when test="f.includeCopy">
(SELECT COUNT(*) FROM keyword_usage k WHERE 1=1 <include refid="usageConds"/>)
</when>
<when test="f.includeAdd">
(SELECT COUNT(*) FROM keyword_add_log a WHERE 1=1 <include refid="addConds"/>)
</when>
<otherwise>0</otherwise>
</choose>
</select>
<select id="selectUsageRows" resultType="com.nanri.aiimage.modules.keywordusage.model.vo.KeywordUsageRowVo">
SELECT x.user_name AS userName,
x.country AS country,
x.keyword AS keyword,
x.scene AS scene,
x.op_time AS `time`
FROM (
<if test="f.includeCopy">
SELECT k.user_name, k.country, k.keyword, '复制关键词' AS scene,
k.used_time AS op_time, k.id AS sid
FROM keyword_usage k
WHERE 1=1 <include refid="usageConds"/>
</if>
<if test="f.includeCopy and f.includeAdd">UNION ALL</if>
<if test="f.includeAdd">
SELECT a.user_name, a.country, a.keyword, '添加关键词' AS scene,
a.add_time AS op_time, a.id AS sid
FROM keyword_add_log a
WHERE 1=1 <include refid="addConds"/>
</if>
) x
ORDER BY x.op_time DESC, x.sid DESC
LIMIT #{f.offset}, #{f.limit}
</select>
<select id="countCopy" resultType="long">
SELECT COUNT(*) FROM keyword_usage k WHERE 1=1 <include refid="usageConds"/>
</select>
<select id="countCopyExisting" resultType="long">
SELECT COUNT(*)
FROM keyword_usage k
INNER JOIN keyword_share s
ON s.company_id = k.company_id
AND s.country = k.country
AND s.keyword = k.keyword
WHERE 1=1 <include refid="usageConds"/>
</select>
<select id="countAdd" resultType="long">
SELECT COUNT(*) FROM keyword_add_log a WHERE 1=1 <include refid="addConds"/>
</select>
<select id="countDeletes" resultType="long">
SELECT COUNT(*) FROM keyword_delete_log d WHERE 1=1 <include refid="deleteConds"/>
</select>
<select id="selectDeleteRows" resultType="com.nanri.aiimage.modules.keywordusage.model.vo.KeywordUsageRowVo">
SELECT d.user_name AS userName,
d.country AS country,
d.keyword AS keyword,
'删除关键词' AS scene,
d.delete_time AS `time`
FROM keyword_delete_log d
WHERE 1=1 <include refid="deleteConds"/>
ORDER BY d.delete_time DESC, d.id DESC
LIMIT #{f.offset}, #{f.limit}
</select>
<select id="selectStats" resultType="com.nanri.aiimage.modules.keywordusage.model.vo.KeywordUsageStatsVo">
SELECT
(SELECT COUNT(*) FROM keyword_usage k
WHERE 1=1
<if test="companyId != null">AND k.company_id = #{companyId}</if>) AS used,
(SELECT COUNT(*)
FROM keyword_usage k
INNER JOIN keyword_share s
ON s.company_id = k.company_id
AND s.country = k.country
AND s.keyword = k.keyword
WHERE 1=1
<if test="companyId != null">AND k.company_id = #{companyId}</if>) AS exist,
(SELECT COUNT(*) FROM keyword_add_log a
WHERE 1=1
<if test="companyId != null">AND a.company_id = #{companyId}</if>) AS added,
(SELECT COUNT(*) FROM keyword_delete_log d
WHERE 1=1
<if test="companyId != null">AND d.company_id = #{companyId}</if>) AS deletes
</select>
<select id="selectUsers" resultType="string">
SELECT DISTINCT user_name
FROM (
SELECT user_name, company_id FROM keyword_usage
UNION
SELECT user_name, company_id FROM keyword_add_log
UNION
SELECT user_name, company_id FROM keyword_delete_log
) t
WHERE user_name IS NOT NULL AND user_name != ''
<if test="companyId != null">AND company_id = #{companyId}</if>
ORDER BY user_name
</select>
<select id="selectCountries" resultType="string">
SELECT DISTINCT country
FROM (
SELECT country, company_id FROM keyword_usage
UNION
SELECT country, company_id FROM keyword_add_log
UNION
SELECT country, company_id FROM keyword_delete_log
) t
WHERE country IS NOT NULL AND country != ''
<if test="companyId != null">AND company_id = #{companyId}</if>
ORDER BY country
</select>
</mapper>