feat: 不轮询清单与批量开关轮询
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:
邹进
2026-10-26 03:07:20 +09:00
parent a4e3fe4d8f
commit 7ddb9312e3
45 changed files with 2250 additions and 50 deletions

View File

@@ -0,0 +1,122 @@
// Package pollingalert 是失败告警"停机被拒"视图的只读查询,供后台列表与导出共用(add-polling-pause-list-and-batch-toggle)。
package pollingalert
import (
"context"
"time"
"gorm.io/gorm"
"github.com/break/junhong_cmp_fiber/pkg/constants"
"github.com/break/junhong_cmp_fiber/pkg/errors"
)
// StopRefusedFilter 是停机被拒视图的附加筛选。
type StopRefusedFilter struct {
CarrierID *uint
Status *int
ICCID string
StartTime *time.Time
EndTime *time.Time
}
// StopRefusedRow 是停机被拒告警与卡当前状态的投影。
type StopRefusedRow struct {
ID uint
CardID uint
ICCID string
CarrierID uint
CarrierName string
DeviceID uint
NetworkStatus int
StopReason string
EnablePolling bool
HasPackage bool
ErrorCategory string
FailCount int
FirstFailedAt *time.Time
LastFailedAt *time.Time
LastError string
Status int
HandledBy uint
HandledByName string
HandledAt *time.Time
HandleRemark string
}
// ApplyStopRefused 在告警查询上叠加"停机被拒"视图条件:停复机方向为停机,且错误类型为终态或业务错误、或停机失败次数达到阈值。
// 停复机方向告警的最近错误以 "stop: " 开头(见停复机指令执行器)。
func ApplyStopRefused(query *gorm.DB, table string, threshold int) *gorm.DB {
if threshold <= 0 {
threshold = 5
}
prefix := ""
if table != "" {
prefix = table + "."
}
return query.Where(prefix+"alert_level = ? AND "+prefix+"check_type = ? AND "+prefix+"last_error LIKE ?",
constants.PollingAlertLevelCard, constants.CheckTypeStopResume, constants.StopResumeActionStop+":%").
Where("("+prefix+"error_category IN ? OR "+prefix+"fail_count >= ?)",
[]string{constants.GatewayClassTerminal, constants.GatewayClassBusiness}, threshold)
}
// Query 停机被拒视图查询。
type Query struct {
db *gorm.DB
}
// NewQuery 创建停机被拒视图查询。
func NewQuery(db *gorm.DB) *Query {
return &Query{db: db}
}
func (q *Query) base(ctx context.Context, filter StopRefusedFilter, threshold int) *gorm.DB {
query := ApplyStopRefused(q.db.WithContext(ctx).Table("tb_polling_failure_alert AS a"), "a", threshold)
if filter.CarrierID != nil {
query = query.Where("a.carrier_id = ?", *filter.CarrierID)
}
if filter.Status != nil {
query = query.Where("a.status = ?", *filter.Status)
}
if filter.ICCID != "" {
query = query.Where("a.iccid = ?", filter.ICCID)
}
if filter.StartTime != nil {
query = query.Where("a.last_failed_at >= ?", *filter.StartTime)
}
if filter.EndTime != nil {
query = query.Where("a.last_failed_at <= ?", *filter.EndTime)
}
return query
}
// Count 统计停机被拒告警数。
func (q *Query) Count(ctx context.Context, filter StopRefusedFilter, threshold int) (int64, error) {
var total int64
if err := q.base(ctx, filter, threshold).Count(&total).Error; err != nil {
return 0, errors.Wrap(errors.CodeDatabaseError, err, "统计停机被拒告警失败")
}
return total, nil
}
// Page 返回一页停机被拒告警,附带所属设备、网络状态、停机原因、轮询开关、是否有生效套餐与处理人。
func (q *Query) Page(ctx context.Context, filter StopRefusedFilter, threshold, offset, limit int) ([]StopRefusedRow, error) {
var rows []StopRefusedRow
err := q.base(ctx, filter, threshold).
Select(`a.id, a.card_id, a.iccid, a.carrier_id, COALESCE(ca.carrier_name, '') AS carrier_name,
COALESCE(b.device_id, 0) AS device_id, COALESCE(c.network_status, 0) AS network_status,
COALESCE(c.stop_reason, '') AS stop_reason, COALESCE(c.enable_polling, FALSE) AS enable_polling,
EXISTS (SELECT 1 FROM tb_package_usage u WHERE u.status = ? AND u.master_usage_id IS NULL AND u.deleted_at IS NULL
AND ((b.device_id IS NOT NULL AND u.device_id = b.device_id) OR (b.device_id IS NULL AND u.iot_card_id = a.card_id))) AS has_package,
a.error_category, a.fail_count, a.first_failed_at, a.last_failed_at, a.last_error, a.status,
a.handled_by, COALESCE(ac.username, '') AS handled_by_name, a.handled_at, a.handle_remark`, constants.PackageUsageStatusActive).
Joins("LEFT JOIN tb_iot_card c ON c.id = a.card_id").
Joins("LEFT JOIN tb_device_sim_binding b ON b.iot_card_id = a.card_id AND b.bind_status = ? AND b.deleted_at IS NULL", constants.BindStatusBound).
Joins("LEFT JOIN tb_carrier ca ON ca.id = a.carrier_id").
Joins("LEFT JOIN tb_account ac ON ac.id = a.handled_by").
Order("a.last_failed_at DESC NULLS LAST, a.id DESC").Offset(offset).Limit(limit).Scan(&rows).Error
if err != nil {
return nil, errors.Wrap(errors.CodeDatabaseError, err, "查询停机被拒告警失败")
}
return rows, nil
}

