80 lines
2.5 KiB
Markdown
80 lines
2.5 KiB
Markdown
# 远光软件微调平台 - 前端（Vue 3）
|
||
|
||
> 由原 `web/` 静态多页面 HTML 项目改造而来。
|
||
|
||
## 技术栈
|
||
|
||
- **Vue 3** + **TypeScript** + **Vite**
|
||
- **Vue Router 4** - 路由
|
||
- **Pinia** - 状态管理
|
||
- **Element Plus** - UI 组件库（主色 `#1890ff`）
|
||
- **axios** - HTTP 请求
|
||
- **Chart.js** - 训练曲线图表
|
||
- **marked + DOMPurify** - Markdown 渲染
|
||
- **md-editor-v3** - Prompt 编辑器
|
||
- **@vueuse/core** - 组合式工具
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
cd frontend
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
开发服务器默认运行在 `http://localhost:16801`。
|
||
|
||
后端 API 默认通过 Vite 代理转发到 `http://localhost:17861`（见 `vite.config.ts`）。
|
||
|
||
开发环境默认联调真实后端接口。如需进行隔离前端开发，可显式启用 Mock：
|
||
|
||
```bash
|
||
VITE_ENABLE_MOCK=true npm run dev
|
||
```
|
||
|
||
真实联调、测试环境和生产环境不应启用 Mock。
|
||
|
||
## 构建
|
||
|
||
```bash
|
||
npm run build # 类型检查 + 生产构建，产物在 dist/
|
||
npm run preview # 本地预览构建产物
|
||
npm run type-check # 仅类型检查
|
||
```
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
src/
|
||
├── api/ # axios 封装 + 各业务模块 API
|
||
├── components/ # 公共组件（侧边栏、顶部栏、通用列表等）
|
||
├── composables/ # 组合式函数（流式对话、图表、轮询等）
|
||
├── constants/ # 常量与映射表
|
||
├── layouts/ # 主布局
|
||
├── router/ # 路由配置 + 登录守卫
|
||
├── stores/ # Pinia 状态（auth/system/models/tools）
|
||
├── styles/ # 全局样式与主题
|
||
├── types/ # TypeScript 类型定义
|
||
└── views/ # 页面视图
|
||
├── login/ # 登录
|
||
├── system/ # 用户设置 / 平台性能 / 日志 / 训练日志
|
||
├── tenants/ # 租户管理
|
||
├── projects/ # 项目空间 / 成员 / 资源授权弹窗
|
||
├── approvals/ # 审批中心 / 审批模板
|
||
├── audit/ # 审计中心
|
||
├── dashboard/ # 服务看板
|
||
├── model/ # 模型管理
|
||
├── dataset/ # 数据集
|
||
├── fine-tune/ # 模型调优
|
||
├── eval/ # 模型评测
|
||
├── inference/ # 模型推理
|
||
├── compare/ # 模型对比
|
||
└── tools/ # 其他工具
|
||
```
|
||
|
||
## 与原 web/ 项目的关系
|
||
|
||
- 原 `web/` 目录**保留不动**，作为功能对照参照。
|
||
- 新前端位于 `frontend/`，新旧可并存。
|
||
- 后端 API 端点完全不变，仅前端实现方式改为 Vue SPA。
|