Files
one-pipe-system/docs/2026-10-26-轮询账户限流-后台接入交付.md
luo 06684e1fc0
All checks were successful
构建并部署前端到测试环境 / deploy (push) Successful in 55s
fix: 轮询按运营商账户限流
2026-10-26 14:31:15 +08:00

11 KiB
Raw Blame History

轮询账户限流:后台接入交付

本次仅修改本后台前端,未修改独立 C 端、未推送 Git 或部署生产、未配置数据库菜单。真实接口权限和调度行为仍需测试环境联调。本地写操作全部通过 mock 验证。

后台配置与使用

新增菜单、隐藏详情、按钮编码和平台账号限制见 权限增量清单。原有网关、轮询配置预览/统计、停复机记录 URL 和权限保留。仅超级管理员的维护项不列入普通配置清单。

UI 沿用店铺列表表头、可选列、分页和店铺详情返回/标题/两列布局;窄屏详情单列。时间统一店铺格式,运营商账户按名称远程搜索,搜索条件 >=4 才出现展开。

新增配置字段现可保存,旧文档“仅预览”已失效。四项间隔:空继承、0 禁止且不再继承、正数执行。编辑清空使用 clear_fields,保存 warnings 单独展示;不再发送保护期间隔。

C 端需要同步哪些

必须修改(文档明确要求)

  1. C 端资产详情调用 GET /api/c/v1/asset/info 后,不再展示保护期状态(device_protect_status),包括标签、说明、倒计时和相关状态分支(如有)。
  2. 废弃字段可能仍返回固定 none,也可能缺失;兼容解析,但不能再依赖它决定页面展示或是否允许操作。不要把 none 当成新的异常状态。

随新后端回归验证(不是要求 C 端增加后台功能)

  • 订单/套餐生效、有效期变化后,重新读取资产实际 enable_polling;后台可能自动恢复轮询,不要仅凭旧前端缓存维持“已关闭”。
  • 指令队列启用时,业务受理不等于上游已完成停复机。若 C 端有即时完成提示,改为区分“已受理/处理中”和实际状态,并在合理刷新后确认。
  • 资产详情读入口的请求检查、延迟确认及冷却由后端场景配置控制,C 端不要自行复制调度逻辑或高频循环触发。

C 端不需要新增本次后台菜单、告警/调度参数/导入接口;本仓库没有修改任何 C 端代码。若 C 端本来没有保护期 UI 或逻辑,第一项只需核查删除残留引用。

接口覆盖

文档 46 个新增操作中,已有 GatewayService 17 个、PollingConfigService 7 个,本次 PollingSchedulerService 补 22 个。自动测试逐条解析原文附录的 46 个方法/路径,与实际服务调用对照,不以数量代替路径验收。

下表路径省略 /api/admin。精确 URL、Query/Body 测试位于 gateway.test.mjs、pollingConfigExtensions.test.mjs、pollingScheduler.test.mjs。

HTTP 操作 服务方法 后台入口
DELETE /gateway-error-classifications/{id} GatewayService.deleteRule 上游错误分类
DELETE /polling-carrier-params/{carrier_id} PollingSchedulerService.resetCarrierParam 账户参数维护
DELETE /polling-rate-limit-groups/{id} GatewayService.deleteGroup 网关限流组维护
GET /card-polling-pauses PollingSchedulerService.getPauses 不轮询清单
GET /card-stop-resume-records GatewayService.getRecords 停复机记录
GET /gateway-error-classifications GatewayService.getRules 上游错误分类
GET /iot-cards/{id}/polling-state PollingSchedulerService.getCardState 单卡/设备绑定卡/告警详情
GET /iot-cards/{id}/stop-resume-records GatewayService.getCardRecords 单卡/告警详情
GET /polling-carrier-params PollingSchedulerService.getCarrierParams 运营商账户调度参数
GET /polling-carrier-params/{carrier_id} PollingSchedulerService.getCarrierParam 账户参数详情
GET /polling-check-scenes PollingSchedulerService.getScenes 请求检查场景
GET /polling-configs/match-preview PollingConfigService.previewMatch 配置匹配预览
GET /polling-configs/recalculate-due/{task_id} PollingConfigService.getRecalculateTask 重算进度
GET /polling-failure-alerts PollingSchedulerService.getAlerts 告警普通/停机被拒
GET /polling-failure-alerts/summary PollingSchedulerService.getAlertSummary 告警账户汇总
GET /polling-failure-alerts/{id} PollingSchedulerService.getAlert 告警详情
GET /polling-options GatewayService.getOptions 网关各页枚举
GET /polling-rate-limit-groups GatewayService.getGroups 网关限流组
GET /polling-rate-limit-groups/{id} GatewayService.getGroup 网关限流组详情
GET /polling-stats/carrier-queues PollingSchedulerService.getQueues 账户队列监控
GET /polling-stats/carriers GatewayService.getCarrierStats 网关汇总/限流模式
GET /polling-stats/carriers/{carrier_id}/trend GatewayService.getCarrierTrend 账户调用趋势
GET /polling-stats/pre-reset PollingConfigService.getPreResetStats 重置日前统计
GET /polling-stats/tiers PollingConfigService.getTierStats 分层统计
GET /polling-status-imports PollingSchedulerService.getImports 导入任务列表
GET /polling-status-imports/{id} PollingSchedulerService.getImport 导入逐行结果
GET /polling-status/impact PollingSchedulerService.getImpact 单项/批量/导入确认
GET /stop-resume-rule/dry-run PollingSchedulerService.dryRun 规则演练(只读)
POST /devices/batch-update-polling-status PollingSchedulerService.toggleDevices 设备批量/清单恢复
POST /gateway-error-classifications GatewayService.createRule 上游错误分类
POST /gateway-error-classifications/test GatewayService.testRule 错误分类测试
POST /iot-cards/batch-update-polling-status PollingSchedulerService.toggleCards 卡批量/清单恢复
POST /polling-configs/match-preview PollingConfigService.previewDraft 配置草稿预览
POST /polling-configs/recalculate-due PollingConfigService.recalculateDue 重算到期
POST /polling-failure-alerts/close-polling PollingSchedulerService.closeAlertPolling 告警批量关闭卡轮询
POST /polling-rate-limit-groups GatewayService.createGroup 网关限流组维护
POST /polling-status-imports PollingSchedulerService.createImport 创建导入
POST /stop-resume-rule/dry-run/export PollingSchedulerService.exportDryRun 演练导出
PUT /gateway-error-classifications/{id} GatewayService.updateRule 上游错误分类
PUT /gateway-error-classifications/{id}/status GatewayService.setRuleStatus 上游错误分类
PUT /polling-carrier-params/{carrier_id} PollingSchedulerService.saveCarrierParam 账户参数维护
PUT /polling-check-scenes/{scene} PollingSchedulerService.saveScene 请求检查场景维护
PUT /polling-configs/priorities PollingConfigService.updatePriorities 整体优先级(拖动/上移下移)
PUT /polling-failure-alerts/{id}/status PollingSchedulerService.handleAlert 告警处理
PUT /polling-rate-limit-groups/{id} GatewayService.updateGroup 网关限流组维护
PUT /polling-rate-limit-groups/{id}/status GatewayService.setGroupStatus 网关限流组维护

