Files
one-pipe-system/docs/权限.md
luo f2614d8efb
All checks were successful
构建并部署前端到测试环境 / deploy (push) Successful in 54s
fix: some
2026-10-28 15:18:44 +08:00

438 lines
31 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 权限清单
## 套餐管理:真流量预警规则
页面 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。资产归属由后端校验。