feat(admin-frontend): 补齐用户节点与订单运营工作台

新增用户高级筛选、批量操作与更多行级动作，支持邮件、 CSV、封禁恢复、订单分配、邀请查看、流量记录与重置流量增强节点管理页的分页、父子筛选、跨页勾选、批量修改与单节点置顶，并补齐后端批量更新 host、group_ids、rate 修复订单佣金状态误判问题，新增真实佣金筛选与行级确认，同时优化仪表盘排行悬浮详情展示补充 admin-frontend 独立 Dockerfile、Caddy 配置与 GHCR 发布工作流，支持通过独立镜像部署管理前端
2026-04-24 23:15:48 +08:00
parent e393b11b61
commit d4168720ac
65 changed files with 4114 additions and 438 deletions
@@ -1,11 +1,11 @@
 {
  "status": "completed",
-  "completed": 4,
+  "completed": 5,
  "failed": 0,
  "pending": 0,
-  "total": 4,
-  "done": 4,
+  "total": 5,
+  "done": 5,
  "percent": 100,
-  "current": "24h 排行对昨天比较修复、测试补充与语法校验已完成",
-  "updated_at": "2026-04-24 19:25:00"
+  "current": "24h 排行对昨天比较修复、hover 详情卡与右侧流量展示已完成",
+  "updated_at": "2026-04-24 19:36:00"
 }
@@ -3,21 +3,26 @@
  "version": 1,
  "source": "R2",
  "originCommand": "design",
