feat: 不轮询清单与批量开关轮询
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m35s
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:
96
internal/model/card_polling_pause.go
Normal file
96
internal/model/card_polling_pause.go
Normal 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)
|
||||
}
|
||||
@@ -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 卡轮询失败告警分页结果。
|
||||
|
||||
@@ -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过滤(只返回当前授权给该企业的设备)"`
|
||||
|
||||
@@ -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:"任务状态名称(中文)"`
|
||||
|
||||
@@ -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过滤(只返回当前授权给该企业的卡)"`
|
||||
|
||||
154
internal/model/dto/polling_pause_dto.go
Normal file
154
internal/model/dto/polling_pause_dto.go
Normal 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:"原因,写入不轮询清单"`
|
||||
}
|
||||
@@ -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 {
|
||||
|
||||
Reference in New Issue
Block a user