Files
SeeyonFileSystem/server/dto/file_dto.go
2026-07-03 15:58:29 +08:00

137 lines
4.9 KiB
Go

package dto
import "time"
// FileVO 文件视图对象 - 返回给前端
type FileVO struct {
ID uint64 `json:"id"`
Name string `json:"name"`
Extension string `json:"extension"`
FolderID uint64 `json:"folder_id"`
Size int64 `json:"size"`
StorageKey string `json:"storage_key"`
StoragePolicyID uint64 `json:"storage_policy_id"`
MimeType string `json:"mime_type"`
IsFavorite int8 `json:"is_favorite"`
DownloadCount int `json:"download_count"`
Version int `json:"version"` // 乐观锁版本号
DownloadURL string `json:"download_url,omitempty"` // CDN下载链接
PreviewURL string `json:"preview_url,omitempty"` // CDN预览链接
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
}
// FolderVO 文件夹视图对象
type FolderVO struct {
ID uint64 `json:"id"`
Name string `json:"name"`
ParentID uint64 `json:"parent_id"`
Path string `json:"path"`
Version int `json:"version"` // 乐观锁版本号
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
}
// FileListVO 文件列表响应 - 包含文件和文件夹
type FileListVO struct {
Folders []FolderVO `json:"folders"` // 文件夹列表
Files []FileVO `json:"files"` // 文件列表
}
// CreateFolderRequest 创建文件夹请求
type CreateFolderRequest struct {
Name string `json:"name" binding:"required,max=256"` // 文件夹名称
ParentID uint64 `json:"parent_id"` // 父文件夹ID, 0=根目录
}
// RenameRequest 重命名请求
type RenameRequest struct {
NewName string `json:"new_name" binding:"required,max=256"` // 新名称
Version int `json:"version"` // 乐观锁版本号(可选)
}
// MoveRequest 移动请求
type MoveRequest struct {
TargetFolderID uint64 `json:"target_folder_id" binding:"required"` // 目标文件夹ID
}
// ShareCreateRequest 创建分享请求
type ShareCreateRequest struct {
FileID uint64 `json:"file_id" binding:"required"`
Password string `json:"password"`
ExpireHours int `json:"expire_hours"`
MaxDownload int `json:"max_download"`
AllowPreview int `json:"allow_preview"` // 1=允许 0=禁止, 默认1
AllowDownload int `json:"allow_download"` // 1=允许 0=禁止, 默认1
}
// ShareVO 分享视图对象
type ShareVO struct {
ID uint64 `json:"id"`
ShareCode string `json:"share_code"`
ShareURL string `json:"share_url"`
HasPassword bool `json:"has_password"`
ExpireAt *time.Time `json:"expire_at"`
MaxDownload int `json:"max_download"`
DownloadCount int `json:"download_count"`
AllowPreview int8 `json:"allow_preview"`
AllowDownload int8 `json:"allow_download"`
CreatedAt time.Time `json:"created_at"`
}
// ShareVerifyRequest 验证分享密码请求
type ShareVerifyRequest struct {
Password string `json:"password" binding:"required"`
}
// ShareFileVO 分享文件视图对象(公开)
type ShareFileVO struct {
Name string `json:"name"`
Extension string `json:"extension"`
Size int64 `json:"size"`
MimeType string `json:"mime_type"`
PreviewURL string `json:"preview_url"` // 预览链接
AllowPreview bool `json:"allow_preview"`
AllowDownload bool `json:"allow_download"`
CreatedAt time.Time `json:"created_at"`
}
// ========== 分片上传 ==========
// ChunkUploadInitRequest 初始化分片上传请求
type ChunkUploadInitRequest struct {
FileName string `json:"file_name" binding:"required"`
FileSize int64 `json:"file_size" binding:"required"`
MD5 string `json:"md5"` // 客户端计算的MD5(可选, 用于秒传)
FolderID uint64 `json:"folder_id"`
PolicyID uint64 `json:"policy_id"` // 存储策略ID
}
// ChunkUploadInitVO 初始化分片上传响应
type ChunkUploadInitVO struct {
UploadID string `json:"upload_id"` // 上传会话ID
Instant bool `json:"instant"` // 是否秒传
FileID uint64 `json:"file_id"` // 秒传时返回文件ID
ChunkSize int64 `json:"chunk_size"` // 分片大小
Total int `json:"total"` // 总分片数
}
// ChunkUploadChunkVO 单分片上传响应
type ChunkUploadChunkVO struct {
Index int `json:"index"`
Size int64 `json:"size"`
Status string `json:"status"` // ok / exists
}
// ChunkUploadProgressVO 上传进度响应
type ChunkUploadProgressVO struct {
UploadID string `json:"upload_id"`
FileName string `json:"file_name"`
FileSize int64 `json:"file_size"`
ChunkSize int64 `json:"chunk_size"`
TotalChunks int `json:"total_chunks"`
Uploaded int `json:"uploaded"`
Missing []int `json:"missing"` // 未上传的分片索引
Status int8 `json:"status"` // 1=上传中 2=已完成 3=已取消
}