web

type APIResponse struct {
	Code    int         `json:"code"`
	Message string      `json:"message,omitempty"`
	Data    interface{} `json:"data,omitempty"`
	Error   string      `json:"error,omitempty"`
}

type AdminConfigRequest struct {
	// 配置模块，直接使用各配置结构体避免字段重复
	Base     *config.BaseConfig       `json:"base,omitempty"`
	Database *config.DatabaseConfig   `json:"database,omitempty"`
	Transfer *config.TransferConfig   `json:"transfer,omitempty"`
	Storage  *config.StorageConfig    `json:"storage,omitempty"`
	User     *config.UserSystemConfig `json:"user,omitempty"`
	MCP      *config.MCPConfig        `json:"mcp,omitempty"`
	UI       *config.UIConfig         `json:"ui,omitempty"`

	// 系统运行时特有字段（不属于配置模块的字段）
	SysStart *string `json:"sys_start,omitempty"`

	// 顶层通知字段保留与历史配置结构兼容
	NotifyTitle   *string `json:"notify_title,omitempty"`
	NotifyContent *string `json:"notify_content,omitempty"`
}

type AdminConfigResponse struct {
	AdminConfigRequest
}

type AdminDatabaseStatsResponse struct {
	DatabaseSize         int64   `json:"database_size"`
	TableCount           int     `json:"table_count"`
	RecordCount          int64   `json:"record_count"`
	DatabaseType         string  `json:"database_type"`
	DatabaseVersion      string  `json:"database_version"`
	LastBackupTime       string  `json:"last_backup_time"`
	FragmentationPercent float64 `json:"fragmentation_percent"`
}

type AdminFileDetail struct {
	ID           uint   `json:"id"`
	Code         string `json:"code"`
	Prefix       string `json:"prefix"`
	Suffix       string `json:"suffix"`
	Size         int64  `json:"size"`
	Type         string `json:"type"`
	ExpiredAt    string `json:"expired_at"`
	ExpiredCount int    `json:"expired_count"`
	UsedCount    int    `json:"used_count"`
	CreatedAt    string `json:"created_at"`
	RequireAuth  bool   `json:"require_auth"`
	UploadType   string `json:"upload_type"`
}

type AdminFileInfo struct {
	FileInfo
	UserID   *uint  `json:"user_id"`
	Username string `json:"username,omitempty"`
	OwnerIP  string `json:"owner_ip"`
}

type AdminFilesRequest struct {
	Page     int    `json:"page" form:"page"`
	PageSize int    `json:"page_size" form:"page_size"`
	Search   string `json:"search" form:"search"`
}

type AdminFilesResponse struct {
	Files      []AdminFileInfo `json:"files"`
	Pagination PaginationInfo  `json:"pagination"`
}

type AdminLoginRequest struct {
	Username string `json:"username,omitempty"`
	Password string `json:"password" binding:"required"`
}

type AdminLoginResponse struct {
	Token     string `json:"token"`
	TokenType string `json:"token_type"`
	ExpiresIn int64  `json:"expires_in"`
}

type AdminOperationLogItem struct {
	ID        uint   `json:"id"`
	Action    string `json:"action"`
	Target    string `json:"target"`
	Success   bool   `json:"success"`
	Message   string `json:"message"`
	ActorID   *uint  `json:"actor_id,omitempty"`
	ActorName string `json:"actor_name"`
	IP        string `json:"ip"`
	LatencyMs int64  `json:"latency_ms"`
	CreatedAt string `json:"created_at"`
}

type AdminOperationLogListResponse struct {
	Logs       []AdminOperationLogItem `json:"logs"`
	Pagination PaginationResponse      `json:"pagination"`
}

type AdminPerformanceMetricsResponse struct {
	CPUUsage          float64 `json:"cpu_usage"`
	MemoryUsage       int64   `json:"memory_usage"`
	DiskUsage         int64   `json:"disk_usage"`
	NetworkIn         int64   `json:"network_in"`
	NetworkOut        int64   `json:"network_out"`
	RequestsPerSecond int64   `json:"requests_per_second"`
	ActiveConnections int     `json:"active_connections"`
	ResponseTime      float64 `json:"response_time"`
}

type AdminStatsResponse struct {
	TotalUsers         int64  `json:"total_users"`
	ActiveUsers        int64  `json:"active_users"`
	TodayRegistrations int64  `json:"today_registrations"`
	TodayUploads       int64  `json:"today_uploads"`
	TotalFiles         int64  `json:"total_files"`
	ActiveFiles        int64  `json:"active_files"`
	TotalSize          int64  `json:"total_size"`
	SysStart           string `json:"sys_start"`
}

type AdminStorageStatusResponse struct {
	StorageType    string  `json:"storage_type"`
	TotalSpace     int64   `json:"total_space"`
	UsedSpace      int64   `json:"used_space"`
	AvailableSpace int64   `json:"available_space"`
	UsagePercent   float64 `json:"usage_percent"`
	Status         string  `json:"status"`
	IsHealthy      bool    `json:"is_healthy"`
}

type AdminSystemInfoResponse struct {
	GoVersion          string `json:"go_version"`
	BuildTime          string `json:"build_time"`
	GitCommit          string `json:"git_commit"`
	OSInfo             string `json:"os_info"`
	CPUCores           int    `json:"cpu_cores"`
	MemoryUsage        int64  `json:"memory_usage"`
	DiskUsage          int64  `json:"disk_usage"`
	Uptime             string `json:"uptime"`
	FileCodeBoxVersion string `json:"filecodebox_version"`
}

type AdminUserCreateRequest struct {
	Username string `json:"username" binding:"required"`
	Email    string `json:"email" binding:"required"`
	Password string `json:"password" binding:"required"`
	Nickname string `json:"nickname"`
	Role     string `json:"role"`
}

type AdminUserDetail struct {
	ID             uint   `json:"id"`
	Username       string `json:"username"`
	Email          string `json:"email"`
	Nickname       string `json:"nickname"`
	Role           string `json:"role"`
	IsAdmin        bool   `json:"is_admin"`
	IsActive       bool   `json:"is_active"`
	Status         string `json:"status"`
	EmailVerified  bool   `json:"email_verified"`
	CreatedAt      string `json:"created_at"`
	LastLoginAt    string `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"`
}

type AdminUserFilesResponse struct {
	Files    []AdminFileDetail `json:"files"`
	Username string            `json:"username"`
	Total    int64             `json:"total"`
}

type AdminUserInfo struct {
	UserInfo
	TotalUploads   int    `json:"total_uploads"`
	TotalDownloads int    `json:"total_downloads"`
	TotalStorage   int64  `json:"total_storage"`
	LastLoginAt    string `json:"last_login_at,omitempty"`
	LastLoginIP    string `json:"last_login_ip"`
}

type AdminUserStatsResponse struct {
	TotalUsers         int64 `json:"total_users"`
	ActiveUsers        int64 `json:"active_users"`
	TodayRegistrations int64 `json:"today_registrations"`
	TodayUploads       int64 `json:"today_uploads"`
}

type AdminUserStatusRequest struct {
	Status string `json:"status" binding:"required"`
}

type AdminUserUpdateRequest struct {
	Username string `json:"username"`
	Email    string `json:"email"`
	Nickname string `json:"nickname"`
	Role     string `json:"role"`
	Status   string `json:"status"`
}

type AdminUsersListResponse struct {
	Users      []AdminUserDetail      `json:"users"`
	Stats      AdminUserStatsResponse `json:"stats"`
	Pagination PaginationResponse     `json:"pagination"`
}

type AdminUsersRequest struct {
	Page     int    `json:"page" form:"page"`
	PageSize int    `json:"page_size" form:"page_size"`
	Search   string `json:"search" form:"search"`
	Status   string `json:"status" form:"status"`
}

type AdminUsersResponse struct {
	Users      []AdminUserInfo `json:"users"`
	Pagination PaginationInfo  `json:"pagination"`
}

type AuthLoginRequest struct {
	Username string `json:"username" binding:"required"`
	Password string `json:"password" binding:"required"`
}

