package dto import "time" // CreateExportTaskRequest 创建导出任务请求。 type CreateExportTaskRequest struct { Scene string `json:"scene" validate:"required,oneof=device iot_card order" required:"true" description:"导出场景 (device:设备, iot_card:IoT卡, order:订单)"` Format string `json:"format" validate:"required,oneof=xlsx csv" required:"true" description:"导出格式 (xlsx:Excel, csv:CSV)"` Query map[string]interface{} `json:"query,omitempty" description:"导出筛选参数(JSON对象,可选)"` } // CreateExportTaskResponse 创建导出任务响应。 type CreateExportTaskResponse struct { TaskID uint `json:"task_id" description:"导出任务ID"` TaskNo string `json:"task_no" description:"任务编号"` Status int `json:"status" description:"任务状态 (1:待处理, 2:处理中, 3:已完成, 4:已失败, 5:已取消)"` StatusName string `json:"status_name" description:"任务状态名称(中文)"` Message string `json:"message" description:"提示信息"` } // ListExportTaskRequest 导出任务列表请求。 type ListExportTaskRequest struct { Page int `json:"page" query:"page" validate:"omitempty,min=1" minimum:"1" description:"页码"` PageSize int `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" minimum:"1" maximum:"100" description:"每页数量"` Scene string `json:"scene" query:"scene" validate:"omitempty,oneof=device iot_card order" description:"导出场景 (device:设备, iot_card:IoT卡, order:订单)"` Status *int `json:"status" query:"status" validate:"omitempty,min=1,max=5" minimum:"1" maximum:"5" description:"任务状态 (1:待处理, 2:处理中, 3:已完成, 4:已失败, 5:已取消)"` StartTime *time.Time `json:"start_time" query:"start_time" description:"创建时间起始"` EndTime *time.Time `json:"end_time" query:"end_time" description:"创建时间结束"` } // ExportTaskItem 导出任务列表项。 type ExportTaskItem struct { ID uint `json:"id" description:"任务ID"` TaskNo string `json:"task_no" description:"任务编号"` Scene string `json:"scene" description:"导出场景 (device:设备, iot_card:IoT卡, order:订单)"` Format string `json:"format" description:"导出格式 (xlsx:Excel, csv:CSV)"` Status int `json:"status" description:"任务状态 (1:待处理, 2:处理中, 3:已完成, 4:已失败, 5:已取消)"` StatusName string `json:"status_name" description:"任务状态名称(中文)"` Progress int `json:"progress" description:"任务进度(0-100)"` TotalRows int `json:"total_rows" description:"总行数"` ProcessedRows int `json:"processed_rows" description:"已处理行数"` TotalShards int `json:"total_shards" description:"总分片数"` SuccessShards int `json:"success_shards" description:"成功分片数"` FailedShards int `json:"failed_shards" description:"失败分片数"` CancelRequested bool `json:"cancel_requested" description:"是否已请求取消"` FileKey string `json:"file_key,omitempty" description:"导出文件Key"` ErrorMessage string `json:"error_message,omitempty" description:"错误信息"` CreatedAt time.Time `json:"created_at" description:"创建时间"` StartedAt *time.Time `json:"started_at,omitempty" description:"开始处理时间"` CompletedAt *time.Time `json:"completed_at,omitempty" description:"完成时间"` CreatorUserID uint `json:"creator_user_id" description:"创建人用户ID"` CreatorUserType int `json:"creator_user_type" description:"创建人用户类型 (2:平台, 3:代理, 4:企业)"` CreatorShopID *uint `json:"creator_shop_id,omitempty" description:"创建人店铺ID"` CreatorEnterpriseID *uint `json:"creator_enterprise_id,omitempty" description:"创建人企业ID"` } // ListExportTaskResponse 导出任务列表响应。 type ListExportTaskResponse struct { List []*ExportTaskItem `json:"items" description:"任务列表"` Total int64 `json:"total" description:"总数"` Page int `json:"page" description:"当前页码"` PageSize int `json:"size" description:"每页数量"` } // GetExportTaskRequest 导出任务详情请求。 type GetExportTaskRequest struct { ID uint `path:"id" description:"任务ID" required:"true"` } // ExportTaskDetailResponse 导出任务详情响应。 type ExportTaskDetailResponse struct { ExportTaskItem DownloadURL string `json:"download_url,omitempty" description:"下载链接(仅已完成任务返回)"` DownloadExpiresAt *time.Time `json:"download_expires_at,omitempty" description:"下载链接过期时间"` } // CancelExportTaskRequest 取消导出任务请求。 type CancelExportTaskRequest struct { ID uint `path:"id" description:"任务ID" required:"true"` } // CancelExportTaskResponse 取消导出任务响应。 type CancelExportTaskResponse struct { TaskID uint `json:"task_id" description:"任务ID"` Status int `json:"status" description:"任务状态 (1:待处理, 2:处理中, 3:已完成, 4:已失败, 5:已取消)"` StatusName string `json:"status_name" description:"任务状态名称(中文)"` CancelRequested bool `json:"cancel_requested" description:"是否已请求取消"` Message string `json:"message" description:"提示信息"` }