chore: document v1 dto fields

backend/app/http/v1/dto/upload.go

@@ -1,24 +1,35 @@
 package dto
 
 type UploadInitForm struct {
-	Hash     string `json:"hash"`
-	Size     int64  `json:"size"`
+	// Hash 文件哈希（用于秒传校验）。
+	Hash string `json:"hash"`
+	// Size 文件大小（字节）。
+	Size int64 `json:"size"`
+	// Filename 原始文件名。
 	Filename string `json:"filename"`
+	// MimeType 文件类型（如 image/png）。
 	MimeType string `json:"mime_type"`
-	Type     string `json:"type"`
+	// Type 业务类型（如 cover/media/avatar）。
+	Type string `json:"type"`
 }
 
 type UploadInitResponse struct {
-	UploadID  string `json:"upload_id"`
-	Key       string `json:"key"` // For S3 direct
-	ChunkSize int64  `json:"chunk_size"`
+	// UploadID 分片上传ID。
+	UploadID string `json:"upload_id"`
+	// Key 对象存储Key（S3 直传使用）。
+	Key string `json:"key"`
+	// ChunkSize 分片大小（字节）。
+	ChunkSize int64 `json:"chunk_size"`
 }
 
 type UploadPartForm struct {
-	UploadID   string `form:"upload_id"`
-	PartNumber int    `form:"part_number"`
+	// UploadID 分片上传ID。
+	UploadID string `form:"upload_id"`
+	// PartNumber 分片序号（从 1 开始）。
+	PartNumber int `form:"part_number"`
 }
 
 type UploadCompleteForm struct {
+	// UploadID 分片上传ID。
 	UploadID string `json:"upload_id"`
 }