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
@@ -16,7 +16,7 @@
|
||||
| [frontend/contact.md](frontend/contact.md) | 联系人 | ✅ Phase 2a | 17 个 API：好友申请/管理、好友分组、黑名单、搜索/推荐、在线状态 |
|
||||
| [frontend/websocket.md](frontend/websocket.md) | WebSocket | ✅ Phase 2a | 前端 WebSocket 连接管理、事件协议、心跳、重连 |
|
||||
| [frontend/im.md](frontend/im.md) | 即时通讯 | ✅ Phase 2b | 7 个 API：会话列表/置顶/删除/清空、历史消息、全局搜索、未读数 |
|
||||
| [frontend/group.md](frontend/group.md) | 群聊管理 | 🔜 Phase 2c | 16 个 API：建群/管理/成员/角色/禁言/公告/搜索/入群审批 |
|
||||
| [frontend/group.md](frontend/group.md) | 群聊管理 | ✅ Phase 2c | 16 个 API：建群/管理/成员/角色/禁言/公告/搜索/入群审批 |
|
||||
| [frontend/meeting.md](frontend/meeting.md) | 会议 | 📋 后续 | 即时会议、预约会议、加入/离开、会议列表 |
|
||||
| [frontend/notify.md](frontend/notify.md) | 通知 | 📋 后续 | 通知列表、标记已读 |
|
||||
|
||||
@@ -28,7 +28,7 @@
|
||||
| [admin/user.md](admin/user.md) | 用户管理 | ✅ Phase 1 | 用户列表/详情、状态管理、角色分配、创建用户 |
|
||||
| [admin/online.md](admin/online.md) | 在线监控 | ✅ Phase 2a | 在线用户列表、在线用户计数 |
|
||||
| [admin/contact.md](admin/contact.md) | 好友关系管理 | ✅ Phase 2a | 好友关系列表（分页）、管理员解除好友关系 |
|
||||
| [admin/group.md](admin/group.md) | 群聊管理 | 🔜 Phase 2c | 群列表/详情、管理员解散群/移除成员 |
|
||||
| [admin/group.md](admin/group.md) | 群聊管理 | ✅ Phase 2c | 群列表/详情、管理员解散群聊 |
|
||||
| [admin/meeting.md](admin/meeting.md) | 会议管理 | 📋 后续 | 会议列表/详情、强制结束、会议统计 |
|
||||
| [admin/system.md](admin/system.md) | 系统管理 | 📋 待定 | 仪表盘数据、操作日志、系统配置 |
|
||||
|
||||
@@ -196,7 +196,8 @@ docs/api/
|
||||
│ ├── auth.md # 用户认证 ✅ Phase 1
|
||||
│ ├── contact.md # 联系人管理（17 个 API） ✅ Phase 2a
|
||||
│ ├── websocket.md # WebSocket 事件协议 ✅ Phase 2a
|
||||
│ ├── im.md # 即时通讯（7 个 API） ✅ Phase 2b
|
||||
│ ├── im.md # 即时通讯（8 个 API） ✅ Phase 2b/2c
|
||||
│ ├── group.md # 群聊管理（16 个 API） ✅ Phase 2c
|
||||
│ ├── meeting.md # 会议 📋 后续
|
||||
│ └── notify.md # 通知 📋 后续
|
||||
├── admin/ # 后台管理端 API
|
||||
@@ -204,7 +205,8 @@ docs/api/
|
||||
│ ├── user.md # 用户管理 ✅ Phase 1
|
||||
│ ├── online.md # 在线监控 ✅ Phase 2a
|
||||
│ ├── contact.md # 好友关系管理 ✅ Phase 2a
|
||||
│ ├── group.md # 群聊管理（3 个 API） ✅ Phase 2c
|
||||
│ ├── meeting.md # 会议管理 📋 后续
|
||||
│ └── system.md # 系统管理 📋 待定
|
||||
└── websocket.md # WebSocket 全量事件协议 ✅ Phase 2a/2b
|
||||
└── websocket.md # WebSocket 全量事件协议 ✅ Phase 2a/2b/2c
|
||||
```
|
||||
|
||||
@@ -435,3 +435,214 @@
|
||||
"message": "我是你的同事"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 群聊事件（Phase 2c）
|
||||
|
||||
### im.group.read
|
||||
|
||||
**方向：** 客户端 → 服务端
|
||||
|
||||
**说明：** 标记群聊消息已读（消息级已读回执）
|
||||
|
||||
**data 内容：**
|
||||
```json
|
||||
{
|
||||
"conversation_id": 100,
|
||||
"message_ids": [501, 502, 503]
|
||||
}
|
||||
```
|
||||
|
||||
**ACK 响应：** `{ "code": 0, "message": "ok" }`
|
||||
|
||||
---
|
||||
|
||||
### group.created
|
||||
|
||||
**方向：** 服务端 → 客户端
|
||||
|
||||
**说明：** 群聊创建成功，推送给所有初始成员
|
||||
|
||||
**data 内容：**
|
||||
```json
|
||||
{
|
||||
"group_id": 10,
|
||||
"conversation_id": 100,
|
||||
"name": "项目讨论组",
|
||||
"owner_id": 1
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### group.info.update
|
||||
|
||||
**方向：** 服务端 → 客户端
|
||||
|
||||
**说明：** 群信息更新（名称、头像、公告等），推送给所有群成员
|
||||
|
||||
**data 内容：**
|
||||
```json
|
||||
{
|
||||
"group_id": 10,
|
||||
"conversation_id": 100,
|
||||
"operator_id": 1
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### group.dissolved
|
||||
|
||||
**方向：** 服务端 → 客户端
|
||||
|
||||
**说明：** 群聊已解散，推送给所有群成员
|
||||
|
||||
**data 内容：**
|
||||
```json
|
||||
{
|
||||
"group_id": 10,
|
||||
"conversation_id": 100,
|
||||
"operator_id": 1
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### group.member.join
|
||||
|
||||
**方向：** 服务端 → 客户端
|
||||
|
||||
**说明：** 新成员加入群聊（邀请加入或审批通过），推送给所有群成员
|
||||
|
||||
**data 内容：**
|
||||
```json
|
||||
{
|
||||
"group_id": 10,
|
||||
"conversation_id": 100,
|
||||
"user_ids": [5, 6]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### group.member.kicked
|
||||
|
||||
**方向：** 服务端 → 客户端
|
||||
|
||||
**说明：** 成员被移出群聊，推送给所有群成员
|
||||
|
||||
**data 内容：**
|
||||
```json
|
||||
{
|
||||
"group_id": 10,
|
||||
"conversation_id": 100,
|
||||
"user_id": 5,
|
||||
"operator_id": 1
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### group.member.leave
|
||||
|
||||
**方向：** 服务端 → 客户端
|
||||
|
||||
**说明：** 成员主动退出群聊，推送给其余群成员
|
||||
|
||||
**data 内容：**
|
||||
```json
|
||||
{
|
||||
"group_id": 10,
|
||||
"conversation_id": 100,
|
||||
"user_id": 5
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### group.role.update
|
||||
|
||||
**方向：** 服务端 → 客户端
|
||||
|
||||
**说明：** 成员角色变更（设为/取消管理员），推送给所有群成员
|
||||
|
||||
**data 内容：**
|
||||
```json
|
||||
{
|
||||
"group_id": 10,
|
||||
"conversation_id": 100,
|
||||
"user_id": 5,
|
||||
"new_role": 1,
|
||||
"operator_id": 1
|
||||
}
|
||||
```
|
||||
|
||||
> `new_role`：0=普通成员，1=管理员，2=群主
|
||||
|
||||
---
|
||||
|
||||
### group.mute.update
|
||||
|
||||
**方向：** 服务端 → 客户端
|
||||
|
||||
**说明：** 禁言状态变更（个人禁言或全体禁言），推送给所有群成员
|
||||
|
||||
**data 内容（个人禁言）：**
|
||||
```json
|
||||
{
|
||||
"group_id": 10,
|
||||
"conversation_id": 100,
|
||||
"user_id": 5,
|
||||
"is_muted": true,
|
||||
"operator_id": 1
|
||||
}
|
||||
```
|
||||
|
||||
**data 内容（全体禁言）：**
|
||||
```json
|
||||
{
|
||||
"group_id": 10,
|
||||
"conversation_id": 100,
|
||||
"is_all_muted": true,
|
||||
"operator_id": 1
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### group.owner.transfer
|
||||
|
||||
**方向：** 服务端 → 客户端
|
||||
|
||||
**说明：** 群主转让，推送给所有群成员
|
||||
|
||||
**data 内容：**
|
||||
```json
|
||||
{
|
||||
"group_id": 10,
|
||||
"conversation_id": 100,
|
||||
"old_owner_id": 1,
|
||||
"new_owner_id": 5
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### group.join.request
|
||||
|
||||
**方向：** 服务端 → 客户端
|
||||
|
||||
**说明：** 新的入群申请，推送给群主和管理员
|
||||
|
||||
**data 内容：**
|
||||
```json
|
||||
{
|
||||
"group_id": 10,
|
||||
"request_id": 20,
|
||||
"user_id": 8,
|
||||
"user_nickname": "新用户",
|
||||
"message": "请让我加入"
|
||||
}
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user