# ruoyi-plus-vben

**Repository Path**: codelemons/ruoyi-plus-vben

## Basic Information

- **Project Name**: ruoyi-plus-vben
- **Description**: 基于 vben(ant-design-vue) 的 RuoYi-Vue-Plus 前端项目
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 227
- **Created**: 2023-12-26
- **Last Updated**: 2023-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center"> <a href="https://github.com/anncwb/vue-vben-admin"> <img alt="VbenAdmin Logo" width="200" height="200" src="https://anncwb.github.io/anncwb/images/logo.png"> </a> <br> <br>

[![license](https://img.shields.io/github/license/anncwb/vue-vben-admin.svg)](LICENSE)

<h1>RuoYi Plus Vben</h1>
</div>

## 提示

已经将 antv4 版本的代码提交到该仓库 即默认 main 分支

## 简介

**该仓库是基于[ vben-2.10.1](https://github.com/vbenjs/vue-vben-admin/releases/tag/2.10.1) 版本使用 ant-design-vue 最新版本 V4**

基于 [vben(ant-design-vue)](https://github.com/vbenjs/vue-vben-admin) 的 RuoYi-Vue-Plus 前端项目

| 组件/框架      | 版本   |
| :------------- | :----- |
| vben           | 2.10.1 |
| ant-design-vue | 4.0.5  |

对应后端项目: **(分布式 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

spring-admin -账号: ruoyi 123456 由于服务器太小 没有运行 powerjob 模块

[预览地址点这里](http://139.9.116.11/)

[H5/小程序版本预览](http://139.9.116.11:5050/#/pages/login/index) 预览版本 用移动设备/开发者工具设置移动设备打开

## 文档

[vben 文档地址](https://doc.vvbin.cn/)

[RuoYi-Plus 文档地址](https://plus-doc.dromara.org/#/)

[本框架文档](https://gitee.com/dapppp/ruoyi-plus-vben/blob/master/docs.md)

## 预览图

![图片](https://gitee.com/dapppp/ruoyi-plus-vben/raw/main/preview/1.png) ![图片](https://gitee.com/dapppp/ruoyi-plus-vben/raw/main/preview/2.png) ![图片](https://gitee.com/dapppp/ruoyi-plus-vben/raw/main/preview/3.png) ![图片](https://gitee.com/dapppp/ruoyi-plus-vben/raw/main/preview/4.png) ![图片](https://gitee.com/dapppp/ruoyi-plus-vben/raw/main/preview/5.png) ![图片](https://gitee.com/dapppp/ruoyi-plus-vben-antv4/raw/main/preview/6.png) ![图片](https://gitee.com/dapppp/ruoyi-plus-vben/raw/main/preview/7.png)

## 安装使用

- 获取项目代码

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

- 安装依赖

```bash
cd ruoyi-plus-vben

pnpm install
```

- 修改.env.development 配置文件

```properties
# 设置为代理地址或者直接http地址
VITE_GLOB_API_URL=/dev-api

# 文件上传路径 不用修改
VITE_GLOB_UPLOAD_URL=/resource/oss/upload

# springadmin监控地址 默认为{VITE_GLOB_API_URL}/admin/applications 注意跨域问题
# cloud可以不配置
VITE_GLOB_ADMIN_MONITOR_URL=http://127.0.0.1:9090/admin/applications

# powerjob的后台地址 默认为{VITE_GLOB_API_URL}/powerjob
# cloud可以不配置
VITE_GLOB_POWERJOB_URL=http://127.0.0.1:7700/#/oms/home
```

**提示** 分布式和微服务版本 对于一些第三方监控(如 nacos, springadmin, powerjob 等)

|            | 链接如何显示/打开 |   路径如何获取   |
| :--------: | :---------------: | :--------------: |
| 分布式 5.X |    内嵌 iframe    | env.xxx 文件配置 |
| 微服务 2.x |     外链方式      |     后台返回     |

所以微服务版本不需要配置 env.xxxx 中的地址 是由后台返回 path 而分布式除了需要配置 env.xxx 文件中的路径 还需要通过 nginx 解决跨域问题 可参考[nginx.conf](https://gitee.com/dromara/RuoYi-Vue-Plus/blob/5.X/script/docker/nginx/conf/nginx.conf#LC87)配置

- 运行

```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 80+` 浏览器

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

| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>IE | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari |
| :-: | :-: | :-: | :-: | :-: |
| not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions |