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 all" description:"检查类型 (card_status:卡状态, carddata:流量, realname:实名, package:套餐, all:账户级)"` 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:"创建时间"` } // 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:"待执行的延迟确认(秒)"` } // 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:"各检查类型状态"` } // 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:"未处理卡级失败告警数(按错误类别)"` } // CarrierPollingStatsResponse 按运营商账户的轮询监控。 type CarrierPollingStatsResponse struct { SchedulerMode string `json:"scheduler_mode" description:"当前调度模式"` InitState string `json:"init_state" description:"新结构初始化状态 (running / done,空表示未初始化)"` Items []CarrierPollingStatsItem `json:"items" description:"各运营商账户监控"` }