置顶说明

当前分支适配后端v5的latest 不适配v6

当前分支适配后端v5的latest 不适配v6

当前分支适配后端v5的latest 不适配v6

v6已经基于vben5.7版本完全重构(改为单仓项目) 不兼容当前框架 仓库地址 https://gitee.com/dapppp/bell-plus 目前进度开发中 不要用于新项目 底层可能大改

原ant-design-vue版本已经归档到v1/ant-design-vue分支 不再进行更新(当然你可以手动合并官方的更新)

提示

最低需要使用node版本>22.16.0 否则会影响编辑器的格式化(需要安装oxc插件)

该分支使用antdv-next替代已经不维护的antd-design-vue

该仓库使用vben最新版本v5开发

v5版本采用分仓(包)目录结构, 具体开发路径为: 根目录/apps/web-antd

目前对应后端版本: 分布式5.6.0/微服务2.6.0

简介

基于 vben5 & antdv-next 的 RuoYi-Vue-Plus 前端项目

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

分布式 RuoYi-Vue-Plus

微服务 RuoYi-Cloud-Plus

赞助商

• 万级算力服务 https://ku0.com/

预览

admin 账号: admin admin123

预览地址点这里

服务器由以下群友赞助(以下排名不分前后)

依依-阿里/腾讯/华为云服务器高返, 疯狂的牛子Li, 四海升平(站长推荐https://ku0.com/), 疯狂的骡子Li, 疯狂的鸟哥Li疯狂的麦克斯, 消息必须回🤔, 群复读机(末初科技 mochu.tech), 大熊, 張Zcccccy, 等風來再離開, AI主理人

WX Group

演示站 - 微信群菜单

文档

本框架文档 强烈建议阅读

Vben V5 文档地址

RuoYi-Plus 文档地址

预览图

安装使用

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

"packageManager": "pnpm",
"engines": {
  "node": ">=22.16.0",
  "pnpm": "latest"
},

• 获取项目代码

git clone https://github.com/imdap/ruoyi-plus-vben5.git

2. 安装依赖

cd ruoyi-plus-vben5

pnpm install

• 菜单图标替换

参考 菜单图标替换

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

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

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

<!-- 修改地址 -->
<template>
  <iframe
    class="size-full"
    src="http://localhost:9090/admin/applications"
  ></iframe>
</template>

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

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

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

# 端口号
VITE_PORT=5666
# 打包路径
VITE_BASE=/
# 是否开启 Nitro Mock服务，true 为开启，false 为关闭
VITE_NITRO_MOCK=false
# 是否打开 devtools，true 为打开，false 为关闭
VITE_DEVTOOLS=false
# 是否注入全局loading
VITE_INJECT_APP_LOADING=true

# 后台请求路径 具体在vite.config.mts配置代理
VITE_GLOB_API_URL=/api
# 全局加密开关(即开启了加解密功能才会生效 不是全部接口加密 需要和后端对应)
VITE_GLOB_ENABLE_ENCRYPT=true
# RSA公钥 请求加密使用 注意这两个是两对RSA公私钥 请求加密-后端解密是一对 响应解密-后端加密是一对
VITE_GLOB_RSA_PUBLIC_KEY=
# RSA私钥 响应解密使用 注意这两个是两对RSA公私钥 请求加密-后端解密是一对 响应解密-后端加密是一对
VITE_GLOB_RSA_PRIVATE_KEY=
# 客户端id
VITE_GLOB_APP_CLIENT_ID=e5cd7e4891bf95d1d19206ce24a7b32e
# 开启WEBSOCKET
VITE_GLOB_WEBSOCKET_ENABLE=false

• 运行

pnpm dev:antd

4. 打包

pnpm build:antd

这是一个特性 而不是一个bug!

1. 菜单管理可分配 但只有admin/superadmin角色能访问 其他角色访问会到403页面
2. 租户相关菜单可分配 但只有superadmin角色能访问 其他角色访问会到403页面
3. 分配的租户管理员无法修改自己的角色的菜单(即管理员角色的菜单) 防止自己把自己权限弄没了

Git 贡献提交规范

参考 vue 规范 (Angular)

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

浏览器支持

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

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

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