Files

T

yinjianm e847252e12 fix(api): 修复节点流量限额共享统计与父子显隐联动

统一节点流量统计与限额展示口径，节点详情新增昨日流量，
并让今日、昨日和本月使用清晰的半开时间窗口聚合

同 machine_id 或同 host 的节点现在共享当前账期已用流量，
管理端优先使用后端 traffic_limit_snapshot 展示月额度状态，
mi-node 下发的 current_used 也改为共享账期统计

新增 parent_auto_hidden 标记与父节点显隐联动服务，父节点
因自动上线或流量限额变为不可展示时会隐藏当前显示的子节点，
恢复时只恢复这批自动隐藏的子节点，避免覆盖手动操作

2026-04-29 02:24:57 +08:00

4.9 KiB

Raw Blame History

任务清单: parent-node-auto-visibility

@status: completed | 2026-04-29 02:07

@feature: parent-node-auto-visibility
@created: 2026-04-29
@status: completed
@mode: R2
@type: implementation

LIVE_STATUS

{"status":"completed","completed":6,"failed":0,"pending":0,"total":6,"percent":100,"current":"父节点自动下线联动子节点隐藏与恢复已完成并通过验证","updated_at":"2026-04-29 02:14:00"}

进度概览

完成	失败	跳过	总数
6	0	0	6

任务列表

1. 数据模型与联动服务

[√] 1.1 新增 v2_server 父级自动隐藏标记字段
- 文件路径或作用范围: database/migrations/*_add_parent_auto_visibility_fields_to_v2_server_table.php, app/Models/Server.php
- 预期变更: 增加 parent_auto_hidden 与 parent_auto_action_at 字段，补充模型 docblock 和 casts。
- 完成标准: 新字段迁移幂等，模型可布尔/整数转换字段。
- 验证方式: php -l 检查新增迁移和模型语法。
- depends_on: []
[√] 1.2 新增父节点子节点展示联动服务
- 文件路径或作用范围: app/Services/ServerParentVisibilityService.php
- 预期变更: 实现隐藏当前展示子节点、恢复被标记子节点、清除手动标记的集中方法。
- 完成标准: 只标记本次自动隐藏的子节点；恢复时不恢复未标记或仍被墙检测隐藏的节点。
- 验证方式: 单元测试覆盖自动隐藏和恢复行为。
- depends_on: [1.1]

2. 自动状态入口接入

[√] 2.1 接入自动上线同步
- 文件路径或作用范围: app/Services/ServerAutoOnlineService.php
- 预期变更: 父节点自动同步后根据最终展示状态隐藏或恢复直接子节点；结果统计包含子节点联动更新。
- 完成标准: 父节点离线自动隐藏时同步隐藏展示中的子节点；父节点恢复在线时只恢复 parent_auto_hidden=1 的子节点。
- 验证方式: tests/Unit/ServerAutoOnlineServiceTest.php 新增断言。
- depends_on: [1.2]
[√] 2.2 接入流量限额超额和恢复
- 文件路径或作用范围: app/Services/ServerTrafficLimitService.php
- 预期变更: refreshSchedule()、resetServer()、applyRuntimeMetrics() 状态落库后触发父节点子节点隐藏/恢复。
- 完成标准: suspended 隐藏子节点，normal/reset 恢复被标记子节点，未启用限额不触发误恢复。
- 验证方式: tests/Unit/ServerTrafficLimitServiceTest.php 新增断言。
- depends_on: [1.2]
[√] 2.3 清理手动 show 修改的自动联动标记
- 文件路径或作用范围: app/Http/Controllers/V2/Admin/Server/ManageController.php
- 预期变更: 单节点保存、快速更新、批量更新接收 show 时清除 parent_auto_hidden 和 parent_auto_action_at。
- 完成标准: 手动显示/隐藏子节点后，后续父节点恢复不会覆盖人工决定。
- 验证方式: 代码检查和相关服务测试覆盖标记清除方法。
- depends_on: [1.1, 1.2]

3. 验证与知识库

[√] 3.1 补充测试、知识库和变更记录
- 文件路径或作用范围: tests/Unit/ServerAutoOnlineServiceTest.php, tests/Unit/ServerTrafficLimitServiceTest.php, .helloagents/modules/node-traffic-limit.md, .helloagents/context.md, .helloagents/CHANGELOG.md
- 预期变更: 增加自动上线与流量限额联动测试，更新知识库说明和变更记录。
- 完成标准: 目标测试通过或明确记录环境阻塞；知识库反映代码事实。
- 验证方式: vendor/bin/phpunit tests/Unit/ServerAutoOnlineServiceTest.php tests/Unit/ServerTrafficLimitServiceTest.php
- depends_on: [2.1, 2.2, 2.3]

执行日志

时间	任务	状态	备注
2026-04-29 01:53	方案设计	in_progress	已完成上下文收集与任务拆分
2026-04-29 02:03	1.1-2.3	completed	已完成迁移、模型、联动服务和入口接入
2026-04-29 02:08	3.1	completed	已补充自动上线和流量限额测试
2026-04-29 02:14	验证	completed	PHP 语法、PHPStan 和目标 PHPUnit 测试通过

执行备注

当前已有遗留方案包 202604250006_ticket-closed-reply-reopen 标记 in_progress，本任务作为新方案包独立执行。
不执行生产数据库迁移，仅提交迁移文件和测试。
验证命令:
- php -l 检查新增/修改 PHP 文件。
- vendor\bin\phpstan analyse app\Services\ServerParentVisibilityService.php app\Services\ServerAutoOnlineService.php app\Services\ServerTrafficLimitService.php app\Http\Controllers\V2\Admin\Server\ManageController.php app\Models\Server.php --memory-limit=1G
- 使用一次性 SQLite 文件执行 vendor\bin\phpunit tests\Unit\ServerAutoOnlineServiceTest.php tests\Unit\ServerTrafficLimitServiceTest.php，结果 17 tests / 83 assertions 通过。

4.9 KiB Raw Blame History

任务清单: parent-node-auto-visibility

LIVE_STATUS

进度概览

任务列表

1. 数据模型与联动服务

2. 自动状态入口接入

3. 验证与知识库

执行日志

执行备注

4.9 KiB

Raw Blame History