type AuthLoginResponse struct {
	Token     string    `json:"token"`
	TokenType string    `json:"token_type"`
	ExpiresIn int64     `json:"expires_in"`
	User      *UserInfo `json:"user"`
}

type AuthRegisterRequest struct {
	Username string `json:"username" binding:"required"`
	Email    string `json:"email" binding:"required"`
	Password string `json:"password" binding:"required"`
	Nickname string `json:"nickname"`
}

type AuthRegisterResponse struct {
	ID       uint   `json:"id"`
	Username string `json:"username"`
	Email    string `json:"email"`
	Nickname string `json:"nickname"`
	Role     string `json:"role"`
}

type BackupPathResponse struct {
	BackupPath string `json:"backup_path"`
}

type ChunkUploadCompleteRequest struct {
	ExpireValue int    `json:"expire_value" binding:"required"`
	ExpireStyle string `json:"expire_style" binding:"required"`
	RequireAuth bool   `json:"require_auth"`
}

type ChunkUploadCompleteResponse struct {
	Code     string `json:"code"`
	ShareURL string `json:"share_url"`
	FileName string `json:"file_name"`
}

type ChunkUploadInitRequest struct {
	FileName  string `json:"file_name" binding:"required"`
	FileSize  int64  `json:"file_size" binding:"required"`
	ChunkSize int    `json:"chunk_size" binding:"required"`
	FileHash  string `json:"file_hash" binding:"required"`
}

type ChunkUploadInitResponse struct {
	UploadID      string  `json:"upload_id"`
	TotalChunks   int     `json:"total_chunks"`
	ChunkSize     int     `json:"chunk_size"`
	UploadedCount int     `json:"uploaded_count"`
	Progress      float64 `json:"progress"`
}

type ChunkUploadResponse struct {
	ChunkHash  string  `json:"chunk_hash"`
	ChunkIndex int     `json:"chunk_index"`
	Progress   float64 `json:"progress"`
}

type ChunkUploadStatusResponse struct {
	UploadID      string  `json:"upload_id"`
	Status        string  `json:"status"`
	Progress      float64 `json:"progress"`
	TotalChunks   int     `json:"total_chunks"`
	UploadedCount int     `json:"uploaded_count"`
	FileName      string  `json:"file_name"`
	FileSize      int64   `json:"file_size"`
}

type ChunkValidationResponse struct {
	Valid bool `json:"valid"`
}

type CleanedCountResponse struct {
	CleanedCount int `json:"cleaned_count"`
}

type ControlDataRequest struct {
	Action string `json:"action" binding:"required"` // "start" 或 "stop"
}

type CountResponse struct {
	Count int `json:"count"`
}

type ErrorResponse struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
	Error   string `json:"error,omitempty"`
}

type FileInfo struct {
	Code         string     `json:"code"`
	FileName     string     `json:"file_name"`
	Size         int64      `json:"size"`
	UploadType   string     `json:"upload_type"`
	RequireAuth  bool       `json:"require_auth"`
	UsedCount    int        `json:"used_count"`
	ExpiredCount int        `json:"expired_count"`
	ExpiredAt    *time.Time `json:"expired_at"`
	CreatedAt    time.Time  `json:"created_at"`
	IsExpired    bool       `json:"is_expired"`
}

type FileInfoResponse struct {
	Code        string `json:"code"`
	Name        string `json:"name"`
	Size        int64  `json:"size"`
	Text        string `json:"text,omitempty"` // 文本内容或下载链接
	UploadType  string `json:"upload_type"`
	RequireAuth bool   `json:"require_auth"`
}

type HealthResponse struct {
	Status    string `json:"status"`
	Timestamp string `json:"timestamp"`
	Version   string `json:"version"`
}

type IDResponse struct {
	ID uint `json:"id"`
}

type LogPathResponse struct {
	LogPath string `json:"log_path"`
}

type LogsResponse struct {
	Logs  []string `json:"logs"`
	Total int      `json:"total"`
}

type MCPStatusResponse struct {
	Status string            `json:"status"`
	Config *config.MCPConfig `json:"config"`
}

type MCPTestResponse struct {
	MCPStatusResponse
}

