Files
Xboard/.helloagents/context.md
T
yinjianm 16203b14f6 feat(admin-frontend): 新增系统与订阅管理后台页面
扩展管理端侧边栏与路由,新增系统配置真实页面、订阅套餐
管理页、节点管理页及多个结构化占位页

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

同步后端 traffic rank limit 支持与知识库归档、设计约束、
验证配置及视觉验收产物
2026-04-24 15:32:09 +08:00

1.8 KiB

项目上下文

基本信息

  • 项目: Xboard-new
  • 当前工作目录: E:\code\php\Xboard-new
  • 主要栈: Laravel(PHP) + Vue3/TypeScript/Vite/Element Plus (admin-frontend)

技术上下文

  • 管理端前端位于 admin-frontend/
  • 管理端 API 通过 window.settings.secure_pathVITE_ADMIN_PATH 解析 /api/v2/{secure_path} 前缀
  • 登录接口复用 /api/v2/passport/auth/login
  • 管理端仪表盘现已接入:
    • stat/getStats
    • stat/getOrder
    • stat/getTrafficRank
    • system/getSystemStatus
    • system/getQueueStats
  • 管理端用户管理现已接入:
    • user/fetch
    • user/generate
    • user/update
    • user/resetSecret
    • user/destroy
    • plan/fetch
  • 管理端节点管理现已接入:
    • server/manage/getNodes
    • server/group/fetch
    • server/manage/update
    • server/manage/copy
    • server/manage/drop
  • 管理端套餐管理现已接入:
    • plan/fetch
    • plan/save
    • plan/update
    • plan/drop
    • plan/sort
    • server/group/fetch

项目概述

  • 主仓仍以 Laravel 为后端真相源
  • admin-frontend 负责独立管理后台 UI 与交互逻辑
  • public/assets/admin 为构建产物输出位置

开发约定

  • 管理端路由使用 Hash 模式
  • 管理端当前业务路由包含 /dashboard/users/tickets/nodes/node-groups/node-routes/subscriptions/plans
  • Bearer Token 存储于 sessionStorage/localStorage
  • admin-frontend 的视觉方向当前以 Apple 风格为基线,优先纯色分区、系统字体栈和低装饰成本

当前约束

  • 本地静态 preview 环境默认缺少 Laravel 注入的 window.settings 与真实管理 API,受保护页面只能验证结构与跳转,不能替代完整联调
  • 后端接口契约以仓库内 Controller/Route 为准,不在前端推断字段