feat(admin-frontend): 补齐用户节点与订单运营工作台
新增用户高级筛选、批量操作与更多行级动作，支持邮件、 CSV、封禁恢复、订单分配、邀请查看、流量记录与重置流量 增强节点管理页的分页、父子筛选、跨页勾选、批量修改与 单节点置顶，并补齐后端批量更新 host、group_ids、rate 修复订单佣金状态误判问题，新增真实佣金筛选与行级确认， 同时优化仪表盘排行悬浮详情展示 补充 admin-frontend 独立 Dockerfile、Caddy 配置与 GHCR 发布工作流，支持通过独立镜像部署管理前端
This commit is contained in:
yinjianm
+11
@@ -0,0 +1,11 @@
|
||||
{
|
||||
"status": "completed",
|
||||
"completed": 5,
|
||||
"failed": 0,
|
||||
"pending": 0,
|
||||
"total": 5,
|
||||
"done": 5,
|
||||
"percent": 100,
|
||||
"current": "节点管理分页、置顶、批量修改与父子筛选已完成",
|
||||
"updated_at": "2026-04-24 23:02:00"
|
||||
}
|
||||
+49
@@ -0,0 +1,49 @@
|
||||
{
|
||||
"updatedAt": "2026-04-24T14:45:23.000Z",
|
||||
"version": 1,
|
||||
"source": "manual",
|
||||
"originCommand": "generic-r2",
|
||||
"verifyMode": "test-first",
|
||||
"reviewerFocus": [
|
||||
"节点分页后的勾选状态是否稳定，不会因切页导致批量修改作用域错误",
|
||||
"置顶动作与批量修改是否真实复用现有后台接口而不是只做前端假交互"
|
||||
],
|
||||
"testerFocus": [
|
||||
"节点页是否支持按筛选结果分页浏览，并可切换每页数量",
|
||||
"父节点与子节点筛选是否按 parent_id 正确区分",
|
||||
"批量修改是否只提交已勾选节点的 ids，并只更新 host / group_ids / rate"
|
||||
],
|
||||
"ui": {
|
||||
"required": true,
|
||||
"designContract": true,
|
||||
"sourcePriority": [
|
||||
"requirements.md",
|
||||
".helloagents/DESIGN.md",
|
||||
"hello-ui"
|
||||
],
|
||||
"styleAdvisor": {
|
||||
"required": false,
|
||||
"reason": "",
|
||||
"focus": []
|
||||
},
|
||||
"visualValidation": {
|
||||
"required": true,
|
||||
"reason": "节点管理本轮新增分页控件、父子筛选、批量修改弹窗与置顶动作，需要确认高密度工作台节奏与 Apple 化后台契约一致。",
|
||||
"screens": [
|
||||
"#/nodes desktop"
|
||||
],
|
||||
"states": [
|
||||
"节点列表默认加载完成态",
|
||||
"节点列表已勾选批量操作可用态",
|
||||
"节点批量修改弹窗展开态",
|
||||
"节点父子筛选切换态"
|
||||
]
|
||||
}
|
||||
},
|
||||
"advisor": {
|
||||
"required": false,
|
||||
"reason": "",
|
||||
"focus": [],
|
||||
"preferredSources": []
|
||||
}
|
||||
}
|
||||
+62
@@ -0,0 +1,62 @@
|
||||
# admin-frontend 节点管理分页、置顶与批量修改 — 实施规划
|
||||
|
||||
## 目标与范围
|
||||
- 将现有节点管理页从“单屏全量表格”升级为“可分页浏览、可稳定勾选、可批量维护”的真实运营工作台。
|
||||
- 在不破坏既有 Apple 化后台节奏的前提下，补齐列表密度管理与批量维护动作。
|
||||
|
||||
## 架构与实现策略
|
||||
- 继续保留 `NodesView.vue` 作为节点页装配入口，但补齐以下四类状态：
|
||||
- 前端分页状态（页码、每页条数）
|
||||
- 父/子节点筛选状态
|
||||
- 跨分页勾选状态
|
||||
- 批量修改弹窗状态
|
||||
- 新增 `NodeBatchEditDialog.vue`：
|
||||
- 负责批量修改节点地址（host）、权限组、倍率
|
||||
- 采用“字段开关 + 输入控件”的结构，避免未启用字段被误提交
|
||||
- 明确提示仅对已勾选节点生效
|
||||
- `src/utils/nodes.ts` 负责收敛节点列表的本地过滤逻辑：
|
||||
- 关键字搜索
|
||||
- 类型筛选
|
||||
- 权限组筛选
|
||||
- 父/子节点筛选
|
||||
- `src/api/admin.ts` 与 `src/types/api.d.ts` 补齐节点批量修改的类型与接口封装。
|
||||
- Laravel `ManageController::batchUpdate` 做最小扩展，仅补齐 `host / rate / group_ids` 三个字段的批量更新支持。
|
||||
- “置顶节点”不新开接口，直接基于当前排序结果生成新的 `{ id, order }[]` 并提交到 `server/manage/sort`。
|
||||
|
||||
## 完成定义
|
||||
- 节点列表底部出现可用的分页控件，并能按当前筛选结果切页。
|
||||
- 节点列表支持勾选多个节点，切页后勾选状态仍能稳定恢复。
|
||||
- 工具条出现“批量修改”入口，且只有已勾选节点时可用。
|
||||
- 批量修改弹窗支持按需修改 `host / group_ids / rate`，并真实写回后台。
|
||||
- 节点行菜单新增“置顶节点”，执行后该节点会排到列表最前。
|
||||
- 搜索工具条新增“全部节点 / 父节点 / 子节点”筛选选项。
|
||||
|
||||
## 文件结构
|
||||
- `.helloagents/plans/202604242245_admin-frontend-node-pagination-batch-edit/*`
|
||||
- `admin-frontend/src/api/admin.ts`
|
||||
- `admin-frontend/src/types/api.d.ts`
|
||||
- `admin-frontend/src/utils/nodes.ts`
|
||||
- `admin-frontend/src/views/nodes/NodesView.vue`
|
||||
- `admin-frontend/src/views/nodes/NodeBatchEditDialog.vue`
|
||||
- `admin-frontend/src/views/nodes/NodeBatchEditDialog.scss`
|
||||
- `app/Http/Controllers/V2/Admin/Server/ManageController.php`
|
||||
|
||||
## UI / 设计约束
|
||||
- 节点页首屏继续保持“黑色 Hero + 白色工作台”结构，不另起新皮肤。
|
||||
- 父/子节点筛选应与搜索、类型、权限组并列出现在工具条，维持高密度但不拥挤的运营节奏。
|
||||
- 批量修改弹窗保持轻薄白色面板、分组式表单和固定底栏，避免做成厚重后台配置页。
|
||||
- “置顶节点”属于高频轻操作，应放在行级菜单中而不是二级排序弹窗里。
|
||||
|
||||
## 风险与验证
|
||||
- 风险 1：分页后勾选容易丢失，因此需要在前端维护独立的勾选 ID 集合并在切页后回填。
|
||||
- 风险 2：批量修改只改部分字段，若直接提交完整节点模型容易覆盖协议配置，因此必须使用专门的批量 payload。
|
||||
- 风险 3：`batchUpdate` 原本不支持 `host / rate / group_ids`，前端先实现但后端不补齐会导致伪完成，因此必须同步扩展管理端接口。
|
||||
- 验证方式：
|
||||
- `npm run build`
|
||||
- 代码级视觉自检：节点列表默认态、已勾选批量修改态、批量修改弹窗态
|
||||
- 代码检查：置顶排序 payload 与批量修改 payload
|
||||
|
||||
## 决策记录
|
||||
- [2026-04-24] 节点分页采用前端本地分页，不为本轮新增后端分页接口。
|
||||
- [2026-04-24] 批量修改范围按用户确认固定为“仅已勾选节点”，不扩展到筛选结果。
|
||||
- [2026-04-24] “置顶节点”直接复用 `server/manage/sort`，避免新开单独排序接口。
|
||||
+41
@@ -0,0 +1,41 @@
|
||||
# admin-frontend 节点管理分页、置顶与批量修改 — 需求
|
||||
|
||||
确认后冻结，执行阶段不可修改。如需变更必须回到设计阶段重新确认。
|
||||
|
||||
## 核心目标
|
||||
- 在 `admin-frontend` 的 `#/nodes` 页面内补齐分页能力，避免节点列表持续增长后整页难以浏览。
|
||||
- 为节点列表增加“置顶”单行操作，让运营者可以把某个节点快速移动到列表顶部。
|
||||
- 为节点管理补齐批量修改工作流，并按本轮确认仅对**已勾选节点**生效。
|
||||
- 为节点搜索补齐“子节点 / 父节点”筛选选项，帮助运营者快速区分主节点与子节点。
|
||||
|
||||
## 功能边界
|
||||
- 必须保留现有节点管理能力：搜索、类型筛选、权限组筛选、显隐切换、复制、删除、添加节点、编辑节点、编辑排序。
|
||||
- 分页必须作用于当前筛选结果，并允许切换每页数量。
|
||||
- “置顶节点”必须真实生效到后台排序，不能只在前端临时重排。
|
||||
- 批量修改本轮只支持以下字段：
|
||||
- 节点地址（仅 `host`，不含端口）
|
||||
- 权限组
|
||||
- 倍率
|
||||
- 批量修改只作用于已勾选节点；未勾选节点时不能误操作全部节点或筛选结果。
|
||||
- “子节点 / 父节点”筛选必须基于 `parent_id` 真实区分：
|
||||
- 父节点：`parent_id` 为空
|
||||
- 子节点：`parent_id` 有值
|
||||
|
||||
## 非目标
|
||||
- 本轮不引入后端列表分页接口，节点列表继续沿用 `server/manage/getNodes` 全量拉取 + 前端分页。
|
||||
- 本轮不接入批量删除、批量重置流量、批量显隐、批量启停等其他批量动作。
|
||||
- 本轮不修改节点编辑弹窗字段结构，也不扩展批量端口修改。
|
||||
|
||||
## 技术约束
|
||||
- 技术栈固定为 `Vue 3 + TypeScript + Vite + Element Plus`，主目录限定在 `admin-frontend/`，后端仅做最小必要的 Laravel 管理接口补丁。
|
||||
- 节点真相源仍以 `App\Http\Controllers\V2\Admin\Server\ManageController`、`App\Http\Requests\Admin\ServerSave` 与 `App\Models\Server` 为准。
|
||||
- 置顶动作继续复用 `POST /server/manage/sort`。
|
||||
- 批量修改优先复用现有 `POST /server/manage/batchUpdate`，只补齐本轮所需字段支持。
|
||||
- 视觉继续遵循 `apple/DESIGN.md` 与 `.helloagents/DESIGN.md` 的 Apple 化后台约束：黑色首屏 + 白色工作台 + 蓝色单一强调。
|
||||
|
||||
## 质量要求
|
||||
- 分页、勾选和筛选不能互相打架：切页后已勾选节点状态应保持稳定，不得让用户误以为选择丢失。
|
||||
- 批量修改入口需要明确显示“当前已选 N 个节点”，降低误操作风险。
|
||||
- 批量修改弹窗需清楚说明“节点地址只改 host，不改端口”，避免概念歧义。
|
||||
- 父/子节点筛选应作为节点搜索工作流的一部分清晰可见，而不是埋进深层菜单。
|
||||
- 最终至少完成一次 `admin-frontend` 构建验证，并留下视觉验收与交付证据。
|
||||
+13
@@ -0,0 +1,13 @@
|
||||
# admin-frontend 节点管理分页、置顶与批量修改 — 任务分解
|
||||
|
||||
## 任务列表
|
||||
- [x] 任务1：补齐本轮方案与合同产物（涉及文件：`.helloagents/plans/202604242245_admin-frontend-node-pagination-batch-edit/*`；完成标准：存在需求、方案、任务、合同与状态文件；验证方式：文件检查）
|
||||
- [x] 任务2：扩展节点批量修改 API 与后端兼容（涉及文件：`admin-frontend/src/api/admin.ts`、`admin-frontend/src/types/api.d.ts`、`app/Http/Controllers/V2/Admin/Server/ManageController.php`；完成标准：前后端支持按已勾选节点批量更新 `host / group_ids / rate`；验证方式：`npm run build` + 代码检查）
|
||||
- [x] 任务3：重构节点列表工作台并接入分页 / 父子筛选 / 置顶（涉及文件：`admin-frontend/src/views/nodes/NodesView.vue`、`admin-frontend/src/utils/nodes.ts`；完成标准：节点页支持分页、父/子节点筛选与单节点置顶；验证方式：`npm run build`）
|
||||
- [x] 任务4：新增节点批量修改弹窗并接入勾选流（涉及文件：`admin-frontend/src/views/nodes/NodeBatchEditDialog.vue`、`admin-frontend/src/views/nodes/NodeBatchEditDialog.scss`、`admin-frontend/src/views/nodes/NodesView.vue`；完成标准：只对已勾选节点执行批量修改，支持地址 host、权限组、倍率三项；验证方式：`npm run build`）
|
||||
- [x] 任务5：完成验证与知识库同步（涉及文件：`.helloagents/CHANGELOG.md`、`.helloagents/context.md`、`.helloagents/modules/admin-frontend.md`、`.helloagents/.ralph-visual.json`、`.helloagents/.ralph-closeout.json`、`.helloagents/sessions/master/default/STATE.md`；完成标准：构建通过、知识库更新、证据落盘；验证方式：命令输出 + 证据文件）
|
||||
|
||||
## 进度
|
||||
- [x] 已确认批量修改范围固定为“仅已勾选节点”。
|
||||
- [x] 已完成节点分页、父/子节点筛选、置顶动作与批量修改弹窗。
|
||||
- [x] 已完成构建验证、知识库同步与交付收尾。
|
||||
Reference in New Issue
Block a user