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