-  "verifyMode": "targeted-check",
+  "verifyMode": "review-first",
  "reviewerFocus": [
    "24h 排行比较窗口是否准确命中昨天整日统计",
    "7天 / 30天 对比逻辑是否保持原样，未被意外改动",
-    "节点排行与用户排行是否共用同一后端修复入口"
+    "节点/用户排行的 hover 详情卡与右侧流量值展示是否满足新增交互需求"
  ],
  "testerFocus": [
    "单日窗口应返回昨天整日作为 previous window",
    "多日窗口应继续沿用原等跨度比较规则",
-    "修改文件至少通过 PHP 语法校验"
+    "节点/用户排行 hover 时应展示 当前流量 / 上期流量 / 变化率",
+    "admin-frontend 执行 npm run build 应通过"
  ],
  "ui": {
-    "required": false,
-    "designContract": false,
-    "sourcePriority": [],
+    "required": true,
+    "designContract": true,
+    "sourcePriority": [
+      "plan.md",
+      ".helloagents/DESIGN.md",
+      "hello-ui"
+    ],
    "styleAdvisor": {
      "required": false,
      "reason": "",
@@ -26,8 +31,14 @@
    "visualValidation": {
      "required": false,
      "reason": "",
-      "screens": [],
-      "states": []
+      "screens": [
+        "#/dashboard node rank hover",
+        "#/dashboard user rank hover"
+      ],
+      "states": [
+        "排行 hover tooltip",
+        "当前流量右侧显示"
+      ]
    }
  },
  "advisor": {
@@ -19,19 +19,22 @@
 ### 目标
 - 修复 `24h` 排行涨跌百分比的对比窗口。
 - 保持本轮范围最小，只处理 `24h` 口径，不改动 `7天 / 30天` 的既有对比方式。
+- 为排行项补充 hover 详情卡，并把当前流量值移动到右侧强化展示。

 ### 约束条件
 ```yaml
 范围约束: 仅修复 admin 仪表盘 traffic rank 的 24h 对比逻辑
-技术约束: 优先做后端定点修复，不改动前端排行展示结构
+技术约束: 后端做 24h 定点修复，前端仅做排行 hover 信息与右侧值展示的增量调整
 业务约束: 24h 必须与昨天整日统计对比；7天/30天 本轮保持现状
-验证约束: 本地无 composer vendor，无法直接跑 Laravel/PHPUnit 全量测试
+验证约束: 本地无 composer vendor，无法直接跑 Laravel/PHPUnit；优先执行 admin-frontend 构建验证
 ```

 ### 验收标准
 - [ ] `stat/getTrafficRank` 在单日窗口下返回的 `change` 不再因昨日统计行被排除而全部回退为 `0`
 - [ ] 节点排行与用户排行共用同一修复逻辑
- [ ] 修改文件通过基础语法校验
+- [ ] 排行项 hover 时可看到“当前流量 / 上期流量 / 变化率”详情
+- [ ] 当前流量值固定在排行项右侧，视觉上不再被节点名吞没
+- [ ] `admin-frontend` 构建通过
 - [ ] `.helloagents` 变更记录已同步

 ---
@@ -50,7 +53,8 @@
 1. 在 `StatController` 中新增单独的对比窗口解析方法。
 2. 当当前窗口是单日口径时，上一窗口直接固定为 `start_time - 86400 ~ start_time`，精确命中昨天整日统计。
 3. 多日窗口沿用现有等跨度逻辑，避免超出本轮范围。
-4. 增加单元测试覆盖窗口计算规则，便于后续回归。
+4. 前端排行项补充 `ElTooltip` 悬浮详情卡，并将当前流量值右移到独立右侧列。
+5. 增加单元测试覆盖窗口计算规则，便于后续回归。

 ---

@@ -62,3 +66,10 @@
 **背景**: 用户在确认阶段明确选择“只修复 24h，对昨天同时间窗口比较；7天 / 30天 保持现状”。
 **决策**: 后端只对单日窗口切换为“昨天整日”比较，多日窗口不在本轮调整。
 **理由**: 与用户确认范围一致，改动最小，回归风险最低。
+
+### admin-frontend-dashboard-rank-24h-compare#D002: 排行项补充 hover 详情卡，并将当前流量右移显示
+**日期**: 2026-04-24
+**状态**: ✅采纳
+**背景**: 用户补充要求鼠标移入节点排行时展示“当前 / 上期 / 变化率”，并指出当前流量值放在左侧不够明显。
+**决策**: 节点 / 用户排行统一复用 tooltip 详情卡，同时把当前流量值移到右侧与涨跌列组合显示。
+**理由**: 复用同一排行结构即可满足需求，且不会引入新的页面层级或交互负担。
@@ -13,7 +13,7 @@

 | 完成 | 失败 | 跳过 | 总数 |
 |------|------|------|------|
-| 4 | 0 | 0 | 4 |
+| 5 | 0 | 0 | 5 |

 ---

@@ -21,8 +21,9 @@

 - [√] 1. 定位 24h 排行涨跌全部为 0 的根因，确认前后端边界
 - [√] 2. 在后端实现单日窗口与昨天整日统计的定点对比修复
- [√] 3. 补充单元测试覆盖窗口解析逻辑
- [√] 4. 进行语法校验并同步 `.helloagents` 记录
+- [√] 3. 为排行项补充 hover 详情卡，并把当前流量值右移强化展示
+- [√] 4. 补充单元测试覆盖窗口解析逻辑
+- [√] 5. 进行构建 / 可用性验证并同步 `.helloagents` 记录

 ---

@@ -32,11 +33,12 @@
 |------|------|------|------|
 | 2026-04-24 19:13 | 根因定位 | completed | 确认日统计 `record_at` 固定为当天 00:00，旧窗口回推会把昨天记录错位排除 |
 | 2026-04-24 19:18 | 后端修复 | completed | `StatController` 新增单日窗口解析逻辑，仅修复 24h 对昨天比较 |
-| 2026-04-24 19:21 | 测试补充 | completed | 新增窗口解析单元测试，覆盖单日与多日两条路径 |
-| 2026-04-24 19:25 | 校验与文档同步 | completed | 已执行 PHP 语法校验，并更新模块文档与 CHANGELOG |
+| 2026-04-24 19:31 | 前端增强 | completed | 排行项新增 hover 详情卡，并把当前流量值移动到右侧独立列 |
+| 2026-04-24 19:34 | 测试补充 | completed | 新增窗口解析单元测试，覆盖单日与多日两条路径 |
+| 2026-04-24 19:36 | 校验与文档同步 | completed | `admin-frontend` 执行 `npm run build` 通过，并同步模块文档与 CHANGELOG |

 ---

 ## 执行备注

- 本地环境缺少 `vendor/autoload.php` 与 `vendor/bin/phpunit`，本轮无法执行 PHPUnit；已退化为语法校验，并保留测试文件供后续有依赖环境时执行。
+- 本地环境缺少 `vendor/autoload.php` 与 `vendor/bin/phpunit`，本轮无法执行 PHPUnit；已保留测试文件供后续有依赖环境时执行。