实现七月迭代公共技术基础

internal/model/dto/export_task_dto.go

@@ -31,6 +31,7 @@ type ListExportTaskRequest struct {
 // ExportTaskItem 导出任务列表项。
 type ExportTaskItem struct {
 	ID                  uint       `json:"id" description:"任务ID"`
+	TaskID              uint       `json:"task_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)"`
@@ -42,10 +43,16 @@ type ExportTaskItem struct {
 	TotalShards         int        `json:"total_shards" description:"总分片数"`
 	SuccessShards       int        `json:"success_shards" description:"成功分片数"`
 	FailedShards        int        `json:"failed_shards" description:"失败分片数"`
+	TotalCount          int        `json:"total_count" description:"统一任务总数"`
+	SuccessCount        int        `json:"success_count" description:"统一任务成功数"`
+	FailedCount         int        `json:"failed_count" description:"统一任务失败数"`
 	CancelRequested     bool       `json:"cancel_requested" description:"是否已请求取消"`
 	FileKey             string     `json:"file_key,omitempty" description:"导出文件Key"`
 	ErrorMessage        string     `json:"error_message,omitempty" description:"错误信息"`
+	ErrorCode           string     `json:"error_code,omitempty" description:"安全错误码"`
+	ErrorSummary        string     `json:"error_summary,omitempty" description:"安全失败摘要"`
 	CreatedAt           time.Time  `json:"created_at" description:"创建时间"`
+	UpdatedAt           time.Time  `json:"updated_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"`

internal/model/dto/system_config_dto.go

@@ -0,0 +1,46 @@
+package dto
+
+import "time"
+
+// SystemConfigListRequest 是系统配置分页查询参数。
+type SystemConfigListRequest struct {
+	Module   string `json:"module" query:"module" validate:"omitempty,max=100" description:"模块筛选"`
+	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:"每页数量"`
+}
+
+// SystemConfigItem 是超级管理员可见的受控配置投影。
+type SystemConfigItem struct {
+	ConfigKey   string     `json:"config_key" description:"稳定配置 Key"`
+	Value       string     `json:"value" description:"配置值；敏感值按注册策略脱敏"`
+	ValueType   string     `json:"value_type" description:"值类型 (string:字符串, int:整数, bool:布尔, json:JSON)"`
+	Module      string     `json:"module" description:"所属模块"`
+	Description string     `json:"description" description:"中文说明"`
+	Readonly    bool       `json:"readonly" description:"是否只读"`
+	Sensitive   bool       `json:"sensitive" description:"是否敏感"`
+	Registered  bool       `json:"registered" description:"是否已在代码注册"`
+	Control     string     `json:"control" description:"前端控件提示"`
+	EnumValues  []string   `json:"enum_values,omitempty" description:"允许的枚举值"`
+	Min         *int64     `json:"min,omitempty" description:"整数最小值"`
+	Max         *int64     `json:"max,omitempty" description:"整数最大值"`
+	UpdatedAt   *time.Time `json:"updated_at,omitempty" description:"最近更新时间"`
+}
+
+// SystemConfigListResponse 是系统配置分页结果。
+type SystemConfigListResponse struct {
+	List     []SystemConfigItem `json:"list" description:"配置列表"`
+	Total    int64              `json:"total" description:"总数量"`
+	Page     int                `json:"page" description:"页码"`
+	PageSize int                `json:"page_size" description:"每页数量"`
+}
+
+// UpdateSystemConfigRequest 是单 Key 更新请求。
+type UpdateSystemConfigRequest struct {
+	Value string `json:"value" validate:"required" required:"true" description:"字符串化配置值"`
+}
+
+// UpdateSystemConfigParams 组合路径和请求体文档参数。
+type UpdateSystemConfigParams struct {
+	Key string `json:"key" path:"key" validate:"required" required:"true" description:"稳定配置 Key"`
+	UpdateSystemConfigRequest
+}