group

type AddGroupMembersServiceReq struct {
	GroupNo      string   // 群编号
	Members      []string // 待添加成员 UID 列表
	OperatorUID  string   // 操作者 UID
	OperatorName string   // 操作者名称
	TraceID      string   // 请求级 trace_id（reqid），用于串联 handler/service/auth/GIN 分段慢日志
}

type AddGroupMembersServiceResp struct {
	Added int // 实际添加成功的数量
}

type AddGroupReq struct {
	GroupNo string
	Name    string
}

type AddMemberReq struct {
	GroupNo   string
	MemberUID string
}

type CategoryRow struct {
	CategoryID string `db:"category_id"`
	UID        string `db:"uid"`
	SpaceID    string `db:"space_id"`
	Status     int    `db:"status"`
}

type CreateGroupServiceReq struct {
	Creator     string   // 创建者 UID
	Members     []string // 成员 UID 列表（不含创建者，Service 内部会自动加入）
	Name        string   // 群名称（可为空，Service 会自动生成）
	SpaceID     string   // Space ID（可为空）
	BotUID      string   // Bot UID（可为空；非空时自动加入群并设为 bot_admin）
	CategoryID  string   // 群聊分组 ID（可为空；非空时自动设置创建者的 group_setting）
	AvatarText  string   // 自定义群头像文字（可为空；空=按 is_named 回退：老群渲染群名/新群双人图标）
	AvatarColor *int     // 自定义群头像色板下标（nil=渲染时按 group_no 派生）
}

type CreateGroupServiceResp struct {
	GroupNo        string   // 群编号
	Name           string   // 群名称
	SkippedMembers []string // 因不在 Space 而被过滤的成员 UID
}

type DB struct {
	// contains filtered or unexported fields
}

type DetailModel struct {
	Model
	Mute            int    // 免打扰
	Top             int    // 置顶
	ShowNick        int    // 显示昵称
	Save            int    // 是否保存
	ChatPwdOn       int    //是否开启聊天密码
	RevokeRemind    int    //撤回提醒
	JoinGroupRemind int    // 进群提醒
	Screenshot      int    //截屏通知
	Receipt         int    //消息是否回执
	Flame           int    // 是否开启阅后即焚
	FlameSecond     int    // 阅后即焚秒数
	Remark          string // 群备注
}

type Group struct {
	log.Log
	// contains filtered or unexported fields
}

type GroupMdResult struct {
	Content   string     `json:"content"`
	Version   int64      `json:"version"`
	UpdatedAt *time.Time `json:"updated_at"`
	UpdatedBy string     `json:"updated_by"`
}

