model

type AdminOperationLog struct {
	gorm.Model
	Action    string `gorm:"size:100;index" json:"action"`
	Target    string `gorm:"size:255" json:"target"`
	Success   bool   `json:"success"`
	Message   string `gorm:"type:text" json:"message"`
	ActorID   *uint  `gorm:"index" json:"actor_id"`
	ActorName string `gorm:"size:100" json:"actor_name"`
	IP        string `gorm:"size:45" json:"ip"`
	LatencyMs int64  `json:"latency_ms"`
}

type AdminOperationLogQuery struct {
	Action   string
	Actor    string
	Success  *bool
	Page     int
	PageSize int
}

type ChunkQuery struct {
	UploadID   string `json:"upload_id"`
	ChunkIndex *int   `json:"chunk_index"`
	Status     string `json:"status"`
	Completed  *bool  `json:"completed"`
	Limit      int    `json:"limit"`
	Offset     int    `json:"offset"`
}

type ChunkStats struct {
	gorm.Model
	TotalChunks     int64 `json:"total_chunks"`
	CompletedChunks int64 `json:"completed_chunks"`
	PendingChunks   int64 `json:"pending_chunks"`
	FailedChunks    int64 `json:"failed_chunks"`
}

type ChunkUpdate struct {
	gorm.Model
	ChunkHash  *string    `json:"chunk_hash"`
	Completed  *bool      `json:"completed"`
	RetryCount *int       `json:"retry_count"`
	LastError  *string    `json:"last_error"`
	Status     *string    `json:"status"`
	UpdatedAt  *time.Time `json:"updated_at"`
}

type FileCode struct {
	gorm.Model
	Code         string `gorm:"uniqueIndex;size:255" json:"code"`
	UUIDFileName string `gorm:"size:255" json:"uuid_file_name"`
	FilePath     string `gorm:"size:255" json:"file_path"`
	Size         int64  `gorm:"default:0" json:"size"`
	Text         string `gorm:"type:text" json:"text"`
	// Note 文件备注（可空）：随分享展示给取件人（2026-10-12，文件+文本一并投递）
	Note         string     `gorm:"type:text" json:"note"`
	ExpiredAt    *time.Time `gorm:"index:idx_file_codes_status_expired,priority:2" json:"expired_at"`
	ExpiredCount int        `gorm:"default:0" json:"expired_count"` // 剩余可取次数：-1=无限, 0=已耗尽, >0=剩余
	UsedCount    int        `gorm:"default:0" json:"used_count"`
	// Status 管控状态，默认 normal；blocked/pending_review 拒绝取件（索引覆盖管理端按状态筛选）
	Status string `gorm:"size:20;default:'normal';index:idx_file_codes_status_expired,priority:1" json:"status"`

	FileHash  string `gorm:"size:64" json:"file_hash"`
	IsChunked bool   `gorm:"default:false" json:"is_chunked"`
	UploadID  string `gorm:"size:36" json:"upload_id"`

	// 新增：用户认证相关字段
	UserID       *uint  `gorm:"index" json:"user_id"`                           // 上传用户ID，为null表示匿名上传
	UploadType   string `gorm:"size:20;default:'anonymous'" json:"upload_type"` // anonymous, authenticated
	RequireAuth  bool   `gorm:"default:false" json:"require_auth"`              // 是否需要密码才能下载
	PasswordHash string `gorm:"size:255" json:"-"`                              // 取件密码的 bcrypt 哈希（json:"-" 不外泄）
	OwnerIP      string `gorm:"size:45" json:"owner_ip"`                        // 上传者IP地址
	// Encrypted 端到端客户端加密（P1 E2E）：true 时存储的是密文，密钥经分享链接
	// #fragment 传递、从不落服务端；服务端零知识（预览/服务端 zip 打包不适用）
	Encrypted bool `gorm:"default:false" json:"encrypted"`

	// 取件追踪（软删除字段 gorm.Model.DeletedAt 已自带）
	ViewerIP       string     `gorm:"size:45" json:"viewer_ip"`      // 最近一次取件人IP
	ViewerAt       *time.Time `json:"viewer_at"`                     // 最近一次取件时间
	ViewerCount    int        `gorm:"default:0" json:"viewer_count"` // 累计取件次数
	LastNotifiedAt *time.Time `json:"last_notified_at"`              // 最近一次给 owner 发通知的时间（用于去重）

	// PickupCode 6 位取件码（2026-10-08 起落库持久化，"只保留 6 位码"呈现）：
	//   - 本列为真相源；Redis/memkv 映射降级为加速缓存（TTL=分享过期时间），
	//     单机内存模式重启后经 GetByPickupCode 回退解析，取件码不再失联
	//   - 永久分享同样铸造（KV 无法表达永久 TTL，DB 无此约束）
	//   - nil=未铸造（E2E 密文分享/历史数据）；可空唯一索引允许多行 NULL
	PickupCode *string `gorm:"uniqueIndex;size:8" json:"pickup_code,omitempty"`
}

