yinjianm
45 lines
1.4 KiB
Markdown
45 lines
1.4 KiB
Markdown
# 项目上下文
|
|
|
|
## 基本信息
|
|
|
|
- 项目: Xboard-new
|
|
- 当前工作目录: `E:\code\php\Xboard-new`
|
|
- 主要栈: Laravel(PHP) + Vue3/TypeScript/Vite/Element Plus (`admin-frontend`)
|
|
|
|
## 技术上下文
|
|
|
|
- 管理端前端位于 `admin-frontend/`
|
|
- 管理端 API 通过 `window.settings.secure_path` 或 `VITE_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`
|
|
|
|
## 项目概述
|
|
|
|
- 主仓仍以 Laravel 为后端真相源
|
|
- `admin-frontend` 负责独立管理后台 UI 与交互逻辑
|
|
- `public/assets/admin` 为构建产物输出位置
|
|
|
|
## 开发约定
|
|
|
|
- 管理端路由使用 Hash 模式
|
|
- 管理端当前业务路由包含 `/dashboard`、`/users` 与 `/tickets`
|
|
- Bearer Token 存储于 `sessionStorage/localStorage`
|
|
- `admin-frontend` 的视觉方向当前以 Apple 风格为基线，优先纯色分区、系统字体栈和低装饰成本
|
|
|
|
## 当前约束
|
|
|
|
- 本地静态 preview 环境默认缺少 Laravel 注入的 `window.settings` 与真实管理 API，受保护页面只能验证结构与跳转，不能替代完整联调
|
|
- 后端接口契约以仓库内 Controller/Route 为准，不在前端推断字段
|