type GroupResp struct {
	GroupNo                  string    `json:"group_no"`                    // 群编号
	GroupType                GroupType `json:"group_type"`                  // 群类型
	Category                 string    `json:"category"`                    // 群分类
	Name                     string    `json:"name"`                        // 群名称
	IsNamed                  int       `json:"is_named"`                    // 1=改版前老群(默认渲染群名文字)/0=新群(默认双人图标)；由 #500 迁移回填，新群恒为 0；客户端可据此本地预判默认头像取群名文字 vs 双人图标
	AvatarText               string    `json:"avatar_text"`                 // 自定义群头像文字（空=按 is_named 回退：老群渲染群名/新群双人图标）
	AvatarColor              *int      `json:"avatar_color"`                // 自定义群头像色板下标（null=按 group_no 派生）
	Remark                   string    `json:"remark"`                      // 群备注
	Notice                   string    `json:"notice"`                      // 群公告
	Mute                     int       `json:"mute"`                        // 免打扰
	Top                      int       `json:"top"`                         // 置顶
	ShowNick                 int       `json:"show_nick"`                   // 显示昵称
	Save                     int       `json:"save"`                        // 是否保存
	Forbidden                int       `json:"forbidden"`                   // 是否全员禁言
	Invite                   int       `json:"invite"`                      // 群聊邀请确认
	ChatPwdOn                int       `json:"chat_pwd_on"`                 //是否开启聊天密码
	Screenshot               int       `json:"screenshot"`                  //截屏通知
	RevokeRemind             int       `json:"revoke_remind"`               //撤回提醒
	JoinGroupRemind          int       `json:"join_group_remind"`           //进群提醒
	ForbiddenAddFriend       int       `json:"forbidden_add_friend"`        //群内禁止加好友
	Status                   int       `json:"status"`                      //群状态
	Receipt                  int       `json:"receipt"`                     //消息是否回执
	Flame                    int       `json:"flame"`                       // 阅后即焚
	FlameSecond              int       `json:"flame_second"`                // 阅后即焚秒数
	AllowViewHistoryMsg      int       `json:"allow_view_history_msg"`      // 是否允许新成员查看历史消息
	MemberCount              int       `json:"member_count"`                // 成员数量
	OnlineCount              int       `json:"online_count"`                // 在线数量
	Quit                     int       `json:"quit"`                        // 我是否已退出群聊
	Role                     int       `json:"role"`                        // 我在群聊里的角色
	ForbiddenExpirTime       int64     `json:"forbidden_expir_time"`        // 我在此群的禁言过期时间
	AllowMemberPinnedMessage int       `json:"allow_member_pinned_message"` //是否允许群成员置顶消息
	HasGroupMd               bool      `json:"has_group_md"`                // 是否有GROUP.md
	GroupMdVersion           int64     `json:"group_md_version"`            // GROUP.md版本
	GroupMdUpdatedAt         *string   `json:"group_md_updated_at"`         // GROUP.md最后更新时间
	CanEditGroupMd           bool      `json:"can_edit_group_md"`           // 是否可编辑GROUP.md
	CanManageBotAdmin        bool      `json:"can_manage_bot_admin"`        // 是否可管理Bot管理员
	SpaceID                  string    `json:"space_id"`                    // Space ID
	IsExternalGroup          int       `json:"is_external_group"`           // 是否外部群 0.否 1.是
	AllowExternal            int       `json:"allow_external"`              // 是否允许外部成员 1.允许(默认) 0.禁止
	AllowNoMention           int       `json:"allow_no_mention"`            // 群级是否允许免@生效 1.允许(默认) 0.禁止
	CreatedAt                string    `json:"created_at"`
	UpdatedAt                string    `json:"updated_at"`
	Version                  int64     `json:"version"` // 群数据版本
}

type GroupType int

