feat: 不轮询清单与批量开关轮询
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m35s

- 新增不轮询清单 tb_card_polling_pause(迁移 000256 补写存量),所有改 enable_polling 的入口同事务写清单
- 卡、设备勾选批量开关轮询(单次 500,逐项结果,开启跳过风险停机与已销户)与 CSV 文件导入
- 订单套餐生效、改有效期后自动恢复轮询并按规则评估复机
- 不轮询清单查询与导出;卡、设备列表与导出增加是否轮询
- 失败告警停机被拒视图、导出与批量关闭轮询;开关轮询影响说明

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
邹进
2026-10-26 03:07:20 +09:00
parent a4e3fe4d8f
commit 7ddb9312e3
45 changed files with 2250 additions and 50 deletions

View File

@@ -0,0 +1,96 @@
package model
import (
"database/sql/driver"
"time"
"github.com/bytedance/sonic"
)
// CardPollingPause 不轮询清单记录:同一资产只有一条已关闭记录,恢复后保留历史。调度不读本表。
type CardPollingPause struct {
ID uint `gorm:"column:id;primaryKey" json:"id"`
AssetType string `gorm:"column:asset_type;type:varchar(20);not null" json:"asset_type"`
AssetID uint `gorm:"column:asset_id;not null" json:"asset_id"`
Identifier string `gorm:"column:identifier;type:varchar(100);not null;default:''" json:"identifier"`
CarrierID uint `gorm:"column:carrier_id;not null;default:0" json:"carrier_id"`
Status int `gorm:"column:status;type:smallint;not null;default:1" json:"status"`
CloseSource string `gorm:"column:close_source;type:varchar(30);not null" json:"close_source"`
CloseReason string `gorm:"column:close_reason;type:varchar(500);not null;default:''" json:"close_reason"`
ClosedBy uint `gorm:"column:closed_by;not null;default:0" json:"closed_by"`
ClosedAt time.Time `gorm:"column:closed_at;not null" json:"closed_at"`
ImportTaskID uint `gorm:"column:import_task_id;not null;default:0" json:"import_task_id"`
RestoreSource string `gorm:"column:restore_source;type:varchar(30);not null;default:''" json:"restore_source"`
RestoreReason string `gorm:"column:restore_reason;type:varchar(500);not null;default:''" json:"restore_reason"`
RestoredBy uint `gorm:"column:restored_by;not null;default:0" json:"restored_by"`
RestoredAt *time.Time `gorm:"column:restored_at" json:"restored_at"`
CreatedAt time.Time `gorm:"column:created_at" json:"created_at"`
UpdatedAt time.Time `gorm:"column:updated_at" json:"updated_at"`
}
// TableName 返回不轮询清单表名。
func (CardPollingPause) TableName() string {
return "tb_card_polling_pause"
}
// PollingStatusImportTask 轮询开关文件导入任务。
type PollingStatusImportTask struct {
ID uint `gorm:"column:id;primaryKey" json:"id"`
TaskNo string `gorm:"column:task_no;type:varchar(50);not null" json:"task_no"`
AssetType string `gorm:"column:asset_type;type:varchar(20);not null" json:"asset_type"`
EnablePolling bool `gorm:"column:enable_polling;not null" json:"enable_polling"`
Reason string `gorm:"column:reason;type:varchar(500);not null;default:''" json:"reason"`
FileName string `gorm:"column:file_name;type:varchar(255);not null;default:''" json:"file_name"`
StorageKey string `gorm:"column:storage_key;type:varchar(500);not null" json:"storage_key"`
Status int `gorm:"column:status;not null;default:1" json:"status"`
TotalCount int `gorm:"column:total_count;not null;default:0" json:"total_count"`
SuccessCount int `gorm:"column:success_count;not null;default:0" json:"success_count"`
SkipCount int `gorm:"column:skip_count;not null;default:0" json:"skip_count"`
FailCount int `gorm:"column:fail_count;not null;default:0" json:"fail_count"`
ResultItems PollingStatusImportResults `gorm:"column:result_items;type:jsonb;not null;default:'[]'" json:"result_items"`
ErrorMessage string `gorm:"column:error_message;type:text;not null;default:''" json:"error_message"`
Creator uint `gorm:"column:creator;not null;default:0" json:"creator"`
CreatorName string `gorm:"column:creator_name;type:varchar(100);not null;default:''" json:"creator_name"`
StartedAt *time.Time `gorm:"column:started_at" json:"started_at"`
CompletedAt *time.Time `gorm:"column:completed_at" json:"completed_at"`
CreatedAt time.Time `gorm:"column:created_at" json:"created_at"`
UpdatedAt time.Time `gorm:"column:updated_at" json:"updated_at"`
}
// TableName 返回轮询开关导入任务表名。
func (PollingStatusImportTask) TableName() string {
return "tb_polling_status_import_task"
}
// PollingStatusImportResultItem 导入单行结果;行号自数据首行起计。
type PollingStatusImportResultItem struct {
Line int `json:"line"`
Identifier string `json:"identifier"`
AssetID uint `json:"asset_id,omitempty"`
Status int `json:"status"`
Reason string `json:"reason,omitempty"`
}
// PollingStatusImportResults 导入逐行结果集合。
type PollingStatusImportResults []PollingStatusImportResultItem
// Value 将逐行结果序列化为 JSONB。
func (items PollingStatusImportResults) Value() (driver.Value, error) {
if items == nil {
return "[]", nil
}
return sonic.Marshal(items)
}
// Scan 从 JSONB 读取逐行结果。
func (items *PollingStatusImportResults) Scan(value any) error {
if value == nil {
*items = PollingStatusImportResults{}
return nil
}
data, ok := value.([]byte)
if !ok {
return nil
}
return sonic.Unmarshal(data, items)
}

