MeBox/internal/model/user.go

package model

import (
	"encoding/json"
	"strings"
	"time"
)

// User 是本地账户。第一个注册的管理员（或种子管理员）获得 "admin" 角色；
// 其他所有用户默认为 "user"。
type User struct {
	Base
	Username           string     `gorm:"uniqueIndex;size:64;not null" json:"username"`
	PasswordHash       string     `gorm:"size:128;not null" json:"-"`
	Role               string     `gorm:"size:16;not null;default:user" json:"role"`
	Tier               string     `gorm:"size:16;default:free" json:"tier"` // free / plus
	Nickname           string     `gorm:"size:128" json:"nickname,omitempty"`
	Email              string     `gorm:"size:128" json:"email,omitempty"`
	AvatarURL          string     `gorm:"size:255" json:"avatar_url,omitempty"`
	HideAdult          bool       `gorm:"default:true" json:"hide_adult"`
	ForcePasswordReset bool       `gorm:"default:false" json:"force_password_reset"`
	IsActive           bool       `gorm:"default:true" json:"is_active"`
	LastLoginAt        *time.Time `json:"last_login_at,omitempty"`
	// AllowedLibraryIDs 存储管理员为该用户指定的受限可访问媒体库 ID 列表（JSON 字符串）。
	// 为空时代表不限制（全库可访问）。
	AllowedLibraryIDs  string   `gorm:"type:text" json:"-"`
	AllowedLibraryList []string `gorm:"-" json:"allowed_library_ids,omitempty"`
	// PinnedLibraryIDs 存储用户置顶的媒体库 ID 列表（JSON 字符串），顺序即置顶优先级。
	PinnedLibraryIDs  string   `gorm:"type:text" json:"-"`
	PinnedLibraryList []string `gorm:"-" json:"pinned_library_ids,omitempty"`
	// LibraryTags 存储用户自定义的媒体库标签分组（JSON 字符串），
	// 形如 [{"name":"动画","library_ids":["lib-1","lib-2"]}]。标签属于用户本人，
	// 用于在媒体库页把同一标签下的媒体库聚合到一起。
	LibraryTags    string          `gorm:"type:text" json:"-"`
	LibraryTagList []LibraryTagSet `gorm:"-" json:"library_tags,omitempty"`
	// SubtitleChineseMode 是网页播放器外挂字幕的简繁转换偏好：
	// original / simplified / traditional。
	SubtitleChineseMode string `gorm:"size:16;not null;default:original" json:"subtitle_chinese_mode"`
	// 网页播放器偏好按用户存储，切换媒体对象后继续沿用。
	// 播放倍速不在此列：它只作用于当前视频，不进数据库。
	PlayerVolume float64 `gorm:"not null;default:1" json:"player_volume"`
	// PlayerVr360GuideSeen 记录用户是否已经看过 VR 全景播放的首次操作说明，
	// 按用户保存：看过一次之后不再弹出。
	PlayerVr360GuideSeen bool    `gorm:"not null;default:false" json:"player_vr360_guide_seen"`
	DanmakuEnabled       bool    `gorm:"not null;default:true" json:"danmaku_enabled"`
	DanmakuOpacity       float64 `gorm:"not null;default:1" json:"danmaku_opacity"`
	DanmakuFontSize      int     `gorm:"not null;default:24" json:"danmaku_font_size"`
	DanmakuArea          float64 `gorm:"not null;default:1" json:"danmaku_area"`
	DanmakuMergeSources  bool    `gorm:"not null;default:false" json:"danmaku_merge_sources"`
	DanmakuSource        string  `gorm:"size:512" json:"danmaku_source,omitempty"`
	DanmakuAppID         string  `gorm:"size:128" json:"danmaku_app_id,omitempty"`
	// DanmakuAppKey 只在服务端读取并用于请求签名，绝不通过用户资料接口下发。
	DanmakuAppKey string `gorm:"size:256" json:"-"`
	// ExpiredAt is the account expiry time. Nil means the account never
	// expires. When set and in the past, the account is treated as expired
	// (login blocked) until an admin or a redemption code renews it.
	ExpiredAt *time.Time `json:"expired_at,omitempty"`
	// TelegramChatID 是用户绑定的 Telegram 会话 ID，用于接收账号与设备通知。
	// 为空表示未绑定；绑定走个人资料页生成的一次性码 + Bot /bind 命令。
	TelegramChatID string `gorm:"size:64" json:"telegram_chat_id,omitempty"`
	// ShareWarnings counts anti-account-sharing warnings, mainly device
	// fingerprint mismatches. Once it exceeds the configured threshold a
	// re-offence disables the account until an admin re-enables it.
	ShareWarnings       int        `gorm:"default:0" json:"share_warnings"`
	LastShareWarnAt     *time.Time `json:"last_share_warn_at,omitempty"`
	IsDefaultAdmin      bool       `gorm:"-" json:"is_default_admin,omitempty"`
	IsProtected         bool       `gorm:"-" json:"is_protected,omitempty"`
	RealtimeOnline      bool       `gorm:"-" json:"realtime_online,omitempty"`
	RealtimeDeviceCount int        `gorm:"-" json:"realtime_device_count,omitempty"`
}

// DecodeAllowedLibraryIDs 解析 AllowedLibraryIDs 字段。
func (u *User) DecodeAllowedLibraryIDs() []string {
	if u == nil || strings.TrimSpace(u.AllowedLibraryIDs) == "" {
		return nil
	}
	var ids []string
	if err := json.Unmarshal([]byte(u.AllowedLibraryIDs), &ids); err != nil {
		return nil
	}
	var out []string
	for _, id := range ids {
		trimmed := strings.TrimSpace(id)
		if trimmed != "" {
			out = append(out, trimmed)
		}
	}
	return out
}

// DecodePinnedLibraryIDs 解析 PinnedLibraryIDs 字段。
func (u *User) DecodePinnedLibraryIDs() []string {
	if u == nil || strings.TrimSpace(u.PinnedLibraryIDs) == "" {
		return nil
	}
	var ids []string
	if err := json.Unmarshal([]byte(u.PinnedLibraryIDs), &ids); err != nil {
		return nil
	}
	var out []string
	for _, id := range ids {
		trimmed := strings.TrimSpace(id)
		if trimmed != "" {
			out = append(out, trimmed)
		}
	}
	return out
}

// PopulateComputedFields 填充非 DB 虚拟计算字段（如 AllowedLibraryList）。
func (u *User) PopulateComputedFields() {
	if u == nil {
		return
	}
	u.AllowedLibraryList = u.DecodeAllowedLibraryIDs()
	u.PinnedLibraryList = u.DecodePinnedLibraryIDs()
	u.LibraryTagList = u.DecodeLibraryTags()
}