# 轮询账户限流:后台接入交付 本次仅修改本后台前端,未修改独立 C 端、未推送 Git 或部署生产、未配置数据库菜单。真实接口权限和调度行为仍需测试环境联调。本地写操作全部通过 mock 验证。 ## 后台配置与使用 新增菜单、隐藏详情、按钮编码和平台账号限制见 [权限增量清单](./权限.md#轮询管理运营商账户限流与调度2026-10-26-增量)。原有网关、轮询配置预览/统计、停复机记录 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。 ## 验证与限制 本地复现: ```powershell $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 推送或部署。