第一次提交
This commit is contained in:
79
frontend/README.md
Normal file
79
frontend/README.md
Normal file
@@ -0,0 +1,79 @@
|
||||
# 远光软件微调平台 - 前端(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。
|
||||
Reference in New Issue
Block a user