This commit is contained in:
108
docs/权限.md
108
docs/权限.md
@@ -258,3 +258,111 @@
|
||||
| 停复机记录 | 资产管理 → 单卡信息,设备绑定卡操作区 | `device_info:stop_resume_records` |
|
||||
|
||||
查询、重置、分页与刷新使用页面权限,无需另配按钮。运营商名称搜索下拉需要当前账号能读取 `/api/admin/carriers`;这些前端编码不替代后端独立鉴权。
|
||||
|
||||
## 轮询管理:轮询配置预览与统计
|
||||
|
||||
本次只需新增一个菜单;已有「轮询配置」`/polling-management/config` 保留,不改旧 CRUD 权限。以下仅列普通账号需要配置的项。
|
||||
|
||||
| 菜单名称 | URL | 父菜单 | 菜单权限编码 |
|
||||
| --- | --- | --- | --- |
|
||||
| 轮询配置统计 | `/polling-management/config-stats` | 轮询管理 `/polling-management` | `polling_config_stats:page` |
|
||||
|
||||
| 按钮名称 | 所属菜单 | 按钮权限编码 |
|
||||
| --- | --- | --- |
|
||||
| 匹配预览 / 草稿预览 / 预览未保存修改 | 轮询配置 `/polling-management/config` | `polling_config:match_preview` |
|
||||
| 查询重算进度 | 轮询配置 `/polling-management/config` | `polling_config:recalculate_progress` |
|
||||
| 查看重置日前加密查流量效果统计 | 轮询配置统计 | `polling_config_stats:pre_reset` |
|
||||
| 查看分层轮询统计 | 轮询配置统计 | `polling_config_stats:tiers` |
|
||||
|
||||
统计菜单权限和区域权限需同时授权;若仅授权其中一个统计区域,另一区域不会请求接口。进度查询权限只允许查询已有任务,不授予创建任务的能力。上述编码是前端配置约定,后端独立鉴权。
|
||||
|
||||
### 接入说明
|
||||
|
||||
- 当前配置预览使用 GET;草稿预览使用 POST,并在 Query 和 Body 同时传入同一 ICCID。多条草稿可覆盖已有配置或以 id=0 新增,预览不调用持久化 CRUD。
|
||||
- 草稿中实名、流量、套餐、卡状态检查区分继承(null)、禁止且不再继承(0)、指定秒数(正数)。保护期已下线,表单和请求均移除。重置日前加密需明确开启,窗口和窗口内流量间隔成对设置。
|
||||
- 以 2026-10-26 完整接口文档为准:资产状态、套餐状态、重置日前窗口字段现已支持创建/编辑保存;编辑清空通过 `clear_fields`,保存成功展示 `warnings`。
|
||||
- 时间使用与店铺列表相同的 `formatDateTime`。运营商账户按名称远程搜索,仍提交数字 ID;搜索条件 >=4 时才显示展开按钮。
|
||||
- 任务进度每 3 秒查询一次,终态、失败、关闭、路由离开和卸载后停止;保留真实 task_id、任务状态及 string 类型的响应账户 ID。
|
||||
- 统计周期为 null 时显示「无周期数据」,真实 0 保留。分层统计标明 5 分钟缓存,未匹配配置的在库卡和已销售无套餐卡突出告警;刷新不宣称清除服务器缓存。
|
||||
|
||||
### 本地验证
|
||||
|
||||
```powershell
|
||||
node --test scripts/tests/pollingConfigExtensions.test.mjs
|
||||
.\node_modules\.bin\vue-tsc.cmd --noEmit
|
||||
node scripts/tests/verifyBuild.mjs
|
||||
node scripts/tests/verifyBuild.mjs --serve --polling
|
||||
```
|
||||
|
||||
最后一条命令启动 `http://127.0.0.1:5190` 的本地模拟接口页面;所有 `/api` 请求被拦截,不会对真实后端保存配置或创建任务。当前未进行真实后端联调、菜单数据写入、Git 推送或生产部署。
|
||||
|
||||
2026-10-26 验证:新增轮询配置测试 20 项、全量回归 174 项通过;类型、生产构建、针对性 lint / 格式 / 编码检查通过。浏览器验证了当前预览、草稿控件、异步进度、空周期/零值统计、普通账号入口及小屏布局。生产构建仍有项目既有循环依赖、其他页面常量绑定与大 chunk 警告。
|
||||
|
||||
## 轮询管理:运营商账户限流与调度(2026-10-26 增量)
|
||||
|
||||
本节在前两次配置的基础上新增,旧菜单和旧权限不必重建。仅列非超级管理员专属的菜单/按钮;标注“平台”的项只允许 user_type=1/2,权限码不能突破身份限制。前端编码是本项目约定,后端仍需独立授权。
|
||||
|
||||
### 新增可见菜单
|
||||
|
||||
| 菜单名称 | URL | 父菜单 | 菜单权限 |
|
||||
| --- | --- | --- | --- |
|
||||
| 运营商账户调度参数 | `/polling-management/carrier-params` | 轮询管理 `/polling-management` | `polling_carrier_params:page` |
|
||||
| 请求检查场景 | `/polling-management/check-scenes` | 轮询管理 | `polling_check_scene:page` |
|
||||
| 失败告警 | `/polling-management/failure-alerts` | 轮询管理 | `polling_failure_alert:page` |
|
||||
| 账户队列监控 | `/polling-management/carrier-queues` | 轮询管理 | `polling_carrier_queue:page` |
|
||||
| 停复机规则演练(平台) | `/polling-management/stop-resume-dry-run` | 轮询管理 | `stop_resume_dry_run:page` |
|
||||
| 不轮询清单(平台) | `/polling-management/polling-pauses` | 轮询管理 | `polling_pause:page` |
|
||||
| 轮询开关导入(平台) | `/polling-management/polling-status-imports` | 轮询管理 | `polling_status_import:page` |
|
||||
| 导出不轮询清单(平台) | `/asset-management/export-task-management/export-polling-pause` | 导出管理 `/asset-management/export-task-management` | `export_task:polling_pause_page` |
|
||||
| 导出停机被拒告警(平台) | `/asset-management/export-task-management/export-polling-stop-refused-alert` | 导出管理 | `export_task:polling_stop_refused_alert_page` |
|
||||
| 导出停复机规则演练(平台) | `/asset-management/export-task-management/export-stop-resume-rule-dry-run` | 导出管理 | `export_task:stop_resume_rule_dry_run_page` |
|
||||
|
||||
### 新增隐藏详情菜单
|
||||
|
||||
这些是独立页面,不是按钮编码,需配置隐藏路由;URL 参数保留,不替换为具体 ID。
|
||||
|
||||
| 菜单名称 | URL | 父菜单 | 菜单权限 |
|
||||
| --- | --- | --- | --- |
|
||||
| 运营商账户调度参数详情 | `/polling-management/carrier-params/detail/:carrier_id` | 轮询管理 | `polling_carrier_params:detail_page` |
|
||||
| 失败告警详情 | `/polling-management/failure-alerts/detail/:id` | 轮询管理 | `polling_failure_alert:detail_page` |
|
||||
| 轮询开关导入详情(平台) | `/polling-management/polling-status-imports/detail/:id` | 轮询管理 | `polling_status_import:detail_page` |
|
||||
|
||||
三个导出场景共用已有隐藏详情 `/asset-management/export-task-management/export-task-detail?id=任务ID`,沿用 `export_task:detail_page`,不再新增详情路由。
|
||||
|
||||
### 新增按钮权限编码
|
||||
|
||||
| 所属页面 | 按钮/能力 | 编码 |
|
||||
| --- | --- | --- |
|
||||
| 运营商账户调度参数 | 查看详情 | `polling_carrier_params:detail` |
|
||||
| 失败告警 | 查看详情 | `polling_failure_alert:detail` |
|
||||
| 失败告警 | 账户汇总 | `polling_failure_alert:summary` |
|
||||
| 失败告警 | 标记已处理(仅未处理状态) | `polling_failure_alert:handle` |
|
||||
| 失败告警 | 批量关闭卡轮询(平台) | `polling_failure_alert:close_polling` |
|
||||
| 失败告警 | 导出停机被拒(平台) | `polling_failure_alert:export` |
|
||||
| 停复机规则演练 | 导出演练明细(平台) | `stop_resume_dry_run:export` |
|
||||
| 不轮询清单 | 批量开启轮询(平台) | `polling_pause:restore` |
|
||||
| 不轮询清单 | 创建导出任务(平台) | `polling_pause:export` |
|
||||
| 轮询开关导入 | 上传并创建任务(平台) | `polling_status_import:create` |
|
||||
| 轮询开关导入 | 查看任务与逐行结果(平台) | `polling_status_import:detail` |
|
||||
| IoT 卡列表 | 批量开关轮询(平台/代理) | `iot_card:batch_polling` |
|
||||
| 设备列表 | 批量开关轮询(平台/代理) | `device:batch_polling` |
|
||||
| 单卡资产详情 / 卡级告警详情 | 查询单卡轮询状态 | `iot_info:polling_state` |
|
||||
| 设备资产详情的绑定卡 | 查询该绑定卡轮询状态 | `device_info:polling_state` |
|
||||
| 导出不轮询清单 | 查看详情 / 下载 | `export_task:polling_pause_detail` / `export_task:polling_pause_download` |
|
||||
| 导出停机被拒告警 | 查看详情 / 下载 | `export_task:polling_stop_refused_alert_detail` / `export_task:polling_stop_refused_alert_download` |
|
||||
| 导出停复机规则演练 | 查看详情 / 下载 | `export_task:stop_resume_rule_dry_run_detail` / `export_task:stop_resume_rule_dry_run_download` |
|
||||
|
||||
“详情”按钮及对应隐藏详情菜单需同时授权。告警详情内查看停复机记录复用已有 `iot_info:stop_resume_records`;资产单项轮询开关复用 `iot_info:auto_polling` / `device_info:auto_polling`,无需新编码。请求检查场景、队列监控无新增普通写按钮。系统配置沿用旧菜单与权限,仅新增 polling 模块选项。
|
||||
|
||||
### 操作边界
|
||||
|
||||
- 批量只提交当前勾选 ID,最多 500 条,不扩展成全量筛选;原因必填,先读 impact 再确认。四类逐项结果完整保留,部分成功不回滚。
|
||||
- 企业账号不开放批量;代理资产范围由后端校验。风险停机、已销户不提供“强制开启”。
|
||||
- 账户级告警 card_id=0 不请求单卡接口、不允许勾选关闭卡轮询;停机被拒视图隐藏并剔除不支持的筛选。
|
||||
- 导入仅 CSV,首行为表头,首列保留文本,最多 50000 数据行;上传成功后才创建任务。任务终态/请求失败停止自动刷新。
|
||||
- 演练仅判断不执行;明细 result 不改变汇总,导出也不带 result;演练允许每页 500,其他列表最大 100。
|
||||
- 调度、限流、指令队列开关不会因本次前端接入自动修改。旧并发配置仅 legacy 模式有效。
|
||||
|
||||
C 端同步项和接口覆盖/验证见 [本次接入交付说明](./2026-10-26-轮询账户限流-后台接入交付.md)。
|
||||
|
||||
本次验证:191 项回归通过;类型、生产构建、代码/样式/格式与 UTF-8 检查通过。仅本地 mock 验收,没有写入菜单数据、推送或部署;生产构建仍有项目既有循环依赖与大 chunk 警告。
|
||||
|
||||
Reference in New Issue
Block a user