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:
@@ -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