签入版本

This commit is contained in:
2026-10-11 19:06:33 +08:00
parent 17d28de8b7
commit 4084c6bd17
674 changed files with 58855 additions and 1892 deletions
@@ -1,23 +1,23 @@
# 9.1 前端工程概述
:::tip 概述
前端基于 Vue 3 + TypeScript + Vite + ElementPlus 构建,采用 Pinia 状态管理,支持动态菜单和权限控制。通过 Axios 封装统一处理请求/响应/错误,通过 `v-perm` 指令实现按钮级权限控制。前端为本仓库 **`ui/` 目录**内的 EleVue 管理后台,与本后端通过 API 对接。
前端基于 Vue 3 + TypeScript + Vite + NaiveUI 构建,采用 Pinia 状态管理,支持动态菜单和权限控制。通过 Axios 封装统一处理请求/响应/错误,通过 `v-perm` 指令实现按钮级权限控制。前端为本仓库 **`ui/` 目录**内的 NaiveVue 管理后台,与本后端通过 API 对接。
:::
## 技术栈
| 类别 | 技术 | 版本 | 说明 |
|------|------|------|------|
| 框架 | Vue | 3.4+ | 核心 UI 框架 |
| 框架 | Vue | 3.5+(实际 ^3.5.1) | 核心 UI 框架 |
| 语言 | TypeScript | 4.9+(实际 ^4.9.5) | 类型安全 |
| UI 库 | ElementPlus | 2.7+ | 组件库 |
| 构建 | Vite | 3.2+(实际 ^3.2.10) | 开发服务器与构建 |
| 状态 | Pinia | 2.1+ | 全局状态管理 |
| 路由 | Vue Router | 4.3+ | 路由管理 |
| HTTP | Axios | 0.27+(实际 ^0.27.2) | HTTP 请求(注:0.27.x 版本较老) |
| 富文本 | TinyMce | 5.10+ | 富文本编辑器 |
| UI 库 | NaiveUI | 2.40+(实际 ^2.40.0) | 组件库 |
| 构建 | Vite | 5.4+(实际 ^5.4.3) | 开发服务器与构建 |
| 状态 | Pinia | 2.2+(实际 ^2.2.2) | 全局状态管理 |
| 路由 | Vue Router | 4.4+(实际 ^4.4.3) | 路由管理 |
| HTTP | Axios | 1.7+(实际 ^1.7.7) | HTTP 请求 |
| 富文本 | TinyMce / Quill | 5.10+ | 富文本编辑器 |
| 图表 | ECharts | 5.5+ | 数据可视化 |
| CSS | TailwindCSS | 3.4+ | 原子化 CSS |
| CSS | TailwindCSS + Less | 3.4+ | 原子化 CSS 与预处理 |
(版本以前端仓库 `package.json` 为准。)
@@ -36,7 +36,7 @@
`v-perm` / `v-perms` 指令控制按钮级权限:
```vue
<el-button v-perm="['sys:user:add']">新增</el-button>
<n-button v-perm="['sys:user:add']">新增</n-button>
```
### Token 管理
@@ -54,7 +54,7 @@ Axios 拦截器自动处理:
|------|------|
| BasicTable | 数据表格(分页、排序、搜索) |
| BasicForm | 动态表单(配置驱动) |
| BasicModal | 弹窗(表单弹窗、详情弹窗) |
| basicModal | 弹窗(表单弹窗、详情弹窗,全局注册) |
| BasicUpload | 文件上传 |
| Editor | 富文本编辑器(TinyMce) |
| ImportExcel | Excel 导入 |