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
177
backend/go-service/app/dto/group_dto.go
Normal file
177
backend/go-service/app/dto/group_dto.go
Normal file
@@ -0,0 +1,177 @@
|
||||
package dto
|
||||
|
||||
// ====== 群聊管理 DTO ======
|
||||
|
||||
// CreateGroupRequest 创建群聊请求
|
||||
// POST /api/v1/groups
|
||||
type CreateGroupRequest struct {
|
||||
Name string `json:"name" binding:"required,max=100"` // 群名称
|
||||
MemberIDs []int64 `json:"member_ids" binding:"required"` // 初始成员用户 ID 列表（不含创建者自身）
|
||||
Avatar string `json:"avatar"` // 群头像 URL（可选）
|
||||
}
|
||||
|
||||
// UpdateGroupRequest 更新群信息请求
|
||||
// PUT /api/v1/groups/:id
|
||||
type UpdateGroupRequest struct {
|
||||
Name *string `json:"name"` // 群名称
|
||||
Avatar *string `json:"avatar"` // 群头像 URL
|
||||
Notice *string `json:"notice"` // 群公告
|
||||
IsSearchable *bool `json:"is_searchable"` // 是否可被搜索
|
||||
}
|
||||
|
||||
// GroupDTO 群聊信息传输对象（返回给前端）
|
||||
type GroupDTO struct {
|
||||
ID int64 `json:"id"` // 群 ID
|
||||
ConversationID int64 `json:"conversation_id"` // 关联会话 ID
|
||||
Name string `json:"name"` // 群名称
|
||||
Avatar string `json:"avatar"` // 群头像
|
||||
OwnerID int64 `json:"owner_id"` // 群主用户 ID
|
||||
Notice string `json:"notice"` // 群公告
|
||||
MaxMembers int `json:"max_members"` // 最大成员数
|
||||
MemberCount int `json:"member_count"` // 当前成员数
|
||||
IsSearchable bool `json:"is_searchable"` // 是否可被搜索
|
||||
IsAllMuted bool `json:"is_all_muted"` // 是否全体禁言
|
||||
Status int `json:"status"` // 群状态：1=正常，2=已解散
|
||||
CreatedAt string `json:"created_at"` // 创建时间
|
||||
}
|
||||
|
||||
// ====== 群成员 DTO ======
|
||||
|
||||
// GroupMemberDTO 群成员信息传输对象
|
||||
type GroupMemberDTO struct {
|
||||
UserID int64 `json:"user_id"` // 用户 ID
|
||||
Nickname string `json:"nickname"` // 群内昵称
|
||||
UserNickname string `json:"user_nickname"` // 用户原始昵称
|
||||
Avatar string `json:"avatar"` // 用户头像
|
||||
Role int `json:"role"` // 角色：0=普通成员，1=管理员，2=群主
|
||||
IsMuted bool `json:"is_muted"` // 是否被禁言
|
||||
JoinedAt string `json:"joined_at"` // 加入时间
|
||||
}
|
||||
|
||||
// InviteMembersRequest 邀请入群请求
|
||||
// POST /api/v1/groups/:id/members
|
||||
type InviteMembersRequest struct {
|
||||
UserIDs []int64 `json:"user_ids" binding:"required"` // 被邀请的用户 ID 列表
|
||||
}
|
||||
|
||||
// SetRoleRequest 设置/取消管理员请求
|
||||
// PUT /api/v1/groups/:id/members/:uid/role
|
||||
type SetRoleRequest struct {
|
||||
Role int `json:"role" binding:"oneof=0 1"` // 目标角色：0=普通成员，1=管理员
|
||||
}
|
||||
|
||||
// MuteRequest 禁言/解除禁言请求
|
||||
// PUT /api/v1/groups/:id/members/:uid/mute
|
||||
type MuteRequest struct {
|
||||
IsMuted bool `json:"is_muted"` // true=禁言, false=解除
|
||||
}
|
||||
|
||||
// TransferOwnerRequest 转让群主请求
|
||||
// PUT /api/v1/groups/:id/transfer
|
||||
type TransferOwnerRequest struct {
|
||||
NewOwnerID int64 `json:"new_owner_id" binding:"required"` // 新群主用户 ID
|
||||
}
|
||||
|
||||
// UpdateNicknameRequest 修改群昵称请求
|
||||
// PUT /api/v1/groups/:id/members/me/nickname
|
||||
type UpdateNicknameRequest struct {
|
||||
Nickname string `json:"nickname" binding:"max=50"` // 群内昵称
|
||||
}
|
||||
|
||||
// ====== 入群申请 DTO ======
|
||||
|
||||
// JoinGroupRequest 申请入群请求
|
||||
// POST /api/v1/groups/:id/join-requests
|
||||
type JoinGroupRequest struct {
|
||||
Message string `json:"message"` // 申请附言
|
||||
}
|
||||
|
||||
// ReviewJoinRequest 审批入群申请请求
|
||||
// PUT /api/v1/groups/:id/join-requests/:rid
|
||||
type ReviewJoinRequest struct {
|
||||
Action string `json:"action" binding:"required,oneof=approve reject"` // 操作：approve=通过, reject=拒绝
|
||||
}
|
||||
|
||||
// JoinRequestDTO 入群申请传输对象
|
||||
type JoinRequestDTO struct {
|
||||
ID int64 `json:"id"` // 申请 ID
|
||||
GroupID int64 `json:"group_id"` // 群 ID
|
||||
UserID int64 `json:"user_id"` // 申请人用户 ID
|
||||
UserNickname string `json:"user_nickname"` // 申请人昵称
|
||||
UserAvatar string `json:"user_avatar"` // 申请人头像
|
||||
Message string `json:"message"` // 申请附言
|
||||
Status int `json:"status"` // 状态：0=待审批，1=通过，2=拒绝
|
||||
CreatedAt string `json:"created_at"` // 申请时间
|
||||
}
|
||||
|
||||
// ====== 群搜索 DTO ======
|
||||
|
||||
// SearchGroupRequest 搜索群聊请求
|
||||
// GET /api/v1/groups/search?keyword=xx&page=1&page_size=20
|
||||
type SearchGroupRequest struct {
|
||||
Keyword string `form:"keyword" binding:"required"` // 搜索关键词
|
||||
Page int `form:"page"` // 页码（默认 1）
|
||||
PageSize int `form:"page_size"` // 每页数量（默认 20）
|
||||
}
|
||||
|
||||
// SearchGroupResponse 搜索群聊响应
|
||||
type SearchGroupResponse struct {
|
||||
List []GroupDTO `json:"list"` // 搜索结果
|
||||
Total int64 `json:"total"` // 总数
|
||||
}
|
||||
|
||||
// ====== 已读回执 DTO ======
|
||||
|
||||
// MarkGroupReadRequest 群聊标记已读请求（WS 事件 im.message.read 的 data 字段）
|
||||
type MarkGroupReadRequest struct {
|
||||
ConversationID int64 `json:"conversation_id"` // 会话 ID
|
||||
MessageIDs []int64 `json:"message_ids"` // 已读消息 ID 列表
|
||||
}
|
||||
|
||||
// MessageReadCountDTO 消息已读计数传输对象
|
||||
type MessageReadCountDTO struct {
|
||||
MessageID int64 `json:"message_id"` // 消息 ID
|
||||
ReadCount int `json:"read_count"` // 已读人数
|
||||
}
|
||||
|
||||
// MessageReadDetailDTO 消息已读详情传输对象
|
||||
type MessageReadDetailDTO struct {
|
||||
UserID int64 `json:"user_id"` // 已读用户 ID
|
||||
UserNickname string `json:"user_nickname"` // 用户昵称
|
||||
UserAvatar string `json:"user_avatar"` // 用户头像
|
||||
ReadAt string `json:"read_at"` // 已读时间
|
||||
}
|
||||
|
||||
// GetReadDetailRequest 获取已读详情请求
|
||||
// GET /api/v1/im/messages/:id/reads?page=1&page_size=20
|
||||
type GetReadDetailRequest struct {
|
||||
Page int `form:"page"` // 页码（默认 1）
|
||||
PageSize int `form:"page_size"` // 每页数量（默认 20）
|
||||
}
|
||||
|
||||
// GetReadDetailResponse 获取已读详情响应
|
||||
type GetReadDetailResponse struct {
|
||||
ReadList []MessageReadDetailDTO `json:"read_list"` // 已读用户列表
|
||||
UnreadList []MessageReadDetailDTO `json:"unread_list"` // 未读用户列表
|
||||
ReadCount int `json:"read_count"` // 已读人数
|
||||
TotalCount int `json:"total_count"` // 群成员总数（不含发送者）
|
||||
}
|
||||
|
||||
// ====== 免打扰 DTO ======
|
||||
|
||||
// SetDoNotDisturbRequest 设置/取消免打扰请求
|
||||
// PUT /api/v1/im/conversations/:id/dnd
|
||||
type SetDoNotDisturbRequest struct {
|
||||
IsDoNotDisturb bool `json:"is_do_not_disturb"` // true=开启, false=关闭
|
||||
}
|
||||
|
||||
// ====== 跨模块接口数据传输 ======
|
||||
|
||||
// GroupBrief 群简要信息（IM 模块通过 GroupInfoGetter 接口获取）
|
||||
type GroupBrief struct {
|
||||
ID int64 `json:"id"`
|
||||
Name string `json:"name"`
|
||||
Avatar string `json:"avatar"`
|
||||
IsAllMuted bool `json:"is_all_muted"`
|
||||
Status int `json:"status"`
|
||||
}
|
||||
@@ -4,23 +4,25 @@ package dto
|
||||
|
||||
// SendMessageRequest 发送消息请求（WS 事件 im.message.send 的 data 字段）
|
||||
type SendMessageRequest struct {
|
||||
ConversationID int64 `json:"conversation_id"` // 会话 ID（与 TargetUserID 二选一）
|
||||
TargetUserID int64 `json:"target_user_id"` // 对方用户 ID（首次发消息时使用，自动创建会话）
|
||||
Type int `json:"type"` // 消息类型：1=文本
|
||||
Content string `json:"content"` // 消息内容
|
||||
ClientMsgID string `json:"client_msg_id"` // 客户端消息唯一 ID，用于幂等去重
|
||||
ConversationID int64 `json:"conversation_id"` // 会话 ID（与 TargetUserID 二选一）
|
||||
TargetUserID int64 `json:"target_user_id"` // 对方用户 ID（首次发消息时使用，自动创建会话）
|
||||
Type int `json:"type"` // 消息类型：1=文本
|
||||
Content string `json:"content"` // 消息内容
|
||||
ClientMsgID string `json:"client_msg_id"` // 客户端消息唯一 ID，用于幂等去重
|
||||
AtUserIDs []int64 `json:"at_user_ids"` // @提醒用户 ID 列表（含 0 表示 @所有人）
|
||||
}
|
||||
|
||||
// MessageDTO 消息传输对象（返回给前端）
|
||||
type MessageDTO struct {
|
||||
ID int64 `json:"id"` // 消息 ID
|
||||
ConversationID int64 `json:"conversation_id"` // 所属会话 ID
|
||||
SenderID int64 `json:"sender_id"` // 发送者用户 ID
|
||||
Type int `json:"type"` // 消息类型
|
||||
Content string `json:"content"` // 消息内容
|
||||
Status int `json:"status"` // 消息状态：1=正常，2=已撤回
|
||||
ClientMsgID string `json:"client_msg_id"` // 客户端消息 ID
|
||||
CreatedAt string `json:"created_at"` // 发送时间
|
||||
ID int64 `json:"id"` // 消息 ID
|
||||
ConversationID int64 `json:"conversation_id"` // 所属会话 ID
|
||||
SenderID int64 `json:"sender_id"` // 发送者用户 ID
|
||||
Type int `json:"type"` // 消息类型
|
||||
Content string `json:"content"` // 消息内容
|
||||
Status int `json:"status"` // 消息状态：1=正常，2=已撤回
|
||||
ClientMsgID string `json:"client_msg_id"` // 客户端消息 ID
|
||||
AtUserIDs []int64 `json:"at_user_ids"` // @提醒用户 ID 列表
|
||||
CreatedAt string `json:"created_at"` // 发送时间
|
||||
}
|
||||
|
||||
// RecallMessageRequest 撤回消息请求（WS 事件 im.message.recall 的 data 字段）
|
||||
@@ -32,16 +34,19 @@ type RecallMessageRequest struct {
|
||||
|
||||
// ConversationDTO 会话列表条目（返回给前端）
|
||||
type ConversationDTO struct {
|
||||
ID int64 `json:"id"` // 会话 ID
|
||||
Type int `json:"type"` // 会话类型：1=单聊
|
||||
PeerUserID int64 `json:"peer_user_id"` // 单聊对方用户 ID
|
||||
PeerNickname string `json:"peer_nickname"` // 对方昵称
|
||||
PeerAvatar string `json:"peer_avatar"` // 对方头像
|
||||
LastMsgContent string `json:"last_msg_content"` // 最后消息预览
|
||||
LastMsgTime string `json:"last_msg_time"` // 最后消息时间
|
||||
ID int64 `json:"id"` // 会话 ID
|
||||
Type int `json:"type"` // 会话类型：1=单聊，2=群聊
|
||||
PeerUserID int64 `json:"peer_user_id"` // 单聊对方用户 ID（群聊为 0）
|
||||
PeerNickname string `json:"peer_nickname"` // 对方昵称（群聊时为群名称）
|
||||
PeerAvatar string `json:"peer_avatar"` // 对方头像（群聊时为群头像）
|
||||
LastMsgContent string `json:"last_msg_content"` // 最后消息预览
|
||||
LastMsgTime string `json:"last_msg_time"` // 最后消息时间
|
||||
LastMsgSenderID *int64 `json:"last_msg_sender_id"` // 最后消息发送者 ID
|
||||
IsPinned bool `json:"is_pinned"` // 是否置顶
|
||||
UnreadCount int `json:"unread_count"` // 未读消息数
|
||||
IsPinned bool `json:"is_pinned"` // 是否置顶
|
||||
UnreadCount int `json:"unread_count"` // 未读消息数
|
||||
GroupID int64 `json:"group_id,omitempty"` // 群聊 ID（仅 type=2 有值）
|
||||
IsDoNotDisturb bool `json:"is_do_not_disturb"` // 是否免打扰
|
||||
AtMeCount int `json:"at_me_count"` // 被@提醒未读计数
|
||||
}
|
||||
|
||||
// ConversationListResponse 会话列表响应
|
||||
|
||||
Reference in New Issue
Block a user