RuoYi-Vue/README.md

154 lines
6.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## 系统需求
* JDK >= 1.8
* MySQL >= 5.5
* Maven >= 3.0
## 技术选型
* 1、系统环境
Java EE 8
Servlet 3.0
Apache Maven 3
* 2、主框架
* Spring Boot 2.1
* Spring Framework 5.1
* Spring Security 5.1
3、持久层
* Apache MyBatis 3.4
* Hibernate Validation 6.0
* Alibaba Druid 1.1
* 4、视图层
* Vue 2.6
* Axios 0.18
* Element UI 2.11
* 5.小程序使用uniapphttps://uniapp.dcloud.io/
# 环境部署
# 准备工作
* JDK >= 1.8 (推荐1.8版本)
* Mysql >= 5.5.0 (推荐5.7版本)
* Redis >= 3.0
* Maven >= 3.0
* Node >= 10
提示
* 前端安装完node后最好设置下淘宝的镜像源不建议使用cnpm可能会出现奇怪的问题
# 后端运行
* 1、导入ruoyi到Eclipse菜单 File -> Import然后选择 Maven -> Existing Maven Projects点击 Next> 按钮,选择工作目录,然后点击 Finish 按钮即可成功导入Eclipse会自动加载Maven依赖包初次加载会比较慢根据自身网络情况而定
* 2、创建数据库mojin并导入数据脚本mojin.sql
* 3.修改好各自项目中的application-dev.yml中的数据库配置和redis配置
* 4、打开运行com.ruoyi.RuoYiApplication.java平台管理接口前端ruoyi-ui【vue项目】
* 5、打开运行com.ruoyi.RuoYiStoreApplication.java商户管理接口前端ruoyi-store-ui【vue项目】
* 5、打开运行com.ruoyi.AppletsAppApplication.java用户端接口前端ruoyi-uniApp模块【uniapp项目】
# 前端运行
# 进入项目目录
* cd ruoyi-ui
# 安装依赖
* npm install
# 强烈建议不要用直接使用 cnpm 安装,会有各种诡异的 bug可以通过重新指定 registry 来解决 npm 安装速度慢的问题。
* npm install --registry=https://registry.npm.taobao.org
# 本地开发 启动项目
* npm run dev
* 当项目开发完毕,只需要运行一行命令就可以打包你的应用
# 打包正式环境
* npm run build:prod
### 用户端uniappruoyi-uniApp模块
1. 下载编辑器HBuilderX.
1. 下载微信开发者工具.
1. 点击HBuilderX顶部菜单->文件->导入->从git导入.
1. 鼠标点击App.vue获取焦点,无需打开文件.
1. 点击HBuilderX编辑器顶部菜单->运行->运行到小程序模拟器.
1. 如果启动不了微信开发者工具,请手动启动微信开发者工具,手动添加项目(项目路径为unpackage/dev/mp-weixin)
1. 打 包: 7.1 打包app点击HBuilderX顶部导航->发行->原生APP云打包. 7.2 打包微信小程序把项目路径unpackage/dev/mp-weixin文件夹拷贝出来即可。
1. 修改接口地址
需要修改config/index.config.js 中的 baseUrl: 改为ruoyi-web中配置的接口地址
其他配置 如appid等需要修改manifest.json(用hbuild打开 有编辑器模式)
# 常见问题
* 如果使用Mac 需要修改application.yml文件路径profile
* 如果使用Linux 提示表不存在,设置大小写敏感配置在/etc/my.cnf 添加lower_case_table_names=1重启MYSQL服务
* 如果提示当前权限不足无法写入文件请检查profile是否可读可写或者无法访问此目录
# 内置功能
## 平台简介
* 前端采用Vue、Element UI。
* 后端采用Spring Boot、Spring Security、Redis & Jwt。
* 权限认证使用Jwt支持多终端认证系统。
* 支持加载动态权限菜单,多方式轻松权限控制。
* 高效率开发,使用代码生成器可以一键生成前后端代码。
## 内置功能
1. 用户管理:用户是系统操作者,该功能主要完成系统用户配置。
2. 部门管理:配置系统组织机构(公司、部门、小组),树结构展现支持数据权限。
3. 岗位管理:配置系统用户所属担任职务。
4. 菜单管理:配置系统菜单,操作权限,按钮权限标识等。
5. 角色管理:角色菜单权限分配、设置角色按机构进行数据范围权限划分。
6. 字典管理:对系统中经常使用的一些较为固定的数据进行维护。
7. 参数管理:对系统动态配置常用参数。
8. 通知公告:系统通知公告信息发布维护。
9. 操作日志:系统正常操作日志记录和查询;系统异常信息日志记录和查询。
10. 登录日志:系统登录日志记录查询包含登录异常。
11. 在线用户:当前系统中活跃用户状态监控。
12. 定时任务:在线(添加、修改、删除)任务调度包含执行结果日志。
13. 代码生成前后端代码的生成java、html、xml、sql支持CRUD下载 。
14. 系统接口根据业务代码自动生成相关的api接口文档。
15. 服务监控监视当前系统CPU、内存、磁盘、堆栈等相关信息。
16. 在线构建器拖动表单元素生成相应的HTML代码。
17. 连接池监视监视当前系统数据库连接池状态可进行分析SQL找出系统性能瓶颈。
## 演示图
<table>
<tr>
<td><img src="https://oscimg.oschina.net/oscnet/cd1f90be5f2684f4560c9519c0f2a232ee8.jpg"/></td>
<td><img src="https://oscimg.oschina.net/oscnet/1cbcf0e6f257c7d3a063c0e3f2ff989e4b3.jpg"/></td>
</tr>
<tr>
<td><img src="https://oscimg.oschina.net/oscnet/707825ad3f29de74a8d6d02fbd73ad631ea.jpg"/></td>
<td><img src="https://oscimg.oschina.net/oscnet/46be40cc6f01aa300eed53a19b5012bf484.jpg"/></td>
</tr>
<tr>
<td><img src="https://oscimg.oschina.net/oscnet/4284796d4cea240d181b8f2201813dda710.jpg"/></td>
<td><img src="https://oscimg.oschina.net/oscnet/3ecfac87a049f7fe36abbcaafb2c40d36cf.jpg"/></td>
</tr>
<tr>
<td><img src="https://oscimg.oschina.net/oscnet/71c2d48905221a09a728df4aff4160b8607.jpg"/></td>
<td><img src="https://oscimg.oschina.net/oscnet/c14c1ee9a64a6a9c2c22f67d43198767dbe.jpg"/></td>
</tr>
<tr>
<td><img src="https://oscimg.oschina.net/oscnet/5e8c387724954459291aafd5eb52b456f53.jpg"/></td>
<td><img src="https://oscimg.oschina.net/oscnet/644e78da53c2e92a95dfda4f76e6d117c4b.jpg"/></td>
</tr>
<tr>
<td><img src="https://oscimg.oschina.net/oscnet/fdea1d8bb8625c27bf964176a2c8ebc6945.jpg"/></td>
<td><img src="https://oscimg.oschina.net/oscnet/509d2708cfd762b6e6339364cac1cc1970c.jpg"/></td>
</tr>
<tr>
<td><img src="https://oscimg.oschina.net/oscnet/up-f1fd681cc9d295db74e85ad6d2fe4389454.png"/></td>
<td><img src="https://oscimg.oschina.net/oscnet/up-c195234bbcd30be6927f037a6755e6ab69c.png"/></td>
</tr>
<tr>
<td><img src="https://oscimg.oschina.net/oscnet/b6115bc8c31de52951982e509930b20684a.jpg"/></td>
<td><img src="https://oscimg.oschina.net/oscnet/up-6d73c2140ce694e3de4c05035fdc1868d4c.png"/></td>
</tr>
</table>