diff --git a/README.md b/README.md index 3125fc57187b27fb5ca73950bd74053663d76c8b..a779e24ec71c85ad179f50ad12b0bdd5ffefbd5d 100644 --- a/README.md +++ b/README.md @@ -1,102 +1,117 @@ -

- logo -

-

RuoYi v4.7.9

-

基于SpringBoot开发的轻量级Java快速开发框架

-

- - - -

- -## 平台简介 - -一直想做一款后台管理系统，看了很多优秀的开源项目但是发现没有合适的。于是利用空闲休息时间开始自己写了一套后台系统。如此有了若依。她可以用于所有的Web应用程序，如网站管理后台，网站会员中心，CMS，CRM，OA。所有前端后台代码封装过后十分精简易上手，出错概率低。同时支持移动客户端访问。系统会陆续更新一些实用功能。 - -性别男，若依是给女儿取的名字（寓意：你若不离不弃，我必生死相依） - -若依是一套全部开源的快速开发平台，毫无保留给个人及企业免费使用。 - -* 前后端分离版本，请移步[RuoYi-Vue](https://gitee.com/y_project/RuoYi-Vue)，微服务版本，请移步[RuoYi-Cloud](https://gitee.com/y_project/RuoYi-Cloud) -* 感谢 [hplus](https://gitee.com/hplus_admin/hplus) 后台主题 UI 框架。 -* 阿里云折扣场：[点我进入](http://aly.ruoyi.vip)，腾讯云秒杀场：[点我进入](http://txy.ruoyi.vip)   -* 阿里云优惠券：[点我领取](https://www.aliyun.com/minisite/goods?userCode=brki8iof&share_source=copy_link)，腾讯云优惠券：[点我领取](https://cloud.tencent.com/redirect.php?redirect=1025&cps_key=198c8df2ed259157187173bc7f4f32fd&from=console)   - -## 内置功能 - -1. 用户管理：用户是系统操作者，该功能主要完成系统用户配置。 -2. 部门管理：配置系统组织机构（公司、部门、小组），树结构展现支持数据权限。 -3. 岗位管理：配置系统用户所属担任职务。 -4. 菜单管理：配置系统菜单，操作权限，按钮权限标识等。 -5. 角色管理：角色菜单权限分配、设置角色按机构进行数据范围权限划分。 -6. 字典管理：对系统中经常使用的一些较为固定的数据进行维护。 -7. 参数管理：对系统动态配置常用参数。 -8. 通知公告：系统通知公告信息发布维护。 -9. 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。 -10. 登录日志：系统登录日志记录查询包含登录异常。 -11. 在线用户：当前系统中活跃用户状态监控。 -12. 定时任务：在线（添加、修改、删除)任务调度包含执行结果日志。 -13. 代码生成：前后端代码的生成（java、html、xml、sql）支持CRUD下载 。 -14. 系统接口：根据业务代码自动生成相关的api接口文档。 -15. 服务监控：监视当前系统CPU、内存、磁盘、堆栈等相关信息。 -16. 缓存监控：对系统的缓存查询，删除、清空等操作。 -17. 在线构建器：拖动表单元素生成相应的HTML代码。 -18. 连接池监视：监视当前系统数据库连接池状态，可进行分析SQL找出系统性能瓶颈。 - -## 在线体验 - -- admin/admin123 -- 陆陆续续收到一些打赏，为了更好的体验已用于演示服务器升级。谢谢各位小伙伴。 - -演示地址：http://ruoyi.vip -文档地址：http://doc.ruoyi.vip - -## 演示图 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - -## 若依交流群 - -QQ群： [![加入QQ群](https://img.shields.io/badge/已满-1389287-blue.svg)](https://jq.qq.com/?_wv=1027&k=5HBAaYN) [![加入QQ群](https://img.shields.io/badge/已满-1679294-blue.svg)](https://jq.qq.com/?_wv=1027&k=5cHeRVW) [![加入QQ群](https://img.shields.io/badge/已满-1529866-blue.svg)](https://jq.qq.com/?_wv=1027&k=53R0L5Z) [![加入QQ群](https://img.shields.io/badge/已满-1772718-blue.svg)](https://jq.qq.com/?_wv=1027&k=5g75dCU) [![加入QQ群](https://img.shields.io/badge/已满-1366522-blue.svg)](https://jq.qq.com/?_wv=1027&k=58cPoHA) [![加入QQ群](https://img.shields.io/badge/已满-1382251-blue.svg)](https://jq.qq.com/?_wv=1027&k=5Ofd4Pb) [![加入QQ群](https://img.shields.io/badge/已满-1145125-blue.svg)](https://jq.qq.com/?_wv=1027&k=5yugASz) [![加入QQ群](https://img.shields.io/badge/已满-86752435-blue.svg)](https://jq.qq.com/?_wv=1027&k=5Rf3d2P) [![加入QQ群](https://img.shields.io/badge/已满-134072510-blue.svg)](https://jq.qq.com/?_wv=1027&k=5ZIjaeP) [![加入QQ群](https://img.shields.io/badge/已满-210336300-blue.svg)](https://jq.qq.com/?_wv=1027&k=5CJw1jY) [![加入QQ群](https://img.shields.io/badge/已满-339522636-blue.svg)](https://jq.qq.com/?_wv=1027&k=5omzbKc) [![加入QQ群](https://img.shields.io/badge/已满-130035985-blue.svg)](https://jq.qq.com/?_wv=1027&k=qPIKBb7s) [![加入QQ群](https://img.shields.io/badge/已满-143151071-blue.svg)](https://jq.qq.com/?_wv=1027&k=4NsjKbtU) [![加入QQ群](https://img.shields.io/badge/已满-158781320-blue.svg)](https://jq.qq.com/?_wv=1027&k=VD2pkz2G) [![加入QQ群](https://img.shields.io/badge/已满-201531282-blue.svg)](https://jq.qq.com/?_wv=1027&k=HlshFwkJ) [![加入QQ群](https://img.shields.io/badge/已满-101526938-blue.svg)](https://jq.qq.com/?_wv=1027&k=0ARRrO9V) [![加入QQ群](https://img.shields.io/badge/已满-264355400-blue.svg)](https://jq.qq.com/?_wv=1027&k=up9k3ZXJ) [![加入QQ群](https://img.shields.io/badge/已满-298522656-blue.svg)](https://jq.qq.com/?_wv=1027&k=540WfdEr) [![加入QQ群](https://img.shields.io/badge/已满-139845794-blue.svg)](https://jq.qq.com/?_wv=1027&k=ss91fC4t) [![加入QQ群](https://img.shields.io/badge/已满-185760789-blue.svg)](https://jq.qq.com/?_wv=1027&k=Cqd66IKe) [![加入QQ群](https://img.shields.io/badge/已满-175104288-blue.svg)](https://jq.qq.com/?_wv=1027&k=7FplYUnR) [![加入QQ群](https://img.shields.io/badge/已满-174942938-blue.svg)](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=lqMHu_5Fskm7H2S1vNAQTtzAUokVydwc&authKey=ptw0Fpch5pbNocML3CIJKKqZBaq2DI7cusKuzIgfMNiY3t9Pvd9hP%2BA8WYx3yaY1&noverify=0&group_code=174942938) [![加入QQ群](https://img.shields.io/badge/287843737-blue.svg)](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=blYlRDmwZXSXI5pVrPPU7ZJ1stFJ6Q2Q&authKey=ForGBWffHVlPt9NE3d7g4DoOIouBh%2BqvAj2lp1CLReHfZAUaK7SRrdwsChKpRJDJ&noverify=0&group_code=287843737) \ No newline at end of file + + +# 若依（RuoYi）后台管理系统 + +## 平台简介 +若依（RuoYi）是一款基于Spring Boot的权限管理系统，采用前后端分离架构，支持多租户、动态数据源、代码生成等核心功能。系统提供可视化Web界面，集成Spring Security、Shiro、MyBatis、Bootstrap等主流技术，包含用户管理、角色权限、菜单管理、部门管理、岗位管理、字典管理等基础功能模块。 + +## 内置功能 +### 核心管理系统 +- **用户管理**：用户增删改查/角色分配/部门关联 +- **角色权限**：权限分级/菜单授权/数据权限 +- **菜单管理**：动态路由/权限绑定 +- **部门管理**：树形结构/层级管理 +- **岗位管理**：岗位CRUD/部门绑定 +- **字典管理**：全局数据字典/编码维护 + +### 系统监控 +- **在线用户**：实时会话管理/强制下线 +- **登录日志**：登录记录查询/清理 +- **操作日志**：记录用户操作/日志导出 +- **缓存监控**：Redis可视化管理 +- **服务器状态**：系统资源监控（内存/CPU/磁盘） + +### 演示模块 +- **UI组件**：对话框/弹窗/卡片/标签页 +- **表单控件**：时间选择/文件上传/双列表框 +- **数据展示**：表格增删改查/固定列/虚拟滚动 +- **数据可视化**：ECharts图表/Petty小图/Sparkline迷你图 +- **交互示例**：流程条/时间轴/可编辑表格 + +## 在线体验 +暂无公开演示地址，请参考本地部署说明启动测试环境 + +## 演示图 +请在`/ruoyi-admin/src/main/resources/static/images/demo/`目录查看UI组件示例截图 + +## 技术架构 +- **后端**：Spring Boot 2.x + MyBatis + Shiro +- **前端**：Bootstrap 4 + jQuery + Layui + zTree +- **数据库**：MySQL + Redis + Druid连接池 +- **部署**：Tomcat 9.x + JDK 1.8+ + +## 安装部署 +### 环境准备 +1. 安装Maven 3.6+和JDK 1.8+ +2. 配置MySQL 5.7+数据库 +3. （可选）安装Redis 6.x缓存 + +### 构建步骤 +```bash +# 克隆仓库 +git clone https://22173.runjs.cn/test-ccannew/RuoYi.git +cd RuoYi/ruoyi-admin + +# 修改数据库配置 +nano src/main/resources/application.yml # 配置MySQL连接 + +# 打包构建 +mvn clean package + +# 启动服务 +java -jar target/ruoyi-admin.jar +``` + +### Windows快捷启动 +```bat +# 使用bat脚本 +bin\package.bat # 构建 +bin\run.bat # 运行 +``` + +## 使用说明 +### 关键接口 +- **文件上传**：`POST /common/upload`（支持单/多文件） +- **用户登录**：`POST /login`（Shiro认证） +- **数据字典**：`GET /system/dict/data`（动态加载） +- **部门树**：`GET /system/dept/treeData`（zTree组件） + +### 功能示例 +1. **用户管理**： +```java +// 查询列表 GET /system/user/list +// 新增用户 POST /system/user/add +// 修改状态 POST /system/user/changeStatus +``` + +2. **权限配置**： +```java +// 角色授权 GET /system/role/authDataScope +// 菜单绑定 POST /system/role/authDataScope +``` + +3. **表格功能**： +```html + + +``` + +## 开发者资源 +- **Swagger文档**：`GET /tool/swagger`（API可视化） +- **代码生成器**：`GET /tool/build`（数据库表自动生成CRUD） +- **前端库**：Bootstrap 4/Select2/SmartWizard/Summernote + +## 社区支持 +加入[若依开源交流群](https://22173.runjs.cn/test-ccannew/RuoYi)获取技术支持 + +## 贡献指南 +1. Fork仓库 +2. 创建feature分支 +3. 提交PR并填写[PR模板](.gitee/PULL_REQUEST_TEMPLATE.zh-CN.md) +4. 核心功能需提供单元测试 + +## 许可证 +MIT License，请查看[LICENSE](LICENSE)文件 + +## 版本信息 +当前版本：`4.3.0`（根据实际pom.xml版本修改） \ No newline at end of file