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

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

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

同步后端 traffic rank limit 支持与知识库归档、设计约束、
验证配置及视觉验收产物
This commit is contained in:
yinjianm
2026-04-24 15:32:09 +08:00
parent 9ce345eb76
commit 16203b14f6
74 changed files with 6737 additions and 119 deletions
@@ -0,0 +1,63 @@
# admin-frontend 系统管理首批交付 — 实施规划
## 目标与范围
-`admin-frontend` 增加“系统管理”信息架构,并先交付“系统配置”主页面。
- 页面目标不是一次性做完整后台系统中心,而是先打通“可进入、可读取、可编辑、可保存”的配置主链路,同时把其余 5 个系统管理入口先稳定为可访问占位页。
## 架构与实现策略
- 在现有 `AdminLayout` 基础上新增“系统管理”二级分组,保持侧边栏结构统一。
- 新增以下路由:
- `/system/config` 为真实功能页
- `/system/plugins`
- `/system/themes`
- `/system/notices`
- `/system/payments`
- `/system/knowledge`
- 系统配置页直接消费现有后端接口,不在前端猜测或重塑接口契约:
- `/config/fetch`
- `/config/save`
- `/config/testSendMail`
- `/config/setTelegramWebhook`
- 配置字段分组、控件元信息与序列化逻辑下沉到 `utils/systemConfig.ts`,避免页面组件膨胀。
- 占位页使用统一的 `SystemPlaceholderView`,以一致的结构说明本轮范围与下一阶段扩展点。
## 完成定义
- 侧边栏出现“系统管理”分组,且可以进入 6 个子入口。
- `/system/config` 页面可真实拉取配置数据,并按 9 个配置分组组织内容。
- 用户可以修改并保存系统配置,保存后获得成功/失败反馈。
- 邮件设置与 Telegram 设置保留辅助动作入口(测试邮件 / 设置 Webhook),但不在本轮额外扩展复杂工作流。
- 其余 5 个系统管理子页可从侧边栏正常进入,并明确标注“下一阶段接入”。
- 验证主路径:`review-first`
- reviewer 关注边界:系统管理信息架构是否清晰、系统配置表单层级是否贴近 Apple 风格后台、占位页是否透明说明未实现范围。
- tester 关注边界:菜单与路由是否真实连通、系统配置页是否真实连接 `/config/fetch``/config/save`、保存链路与辅助按钮是否存在真实数据流。
## 文件结构
- `admin-frontend/src/router/index.ts`
- `admin-frontend/src/layouts/AdminLayout.vue`
- `admin-frontend/src/api/admin.ts`
- `admin-frontend/src/types/api.d.ts`
- `admin-frontend/src/utils/systemConfig.ts`(新增)
- `admin-frontend/src/views/system/SystemConfigView.vue`(新增)
- `admin-frontend/src/views/system/SystemPlaceholderView.vue`(新增)
- `.helloagents/DESIGN.md`
## UI / 设计约束
- 系统配置首页保留黑色 hero + 白色配置壳层的 Apple 后台节奏。
- 左侧使用紧凑分组导航,右侧使用连续表单 section,优先满足“快速定位配置块”的后台效率诉求。
- 页面首屏只保留一个主保存动作和少量辅助描述,不堆砌营销式视觉元素。
- 占位页不做空白页,而是交付可继续扩展的结构化提示页。
## 风险与验证
- 风险 1:配置接口字段类型包含布尔、数值、数组和长文本,前端需要统一序列化与表单回填。
- 风险 2`/config/fetch` 返回分组对象,系统配置页必须避免直接把后端分组名暴露成低可读开发术语。
- 风险 3:本地静态预览环境可能缺少 Laravel 注入或后台认证,浏览器验收要区分“结构验收”和“真实联调”边界。
- 验证方式:
- `npm run build`
- 本地预览 + 浏览器检查 `#/system/config`
- 浏览器检查 `#/system/plugins``#/system/themes``#/system/notices``#/system/payments``#/system/knowledge`
## 决策记录
- [2026-04-23] 系统管理首批交付聚焦“系统配置真实页 + 其余入口占位页”,避免在一轮内同时展开多个 CRUD 模块。
- [2026-04-23] “系统配置”保留左侧配置分组导航,优先满足后台场景中的长表单定位效率。
- [2026-04-23] 前台主题相关配置不混入本轮系统配置页,而是留在“主题配置”入口的后续阶段实现。