# admin-frontend 系统管理首批交付 — 需求

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

## 核心目标
- 在 `admin-frontend` 中新增“系统管理”一级侧边栏分组。
- 优先实现“系统配置”页面，并尽量贴近用户提供的目标结构：左侧分组导航 + 右侧长表单编辑区。
- 页面视觉以 `apple/DESIGN.md` 为参考，并与现有 Apple 化仪表盘、用户管理、工单管理保持同一后台设计语言。

## 功能边界
- 必须新增系统管理分组，包含：
  - 系统配置
  - 插件管理
  - 主题配置
  - 公告管理
  - 支付配置
  - 知识库管理
- 必须实现“系统配置”真实页面，覆盖：
  - 站点设置
  - 安全设置
  - 订阅设置
  - 邀请 & 佣金设置
  - 节点配置
  - 邮件设置
  - Telegram 设置
  - APP 设置
  - 订阅模板
- “系统配置”必须接入现有 Laravel 管理接口的真实数据读取与保存链路。
- 插件管理、主题配置、公告管理、支付配置、知识库管理本轮只要求提供结构化占位页，为下一轮真实接入留入口。

## 非目标
- 本轮不实现插件、主题、公告、支付、知识库的完整 CRUD 页面。
- 本轮不重做后端配置 API，不新增 Laravel 管理端接口。
- 本轮不把前台主题配置混入“系统配置”页；主题能力保留在“主题配置”入口的后续阶段实现。

## 技术约束
- 技术栈固定为 `Vue 3 + TypeScript + Vite + Element Plus`。
- 后端真相源以现有 Laravel 管理接口为准，系统配置使用：
  - `GET /config/fetch`
  - `POST /config/save`
  - `POST /config/testSendMail`
  - `POST /config/setTelegramWebhook`
- 视觉契约优先级：本方案 > `.helloagents/DESIGN.md` > `apple/DESIGN.md` 的参考原则。
- 构建验证使用 `admin-frontend/package.json` 中已有 `npm run build`。

## 质量要求
- 系统配置页必须保持 Apple 风格的一致性，并具备后台长表单的高可读性。
- 异步页面必须覆盖加载、错误、保存成功与未修改状态反馈。
- 表单交互需要明确区分主操作与辅助操作，避免一屏出现过多高强调按钮。
- 最终至少完成一次构建验证与一次浏览器级视觉验收。

