service

Documentation

Index

• Variables
• type AdminFileData
• type AdminFilesResult
• type AdminStatsData
• type AdminStorageDetail
• type AdminUserData
• type AdminUsersResult
• type AuthTokenData
• type AuthValidationResult
• type BuildInfo
  • func GetBuildInfo() *BuildInfo
• type ChunkUploadCompleteData
• type ChunkUploadCompleteResponse
• type ChunkUploadInitData
• type ChunkUploadProgressResponse
• type ChunkUploadStatusData
• type ChunkUploadStatusResponse
• type ChunkVerifyResponse
• type DatabaseStats
• type DiskUsage
• type IntegrityCheckResult
• type LogStats
• type MCPConfig
• type MCPStatus
• type MCPTestResult
• type PasswordResetData
• type PerformanceMetrics
• type PermissionCheckResult
• type RunningTask
• type SecurityScanResult
• type SessionData
• type ShareFileRequest
• type ShareFileResult
• type ShareStatsData
• type ShareTextRequest
• type ShareTextResult
• type ShareUpdateData
• type StorageStatus
• type StorageTestResult
• type SystemInfo
• type SystemStatusData
• type UserFileData
• type UserFilesResult
• type UserProfileUpdateData
• type UserStatsData
• type UserStatsResponse

Variables

var (
	// GoVersion 编译使用的 Go 版本
	GoVersion = "unknown"

	// BuildTime 编译时间，格式为 ISO8601
	BuildTime = "unknown"

	// GitCommit Git 提交哈希值
	GitCommit = "unknown"

	// GitBranch Git 分支名称
	GitBranch = "unknown"

	// Version 应用版本号
	Version = "dev"
)

编译时通过 -ldflags 传入的全局变量

Types

type AdminFileData

type AdminFileData 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"`
	UserID       *uint      `json:"user_id"`
	Username     string     `json:"username,omitempty"`
	OwnerIP      string     `json:"owner_ip"`
}

AdminFileData 管理员文件数据

type AdminFilesResult

type AdminFilesResult struct {
	Files []AdminFileData `json:"files"`
	Total int64           `json:"total"`
}

AdminFilesResult 管理员文件查询结果

type AdminStatsData

type AdminStatsData struct {
	TotalFiles     int64 `json:"total_files"`
	TotalUsers     int64 `json:"total_users"`
	TotalStorage   int64 `json:"total_storage"`
	TodayUploads   int64 `json:"today_uploads"`
	TodayDownloads int64 `json:"today_downloads"`
	ActiveUsers    int64 `json:"active_users"`
	ExpiredFiles   int64 `json:"expired_files"`
	SystemUptime   int64 `json:"system_uptime"`
}

AdminStatsData 管理员统计数据

type AdminStorageDetail

type AdminStorageDetail struct {
	TotalSpace     int64   `json:"total_space"`
	AvailableSpace int64   `json:"available_space"`
	UsedSpace      int64   `json:"used_space"`
	UsagePercent   float64 `json:"usage_percent"`
	Type           string  `json:"type"`
}

AdminStorageDetail 管理员视图的存储详细信息

type AdminUserData

type AdminUserData 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"`
	TotalUploads   int        `json:"total_uploads"`
	TotalDownloads int        `json:"total_downloads"`
	TotalStorage   int64      `json:"total_storage"`
	LastLoginAt    *time.Time `json:"last_login_at"`
	LastLoginIP    string     `json:"last_login_ip"`
	CreatedAt      time.Time  `json:"created_at"`
	UpdatedAt      time.Time  `json:"updated_at"`
}

AdminUserData 管理员用户数据

type AdminUsersResult

type AdminUsersResult struct {
	Users []AdminUserData `json:"users"`
	Total int64           `json:"total"`
}

AdminUsersResult 管理员用户查询结果

type AuthTokenData

type AuthTokenData struct {
	Token     string `json:"token"`
	TokenType string `json:"token_type"`
	ExpiresIn int64  `json:"expires_in"`
	UserID    uint   `json:"user_id"`
}

AuthTokenData 认证令牌数据

type AuthValidationResult

type AuthValidationResult struct {
	Valid     bool   `json:"valid"`
	UserID    uint   `json:"user_id"`
	Role      string `json:"role"`
	Username  string `json:"username"`
	ExpiresAt int64  `json:"expires_at"`
}

AuthValidationResult 认证验证结果

type BuildInfo

type BuildInfo struct {
	Version   string `json:"version"`
	GitCommit string `json:"git_commit"`
	GitBranch string `json:"git_branch"`
	BuildTime string `json:"build_time"`
	GoVersion string `json:"go_version"`
	Arch      string `json:"arch"`
	OS        string `json:"os"`
}

BuildInfo 构建信息结构体

func GetBuildInfo

func GetBuildInfo() *BuildInfo

GetBuildInfo 获取应用构建信息

type ChunkUploadCompleteData