type FileCodeFile struct {
	gorm.Model
	FileCodeID   uint   `gorm:"index;not null" json:"file_code_id"`
	FileName     string `gorm:"size:255" json:"file_name"`      // 原始文件名（消毒后，仅展示）
	UUIDFileName string `gorm:"size:255" json:"uuid_file_name"` // 磁盘/对象唯一名
	FilePath     string `gorm:"size:255" json:"file_path"`      // 存储相对路径（含唯一文件名）
	Size         int64  `gorm:"default:0" json:"size"`
	FileHash     string `gorm:"size:64" json:"file_hash"` // SHA-256（秒传/完整性校验）
	SortOrder    int    `gorm:"default:0" json:"sort_order"`
}

type FileCodeQuery struct {
	Keyword       string // 模糊匹配 code/pickup_code/uuid_file_name/text/file_path
	UserID        *uint  // 上传者
	UploadType    string // anonymous/authenticated/presign_*
	OwnerIP       string // 上传者 IP（滥用定位）
	Status        string // normal/blocked/pending_review
	MinSize       *int64 // 大小区间（字节）
	MaxSize       *int64
	CreatedAfter  *time.Time // 创建时间区间
	CreatedBefore *time.Time
	Expired       *bool // true=仅过期(时间或次数)，false=仅未过期
	// Health 健康洞察过滤（2026-10-07）：active/expired/expiring_soon/never_picked/forever，
	// 空串=不过滤；口径见 dao.applyHealthFilter（与 CountByHealth 同源）
	Health string
	// Deleted 软删筛选：""=默认仅存活 / "only"=仅回收站(已软删) / "all"=全部。
	// 回收站视图用 "only"；配合 status/keyword 等既有筛选叠加。
	Deleted  string // "", "only", "all"
	Page     int
	PageSize int
}

type FileCodeStats struct {
	gorm.Model
	TotalFiles     int64 `json:"total_files"`
	TotalSize      int64 `json:"total_size"`
	TodayUploads   int64 `json:"today_uploads"`
	TodayDownloads int64 `json:"today_downloads"`
	ExpiredFiles   int64 `json:"expired_files"`
	AnonymousFiles int64 `json:"anonymous_files"`
	UserFiles      int64 `json:"user_files"`
}

type FileCodeUpdate struct {
	gorm.Model
	ExpiredAt    *time.Time `json:"expired_at"`
	ExpiredCount *int       `json:"expired_count"`
	UsedCount    *int       `json:"used_count"`
	RequireAuth  *bool      `json:"require_auth"`
	OwnerIP      *string    `json:"owner_ip"`
}

type FilePreview struct {
	ID          uint      `gorm:"primarykey" json:"id"`
	FileCodeID  uint      `gorm:"uniqueIndex;not null" json:"file_code_id"` // 关联的文件ID
	PreviewType string    `gorm:"size:20;not null" json:"preview_type"`     // 预览类型
	Thumbnail   string    `gorm:"size:255" json:"thumbnail"`                // 缩略图路径
	PreviewURL  string    `gorm:"size:255" json:"preview_url"`              // 预览URL
	Width       int       `json:"width"`                                    // 宽度
	Height      int       `json:"height"`                                   // 高度
	Duration    int       `json:"duration"`                                 // 时长（秒）
	PageCount   int       `json:"page_count"`                               // 页数
	TextContent string    `gorm:"type:text" json:"text_content"`            // 文本内容
	MimeType    string    `gorm:"size:50" json:"mime_type"`                 // MIME类型
	FileSize    int64     `json:"file_size"`                                // 文件大小
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
}

type FileRequest struct {
	gorm.Model
	Token     string     `gorm:"uniqueIndex;size:64" json:"token"` // 链接令牌（crypto/rand 32 hex）
	Title     string     `gorm:"size:255" json:"title"`            // 投递页说明（访客可见）
	UserID    uint       `gorm:"index" json:"user_id"`             // 收件人（链接创建者）
	MaxFiles  int        `gorm:"default:0" json:"max_files"`       // 单次投递文件数上限（0=不限）
	MaxBytes  int64      `gorm:"default:0" json:"max_bytes"`       // 单次投递总大小上限字节（0=不限）
	ExpiredAt *time.Time `json:"expired_at"`                       // 链接过期时间（nil=永久）
	UsedCount int        `gorm:"default:0" json:"used_count"`      // 累计投递次数
	RecvBytes int64      `gorm:"default:0" json:"recv_bytes"`      // 累计接收字节
}

