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

@@ -0,0 +1,38 @@
// Package storage 提供对象存储基础设施
// 封装 MinIO 客户端初始化和存储桶自动创建逻辑
package storage
import (
"context"
"fmt"
"github.com/echochat/backend/config"
"github.com/minio/minio-go/v7"
"github.com/minio/minio-go/v7/pkg/credentials"
)
// NewMinioClient 初始化 MinIO 客户端并确保存储桶存在
// 启动时自动创建配置中指定的 bucket如不存在
func NewMinioClient(cfg *config.MinioConfig) (*minio.Client, error) {
client, err := minio.New(cfg.Endpoint, &minio.Options{
Creds: credentials.NewStaticV4(cfg.AccessKey, cfg.SecretKey, ""),
Secure: cfg.UseSSL,
})
if err != nil {
return nil, fmt.Errorf("创建 MinIO 客户端失败: %w", err)
}
ctx := context.Background()
exists, err := client.BucketExists(ctx, cfg.Bucket)
if err != nil {
return nil, fmt.Errorf("检查存储桶 %s 失败: %w", cfg.Bucket, err)
}
if !exists {
if err := client.MakeBucket(ctx, cfg.Bucket, minio.MakeBucketOptions{}); err != nil {
return nil, fmt.Errorf("创建存储桶 %s 失败: %w", cfg.Bucket, err)
}
}
return client, nil
}

View File

@@ -0,0 +1,70 @@
// Package utils 提供通用工具类型和函数
package utils
import (
"database/sql/driver"
"fmt"
"strconv"
"strings"
)
// Int64Array 自定义 PostgreSQL BIGINT[] 类型
// 实现 sql.Scanner 和 driver.Valuer 接口,用于 GORM 与 PostgreSQL 数组字段交互
type Int64Array []int64
// Scan 从数据库读取 PostgreSQL BIGINT[] 格式:{1,2,3}
func (a *Int64Array) Scan(src interface{}) error {
if src == nil {
*a = nil
return nil
}
var s string
switch v := src.(type) {
case []byte:
s = string(v)
case string:
s = v
default:
return fmt.Errorf("Int64Array.Scan: 不支持的类型 %T", src)
}
s = strings.TrimSpace(s)
if s == "{}" || s == "" {
*a = Int64Array{}
return nil
}
s = strings.Trim(s, "{}")
parts := strings.Split(s, ",")
result := make(Int64Array, 0, len(parts))
for _, p := range parts {
p = strings.TrimSpace(p)
if p == "" {
continue
}
n, err := strconv.ParseInt(p, 10, 64)
if err != nil {
return fmt.Errorf("Int64Array.Scan: 解析 '%s' 失败: %w", p, err)
}
result = append(result, n)
}
*a = result
return nil
}
// Value 写入数据库时转换为 PostgreSQL BIGINT[] 格式:{1,2,3}
func (a Int64Array) Value() (driver.Value, error) {
if a == nil {
return nil, nil
}
if len(a) == 0 {
return "{}", nil
}
parts := make([]string, len(a))
for i, v := range a {
parts[i] = strconv.FormatInt(v, 10)
}
return "{" + strings.Join(parts, ",") + "}", nil
}