feat(phase2c): 群聊与已读回执功能完整实现

Phase 2c 全部 14 个 Task 完成,包含:

后端(Go):
- MinIO 文件存储服务集成(Docker + Go SDK + 通用上传 API)
- Group 模块完整实现(DAO + Service + Controller + Router + Wire)
  - 18 个群管理 REST API + 11 个 WS 群事件推送
  - 群创建/解散/邀请/踢人/退出/转让群主/设管理员/禁言/全体禁言/群公告/群昵称/免打扰/搜索
- IM Service 扩展(群消息发送/撤回 + @提醒 + 管理员无时限撤回)
- 已读回执后端(单聊会话级 last_read_msg_id + 群聊消息级 im_message_reads)
- 管理端群组管理(列表/详情/解散)
- 数据库迁移(3 张新表 + 2 张表字段扩展)

前端(uni-app):
- 群聊 Store + API 封装 + 11 个 WS 事件监听
- 已读回执 UI(单聊已读/未读标记 + 群聊 X人已读 + 已读详情页)
- 7 个群聊页面(对话/创建/设置/成员/邀请/审批/搜索)
- 会话列表改造(全部/单聊/群聊 Tab + @标记 + 免打扰标识)

管理端(Vue 3 + Element Plus):
- 群组列表页(搜索/分页/详情弹窗/解散群聊)
- 侧边栏群组管理入口

文档同步:进度/架构/设计/API/规范文档全部更新

Made-with: Cursor
This commit is contained in:
bujinyuan
2026-03-04 14:58:23 +08:00
parent ad76d9a613
commit 19979da59e
77 changed files with 10053 additions and 490 deletions

View File

@@ -34,6 +34,7 @@ func (h *EventHandler) registerEvents() {
h.hub.RegisterEvent("im.message.send", h.handleSendMessage)
h.hub.RegisterEvent("im.message.recall", h.handleRecallMessage)
h.hub.RegisterEvent("im.conversation.read", h.handleMarkRead)
h.hub.RegisterEvent("im.group.read", h.handleGroupRead)
h.hub.RegisterEvent("im.typing", h.handleTyping)
}
@@ -111,6 +112,29 @@ func (h *EventHandler) handleMarkRead(client *ws.Client, msg *ws.Message) {
h.sendACK(client, msg, 0, "ok", nil)
}
// handleGroupRead 处理群聊消息标记已读事件
func (h *EventHandler) handleGroupRead(client *ws.Client, msg *ws.Message) {
funcName := "handler.event_handler.handleGroupRead"
ctx := context.Background()
var req dto.MarkGroupReadRequest
if err := json.Unmarshal(msg.Data, &req); err != nil {
logs.Warn(ctx, funcName, "解析群已读请求失败",
zap.Int64("user_id", client.UserID), zap.Error(err))
h.sendACK(client, msg, -1, "请求参数格式错误", nil)
return
}
if err := h.imService.MarkGroupMessagesRead(ctx, client.UserID, &req); err != nil {
logs.Warn(ctx, funcName, "群已读标记失败",
zap.Int64("user_id", client.UserID), zap.Error(err))
h.sendACK(client, msg, -1, err.Error(), nil)
return
}
h.sendACK(client, msg, 0, "ok", nil)
}
// handleTyping 处理正在输入事件(通过 PubSub 转发给对方,支持跨实例)
func (h *EventHandler) handleTyping(client *ws.Client, msg *ws.Message) {
funcName := "handler.event_handler.handleTyping"