[](LICENSE) RuoYi Plus Vben
## 提示
已经将 antv4 版本的代码提交到该仓库 即默认 main 分支
关于运行警告: `The CJS build of Vite's Node API is deprecated. See https://vitejs.dev/guide/troubleshooting.html#vite-cjs-node-api-deprecated for more details.` 是由于升级vite5 官方还未解决但是不影响使用 详见[vben issue](https://github.com/vbenjs/vue-vben-admin/pull/3508)
## 简介
基于 [vben(ant-design-vue)](https://github.com/vbenjs/vue-vben-admin) 的 RuoYi-Vue-Plus 前端项目
| 组件/框架 | 版本 |
| :------------- | :----- |
| vben | 2.11.4 |
| ant-design-vue | 4.2.1 |
| vue | 3.4.25 |
对应后端项目: **(分布式 5.X 分支 微服务 2.分支)**
分布式 [RuoYi-Vue-Plus](https://gitee.com/dromara/RuoYi-Vue-Plus/tree/5.X/)
微服务 [RuoYi-Cloud-Plus](https://gitee.com/dromara/RuoYi-Cloud-Plus/tree/2.X/)
## 预览
admin 账号: admin admin123
[预览地址点这里](http://plus.dapdap.top)
## WX Group
广告佬g远点, 正常人从演示站加
## 文档
[vben 文档地址](https://doc.vvbin.cn/)
[RuoYi-Plus 文档地址](https://plus-doc.dromara.org/#/)
[本框架文档(必看)](https://dapdap.top/)
## 预览图
           
## 安装使用
前置准备环境(只能用pnpm)
```json
"packageManager": "pnpm",
"engines": {
"node": ">=18.12.0",
"pnpm": ">=9.0.4"
}
```
- 获取项目代码
```bash
git clone https://gitee.com/dapppp/ruoyi-plus-vben.git
```
- 安装依赖
```bash
cd ruoyi-plus-vben
pnpm install
```
- 关于代码生成(非必选)
**系统工具-代码生成 表格右上角有详细操作怎么改后端!**
**系统工具-代码生成 表格右上角有详细操作怎么改后端!**
**系统工具-代码生成 表格右上角有详细操作怎么改后端!**
- 关于一些监控的地址配置(微服务版本可以跳过这一小节)
使用[RuoYi-Vue-Plus](https://gitee.com/dromara/RuoYi-Vue-Plus/tree/5.X/)注意 `已经去除 admin/snailjob 的.env 配置` 可自行修改 有两种方式
1. 修改源码`/views/monitor/admin` `views/monitor/snailjob`
```ts
// 修改地址
const url = ref('http://127.0.0.1:7700/#/oms/home');
```
2. **推荐** 使用菜单自行配置 (跟 cloud 版本打开方式一致)
使用内嵌 iframe 方式需要解决跨域问题 可参考[nginx.conf](https://gitee.com/dromara/RuoYi-Vue-Plus/blob/5.X/script/docker/nginx/conf/nginx.conf#LC87)配置
- 修改.env.development 配置文件
- **注意 RSA 公私钥一定要修改和后端匹配**
- RSA 公私钥为两对 `前端请求加密-后端解密是一对` `后端响应加密 前端解密是一对`
```properties
# 后台请求路径 具体在vite.config.ts配置代理
VITE_GLOB_API_URL=/basic-api
# 全局加密开关(即开启了加解密功能才会生效 不是全部接口加密 需要和后端对应)
VITE_GLOB_ENABLE_ENCRYPT=true
# RSA公钥 请求加密使用 注意这两个是两对RSA公私钥 请求加密-后端解密是一对 响应解密-后端加密是一对
VITE_GLOB_RSA_PUBLIC_KEY=xxx
# RSA私钥 响应解密使用 注意这两个是两对RSA公私钥 请求加密-后端解密是一对 响应解密-后端加密是一对
VITE_GLOB_RSA_PRIVATE_KEY=xx
# 客户端id 必填
VITE_GLOB_APP_CLIENT_ID=e5cd7e4891bf95d1d19206ce24a7b32e
# 开启WEBSOCKET
VITE_GLOB_WEBSOCKET_ENABLE=true
```
- 运行
```bash
pnpm serve
```
- 打包
```bash
pnpm build
```
## 项目地址
- [vue-vben-admin](https://github.com/anncwb/vue-vben-admin) - vben
- [ruoyi-plus-vben](https://gitee.com/dapppp/ruoyi-plus-vben/tree/master)
- ~~[ruoyi-plus-vben-antv4](https://gitee.com/dapppp/ruoyi-plus-vben-antv4)~~
## Git 贡献提交规范
- 参考 [vue](https://github.com/vuejs/vue/blob/dev/.github/COMMIT_CONVENTION.md) 规范 ([Angular](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular))
- `feat` 增加新功能
- `fix` 修复问题/BUG
- `style` 代码风格相关无影响运行结果的
- `perf` 优化/性能提升
- `refactor` 重构
- `revert` 撤销修改
- `test` 测试相关
- `docs` 文档/注释
- `chore` 依赖更新/脚手架配置修改等
- `workflow` 工作流改进
- `ci` 持续集成
- `types` 类型定义文件更改
- `wip` 开发中
## 浏览器支持
本地开发推荐使用`Chrome 85+` 浏览器
支持现代浏览器, 不支持 IE
| [
](http://godban.github.io/browsers-support-badges/)IE | [](http://godban.github.io/browsers-support-badges/)Edge | [
](http://godban.github.io/browsers-support-badges/)Firefox | [
](http://godban.github.io/browsers-support-badges/)Chrome | [
](http://godban.github.io/browsers-support-badges/)Safari |
| :-: | :-: | :-: | :-: | :-: |
| not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
## 捐赠
如果项目帮助到您 可以考虑请作者喝杯咖啡 万分感谢您对开源的支持!
