feat(通知): task_failed 带 ref_json 定位锚点,明细可点直达任务详情
用户原话「都没体现哪个任务id/店铺/用户,咋排查」:通知表只有 title/content, 失败任务又按「用户×模块×自然日」聚合成一条,明细被 5 个 taskNo 预览 + 512 字截断吃掉。 - V162 给 biz_user_notification 加 ref_json(TEXT,可重跑迁移,存量不回填) - 扫描器把桶内每个失败任务写成锚点(taskId/taskNo/moduleType/reason/updatedAt/ deviceId),上限 20 条;品牌任务无 task_no 用 #<id> 兜底,保证至少一条可定位 - 详情接口回传 refs;同键刷新时锚点变化也更新,且不重新点亮已读 - 后台铃铛「展开明细」渲染成可点行,跳任务中心 ?taskNo= 自动开详情抽屉 - 新增判据 taskFailedAdminNotificationCarriesUidAndTaskNoAnchor:管理端正文必须含 uid、每个桶的 ref_json 至少一条非空 taskNo
This commit is contained in:
@@ -0,0 +1,51 @@
|
||||
-- =============================================================
|
||||
-- 迁移 V162__notification_ref_json
|
||||
--
|
||||
-- 1. 变更目的:给站内通知补「结构化定位锚点」列(2026-10-21 需求)。
|
||||
-- 用户原话:「都没体现 哪个任务id 或者 店铺 或用户啥的关键信息 咋排查」。
|
||||
-- 现状:biz_user_notification 只有 title(128)/content(512),task_failed 又按
|
||||
-- 「用户 × 模块 × 自然日」聚合成一条,明细被 taskNoPreview(最多 5 个) + 最近
|
||||
-- 一条原因(截 120) 压缩,且 content 再截 512 ⇒ 同桶其余任务连任务号都看不到。
|
||||
-- 加这一列后,扫描器把桶内每个失败任务写成 JSON(taskId/taskNo/moduleType/
|
||||
-- reason/updatedAt/deviceId),后台「展开明细」渲染成可点行、直达任务详情。
|
||||
--
|
||||
-- 2. 为什么不是把正文放宽:content 是给桌面用户看的自然语言,长度由 UI 决定;
|
||||
-- 结构化定位信息要能被程序消费(跳转、对齐),混在一段文本里只能靠正则捞。
|
||||
--
|
||||
-- 3. 为什么用 TEXT 不用 JSON 类型:MySQL JSON 列在 JDBC 侧同样回字符串,
|
||||
-- 但会给「老的 jar 不认识这一列」的回滚场景多绑一个数据库版本前提;
|
||||
-- TEXT 与 V116 既有风格一致,可重跑、可直接 SHOW。
|
||||
--
|
||||
-- 4. 存量行:ref_json 保持 NULL(不回填)。历史 task_failed 通知的明细在聚合时
|
||||
-- 就已丢弃,回填只能靠正则解析文案,正是本项目一直拒绝的做法。
|
||||
--
|
||||
-- 5. 锁表风险:低。TEXT NULL ADD COLUMN 在 MySQL 8 走 INSTANT(不重建表)。
|
||||
-- 刻意不加索引:这一列只随明细行整体读出,从不做条件筛选。
|
||||
--
|
||||
-- 6. 验证 SQL(迁移后跑):
|
||||
-- SHOW COLUMNS FROM `biz_user_notification` LIKE 'ref_json';
|
||||
-- -> 期望 1 行:Type=text,Null=YES
|
||||
-- SELECT id, scene, LEFT(ref_json, 120) FROM biz_user_notification
|
||||
-- WHERE scene='task_failed' ORDER BY id DESC LIMIT 3;
|
||||
-- -> 新产生的行应能看到 [{"taskId":...,"taskNo":"...
|
||||
--
|
||||
-- 7. 可重跑性:照 V146/V155/V157/V158/V161 惯例,加列前先查 information_schema;
|
||||
-- 迁移中途失败时 flyway repair + 重启会从第一条语句重跑,裸 ADD COLUMN 会撞 1060。
|
||||
--
|
||||
-- 8. 回滚(人工补丁,写成注释以免被 Flyway 当迁移执行):
|
||||
-- ALTER TABLE `biz_user_notification` DROP COLUMN `ref_json`;
|
||||
-- 仅回滚 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 = 'ref_json'
|
||||
);
|
||||
SET @ddl := IF(@has_col = 0,
|
||||
'ALTER TABLE `biz_user_notification` ADD COLUMN `ref_json` TEXT NULL COMMENT ''结构化定位锚点 JSON(task_failed=桶内失败任务清单)'' AFTER `content`',
|
||||
'SELECT ''biz_user_notification.ref_json already exists, skipped'' AS note');
|
||||
PREPARE stmt FROM @ddl;
|
||||
EXECUTE stmt;
|
||||
DEALLOCATE PREPARE stmt;
|
||||
Reference in New Issue
Block a user