统一导出任务

2026-04-27 09:47:03 +08:00
parent 531de3c760
commit 60debb7505
29 changed files with 2580 additions and 0 deletions
--- a/internal/model/dto/export_task_dto.go
+++ b/internal/model/dto/export_task_dto.go
@@ -0,0 +1,89 @@
+package dto
+
+import "time"
+
+// CreateExportTaskRequest 创建导出任务请求。
+type CreateExportTaskRequest struct {
+	Scene  string                 `json:"scene" validate:"required,oneof=device iot_card" required:"true" description:"导出场景 (device:设备, iot_card:IoT卡)"`
+	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" description:"导出场景 (device:设备, iot_card:IoT卡)"`
+	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卡)"`
+	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:"提示信息"`
+}