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:
92
frontend/src/constants/notify.js
Normal file
92
frontend/src/constants/notify.js
Normal file
@@ -0,0 +1,92 @@
|
||||
/**
|
||||
* 通知模块前端常量
|
||||
*
|
||||
* 与后端 backend/go-service/app/constants/notify.go 一致
|
||||
* 新增/修改通知类型时必须同步维护两端常量
|
||||
*/
|
||||
|
||||
// 通知类型(与后端 NotifyType* 保持一致)
|
||||
export const NOTIFY_TYPE_FRIEND_REQUEST = 'friend_request'
|
||||
export const NOTIFY_TYPE_FRIEND_ACCEPTED = 'friend_accepted'
|
||||
export const NOTIFY_TYPE_FRIEND_REJECTED = 'friend_rejected'
|
||||
|
||||
export const NOTIFY_TYPE_GROUP_INVITE = 'group_invite'
|
||||
export const NOTIFY_TYPE_GROUP_JOIN_REQUEST = 'group_join_request'
|
||||
export const NOTIFY_TYPE_GROUP_JOIN_APPROVED = 'group_join_approved'
|
||||
export const NOTIFY_TYPE_GROUP_JOIN_REJECTED = 'group_join_rejected'
|
||||
export const NOTIFY_TYPE_GROUP_KICKED = 'group_kicked'
|
||||
export const NOTIFY_TYPE_GROUP_ROLE_CHANGED = 'group_role_changed'
|
||||
|
||||
export const NOTIFY_TYPE_SYSTEM_BROADCAST = 'system_broadcast'
|
||||
|
||||
export const NOTIFY_TYPE_MEETING_INVITE = 'meeting_invite'
|
||||
export const NOTIFY_TYPE_MEETING_REMINDER = 'meeting_reminder'
|
||||
|
||||
// 通知分类(前端 5 Tab)
|
||||
export const NOTIFY_CATEGORY_ALL = 'all'
|
||||
export const NOTIFY_CATEGORY_FRIEND = 'friend'
|
||||
export const NOTIFY_CATEGORY_GROUP = 'group'
|
||||
export const NOTIFY_CATEGORY_MEETING = 'meeting'
|
||||
export const NOTIFY_CATEGORY_SYSTEM = 'system'
|
||||
|
||||
/** Tab 列表(顺序即 UI 展示顺序) */
|
||||
export const NOTIFY_CATEGORY_TABS = [
|
||||
{ key: NOTIFY_CATEGORY_ALL, label: '全部' },
|
||||
{ key: NOTIFY_CATEGORY_FRIEND, label: '好友' },
|
||||
{ key: NOTIFY_CATEGORY_GROUP, label: '群聊' },
|
||||
{ key: NOTIFY_CATEGORY_MEETING, label: '会议' },
|
||||
{ key: NOTIFY_CATEGORY_SYSTEM, label: '系统' }
|
||||
]
|
||||
|
||||
/** 通知类型中文映射(默认标题兜底) */
|
||||
export const NOTIFY_TYPE_LABEL = {
|
||||
[NOTIFY_TYPE_FRIEND_REQUEST]: '好友申请',
|
||||
[NOTIFY_TYPE_FRIEND_ACCEPTED]: '好友申请通过',
|
||||
[NOTIFY_TYPE_FRIEND_REJECTED]: '好友申请被拒',
|
||||
[NOTIFY_TYPE_GROUP_INVITE]: '群聊邀请',
|
||||
[NOTIFY_TYPE_GROUP_JOIN_REQUEST]: '入群申请',
|
||||
[NOTIFY_TYPE_GROUP_JOIN_APPROVED]: '入群申请通过',
|
||||
[NOTIFY_TYPE_GROUP_JOIN_REJECTED]: '入群申请被拒',
|
||||
[NOTIFY_TYPE_GROUP_KICKED]: '移出群聊',
|
||||
[NOTIFY_TYPE_GROUP_ROLE_CHANGED]: '群角色变更',
|
||||
[NOTIFY_TYPE_SYSTEM_BROADCAST]: '系统通知',
|
||||
[NOTIFY_TYPE_MEETING_INVITE]: '会议邀请',
|
||||
[NOTIFY_TYPE_MEETING_REMINDER]: '会议提醒'
|
||||
}
|
||||
|
||||
/** 通知图标(emoji 占位;后续可替换为 SVG) */
|
||||
export const NOTIFY_TYPE_ICON = {
|
||||
[NOTIFY_TYPE_FRIEND_REQUEST]: '\uD83D\uDC65', // 👥
|
||||
[NOTIFY_TYPE_FRIEND_ACCEPTED]: '\u2705', // ✅
|
||||
[NOTIFY_TYPE_FRIEND_REJECTED]: '\u274C', // ❌
|
||||
[NOTIFY_TYPE_GROUP_INVITE]: '\uD83C\uDF89', // 🎉
|
||||
[NOTIFY_TYPE_GROUP_JOIN_REQUEST]: '\uD83D\uDCE5', // 📥
|
||||
[NOTIFY_TYPE_GROUP_JOIN_APPROVED]: '\u2705', // ✅
|
||||
[NOTIFY_TYPE_GROUP_JOIN_REJECTED]: '\u274C', // ❌
|
||||
[NOTIFY_TYPE_GROUP_KICKED]: '\uD83D\uDEAA', // 🚪
|
||||
[NOTIFY_TYPE_GROUP_ROLE_CHANGED]: '\uD83D\uDD11', // 🔑
|
||||
[NOTIFY_TYPE_SYSTEM_BROADCAST]: '\uD83D\uDCE2', // 📢
|
||||
[NOTIFY_TYPE_MEETING_INVITE]: '\uD83D\uDCC5', // 📅
|
||||
[NOTIFY_TYPE_MEETING_REMINDER]: '\u23F0' // ⏰
|
||||
}
|
||||
|
||||
/** 默认图标 */
|
||||
export const NOTIFY_DEFAULT_ICON = '\uD83D\uDD14' // 🔔
|
||||
|
||||
/** 图标背景颜色(按分类) */
|
||||
export const NOTIFY_CATEGORY_COLOR = {
|
||||
[NOTIFY_CATEGORY_FRIEND]: '#DBEAFE', // 蓝浅
|
||||
[NOTIFY_CATEGORY_GROUP]: '#DCFCE7', // 绿浅
|
||||
[NOTIFY_CATEGORY_MEETING]: '#FEF3C7', // 黄浅
|
||||
[NOTIFY_CATEGORY_SYSTEM]: '#E0E7FF' // 紫浅
|
||||
}
|
||||
|
||||
/**
|
||||
* 判断该通知是否支持内联操作(接受/拒绝按钮)
|
||||
* 仅 group_invite 和 group_join_request 支持,对方待处理状态
|
||||
* @param {string} type
|
||||
* @returns {boolean}
|
||||
*/
|
||||
export const supportsInlineAction = (type) => {
|
||||
return type === NOTIFY_TYPE_GROUP_INVITE || type === NOTIFY_TYPE_GROUP_JOIN_REQUEST
|
||||
}
|
||||
Reference in New Issue
Block a user