RuoYi Plus Vben

提示

该仓库为老版本[vben2]已不再进行维护/更新

最后支持后端版本 5.2.3/2.2.3

适配最新的 [vben5] 移步gitee地址

简介

基于 vben(ant-design-vue) 的 RuoYi-Vue-Plus 前端项目

组件/框架	版本
vben	2.11.4
ant-design-vue	4.2.5
vue	3.4.37

对应后端项目: (分布式 5.X 分支 微服务 2.分支)

分布式 RuoYi-Vue-Plus

微服务 RuoYi-Cloud-Plus

预览

admin 账号: admin admin123

预览地址点这里

文档

vben 文档地址

RuoYi-Plus 文档地址

本框架文档(必看)

预览图

安装使用

前置准备环境(只能用pnpm)

"packageManager": "pnpm",
"engines": {
  "node": ">=18.12.0",
  "pnpm": ">=9.0.4"
}

• 获取项目代码

git clone https://gitee.com/dapppp/ruoyi-plus-vben.git

• 安装依赖

cd ruoyi-plus-vben

pnpm install

• 关于代码生成(非必选)

系统工具-代码生成 表格右上角有详细操作怎么改后端!

系统工具-代码生成 表格右上角有详细操作怎么改后端!

系统工具-代码生成 表格右上角有详细操作怎么改后端!

• 关于一些监控的地址配置(微服务版本可以跳过这一小节)

使用RuoYi-Vue-Plus注意 已经去除 admin/snailjob 的.env 配置 可自行修改 有两种方式

1. 修改源码/views/monitor/admin views/monitor/snailjob

// 修改地址
const url = ref<string>('http://127.0.0.1:7700/#/oms/home');

2. 推荐 使用菜单自行配置 (跟 cloud 版本打开方式一致)

使用内嵌 iframe 方式需要解决跨域问题 可参考nginx.conf配置

• 修改.env.development 配置文件
• 注意 RSA 公私钥一定要修改和后端匹配
• RSA 公私钥为两对 前端请求加密-后端解密是一对 后端响应加密 前端解密是一对

# 后台请求路径 具体在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

• 运行

pnpm serve

• 打包

pnpm build

Git 贡献提交规范

• 参考 vue 规范 (Angular)

  • feat 增加新功能
  • fix 修复问题/BUG
  • style 代码风格相关无影响运行结果的
  • perf 优化/性能提升
  • refactor 重构
  • revert 撤销修改
  • test 测试相关
  • docs 文档/注释
  • chore 依赖更新/脚手架配置修改等
  • workflow 工作流改进
  • ci 持续集成
  • types 类型定义文件更改
  • wip 开发中

浏览器支持

最低适配应该为Chrome 88+以上浏览器 详见 css - where

本地开发推荐使用Chrome 最新版本浏览器

支持现代浏览器, 不支持 IE

IE	Edge	Firefox	Chrome	Safari
not support	last 2 versions	last 2 versions	last 2 versions	last 2 versions

捐赠

如果项目帮助到您 可以考虑请作者喝杯咖啡 万分感谢您对开源的支持!