View File

@@ -67,7 +67,8 @@ type PollingFailureAlertListRequest 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:"每页数量"`
CarrierID *uint `json:"carrier_id" query:"carrier_id" validate:"omitempty,min=1" description:"运营商账户ID"`
CheckType string `json:"check_type" query:"check_type" validate:"omitempty,oneof=card_status carddata realname package all" description:"检查类型 (card_status:卡状态, carddata:流量, realname:实名, package:套餐, all:账户级)"`
CheckType string `json:"check_type" query:"check_type" validate:"omitempty,oneof=card_status carddata realname package stop_resume all" description:"检查类型 (card_status:卡状态, carddata:流量, realname:实名, package:套餐, stop_resume:停复机, all:账户级)"`
View string `json:"view" query:"view" validate:"omitempty,oneof=stop_refused" description:"视图 (stop_refused:停机被拒:停复机方向为停机,且错误类型为终态或业务错误、或停机失败次数达到阈值)"`
ErrorCategory string `json:"error_category" query:"error_category" validate:"omitempty,max=50" description:"错误类别"`
Status *int `json:"status" query:"status" validate:"omitempty,oneof=1 2 3 4" description:"状态 (1:未处理, 2:已恢复, 3:已关闭轮询, 4:已处理)"`
AlertLevel string `json:"alert_level" query:"alert_level" validate:"omitempty,oneof=card carrier" description:"告警级别 (card:卡级, carrier:账户级)"`
@@ -98,6 +99,14 @@ type PollingFailureAlertItem struct {
HandleRemark string `json:"handle_remark" description:"处理备注"`
RecoveredAt *time.Time `json:"recovered_at" description:"自动恢复时间"`
CreatedAt time.Time `json:"created_at" description:"创建时间"`
// 以下字段仅在停机被拒视图(view=stop_refused)返回。
DeviceID *uint `json:"device_id,omitempty" description:"卡绑定的设备ID(停机被拒视图)"`
NetworkStatus *int `json:"network_status,omitempty" description:"卡当前网络状态 (0:停机, 1:开机)(停机被拒视图)"`
StopReason string `json:"stop_reason,omitempty" description:"卡当前停机原因(停机被拒视图)"`
EnablePolling *bool `json:"enable_polling,omitempty" description:"卡当前是否轮询(停机被拒视图)"`
HasPackage *bool `json:"has_package,omitempty" description:"资产是否有生效中主套餐(停机被拒视图)"`
HandledByName string `json:"handled_by_name,omitempty" description:"处理人(停机被拒视图)"`
}
// PollingFailureAlertPageResult 卡轮询失败告警分页结果。

View File

@@ -19,6 +19,7 @@ type ListDeviceRequest struct {
Manufacturer string `json:"manufacturer" query:"manufacturer" validate:"omitempty,max=255" maxLength:"255" description:"制造商(模糊查询)"`
CreatedAtStart *time.Time `json:"created_at_start" query:"created_at_start" description:"创建时间起始"`
CreatedAtEnd *time.Time `json:"created_at_end" query:"created_at_end" description:"创建时间结束"`
EnablePolling *bool `json:"enable_polling" query:"enable_polling" description:"是否轮询 (true:轮询中, false:已关闭轮询, 不传:不过滤)"`
HasActivePackage *bool `json:"has_active_package" query:"has_active_package" description:"是否有生效中的套餐(true:有生效中主套餐, false:无生效中主套餐)"`
Keyword string `json:"keyword" query:"keyword" validate:"omitempty,max=100" maxLength:"100" description:"关键字搜索,匹配虚拟号或IMEI(模糊查询,与virtual_no/imei独立)"`
AuthorizedEnterpriseID *uint `json:"authorized_enterprise_id" query:"authorized_enterprise_id" description:"按有效授权企业ID过滤(只返回当前授权给该企业的设备)"`

View File

@@ -4,7 +4,7 @@ import "time"
// CreateExportTaskRequest 创建导出任务请求。
type CreateExportTaskRequest struct {
Scene string `json:"scene" validate:"required,oneof=device iot_card order package agent_wallet_transaction agent_recharge refund exchange commission_record package_traffic_alert expiring_asset operations_activation operations_renewal stop_resume_rule_dry_run" required:"true" description:"导出场景 (device:设备, iot_card:IoT卡, order:订单, package:套餐, agent_wallet_transaction:代理主钱包流水, agent_recharge:代理充值, refund:退款, exchange:换货, commission_record:佣金明细, package_traffic_alert:套餐真流量达量预警, expiring_asset:临期资产, operations_activation:设备激活情况报表, operations_renewal:套餐续费情况报表, stop_resume_rule_dry_run:停复机规则演练明细)"`
Scene string `json:"scene" validate:"required,oneof=device iot_card order package agent_wallet_transaction agent_recharge refund exchange commission_record package_traffic_alert expiring_asset operations_activation operations_renewal stop_resume_rule_dry_run polling_pause polling_stop_refused_alert" required:"true" description:"导出场景 (device:设备, iot_card:IoT卡, order:订单, package:套餐, agent_wallet_transaction:代理主钱包流水, agent_recharge:代理充值, refund:退款, exchange:换货, commission_record:佣金明细, package_traffic_alert:套餐真流量达量预警, expiring_asset:临期资产, operations_activation:设备激活情况报表, operations_renewal:套餐续费情况报表, stop_resume_rule_dry_run:停复机规则演练明细, polling_pause:不轮询清单, polling_stop_refused_alert:停机被拒告警)"`
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对象,可选);时间筛选固定使用 filters.start_time 与 filters.end_time,取值必须为带显式时区的 RFC3339 秒级时间"`
}
@@ -22,7 +22,7 @@ type CreateExportTaskResponse struct {
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 package agent_wallet_transaction agent_recharge refund exchange commission_record package_traffic_alert expiring_asset operations_activation operations_renewal stop_resume_rule_dry_run" description:"导出场景 (device:设备, iot_card:IoT卡, order:订单, package:套餐, agent_wallet_transaction:代理主钱包流水, agent_recharge:代理充值, refund:退款, exchange:换货, commission_record:佣金明细, package_traffic_alert:套餐真流量达量预警, expiring_asset:临期资产, operations_activation:设备激活情况报表, operations_renewal:套餐续费情况报表, stop_resume_rule_dry_run:停复机规则演练明细)"`
Scene string `json:"scene" query:"scene" validate:"omitempty,oneof=device iot_card order package agent_wallet_transaction agent_recharge refund exchange commission_record package_traffic_alert expiring_asset operations_activation operations_renewal stop_resume_rule_dry_run polling_pause polling_stop_refused_alert" description:"导出场景 (device:设备, iot_card:IoT卡, order:订单, package:套餐, agent_wallet_transaction:代理主钱包流水, agent_recharge:代理充值, refund:退款, exchange:换货, commission_record:佣金明细, package_traffic_alert:套餐真流量达量预警, expiring_asset:临期资产, operations_activation:设备激活情况报表, operations_renewal:套餐续费情况报表, stop_resume_rule_dry_run:停复机规则演练明细, polling_pause:不轮询清单, polling_stop_refused_alert:停机被拒告警)"`
Status *int `json:"status" query:"status" validate:"omitempty,min=1,max=5" minimum:"1" maximum:"5" description:"任务状态 (1:待处理, 2:处理中, 3:已完成, 4:已失败, 5:已取消)"`
StartTime string `json:"start_time" query:"start_time" description:"创建时间起始(带时区的 RFC3339 秒级时间,闭区间含该时刻,如 2026-09-01T00:00:00+08:00)"`
EndTime string `json:"end_time" query:"end_time" description:"创建时间结束(带时区的 RFC3339 秒级时间,闭区间含该时刻,如 2026-09-30T23:59:59+08:00)"`
@@ -33,7 +33,7 @@ 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:订单, package:套餐, agent_wallet_transaction:代理主钱包流水, agent_recharge:代理充值, refund:退款, exchange:换货, commission_record:佣金明细, package_traffic_alert:套餐真流量达量预警, operations_activation:设备激活情况报表, operations_renewal:套餐续费情况报表, stop_resume_rule_dry_run:停复机规则演练明细)"`
Scene string `json:"scene" description:"导出场景 (device:设备, iot_card:IoT卡, order:订单, package:套餐, agent_wallet_transaction:代理主钱包流水, agent_recharge:代理充值, refund:退款, exchange:换货, commission_record:佣金明细, package_traffic_alert:套餐真流量达量预警, operations_activation:设备激活情况报表, operations_renewal:套餐续费情况报表, stop_resume_rule_dry_run:停复机规则演练明细, polling_pause:不轮询清单, polling_stop_refused_alert:停机被拒告警)"`
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:"任务状态名称(中文)"`

View File

@@ -23,6 +23,7 @@ type ListStandaloneIotCardRequest struct {
ICCIDEnd string `json:"iccid_end" query:"iccid_end" validate:"omitempty,max=20" maxLength:"20" description:"ICCID结束号"`
CarrierName string `json:"carrier_name" query:"carrier_name" validate:"omitempty,max=100" maxLength:"100" description:"运营商名称(模糊查询)"`
Keyword string `json:"keyword" query:"keyword" validate:"omitempty,max=100" maxLength:"100" description:"关键字搜索,匹配ICCID或卡虚拟号(模糊查询,与iccid/virtual_no独立)"`
EnablePolling *bool `json:"enable_polling" query:"enable_polling" description:"是否轮询 (true:轮询中, false:已关闭轮询, 不传:不过滤)"`
NetworkStatus *int `json:"network_status" query:"network_status" validate:"omitempty,min=0,max=1" minimum:"0" maximum:"1" description:"网络状态 (0:停机, 1:开机)"`
RealNameStatus *int `json:"real_name_status" query:"real_name_status" validate:"omitempty,min=0,max=1" minimum:"0" maximum:"1" description:"实名状态 (0:未实名, 1:已实名)"`
AuthorizedEnterpriseID *uint `json:"authorized_enterprise_id" query:"authorized_enterprise_id" description:"按有效授权企业ID过滤(只返回当前授权给该企业的卡)"`

View File

@@ -0,0 +1,154 @@
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:"原因,写入不轮询清单"`
}

