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
@@ -18,10 +18,11 @@ alwaysApply: true
|
||||
- **Phase 2a（WebSocket 实时通讯与联系人管理）**：✅ 全部完成（13 个 Task + 后期 Bug 修复 3 项）
|
||||
- **Phase 2b（即时通讯消息系统）**：✅ 全部完成（10 个 Task + 代码审查修复 7 项 + 用户测试修复 8 项），设计文档 `docs/plans/2026-03-03-phase2b-design.md`
|
||||
- 分支：`feature/phase2b-instant-messaging`
|
||||
- **Phase 2c（群聊与已读回执）**：📋 设计完成，待实施（14 个 Task），设计文档 `docs/plans/2026-03-04-phase2c-design.md`，实施计划 `docs/plans/2026-03-04-phase2c-implementation.plan.md`
|
||||
- **Phase 2c（群聊与已读回执）**：✅ 全部完成（14 个 Task + 代码审查修复 14 项），设计文档 `docs/plans/2026-03-04-phase2c-design.md`
|
||||
- 分支：`feature/phase2c-group-read-receipt`
|
||||
- 范围：群聊全功能（三级角色/禁言/@提醒/群公告/入群审批）+ 已读回执（单聊会话级 + 群聊消息级）+ MinIO 文件存储 + 管理端群聊管理
|
||||
- **跨模块通信模式**：已建立接口注入标准（ws.FriendIDsGetter / im.FriendChecker / im.UserInfoGetter → contact.FriendshipDAO，im.OfflineMessagePusher → ws.Handler，contact.OnlineChecker → ws.OnlineService），Phase 2c 新增 im.GroupMemberChecker / im.GroupInfoGetter → group.GroupDAO
|
||||
- 范围：群聊全功能（三级角色/禁言/@提醒/群公告/入群审批）+ 已读回执（单聊会话级 + 群聊消息级）+ MinIO 文件存储 + 管理端群组管理
|
||||
- 代码审查修复：Critical×5（角色类型/公告字段/at_user_ids/@导航/Wire 注册）+ Important×4 + Minor×2 + Suggestion×3
|
||||
- **跨模块通信模式**：接口注入标准（ws.FriendIDsGetter / im.FriendChecker / im.UserInfoGetter → contact.FriendshipDAO，im.OfflineMessagePusher → ws.Handler，contact.OnlineChecker → ws.OnlineService，im.GroupInfoGetter → group.GroupDAO，im.MessageReadRecorder → group.MessageReadDAO，group.UserInfoProvider → auth.UserDAO，group.MessageWriter → im.MessageDAO）
|
||||
|
||||
## 项目概述
|
||||
|
||||
@@ -30,8 +31,8 @@ EchoChat 是一个实时音视频通讯平台，包含三个子项目：
|
||||
- `frontend/` — 前台用户端（uni-app + Vue 3.4 + Pinia 2.x）
|
||||
- `admin/` — 后台管理端（Vue 3.5+ + Element Plus + Pinia 3.x）
|
||||
|
||||
已实现模块：auth（认证）、contact（联系人）、ws（WebSocket）、admin（管理端）、im（即时通讯）
|
||||
Phase 2c 待实现模块：group（群聊管理）、file（文件上传/MinIO）+ im 扩展（已读回执）
|
||||
已实现模块：auth（认证）、contact（联系人）、ws（WebSocket）、admin（管理端）、im（即时通讯 + 已读回执）、group（群聊管理）、file（文件上传/MinIO）
|
||||
前端常量：`frontend/src/constants/group.js`（GROUP_ROLE / GROUP_STATUS / JOIN_REQUEST_STATUS，与后端 constants/group.go 对齐）
|
||||
|
||||
## 核心开发规则
|
||||
|
||||
@@ -45,10 +46,48 @@ Phase 2c 待实现模块：group（群聊管理）、file（文件上传/MinIO
|
||||
8. **角色等级体系**：`auth_roles.level` 字段（值越小权限越高：1=超管, 10=管理员, 100=普通用户），所有管理操作强制执行层级权限校验
|
||||
9. **代码注释**：所有公开函数、组件、Store 必须有详细注释
|
||||
10. **后端架构规范**：详见 `docs/conventions/backend-module-architecture.md`（模块分层/接口注入/日志/错误处理/批量查询/系统消息/Store 封装等）
|
||||
11. **文档自动同步（强制）**：每个 Task 或功能开发完成后，必须自动执行文档同步，详见下方「文档自动同步规则」
|
||||
12. **验证方式**：使用 Playwright MCP 进行页面自动化验证
|
||||
13. **代码审查**：每个 Task 完成后，使用 `code-reviewer` 子代理进行结构化审查，确保代码质量和计划一致性
|
||||
14. **完成验证**：使用 `verification-before-completion` 技能，在声称完成前运行验证命令并确认输出
|
||||
11. **代码风格全局一致（最高优先级）**：新编写的任何模块代码，必须严格参照已有模块的实际代码实现和风格，禁止自创新封装、新 API、新模式。详见下方「代码风格全局一致规则」
|
||||
12. **文档自动同步（强制）**：每个 Task 或功能开发完成后，必须自动执行文档同步，详见下方「文档自动同步规则」
|
||||
13. **验证方式**：使用 Playwright MCP 进行页面自动化验证
|
||||
14. **代码审查**：每个 Task 完成后，使用 `code-reviewer` 子代理进行结构化审查，确保代码质量和计划一致性
|
||||
15. **完成验证**：使用 `verification-before-completion` 技能，在声称完成前运行验证命令并确认输出
|
||||
|
||||
## 代码风格全局一致规则（最高优先级，强制执行）
|
||||
|
||||
> **核心原则：编写任何新模块/新文件的代码前，必须先阅读同层级现有模块的实际代码，严格复制其风格，禁止引入不存在的 API、封装或模式。**
|
||||
|
||||
### 执行流程（强制）
|
||||
|
||||
1. **写代码前**：先用 Read/Grep 工具读取同类型现有文件（如写新 Controller 前先读 `im_controller.go` 和 `contact_controller.go`）
|
||||
2. **写代码时**：逐行对照现有代码的导入、结构体定义、方法签名、日志调用、错误处理模式
|
||||
3. **写代码后**：与参照文件做差异比对，确认风格完全一致
|
||||
|
||||
### Go 后端各层代码风格（以实际代码为准）
|
||||
|
||||
详细的风格规范和代码模板见 `docs/conventions/backend-module-architecture.md`。以下是关键约定摘要：
|
||||
|
||||
| 层级 | 接收器 | 日志 | funcName | 错误处理 |
|
||||
|------|--------|------|----------|---------|
|
||||
| Controller（前台业务） | `ctl` | 不记日志 | 无 | 方法级 `handleError` |
|
||||
| Controller（auth/admin） | `ctrl`/`ctl` | 有日志 | 有 | `handleAuthError` 包级函数 / 内联 |
|
||||
| Service | `s` | `logs.Info/Debug/Error` | `"service.{file}.{Method}"` | 包顶部 `var ErrXxx` |
|
||||
| DAO | `d` | `logs.Info/Debug/Error` | `"dao.{file}.{Method}"` | `logs.Error` + 返回 err |
|
||||
|
||||
### 日志 API（以实际代码为准）
|
||||
|
||||
项目中 logs 包只有 `logs.Info/Debug/Warn/Error/Fatal` 五个方法，签名为 `logs.Xxx(ctx, funcName, message, ...zap.Field)`。
|
||||
**不存在** `logs.LogFunctionEntry` / `logs.LogFunctionExit` / `logs.LogSuccess` 等方法，**严禁使用不存在的 API**。
|
||||
|
||||
### 依赖管理
|
||||
|
||||
- **禁止随意拉取最新版本的依赖包**，必须选择与当前 Go 版本（go.mod 中的 `go` 指令）兼容的版本
|
||||
- **禁止触发 Go 工具链自动升级**，如果某依赖要求更高版本的 Go，必须选择兼容版本而非升级 Go
|
||||
- 添加依赖前先检查 go.mod 中的 Go 版本和已有依赖，优先复用已有依赖
|
||||
|
||||
### 前端代码风格
|
||||
|
||||
- 前端新页面/组件/Store 的编写，同样必须先阅读现有同类文件，严格遵循已有的代码结构、命名规范、状态管理模式
|
||||
- 禁止引入项目中未使用的新 UI 框架、状态管理库或工具函数库
|
||||
|
||||
## 文档自动同步规则（强制执行）
|
||||
|
||||
|
||||
Reference in New Issue
Block a user