5d2a1c6974
V158 给 biz_user_notification 加 subject_user_id(事件主体用户,与收件人 user_id 分家): 一行通知是给某个收件人看的,被通知的那个 uid 原先只活在文案字符串里,没有列就没法按用户成组, 也不肯用正则去解历史文案凑分组键。存量不回填(定案)⇒ 老行 subject_user_id 为 NULL,自成「未标注主体」一组。 写入侧 pushOrRefresh 第 8 参带主体,AUDIENCE_USER 时主体=收件人(故新增 7 参便捷档,68 处调用一行没改); pushToAdminsAnyOf 传 null 并注明理由:一把密钥被 N 个账号共用,不挑一个 uid 冒充。 新增 GET /api/notifications/groups 与 /api/admin/notifications/groups:Java 侧分组(复用 baseWrapper 一份筛选实现), 分页按组切,同屏返回 total=组数 与 rowCount=明细条数;unreadGroupCount 走 COUNT(DISTINCT scene, DATE(created_at), IFNULL(subject_user_id,-1)) —— IFNULL 不能省, MySQL 的 COUNT(DISTINCT a,b,c) 会跳过任一表达式为 NULL 的行,不兜就把存量那一组整个数没。 红点是新增 unreadGroupCount 而不动 unreadCount 语义:已装机老客户端读 unreadCount 画徽标, 换语义会让老客户端出现「红点 3、列表 217 条」对不上。 铃铛两级(后管+桌面各一份):聚合行点击只展开、不替用户标已读,已读必须进明细逐条点; 明细一次最多 50 条,超出显示「另有 N 条未列出」;下钻带 scene+day+subjectUserId(主体为空改下发 subjectUnlabelled 旗标走 IS NULL),少一维就会把同场景同天别主体的行混进这一组的明细——桌面端最初就漏了这一维。 死码随两级视图退场:groupNotificationsByDay/NotificationDayGroup 删掉,用例换成 formatDayLabel/notificationGroupKey/formatGroupCounts。 后管日期选择面板 z-index 抬到 3300(面板 3200)之上:Element 弹层只自 2000 起递增,不抬就被面板压住,表现为「日期点不动」。 playwright 加 E2E_PORT+strictPort:实测 5174/5176 被别的项目的 vite 占着,reuseExistingServer 让 e2e 连上别人的应用, 当时 5 条全红是端口归属问题而不是回归。 验证=后端通知面 66/66(-Dtest='Notification*' 63 + AdminNotificationControllerTest 3)BUILD SUCCESS; 后管 node --test 1819/1819、真浏览器 e2e 10/10(含遮挡与「展开只取本组」); 桌面 node --test 834/834、组件挂载 vitest 8/8;两前端 vue-tsc --noEmit rc=0;ops 值班侧 18/18。 记账三处=后管 source-pin 逐文件基线 notification-bell.test.ts 用例 6→7(该文件钉子仍 0,占比不动); 桌面 catch 棘轮 blocks 298→299(新增那支是 toggleGroup 明细失败写进面板 loadError,非静默,silent 84 一格没涨); 桌面 endpoints 台账补 /api/notifications/groups。 变异自证 7 条全 KILLED:红点按条数/组内没读完就减组数/聚合行直接标已读/明细截断不报数/下钻丢主体/ 丢 IS NULL 旗标/null 主体当值下发。其中「组内没读完就减组数」第一轮 SURVIVED——用例只钉了徽标, 而徽标在 unreadGroupCount 归零时会退回条数兜底,把这条回归盖住了;改成同时钉「N 组未读」chip 才杀掉。 已知盲区(下次补,别当已验):①桌面两级只在 happy-dom 跑过真组件,布局与层级没在真浏览器点过 (桌面日期弹层的层级修复本就在 HEAD 里,不是这批引入);②后管 e2e 夹具没有 subjectUserId=null 的行, 「存量自成一组」在后管 UI 层没被点过,只有后端 WHERE 与桌面组件各一条用例钉着。
81 lines
5.8 KiB
SQL
81 lines
5.8 KiB
SQL
-- =============================================================
|
||
-- 迁移 V158__notification_subject_user
|
||
--
|
||
-- 1. 变更目的:给 `biz_user_notification` 补一列「这件事是关于哪个用户的」。
|
||
-- 这张表从 V116 建表起只有一个用户列 `user_id`,语义是**接收者**(桌面端用户本人
|
||
-- 或后台管理员本人),而后台管理员行的主体用户只写在 `content` 文案里
|
||
-- ("用户 小魏11(uid=1160)任务 COLLECT_DATA-…")。后果是列表出口拿不到"按用户
|
||
-- 聚合"的分组键 ⇒ 铃铛只能一个事件一行地平铺。用户 2026-10-13 反馈
|
||
-- 「现在通知的数据都没做整合 看的累」,实测后台侧 217 条未读、22 页,
|
||
-- 其中同一场景反复出现、只有 uid 与任务号不同(见截图两条「用户采集数据任务部分结果缺失」)。
|
||
-- 本迁移是"场景 × 自然日 × 用户"聚合的那一把分组键的存储前提。
|
||
--
|
||
-- 2. 前提取证(本轮只做代码侧,未跑生产只读普查):
|
||
-- · V116 建表语句里与用户相关的列只有 `user_id BIGINT NOT NULL COMMENT '接收者ID'`
|
||
-- 与 `audience`(user=桌面端/admin=后台),没有主体用户列;
|
||
-- · 写入侧本来就知道主体是谁:`NotificationDispatchService.pushToAdmins(..., subjectUserId)`
|
||
-- 的第 62 行已经拿它做 `audience.canReceive(adminId, subjectUserId)` 的数据权限过滤,
|
||
-- 只是过滤完就把这个值丢了、没有落库 ⇒ 补列不需要新的推导逻辑;
|
||
-- · 全仓 `notificationService.push/pushOrRefresh` 的调用点共 6 处,全部在通知模块内
|
||
-- (NotificationDispatchService 5 处 + NotificationScanScheduler 1 处),
|
||
-- 没有模块外的写入方需要一起改。
|
||
--
|
||
-- 3. 影响表与数据量:只加一列,不写数据、不加索引、不删列、不碰其他表。
|
||
-- 存量行取 NULL。口径(用户 2026-10-13 定):**存量不回填**——旧的管理员行不按用户
|
||
-- 拆开,聚合时所有 NULL 归为同一组,界面上表现为「未区分用户」的一组,展开仍能看到明细。
|
||
-- 不做回填的理由是不拿正则去解析历史文案当分组键(措辞改过形的行会静默漏归,
|
||
-- 而"漏归"在界面上与"本来就没有"同形)。
|
||
-- `audience='user'` 的行由写入侧自动补成 `subject_user_id = user_id`(同一人),
|
||
-- 所以桌面端不需要回填也有分组键。
|
||
--
|
||
-- 4. 锁表风险:极低。nullable、无 DEFAULT 的 `ADD COLUMN` 在 MySQL 8 走 INSTANT,
|
||
-- 不重建表、不阻塞 DML。**刻意不加二级索引**:聚合查询的过滤条件恒为
|
||
-- `user_id = ? AND audience = ?`,V116 的 `idx_user_audience_read` 已覆盖这对等值前缀,
|
||
-- 组内行数又被 `NotificationRetentionService` 的 7 天物理保留压住 ⇒ 加 (audience, user_id,
|
||
-- scene, created_at, subject_user_id) 这种宽索引买不到东西,只多一次重建表。
|
||
--
|
||
-- 5. 验证 SQL(迁移后跑,不许只看启动日志的 Successfully applied):
|
||
-- SHOW COLUMNS FROM `biz_user_notification` LIKE 'subject_user_id';
|
||
-- -> 期望 1 行:Type = bigint,Null = YES,Default = NULL
|
||
-- SELECT COUNT(*) AS total,
|
||
-- SUM(subject_user_id IS NULL) AS unlabelled
|
||
-- FROM `biz_user_notification`;
|
||
-- -> 期望 unlabelled = total(本迁移只加列,不回填)
|
||
-- SHOW INDEX FROM `biz_user_notification`;
|
||
-- -> 期望索引清单与迁移前逐字相同(没有新增索引)
|
||
-- 迁移后新产生的行:`SELECT id, audience, user_id, subject_user_id, scene
|
||
-- FROM biz_user_notification ORDER BY id DESC LIMIT 10;`
|
||
-- -> audience='user' 的行 subject_user_id 应等于 user_id;
|
||
-- audience='admin' 的行 subject_user_id 应是文案里那个 uid(跨用户合并的
|
||
-- pushToAdminsAnyOf 除外,那类事件主体不唯一,留 NULL)。
|
||
--
|
||
-- 6. 上线窗口:随 jar 双节点同窗口发布。加列对旧 jar 无影响(旧代码不认识新列,
|
||
-- MyBatis-Plus 按实体字段生成列名,旧实体没有这一列 ⇒ INSERT 里不会出现它);
|
||
-- 反过来只发 jar 不发迁移,会在第一次写 subject_user_id 时撞 1054 Unknown column。
|
||
-- ⇒ 迁移必须与读它的那版 jar 同版。
|
||
--
|
||
-- 7. 可重跑性:照 V146/V155/V157 惯例,加列前先查 information_schema——迁移中途失败时
|
||
-- flyway repair + 重启会从第一条语句重跑整个文件,裸 ADD COLUMN 会撞 1060。
|
||
--
|
||
-- 8. 回滚(人工补丁,写成注释以免落在 Flyway 扫描路径里被当迁移执行):
|
||
-- 触发场景是"这一列不该加"。顺序:停两台应用 → 跑下面一条 DROP →
|
||
-- 删 flyway_schema_history 的 version='158' 行 → 回滚 jar → 起应用。
|
||
-- ALTER TABLE `biz_user_notification` DROP COLUMN `subject_user_id`;
|
||
-- 仅回滚 jar(代码问题、与列无关)不需要 DROP:旧 jar 不认识这一列,留着零影响。
|
||
-- 注意:新 jar 跑过之后这一列会积累非 NULL 值,DROP 会连带丢掉"按用户分组"的依据,
|
||
-- 使聚合退回"未区分用户"那一组——那是显示退化,不是数据丢失(明细行本身还在)。
|
||
-- =============================================================
|
||
|
||
SET @tbl := (
|
||
SELECT COUNT(*) FROM information_schema.COLUMNS
|
||
WHERE TABLE_SCHEMA = DATABASE()
|
||
AND TABLE_NAME = 'biz_user_notification'
|
||
AND COLUMN_NAME = 'subject_user_id'
|
||
);
|
||
SET @ddl := IF(@tbl = 0,
|
||
'ALTER TABLE `biz_user_notification` ADD COLUMN `subject_user_id` bigint NULL DEFAULT NULL COMMENT ''事件主体用户(users.id):管理员行=这件事关于谁,桌面端行=user_id 本人;NULL=存量未标注或主体不唯一''',
|
||
'SELECT ''biz_user_notification.subject_user_id already exists, skipped'' AS note');
|
||
PREPARE stmt FROM @ddl;
|
||
EXECUTE stmt;
|
||
DEALLOCATE PREPARE stmt;
|