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

@@ -40,6 +40,12 @@ export const useChatStore = defineStore('chat', () => {
/** 是否还有更多历史消息 conversationId -> boolean */
const hasMoreMap = ref({})
/** 单聊已读状态conversationId -> lastReadMsgId对方已读到的消息 ID */
const readStatusMap = ref({})
/** 群聊已读计数messageId -> readCount */
const groupReadCountMap = ref({})
// ==================== Computed ====================
/** 当前会话的消息列表conversationId 为 null 时取 pending 队列) */
@@ -85,7 +91,7 @@ export const useChatStore = defineStore('chat', () => {
*/
const sendMessage = (params) => {
const clientMsgId = _generateClientMsgId()
const { conversationId, targetUserId, content, type = 1 } = params
const { conversationId, targetUserId, content, type = 1, at_user_ids } = params
const userStore = useUserStore()
const tempMsg = {
@@ -105,13 +111,18 @@ export const useChatStore = defineStore('chat', () => {
pendingMessages.value[clientMsgId] = { status: 'sending', tempMsg }
const seq = wsService.send('im.message.send', {
const payload = {
conversation_id: conversationId || 0,
target_user_id: targetUserId || 0,
type,
content,
client_msg_id: clientMsgId
})
}
if (at_user_ids && at_user_ids.length > 0) {
payload.at_user_ids = at_user_ids
}
const seq = wsService.send('im.message.send', payload)
if (seq === -1) {
pendingMessages.value[clientMsgId].status = 'failed'
@@ -209,6 +220,8 @@ export const useChatStore = defineStore('chat', () => {
wsService.on('im.message.send.ack', _onSendACK)
wsService.on('im.offline.sync', _onOfflineSync)
wsService.on('im.typing', _onTyping)
wsService.on('im.message.read.ack', _onReadACK)
wsService.on('im.message.read.count', _onReadCount)
}
/** 收到新消息推送 */
@@ -311,6 +324,29 @@ export const useChatStore = defineStore('chat', () => {
fetchConversations()
}
/** 单聊已读确认(对方已读到某条消息) */
const _onReadACK = (msg) => {
if (!msg || !msg.data) return
const { conversation_id, last_read_msg_id } = msg.data
readStatusMap.value[conversation_id] = last_read_msg_id
}
/** 群聊已读计数更新 */
const _onReadCount = (msg) => {
if (!msg || !msg.data) return
const { message_id, read_count } = msg.data
groupReadCountMap.value[message_id] = read_count
}
/** 群聊标记已读(发送 WS 事件) */
const markGroupRead = (conversationId, messageIds) => {
if (!messageIds || messageIds.length === 0) return
wsService.send('im.group.read', {
conversation_id: conversationId,
message_ids: messageIds
})
}
/** 正在输入通知 */
const _onTyping = (msg) => {
if (!msg || !msg.data) return
@@ -366,6 +402,8 @@ export const useChatStore = defineStore('chat', () => {
totalUnread,
typingMap,
hasMoreMap,
readStatusMap,
groupReadCountMap,
currentMessages,
sortedConversations,
fetchConversations,
@@ -373,6 +411,7 @@ export const useChatStore = defineStore('chat', () => {
sendMessage,
recallMessage,
markRead,
markGroupRead,
sendTyping,
loadHistoryMessages,
pinConversation,