type PaginatedResponse struct {
	List       interface{}    `json:"list"`
	Pagination PaginationInfo `json:"pagination"`
}

type PaginationInfo struct {
	Page       int   `json:"page"`
	PageSize   int   `json:"page_size"`
	Total      int64 `json:"total"`
	TotalPages int   `json:"total_pages"`
	HasNext    bool  `json:"has_next"`
	HasPrev    bool  `json:"has_prev"`
}

type PaginationResponse struct {
	Page     int   `json:"page"`
	PageSize int   `json:"page_size"`
	Total    int64 `json:"total"`
	Pages    int64 `json:"pages"`
}

type ShareCodeRequest struct {
	Code string `json:"code" form:"code" binding:"required"`
}

type ShareFileRequest struct {
	ExpireValue int    `json:"expire_value" form:"expire_value"`
	ExpireStyle string `json:"expire_style" form:"expire_style"`
	RequireAuth bool   `json:"require_auth" form:"require_auth"`
}

type ShareResponse struct {
	Code      string     `json:"code"`
	ShareURL  string     `json:"share_url"`
	FileName  string     `json:"file_name,omitempty"`
	ExpiredAt *time.Time `json:"expired_at"`
}

type ShareStatsResponse struct {
	Code         string     `json:"code"`
	FileName     string     `json:"file_name"`
	FileSize     int64      `json:"file_size"`
	UsedCount    int        `json:"used_count"`
	ExpiredCount int        `json:"expired_count"`
	ExpiredAt    *time.Time `json:"expired_at"`
	UploadType   string     `json:"upload_type"`
	RequireAuth  bool       `json:"require_auth"`
	IsExpired    bool       `json:"is_expired"`
	CreatedAt    time.Time  `json:"created_at"`
}

type ShareTextRequest struct {
	Text        string `json:"text" binding:"required"`
	ExpireValue int    `json:"expire_value"`
	ExpireStyle string `json:"expire_style"`
	RequireAuth bool   `json:"require_auth"`
}

type StorageConnectionResponse struct {
	Type   string `json:"type"`
	Status string `json:"status"`
}

type StorageInfoResponse struct {
	Current        string                      `json:"current"`
	Available      []string                    `json:"available"`
	StorageDetails map[string]WebStorageDetail `json:"storage_details"`
	StorageConfig  *config.StorageConfig       `json:"storage_config"`
}

type StorageSwitchRequest struct {
	Type   string                `json:"type" binding:"required"`
	Config *config.StorageConfig `json:"config,omitempty"`
}

type StorageSwitchResponse struct {
	Success     bool   `json:"success"`
	Message     string `json:"message"`
	CurrentType string `json:"current_type"`
}

type StorageTestRequest struct {
	Type   string                `json:"type" binding:"required"`
	Config *config.StorageConfig `json:"config" binding:"required"`
}

type StorageTestResponse struct {
	Success bool   `json:"success"`
	Message string `json:"message"`
	Details string `json:"details,omitempty"`
}

type SuccessResponse struct {
	Code    int         `json:"code"`
	Message string      `json:"message,omitempty"`
	Data    interface{} `json:"data,omitempty"`
}

type SystemInfoResponse struct {
	OS       string `json:"os"`
	Arch     string `json:"arch"`
	Version  string `json:"version"`
	Go       string `json:"go"`
	Uptime   string `json:"uptime"`
	Memory   string `json:"memory"`
	Database string `json:"database"`
}

type TasksResponse struct {
	Tasks interface{} `json:"tasks"` // 使用 interface{} 以兼容现有类型
	Total int         `json:"total"`
}

type TestDataRequest struct {
	Port string `json:"port"`
	Host string `json:"host"`
}

type TokenResponse struct {
	Token    string      `json:"token"`
	UserInfo interface{} `json:"user_info,omitempty"`
}

type TransferLogItem struct {
	ID         uint   `json:"id"`
	Operation  string `json:"operation"`
	FileCode   string `json:"file_code"`
	FileName   string `json:"file_name"`
	FileSize   int64  `json:"file_size"`
	UserID     *uint  `json:"user_id,omitempty"`
	Username   string `json:"username"`
	IP         string `json:"ip"`
	DurationMs int64  `json:"duration_ms"`
	CreatedAt  string `json:"created_at"`
}

