19979da59e
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
543 lines
14 KiB
Go
543 lines
14 KiB
Go
// Package controller 提供 group 模块的 HTTP 接口处理
|
||
package controller
|
||
|
||
import (
|
||
"strconv"
|
||
|
||
"github.com/echochat/backend/app/dto"
|
||
"github.com/echochat/backend/app/group/service"
|
||
"github.com/echochat/backend/pkg/middleware"
|
||
"github.com/echochat/backend/pkg/utils"
|
||
"github.com/gin-gonic/gin"
|
||
)
|
||
|
||
// GroupController 群聊管理控制器（REST API）
|
||
type GroupController struct {
|
||
groupService *service.GroupService
|
||
}
|
||
|
||
// NewGroupController 创建 GroupController 实例
|
||
func NewGroupController(groupService *service.GroupService) *GroupController {
|
||
return &GroupController{groupService: groupService}
|
||
}
|
||
|
||
// CreateGroup 创建群聊
|
||
// POST /api/v1/groups
|
||
func (ctl *GroupController) CreateGroup(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
var req dto.CreateGroupRequest
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
utils.ResponseBadRequest(c, "参数校验失败: "+err.Error())
|
||
return
|
||
}
|
||
|
||
result, err := ctl.groupService.CreateGroup(ctx, userID, &req)
|
||
if err != nil {
|
||
ctl.handleError(c, err, "创建群聊失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, result)
|
||
}
|
||
|
||
// GetGroupDetail 获取群详情
|
||
// GET /api/v1/groups/:id
|
||
func (ctl *GroupController) GetGroupDetail(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
result, err := ctl.groupService.GetGroupDetail(ctx, userID, groupID)
|
||
if err != nil {
|
||
ctl.handleError(c, err, "获取群详情失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, result)
|
||
}
|
||
|
||
// UpdateGroup 更新群信息
|
||
// PUT /api/v1/groups/:id
|
||
func (ctl *GroupController) UpdateGroup(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
var req dto.UpdateGroupRequest
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
utils.ResponseBadRequest(c, "参数校验失败: "+err.Error())
|
||
return
|
||
}
|
||
|
||
if err := ctl.groupService.UpdateGroup(ctx, userID, groupID, &req); err != nil {
|
||
ctl.handleError(c, err, "更新群信息失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, nil)
|
||
}
|
||
|
||
// DissolveGroup 解散群聊
|
||
// DELETE /api/v1/groups/:id
|
||
func (ctl *GroupController) DissolveGroup(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
if err := ctl.groupService.DissolveGroup(ctx, userID, groupID); err != nil {
|
||
ctl.handleError(c, err, "解散群聊失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, nil)
|
||
}
|
||
|
||
// GetMembers 获取群成员列表
|
||
// GET /api/v1/groups/:id/members
|
||
func (ctl *GroupController) GetMembers(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
result, err := ctl.groupService.GetMembers(ctx, userID, groupID)
|
||
if err != nil {
|
||
ctl.handleError(c, err, "获取成员列表失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, result)
|
||
}
|
||
|
||
// InviteMembers 邀请入群
|
||
// POST /api/v1/groups/:id/members
|
||
func (ctl *GroupController) InviteMembers(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
var req dto.InviteMembersRequest
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
utils.ResponseBadRequest(c, "参数校验失败: "+err.Error())
|
||
return
|
||
}
|
||
|
||
if err := ctl.groupService.InviteMembers(ctx, userID, groupID, req.UserIDs); err != nil {
|
||
ctl.handleError(c, err, "邀请入群失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, nil)
|
||
}
|
||
|
||
// KickMember 踢出成员
|
||
// DELETE /api/v1/groups/:id/members/:uid
|
||
func (ctl *GroupController) KickMember(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
targetID, err := strconv.ParseInt(c.Param("uid"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "用户 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
if err := ctl.groupService.KickMember(ctx, userID, groupID, targetID); err != nil {
|
||
ctl.handleError(c, err, "踢出成员失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, nil)
|
||
}
|
||
|
||
// SetMemberRole 设置/取消管理员
|
||
// PUT /api/v1/groups/:id/members/:uid/role
|
||
func (ctl *GroupController) SetMemberRole(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
targetID, err := strconv.ParseInt(c.Param("uid"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "用户 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
var req dto.SetRoleRequest
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
utils.ResponseBadRequest(c, "参数校验失败: "+err.Error())
|
||
return
|
||
}
|
||
|
||
if err := ctl.groupService.SetMemberRole(ctx, userID, groupID, targetID, req.Role); err != nil {
|
||
ctl.handleError(c, err, "设置角色失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, nil)
|
||
}
|
||
|
||
// MuteMember 禁言/解除禁言
|
||
// PUT /api/v1/groups/:id/members/:uid/mute
|
||
func (ctl *GroupController) MuteMember(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
targetID, err := strconv.ParseInt(c.Param("uid"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "用户 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
var req dto.MuteRequest
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
utils.ResponseBadRequest(c, "参数校验失败: "+err.Error())
|
||
return
|
||
}
|
||
|
||
if err := ctl.groupService.MuteMember(ctx, userID, groupID, targetID, req.IsMuted); err != nil {
|
||
ctl.handleError(c, err, "操作失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, nil)
|
||
}
|
||
|
||
// TransferOwner 转让群主
|
||
// PUT /api/v1/groups/:id/transfer
|
||
func (ctl *GroupController) TransferOwner(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
var req dto.TransferOwnerRequest
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
utils.ResponseBadRequest(c, "参数校验失败: "+err.Error())
|
||
return
|
||
}
|
||
|
||
if err := ctl.groupService.TransferOwner(ctx, userID, groupID, req.NewOwnerID); err != nil {
|
||
ctl.handleError(c, err, "转让群主失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, nil)
|
||
}
|
||
|
||
// LeaveGroup 退出群聊
|
||
// DELETE /api/v1/groups/:id/members/me
|
||
func (ctl *GroupController) LeaveGroup(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
if err := ctl.groupService.LeaveGroup(ctx, userID, groupID); err != nil {
|
||
ctl.handleError(c, err, "退出群聊失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, nil)
|
||
}
|
||
|
||
// UpdateNickname 修改群内昵称
|
||
// PUT /api/v1/groups/:id/members/me/nickname
|
||
func (ctl *GroupController) UpdateNickname(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
var req dto.UpdateNicknameRequest
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
utils.ResponseBadRequest(c, "参数校验失败: "+err.Error())
|
||
return
|
||
}
|
||
|
||
if err := ctl.groupService.UpdateNickname(ctx, userID, groupID, req.Nickname); err != nil {
|
||
ctl.handleError(c, err, "修改昵称失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, nil)
|
||
}
|
||
|
||
// SubmitJoinRequest 申请入群
|
||
// POST /api/v1/groups/:id/join-requests
|
||
func (ctl *GroupController) SubmitJoinRequest(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
var req dto.JoinGroupRequest
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
utils.ResponseBadRequest(c, "参数校验失败: "+err.Error())
|
||
return
|
||
}
|
||
|
||
if err := ctl.groupService.SubmitJoinRequest(ctx, userID, groupID, req.Message); err != nil {
|
||
ctl.handleError(c, err, "申请入群失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, nil)
|
||
}
|
||
|
||
// GetJoinRequests 获取入群申请列表
|
||
// GET /api/v1/groups/:id/join-requests
|
||
func (ctl *GroupController) GetJoinRequests(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
result, err := ctl.groupService.GetJoinRequests(ctx, userID, groupID)
|
||
if err != nil {
|
||
ctl.handleError(c, err, "获取入群申请失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, result)
|
||
}
|
||
|
||
// ReviewJoinRequest 审批入群申请
|
||
// PUT /api/v1/groups/:id/join-requests/:rid
|
||
func (ctl *GroupController) ReviewJoinRequest(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
requestID, err := strconv.ParseInt(c.Param("rid"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "申请 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
var req dto.ReviewJoinRequest
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
utils.ResponseBadRequest(c, "参数校验失败: "+err.Error())
|
||
return
|
||
}
|
||
|
||
if err := ctl.groupService.ReviewJoinRequest(ctx, userID, groupID, requestID, req.Action); err != nil {
|
||
ctl.handleError(c, err, "审批失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, nil)
|
||
}
|
||
|
||
// SearchGroups 搜索群聊
|
||
// GET /api/v1/groups/search?keyword=xx&page=1&page_size=20
|
||
func (ctl *GroupController) SearchGroups(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
_, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
var req dto.SearchGroupRequest
|
||
if err := c.ShouldBindQuery(&req); err != nil {
|
||
utils.ResponseBadRequest(c, "参数校验失败: "+err.Error())
|
||
return
|
||
}
|
||
|
||
result, err := ctl.groupService.SearchGroups(ctx, &req)
|
||
if err != nil {
|
||
ctl.handleError(c, err, "搜索群聊失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, result)
|
||
}
|
||
|
||
// SetAllMuted 设置全体禁言
|
||
// PUT /api/v1/groups/:id/all-mute
|
||
func (ctl *GroupController) SetAllMuted(c *gin.Context) {
|
||
ctx := c.Request.Context()
|
||
userID, ok := middleware.GetCurrentUserID(c)
|
||
if !ok {
|
||
utils.ResponseUnauthorized(c, "无法获取当前用户信息")
|
||
return
|
||
}
|
||
|
||
groupID, err := strconv.ParseInt(c.Param("id"), 10, 64)
|
||
if err != nil {
|
||
utils.ResponseBadRequest(c, "群 ID 格式错误")
|
||
return
|
||
}
|
||
|
||
var body struct {
|
||
IsAllMuted bool `json:"is_all_muted"`
|
||
}
|
||
if err := c.ShouldBindJSON(&body); err != nil {
|
||
utils.ResponseBadRequest(c, "参数校验失败: "+err.Error())
|
||
return
|
||
}
|
||
|
||
if err := ctl.groupService.SetAllMuted(ctx, userID, groupID, body.IsAllMuted); err != nil {
|
||
ctl.handleError(c, err, "设置全体禁言失败")
|
||
return
|
||
}
|
||
utils.ResponseOK(c, nil)
|
||
}
|
||
|
||
// handleError 统一业务错误映射
|
||
// 已知业务错误 → 返回 Service 层定义的具体提示
|
||
// 未知错误 → 返回 fallbackMsg（未传则默认"服务器内部错误"）
|
||
func (ctl *GroupController) handleError(c *gin.Context, err error, fallbackMsg ...string) {
|
||
switch err {
|
||
case service.ErrGroupNotFound:
|
||
utils.ResponseNotFound(c, err.Error())
|
||
case service.ErrGroupDissolved:
|
||
utils.ResponseBadRequest(c, err.Error())
|
||
case service.ErrNotGroupMember:
|
||
utils.ResponseForbidden(c, err.Error())
|
||
case service.ErrNotGroupOwner:
|
||
utils.ResponseForbidden(c, err.Error())
|
||
case service.ErrNotGroupAdmin:
|
||
utils.ResponseForbidden(c, err.Error())
|
||
case service.ErrGroupFull:
|
||
utils.ResponseBadRequest(c, err.Error())
|
||
case service.ErrAlreadyMember:
|
||
utils.ResponseBadRequest(c, err.Error())
|
||
case service.ErrCannotKickHigherRole:
|
||
utils.ResponseForbidden(c, err.Error())
|
||
case service.ErrOwnerCannotLeave:
|
||
utils.ResponseBadRequest(c, err.Error())
|
||
case service.ErrCannotMuteSelf:
|
||
utils.ResponseBadRequest(c, err.Error())
|
||
case service.ErrAlreadyMuted:
|
||
utils.ResponseBadRequest(c, err.Error())
|
||
case service.ErrUserMuted:
|
||
utils.ResponseForbidden(c, err.Error())
|
||
case service.ErrGroupAllMuted:
|
||
utils.ResponseForbidden(c, err.Error())
|
||
case service.ErrPendingRequestExists:
|
||
utils.ResponseBadRequest(c, err.Error())
|
||
case service.ErrJoinRequestNotFound:
|
||
utils.ResponseNotFound(c, err.Error())
|
||
default:
|
||
msg := "服务器内部错误"
|
||
if len(fallbackMsg) > 0 && fallbackMsg[0] != "" {
|
||
msg = fallbackMsg[0]
|
||
}
|
||
utils.ResponseError(c, msg)
|
||
}
|
||
}
|