16 个既有接口改动的处理

既有接口 接入结果
GET /polling-configs 列表新增资产/套餐条件、重置日前窗口和间隔列
GET /polling-configs/:id 编辑读入全部新增字段,废弃保护间隔不再参与
POST /polling-configs 白名单保存新增匹配及窗口字段、三态间隔,展示 warnings
PUT /polling-configs/:id clear_fields 显式清空,0 保留,展示 warnings
GET /assets/resolve/:identifier 不再映射废弃保护期展示;其余资产身份不变
GET /assets/:identifier/realtime-status 不再更新保护期 UI 字段
POST /assets/:identifier/refresh 沿用刷新读取,界面无保护期展示
GET /api/c/v1/asset/info 独立 C 端同步项,本仓库不改
PUT /carriers/:id 0→1 首次不带确认;展示后端实际影响后确认重提
GET /system-configs 新增 polling 模块,复用 string/int/bool/json 编辑与校验
GET /iot-cards/standalone 三态是否轮询筛选,保留 false
GET /devices 新增筛选与是否轮询列
PATCH /assets/:identifier/polling-status 先读 impact 确认,拒绝/取消恢复 UI,不提供强制参数
POST /storage/upload-url purpose=polling_status_import;校验 key 前缀后上传,成功才建任务
POST /export-tasks 三个新增场景;卡/设备保留 enable_polling 筛选
GET /export-tasks 三个场景列表、共用详情与下载权限;历史文件不做客户端改写

PUT /system-configs/:key 继续走原编辑能力,新增键来自服务器;本次不会自动修改 scheduler、rate_limit_mode、queue_enabled。

验证与限制

本地复现:

$tests = @(rg --files scripts/tests -g '*.test.mjs')
node --import ./scripts/tests/register-esbuild.mjs --test $tests
.\node_modules\.bin\vue-tsc.cmd --noEmit
node scripts/tests/verifyBuild.mjs
node scripts/tests/verifyBuild.mjs --serve --scheduler

最后一项在 http://127.0.0.1:5190 启动本地 mock,所有 /api 被拦截;可使用 local-scheduler-platform/admin/agent/enterprise 模拟 token。该结果不等于线上后端已联调。

已覆盖:46 路径映射、22 新方法请求结构、null/0/false、清空与废弃字段、权限/身份、500 条和 CSV 50000 行边界、引号换行、部分成功、影响说明失败/取消、上传失败、迟到请求/账号范围切换/卸载、模板编译。旧实名管控回归改成后端实际文案确认。

生产构建的既有循环依赖、常量 v-model 和大 chunk 警告仍存在;未在本次跨范围重构。后端若将实名确认提示升级为独立错误码,可替换当前的语义识别,避免依赖提示中的“实名/确认”关键词。当前未知网络错误或不相关错误不会触发确认重试。

2026-10-26 最终回归:全量 191 项通过(本次调度接入新增 17 项,保留并升级原有回归)。类型检查、生产构建、针对性 ESLint / Prettier / 新增组件样式检查、全仓 UTF-8 编码检查通过。

浏览器使用本地 mock 验证了平台账号入口、特殊告警视图、批量 impact 确认与四类逐项结果、CSV 上传建任务/详情、演练汇总与明细、时间格式、网关 80% 成功率及 p95 超桶显示;检查了浅/深色与 375/390/768/1024/1440 宽度布局。开发热更新仍可能遇到项目既有 API 循环依赖,刷新后进行验收,不把热更新错误当作真实接口结果。

真实后端账号、数据范围、错误码、异步终态和导出文件内容需由部署后的联调确认;本次未进行线上写入、Git 推送或部署。