33 lines
3.0 KiB
Markdown
33 lines
3.0 KiB
Markdown
# Change: 网关限流管理前端接入
|
||
|
||
## Why
|
||
|
||
`docs/网关限流.md` 新增 17 个管理端接口，当前前端缺少网关限流组、上游错误分类、全局停复机记录及按运营商统计的入口。需要完整接入已定义契约，并在交付时提供普通账号需要配置的菜单与按钮权限，不列出仅超级管理员的操作。
|
||
|
||
## What Changes
|
||
|
||
- 在现有「轮询管理」下新增「停复机记录」「上游错误分类」「网关限流组」「网关调用统计」四个页面。
|
||
- 接入全部 17 个接口及类型；枚举通过 `GET /api/admin/polling-options` 获取，不把可配置枚举仅写死在前端。
|
||
- 停复机记录支持文档内筛选、分页、必填时间范围和 31 天跨度校验；单卡信息及设备绑定卡提供单卡历史入口，使用卡 ID 请求新接口。
|
||
- 分类规则支持分页筛选、测试现有规则和草稿；限流组支持分页筛选和详情。新建、修改、启停、删除均仅向超级管理员开放，并在操作函数中再次检查身份。
|
||
- 限流组表单校验 QPS、预留额度与高优先级操作的关系，删除和启停提供确认与防重复提交。
|
||
- 网关统计支持账户汇总及账户趋势查询，校验各接口时间参数。
|
||
- 接入路由别名、静态路由和现有后端菜单模式；使用 `xxx:xxx` 格式前端权限常量控制普通用户操作。
|
||
- 新增契约、参数校验、权限分支和交互回归测试，运行类型检查、构建及编码检查。
|
||
- 完工后输出菜单配置清单（名称、URL、父菜单）与按钮权限编码；清单仅保留非超级管理员专属项。
|
||
|
||
## Impact
|
||
|
||
- Affected specs: `gateway-rate-limit-management`（新增）。当前 `openspec list --specs` 无已归档规范；现有 `add-polling-priority-queue` 已完成，与本次新增页面并列，不修改其行为。
|
||
- Affected code: `src/types/api/`、`src/api/modules/`、`src/config/constants/`、`src/views/polling-management/`、`src/views/asset-management/asset-information/`、`src/router/routesAlias.ts`、`src/router/routes/asyncRoutes.ts`、`scripts/tests/`。
|
||
- 不修改网关后端限流算法、既有轮询调度、停复机执行动作；不自动创建数据库菜单，不推送 Git，不执行生产部署。
|
||
- 保留用户在 `.gitea/workflows/deploy.yaml` 与 `package.json` 的现有修改。
|
||
|
||
## Contract boundary
|
||
|
||
文档未提供统计接口 `carriers[]`、`points[]` 内部字段，仓库当前也没有 `docs/admin-openapi.yaml` 可补全。实现不得假定次数、失败率、时间戳等字段：先按实际响应提供可查看的动态字段表格/原始数据，并清楚提示契约未展开；有真实字段样例后才绘制业务趋势图。不得用虚构字段或零值冒充统计结果。
|
||
|
||
权限编码是前端配置约定，并非接口文档声明的后端权限；实际授权仍由后端控制。仅超级管理员限制必须依据现有 `userStore.isSuperAdmin`，不能通过配置普通按钮权限绕过。
|
||
|
||
用户于 2026-10-24 回复「直接执行」，已批准按此范围实施。
|