type IService interface {
	// 获取群总数
	GetAllGroupCount() (int64, error)
	// 查询某天的新建群数量
	GetCreatedCountWithDate(date string) (int64, error)
	// 添加一个群
	AddGroup(model *AddGroupReq) error
	// 某个时间段的建群数据
	GetGroupWithDateSpace(startDate, endDate string) (map[string]int64, error)
	// 查询某个群信息
	GetGroupWithGroupNo(groupNo string) (*InfoResp, error)
	// GetGroups 获取群集合
	GetGroups(groupNos []string) ([]*InfoResp, error)
	// 获取某一批群与指定用户的详情（包括用户对群的设置等等）
	GetGroupDetails(groupNos []string, uid string) ([]*GroupResp, error)
	// 获取群详情
	GetGroupDetail(groupNo string, uid string) (*GroupResp, error)

	// -------------------- 群设置 --------------------
	// GetSettings 获取群的设置
	GetSettings(groupNos []string, uid string) ([]*SettingResp, error)
	// GetSettingsWithUids 获取一批用户对某个群的设置
	GetSettingsWithUIDs(groupNo string, uids []string) ([]*SettingResp, error)

	// -------------------- 群成员 --------------------
	// 获取指定群的群成员列表
	GetMembers(groupNo string) ([]*MemberResp, error)
	// GetMemberExternalMarkers 批量获取指定群所有非删除成员的外部来源标识。
	// 返回 uid -> MemberExternalMarker 的映射，供消息同步等热路径 O(1) 查找，避免 N+1 JOIN。
	GetMemberExternalMarkers(groupNo string) (map[string]MemberExternalMarker, error)
	// GetMemberExternalFields 单成员版外部来源 / 归属 Space 字段查询（YUJ-206），
	// 供 /users/{uid}?group_no= 路径补齐 GroupMemberResp 的 is_external / source_space_* /
	// home_space_* 字段。语义与 GetMemberExternalMarkers 保持一致。
	GetMemberExternalFields(groupNo, uid string) (
		isExternal int,
		sourceSpaceID, sourceSpaceName string,
		homeSpaceID, homeSpaceName string,
		err error,
	)
	// 获取指定群的指定成员信息
	GetMember(groupNo, uid string) (*MemberResp, error)
	// 获取黑名单成员uid集合
	GetBlacklistMemberUIDs(groupNo string) ([]string, error)
	// GetSubscribableMemberUIDs 返回可订阅成员 uid 集合（status=normal AND is_deleted=0，
	// 即排除被拉黑成员），供子区/父群的 IM Subscribers 数据源使用。与 GetMembers
	// （“所有非删除成员”）语义不同，不可互换。
	GetSubscribableMemberUIDs(groupNo string) ([]string, error)
	// 查询管理员成员uid列表（包括创建者）
	GetMemberUIDsOfManager(groupNo string) ([]string, error)
	// 是否是创建者或管理者
	IsCreatorOrManager(groupNo string, uid string) (bool, error)
	// 获取成员总数量和在线数量
	// 第一个返回参数为成员总数量
	// 第二个返回参数为在线数量
	GetMemberTotalAndOnlineCount(groupNo string) (int, int, error)
	// 是否存在群成员
	ExistMember(groupNo string, uid string) (bool, error)
	// ExistMemberActive 是否存在「活跃」群成员（is_deleted=0 AND status=Normal，
	// 白名单语义、fail-closed），排除被拉黑成员。供绕过 IM 直查本地分表的读/发门禁，
	// 以及子区(CommunityTopic)解析父群后的读/写门禁使用，防止被拉黑用户越权读子区内容。
	ExistMemberActive(groupNo string, uid string) (bool, error)
	// 成员是否在某群里存在 返回对应在群里的群编号
	ExistMembers(groupNos []string, uid string) ([]string, error)
	// ExistMembersActive 批量版 ExistMemberActive：返回 uid 处于「活跃」状态
	// （is_deleted=0 AND status=Normal）的群编号集合，排除被拉黑成员
	ExistMembersActive(groupNos []string, uid string) ([]string, error)
	// GetGroupsWithMemberUID 获取某个用户的所有群
	GetGroupsWithMemberUID(uid string) ([]*InfoResp, error)
	// 获取指定群的群成员的最大数据版本
	GetGroupMemberMaxVersion(groupNo string) (int64, error)
	// 获取用户所有超级群信息
	GetUserSupers(uid string) ([]*InfoResp, error)
	// 新增群成员
	AddMember(model *AddMemberReq) error
	// 获取指定一批群的指定成员信息
	GetMembersWithUIDAndGroupIds(uid string, groupNos []string) ([]*MemberResp, error)
	// 查询一批群的管理员及群主
	GetManagersWithGroupNos(groupNos []string) ([]*MemberResp, error)
	// GetGroupMd returns GROUP.md content for a group
	GetGroupMd(groupNo string) (*GroupMdResult, error)
	// UpdateGroupMd updates GROUP.md content
	UpdateGroupMd(groupNo string, content string, updatedBy string) (int64, error)
	// DeleteGroupMd deletes GROUP.md content
	DeleteGroupMd(groupNo string) (int64, error)
	// IsBotAdmin checks if a member is a bot admin
	IsBotAdmin(groupNo string, uid string) (bool, error)
	// GetBotMemberUIDs returns UIDs of robot members in the group
	GetBotMemberUIDs(groupNo string) ([]string, error)

	// CreateGroup 创建群（统一入口，Web 和 Bot 共用）
	CreateGroup(req *CreateGroupServiceReq) (*CreateGroupServiceResp, error)
	// AddGroupMembers 添加群成员
	AddGroupMembers(req *AddGroupMembersServiceReq) (*AddGroupMembersServiceResp, error)
	// RemoveGroupMembers 移除群成员
	RemoveGroupMembers(req *RemoveGroupMembersServiceReq) (*RemoveGroupMembersServiceResp, error)
	// RemoveUserFromGroupThreads 清理某用户在某群所有子区的 thread_member 记录、IM 订阅和置顶。
	// 供 botfather 删除 Bot 等“父群成员已移除、需对齐摘除子区订阅”的外部路径调用（Issue #27）。
	RemoveUserFromGroupThreads(groupNo, uid, spaceID string)
	// UpdateGroupInfo 更新群信息
	UpdateGroupInfo(req *UpdateGroupInfoServiceReq) error
	// UpdateGroupAvatarCustom 更新自定义群头像文字/颜色
	UpdateGroupAvatarCustom(req *UpdateGroupAvatarCustomServiceReq) error
}

