Files
EchoChat/backend/go-service/app/im/service/interfaces.go
bujinyuan 19979da59e 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
2026-03-04 14:58:23 +08:00

38 lines
1.4 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// Package service 提供 IM 模块的业务逻辑
package service
import (
"context"
authModel "github.com/echochat/backend/app/auth/model"
"github.com/echochat/backend/app/dto"
)
// FriendChecker 好友关系校验接口
// 由 contact.FriendshipDAO 隐式实现,通过 Wire 接口注入避免直接依赖 contact 包
type FriendChecker interface {
IsFriend(ctx context.Context, userID, targetID int64) (bool, error)
}
// UserInfoGetter 用户信息批量查询接口
// 由 contact.FriendshipDAO 隐式实现,返回 id/username/nickname/avatar
type UserInfoGetter interface {
GetUsersByIDs(ctx context.Context, userIDs []int64) ([]authModel.User, error)
}
// GroupInfoGetter 群信息查询接口Phase 2c
// 由 group.GroupDAO 隐式实现,通过 Wire 接口注入
// IM 模块通过此接口获取群表信息(判断全体禁言、已解散等)
// 成员信息(角色/禁言/列表)通过 convDAO 直接查询 im_conversation_members 表
type GroupInfoGetter interface {
GetGroupBrief(ctx context.Context, conversationID int64) (*dto.GroupBrief, error)
}
// MessageReadRecorder 群消息已读记录接口Phase 2c
// 由 group.MessageReadDAO 隐式实现
type MessageReadRecorder interface {
BatchCreateReads(ctx context.Context, messageIDs []int64, userID int64) error
GetReadCountBatch(ctx context.Context, messageIDs []int64) (map[int64]int, error)
GetReadUserIDs(ctx context.Context, messageID int64) ([]int64, error)
}