438 lines
31 KiB
Markdown
438 lines
31 KiB
Markdown
# 权限清单
|
||
|
||
## 套餐管理:真流量预警规则
|
||
|
||
页面 URL:`/package-management/traffic-alert-rules`
|
||
|
||
| 类型 | 权限名称 | 权限编码 |
|
||
| -------- | ------------- | ------------------------------------ |
|
||
| 页面查看 | `rulesView` | `package_traffic_alert:rules_view` |
|
||
| 新增规则 | `ruleCreate` | `package_traffic_alert:rule_create` |
|
||
| 编辑规则 | `ruleUpdate` | `package_traffic_alert:rule_update` |
|
||
| 启用规则 | `ruleEnable` | `package_traffic_alert:rule_enable` |
|
||
| 停用规则 | `ruleDisable` | `package_traffic_alert:rule_disable` |
|
||
|
||
启用和停用不得复用编辑权限。
|
||
|
||
## 套餐管理:真流量达量预警
|
||
|
||
| 页面/操作 | URL | 权限名称 | 权限编码 |
|
||
| --- | --- | --- | --- |
|
||
| 预警列表 | `/package-management/traffic-alerts` | `recordsView` | `package_traffic_alert:records_view` |
|
||
| 点击套餐名称进入预警详情 | `/package-management/traffic-alerts/detail/:id` | `recordDetail` | `package_traffic_alert:record_detail` |
|
||
| 导出预警记录 | — | `export` | `package_traffic_alert:export` |
|
||
| 导出任务页面 | `/asset-management/export-task-management/export-package-traffic-alert` | `page` | `export_task:package_traffic_alert_page` |
|
||
|
||
## 店铺管理:店铺列表
|
||
|
||
| 页面/操作 | URL | 权限名称 | 权限编码 |
|
||
| --- | --- | --- | --- |
|
||
| 店铺列表 | `/shop-management/list` | `listView` | `shop:list_view` |
|
||
| 店铺详情 | `/shop-management/detail/:id` | `detailView` | `shop:detail_view` |
|
||
| 新增店铺 | — | — | `shop:add` |
|
||
| 批量交接 | — | `batch` | `shop:business_owner_batch` |
|
||
| 导入业务员 | — | `importPage` | `shop:business_owner_import_view` |
|
||
| 查看店铺详情 | — | — | `shop:detail` |
|
||
| 切换店铺状态 | — | — | `shop:modify_status` |
|
||
| 账号列表 | — | — | `shop:look_customer` |
|
||
| 默认角色 | — | — | `shop:default_role` |
|
||
| 调整实际信用额度 | — | — | `shop:credit_limit_manage` |
|
||
| 编辑店铺 | — | — | `shop:edit` |
|
||
| 删除店铺 | — | — | `shop:delete` |
|
||
| 审计记录 | — | — | `audit:shop_entry` / `audit:agent_resource_activity` |
|
||
| 资金链路 | — | — | `audit:finance_timeline` |
|
||
|
||
## 店铺管理:业务用户组
|
||
|
||
页面 URL:`/shop-management/business-user-groups`
|
||
|
||
| 类型 | 权限名称 | 权限编码 |
|
||
| -------- | --------- | ----------------------------- |
|
||
| 页面查看 | `page` | `business_user_group:page` |
|
||
| 新增 | `create` | `business_user_group:create` |
|
||
| 编辑 | `update` | `business_user_group:update` |
|
||
| 删除 | `delete` | `business_user_group:delete` |
|
||
| 成员管理 | `members` | `business_user_group:members` |
|
||
|
||
## 店铺管理:批量换绑业务员
|
||
|
||
页面 URL:`/shop-management/business-owner-import`
|
||
|
||
| 类型 | 权限名称 | 权限编码 |
|
||
| ---------------------------- | -------------- | ----------------------------------- |
|
||
| 页面查看 | `importPage` | `shop:business_owner_import_view` |
|
||
| 创建导入任务 | `importCreate` | `shop:business_owner_import_create` |
|
||
| 详情按钮 | `importDetail` | `shop:business_owner_import_detail` |
|
||
| 详情页面(当前为列表页抽屉) | `importDetail` | `shop:business_owner_import_detail` |
|
||
|
||
## 店铺管理:代理注册申请
|
||
|
||
列表不显示操作列,点击“申请店铺”名称进入详情页。
|
||
|
||
| 页面/操作 | URL | 权限名称 | 权限编码 |
|
||
| --- | --- | --- | --- |
|
||
| 申请列表 | `/shop-management/agent-distribution-registrations` | `list` | `agent_distribution_registration:list` |
|
||
| 申请详情 | `/shop-management/agent-distribution-registrations/detail/:id` | `detail` | `agent_distribution_registration:detail` |
|
||
| 恢复审批 | — | `recoverApproval` | `agent_distribution_registration:recover_approval` |
|
||
|
||
## 资产管理:手机号资产关联
|
||
|
||
页面 URL:`/asset-management/phone-asset-association`
|
||
|
||
| 类型 | 权限名称 | 权限编码 |
|
||
| ---------------- | -------------------- | ---------------------------------------------- |
|
||
| 页面查看 | `list` | `phone_asset_association:list` |
|
||
| 单条解绑 | `unbind` | `phone_asset_association:unbind` |
|
||
| 批量解绑 | `unbindBatch` | `phone_asset_association:unbind_batch` |
|
||
| 解绑导入页面 | `unbindImportPage` | `phone_asset_association:unbind_import_view` |
|
||
| 创建解绑导入任务 | `unbindImportCreate` | `phone_asset_association:unbind_import_create` |
|
||
|
||
## 资产管理:解绑导入任务
|
||
|
||
| 页面/操作 | URL | 权限名称 | 权限编码 |
|
||
| --- | --- | --- | --- |
|
||
| 任务列表 | `/asset-management/task-management/phone-asset-unbind-import-tasks` | `unbindImportPage` | `phone_asset_association:unbind_import_page` |
|
||
| 任务详情 | `/asset-management/task-management/phone-asset-unbind-import-tasks/detail` | `unbindImportDetail` | `phone_asset_association:unbind_import_detail` |
|
||
| 详情按钮 | — | `unbindImportDetail` | `asset_association:unbind_import_detail` |
|
||
|
||
## 资产管理:临期资产
|
||
|
||
页面 URL:`/asset-management/expiring-assets`
|
||
|
||
| 类型 | 权限名称 | 权限编码 |
|
||
| -------- | -------- | ----------------------- |
|
||
| 页面查看 | `page` | `expiring_asset:page` |
|
||
| 导出 | `export` | `expiring_asset:export` |
|
||
|
||
## 资产管理:导出任务页面
|
||
|
||
详情按钮为导出任务列表中的任务编号点击入口,权限编码按导出场景区分;详情页面统一使用 `id` 查询参数。
|
||
|
||
| 导出场景 | 列表页面 URL | 页面权限编码 | 详情按钮权限编码 | 详情页面 URL |
|
||
| --- | --- | --- | --- | --- |
|
||
| 设备 | `/asset-management/export-task-management/export-device` | `export_task:device_page` | `export_task:device_detail` | `/asset-management/export-task-management/export-task-detail?id=:id` |
|
||
| IoT 卡 | `/asset-management/export-task-management/export-iot-card` | `export_task:iot_card_page` | `export_task:iot_card_detail` | `/asset-management/export-task-management/export-task-detail?id=:id` |
|
||
| 订单 | `/asset-management/export-task-management/export-order` | `export_task:order_page` | `export_task:order_detail` | `/asset-management/export-task-management/export-task-detail?id=:id` |
|
||
| 套餐 | `/asset-management/export-task-management/export-package` | `export_task:package_page` | `export_task:package_detail` | `/asset-management/export-task-management/export-task-detail?id=:id` |
|
||
| 代理主钱包流水 | `/asset-management/export-task-management/export-agent-wallet-transaction` | `export_task:agent_wallet_transaction_page` | `export_task:agent_wallet_transaction_detail` | `/asset-management/export-task-management/export-task-detail?id=:id` |
|
||
| 代理充值 | `/asset-management/export-task-management/export-agent-recharge` | `export_task:agent_recharge_page` | `export_task:agent_recharge_detail` | `/asset-management/export-task-management/export-task-detail?id=:id` |
|
||
| 退款 | `/asset-management/export-task-management/export-refund` | `export_task:refund_page` | `export_task:refund_detail` | `/asset-management/export-task-management/export-task-detail?id=:id` |
|
||
| 换货 | `/asset-management/export-task-management/export-exchange` | `export_task:exchange_page` | `export_task:exchange_detail` | `/asset-management/export-task-management/export-task-detail?id=:id` |
|
||
| 佣金明细 | `/asset-management/export-task-management/export-commission-record` | `export_task:commission_record_page` | `export_task:commission_record_detail` | `/asset-management/export-task-management/export-task-detail?id=:id` |
|
||
| 套餐真流量达量预警 | `/asset-management/export-task-management/export-package-traffic-alert` | `export_task:package_traffic_alert_page` | `export_task:package_traffic_alert_detail` | `/asset-management/export-task-management/export-task-detail?id=:id` |
|
||
| 临期资产 | `/asset-management/export-task-management/export-expiring-asset` | `export_task:expiring_asset_page` | `export_task:expiring_asset_detail` | `/asset-management/export-task-management/export-task-detail?id=:id` |
|
||
| 设备激活报表 | `/asset-management/export-task-management/export-operations-activation` | `export_task:operations_activation_page` | `export_task:operations_activation_detail` | `/asset-management/export-task-management/export-task-detail?id=:id` |
|
||
| 套餐续费报表 | `/asset-management/export-task-management/export-operations-renewal` | `export_task:operations_renewal_page` | `export_task:operations_renewal_detail` | `/asset-management/export-task-management/export-task-detail?id=:id` |
|
||
|
||
## 财务管理:退款管理
|
||
|
||
| 页面/操作 | URL | 权限名称 | 权限编码 |
|
||
| --------- | ---------------------------- | ----------------- | ------------------------- |
|
||
| 退款列表 | `/finance/refund` | `page` | `refund:page` |
|
||
| 退款详情 | `/finance/refund/detail/:id` | `detailPage` | `refund:detail_page` |
|
||
| 恢复审批 | — | `recoverApproval` | `refund:recover_approval` |
|
||
|
||
## 财务管理:员工代收款账单
|
||
|
||
| 页面/操作 | URL | 权限名称 | 权限编码 |
|
||
| --- | --- | --- | --- |
|
||
| 账单列表 | `/finance/employee-collection/bills` | `billPage` | `employee_collection:bill_view` |
|
||
| 账单详情 | `/finance/employee-collection/bills/detail/:id` | `billDetail` | `employee_collection:bill_detail` |
|
||
| 创建核销申请 | — | `applicationCreate` | `employee_collection:application_create` |
|
||
| 关闭账单 | — | `billClose` | `employee_collection:bill_close` |
|
||
|
||
## 财务管理:核销申请
|
||
|
||
| 页面/操作 | URL | 权限名称 | 权限编码 |
|
||
| --- | --- | --- | --- |
|
||
| 申请列表 | `/finance/employee-collection/applications` | `applicationPage` | `employee_collection:application_view` |
|
||
| 申请详情 | `/finance/employee-collection/applications/detail/:id` | `applicationDetail` | `employee_collection:application_detail` |
|
||
| 修改并重新提交 | — | `applicationUpdate` | `employee_collection:application_update` |
|
||
| 查看凭证 | — | `applicationViewVoucher` | `employee_collection:application_view_voucher` |
|
||
| 恢复审批 | — | `applicationRecoverApproval` | `employee_collection:application_recover_approval` |
|
||
|
||
## 财务管理:收款方式管理
|
||
|
||
页面 URL:`/finance/employee-collection/payment-methods`
|
||
|
||
| 类型 | 权限名称 | 权限编码 |
|
||
| -------- | --------------------- | ------------------------------------------- |
|
||
| 页面查看 | `paymentMethodPage` | `employee_collection:payment_method_view` |
|
||
| 新增 | `paymentMethodCreate` | `employee_collection:payment_method_create` |
|
||
| 编辑 | `paymentMethodEdit` | `employee_collection:payment_method_edit` |
|
||
| 删除 | `paymentMethodDelete` | `employee_collection:payment_method_delete` |
|
||
|
||
## 财务管理:代理商资金概况
|
||
|
||
页面 URL:`/finance/agent-fund-overview`
|
||
|
||
| 类型 | 权限名称 | 权限编码 |
|
||
| ------------ | ------------------ | --------------------------------------- |
|
||
| 页面查看 | `page` | `agent_fund_overview:page` |
|
||
| 佣金明细导出 | `commissionExport` | `agent_fund_overview:commission_export` |
|
||
|
||
## 设置:商户池管理
|
||
|
||
| 页面/操作 | URL | 权限名称 | 权限编码 |
|
||
| --- | --- | --- | --- |
|
||
| 管理页面 | `/settings/payment-merchant-pools` | `page` | `payment_merchant_pool:page` |
|
||
| 商户详情 | `/settings/payment-merchant-pools/detail/:id` | `merchantDetail` | `payment_merchant_pool:merchant_detail` |
|
||
| 商户池详情 | `/settings/payment-merchant-pools/pool-detail/:id` | `poolDetail` | `payment_merchant_pool:pool_detail` |
|
||
| 新增/编辑/启停/删除商户 | — | — | `payment_merchant_pool:merchant_create` / `merchant_edit` / `merchant_toggle` / `merchant_delete` |
|
||
| 新增/编辑/启停商户池 | — | — | `payment_merchant_pool:pool_create` / `pool_edit` / `pool_toggle` |
|
||
| 保存微信授权配置 | — | `wechatAuthEdit` | `payment_merchant_pool:wechat_auth_edit` |
|
||
|
||
## 设置:H5运营弹窗配置
|
||
|
||
| 页面/操作 | URL | 权限名称 | 权限编码 |
|
||
| --- | --- | --- | --- |
|
||
| 配置列表 | `/settings/h5-popup-configuration` | `list` | `h5_popup_configuration:list` |
|
||
| 配置详情 | `/settings/h5-popup-configuration/detail/:id` | `detail` | `h5_popup_configuration:detail` |
|
||
| 新增/编辑/启用/停用 | — | — | `h5_popup_configuration:create` / `update` / `enable` / `disable` |
|
||
|
||
## 设置:资产钱包自动续费
|
||
|
||
| 页面/操作 | URL | 权限名称 | 权限编码 |
|
||
| --- | --- | --- | --- |
|
||
| 页面查看 | `/settings/asset-wallet-auto-renewal` | `page` | `asset_wallet_auto_renewal:page` |
|
||
| 保存配置 | — | `update` | `asset_wallet_auto_renewal:update` |
|
||
|
||
## 轮询管理:优先队列
|
||
|
||
页面 URL:`/polling-management/priority-queue`
|
||
|
||
| 类型 | 权限名称 | 权限编码 |
|
||
| ------------ | -------- | ------------------------------- |
|
||
| 页面查看 | `page` | `polling_priority_queue:page` |
|
||
| 人工优先入队 | `create` | `polling_priority_queue:create` |
|
||
| 查看详情 | `detail` | `polling_priority_queue:detail` |
|
||
|
||
## 运营报表:设备激活报表
|
||
|
||
页面 URL:`/operations-reports/activation`
|
||
|
||
| 类型 | 权限名称 | 权限编码 |
|
||
| -------- | ------------------ | -------------------------------------- |
|
||
| 页面查看 | `activationPage` | `operations_reports:activation_page` |
|
||
| 导出 | `activationExport` | `operations_reports:activation_export` |
|
||
|
||
## 运营报表:套餐续费报表
|
||
|
||
页面 URL:`/operations-reports/renewal`
|
||
|
||
| 类型 | 权限名称 | 权限编码 |
|
||
| -------- | --------------- | ----------------------------------- |
|
||
| 页面查看 | `renewalPage` | `operations_reports:renewal_page` |
|
||
| 导出 | `renewalExport` | `operations_reports:renewal_export` |
|
||
|
||
## 通用:导出任务详情
|
||
|
||
页面 URL:`/asset-management/export-task-management/export-task-detail`
|
||
|
||
- 页面权限:`export_task:detail_page`
|
||
- 各场景详情权限:`export_task:<scene>_detail`
|
||
- 各场景下载权限:`export_task:<scene>_download`
|
||
|
||
所有权限编码必须保持唯一;页面 URL 权限与按钮权限应分别定义。
|
||
|
||
## 轮询管理:网关限流
|
||
|
||
以下仅列普通账号需要配置的项。父菜单为已有「轮询管理」`/polling-management`,无需新增一级菜单。
|
||
|
||
| 菜单名称 | URL | 父菜单 | 菜单权限编码 |
|
||
| --- | --- | --- | --- |
|
||
| 停复机记录 | `/polling-management/stop-resume-records` | 轮询管理 | `card_stop_resume_record:page` |
|
||
| 上游错误分类 | `/polling-management/error-classifications` | 轮询管理 | `gateway_error_classification:page` |
|
||
| 网关限流组 | `/polling-management/rate-limit-groups` | 轮询管理 | `gateway_rate_limit_group:page` |
|
||
| 网关调用统计 | `/polling-management/gateway-stats` | 轮询管理 | `gateway_call_stats:page` |
|
||
| 网关限流组详情(隐藏) | `/polling-management/rate-limit-groups/detail/:id` | 轮询管理 | `gateway_rate_limit_group:detail_page` |
|
||
|
||
详情为轮询管理下的同级隐藏路由,不挂在列表组件下。`:id` 保留路由参数形式;普通账号需同时获得该隐藏菜单与「查看详情」按钮授权。
|
||
|
||
| 按钮名称 | 所属菜单/位置 | 按钮权限编码 |
|
||
| --- | --- | --- |
|
||
| 测试分类 / 草稿测试 | 上游错误分类 | `gateway_error_classification:test` |
|
||
| 查看详情 | 网关限流组 | `gateway_rate_limit_group:detail` |
|
||
| 查询趋势 | 网关调用统计 | `gateway_call_stats:trend` |
|
||
| 停复机记录 | 资产管理 → 单卡信息,卡信息头部 | `iot_info:stop_resume_records` |
|
||
| 停复机记录 | 资产管理 → 单卡信息,设备绑定卡操作区 | `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 警告。
|
||
|
||
## 订单分类与沉默期(2026-10-28)
|
||
|
||
后台实现已按 Apifox 定义补齐。以下为实际路由和前端权限约定;后端仍需创建真实菜单/按钮记录并独立校验权限与数据范围。未推送、部署或写入服务器菜单,真实支付/审批/退款/导出需测试环境联调。准确范围见 [执行记录](../openspec/changes/add-order-segmentation-and-package-silence/implementation.md)。
|
||
|
||
### 新增可见菜单
|
||
|
||
| 菜单名称 | URL | 父菜单 | 菜单权限 |
|
||
| --- | --- | --- | --- |
|
||
| 平台订单 | `/order-management/platform-orders` | 订单管理 `/order-management` | `orders:platform_page` |
|
||
| 代理商订单 | `/order-management/agent-orders` | 订单管理 | `orders:agent_page` |
|
||
| 在线支付订单 | `/order-management/online-orders` | 订单管理 | `orders:online_page` |
|
||
| 延期订单 | `/package-management/silence-orders` | 套餐管理 `/package-management` | `package_silence:orders_page` |
|
||
| 延期批次与异常 | `/package-management/silence-batches` | 套餐管理 | `package_silence:batches_page` |
|
||
| 沉默期临期/过期套餐 | `/package-management/silence-usages` | 套餐管理 | `package_silence:usages_page` |
|
||
| 延期政策 | `/package-management/silence-policies` | 套餐管理 | `package_silence:policies_page`(并需 `package_silence:policy`) |
|
||
| 导出平台订单 | `/asset-management/export-task-management/export-order-platform` | 导出管理 `/asset-management/export-task-management` | `export_task:order_platform_page` |
|
||
| 导出代理商订单 | `/asset-management/export-task-management/export-order-agent` | 导出管理 | `export_task:order_agent_page` |
|
||
| 导出在线支付订单 | `/asset-management/export-task-management/export-order-online` | 导出管理 | `export_task:order_online_page` |
|
||
| 导出延期订单 | `/asset-management/export-task-management/export-silence-order` | 导出管理 | `export_task:package_silence_order_page` |
|
||
| 导出沉默期套餐 | `/asset-management/export-task-management/export-silence-usage` | 导出管理 | `export_task:package_silence_usage_page` |
|
||
|
||
代理账号仅可配置平台/代理商普通订单及其导出;在线普通订单及导出只允许 user_type=1/2。企业不得配置普通订单菜单。旧普通订单列表/详情保留。沉默期模块没有额外虚构身份范围,按后端真实授权及数据范围工作。
|
||
|
||
### 新增隐藏详情菜单
|
||
|
||
| 菜单名称 | URL | 父菜单 | 菜单权限 |
|
||
| --- | --- | --- | --- |
|
||
| 延期订单详情 | `/package-management/silence-orders/detail/:id` | 套餐管理 | `package_silence:order_detail_page` |
|
||
| 延期批次详情 | `/package-management/silence-batches/detail/:id` | 套餐管理 | `package_silence:batch_detail_page` |
|
||
|
||
直接访问详情同时要求对应列表页权限、隐藏详情菜单权限和下表详情按钮权限;不能只配隐藏详情菜单。导出详情沿用已有隐藏 `export_task:detail_page` 与已有导出详情 URL。仅超管专属配置不列入普通菜单清单。
|
||
|
||
### 新增及沿用按钮权限
|
||
|
||
| 操作 | 权限编码 |
|
||
| --- | --- |
|
||
| 下单时调整本次沉默期(两个单项购买入口) | `package_silence:override` |
|
||
| 扫码付费延期、单项特殊延期 | `package_silence:extend` |
|
||
| 批量特殊延期(含 CSV 导入) | 同时需要 `package_silence:extend`、`package_silence:extend_batch` |
|
||
| 登记线下付费延期 | `package_silence:offline` |
|
||
| 异常明细重试/关闭 | `package_silence:exception` |
|
||
| 政策查询/新增/编辑/启停/匹配 | `package_silence:policy` |
|
||
| 查看延期订单详情 | `package_silence:order_detail` |
|
||
| 查看延期批次详情 | `package_silence:batch_detail` |
|
||
| 创建延期订单导出 | `package_silence:order_export` |
|
||
| 创建沉默期套餐清单导出 | `package_silence:usage_export` |
|
||
| 创建普通订单/查看详情/导出 | 沿用 `orders:add` / `orders:view_detail` / `orders:export` |
|
||
| 平台普通订单导出详情/下载 | `export_task:order_platform_detail` / `export_task:order_platform_download` |
|
||
| 代理商普通订单导出详情/下载 | `export_task:order_agent_detail` / `export_task:order_agent_download` |
|
||
| 在线普通订单导出详情/下载 | `export_task:order_online_detail` / `export_task:order_online_download` |
|
||
| 延期订单导出详情/下载 | `export_task:package_silence_order_detail` / `export_task:package_silence_order_download` |
|
||
| 沉默期套餐导出详情/下载 | `export_task:package_silence_usage_detail` / `export_task:package_silence_usage_download` |
|
||
|
||
沉默期流水、首次购买记录没有在后端文档声明独立按钮权限,继承所属资产/列表页的读取范围,不虚构按钮编码。角色配置继续使用后端真实权限树,需后端提供权限记录和 ID,前端不伪造记录。
|
||
|
||
### 操作边界与验证
|
||
|
||
- 默认商品沉默期 1–90 天,购买覆盖天数仅最小 1;付费延期天数/金额由资格和试算决定,不复制算法。
|
||
- 特殊延期 CSV 为前端解析:表头 `package_usage_id,days`,每行两个整数,转换为文档 items[];不假设后端导入文件格式。
|
||
- 政策免审批完整枚举未在 OpenAPI 给出;已有值原样保留,提供明确的 offline_paid/batch,其他值需填写后端精确编码。政策接口没有 DELETE,不提供删除。
|
||
- 二维码/线下同一快照重试复用幂等键;特殊请求结果不明时提示核对批次并阻止重复提交。待审批、已支付和已完成严格区分。
|
||
- 异常关闭必须填写原因并确认,提示在线订单可能原路退款;不直接修改套餐截止时间。
|
||
- 企业资产五项限制保持;首次购买为只读事实,不回填绑定卡或换货资产;对象缺失隐藏沉默期入口。
|
||
- 236 项测试、类型与生产构建通过;仅本地 mock 验收,没有真实支付、审批、退款、开关切换、导出、推送或部署。
|
||
|
||
### C 端同步(本仓库未修改)
|
||
|
||
独立 C 端需接入可选 silence、状态/格式化截止日及 extendable 入口;`/api/c/v1/package-silence` 下的资格、报价、自助下单/qr_content、订单状态刷新、我的延期订单/详情、流水。对象缺失或总开关关闭时隐藏入口;金额单位分、结果取后端,不能复制计费/审批算法,不调用后台 URL。资产归属由后端校验。
|