package dto // CreatePollingConfigRequest 创建轮询配置请求 type CreatePollingConfigRequest struct { ConfigName string `json:"config_name" validate:"required,min=1,max=100" required:"true" minLength:"1" maxLength:"100" description:"配置名称"` CardCondition string `json:"card_condition" validate:"omitempty,oneof=not_real_name real_name activated suspended" description:"卡状态条件 (not_real_name:未实名, real_name:已实名, activated:已激活, suspended:已停用)"` CardCategory string `json:"card_category" validate:"omitempty,oneof=normal industry" description:"卡业务类型 (normal:普通卡, industry:行业卡)"` CarrierID *uint `json:"carrier_id" validate:"omitempty" description:"运营商ID(可选,精确匹配)"` Priority int `json:"priority" validate:"required,min=1,max=1000" required:"true" minimum:"1" maximum:"1000" description:"优先级(数字越小优先级越高)"` RealnameCheckInterval *int `json:"realname_check_interval" validate:"omitempty,min=0" minimum:"0" description:"实名检查间隔(秒):正数按间隔(最小30秒),0 不检查且不再继承,不传或为空继承优先级更低的配置"` CarddataCheckInterval *int `json:"carddata_check_interval" validate:"omitempty,min=0" minimum:"0" description:"流量检查间隔(秒):正数按间隔(最小60秒),0 不检查且不再继承,不传或为空继承优先级更低的配置"` PackageCheckInterval *int `json:"package_check_interval" validate:"omitempty,min=0" minimum:"0" description:"套餐检查间隔(秒):正数按间隔(最小60秒),0 不检查且不再继承,不传或为空继承优先级更低的配置"` CardStatusCheckInterval *int `json:"card_status_check_interval" validate:"omitempty,min=0" minimum:"0" description:"卡状态检查间隔(秒):正数按间隔(最小30秒),0 不检查且不再继承,不传或为空继承优先级更低的配置"` PackageState *string `json:"package_state" validate:"omitempty,oneof=active depleted pending none" enum:"active,depleted,pending,none" description:"套餐状态匹配 (active:有生效套餐, depleted:套餐已用完, pending:只有待生效套餐, none:无套餐),为空不限"` AssetStatus *int `json:"asset_status" validate:"omitempty,oneof=1 2 3 4" enum:"1,2,3,4" description:"资产状态匹配 (1:在库, 2:已销售, 3:已换货, 4:已停用),为空不限"` PreResetWindow *int `json:"pre_reset_window" validate:"omitempty,min=60" minimum:"60" description:"重置日前加密窗口长度(秒),与窗口内流量间隔同时配置才生效"` PreResetCarddataInterval *int `json:"pre_reset_carddata_interval" validate:"omitempty,min=60" minimum:"60" description:"重置日前窗口内的流量检查间隔(秒),与窗口长度同时配置才生效"` Description string `json:"description" validate:"omitempty,max=500" maxLength:"500" description:"配置说明"` } // UpdatePollingConfigRequest 更新轮询配置请求 type UpdatePollingConfigRequest struct { ConfigName *string `json:"config_name" validate:"omitempty,min=1,max=100" minLength:"1" maxLength:"100" description:"配置名称"` CardCondition *string `json:"card_condition" validate:"omitempty,oneof=not_real_name real_name activated suspended" description:"卡状态条件 (not_real_name:未实名, real_name:已实名, activated:已激活, suspended:已停用)"` CardCategory *string `json:"card_category" validate:"omitempty,oneof=normal industry" description:"卡业务类型 (normal:普通卡, industry:行业卡)"` CarrierID *uint `json:"carrier_id" validate:"omitempty" description:"运营商ID(可选,精确匹配)"` Priority *int `json:"priority" validate:"omitempty,min=1,max=1000" minimum:"1" maximum:"1000" description:"优先级(数字越小优先级越高)"` RealnameCheckInterval *int `json:"realname_check_interval" validate:"omitempty,min=0" minimum:"0" description:"实名检查间隔(秒):正数按间隔(最小30秒),0 不检查且不再继承,不传或为空继承优先级更低的配置"` CarddataCheckInterval *int `json:"carddata_check_interval" validate:"omitempty,min=0" minimum:"0" description:"流量检查间隔(秒):正数按间隔(最小60秒),0 不检查且不再继承,不传或为空继承优先级更低的配置"` PackageCheckInterval *int `json:"package_check_interval" validate:"omitempty,min=0" minimum:"0" description:"套餐检查间隔(秒):正数按间隔(最小60秒),0 不检查且不再继承,不传或为空继承优先级更低的配置"` CardStatusCheckInterval *int `json:"card_status_check_interval" validate:"omitempty,min=0" minimum:"0" description:"卡状态检查间隔(秒):正数按间隔(最小30秒),0 不检查且不再继承,不传或为空继承优先级更低的配置"` PackageState *string `json:"package_state" validate:"omitempty,oneof=active depleted pending none" enum:"active,depleted,pending,none" description:"套餐状态匹配 (active:有生效套餐, depleted:套餐已用完, pending:只有待生效套餐, none:无套餐),为空不限"` AssetStatus *int `json:"asset_status" validate:"omitempty,oneof=1 2 3 4" enum:"1,2,3,4" description:"资产状态匹配 (1:在库, 2:已销售, 3:已换货, 4:已停用),为空不限"` PreResetWindow *int `json:"pre_reset_window" validate:"omitempty,min=60" minimum:"60" description:"重置日前加密窗口长度(秒),与窗口内流量间隔同时配置才生效"` PreResetCarddataInterval *int `json:"pre_reset_carddata_interval" validate:"omitempty,min=60" minimum:"60" description:"重置日前窗口内的流量检查间隔(秒),与窗口长度同时配置才生效"` ClearFields []PollingConfigClearField `json:"clear_fields" validate:"omitempty,dive,oneof=realname_check_interval carddata_check_interval package_check_interval card_status_check_interval carrier_id package_state asset_status pre_reset_window pre_reset_carddata_interval" description:"要清空为空值的字段(间隔清空即改为继承,匹配条件清空即不限):realname_check_interval/carddata_check_interval/package_check_interval/card_status_check_interval/carrier_id/package_state/asset_status/pre_reset_window/pre_reset_carddata_interval"` Description *string `json:"description" validate:"omitempty,max=500" maxLength:"500" description:"配置说明"` } // PollingConfigListRequest 轮询配置列表请求 type PollingConfigListRequest 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 *int16 `json:"status" query:"status" validate:"omitempty,oneof=0 1" description:"状态 (1:启用, 0:禁用)"` CardCondition *string `json:"card_condition" query:"card_condition" validate:"omitempty,oneof=not_real_name real_name activated suspended" description:"卡状态条件"` CardCategory *string `json:"card_category" query:"card_category" validate:"omitempty,oneof=normal industry" description:"卡业务类型"` CarrierID *uint `json:"carrier_id" query:"carrier_id" validate:"omitempty" description:"运营商ID"` ConfigName *string `json:"config_name" query:"config_name" validate:"omitempty,max=100" maxLength:"100" description:"配置名称(模糊搜索)"` } // UpdatePollingConfigStatusRequest 更新轮询配置状态请求 type UpdatePollingConfigStatusRequest struct { Status int16 `json:"status" validate:"required,oneof=0 1" required:"true" description:"状态 (1:启用, 0:禁用)"` } // PollingConfigResponse 轮询配置响应 type PollingConfigResponse struct { ID uint `json:"id" description:"配置ID"` ConfigName string `json:"config_name" description:"配置名称"` CardCondition string `json:"card_condition" description:"卡状态条件 (not_real_name:未实名, real_name:已实名, activated:已激活, suspended:已停用)"` CardCategory string `json:"card_category" description:"卡业务类型 (normal:普通卡, industry:行业卡)"` CarrierID *uint `json:"carrier_id" description:"运营商ID"` Priority int `json:"priority" description:"优先级(数字越小优先级越高)"` RealnameCheckInterval *int `json:"realname_check_interval" description:"实名检查间隔(秒):正数按间隔,0 不检查,空继承"` CarddataCheckInterval *int `json:"carddata_check_interval" description:"流量检查间隔(秒):正数按间隔,0 不检查,空继承"` PackageCheckInterval *int `json:"package_check_interval" description:"套餐检查间隔(秒):正数按间隔,0 不检查,空继承"` CardStatusCheckInterval *int `json:"card_status_check_interval" description:"卡状态检查间隔(秒):正数按间隔,0 不检查,空继承"` PackageState *string `json:"package_state" description:"套餐状态匹配 (active:有生效套餐, depleted:套餐已用完, pending:只有待生效套餐, none:无套餐),为空不限"` AssetStatus *int `json:"asset_status" description:"资产状态匹配 (1:在库, 2:已销售, 3:已换货, 4:已停用),为空不限"` PreResetWindow *int `json:"pre_reset_window" description:"重置日前加密窗口长度(秒)"` PreResetCarddataInterval *int `json:"pre_reset_carddata_interval" description:"重置日前窗口内的流量检查间隔(秒)"` Warnings []string `json:"warnings,omitempty" description:"保存提示(如与其他启用配置优先级相同且匹配条件可能重叠),不影响保存结果"` Status int16 `json:"status" description:"状态 (1:启用, 0:禁用)"` Description string `json:"description" description:"配置说明"` CreatedAt string `json:"created_at" description:"创建时间"` UpdatedAt string `json:"updated_at" description:"更新时间"` } // UpdatePollingConfigParams 更新轮询配置参数 type UpdatePollingConfigParams struct { IDReq UpdatePollingConfigRequest } // UpdatePollingConfigStatusParams 更新轮询配置状态参数 type UpdatePollingConfigStatusParams struct { IDReq UpdatePollingConfigStatusRequest } // PollingConfigPageResult 轮询配置分页结果 type PollingConfigPageResult struct { List []*PollingConfigResponse `json:"items" description:"配置列表"` Total int64 `json:"total" description:"总数"` Page int `json:"page" description:"当前页"` PageSize int `json:"size" description:"每页数量"` } // UpdatePollingConfigPrioritiesRequest 整体调整轮询配置优先级请求 type UpdatePollingConfigPrioritiesRequest struct { OrderedIDs []uint `json:"ordered_ids" validate:"required,min=1,max=1000,dive,min=1" required:"true" minItems:"1" maxItems:"1000" description:"按期望生效顺序排列的配置 ID 列表(排在前面的优先级更高);ID 须为正整数且不重复;系统按顺序把优先级重排为 1、2、3…,未列出的配置保持原优先级"` } // PollingConfigOverride 匹配预览中的未保存修改;ID 为 0 表示新增草稿,Disabled 为 true 表示假设该配置停用。 // 字段含义与创建轮询配置相同,均为可选;草稿名称为空时显示"未保存的配置"。 type PollingConfigOverride struct { ID uint `json:"id" description:"要覆盖的配置 ID,0 表示新增一条草稿配置"` Disabled bool `json:"disabled" description:"假设该配置停用(不参与匹配),为 true 时其余字段忽略"` ConfigName string `json:"config_name" maxLength:"100" description:"草稿配置名称"` CardCondition string `json:"card_condition" enum:"not_real_name,activated,suspended" description:"卡状态条件 (not_real_name:未实名, activated:已激活, suspended:已停用),为空不限"` CardCategory string `json:"card_category" enum:"normal,industry" description:"卡业务类型 (normal:普通卡, industry:行业卡),为空不限"` CarrierID *uint `json:"carrier_id" description:"运营商账户ID,为空不限"` Priority int `json:"priority" minimum:"0" description:"优先级(数字越小越优先;与已有配置相同时排在已有配置之后)"` RealnameCheckInterval *int `json:"realname_check_interval" minimum:"0" description:"实名检查间隔(秒),正数按间隔、0 不检查、空继承"` CarddataCheckInterval *int `json:"carddata_check_interval" minimum:"0" description:"流量检查间隔(秒),正数按间隔、0 不检查、空继承"` PackageCheckInterval *int `json:"package_check_interval" minimum:"0" description:"套餐检查间隔(秒),正数按间隔、0 不检查、空继承"` CardStatusCheckInterval *int `json:"card_status_check_interval" minimum:"0" description:"卡状态检查间隔(秒),正数按间隔、0 不检查、空继承"` PackageState *string `json:"package_state" enum:"active,depleted,pending,none" description:"套餐状态匹配 (active:有生效套餐, depleted:套餐已用完, pending:只有待生效套餐, none:无套餐),为空不限"` AssetStatus *int `json:"asset_status" enum:"1,2,3,4" description:"资产状态匹配 (1:在库, 2:已销售, 3:已换货, 4:已停用),为空不限"` PreResetWindow *int `json:"pre_reset_window" minimum:"60" description:"重置日前加密窗口长度(秒),与窗口内流量间隔同时配置才生效"` PreResetCarddataInterval *int `json:"pre_reset_carddata_interval" minimum:"60" description:"重置日前窗口内的流量检查间隔(秒),与窗口长度同时配置才生效"` } // PollingConfigMatchPreviewQuery 按当前配置预览的查询参数 type PollingConfigMatchPreviewQuery struct { ICCID string `json:"-" query:"iccid" validate:"required,max=30" required:"true" maxLength:"30" description:"要预览的卡 ICCID"` } // PollingConfigMatchPreviewRequest 带未保存修改的匹配预览请求(请求体) type PollingConfigMatchPreviewRequest struct { ICCID string `json:"iccid" validate:"required,max=30" required:"true" maxLength:"30" description:"要预览的卡 ICCID"` Overrides []PollingConfigOverride `json:"overrides" maxItems:"20" description:"未保存的修改,不写任何数据"` } // PollingCardMatchFacts 卡的匹配维度取值 type PollingCardMatchFacts struct { CardID uint `json:"card_id" description:"IoT卡ID"` ICCID string `json:"iccid" description:"ICCID"` CardCondition string `json:"card_condition" description:"卡状态条件 (not_real_name:未实名, activated:已激活, suspended:已停用)"` CardCategory string `json:"card_category" description:"卡业务类型 (normal:普通卡, industry:行业卡)"` CarrierID uint `json:"carrier_id" description:"运营商账户ID"` AssetStatus int `json:"asset_status" description:"资产状态 (1:在库, 2:已销售, 3:已换货, 4:已停用)"` PackageState string `json:"package_state" description:"套餐状态 (active:有生效套餐, depleted:套餐已用完, pending:只有待生效套餐, none:无套餐),解析失败为空"` PackageStateName string `json:"package_state_name" description:"套餐状态名称"` EnablePolling bool `json:"enable_polling" description:"是否开启轮询"` } // PollingConfigBrief 匹配到的配置摘要 type PollingConfigBrief struct { ID uint `json:"id" description:"配置ID"` ConfigName string `json:"config_name" description:"配置名称"` Priority int `json:"priority" description:"优先级"` Draft bool `json:"draft" description:"是否为预览中的未保存配置"` } // PollingIntervalPreview 某检查类型最终采用的间隔与来源 type PollingIntervalPreview struct { TaskType string `json:"task_type" description:"检查类型 (polling:realname:实名, polling:carddata:流量, polling:package:套餐, polling:card_status:卡状态)"` TaskTypeName string `json:"task_type_name" description:"检查类型名称"` Mode string `json:"mode" description:"结果 (interval:按间隔检查, disabled:不检查, unmatched:没有任何配置给出取值,不检查)"` Interval int `json:"interval" description:"间隔(秒),仅 mode=interval 时有值"` ConfigID uint `json:"config_id" description:"给出取值的配置ID"` ConfigName string `json:"config_name" description:"给出取值的配置名称"` Inherited bool `json:"inherited" description:"是否继承自非首个命中的配置(首个命中配置该项为空)"` } // PollingConfigMatchPreviewResponse 匹配预览响应 type PollingConfigMatchPreviewResponse struct { Card PollingCardMatchFacts `json:"card" description:"卡的匹配维度取值"` Matched []PollingConfigBrief `json:"matched" description:"命中的配置(按优先级、ID 升序)"` Intervals []PollingIntervalPreview `json:"intervals" description:"各检查类型最终结果"` } // PollingRecalculateDueRequest 立即重算到期时间请求 type PollingRecalculateDueRequest struct { CarrierID *uint `json:"carrier_id" description:"只处理该运营商账户的卡,为空处理全部开启轮询的卡"` } // PollingRecalculateDueTaskIDRequest 重算任务进度查询路径参数 type PollingRecalculateDueTaskIDRequest struct { TaskID string `json:"-" path:"task_id" required:"true" description:"重算任务ID"` } // PollingRecalculateDueResponse 重算到期时间任务进度 type PollingRecalculateDueResponse struct { TaskID string `json:"task_id" description:"重算任务ID"` Status string `json:"status" description:"状态 (pending:已入队, running:执行中, completed:已完成, failed:失败)"` CarrierID string `json:"carrier_id" description:"限定的运营商账户ID,为空表示全部"` Total int `json:"total" description:"需处理的卡数"` Processed int `json:"processed" description:"已处理的卡数"` Advanced int `json:"advanced" description:"被提前的检查项数"` Error string `json:"error" description:"失败原因"` CreatedAt string `json:"created_at" description:"创建时间"` StartedAt string `json:"started_at" description:"开始时间"` FinishedAt string `json:"finished_at" description:"结束时间"` } // PollingTierStatItem 按命中配置统计的卡数 type PollingTierStatItem struct { ConfigID uint `json:"config_id" description:"首个命中的配置ID,0 表示未匹配任何配置"` ConfigName string `json:"config_name" description:"首个命中的配置名称"` Cards int `json:"cards" description:"卡数"` } // PollingTierStatsResponse 分层统计响应 type PollingTierStatsResponse struct { TotalCards int `json:"total_cards" description:"开启轮询的卡数"` ByConfig []PollingTierStatItem `json:"by_config" description:"按首个命中配置统计"` ByPackageState map[string]int `json:"by_package_state" description:"按套餐状态统计 (active/depleted/pending/none/unknown)"` UnmatchedInStock int `json:"unmatched_in_stock" description:"未匹配任何配置的在库卡数(应告警)"` UnmatchedSoldNoPackage int `json:"unmatched_sold_no_package" description:"未匹配任何配置的已销售无套餐卡数(应告警)"` ComputedAt string `json:"computed_at" description:"统计时间(结果缓存 5 分钟)"` } // PollingPreResetCycleStat 某运营商账户某个重置周期的加密效果 type PollingPreResetCycleStat struct { ResetAt string `json:"reset_at" description:"重置时刻(上海时区)"` ActivePackageCards int `json:"active_package_cards" description:"当前有生效套餐的轮询卡数"` CheckedInWindow int64 `json:"checked_in_window" description:"窗口内查到过流量的卡数(近似去重计数)"` NotCheckedInWindow int64 `json:"not_checked_in_window" description:"有生效套餐但窗口内未查到流量的卡数(近似,最小为 0)"` LastOffsetBuckets map[string]int `json:"last_offset_buckets" description:"每张卡窗口内最后一次查询距重置时刻的分布(分钟):le_5/le_15/le_30/le_60/gt_60"` } // PollingPreResetCarrierStat 某运营商账户的重置日前加密效果 type PollingPreResetCarrierStat struct { CarrierID uint `json:"carrier_id" description:"运营商账户ID"` CarrierName string `json:"carrier_name" description:"运营商账户名称"` Previous PollingPreResetCycleStat `json:"previous" description:"最近一次已过去的重置周期"` Upcoming PollingPreResetCycleStat `json:"upcoming" description:"即将到来的重置周期(窗口未开始时计数为 0)"` } // PollingPreResetStatsResponse 重置日前加密效果统计响应 type PollingPreResetStatsResponse struct { Carriers []PollingPreResetCarrierStat `json:"carriers" description:"有开启轮询卡的运营商账户"` } // PollingConfigClearField 是更新轮询配置时可清空为空值的字段名。 type PollingConfigClearField string // Enum 返回可清空字段的全部取值,供接口文档生成数组元素枚举。 func (PollingConfigClearField) Enum() []interface{} { return []interface{}{"realname_check_interval", "carddata_check_interval", "package_check_interval", "card_status_check_interval", "carrier_id", "package_state", "asset_status", "pre_reset_window", "pre_reset_carddata_interval"} }