type ChunkUploadCompleteData struct {
	Code      string     `json:"code"`
	ShareURL  string     `json:"share_url"`
	FileName  string     `json:"file_name"`
	FileSize  int64      `json:"file_size"`
	ExpiredAt *time.Time `json:"expired_at"`
}

ChunkUploadCompleteData 分片上传完成数据

type ChunkUploadCompleteResponse

type ChunkUploadCompleteResponse struct {
	Success  bool   `json:"success"`
	Message  string `json:"message"`
	FileCode string `json:"file_code,omitempty"`
	ShareURL string `json:"share_url,omitempty"`
}

ChunkUploadCompleteResponse 分块上传完成响应

type ChunkUploadInitData

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

ChunkUploadInitData 分片上传初始化数据

type ChunkUploadProgressResponse

type ChunkUploadProgressResponse struct {
	UploadID string `json:"upload_id"`
	Progress int    `json:"progress"`
	Status   string `json:"status"`
}

ChunkUploadProgressResponse 分块上传进度响应

type ChunkUploadStatusData

type ChunkUploadStatusData 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"`
	CreatedAt     time.Time `json:"created_at"`
	UpdatedAt     time.Time `json:"updated_at"`
}

ChunkUploadStatusData 分片上传状态数据

type ChunkUploadStatusResponse

type ChunkUploadStatusResponse struct {
	UploadID       string `json:"upload_id"`
	Status         string `json:"status"`
	UploadedChunks []int  `json:"uploaded_chunks"`
	TotalChunks    int    `json:"total_chunks"`
	Progress       int    `json:"progress"`
	CreatedAt      string `json:"created_at"`
	UpdatedAt      string `json:"updated_at"`
}

ChunkUploadStatusResponse 分块上传状态响应

type ChunkVerifyResponse

type ChunkVerifyResponse struct {
	Verified bool   `json:"verified"`
	Message  string `json:"message"`
}

ChunkVerifyResponse 分块验证响应

type DatabaseStats

type DatabaseStats struct {
	TotalFiles   int64  `json:"total_files"`
	TotalUsers   int64  `json:"total_users"`
	TotalSize    int64  `json:"total_size"`
	DatabaseSize string `json:"database_size"`
}

DatabaseStats 数据库统计信息

type DiskUsage

type DiskUsage struct {
	TotalSpace     int64   `json:"total_space"`
	UsedSpace      int64   `json:"used_space"`
	AvailableSpace int64   `json:"available_space"`
	UsagePercent   float64 `json:"usage_percent"`
	StorageType    string  `json:"storage_type"`
	Success        bool    `json:"success"`
	Error          *string `json:"error"`
}

DiskUsage 磁盘使用情况

type IntegrityCheckResult

type IntegrityCheckResult struct {
	Status       string   `json:"status"`
	CheckedFiles int      `json:"checked_files"`
	CorruptFiles int      `json:"corrupt_files"`
	MissingFiles int      `json:"missing_files"`
	Issues       []string `json:"issues"`
}

IntegrityCheckResult 完整性检查结果

type LogStats

type LogStats struct {
	TotalLogs   int    `json:"total_logs"`
	ErrorLogs   int    `json:"error_logs"`
	WarningLogs int    `json:"warning_logs"`
	InfoLogs    int    `json:"info_logs"`
	LastLogTime string `json:"last_log_time"`
	LogSize     string `json:"log_size"`
}

LogStats 日志统计

type MCPConfig

type MCPConfig struct {
	Enabled bool   `json:"enabled"`
	Host    string `json:"host"`
	Port    int    `json:"port"`
	Status  string `json:"status"`
}

MCPConfig MCP配置信息

type MCPStatus

type MCPStatus struct {
	Config      MCPConfig `json:"config"`
	IsRunning   bool      `json:"is_running"`
	LastStarted string    `json:"last_started"`
	Version     string    `json:"version"`
}

MCPStatus MCP状态信息

type MCPTestResult

type MCPTestResult struct {
	Success     bool   `json:"success"`
	Message     string `json:"message"`
	ConnectedAt string `json:"connected_at"`
}

MCPTestResult MCP测试结果

type PasswordResetData

type PasswordResetData struct {
	UserID    uint   `json:"user_id"`
	Token     string `json:"token"`
	ExpiresAt int64  `json:"expires_at"`
}

PasswordResetData 密码重置数据

type PerformanceMetrics

type PerformanceMetrics struct {
	MemoryUsage   string    `json:"memory_usage"`
	CPUUsage      string    `json:"cpu_usage"`
	ResponseTime  string    `json:"response_time"`
	LastUpdated   time.Time `json:"last_updated"`
	DatabaseStats string    `json:"database_stats"`
}

PerformanceMetrics 性能指标

type PermissionCheckResult

type PermissionCheckResult struct {
	Status      string            `json:"status"`
	Permissions map[string]string `json:"permissions"`
	Issues      []string          `json:"issues"`
}

PermissionCheckResult 权限检查结果

type RunningTask

type RunningTask struct {
	ID          string `json:"id"`
	Type        string `json:"type"`
	Status      string `json:"status"`
	Progress    int    `json:"progress"`
	StartTime   string `json:"start_time"`
	Description string `json:"description"`
}

