Merge remote-tracking branch 'upstream/main' into merge-gramsrv-0e2fcdf9

internal/domain/user.go

@@ -105,10 +105,21 @@ type User struct {
 	Username    string
 	CountryCode string
 	Verified    bool
+	Scam        bool
+	Fake        bool
 	Support     bool
 	Contact     bool
 	Mutual      bool
 	CloseFriend bool
+	// RestrictionReasons are transient, viewer-scoped unavailability reasons.
+	// They are produced after loading the viewer-independent base user and must
+	// never be persisted in users or the base-user cache.
+	RestrictionReasons []UserRestrictionReason
+	// ContactNote/ContactNoteEntities are transient viewer-scoped contact
+	// projection fields. They must never be persisted into users or a
+	// viewer-independent base-user cache.
+	ContactNote         string
+	ContactNoteEntities []MessageEntity
 	// Bot 标识 bot 账号；置位时 BotInfoVersion 必须 ≥1（TDesktop 只认
 	// user TL 是否携带 bot_info_version 字段，且与 bot flag 共用 bit14）。
 	Bot            bool
@@ -153,6 +164,23 @@ type User struct {
 	AccountDeleteAt time.Time
 }
 
+// UserRestrictionReason is the protocol-neutral form of Telegram's
+// restrictionReason. Platform "all" applies to TDesktop and official mobile
+// clients; Text is intentionally server supplied and directly user-visible.
+type UserRestrictionReason struct {
+	Platform string
+	Reason   string
+	Text     string
+}
+
+func AccountFrozenRestrictionReasons() []UserRestrictionReason {
+	return []UserRestrictionReason{{
+		Platform: "all",
+		Reason:   "frozen",
+		Text:     "This account is frozen.",
+	}}
+}
+
 // PremiumActiveAt 报告用户在 now（Unix 秒）时刻是否为有效会员。
 // bot 永不为会员（官方语义；授予路径同样排除 bot，这里是双保险）。
 func (u User) PremiumActiveAt(now int64) bool {