Files
Xboard/.helloagents/archive/2026-04/202604232320_admin-frontend-node-management/requirements.md
T
yinjianm 16203b14f6 feat(admin-frontend): 新增系统与订阅管理后台页面
扩展管理端侧边栏与路由,新增系统配置真实页面、订阅套餐
管理页、节点管理页及多个结构化占位页

补齐前端 API、类型与工具层,并增强仪表盘刷新、趋势切换、
失败作业详情与流量排行 limit 联动能力

同步后端 traffic rank limit 支持与知识库归档、设计约束、
验证配置及视觉验收产物
2026-04-24 15:32:09 +08:00

1.8 KiB

admin-frontend 节点管理首批交付 — 需求

确认后冻结,执行阶段不可修改。如需变更必须回到设计阶段重新确认。

核心目标

  • admin-frontend 中新增“节点管理”侧边栏分组。
  • 优先实现“节点管理”主页面,使管理者可以在 Apple 风格后台中查看、搜索、筛选和执行基础节点操作。
  • 页面视觉以 apple/DESIGN.md 为参考,并与现有 Apple 化仪表盘、用户管理、工单管理保持一致。

功能边界

  • 必须新增节点管理分组,包含:节点管理、权限组管理、路由管理 3 个入口。
  • 必须实现“节点管理”列表页,覆盖:
    • 节点列表拉取
    • 关键字段展示(节点 ID、显隐、节点、地址、在线人数、倍率、权限组)
    • 搜索
    • 类型筛选
    • 权限组筛选
    • 显隐切换
    • 行级更多操作菜单
  • 权限组管理、路由管理本轮只要求提供结构化占位页,为下一轮真实接入留入口。

非目标

  • 本轮不实现完整的节点创建 / 编辑大表单。
  • 本轮不实现拖拽排序或完整排序编辑器。
  • 本轮不重做后端接口,不新增 Laravel 管理端 API。

技术约束

  • 技术栈固定为 Vue 3 + TypeScript + Vite + Element Plus
  • 后端真相源以现有 Laravel 管理接口为准,节点列表使用 /server/manage/getNodes
  • 视觉契约优先级:本方案 > .helloagents/DESIGN.md > apple/DESIGN.md 的参考原则。
  • 构建验证使用 admin-frontend/package.json 中已有 npm run build

质量要求

  • 页面必须保持 Apple 风格的一致性和高密度运营后台可读性。
  • 异步列表必须覆盖加载、空和错误反馈。
  • 危险操作要有确认提示。
  • 最终至少完成一次构建验证与一次浏览器级视觉验收。