11 KiB
轮询账户限流:后台接入交付
本次仅修改本后台前端,未修改独立 C 端、未推送 Git 或部署生产、未配置数据库菜单。真实接口权限和调度行为仍需测试环境联调。本地写操作全部通过 mock 验证。
后台配置与使用
新增菜单、隐藏详情、按钮编码和平台账号限制见 权限增量清单。原有网关、轮询配置预览/统计、停复机记录 URL 和权限保留。仅超级管理员的维护项不列入普通配置清单。
UI 沿用店铺列表表头、可选列、分页和店铺详情返回/标题/两列布局;窄屏详情单列。时间统一店铺格式,运营商账户按名称远程搜索,搜索条件 >=4 才出现展开。
新增配置字段现可保存,旧文档“仅预览”已失效。四项间隔:空继承、0 禁止且不再继承、正数执行。编辑清空使用 clear_fields,保存 warnings 单独展示;不再发送保护期间隔。
C 端需要同步哪些
必须修改(文档明确要求)
- C 端资产详情调用
GET /api/c/v1/asset/info后,不再展示保护期状态(device_protect_status),包括标签、说明、倒计时和相关状态分支(如有)。 - 废弃字段可能仍返回固定
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 推送或部署。