View File

@@ -0,0 +1,111 @@
// Package pollingpause 是不轮询清单的只读查询,供后台列表与导出共用(add-polling-pause-list-and-batch-toggle)。
package pollingpause
import (
"context"
"time"
"gorm.io/gorm"
"github.com/break/junhong_cmp_fiber/internal/model"
"github.com/break/junhong_cmp_fiber/pkg/constants"
"github.com/break/junhong_cmp_fiber/pkg/errors"
)
// Filter 是不轮询清单筛选条件。
type Filter struct {
AssetType string
CarrierID *uint
Source string
Status *int
Identifier string
OperatorID *uint
StartTime *time.Time
EndTime *time.Time
}
// Row 是清单记录与资产当前状态、名称的投影。
type Row struct {
model.CardPollingPause
CarrierName string
EnablePolling bool
GatewayExtend string
ClosedByName string
RestoredByName string
}
// EnsureAllowed 不轮询清单仅超级管理员与平台账号可查看与导出。
func EnsureAllowed(userType int) error {
if userType == constants.UserTypeSuperAdmin || userType == constants.UserTypePlatform {
return nil
}
return errors.New(errors.CodeForbidden, "仅平台账号可查看不轮询清单")
}
// Query 不轮询清单只读查询。
type Query struct {
db *gorm.DB
}
// NewQuery 创建不轮询清单查询。
func NewQuery(db *gorm.DB) *Query {
return &Query{db: db}
}
func (q *Query) base(ctx context.Context, filter Filter) *gorm.DB {
query := q.db.WithContext(ctx).Table("tb_card_polling_pause AS p")
if filter.AssetType != "" {
query = query.Where("p.asset_type = ?", filter.AssetType)
}
if filter.CarrierID != nil {
query = query.Where("p.carrier_id = ?", *filter.CarrierID)
}
if filter.Source != "" {
query = query.Where("p.close_source = ?", filter.Source)
}
if filter.Status != nil {
query = query.Where("p.status = ?", *filter.Status)
}
if filter.Identifier != "" {
query = query.Where("p.identifier = ?", filter.Identifier)
}
if filter.OperatorID != nil {
query = query.Where("p.closed_by = ?", *filter.OperatorID)
}
if filter.StartTime != nil {
query = query.Where("p.closed_at >= ?", *filter.StartTime)
}
if filter.EndTime != nil {
query = query.Where("p.closed_at <= ?", *filter.EndTime)
}
return query
}
// Count 统计符合条件的记录数。
func (q *Query) Count(ctx context.Context, filter Filter) (int64, error) {
var total int64
if err := q.base(ctx, filter).Count(&total).Error; err != nil {
return 0, errors.Wrap(errors.CodeDatabaseError, err, "统计不轮询清单失败")
}
return total, nil
}
// Page 按关闭时间倒序返回一页记录,附带资产当前轮询开关、网关扩展状态、运营商账户与操作人名称。
func (q *Query) Page(ctx context.Context, filter Filter, offset, limit int) ([]Row, error) {
var rows []Row
err := q.base(ctx, filter).
Select(`p.*, COALESCE(ca.carrier_name, '') AS carrier_name,
COALESCE(c.enable_polling, d.enable_polling, FALSE) AS enable_polling,
COALESCE(c.gateway_extend, '') AS gateway_extend,
COALESCE(a1.username, '') AS closed_by_name, COALESCE(a2.username, '') AS restored_by_name`).
Joins("LEFT JOIN tb_iot_card c ON p.asset_type = 'iot_card' AND c.id = p.asset_id").
Joins("LEFT JOIN tb_device d ON p.asset_type = 'device' AND d.id = p.asset_id").
Joins("LEFT JOIN tb_carrier ca ON ca.id = p.carrier_id").
Joins("LEFT JOIN tb_account a1 ON a1.id = p.closed_by").
Joins("LEFT JOIN tb_account a2 ON a2.id = p.restored_by").
Order("p.closed_at DESC, p.id DESC").Offset(offset).Limit(limit).Scan(&rows).Error
if err != nil {
return nil, errors.Wrap(errors.CodeDatabaseError, err, "查询不轮询清单失败")
}
return rows, nil
}