type InfoResp struct {
	GroupNo             string    `json:"group_no"`               // 群编号
	GroupType           GroupType `json:"group_type"`             // 群类型
	Name                string    `json:"name"`                   // 群名称
	Notice              string    `json:"notice"`                 // 群公告
	Creator             string    `json:"creator"`                // 创建者uid
	Status              int       `json:"status"`                 // 群状态
	Forbidden           int       `json:"forbidden"`              // 是否全员禁言
	Invite              int       `json:"invite"`                 // 是否开启邀请确认 0.否 1.是
	ForbiddenAddFriend  int       `json:"forbidden_add_friend"`   //群内禁止加好友
	AllowViewHistoryMsg int       `json:"allow_view_history_msg"` // 是否允许新成员查看历史记录
	CreatedAt           string    `json:"created_at"`
	UpdatedAt           string    `json:"updated_at"`
	Version             int64     `json:"version"`           // 群数据版本
	SpaceID             string    `json:"space_id"`          // Space ID
	IsExternalGroup     int       `json:"is_external_group"` // 是否外部群
	AllowExternal       int       `json:"allow_external"`    // 是否允许外部成员 1.允许(默认) 0.禁止
	AllowNoMention      int       `json:"allow_no_mention"`  // 群级是否允许免@生效 1.允许(默认) 0.禁止
}

type InviteDetailModel struct {
	InviteModel
	InviterName string `json:"inviter_name"` // 邀请者名称

}

type InviteDetailResp struct {
	InviteNo    string                 `json:"invite_no"`    // 邀请唯一编号
	GroupNo     string                 `json:"group_no"`     // 群唯一编号
	Inviter     string                 `json:"inviter"`      // 邀请者
	Remark      string                 `json:"remark"`       // 邀请备注
	InviterName string                 `json:"inviter_name"` // 邀请者名称
	Status      int                    `json:"status"`       // 状态 0.未确认 1.已确认
	Items       []InviteItemDetailResp `json:"items"`        // 邀请项详情
	// YUJ-168 / GH #1243: 外部群 H5 邀请 landing 的信任锚点字段。
	// SpaceName 始终下发（前端判断非空才渲染"来自 xx"），
	// IsExternal 仅在当前登录用户不属于该 Space 时置 1。
	SpaceName  string `json:"space_name"`  // 群所属 Space 名称（空字符串表示无 Space）
	IsExternal int    `json:"is_external"` // 访问者视角：0=内部/未登录，1=跨 Space 外部访问者
}

type InviteItemDetailModel struct {
	InviteItemModel
	Name string // 被邀请者名称
}

type InviteItemDetailResp struct {
	UID  string `json:"uid"`  // 被邀请uid
	Name string `json:"name"` // 被邀请者名称
}