type TransferLogListResponse struct {
	Logs       []TransferLogItem  `json:"logs"`
	Pagination PaginationResponse `json:"pagination"`
}

type UploadInfoResponse struct {
	ShareCode    string `json:"share_code"`
	DownloadLink string `json:"download_link"`
}

type UserAPIKeyCreateRequest struct {
	Name          string  `json:"name"`
	ExpiresInDays *int    `json:"expires_in_days"`
	ExpiresAt     *string `json:"expires_at"`
}

type UserAPIKeyCreateResponse struct {
	Key    string             `json:"key"`
	APIKey UserAPIKeyResponse `json:"api_key"`
}

type UserAPIKeyListResponse struct {
	Keys []UserAPIKeyResponse `json:"keys"`
}

type UserAPIKeyResponse struct {
	ID         uint   `json:"id"`
	Name       string `json:"name"`
	Prefix     string `json:"prefix"`
	CreatedAt  string `json:"created_at"`
	UpdatedAt  string `json:"updated_at"`
	LastUsedAt string `json:"last_used_at,omitempty"`
	ExpiresAt  string `json:"expires_at,omitempty"`
	RevokedAt  string `json:"revoked_at,omitempty"`
	Revoked    bool   `json:"revoked"`
}

type UserDataRequest struct {
	Username string `json:"username" binding:"required"`
	Email    string `json:"email" binding:"omitempty,email"`
	Password string `json:"password" binding:"required"`
	Nickname string `json:"nickname"`
	IsAdmin  bool   `json:"is_admin"`
	IsActive bool   `json:"is_active"`
}

type UserFilesRequest struct {
	Page     int    `json:"page" form:"page"`
	PageSize int    `json:"page_size" form:"page_size"`
	Search   string `json:"search" form:"search"`
}

type UserFilesResponse struct {
	Files      []FileInfo     `json:"files"`
	Pagination PaginationInfo `json:"pagination"`
}

type UserInfo 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"`
	CreatedAt     string `json:"created_at,omitempty"`
	LastLoginAt   string `json:"last_login_at,omitempty"`
}

type UserPasswordChangeRequest struct {
	OldPassword string `json:"old_password" binding:"required"`
	NewPassword string `json:"new_password" binding:"required"`
}

type UserPasswordResetRequest struct {
	Email string `json:"email" binding:"required"`
}

type UserProfileResponse 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"`
	CreatedAt     string `json:"created_at"`
	UpdatedAt     string `json:"updated_at"`
}

type UserProfileUpdateRequest struct {
	Nickname string `json:"nickname"`
	Avatar   string `json:"avatar"`
}

type UserStatsResponse struct {
	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"`
	CurrentFiles    int    `json:"current_files"`
	FileCount       int    `json:"file_count"`
	LastLoginAt     string `json:"last_login_at,omitempty"`
	LastLoginIP     string `json:"last_login_ip"`
	EmailVerified   bool   `json:"email_verified"`
	Status          string `json:"status"`
	Role            string `json:"role"`
	LastUploadAt    string `json:"last_upload_at,omitempty"`
	LastDownloadAt  string `json:"last_download_at,omitempty"`
}

type UserSystemInfoResponse struct {
	// 使用整型 0/1 表示开关，以与配置层和前端保持一致
	UserSystemEnabled        int `json:"user_system_enabled"`
	AllowUserRegistration    int `json:"allow_user_registration"`
	RequireEmailVerification int `json:"require_email_verification"`
}

type WebStorageDetail struct {
	Type      string `json:"type"`
	Available bool   `json:"available"`
	Error     string `json:"error,omitempty"`
	// StoragePath 本存储的路径或标识（例如本地目录、S3 bucket）
	StoragePath string `json:"storage_path,omitempty"`
	// UsagePercent 使用率（0-100），如果无法获取则为 nil
	UsagePercent *int `json:"usage_percent,omitempty"`
}