type Notify struct {
	gorm.Model
	Title        string     `gorm:"size:255;not null" json:"title"`
	Content      string     `gorm:"type:text;not null" json:"content"`
	Type         string     `gorm:"size:20;default:'system';index" json:"type"` // system/feature/maintenance/share_retrieved
	Level        string     `gorm:"size:20;default:'info';index" json:"level"`  // info/warning/error/success
	Status       int        `gorm:"default:1;index" json:"status"`              // 0=草稿 1=发布 2=下线
	StartAt      *time.Time `json:"start_at,omitempty"`                         // 生效时间
	EndAt        *time.Time `json:"end_at,omitempty"`                           // 失效时间
	AuthorID     uint       `gorm:"index" json:"author_id"`                     // 发布管理员
	TargetUserID *uint      `gorm:"index" json:"target_user_id,omitempty"`      // 0=广播, >0=定向给某用户
	ReadAt       *time.Time `gorm:"index" json:"read_at,omitempty"`             // 用户首次已读时间
}

type PickupCharge struct {
	gorm.Model
	// Code 规范分享码（8 位 file_codes.code；取件码入口解析后写入）。
	Code string `gorm:"size:255;not null;uniqueIndex:idx_pickup_charge_code_token" json:"code"`
	// TokenHash 令牌指纹（令牌签名段，hex）。
	TokenHash string `gorm:"size:64;not null;uniqueIndex:idx_pickup_charge_code_token" json:"token_hash"`
	// Channel 计次来源通道（select / retrieve / download），仅供观测。
	Channel string `gorm:"size:32" json:"channel"`
	// IP 取件人 IP（可信代理解析后）——owner 侧「取件历史」逐条展示用。
	// 落的是明文 IP（与 transfer_logs 一致）；若日后要脱敏，这里是唯一改动点。
	IP string `gorm:"size:64" json:"ip"`
	// ChargedAt 计次时刻（= 计次成功时间）。
	ChargedAt time.Time `gorm:"index" json:"charged_at"`
}

type SystemConfigRecord struct {
	gorm.Model
	Data string `gorm:"type:text" json:"data"`
}

type TransferLog struct {
	gorm.Model
	Operation  string `gorm:"size:20;index" json:"operation"`
	FileCodeID uint   `gorm:"index" json:"file_code_id"`
	FileCode   string `gorm:"size:255" json:"file_code"`
	FileName   string `gorm:"size:255" json:"file_name"`
	FileSize   int64  `json:"file_size"`
	UserID     *uint  `gorm:"index" json:"user_id"`
	// APIKeyID 认证所用用户级 API Key（Key 粒度归因；JWT/匿名上传为 nil）
	APIKeyID   *uint  `gorm:"index" json:"api_key_id"`
	Username   string `gorm:"size:100" json:"username"`
	IP         string `gorm:"size:45" json:"ip"`
	DurationMs int64  `json:"duration_ms"`
}

type TransferLogQuery struct {
	Operation string `json:"operation"`
	UserID    *uint  `json:"user_id"`
	Search    string `json:"search"`
	Page      int    `json:"page"`
	PageSize  int    `json:"page_size"`
}

type UploadChunk struct {
	gorm.Model

	// UploadID 与 ChunkIndex 组成**复合唯一键**（2026-10-25 审计 A3）：
	// 无此约束时，分片失败后重传同索引会**再建一行**（dao.GetChunkByIndex 只查
	// completed=true 的行 ⇒ 看不到未完成的旧行）⇒ CountCompletedChunks 按行数计
	// ⇒ 「分片齐全」判定可虚高（声明 5 片只传 4 片也可能计成 5）。
	//
	// ⚠️ **两个字段必须挂同一个索引名**才是复合索引：只给 ChunkIndex 挂
	// `uniqueIndex:` ⇒ gorm 建的是 **chunk_index 单列**唯一索引 ⇒ **不同上传
	// 会话的同索引分片互相冲突**（CI 真机冒烟实测：S13e 同用户秒传
	// 「UNIQUE constraint failed: upload_chunks.chunk_index」⇒ 整条秒传链路挂）。
	//
	// 生产走版本化迁移 000006（复合）；此处标签让**新建库**（AutoMigrate）也有。
	UploadID    string `gorm:"index;size:36;uniqueIndex:idx_upload_chunks_upload_id_chunk_index" json:"upload_id"`
	ChunkIndex  int    `gorm:"uniqueIndex:idx_upload_chunks_upload_id_chunk_index" json:"chunk_index"`
	ChunkHash   string `gorm:"size:64" json:"chunk_hash"`
	TotalChunks int    `json:"total_chunks"`
	FileSize    int64  `json:"file_size"`
	ChunkSize   int    `json:"chunk_size"`
	FileName    string `gorm:"size:255" json:"file_name"`

	// 归属追踪（治理 2026-10-03）：分片通道此前不记录上传者，
	// Complete 处置（滥用定位/归属校验）无从下手。控制记录（chunk_index=-1）填充。
	OwnerIP string `gorm:"size:45" json:"owner_ip"`
	UserID  *uint  `gorm:"index" json:"user_id"`

	Completed  bool   `gorm:"default:false" json:"completed"`
	RetryCount int    `gorm:"default:0" json:"retry_count"`            // 重试次数
	LastError  string `gorm:"type:text" json:"last_error"`             // 最后错误信息
	Status     string `gorm:"size:20;default:'pending'" json:"status"` // pending, uploading, completed, failed
}