type InviteItemModel struct {
	InviteNo string `json:"invite_no"` // 邀请唯一编号
	GroupNo  string `json:"group_no"`  // 群唯一编号
	Inviter  string `json:"inviter"`   // 邀请者
	UID      string `json:"uid"`       // 被邀请uid
	Status   int    `json:"status"`    // 状态 0.未确认 1.已确认
	db.BaseModel
}

type InviteModel struct {
	InviteNo string `json:"invite_no"` // 邀请唯一编号
	GroupNo  string `json:"group_no"`  // 群唯一编号
	Inviter  string `json:"inviter"`   // 邀请者
	Remark   string `json:"remark"`    // 邀请备注
	Status   int    `json:"status"`    // 状态 0.未确认 1.已确认
	Allower  string `json:"allower"`   // 确认者
	db.BaseModel
}

type InviteReq struct {
	UIDS   []string `json:"uids"`
	Remark string   `json:"remark"`
}

type Manager struct {
	log.Log
	// contains filtered or unexported fields
}

type MemberDetailModel struct {
	UID                string // 成员uid
	GroupNo            string // 群编号
	Name               string // 群成员名称
	Remark             string // 成员备注
	Role               int    // 成员角色
	Version            int64
	Vercode            string //验证码
	InviteUID          string // 邀请人
	IsDeleted          int    // 是否删除
	Status             int    // 1.正常 2.黑名单
	Username           string
	Robot              int    // 机器人标识0.否1.是
	ForbiddenExpirTime int64  // 禁言时长
	BotAdmin           int    // Bot管理员 0.否 1.是
	IsExternal         int    // 外部成员 0.否 1.是
	SourceSpaceID      string // 来源 Space ID（外部成员使用）
	db.BaseModel
}

type MemberExternalMarker struct {
	IsExternal      int    // 1 = 外部成员
	SourceSpaceName string // 来源 Space 名称；非外部成员或无来源时为空
	// HomeSpaceID / HomeSpaceName 是为了前端"相对当前查看 Space"渲染外部徽标
	// 而新增的视图字段（YUJ-63 / #1208）。后端 IsExternal / SourceSpace* 语义不变。
	// 规则：外部成员 → home = source space；内部成员 → home = 群自身 space。
	HomeSpaceID   string
	HomeSpaceName string
}

type MemberGroupDetailModel struct {
	GroupName string // 群名称
	MemberModel
}

type MemberModel struct {
	GroupNo            string // 群编号
	UID                string // 成员uid
	Remark             string // 成员备注
	Role               int    // 成员角色 1. 创建者	 2.管理员
	Version            int64
	Status             int    // 1.正常 2.黑名单
	Vercode            string //验证码
	IsDeleted          int    // 是否删除
	InviteUID          string // 邀请者
	Robot              int    // 机器人
	ForbiddenExpirTime int64  // 禁言时长
	IsExternal         int    // 外部成员 0.否 1.是
	SourceSpaceID      string // 来源 Space ID（外部成员使用）
	db.BaseModel
}

type MemberResp struct {
	GroupNo            string // 群编号
	UID                string // 成员uid
	Name               string // 群成员名称
	Remark             string // 成员备注
	Role               int    // 成员角色
	Version            int64
	Vercode            string //验证码
	InviteUID          string // 邀请人uid
	CreatedAt          int64  // 注册时间 10位时间戳
	IsDeleted          int    //是否已删除
	ForbiddenExpirTime int64  // 禁言时长
	Status             int    // 成员状态
}

