package domain // UserIDSequenceBase 是普通用户 ID 的起始值。 // // 取 2026-06-01 00:00:00 Asia/Shanghai 的 Unix 秒级时间戳。 // 777000 等兼容系统账号低于该区间,业务注册用户从这里开始递增。 const UserIDSequenceBase int64 = 1780243200 // PeerColor is a domain-only representation of Telegram peerColor. // HasColor preserves explicit color=0, which is distinct from "color unset". type PeerColor struct { HasColor bool Color int BackgroundEmojiID int64 } // Empty reports whether no explicit color/profile color state is set. func (c PeerColor) Empty() bool { return !c.HasColor && c.BackgroundEmojiID == 0 } // User 是一个账号。第一阶段仅保留登录链路必须字段; // access_hash 为任何 InputUser 校验所必须,不可省。 type User struct { ID int64 AccessHash int64 Phone string // SignupEmail is set only for email-signup accounts (see // domain.NewEmailSignupDisplayPhone): it is the durable email->user // reverse lookup key, since Phone itself no longer encodes the email. // Empty for every ordinary phone-number account. SignupEmail string FirstName string LastName string About string Username string CountryCode string Verified bool Support bool Contact bool Mutual bool CloseFriend bool // Bot 标识 bot 账号;置位时 BotInfoVersion 必须 ≥1(TDesktop 只认 // user TL 是否携带 bot_info_version 字段,且与 bot flag 共用 bit14)。 Bot bool BotInfoVersion int // PremiumUntil 是会员到期 Unix 秒;0 表示非会员。premium 状态的唯一权威 // 来源是该字段,由读取路径经 PremiumActiveAt 即时派生——到期后无需等 // 后台 sweeper 翻转即停止下发 premium(sweeper 只负责清理与通知推送)。 PremiumUntil int // EmojiStatusDocumentID / EmojiStatusUntil 是用户自定义 emoji status //(premium 专属,account.updateEmojiStatus)。DocumentID==0 表示未设置; // Until==0 表示永久。 EmojiStatusDocumentID int64 EmojiStatusUntil int // Birthday 是用户公开生日(account.updateBirthday)。零值表示未设置。 Birthday Birthday // PersonalChannelID 是资料页展示的「个人频道」(account.updatePersonalChannel); // 0 表示未设置。资料投影时按它取频道对象与最新一帖。 PersonalChannelID int64 Color PeerColor ProfileColor PeerColor // Profile photo fields are filled by app-layer user projection. PhotoID==0 表示无头像。 PhotoID int64 PhotoDCID int PhotoStripped []byte PhotoPersonal bool PhotoHasVideo bool LastSeenAt int Status UserStatus } // PremiumActiveAt 报告用户在 now(Unix 秒)时刻是否为有效会员。 // bot 永不为会员(官方语义;授予路径同样排除 bot,这里是双保险)。 func (u User) PremiumActiveAt(now int64) bool { return !u.Bot && u.PremiumUntil > 0 && int64(u.PremiumUntil) > now } // EmojiStatusActiveAt 报告用户在 now(Unix 秒)时刻是否有生效的 emoji status // (已设置且未过期;Until==0 表示永久)。emoji status 是 premium 专属,到期 // 降级后即便列仍有残值也不再下发。 func (u User) EmojiStatusActiveAt(now int64) bool { if !u.PremiumActiveAt(now) || u.EmojiStatusDocumentID == 0 { return false } return u.EmojiStatusUntil == 0 || int64(u.EmojiStatusUntil) > now } // UserStatusKind is a protocol-neutral account presence state. type UserStatusKind int const ( UserStatusUnknown UserStatusKind = iota UserStatusOnline UserStatusOffline UserStatusRecently UserStatusLastWeek UserStatusLastMonth UserStatusEmpty ) // UserStatus describes the currently visible presence state for a user. // // Expires and WasOnline are absolute Unix timestamps in seconds, matching // Telegram's UserStatus semantics without leaking tg.* into domain. type UserStatus struct { Kind UserStatusKind Expires int WasOnline int } // Birthday 是用户公开生日。Day/Month 为 0 表示未设置;Year 为 0 表示只填了月日不含年份。 type Birthday struct { Day int Month int Year int } // IsSet 报告生日是否已设置(必须有合法月日)。 func (b Birthday) IsSet() bool { return b.Day != 0 && b.Month != 0 } // ValidBirthday 校验月/日(年份可选)是否在合法范围内。清除生日传零值即可(IsSet 为 false)。 func ValidBirthday(b Birthday) bool { if b.Month < 1 || b.Month > 12 || b.Day < 1 || b.Day > 31 { return false } if b.Year != 0 && (b.Year < 1900 || b.Year > 2100) { return false } return true } // UserProfileUpdate 描述 account.updateProfile 的可选字段更新。 type UserProfileUpdate struct { FirstName string HasFirstName bool LastName string HasLastName bool About string HasAbout bool } // UserFullView is the app-layer personalized full user view consumed by RPC. type UserFullView struct { User User ProfilePhoto *Photo PersonalPhoto *Photo FallbackPhoto *Photo About string PhoneCallsAvailable bool PhoneCallsPrivate bool VideoCallsAvailable bool VoiceMessagesForbidden bool ReadDatesPrivate bool }