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:
@@ -0,0 +1,136 @@
|
||||
// Package controller 提供 notify 模块的 HTTP 接口
|
||||
package controller
|
||||
|
||||
import (
|
||||
"errors"
|
||||
"strconv"
|
||||
|
||||
"github.com/echochat/backend/app/dto"
|
||||
"github.com/echochat/backend/app/notify/service"
|
||||
"github.com/echochat/backend/pkg/middleware"
|
||||
"github.com/echochat/backend/pkg/utils"
|
||||
"github.com/gin-gonic/gin"
|
||||
)
|
||||
|
||||
// NotificationController 通知控制器(REST API)
|
||||
type NotificationController struct {
|
||||
notifyService *service.NotifyService
|
||||
}
|
||||
|
||||
// NewNotificationController 创建 NotificationController 实例
|
||||
func NewNotificationController(notifyService *service.NotifyService) *NotificationController {
|
||||
return &NotificationController{notifyService: notifyService}
|
||||
}
|
||||
|
||||
// GetList 获取通知列表
|
||||
// GET /api/v1/notifications?category=&is_read=&before_id=&limit=
|
||||
func (ctl *NotificationController) GetList(c *gin.Context) {
|
||||
ctx := c.Request.Context()
|
||||
userID, ok := middleware.GetCurrentUserID(c)
|
||||
if !ok {
|
||||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||||
return
|
||||
}
|
||||
|
||||
var req dto.GetNotificationsRequest
|
||||
if err := c.ShouldBindQuery(&req); err != nil {
|
||||
utils.ResponseBadRequest(c, "请求参数错误: "+err.Error())
|
||||
return
|
||||
}
|
||||
|
||||
resp, err := ctl.notifyService.GetList(ctx, userID, &req)
|
||||
if err != nil {
|
||||
utils.ResponseError(c, "获取通知列表失败")
|
||||
return
|
||||
}
|
||||
utils.ResponseOK(c, resp)
|
||||
}
|
||||
|
||||
// GetUnreadCount 获取未读数(总数 + 按分类)
|
||||
// GET /api/v1/notifications/unread-count
|
||||
func (ctl *NotificationController) GetUnreadCount(c *gin.Context) {
|
||||
ctx := c.Request.Context()
|
||||
userID, ok := middleware.GetCurrentUserID(c)
|
||||
if !ok {
|
||||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||||
return
|
||||
}
|
||||
|
||||
resp, err := ctl.notifyService.GetUnreadCount(ctx, userID)
|
||||
if err != nil {
|
||||
utils.ResponseError(c, "获取未读数失败")
|
||||
return
|
||||
}
|
||||
utils.ResponseOK(c, resp)
|
||||
}
|
||||
|
||||
// MarkRead 标记单条通知为已读
|
||||
// PUT /api/v1/notifications/:id/read
|
||||
func (ctl *NotificationController) MarkRead(c *gin.Context) {
|
||||
ctx := c.Request.Context()
|
||||
userID, ok := middleware.GetCurrentUserID(c)
|
||||
if !ok {
|
||||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||||
return
|
||||
}
|
||||
|
||||
id, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||||
if err != nil {
|
||||
utils.ResponseBadRequest(c, "通知 ID 格式错误")
|
||||
return
|
||||
}
|
||||
|
||||
if err := ctl.notifyService.MarkRead(ctx, userID, id); err != nil {
|
||||
if errors.Is(err, service.ErrNotificationNotFound) {
|
||||
utils.ResponseNotFound(c, err.Error())
|
||||
return
|
||||
}
|
||||
utils.ResponseError(c, "标记已读失败")
|
||||
return
|
||||
}
|
||||
utils.ResponseOK(c, nil)
|
||||
}
|
||||
|
||||
// MarkAllRead 一键清零未读
|
||||
// PUT /api/v1/notifications/read-all?category=
|
||||
func (ctl *NotificationController) MarkAllRead(c *gin.Context) {
|
||||
ctx := c.Request.Context()
|
||||
userID, ok := middleware.GetCurrentUserID(c)
|
||||
if !ok {
|
||||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||||
return
|
||||
}
|
||||
|
||||
category := c.Query("category")
|
||||
affected, err := ctl.notifyService.MarkAllRead(ctx, userID, category)
|
||||
if err != nil {
|
||||
utils.ResponseError(c, "批量标记已读失败")
|
||||
return
|
||||
}
|
||||
utils.ResponseOK(c, dto.MarkReadResponse{Affected: int(affected)})
|
||||
}
|
||||
|
||||
// Broadcast 管理员发起全员广播
|
||||
// POST /api/v1/admin/notifications/broadcast
|
||||
// 需要 admin/super_admin 角色,由路由层中间件保证
|
||||
func (ctl *NotificationController) Broadcast(c *gin.Context) {
|
||||
ctx := c.Request.Context()
|
||||
operatorID, ok := middleware.GetCurrentUserID(c)
|
||||
if !ok {
|
||||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||||
return
|
||||
}
|
||||
|
||||
var req dto.BroadcastNotificationRequest
|
||||
if err := c.ShouldBindJSON(&req); err != nil {
|
||||
utils.ResponseBadRequest(c, "请求参数错误: "+err.Error())
|
||||
return
|
||||
}
|
||||
|
||||
affected, err := ctl.notifyService.Broadcast(ctx, operatorID, &req)
|
||||
if err != nil {
|
||||
utils.ResponseError(c, "广播失败")
|
||||
return
|
||||
}
|
||||
utils.ResponseOK(c, dto.BroadcastNotificationResponse{Affected: affected})
|
||||
}
|
||||
Reference in New Issue
Block a user