View File

@@ -3,7 +3,7 @@ package dto
type GetUploadURLRequest struct {
FileName string `json:"file_name" validate:"required,min=1,max=255" required:"true" minLength:"1" maxLength:"255" description:"文件名(如:cards.csv)"`
ContentType string `json:"content_type" validate:"omitempty,max=100" maxLength:"100" description:"文件 MIME 类型(如:text/csv),留空则自动推断"`
Purpose string `json:"purpose" validate:"required,oneof=iot_import export attachment batch_purchase device_batch_allocation shop_import phone_unbind_import" required:"true" enum:"iot_import,export,attachment,batch_purchase,device_batch_allocation,shop_import,phone_unbind_import" description:"文件用途 (iot_import:ICCID导入, export:数据导出, attachment:附件, batch_purchase:资产套餐批量订购CSV, device_batch_allocation:设备批量分配或回收CSV, shop_import:店铺负责人导入CSV, phone_unbind_import:手机号资产解绑导入CSV)"`
Purpose string `json:"purpose" validate:"required,oneof=iot_import export attachment batch_purchase device_batch_allocation shop_import phone_unbind_import polling_status_import" required:"true" enum:"iot_import,export,attachment,batch_purchase,device_batch_allocation,shop_import,phone_unbind_import,polling_status_import" description:"文件用途 (iot_import:ICCID导入, export:数据导出, attachment:附件, batch_purchase:资产套餐批量订购CSV, device_batch_allocation:设备批量分配或回收CSV, shop_import:店铺负责人导入CSV, phone_unbind_import:手机号资产解绑导入CSV, polling_status_import:轮询开关导入CSV)"`
}
type GetUploadURLResponse struct {