feat: 停复机规则演练与终态自动关闭轮询
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m26s

统一停复机规则转正的第一次发布:总开关仍关闭,现有停复机行为不变。

- 新增停复机规则演练:GET /stop-resume-rule/dry-run 按新规则对开机与停机卡只判断不执行,返回运营商账户 × 停机原因 × 判断结果汇总与分页明细,可假设通道实名管控配置;POST /stop-resume-rule/dry-run/export 导出明细(场景 stop_resume_rule_dry_run);仅超级管理员与平台账号
- 风险停机、已销户关闭轮询不再限于独立卡,只关该卡自身轮询,不级联设备
- 错误分类规则增加 auto_disable_polling,仅终态类别可勾选;停复机(含设备停复机)命中该规则时不重试、关闭该卡轮询、回写网关扩展状态并写审计 iot_card.terminal_disable_polling
- 迁移 000250 加列与约束,并为"已销户""仅支持风险复机"置位
This commit is contained in:
邹进
2026-10-25 17:52:40 +09:00
parent fad7dbfdff
commit af8249158d
33 changed files with 1227 additions and 56 deletions

View File

@@ -30,6 +30,7 @@ import (
type Service struct {
stopResumeRecorder *gatewaylimit.StopResumeRecorder
terminalPolling *gatewaylimit.TerminalPollingDisabler
db *gorm.DB
redis *redis.Client
deviceStore *postgres.DeviceStore
@@ -1436,6 +1437,7 @@ func (s *Service) StopDevice(ctx context.Context, deviceID uint) (*dto.DeviceSus
s.recordCardCommand(ctx, card, constants.StopResumeActionStop, constants.StopReasonManual, gwErr, time.Since(callStartedAt))
integrationID = observer.integration
if gwErr != nil {
s.disablePollingOnTerminal(ctx, card, constants.StopResumeActionStop, gwErr)
log.Error("设备停机-调网关停机失败",
zap.Uint("device_id", deviceID),
zap.String("iccid", card.ICCID),
@@ -1582,6 +1584,7 @@ func (s *Service) StartDevice(ctx context.Context, deviceID uint) error {
s.recordCardCommand(ctx, card, constants.StopResumeActionStart, "", gwErr, time.Since(callStartedAt))
integrationID = observer.integration
if gwErr != nil {
s.disablePollingOnTerminal(ctx, card, constants.StopResumeActionStart, gwErr)
log.Error("设备复机-调网关复机失败",
zap.Uint("device_id", deviceID),
zap.String("iccid", card.ICCID),
@@ -1735,6 +1738,18 @@ func (s *Service) SetStopResumeRecorder(recorder *gatewaylimit.StopResumeRecorde
s.stopResumeRecorder = recorder
}
// SetTerminalPollingDisabler 注入终态关闭轮询处理器:设备下某张卡停复机命中"自动关闭轮询"规则时只关闭该卡轮询。
func (s *Service) SetTerminalPollingDisabler(disabler *gatewaylimit.TerminalPollingDisabler) {
s.terminalPolling = disabler
}
// disablePollingOnTerminal 设备下单卡停复机失败命中终态规则时关闭该卡轮询并清除轮询卡缓存。
func (s *Service) disablePollingOnTerminal(ctx context.Context, card *model.IotCard, action string, callErr error) {
if s.terminalPolling.HandleCommandError(ctx, card, action, callErr) {
s.invalidatePollingCardCache(card.ID)
}
}
// recordCardCommand 写设备下单卡的停复机记录;停复机只发一次请求,尝试序号恒为 1。
func (s *Service) recordCardCommand(ctx context.Context, card *model.IotCard, action, reason string, callErr error, duration time.Duration) {
if s.stopResumeRecorder == nil || card == nil {