Files
junhong_cmp_fiber/internal/model/dto/carrier_polling_dto.go
邹进 7ddb9312e3
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m35s
feat: 不轮询清单与批量开关轮询
- 新增不轮询清单 tb_card_polling_pause(迁移 000256 补写存量),所有改 enable_polling 的入口同事务写清单
- 卡、设备勾选批量开关轮询(单次 500,逐项结果,开启跳过风险停机与已销户)与 CSV 文件导入
- 订单套餐生效、改有效期后自动恢复轮询并按规则评估复机
- 不轮询清单查询与导出;卡、设备列表与导出增加是否轮询
- 失败告警停机被拒视图、导出与批量关闭轮询;开关轮询影响说明

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 03:07:20 +09:00

223 lines
18 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package dto
import "time"
// CarrierPollingParamItem 运营商账户调度参数(含全局默认合并后的生效值)。
type CarrierPollingParamItem struct {
CarrierID uint `json:"carrier_id" description:"运营商账户ID"`
CarrierName string `json:"carrier_name" description:"运营商账户名称"`
IsDefault bool `json:"is_default" description:"是否未单独配置、全部使用全局默认"`
InflightLimit int `json:"inflight_limit" description:"生效的执行上限(跨 Worker 实例同时执行卡任务数)"`
CardMaxInFlight int `json:"card_max_in_flight" description:"生效的每进程卡任务 max_in_flight"`
PriorityMaxRatio *float64 `json:"priority_max_ratio" description:"优先队列每轮最大占比(0~1),空表示不限"`
StopResumeMaxInFlight *int `json:"stop_resume_max_in_flight" description:"每进程停复机 max_in_flight(停复机指令队列使用),空表示默认"`
SRInflightLimit *int `json:"sr_inflight_limit" description:"停复机执行上限(停复机指令队列使用),空表示默认"`
StopResumeMinInterval *int `json:"stop_resume_min_interval" description:"单卡两次停复机调用最小间隔(秒),空表示默认"`
StopResumeConfirmDelay *int `json:"stop_resume_confirm_delay" description:"停复机结果未知后确认延迟(秒),空表示默认"`
ConfiguredInflight *int `json:"configured_inflight_limit" description:"单独配置的执行上限,空表示使用默认"`
ConfiguredMaxInFlight *int `json:"configured_card_max_in_flight" description:"单独配置的每进程 max_in_flight,空表示使用默认"`
ConsumeCapacity int `json:"consume_capacity" description:"当前订阅进程 max_in_flight 之和(执行上限不应超过该值)"`
}
// CarrierPollingParamListResponse 运营商账户调度参数列表。
type CarrierPollingParamListResponse struct {
Items []CarrierPollingParamItem `json:"items" description:"各运营商账户调度参数"`
SubscriberProcesses int `json:"subscriber_processes" description:"订阅卡任务的 Worker 进程数"`
DefaultInflight int `json:"default_inflight_limit" description:"全局默认执行上限"`
DefaultMaxInFlight int `json:"default_card_max_in_flight" description:"全局默认每进程 max_in_flight"`
}
// CarrierPollingParamPath 运营商账户路径参数。
type CarrierPollingParamPath struct {
CarrierID uint `json:"-" path:"carrier_id" required:"true" description:"运营商账户ID"`
}
// SaveCarrierPollingParamRequest 保存运营商账户调度参数;字段为空表示该项使用全局默认。
type SaveCarrierPollingParamRequest struct {
CarrierID uint `json:"-" path:"carrier_id" required:"true" description:"运营商账户ID"`
InflightLimit *int `json:"inflight_limit" validate:"omitempty,min=1,max=10000" minimum:"1" maximum:"10000" description:"执行上限,空表示默认"`
CardMaxInFlight *int `json:"card_max_in_flight" validate:"omitempty,min=1,max=2000" minimum:"1" maximum:"2000" description:"每进程卡任务 max_in_flight,空表示默认"`
StopResumeMaxInFlight *int `json:"stop_resume_max_in_flight" validate:"omitempty,min=1,max=1000" minimum:"1" maximum:"1000" description:"每进程停复机 max_in_flight,空表示默认"`
SRInflightLimit *int `json:"sr_inflight_limit" validate:"omitempty,min=1,max=10000" minimum:"1" maximum:"10000" description:"停复机执行上限,空表示默认"`
PriorityMaxRatio *float64 `json:"priority_max_ratio" validate:"omitempty,gt=0,lte=1" description:"优先队列每轮最大占比(0~1],空表示不限"`
StopResumeMinInterval *int `json:"stop_resume_min_interval" validate:"omitempty,min=1,max=86400" minimum:"1" maximum:"86400" description:"单卡停复机最小间隔(秒),空表示默认"`
StopResumeConfirmDelay *int `json:"stop_resume_confirm_delay" validate:"omitempty,min=1,max=86400" minimum:"1" maximum:"86400" description:"停复机结果未知确认延迟(秒),空表示默认"`
}
// PollingCheckSceneItem 请求检查场景。
type PollingCheckSceneItem struct {
Scene string `json:"scene" description:"场景编码 (order_paid:订单支付, package_activated:套餐激活, stop_resume_succeeded:停复机成功, device_operation:设备操作, auto_renewal_purchase:自动续费购包, client_asset_detail:C 端资产详情, admin_asset_realtime:后台资产实时状态, realname_link:实名链接)"`
SceneName string `json:"scene_name" description:"场景名称"`
CheckTypes []string `json:"check_types" description:"检查类型 (card_status:卡状态, carddata:流量, realname:实名)"`
ConfirmDelays []int `json:"confirm_delays" description:"延迟确认序列(秒),空表示只立即检查一次"`
Cooldown *int `json:"cooldown" description:"冷却时长(秒),最近一次成功检查未超过该时长则不请求;空表示不冷却"`
UpdatedAt time.Time `json:"updated_at" description:"更新时间"`
}
// UpdatePollingCheckSceneRequest 修改请求检查场景(场景由代码预置,只可改检查类型、确认延迟与冷却)。
type UpdatePollingCheckSceneRequest struct {
Scene string `json:"-" path:"scene" required:"true" description:"场景编码"`
CheckTypes []string `json:"check_types" validate:"required,min=1,max=3,dive,oneof=card_status carddata realname" required:"true" description:"检查类型 (card_status:卡状态, carddata:流量, realname:实名)"`
ConfirmDelays []int `json:"confirm_delays" validate:"omitempty,max=5,dive,min=1,max=86400" description:"延迟确认序列(秒,递增),空表示只立即检查一次"`
Cooldown *int `json:"cooldown" validate:"omitempty,min=1,max=86400" minimum:"1" maximum:"86400" description:"冷却时长(秒),空表示不冷却"`
}
// PollingFailureAlertListRequest 卡轮询失败告警列表请求。
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 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:账户级)"`
ICCID string `json:"iccid" query:"iccid" validate:"omitempty,max=30" description:"ICCID(精确)"`
StartTime string `json:"start_time" query:"start_time" description:"最近失败时间起始(带时区的 RFC3339 秒级时间)"`
EndTime string `json:"end_time" query:"end_time" description:"最近失败时间结束(带时区的 RFC3339 秒级时间)"`
}
// PollingFailureAlertItem 卡轮询失败告警。
type PollingFailureAlertItem struct {
ID uint `json:"id" description:"告警ID"`
AlertLevel string `json:"alert_level" description:"告警级别 (card:卡级, carrier:账户级)"`
CardID uint `json:"card_id" description:"卡ID,账户级为 0"`
ICCID string `json:"iccid" description:"ICCID"`
CarrierID uint `json:"carrier_id" description:"运营商账户ID"`
CarrierName string `json:"carrier_name" description:"运营商账户名称"`
CheckType string `json:"check_type" description:"检查类型"`
CheckTypeName string `json:"check_type_name" description:"检查类型名称"`
ErrorCategory string `json:"error_category" description:"最近错误类别"`
FailCount int `json:"fail_count" description:"连续失败次数;账户级为窗口内告警数"`
FirstFailedAt *time.Time `json:"first_failed_at" description:"首次失败时间"`
LastFailedAt *time.Time `json:"last_failed_at" description:"最近失败时间"`
LastError string `json:"last_error" description:"最近错误"`
Status int `json:"status" description:"状态 (1:未处理, 2:已恢复, 3:已关闭轮询, 4:已处理)"`
StatusName string `json:"status_name" description:"状态名称"`
HandledBy uint `json:"handled_by" description:"处理人"`
HandledAt *time.Time `json:"handled_at" description:"处理时间"`
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 卡轮询失败告警分页结果。
type PollingFailureAlertPageResult struct {
List []PollingFailureAlertItem `json:"items" description:"告警列表"`
Total int64 `json:"total" description:"总数"`
Page int `json:"page" description:"当前页"`
PageSize int `json:"size" description:"每页数量"`
}
// PollingFailureAlertSummaryItem 未处理告警按运营商账户 × 错误类别汇总。
type PollingFailureAlertSummaryItem struct {
CarrierID uint `json:"carrier_id" description:"运营商账户ID"`
CarrierName string `json:"carrier_name" description:"运营商账户名称"`
ErrorCategory string `json:"error_category" description:"错误类别"`
OpenCount int64 `json:"open_count" description:"未处理卡级告警数"`
}
// PollingFailureAlertIDPath 告警路径参数。
type PollingFailureAlertIDPath struct {
ID uint `json:"-" path:"id" required:"true" description:"告警ID"`
}
// HandlePollingFailureAlertRequest 标记告警已处理。
type HandlePollingFailureAlertRequest struct {
ID uint `json:"-" path:"id" required:"true" description:"告警ID"`
Status int `json:"status" validate:"required,oneof=4" required:"true" description:"目标状态 (4:已处理);关闭轮询请使用资产轮询开关接口"`
Remark string `json:"remark" validate:"omitempty,max=500" maxLength:"500" description:"处理备注"`
}
// CardPollingStatePath 卡ID路径参数。
type CardPollingStatePath struct {
ID uint `json:"-" path:"id" required:"true" description:"卡ID"`
}
// CardPollingTypeState 卡某检查类型的轮询状态。
type CardPollingTypeState struct {
CheckType string `json:"check_type" description:"检查类型"`
CheckTypeName string `json:"check_type_name" description:"检查类型名称"`
NextDueAt *time.Time `json:"next_due_at" description:"下次到期时间"`
LastSuccessAt *time.Time `json:"last_success_at" description:"最近一次成功时间"`
FailCount int `json:"fail_count" description:"连续失败次数"`
FirstFailedAt *time.Time `json:"first_failed_at" description:"首次失败时间"`
LastError string `json:"last_error" description:"最近错误(类别|信息)"`
PendingConfirm []int `json:"pending_confirm" description:"待执行的延迟确认(秒)"`
}
// CardStopResumeCommandState 卡当前停复机指令(停复机指令队列)。
type CardStopResumeCommandState struct {
Action string `json:"action" description:"动作 (stop:停机, start:复机)"`
Reason string `json:"reason" description:"停机原因"`
Scenes []string `json:"scenes" description:"触发场景"`
Source string `json:"source" description:"请求来源"`
Version int64 `json:"version" description:"指令版本"`
FailCount int `json:"fail_count" description:"连续失败次数"`
LastError string `json:"last_error" description:"最近错误(类别|信息)"`
Pending bool `json:"pending" description:"结果未知,待确认"`
Unknown int `json:"unknown" description:"连续结果未知次数"`
WrittenAt *time.Time `json:"written_at" description:"最近写入时间"`
NextAt *time.Time `json:"next_at" description:"下次可执行时间(空表示不在队列中)"`
}
// CardPollingStateResponse 单卡轮询状态(只读)。
type CardPollingStateResponse struct {
CardID uint `json:"card_id" description:"卡ID"`
ICCID string `json:"iccid" description:"ICCID"`
CarrierID uint `json:"carrier_id" description:"运营商账户ID"`
SchedulerMode string `json:"scheduler_mode" description:"当前调度模式 (legacy:旧分片调度, carrier:按运营商账户调度)"`
EnablePolling bool `json:"enable_polling" description:"卡轮询开关"`
Queue string `json:"queue" description:"所在队列 (priority:优先, queue:普通, none:不在轮询中)"`
QueueScoreAt *time.Time `json:"queue_score_at" description:"队列中下次可领取时间"`
Running bool `json:"running" description:"是否执行中"`
ClaimExpireAt *time.Time `json:"claim_expire_at" description:"处理中标记到期时间"`
PriorityMark bool `json:"priority_mark" description:"执行中收到请求检查,收尾后进入优先队列"`
Types []CardPollingTypeState `json:"types" description:"各检查类型状态"`
StopResumeQueueEnabled bool `json:"stop_resume_queue_enabled" description:"停复机出口开关是否开启"`
StopResumeCommand *CardStopResumeCommandState `json:"stop_resume_command" description:"当前停复机指令(无指令为空)"`
LastStopResumeCallAt *time.Time `json:"last_stop_resume_call_at" description:"最近一次停复机网关调用时间(单卡最小重试间隔依据)"`
}
// CarrierPollingStatsItem 按运营商账户的轮询监控。
type CarrierPollingStatsItem struct {
CarrierID uint `json:"carrier_id" description:"运营商账户ID"`
CarrierName string `json:"carrier_name" description:"运营商账户名称"`
PriorityLength int64 `json:"priority_length" description:"优先队列长度"`
QueueLength int64 `json:"queue_length" description:"普通队列长度"`
DueCount int64 `json:"due_count" description:"已到期卡数(优先 + 普通)"`
Running int64 `json:"running" description:"执行中卡任务数"`
InflightLimit int `json:"inflight_limit" description:"执行上限"`
QPSLastMinute float64 `json:"qps_last_minute" description:"上一分钟实际网关调用 QPS(查询类)"`
RateLimitWaits int64 `json:"rate_limit_waits" description:"上一分钟限流等待次数"`
RateLimited int64 `json:"rate_limited" description:"上一分钟限流拒绝或等待超时次数"`
ExpiredClaims1h int64 `json:"expired_claims_1h" description:"近 1 小时处理中标记到期次数(执行崩溃或超时)"`
OpenAlerts int64 `json:"open_alerts" description:"未处理卡级失败告警数"`
OpenAlertsByType map[string]int64 `json:"open_alerts_by_category" description:"未处理卡级失败告警数(按错误类别)"`
StopResumeQueueLength int64 `json:"stop_resume_queue_length" description:"停复机指令队列长度"`
StopResumeDue int64 `json:"stop_resume_due" description:"已到期停复机指令数"`
StopResumeRunning int64 `json:"stop_resume_running" description:"执行中停复机指令数"`
StopResumePending int64 `json:"stop_resume_pending" description:"结果未知待确认的停复机指令数(按队列前 500 条统计)"`
StopResumeSuccess1h int64 `json:"stop_resume_success_1h" description:"近 1 小时停复机成功数"`
StopResumeFailed1h int64 `json:"stop_resume_failed_1h" description:"近 1 小时停复机失败数(计入连续失败或终态)"`
StopResumeRetry1h int64 `json:"stop_resume_retry_1h" description:"近 1 小时停复机推后重试数(限流、频率限制、最小间隔)"`
StopResumeUnknown1h int64 `json:"stop_resume_unknown_1h" description:"近 1 小时停复机结果未知数"`
}
// CarrierPollingStatsResponse 按运营商账户的轮询监控。
type CarrierPollingStatsResponse struct {
SchedulerMode string `json:"scheduler_mode" description:"当前调度模式"`
InitState string `json:"init_state" description:"新结构初始化状态 (running / done,空表示未初始化)"`
Items []CarrierPollingStatsItem `json:"items" description:"各运营商账户监控"`
}