type Model struct {
	GroupNo                  string     // 群编号
	GroupType                int        // 群类型 0.普通群 1.超大群
	Name                     string     // 群名称
	IsNamed                  int        // 1=改版前老群/0=新群；由 #500 迁移回填，新群恒为 0。默认头像取群名文字仅对 1 生效（grandfather 老群），新群一律双人图标
	Avatar                   string     // 群头像
	AvatarVersion            int64      // 群头像对象版本，0 表示旧版稳定路径
	IsUploadAvatar           int        // 群头像是否已经被用户上传
	AvatarText               string     // 自定义群头像文字；空时按 is_named 回退（老群取群名前2字，新群双人图标）
	AvatarColor              *int       // 自定义群头像色板下标，nil(NULL) 表示按 group_no 派生
	Notice                   string     // 群公告
	Creator                  string     // 创建者uid
	Status                   int        // 群状态
	Version                  int64      // 版本号
	Forbidden                int        // 是否全员禁言
	Invite                   int        // 是否开启邀请确认 0.否 1.是
	ForbiddenAddFriend       int        //群内禁止加好友
	AllowViewHistoryMsg      int        // 是否允许新成员查看历史消息
	AllowMemberPinnedMessage int        // 是否允许群成员置顶消息
	Category                 string     // 群分类
	SpaceID                  string     // Space ID
	IsExternalGroup          int        // 外部群 0.否 1.是（自动维护）
	AllowExternal            int        // 是否允许外部成员加入 1.允许(默认) 0.禁止
	AllowNoMention           int        // 群级是否允许免@生效 1.允许(默认) 0.禁止（bot 在本群必须被@）
	GroupMd                  *string    // GROUP.md content
	GroupMdVersion           int64      // GROUP.md version
	GroupMdUpdatedAt         *time.Time // GROUP.md last update time
	GroupMdUpdatedBy         string     // GROUP.md last updater UID
	db.BaseModel
}

type MsgGroupMemberScanJoinExt struct {
	config.MsgGroupMemberScanJoin
	IsExternal int `json:"is_external"`
}

type RemoveGroupMembersServiceReq struct {
	GroupNo      string   // 群编号
	Members      []string // 待移除成员 UID 列表
	OperatorUID  string   // 操作者 UID
	OperatorName string   // 操作者名称
}

type RemoveGroupMembersServiceResp struct {
	Removed     int      // 实际移除数量
	RemovedUIDs []string // 实际移除的 UID 列表
}

type Service struct {
	log.Log
	// contains filtered or unexported fields
}

type Setting struct {
	UID             string // 用户uid
	GroupNo         string // 群编号
	Mute            int    // 免打扰
	Top             int    // 置顶
	ShowNick        int    // 显示昵称
	Save            int    // 是否保存
	ChatPwdOn       int    //是否开启聊天密码
	Screenshot      int    //截屏通知
	RevokeRemind    int    //撤回通知
	JoinGroupRemind int    //进群提醒
	Receipt         int    //消息是否回执
	Flame           int    // 是否开启阅后即焚
	FlameSecond     int    // 阅后即焚秒数
	Remark          string // 群备注
	Version         int64  // 版本
	db.BaseModel
}

type SettingResp struct {
	UID             string
	GroupNo         string // 群编号
	Mute            int    // 免打扰
	Top             int    // 置顶
	ShowNick        int    // 显示昵称
	Save            int    // 是否保存
	ChatPwdOn       int    //是否开启聊天密码
	Screenshot      int    //截屏通知
	RevokeRemind    int    //撤回通知
	JoinGroupRemind int    //进群提醒
	Receipt         int    //消息是否回执
	Remark          string // 群备注
	Version         int64  // 版本
}

type UpdateGroupAvatarCustomServiceReq struct {
	GroupNo      string
	OperatorUID  string
	OperatorName string
	// AvatarText：nil 表示不更新文字；非 nil（含 ""）表示设置，"" 即清除自定义文字（回退 is_named 规则:老群群名/新群双人图标）。
	AvatarText *string
	// SetAvatarColor：是否更新颜色。为 true 时按 AvatarColor 设置：nil 清除（NULL，回退派生），
	// 非 nil 为色板下标。为 false 时不动颜色。
	SetAvatarColor bool
	AvatarColor    *int
}

type UpdateGroupInfoServiceReq struct {
	GroupNo      string  // 群编号
	OperatorUID  string  // 操作者 UID
	OperatorName string  // 操作者名称
	Name         *string // 新群名（nil 表示不更新）
	Notice       *string // 新公告（nil 表示不更新）
}