feat(通知): 四级严重度与严重度/时间双排序,客户端与后台管理同步

通知表新增 severity(紧急/高危/中危/低危,V161),由 scene + level 推导且
不回改 level:老客户端配色不受影响,secret_balance 的余量偏低与欠费也能分档。
列表与聚合接口默认按严重度倒序(同档按时间倒序),sort=time 切纯时间排序;
聚合组取组内最高严重度。两端铃铛加彩色等级标签与排序切换,展开明细沿用
同一排序,严重度排序下隐藏会跨天误导的日期头。
This commit is contained in:
2026-10-21 13:33:07 +08:00
parent f6aa04d0f2
commit 86d78160fd
23 changed files with 804 additions and 40 deletions
@@ -0,0 +1,68 @@
-- =============================================================
-- 迁移 V161__notification_severity
--
-- 1. 变更目的:给站内通知补「严重度」一列(2026-10-21 需求)。
-- 用户原话:「通知功能优化加个紧急、高危、中危、低危的状态,排序默认按这个排,
-- 也可以支持按时间排序 2 种,客户端和后台管理都加」。
-- 此前表里只有 `level`(info/warning/error),它是**呈现级别**不是业务严重度:
-- task_partial 与 task_failed 都可能是 warning,但前者是交付不完整、后者是任务失败;
-- 直接拿 level 当四级严重度会把两者压成同一档。故新增独立列,不回改 level——
-- 老客户端的配色/图标按 level 走,改 level 的取值等于把它们一起打碎。
--
-- 2. 严重度口径(服务端唯一来源 NotificationService.severityOf):
-- urgent 紧急:service_down(下游服务停摆)、secret_balance + error(代理欠费)
-- high 高危:task_failed、secret_invalid、maixiang_anomaly(任务/密钥/调度异常)
-- medium 中危:task_partial、secret_balance + warning(余量偏低)
-- low 低危:system(普通系统通知)
-- 未登记 scene 兜底:error→urgent、warning→high、info→low、其余 medium。
--
-- 3. 存量回填:按 scene + level 推导(与 Java 侧同一张表),不拿正则解析历史文案。
-- 只回填空值/空串/默认值 medium 的行;已经是 urgent/high/low 的行不动。
--
-- 4. 锁表风险:低。带 DEFAULT 的 ADD COLUMN 在 MySQL 8 走 INSTANT(不重建表)。
-- 刻意不加二级索引:查询过滤条件恒为 user_id + audience,V116 的
-- idx_user_audience_read 已覆盖;严重度只有四个值,宽索引买不到排序收益。
--
-- 5. 验证 SQL(迁移后跑,不许只看启动日志的 Successfully applied):
-- SHOW COLUMNS FROM `biz_user_notification` LIKE 'severity';
-- -> 期望 1 行:Type=varchar(16),Null=NO,Default=medium
-- SELECT severity, COUNT(*) FROM biz_user_notification GROUP BY severity;
-- -> 期望只出现 urgent/high/medium/low 四个值
-- SELECT id, scene, level, severity FROM biz_user_notification ORDER BY id DESC LIMIT 10;
-- -> 抽查:service_down 应为 urgent,task_failed 应为 high,system 应为 low
--
-- 6. 可重跑性:照 V146/V155/V157/V158 惯例,加列前先查 information_schema;
-- 迁移中途失败时 flyway repair + 重启会从第一条语句重跑,裸 ADD COLUMN 会撞 1060。
-- 回填语句本身幂等(只改 medium/空值,重算结果相同)。
--
-- 7. 回滚(人工补丁,写成注释以免被 Flyway 当迁移执行):
-- ALTER TABLE `biz_user_notification` DROP COLUMN `severity`;
-- 仅回滚 jar 不需要 DROP:旧 jar 的实体没有这一列,INSERT 不会写它。
-- =============================================================
SET @has_col := (
SELECT COUNT(*) FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = DATABASE()
AND TABLE_NAME = 'biz_user_notification'
AND COLUMN_NAME = 'severity'
);
SET @ddl := IF(@has_col = 0,
'ALTER TABLE `biz_user_notification` ADD COLUMN `severity` varchar(16) NOT NULL DEFAULT ''medium'' COMMENT ''严重度:urgent=紧急/high=高危/medium=中危/low=低危'' AFTER `level`',
'SELECT ''biz_user_notification.severity already exists, skipped'' AS note');
PREPARE stmt FROM @ddl;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
UPDATE `biz_user_notification`
SET `severity` = CASE
WHEN `scene` = 'service_down' THEN 'urgent'
WHEN `scene` = 'secret_balance' AND `level` = 'error' THEN 'urgent'
WHEN `scene` IN ('maixiang_anomaly', 'secret_invalid', 'task_failed') THEN 'high'
WHEN `scene` IN ('task_partial', 'secret_balance') THEN 'medium'
WHEN `scene` = 'system' THEN 'low'
WHEN `level` = 'error' THEN 'urgent'
WHEN `level` = 'warning' THEN 'high'
WHEN `level` = 'info' THEN 'low'
ELSE 'medium'
END
WHERE `severity` IS NULL OR `severity` = '' OR `severity` = 'medium';