yinjianm
16203b14f6
扩展管理端侧边栏与路由，新增系统配置真实页面、订阅套餐 管理页、节点管理页及多个结构化占位页 补齐前端 API、类型与工具层，并增强仪表盘刷新、趋势切换、 失败作业详情与流量排行 limit 联动能力 同步后端 traffic rank limit 支持与知识库归档、设计约束、 验证配置及视觉验收产物
52 lines
2.3 KiB
Markdown
52 lines
2.3 KiB
Markdown
# 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 风格的一致性，并具备后台长表单的高可读性。
|
|
- 异步页面必须覆盖加载、错误、保存成功与未修改状态反馈。
|
|
- 表单交互需要明确区分主操作与辅助操作，避免一屏出现过多高强调按钮。
|
|
- 最终至少完成一次构建验证与一次浏览器级视觉验收。
|
|
|