Files

T

yinjianm 16203b14f6 feat(admin-frontend): 新增系统与订阅管理后台页面

扩展管理端侧边栏与路由，新增系统配置真实页面、订阅套餐
管理页、节点管理页及多个结构化占位页

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

同步后端 traffic rank limit 支持与知识库归档、设计约束、
验证配置及视觉验收产物

2026-04-24 15:32:09 +08:00

2.3 KiB

Raw Blame History

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

2.3 KiB Raw Blame History

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

核心目标

功能边界

非目标

技术约束

质量要求

2.3 KiB

Raw Blame History