package dto import "time" // BatchUpdatePollingStatusRequest 勾选批量开关轮询请求(卡或设备)。 type BatchUpdatePollingStatusRequest struct { AssetIDs []uint `json:"asset_ids" validate:"required,min=1,max=500,dive,gt=0" minItems:"1" maxItems:"500" description:"资产ID列表(卡ID或设备ID),单次最多500个,不能重复"` EnablePolling *bool `json:"enable_polling" validate:"required" description:"目标状态 (true:开启轮询, false:关闭轮询)"` Reason string `json:"reason" validate:"required,max=500" maxLength:"500" description:"原因,写入不轮询清单"` } // PollingToggleItem 批量开关轮询逐项结果。 type PollingToggleItem struct { AssetID uint `json:"asset_id" description:"资产ID"` Identifier string `json:"identifier" description:"资产标识(卡为 ICCID,设备为 IMEI 或虚拟号)"` Status int `json:"status" description:"结果 (1:成功, 2:跳过, 3:失败, 4:无权限或资产不存在)"` StatusName string `json:"status_name" description:"结果名称"` Reason string `json:"reason" description:"跳过或失败原因"` } // BatchUpdatePollingStatusResponse 批量开关轮询结果。 type BatchUpdatePollingStatusResponse struct { SuccessCount int `json:"success_count" description:"成功数"` SkipCount int `json:"skip_count" description:"跳过数(已是目标状态、风险停机或已销户不能开启)"` FailCount int `json:"fail_count" description:"失败数(含无权限或资产不存在)"` Items []PollingToggleItem `json:"items" description:"逐项结果"` Impact []string `json:"impact" description:"本次目标状态的影响说明"` } // PollingToggleImpactResponse 开关轮询影响说明(供前端确认框展示)。 type PollingToggleImpactResponse struct { Disable []string `json:"disable" description:"关闭轮询的影响"` Enable []string `json:"enable" description:"开启轮询的影响"` } // CardPollingPauseListRequest 不轮询清单查询请求。 type CardPollingPauseListRequest 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:"每页数量"` AssetType string `json:"asset_type" query:"asset_type" validate:"omitempty,oneof=iot_card device" description:"资产类型 (iot_card:卡, device:设备)"` CarrierID *uint `json:"carrier_id" query:"carrier_id" validate:"omitempty,min=1" description:"卡所属运营商账户ID"` Source string `json:"source" query:"source" validate:"omitempty,oneof=single batch import risk_auto cascade order expiry_change alert history" description:"关闭来源 (single:单资产接口, batch:勾选批量, import:文件导入, risk_auto:风险停机或已销户自动关闭, cascade:设备级联, order:支付或下单生效, expiry_change:改有效期, alert:停机被拒告警处理, history:历史数据)"` Status *int `json:"status" query:"status" validate:"omitempty,oneof=1 2" description:"状态 (1:已关闭, 2:已恢复)"` Identifier string `json:"identifier" query:"identifier" validate:"omitempty,max=100" description:"ICCID 或 IMEI(精确)"` OperatorID *uint `json:"operator_id" query:"operator_id" validate:"omitempty,min=1" description:"关闭操作人账号ID"` StartTime string `json:"start_time" query:"start_time" description:"关闭时间起始(带时区的 RFC3339 秒级时间)"` EndTime string `json:"end_time" query:"end_time" description:"关闭时间结束(带时区的 RFC3339 秒级时间)"` } // CardPollingPauseItem 不轮询清单记录。 type CardPollingPauseItem struct { ID uint `json:"id" description:"记录ID"` AssetType string `json:"asset_type" description:"资产类型 (iot_card:卡, device:设备)"` AssetID uint `json:"asset_id" description:"资产ID"` Identifier string `json:"identifier" description:"ICCID 或 IMEI"` CarrierID uint `json:"carrier_id" description:"卡所属运营商账户ID(设备为 0)"` CarrierName string `json:"carrier_name" description:"运营商账户名称"` EnablePolling bool `json:"enable_polling" description:"资产当前轮询开关"` GatewayExtend string `json:"gateway_extend" description:"卡当前网关扩展状态(设备为空)"` Status int `json:"status" description:"状态 (1:已关闭, 2:已恢复)"` StatusName string `json:"status_name" description:"状态名称"` CloseSource string `json:"close_source" description:"关闭来源"` CloseSourceName string `json:"close_source_name" description:"关闭来源名称"` CloseReason string `json:"close_reason" description:"关闭原因"` ClosedBy uint `json:"closed_by" description:"关闭操作人账号ID(系统为 0)"` ClosedByName string `json:"closed_by_name" description:"关闭操作人"` ClosedAt time.Time `json:"closed_at" description:"关闭时间"` ImportTaskID uint `json:"import_task_id" description:"文件导入任务ID(非导入为 0)"` RestoreSource string `json:"restore_source" description:"恢复来源"` RestoreSourceName string `json:"restore_source_name" description:"恢复来源名称"` RestoreReason string `json:"restore_reason" description:"恢复原因"` RestoredBy uint `json:"restored_by" description:"恢复操作人账号ID(系统为 0)"` RestoredByName string `json:"restored_by_name" description:"恢复操作人"` RestoredAt *time.Time `json:"restored_at" description:"恢复时间"` } // CardPollingPausePageResult 不轮询清单分页结果。 type CardPollingPausePageResult struct { Items []CardPollingPauseItem `json:"items" description:"清单记录"` Total int64 `json:"total" description:"总数"` Page int `json:"page" description:"当前页"` PageSize int `json:"size" description:"每页数量"` } // CreatePollingStatusImportRequest 创建轮询开关文件导入任务请求。 type CreatePollingStatusImportRequest struct { FileKey string `json:"file_key" validate:"required,max=500" maxLength:"500" description:"已上传的 CSV 文件 Key(必须以 polling-status-imports/ 开头);首列为 ICCID(卡)或 IMEI/虚拟号(设备),首行为表头"` AssetType string `json:"asset_type" validate:"required,oneof=iot_card device" description:"资产类型 (iot_card:按 ICCID, device:按 IMEI 或虚拟号)"` EnablePolling *bool `json:"enable_polling" validate:"required" description:"目标状态 (true:开启轮询, false:关闭轮询)"` Reason string `json:"reason" validate:"required,max=500" maxLength:"500" description:"原因,写入不轮询清单"` } // PollingStatusImportListRequest 轮询开关导入任务列表请求。 type PollingStatusImportListRequest 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:"每页数量"` Status *int `json:"status" query:"status" validate:"omitempty,oneof=1 2 3 4" description:"任务状态 (1:待处理, 2:处理中, 3:已完成, 4:失败)"` } // PollingStatusImportIDPath 导入任务路径参数。 type PollingStatusImportIDPath struct { ID uint `json:"-" path:"id" required:"true" description:"导入任务ID"` } // PollingStatusImportTaskResponse 轮询开关导入任务。 type PollingStatusImportTaskResponse struct { ID uint `json:"id" description:"任务ID"` TaskNo string `json:"task_no" description:"任务编号"` AssetType string `json:"asset_type" description:"资产类型 (iot_card:卡, device:设备)"` EnablePolling bool `json:"enable_polling" description:"目标状态"` Reason string `json:"reason" description:"原因"` FileName string `json:"file_name" description:"文件名"` Status int `json:"status" description:"任务状态 (1:待处理, 2:处理中, 3:已完成, 4:失败)"` StatusName string `json:"status_name" description:"任务状态名称"` TotalCount int `json:"total_count" description:"数据行数"` SuccessCount int `json:"success_count" description:"成功行数"` SkipCount int `json:"skip_count" description:"跳过行数"` FailCount int `json:"fail_count" description:"失败行数"` ErrorMessage string `json:"error_message" description:"任务级失败原因"` CreatorName string `json:"creator_name" description:"创建人"` CreatedAt time.Time `json:"created_at" description:"创建时间"` StartedAt *time.Time `json:"started_at" description:"开始处理时间"` CompletedAt *time.Time `json:"completed_at" description:"完成时间"` } // PollingStatusImportItemResponse 导入逐行结果。 type PollingStatusImportItemResponse struct { Line int `json:"line" description:"行号(自数据首行起计)"` Identifier string `json:"identifier" description:"ICCID 或 IMEI"` AssetID uint `json:"asset_id" description:"资产ID(未找到为 0)"` Status int `json:"status" description:"结果 (1:成功, 2:跳过, 3:失败, 4:无权限或资产不存在)"` StatusName string `json:"status_name" description:"结果名称"` Reason string `json:"reason" description:"跳过或失败原因"` } // PollingStatusImportTaskDetailResponse 导入任务详情(含逐行结果)。 type PollingStatusImportTaskDetailResponse struct { PollingStatusImportTaskResponse Items []PollingStatusImportItemResponse `json:"items" description:"逐行结果"` } // PollingStatusImportPageResult 导入任务分页结果。 type PollingStatusImportPageResult struct { Items []PollingStatusImportTaskResponse `json:"items" description:"任务列表"` Total int64 `json:"total" description:"总数"` Page int `json:"page" description:"当前页"` PageSize int `json:"size" description:"每页数量"` } // ClosePollingByAlertsRequest 告警页勾选批量关闭轮询请求。 type ClosePollingByAlertsRequest struct { AlertIDs []uint `json:"alert_ids" validate:"required,min=1,max=500,dive,gt=0" minItems:"1" maxItems:"500" description:"告警ID列表,单次最多500个"` Reason string `json:"reason" validate:"required,max=500" maxLength:"500" description:"原因,写入不轮询清单"` }