type User struct {
	gorm.Model
	Username      string     `gorm:"uniqueIndex;size:50" json:"username"`
	Email         string     `gorm:"uniqueIndex;size:100" json:"email"`
	PasswordHash  string     `gorm:"size:128" json:"-"`                      // 密码哈希，不返回给前端
	Nickname      string     `gorm:"size:50" json:"nickname"`                // 用户昵称
	Avatar        string     `gorm:"size:255" json:"avatar"`                 // 头像URL
	Role          string     `gorm:"size:20;default:'user'" json:"role"`     // admin, user
	Status        string     `gorm:"size:20;default:'active'" json:"status"` // active, inactive, banned
	EmailVerified bool       `gorm:"default:false" json:"email_verified"`    // 邮箱是否验证
	LastLoginAt   *time.Time `json:"last_login_at"`                          // 最后登录时间
	LastLoginIP   string     `gorm:"size:45" json:"last_login_ip"`           // 最后登录IP
	OidcSub       string     `gorm:"index;size:128" json:"-"`                // OIDC subject（P2 SSO；空=非 OIDC）
	// SessionEpoch 会话纪元：改密/封禁/降权时 +1，使全部已签发 JWT 即时失效
	// （2026-10-05 审计 P2：此前封禁/重置密码后旧 JWT 仍有效至自然过期）。
	SessionEpoch int `gorm:"default:0" json:"-"`

	// 用户上传统计
	TotalUploads    int   `gorm:"default:0" json:"total_uploads"`     // 总上传次数
	TotalDownloads  int   `gorm:"default:0" json:"total_downloads"`   // 总下载次数
	TotalStorage    int64 `gorm:"default:0" json:"total_storage"`     // 总存储大小(字节)
	MaxUploadSize   int64 `gorm:"default:0" json:"max_upload_size"`   // 最大单次上传大小(字节)，0表示使用系统默认
	MaxStorageQuota int64 `gorm:"default:0" json:"max_storage_quota"` // 最大存储配额(字节)，0表示无限制
}

type UserAPIKey struct {
	gorm.Model
	UserID     uint   `gorm:"index"`
	Name       string `gorm:"size:100"`
	Prefix     string `gorm:"size:16"`
	KeyHash    string `gorm:"size:64;uniqueIndex"`
	LastUsedAt *time.Time
	LastUsedIP string `gorm:"size:45"`
	ExpiresAt  *time.Time
	// ExpiryNotifiedAt 临期通知去重标记；NULL=未通知
	ExpiryNotifiedAt *time.Time
	RevokedAt        *time.Time
	Revoked          bool `gorm:"default:false"`
}

type UserQuery struct {
	ID       *uint  `json:"id"`
	Username string `json:"username"`
	Email    string `json:"email"`
	Role     string `json:"role"`
	Status   string `json:"status"`
	Search   string `json:"search"` // 模糊搜索用户名或邮箱
	Limit    int    `json:"limit"`
	Offset   int    `json:"offset"`
}

type UserResp struct {
	ID              uint       `json:"id"`
	Username        string     `json:"username"`
	Email           string     `json:"email"`
	Nickname        string     `json:"nickname"`
	Avatar          string     `json:"avatar"`
	Role            string     `json:"role"`
	Status          string     `json:"status"`
	EmailVerified   bool       `json:"email_verified"`
	LastLoginAt     *time.Time `json:"last_login_at"`
	LastLoginIP     string     `json:"last_login_ip"`
	TotalUploads    int        `json:"total_uploads"`
	TotalDownloads  int        `json:"total_downloads"`
	TotalStorage    int64      `json:"total_storage"`
	MaxUploadSize   int64      `json:"max_upload_size"`
	MaxStorageQuota int64      `json:"max_storage_quota"`
	CreatedAt       time.Time  `json:"created_at"`
	UpdatedAt       time.Time  `json:"updated_at"`
}

type UserStats struct {
	UserID         uint  `json:"user_id"`
	TotalUploads   int   `json:"total_uploads"`
	TotalDownloads int   `json:"total_downloads"`
	TotalStorage   int64 `json:"total_storage"`
	FileCount      int   `json:"file_count"`
}