RunningTask 运行中的任务

type SecurityScanResult

type SecurityScanResult struct {
	Status      string   `json:"status"`
	Issues      []string `json:"issues"`
	LastScanned string   `json:"last_scanned"`
	Passed      bool     `json:"passed"`
	Suggestions []string `json:"suggestions"`
}

SecurityScanResult 安全扫描结果

type SessionData

type SessionData struct {
	SessionID string `json:"session_id"`
	UserID    uint   `json:"user_id"`
	IPAddress string `json:"ip_address"`
	UserAgent string `json:"user_agent"`
	ExpiresAt int64  `json:"expires_at"`
	IsActive  bool   `json:"is_active"`
}

SessionData 会话数据

type ShareFileRequest

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"`
	File        *multipart.FileHeader `json:"-" form:"-"` // 文件内容
	ClientIP    string                `json:"client_ip" form:"client_ip"`
	UserID      *uint                 `json:"user_id" form:"user_id"`
}

ShareFileRequest 文件分享请求结构

type ShareFileResult

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

ShareFileResult 分享文件结果

type ShareStatsData

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

ShareStatsData 分享统计数据

type ShareTextRequest

type ShareTextRequest struct {
	Text        string `json:"text" binding:"required"`
	ExpireValue int    `json:"expire_value"`
	ExpireStyle string `json:"expire_style"`
	RequireAuth bool   `json:"require_auth"`
	ClientIP    string `json:"client_ip"`
	UserID      *uint  `json:"user_id"`
}

ShareTextRequest 文本分享请求结构

type ShareTextResult

type ShareTextResult struct {
	Code      string     `json:"code"`
	ShareURL  string     `json:"share_url"`
	ExpiredAt *time.Time `json:"expired_at"`
}

ShareTextResult 分享文本结果

type ShareUpdateData

type ShareUpdateData struct {
	ExpiredAt    *time.Time `json:"expired_at"`
	ExpiredCount int        `json:"expired_count"`
	RequireAuth  bool       `json:"require_auth"`
}

ShareUpdateData 分享更新数据

type StorageStatus

type StorageStatus struct {
	Type      string             `json:"type"`
	Status    string             `json:"status"`
	Available bool               `json:"available"`
	Details   AdminStorageDetail `json:"details"`
}

StorageStatus 存储状态信息

type StorageTestResult

type StorageTestResult struct {
	Type    string `json:"type"`
	Success bool   `json:"success"`
	Message string `json:"message"`
}

StorageTestResult 存储测试结果

type SystemInfo

type SystemInfo struct {
	OS           string    `json:"os"`
	Architecture string    `json:"architecture"`
	GoVersion    string    `json:"go_version"`
	StartTime    time.Time `json:"start_time"`
	Uptime       string    `json:"uptime"`
}

SystemInfo 系统信息

type SystemStatusData

type SystemStatusData struct {
	Status   string                 `json:"status"`
	Uptime   int64                  `json:"uptime"`
	Memory   map[string]interface{} `json:"memory"`
	Storage  map[string]interface{} `json:"storage"`
	Database map[string]interface{} `json:"database"`
	Services map[string]interface{} `json:"services"`
	Config   map[string]interface{} `json:"config"`
}

SystemStatusData 系统状态数据

type UserFileData

type UserFileData 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"`
}

UserFileData 用户文件数据

type UserFilesResult

type UserFilesResult struct {
	Files []UserFileData `json:"files"`
	Total int64          `json:"total"`
}

UserFilesResult 用户文件查询结果

type UserProfileUpdateData

type UserProfileUpdateData struct {
	Nickname      string `json:"nickname"`
	Avatar        string `json:"avatar"`
	Email         string `json:"email"`
	EmailVerified bool   `json:"email_verified"`
}

UserProfileUpdateData 用户资料更新数据

type UserStatsData

type UserStatsData 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     *time.Time `json:"last_login_at"`
	LastLoginIP     string     `json:"last_login_ip"`
	EmailVerified   bool       `json:"email_verified"`
	Status          string     `json:"status"`
	Role            string     `json:"role"`
	LastUploadAt    *time.Time `json:"last_upload_at"`
	LastDownloadAt  *time.Time `json:"last_download_at"`
}

UserStatsData 用户统计数据

type UserStatsResponse

type UserStatsResponse struct {
	UserID            uint    `json:"user_id"`
	TotalUploads      int64   `json:"total_uploads"`
	TotalDownloads    int64   `json:"total_downloads"`
	TotalStorage      int64   `json:"total_storage"`
	TotalFiles        int64   `json:"total_files"`
	TodayUploads      int64   `json:"today_uploads"`
	MaxUploadSize     int64   `json:"max_upload_size"`
	MaxStorageQuota   int64   `json:"max_storage_quota"`
	StorageUsage      int64   `json:"storage_usage"`
	StoragePercentage float64 `json:"storage_percentage"`
}

UserStatsResponse 用户统计响应