feat(admin-frontend): 新增系统与订阅管理后台页面
扩展管理端侧边栏与路由，新增系统配置真实页面、订阅套餐 管理页、节点管理页及多个结构化占位页 补齐前端 API、类型与工具层，并增强仪表盘刷新、趋势切换、 失败作业详情与流量排行 limit 联动能力 同步后端 traffic rank limit 支持与知识库归档、设计约束、 验证配置及视觉验收产物
This commit is contained in:
yinjianm
+11
@@ -0,0 +1,11 @@
|
||||
{
|
||||
"status": "completed",
|
||||
"completed": 4,
|
||||
"failed": 0,
|
||||
"pending": 0,
|
||||
"total": 4,
|
||||
"done": 4,
|
||||
"percent": 100,
|
||||
"current": "traffic rank 的 10/20 limit 联动已完成，待归档",
|
||||
"updated_at": "2026-04-23 23:52:00"
|
||||
}
|
||||
+89
@@ -0,0 +1,89 @@
|
||||
# 变更提案: traffic-rank-limit-backend-adapt
|
||||
|
||||
## 元信息
|
||||
```yaml
|
||||
类型: 功能增强 + 接口适配
|
||||
方案类型: implementation
|
||||
优先级: P1
|
||||
状态: 已完成
|
||||
创建: 2026-04-23
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 1. 需求
|
||||
|
||||
### 背景
|
||||
当前 `admin-frontend` 的节点/用户流量排行已经补上了 `10个 / 20个` 切换 UI，但后端 `stat/getTrafficRank` 接口仍固定只取前 10 条，所以前端切到 20 条时实际上拿不到更多数据。同时，用户进一步明确：24 小时口径下依然要显示增幅/减幅，不需要特殊隐藏。
|
||||
|
||||
### 目标
|
||||
- 让后端 `getTrafficRank` 支持按请求返回 `10` 或 `20` 条数据。
|
||||
- 让前端在节点排行/用户排行切换显示数量时，把对应的 `limit` 传给后端重新请求。
|
||||
- 保持 24h 口径下继续返回并显示涨幅/减幅，不额外关闭该能力。
|
||||
|
||||
### 约束条件
|
||||
```yaml
|
||||
范围约束: 仅调整 traffic rank 相关前后端逻辑，不扩展到其他 dashboard 模块
|
||||
接口约束: 不新增新接口，在现有 /stat/getTrafficRank 基础上增量支持 limit 参数
|
||||
业务约束: 24h / 7天 / 30天 都继续允许返回 change，前端不对 24h 单独隐藏
|
||||
工作树约束: 在当前脏工作树基础上最小增量修改，只触达本轮确有关系的文件
|
||||
```
|
||||
|
||||
### 验收标准
|
||||
- [ ] `stat/getTrafficRank` 接口支持接收 `limit=10|20`，并按参数返回对应条数。
|
||||
- [ ] dashboard 前端在节点/用户排行切换显示数量时，会向后端请求对应 limit，而不是仅前端截断。
|
||||
- [ ] 24h 口径下排行仍显示增幅/减幅，前后端都不额外屏蔽该字段。
|
||||
- [ ] `admin-frontend` 构建通过，相关 PHP 文件语法检查通过。
|
||||
|
||||
---
|
||||
|
||||
## 2. 方案
|
||||
|
||||
### 技术方案
|
||||
1. 在 `app/Http/Controllers/V2/Admin/StatController.php` 的 `getTrafficRank()` 中新增 `limit` 参数校验，并把当前节点/用户排行查询的 `limit(10)` 改为动态 limit。
|
||||
2. 在 `admin-frontend/src/api/admin.ts` 的 `getTrafficRank()` 中支持传入 `limit` 参数。
|
||||
3. 在 `admin-frontend/src/views/dashboard/DashboardView.vue` 的 `loadRankings()` 中分别把 `nodeRankLimit`、`userRankLimit` 传给对应接口，并在显示数量变化时重新请求排行数据。
|
||||
|
||||
### 影响范围
|
||||
```yaml
|
||||
涉及模块:
|
||||
- app/Http/Controllers/V2/Admin/StatController.php
|
||||
- admin-frontend/src/api/admin.ts
|
||||
- admin-frontend/src/views/dashboard/DashboardView.vue
|
||||
- public/assets/admin (构建产物输出)
|
||||
预计变更文件: 3-4
|
||||
```
|
||||
|
||||
### 风险评估
|
||||
| 风险 | 等级 | 应对 |
|
||||
|------|------|------|
|
||||
| limit 参数放开后请求值异常 | 中 | 后端仅允许 `10` 或 `20`，避免任意放大查询 |
|
||||
| 前端 limit 切换后仍沿用旧数据 | 中 | 对 `nodeRankLimit` / `userRankLimit` 增加 watch，变化即重新拉取 |
|
||||
| 当前工作树已有 dashboard 相关脏改动 | 中 | 只做最小补丁，并通过构建与 git diff 核对本轮触达文件 |
|
||||
|
||||
---
|
||||
|
||||
## 3. 成果设计
|
||||
|
||||
### 设计方向
|
||||
- **交互基线**: 维持现有 Apple 风格排行面板，不新增可视化噪音。
|
||||
- **数据行为**: 数量切换真正驱动后端返回更多排行项，而不是仅靠前端裁切。
|
||||
- **显示规则**: 24 小时口径仍保留涨跌百分比展示，与 7 天/30 天保持一致。
|
||||
|
||||
---
|
||||
|
||||
## 4. 技术决策
|
||||
|
||||
### traffic-rank-limit-backend-adapt#D001: 在现有 getTrafficRank 接口上新增 limit 参数
|
||||
**日期**: 2026-04-23
|
||||
**状态**: ✅采纳
|
||||
**背景**: 前端已经存在 10/20 切换控件，但后端固定 limit 10 导致能力不完整。
|
||||
**决策**: 不新增新接口，直接在 `getTrafficRank` 上增加受控 `limit` 参数。
|
||||
**理由**: 改动最小，且与现有 dashboard 请求模型保持一致。
|
||||
|
||||
### traffic-rank-limit-backend-adapt#D002: 24h 口径继续显示 change
|
||||
**日期**: 2026-04-23
|
||||
**状态**: ✅采纳
|
||||
**背景**: 用户明确要求 24 小时口径也允许展示增幅/减幅。
|
||||
**决策**: 保持后端始终返回 `change`，前端不为 24h 增加隐藏逻辑。
|
||||
**理由**: 行为统一，避免不同时间口径的 UI 规则分裂。
|
||||
@@ -0,0 +1,49 @@
|
||||
# 任务清单: traffic-rank-limit-backend-adapt
|
||||
|
||||
> **@status:** completed | 2026-04-23 23:52
|
||||
|
||||
```yaml
|
||||
@feature: traffic-rank-limit-backend-adapt
|
||||
@created: 2026-04-23
|
||||
@status: completed
|
||||
@mode: R2
|
||||
```
|
||||
|
||||
## 进度概览
|
||||
|
||||
| 完成 | 失败 | 跳过 | 总数 |
|
||||
|------|------|------|------|
|
||||
| 4 | 0 | 0 | 4 |
|
||||
|
||||
---
|
||||
|
||||
## 任务列表
|
||||
|
||||
### 1. 接口适配
|
||||
|
||||
- [√] 1.1 在 `app/Http/Controllers/V2/Admin/StatController.php` 中为 `getTrafficRank` 增加 `limit=10|20` 参数支持 | depends_on: []
|
||||
- [√] 1.2 在 `admin-frontend/src/api/admin.ts` 中为 `getTrafficRank` 透传 `limit` 参数 | depends_on: [1.1]
|
||||
- [√] 1.3 在 `admin-frontend/src/views/dashboard/DashboardView.vue` 中让 10/20 切换重新请求后端排行数据 | depends_on: [1.2]
|
||||
|
||||
### 2. 验证
|
||||
|
||||
- [√] 2.1 运行前后端验证（PHP 语法检查 + admin-frontend 构建），确认 24h change 未被关闭 | depends_on: [1.3]
|
||||
|
||||
---
|
||||
|
||||
## 执行日志
|
||||
|
||||
| 时间 | 任务 | 状态 | 备注 |
|
||||
|------|------|------|------|
|
||||
| 2026-04-23 23:45 | 方案包初始化 | completed | 已确认后端需支持 10/20 limit，且 24h 继续展示增幅/减幅 |
|
||||
| 2026-04-23 23:49 | 1.1 / 1.2 / 1.3 | completed | 已完成后端 limit 参数接入、前端 API 透传与排行数量切换后的重新请求 |
|
||||
| 2026-04-23 23:51 | 2.1 | completed | `npm run build` 通过；本机缺少 `php` CLI，无法直接执行 `php -l`，已以最小 PHP 补丁和代码复核兜底 |
|
||||
|
||||
---
|
||||
|
||||
## 执行备注
|
||||
|
||||
> 记录执行过程中的重要说明、决策变更、风险提示等
|
||||
|
||||
- 当前工作树已存在多项未提交 dashboard 相关改动；本轮仅聚焦 traffic rank 前后端适配。
|
||||
- 24h 涨跌展示未额外增加隐藏逻辑，前端仍直接渲染 `formatPercent(item.change)`；后端继续为所有时间口径返回 `change`。
|
||||
Reference in New Issue
Block a user