# 权限清单 ## 套餐管理:真流量预警规则 页面 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:_detail` - 各场景下载权限:`export_task:_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。资产归属由后端校验。