Xboard/.helloagents/modules/admin-frontend.md

admin-frontend

职责

• 提供 Vue3 管理端登录页、认证状态、路由守卫和主布局
• 封装管理端统计/系统状态、用户管理和套餐查询接口
• 渲染后台仪表盘、用户管理工作台，以及预留的工单管理入口

行为规范

• 登录成功后优先跳转 redirect 指定路由，否则回到 /dashboard
• 受保护路由在未登录时会自动附加 redirect 查询参数
• API 基础路径使用 /api/v2/{secure_path}，其中 secure_path 来自运行时配置
• 仪表盘以真实后端接口返回值为准，不在前端伪造业务统计
• 用户管理页通过真实后端 user/fetch、user/update、user/generate、user/resetSecret、user/destroy 与 plan/fetch 完成数据读写
• 新增用户时采用“先 generate，后按邮箱回查并 update”的两段式流程，以兼容后端基础创建接口
• 当前首页视觉基线为 Apple 风格：纯色分区、系统字体栈、单一蓝色强调和轻量层次
• 性能优化优先级高于装饰性表达，避免远程字体、全局模糊背景和固定特效层

依赖关系

• 依赖 src/api/client.ts 处理 axios 与认证头
• 依赖 src/utils/users.ts 负责用户管理表单转换、筛选组装和状态计算
• 依赖 Laravel 注入的 window.settings
• 构建输出到 public/assets/admin