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,90 @@
// Package service 提供文件上传模块的业务逻辑
// 封装 MinIO 对象存储的上传操作,返回可访问的文件 URL
package service
import (
"context"
"errors"
"fmt"
"mime/multipart"
"path/filepath"
"strings"
"time"
"github.com/echochat/backend/config"
"github.com/echochat/backend/pkg/logs"
"github.com/google/uuid"
"github.com/minio/minio-go/v7"
"go.uber.org/zap"
)
var (
ErrFileOpen = errors.New("打开上传文件失败")
ErrUploadFailed = errors.New("文件上传失败")
)
// FileService 文件上传服务
type FileService struct {
minioClient *minio.Client
minioCfg *config.MinioConfig
}
// NewFileService 创建文件上传服务实例
func NewFileService(client *minio.Client, cfg *config.MinioConfig) *FileService {
return &FileService{
minioClient: client,
minioCfg: cfg,
}
}
// UploadResult 文件上传结果
type UploadResult struct {
URL string `json:"url"`
FileName string `json:"file_name"`
Size int64 `json:"size"`
}
// Upload 上传文件到 MinIO返回文件访问 URL
// 文件按日期目录组织uploads/2026/03/04/{uuid}.{ext}
func (s *FileService) Upload(ctx context.Context, fileHeader *multipart.FileHeader) (*UploadResult, error) {
funcName := "service.file_service.Upload"
logs.Info(ctx, funcName, "上传文件",
zap.String("file_name", fileHeader.Filename),
zap.Int64("size", fileHeader.Size))
file, err := fileHeader.Open()
if err != nil {
logs.Error(ctx, funcName, "打开上传文件失败", zap.Error(err))
return nil, ErrFileOpen
}
defer file.Close()
ext := strings.ToLower(filepath.Ext(fileHeader.Filename))
now := time.Now()
objectName := fmt.Sprintf("uploads/%s/%s%s", now.Format("2006/01/02"), uuid.New().String(), ext)
contentType := fileHeader.Header.Get("Content-Type")
if contentType == "" {
contentType = "application/octet-stream"
}
_, err = s.minioClient.PutObject(ctx, s.minioCfg.Bucket, objectName, file, fileHeader.Size, minio.PutObjectOptions{
ContentType: contentType,
})
if err != nil {
logs.Error(ctx, funcName, "上传文件到 MinIO 失败", zap.Error(err))
return nil, ErrUploadFailed
}
scheme := "http"
if s.minioCfg.UseSSL {
scheme = "https"
}
url := fmt.Sprintf("%s://%s/%s/%s", scheme, s.minioCfg.Endpoint, s.minioCfg.Bucket, objectName)
return &UploadResult{
URL: url,
FileName: fileHeader.Filename,
Size: fileHeader.Size,
}, nil
}