Design: 套餐真流量预警前端对接

背景

后端已按 docs/产品迭代8月份/套餐真流量预警_API_前端简版.md 在测试环境上线 6 个接口（released）。前端需要新增规则配置与预警记录两个页面，并接入既有权限与导出任务体系。本设计记录关键决策。

决策

1. 页面挂载位置：套餐管理分组

规则数据源是套餐商品（package_id），预警记录也按套餐筛选，因此两个页面都挂在既有 /package-management 路由分组下，与套餐列表、代理系列授权平级。

路由：/package-management/traffic-alert-rules、/package-management/traffic-alerts
详情：/package-management/traffic-alerts/detail/:id（隐藏路由）

2. 导出走专用接口 + 专用弹窗，不复用 ExportTaskCreateDialog

既有 ExportTaskCreateDialog 调用通用 POST /api/admin/export-tasks，而真流量预警导出是专用端点 POST /api/admin/package-traffic-alerts/export，请求体为 format + 与列表一致的一组筛选参数。因此：

新建轻量弹窗（或扩展 ExportTaskCreateDialog 支持自定义 submit），展示“基于当前筛选条件全量导出，不仅导出当前分页数据”
提交成功后提示“导出任务已创建”，并提供跳转既有导出任务列表页的入口，下载走既有能力
导出任务列表若按场景过滤，需要新增场景配置；场景枚举值联调时与后端确认后落入 EXPORT_TASK_SCENE_CONFIG

3. 权限模型

遵循八月迭代约定：权限编码集中定义在 AUGUST_PERMISSIONS.packageTrafficAlert，页面/按钮通过 v-permission + useAuth().hasAuth 引用
页面级：rules_view / records_view 控制菜单与按钮可见性（后端菜单权限同源）
按钮级：规则创建/修改（含启停）、记录详情、导出分别独立编码
403 策略：接口对无权限账号统一返回 403；列表接口 403 时提示“无权限访问”；详情越权按资源不可见处理（复用现有 404 类提示文案），不暴露资源存在性

4. 阈值输入校验

前端 ElInputNumber：min=1、max=100、precision=2
创建时 threshold_percent 必填；修改时三字段均可选（后端按传入字段更新）
remark 创建/修改均限制 500 字符（maxlength + 计数器）

5. 快照与归属变化展示

列表与详情的业务字段均为触发时快照，仅 business_user_group_names 为当前值
详情中 shop_changed_since_trigger / owner_changed_since_trigger 为 true 时，用 ElAlert（info）提示归属已变化，并展示当前店铺/业务员与快照值
空值约定：无店铺/业务员时字段可能为 null 或空数组，统一渲染 -（业务员数组 join 展示，空数组显示 -）

6. 规则列表的 real_data_mb 展示

real_data_mb 为套餐商品当前真流量额度，仅用于配置校验展示（如“按 80% 约对应 x GB”），不作为预警分母
页面以 GB 展示（/1024，保留两位小数），避免 MB 数字过长

风险

记录列表/详情接口字段名未完整给出，联调时以测试环境实际返回为准，类型定义需保留一定弹性（可选字段）
导出任务场景值未给出，若后端未登记场景枚举，导出任务列表页的场景筛选需兼容新值

3.3 KiB Raw Blame History Unescape Escape