Files
EchoChat/backend/go-service/app/admin/controller/group_manage_controller.go
bujinyuan 19979da59e 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
2026-03-04 14:58:23 +08:00

95 lines
2.8 KiB
Go

// Package controller 提供 admin 模块的 HTTP 接口处理
package controller
import (
"strconv"
"github.com/echochat/backend/app/admin/service"
"github.com/echochat/backend/pkg/logs"
"github.com/echochat/backend/pkg/utils"
"github.com/gin-gonic/gin"
"go.uber.org/zap"
)
// GroupManageController 管理端群组管理控制器
type GroupManageController struct {
groupManageService *service.GroupManageService
}
// NewGroupManageController 创建群组管理控制器实例
func NewGroupManageController(svc *service.GroupManageService) *GroupManageController {
return &GroupManageController{groupManageService: svc}
}
// GetGroupList 获取群组列表
// GET /api/v1/admin/groups?page=1&page_size=20&keyword=xxx
func (ctl *GroupManageController) GetGroupList(c *gin.Context) {
funcName := "admin.group_manage_controller.GetGroupList"
ctx := c.Request.Context()
page, _ := strconv.Atoi(c.DefaultQuery("page", "1"))
pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "20"))
keyword := c.Query("keyword")
list, total, err := ctl.groupManageService.ListGroups(ctx, page, pageSize, keyword)
if err != nil {
logs.Error(ctx, funcName, "获取群组列表失败", zap.Error(err))
utils.ResponseError(c, "获取群组列表失败")
return
}
logs.Info(ctx, funcName, "获取群组列表成功",
zap.Int64("total", total), zap.Int("page", page))
utils.ResponseOK(c, gin.H{
"list": list,
"total": total,
})
}
// GetGroupDetail 获取群组详情
// GET /api/v1/admin/groups/:id
func (ctl *GroupManageController) GetGroupDetail(c *gin.Context) {
funcName := "admin.group_manage_controller.GetGroupDetail"
ctx := c.Request.Context()
id, err := strconv.ParseInt(c.Param("id"), 10, 64)
if err != nil {
utils.ResponseBadRequest(c, "ID 格式错误")
return
}
detail, err := ctl.groupManageService.GetGroupDetail(ctx, id)
if err != nil {
logs.Error(ctx, funcName, "获取群组详情失败",
zap.Int64("group_id", id), zap.Error(err))
utils.ResponseError(c, "获取群组详情失败")
return
}
logs.Info(ctx, funcName, "获取群组详情成功", zap.Int64("group_id", id))
utils.ResponseOK(c, detail)
}
// DissolveGroup 解散群聊
// DELETE /api/v1/admin/groups/:id
func (ctl *GroupManageController) DissolveGroup(c *gin.Context) {
funcName := "admin.group_manage_controller.DissolveGroup"
ctx := c.Request.Context()
id, err := strconv.ParseInt(c.Param("id"), 10, 64)
if err != nil {
utils.ResponseBadRequest(c, "ID 格式错误")
return
}
if err := ctl.groupManageService.DissolveGroup(ctx, id); err != nil {
logs.Error(ctx, funcName, "解散群聊失败",
zap.Int64("group_id", id), zap.Error(err))
utils.ResponseError(c, "解散群聊失败")
return
}
logs.Info(ctx, funcName, "解散群聊成功", zap.Int64("group_id", id))
utils.ResponseOK(c, nil)
}