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

backend/go-service/app/file/controller/file_controller.go

@@ -0,0 +1,70 @@
+// Package controller 提供文件上传模块的 HTTP 接口处理
+package controller
+
+import (
+	"github.com/echochat/backend/app/file/service"
+	"github.com/echochat/backend/pkg/middleware"
+	"github.com/echochat/backend/pkg/utils"
+	"github.com/gin-gonic/gin"
+)
+
+const maxUploadSize = 10 << 20 // 10 MB
+
+// FileController 文件上传控制器
+type FileController struct {
+	fileService *service.FileService
+}
+
+// NewFileController 创建文件上传控制器
+func NewFileController(fileService *service.FileService) *FileController {
+	return &FileController{fileService: fileService}
+}
+
+// Upload 处理文件上传请求
+// POST /api/v1/upload
+// 支持 multipart/form-data，字段名为 "file"
+func (ctl *FileController) Upload(c *gin.Context) {
+	ctx := c.Request.Context()
+	_, ok := middleware.GetCurrentUserID(c)
+	if !ok {
+		utils.ResponseUnauthorized(c, "无法获取当前用户信息")
+		return
+	}
+
+	fileHeader, err := c.FormFile("file")
+	if err != nil {
+		utils.ResponseBadRequest(c, "请选择要上传的文件")
+		return
+	}
+
+	if fileHeader.Size > maxUploadSize {
+		utils.ResponseBadRequest(c, "文件大小不能超过 10MB")
+		return
+	}
+
+	result, err := ctl.fileService.Upload(ctx, fileHeader)
+	if err != nil {
+		ctl.handleError(c, err, "文件上传失败")
+		return
+	}
+
+	utils.ResponseOK(c, result)
+}
+
+// handleError 统一业务错误映射
+// 已知业务错误 → 返回 Service 层定义的具体提示
+// 未知错误 → 返回 fallbackMsg（未传则默认"服务器内部错误"）
+func (ctl *FileController) handleError(c *gin.Context, err error, fallbackMsg ...string) {
+	switch err {
+	case service.ErrFileOpen:
+		utils.ResponseBadRequest(c, err.Error())
+	case service.ErrUploadFailed:
+		utils.ResponseError(c, err.Error())
+	default:
+		msg := "服务器内部错误"
+		if len(fallbackMsg) > 0 && fallbackMsg[0] != "" {
+			msg = fallbackMsg[0]
+		}
+		utils.ResponseError(c, msg)
+	}
+}

backend/go-service/app/file/provider.go

@@ -0,0 +1,14 @@
+// Package file 文件上传模块 Wire 依赖注入配置
+package file
+
+import (
+	"github.com/echochat/backend/app/file/controller"
+	"github.com/echochat/backend/app/file/service"
+	"github.com/google/wire"
+)
+
+// FileSet 文件上传模块 Wire Provider Set
+var FileSet = wire.NewSet(
+	service.NewFileService,
+	controller.NewFileController,
+)

backend/go-service/app/file/router.go

@@ -0,0 +1,16 @@
+// Package file 文件上传模块路由注册
+package file
+
+import (
+	"github.com/echochat/backend/app/file/controller"
+	"github.com/gin-gonic/gin"
+)
+
+// RegisterRoutes 注册文件上传模块的所有路由（需要 JWT 中间件）
+func RegisterRoutes(r *gin.Engine, ctrl *controller.FileController, jwtAuth gin.HandlerFunc) {
+	authed := r.Group("/api/v1")
+	authed.Use(jwtAuth)
+	{
+		authed.POST("/upload", ctrl.Upload)
+	}
+}

backend/go-service/app/file/service/file_service.go

@@ -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
+}