feat(im): Task 3 - IM Service 核心业务 + DTO + 接口定义
IMService 核心方法: - SendMessage: 发送消息(好友校验→查找/创建会话→幂等去重→写入→推送) - RecallMessage: 2分钟撤回 - GetConversationList: 会话列表(含对方用户信息) - GetHistoryMessages: 游标分页历史消息 - MarkRead / PinConversation / DeleteConversation / ClearHistory - SearchMessages: 全局消息搜索 - GetTotalUnread: Redis 全局未读总数 DTO: - SendMessageRequest / RecallMessageRequest - ConversationDTO / HistoryMessageResponse - SearchMessageRequest / MarkReadRequest / TypingRequest 接口: - FriendChecker: 好友校验(contact 模块注入) - UserInfoGetter: 用户信息批量查询(contact 模块注入) Made-with: Cursor
This commit is contained in:
109
backend/go-service/app/dto/im_dto.go
Normal file
109
backend/go-service/app/dto/im_dto.go
Normal file
@@ -0,0 +1,109 @@
|
||||
package dto
|
||||
|
||||
// ====== 消息相关 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,用于幂等去重
|
||||
}
|
||||
|
||||
// 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"` // 发送时间
|
||||
}
|
||||
|
||||
// RecallMessageRequest 撤回消息请求(WS 事件 im.message.recall 的 data 字段)
|
||||
type RecallMessageRequest struct {
|
||||
MessageID int64 `json:"message_id"` // 要撤回的消息 ID
|
||||
}
|
||||
|
||||
// ====== 会话相关 DTO ======
|
||||
|
||||
// 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"` // 最后消息时间
|
||||
LastMsgSenderID *int64 `json:"last_msg_sender_id"` // 最后消息发送者 ID
|
||||
IsPinned bool `json:"is_pinned"` // 是否置顶
|
||||
UnreadCount int `json:"unread_count"` // 未读消息数
|
||||
}
|
||||
|
||||
// ConversationListResponse 会话列表响应
|
||||
type ConversationListResponse struct {
|
||||
List []ConversationDTO `json:"list"` // 会话列表
|
||||
}
|
||||
|
||||
// PinConversationRequest 置顶/取消置顶请求
|
||||
type PinConversationRequest struct {
|
||||
IsPinned bool `json:"is_pinned"` // true=置顶, false=取消
|
||||
}
|
||||
|
||||
// ClearHistoryRequest 清空聊天记录请求(REST API)
|
||||
type ClearHistoryRequest struct {
|
||||
ConversationID int64 `json:"conversation_id" binding:"required"` // 会话 ID
|
||||
}
|
||||
|
||||
// ====== 消息搜索 DTO ======
|
||||
|
||||
// SearchMessageRequest 消息搜索请求
|
||||
type SearchMessageRequest struct {
|
||||
Keyword string `form:"keyword" binding:"required"` // 搜索关键词
|
||||
Limit int `form:"limit"` // 返回条数(默认 50)
|
||||
}
|
||||
|
||||
// SearchMessageResponse 消息搜索结果
|
||||
type SearchMessageResponse struct {
|
||||
List []MessageSearchItem `json:"list"` // 搜索结果列表
|
||||
}
|
||||
|
||||
// MessageSearchItem 搜索结果单条
|
||||
type MessageSearchItem struct {
|
||||
MessageDTO
|
||||
SenderNickname string `json:"sender_nickname"` // 发送者昵称
|
||||
SenderAvatar string `json:"sender_avatar"` // 发送者头像
|
||||
}
|
||||
|
||||
// ====== 历史消息 DTO ======
|
||||
|
||||
// HistoryMessageRequest 历史消息查询请求
|
||||
type HistoryMessageRequest struct {
|
||||
ConversationID int64 `form:"conversation_id" binding:"required"` // 会话 ID
|
||||
BeforeID int64 `form:"before_id"` // 游标:查询 ID 小于此值的消息,0 表示最新
|
||||
Limit int `form:"limit"` // 每次拉取条数(默认 30)
|
||||
}
|
||||
|
||||
// HistoryMessageResponse 历史消息响应
|
||||
type HistoryMessageResponse struct {
|
||||
List []MessageDTO `json:"list"` // 消息列表(ID 降序)
|
||||
HasMore bool `json:"has_more"` // 是否还有更多历史消息
|
||||
}
|
||||
|
||||
// ====== 已读标记 DTO ======
|
||||
|
||||
// MarkReadRequest 标记已读请求(WS 事件 im.conversation.read 的 data 字段)
|
||||
type MarkReadRequest struct {
|
||||
ConversationID int64 `json:"conversation_id"` // 要标记已读的会话 ID
|
||||
}
|
||||
|
||||
// ====== 输入状态 DTO ======
|
||||
|
||||
// TypingRequest 正在输入通知请求(WS 事件 im.typing 的 data 字段)
|
||||
type TypingRequest struct {
|
||||
ConversationID int64 `json:"conversation_id"` // 会话 ID
|
||||
}
|
||||
Reference in New Issue
Block a user