Files
junhong_cmp_fiber/internal/model/dto/carrier_polling_dto.go
邹进 c741f1751d feat: 按运营商账户调度的后台接口与重算到期
- /polling-carrier-params 列表(含默认标记与消费能力)、详情、保存(执行上限不得大于订阅进程 max_in_flight 之和)、删除;/polling-check-scenes 列表与修改(检查类型、递增的确认延迟、冷却);/polling-failure-alerts 列表、按账户与错误类别汇总、详情、标记已处理;GET /iot-cards/:id/polling-state 单卡轮询状态;GET /polling-stats/carrier-queues 按账户队列与执行监控
- 读取仅超级管理员与平台账号,修改仅超级管理员(告警处理平台账号可用),均写统一审计;新增审计动作与资源
- carrier 模式下重算到期时间写入卡到期信息与账户队列,只提前不推后
2026-10-25 18:56:32 +09:00

186 lines
15 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 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:"各运营商账户监控"`
}