feat: Phase 2e-1 统一通知中心 + 我的 TabBar 聚合未读红点
后端(notify 模块) - 新增 notify 模块:DAO/Service/Pusher 接口/Controller/Router/CleanupTask - 数据库 DDL:notify_notifications 表 + 3 索引(user+created/user+is_read/user+category) - 11 种 type 枚举(好友/群聊 9 种 + meeting_* 2 种预留)+ 4 种 category - 跨模块集成:contact 3 处 Pusher(friend_request/accepted/rejected) - 跨模块集成:group 6 处 Pusher(invite/join_request/approved/rejected/kicked/role_changed) - WS handler 断线补偿:连接建立即推送 notify.unread.total - 5 REST API(4 用户 + 1 管理员广播)+ 2 WS 事件(notify.new / notify.unread.total) - 30 天已读通知定时清理(未读永久保留) - Provider/Wire 依赖注入(NotifyPusher、NotifyConnectHook、UserInfoResolver 接口) 前端 - 新增 notify 模块:API/Pinia Store(5 分类分页缓存 + 未读数 + WS 事件)/NotifyItem/通知中心主页 - profile 入口:铃铛 badge + 菜单项 badge + 数字显示 - App.vue/login 初始化 notifyStore WS 监听;logout 调用 notifyStore.reset() 清缓存 - 清理 contact.js/group.js 中散落 toast 与冗余 notify.friend.request/group.join.request 处理 - CustomTabBar 新增 hasDot() 聚合指示器:我的 Tab 显示纯红点(无数字), 当前聚合 notifyStore.unreadTotal,未来可扩展「资料待完善/安全提醒/新版本」等 文档 - 新增 Phase 2e 整体路线图 docs/plans/2026-04-20-phase2e-design.md - 新增 Phase 2e-1 专用设计 docs/plans/2026-04-20-phase2e-1-design.md(§6.4 TabBar 聚合红点) - 新增 Phase 2e-1 实施计划 docs/plans/2026-04-20-phase2e-1-implementation.plan.md - 新增 E2E 验证报告 test-report-phase2e-1-notification.md(含 Playwright MCP 2 个现场 Bug 修复记录) - 更新 docs/progress/CURRENT_STATUS.md、docs/api/README.md、docs/api/frontend/notify.md - 更新 .cursor/rules/project-context.mdc、docs/plans/2026-02-27-echochat-system-design.md 其他 - .gitignore 排除 .playwright-mcp/ MCP 临时快照 架构决策 - 单端 WS 连接:沿用现有 ws.Hub,多端已读同步推迟到 Phase 2f/二期 - 跨模块依赖:contact/group → notify 严格单向(接口注入模式) - 降级策略:Pusher 先入库后推送;WS 失败不回滚入库;入库失败仅 Warn 不影响业务 Playwright MCP 回归(4 类场景全通) - 实时推送(admin 广播 → 1s 内前端自动插入 + 角标 +1) - Deep-link 跳转(好友申请通知 → contact/request 页) - 批量清零(全部已读按钮) - TabBar 聚合红点(有未读亮/全部已读灭)与 notifyStore.unreadTotal 三层同步 Made-with: Cursor
This commit is contained in:
@@ -331,3 +331,44 @@ COMMENT ON COLUMN im_message_reads.user_id IS '已读用户 ID';
|
||||
COMMENT ON COLUMN im_message_reads.read_at IS '已读时间';
|
||||
|
||||
CREATE INDEX idx_msg_reads_user ON im_message_reads(user_id, read_at);
|
||||
|
||||
-- ============================================================
|
||||
-- notify_notifications: 通知消息表
|
||||
-- 统一通知中心持久化存储,覆盖好友 / 群聊 / 会议 / 系统广播四类场景
|
||||
-- 写入失败不回滚业务;WS 推送失败不回滚入库(降级策略)
|
||||
-- ============================================================
|
||||
CREATE TABLE notify_notifications (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
user_id BIGINT NOT NULL,
|
||||
type VARCHAR(50) NOT NULL,
|
||||
title VARCHAR(100) NOT NULL DEFAULT '',
|
||||
content VARCHAR(500) NOT NULL DEFAULT '',
|
||||
extra JSONB DEFAULT NULL,
|
||||
actor_id BIGINT DEFAULT NULL,
|
||||
target_type VARCHAR(30) NOT NULL DEFAULT '',
|
||||
target_id BIGINT DEFAULT NULL,
|
||||
is_read BOOLEAN NOT NULL DEFAULT FALSE,
|
||||
read_at TIMESTAMP(0) DEFAULT NULL,
|
||||
created_at TIMESTAMP(0) NOT NULL DEFAULT NOW()
|
||||
);
|
||||
|
||||
COMMENT ON TABLE notify_notifications IS '通知消息表,统一通知中心持久化载体';
|
||||
COMMENT ON COLUMN notify_notifications.id IS '通知唯一标识,自增主键';
|
||||
COMMENT ON COLUMN notify_notifications.user_id IS '接收者用户 ID(每条通知对应单个用户)';
|
||||
COMMENT ON COLUMN notify_notifications.type IS '通知类型常量:friend_request / friend_accepted / friend_rejected / group_invite / group_join_request / group_join_approved / group_join_rejected / group_kicked / group_role_changed / system_broadcast / meeting_invite / meeting_reminder';
|
||||
COMMENT ON COLUMN notify_notifications.title IS '通知标题(前端列表主文案)';
|
||||
COMMENT ON COLUMN notify_notifications.content IS '通知副文案(详细说明或申请附言)';
|
||||
COMMENT ON COLUMN notify_notifications.extra IS '扩展数据 JSON,保存类型相关的原始参数(group_id / request_id / role 等)';
|
||||
COMMENT ON COLUMN notify_notifications.actor_id IS '触发此通知的主体用户 ID(申请人 / 邀请人等),系统广播为 NULL';
|
||||
COMMENT ON COLUMN notify_notifications.target_type IS '业务对象类型:user / group / meeting / system,用于点击跳转路由';
|
||||
COMMENT ON COLUMN notify_notifications.target_id IS '业务对象 ID,与 target_type 联合定位跳转目标';
|
||||
COMMENT ON COLUMN notify_notifications.is_read IS '是否已读:FALSE=未读,TRUE=已读';
|
||||
COMMENT ON COLUMN notify_notifications.read_at IS '已读时间,未读时为 NULL';
|
||||
COMMENT ON COLUMN notify_notifications.created_at IS '通知生成时间';
|
||||
|
||||
-- 列表查询核心索引(按用户倒序分页)
|
||||
CREATE INDEX idx_notify_user_time ON notify_notifications (user_id, created_at DESC);
|
||||
-- 未读数统计索引(覆盖索引)
|
||||
CREATE INDEX idx_notify_user_unread ON notify_notifications (user_id, is_read) WHERE is_read = FALSE;
|
||||
-- 清理任务索引(按创建时间扫描旧数据)
|
||||
CREATE INDEX idx_notify_created_at ON notify_notifications (created_at);
|
||||
|
||||
Reference in New Issue
Block a user