diff --git a/README.md b/README.md index 8ee0b8df..57d4ce59 100644 --- a/README.md +++ b/README.md @@ -1,158 +1,272 @@ -**项目说明** -- 采用SpringBoot、MyBatis、Shiro框架,开发的一套权限系统,极低门槛,拿来即用。设计之初,就非常注重安全性,为企业系统保驾护航,让一切都变得如此简单。 -- 提供了代码生成器,只需编写30%左右代码,其余的代码交给系统自动生成,可快速完成开发任务 -- 支持MySQL、Oracle、SQL Server、PostgreSQL等主流数据库 -
- -**具有如下特点** -- 灵活的权限控制,可控制到页面或按钮,满足绝大部分的权限需求 -- 完善的部门管理及数据权限,通过注解实现数据权限的控制 -- 完善的XSS防范及脚本过滤,彻底杜绝XSS攻击 -- 支持分布式部署,session存储在redis中 -- 友好的代码结构及注释,便于阅读及二次开发 -- 引入quartz定时任务,可动态完成任务的添加、修改、删除、暂停、恢复及日志查看等功能 -- 页面交互使用Vue2.x,极大的提高了开发效率 -- 引入swagger文档支持,方便编写API接口文档 - -
- -**数据权限设计思想** -- 管理员管理、角色管理、部门管理,可操作本部门及子部门数据 -- 菜单管理、定时任务、参数管理、字典管理、系统日志,没有数据权限 -- 业务功能,按照用户数据权限,查询、操作数据【没有本部门数据权限,也能查询本人数据】 - -
- -**项目结构** -``` -renren-security -├─renren-common 公共模块 -│ -├─renren-admin 管理后台 -│ ├─db 数据库SQL脚本 -│ │ -│ ├─modules 模块 -│ │ ├─job 定时任务 -│ │ ├─oss 文件存储 -│ │ └─sys 系统管理(核心) -│ │ -│ └─resources -│ ├─mapper MyBatis文件 -│ ├─statics 静态资源 -│ ├─template 系统页面 -│ │ ├─modules 模块页面 -│ │ ├─index.html AdminLTE主题风格(默认主题) -│ │ └─index1.html Layui主题风格 -│ └─application.yml 全局配置文件 -│ -│ -├─renren-api API服务 -│ -├─renren-generator 代码生成器 -│ └─resources -│ ├─mapper MyBatis文件 -│ ├─template 代码生成器模板(可增加或修改相应模板) -│ ├─application.yml 全局配置文件 -│ └─generator.properties 代码生成器,配置文件 -│ -``` - -
- - **技术选型:** -- 核心框架:Spring Boot 2.1 -- 安全框架:Apache Shiro 1.4 -- 视图框架:Spring MVC 5.0 -- 持久层框架:MyBatis 3.5 -- 定时器:Quartz 2.3 -- 数据库连接池:Druid 1.1 -- 日志管理:SLF4J 1.7、Log4j -- 页面交互:Vue2.x - -
- - **软件需求** -- JDK1.8 -- MySQL5.5+ -- Maven3.0+ - -
- - **本地部署** -- 通过git下载源码 -- idea、eclipse需安装lombok插件,不然会提示找不到entity的get set方法 -- 创建数据库renren_security,数据库编码为UTF-8 -- 执行db/mysql.sql文件,初始化数据【按需导入表结构及数据】 -- 修改application-dev.yml文件,更新MySQL账号和密码 -- 在renren-security目录下,执行mvn clean install -
- -- Eclipse、IDEA运行AdminApplication.java,则可启动项目【renren-admin】 -- renren-admin访问路径:http://localhost:8080/renren-admin -- swagger文档路径:http://localhost:8080/renren-admin/swagger/index.html -- swagger注解路径:http://localhost:8080/renren-admin/swagger-ui.html -- 账号密码:admin/admin - -
- -- Eclipse、IDEA运行ApiApplication.java,则可启动项目【renren-api】 -- renren-api访问路径:http://localhost:8081/renren-api/swagger-ui.html - -
- -- Eclipse、IDEA运行GeneratorApplication.java,则可启动项目【renren-generator】 -- renren-generator访问路径:http://localhost:8082/renren-generator - - -
- - **集群部署** -- 集群部署,需要安装redis,并配置redis信息 -- 需要配置【renren.redis.open=true】,表示开启redis缓存 -- 需要配置【renren.cluster=true】,表示开启集群环境 - -
- - **项目演示** -- 演示地址:http://demo.open.renren.io/renren-security -- 账号密码:admin/admin - -
- -**如何交流、反馈、参与贡献?** -- 开发文档:https://www.renren.io/guide/security -- 官方社区:https://www.renren.io/community -- gitee仓库:https://gitee.com/renrenio/renren-security -- github仓库:https://github.com/renrenio/renren-security -- [人人开源](https://www.renren.io):https://www.renren.io -- 官方QQ群:324780204、145799952 -- 如需关注项目最新动态,请Watch、Star项目,同时也是对项目最好的支持 -- 技术讨论、二次开发等咨询、问题和建议,请移步到官方社区,我会在第一时间进行解答和回复! -- 微信扫码并关注【人人开源】,获得项目最新动态及更新提醒
-![输入图片说明](http://cdn.renren.io/47c26201804031918312618.jpg "在这里输入图片标题") -
-
- -**接口文档效果图:** -![输入图片说明](http://cdn.renren.io/img/c8dae596146248d8b4d0639738c2932b "在这里输入图片标题") - -
- -**Layui主题风格:** -![输入图片说明](http://cdn.renren.io/img/1013aa91fe8542b7b05d82bc9444433a "在这里输入图片标题") - -
- -**AdminLTE主题风格:** -![输入图片说明](http://cdn.renren.io/img/f9762bc6574545ce908e271995efcf1c "在这里输入图片标题") -![输入图片说明](http://cdn.renren.io/img/a1b8bf1ea3db4844a8652a9cf84048cc "在这里输入图片标题") -![输入图片说明](http://cdn.renren.io/img/e542060605f94b3ebec699b0afffc22d "在这里输入图片标题") -![输入图片说明](http://cdn.renren.io/img/c94be5b4bf0d4387b18e119c91b1a986 "在这里输入图片标题") -![输入图片说明](http://cdn.renren.io/img/ae8c683a01c74d8dbc52d62547efda31 "在这里输入图片标题") -![输入图片说明](http://cdn.renren.io/img/ca38bcf3717c427d82dd67d86b744e18 "在这里输入图片标题") -![输入图片说明](http://cdn.renren.io/img/4862ec46a9ad469b90c30788c4707e35 "在这里输入图片标题") -![输入图片说明](http://cdn.renren.io/img/5d8e7243d30a4421b90f15394b6d1ccd "在这里输入图片标题") - -
- -![捐赠](http://cdn.renren.io/donate.jpg "捐赠") \ No newline at end of file +**项目说明** +- renren-security是一个轻量级权限管理系统,其核心设计目标是开发迅速、学习简单、轻量级、易扩展 +- 使用renren-security搭建项目,只需编写30%左右代码,其余的代码交给系统自动生成 +- 一个月的工作量,一周就能完成,剩余的时间可以陪家人、朋友、撩妹、钓凯子等,从此踏入高富帅、白富美行业 + + +**具有如下特点** +- 轻量级的权限系统,只涉及Spring、Shiro、Mybatis后端框架,降低学习使用成本 +- 友好的代码结构及注释,便于阅读及二次开发 +- 支持HTML、JSP、Velocity、Freemarker等视图,零技术门槛 +- 灵活的权限控制,可控制到页面或按钮,满足绝大部分的权限需求 +- 页面交互使用Vue2.x,极大的提高了开发效率 +- 完善的代码生成机制,可在线生成entity、xml、dao、service、html、js、sql代码,减少70%以上的开发任务 +- 引入quartz定时任务,可动态完成任务的添加、修改、删除、暂停、恢复及日志查看等功能 +- 引入API模板,根据token作为登录令牌,极大的方便了APP接口开发 +- 引入Hibernate Validator校验框架,轻松实现后端校验 +- 引入云存储服务,已支持:七牛云、阿里云、腾讯云等 +- 引入路由机制,刷新页面会停留在当前页 + + +**项目结构** +``` +renren-security +├─doc 项目SQL语句 +├─renren-common 公共模块 +│ ├─annotation 公共注解 +│ ├─oss 云存储服务 +│ ├─validator 后台校验 +│ └─db.properties 数据库配置文件 +│ +├─renren-api API模块(接口开发) +│ +├─renren-gen 代码生成器模块 +│ ├─template 代码生成器模板(可增加或修改相应模板) +│ └─generator.properties 配置文件(配置包名、类型转换等) +│ +├─renren-schedule 定时任务模块 +│ +├─renren-shiro 权限模块 +│ +├─renren-shiro-dept 部门权限模块(待开发) +│ +├──renren-web 管理后台模块 +│ ├─js 系统业务js代码 +│ ├─statics 第三方库、插件等静态资源 +│ ├─index.html AdminLTE主题风格(默认主题) +│ └─index1.html Layui主题风格 + +``` + + +**如何交流、反馈、参与贡献?** +- 项目主页:http://www.renren.io/open/ +- 开发文档:http://www.renren.io/open/doc.html +- oschina仓库:http://git.oschina.net/babaio/renren-security +- github仓库:https://github.com/sunlightcs/renren-security +- [编程入门教程](http://www.renren.io):http://www.renren.io +- 官方QQ群:324780204、145799952 +- 如需关注项目最新动态,请Watch、Star项目,同时也是对项目最好的支持 +- 技术讨论、二次开发等咨询、问题和建议,请移步到QQ群324780204、145799952,我会在第一时间进行解答和回复! + +**Layui主题风格:** +![输入图片说明](http://cdn.renren.io/img/2f6a43b9081e421ab8aa596155cd0ffc "在这里输入图片标题") + +**AdminLTE主题风格:** +![输入图片说明](http://cdn.renren.io/img/de740e471280429cb888f521e02ee787 "在这里输入图片标题") +![输入图片说明](http://cdn.renren.io/img/44907148dd254064922a80cfddcc9b53 "在这里输入图片标题") +![输入图片说明](http://cdn.renren.io/img/f38a062145b141bf81157b495277d224 "在这里输入图片标题") +![输入图片说明](http://cdn.renren.io/img/65d7fb1906934e56abf8b8ca7e1c4541 "在这里输入图片标题") +![输入图片说明](http://cdn.renren.io/img/a8bc68f69288424697682f170ee40744 "在这里输入图片标题") +![输入图片说明](http://cdn.renren.io/img/92cd56f397754292a1a182f662a7e883 "在这里输入图片标题") +![输入图片说明](http://cdn.renren.io/img/0b56efe56fd64ed18e33a9e6dbb6e88c "在这里输入图片标题") + + + + + + + + **技术选型:** +- 核心框架:Spring Framework 4.3 +- 安全框架:Apache Shiro 1.3 +- 视图框架:Spring MVC 4.3 +- 持久层框架:MyBatis 3.3 +- 定时器:Quartz 2.2 +- 数据库连接池:Druid 1.0 +- 日志管理:SLF4J 1.7、Log4j +- 页面交互:Vue2.x + + + **软件需求** +- JDK1.7+ +- MySQL5.5+ +- Tomcat7.0+ +- Maven3.0+ + + + + **本地部署** +- 通过git下载源码 +- 创建数据库renren-security,数据库编码为UTF-8 +- 执行doc/db.sql文件,初始化数据【按需导入表结构及数据】 +- 修改db.properties文件,更新MySQL账号和密码 +- Eclipse、IDEA执行【clean package tomcat7:run】命令,即可运行项目 +- 项目访问路径:http://localhost +- 非Maven方式启动,则默认访问路径为:http://localhost:8080/renren-security + + + +**项目打赏** + +如果您觉得作者的权限系统能帮助到您,您可以打赏作者一瓶汽水 +![输入图片说明](http://cdn.renren.io/img/10e0f63b327d4e7ab9113e7b9568381a "在这里输入图片标题") +======= +**项目说明** +- 采用SpringBoot、MyBatis、Shiro框架,开发的一套权限系统,极低门槛,拿来即用。设计之初,就非常注重安全性,为企业系统保驾护航,让一切都变得如此简单。 +- 提供了代码生成器,只需编写30%左右代码,其余的代码交给系统自动生成,可快速完成开发任务 +- 支持MySQL、Oracle、SQL Server、PostgreSQL等主流数据库 +
+ +**具有如下特点** +- 灵活的权限控制,可控制到页面或按钮,满足绝大部分的权限需求 +- 完善的部门管理及数据权限,通过注解实现数据权限的控制 +- 完善的XSS防范及脚本过滤,彻底杜绝XSS攻击 +- 支持分布式部署,session存储在redis中 +- 友好的代码结构及注释,便于阅读及二次开发 +- 引入quartz定时任务,可动态完成任务的添加、修改、删除、暂停、恢复及日志查看等功能 +- 页面交互使用Vue2.x,极大的提高了开发效率 +- 引入swagger文档支持,方便编写API接口文档 + +
+ +**数据权限设计思想** +- 管理员管理、角色管理、部门管理,可操作本部门及子部门数据 +- 菜单管理、定时任务、参数管理、字典管理、系统日志,没有数据权限 +- 业务功能,按照用户数据权限,查询、操作数据【没有本部门数据权限,也能查询本人数据】 + +
+ +**项目结构** +``` +renren-security +├─renren-common 公共模块 +│ +├─renren-admin 管理后台 +│ ├─db 数据库SQL脚本 +│ │ +│ ├─modules 模块 +│ │ ├─job 定时任务 +│ │ ├─oss 文件存储 +│ │ └─sys 系统管理(核心) +│ │ +│ └─resources +│ ├─mapper MyBatis文件 +│ ├─statics 静态资源 +│ ├─template 系统页面 +│ │ ├─modules 模块页面 +│ │ ├─index.html AdminLTE主题风格(默认主题) +│ │ └─index1.html Layui主题风格 +│ └─application.yml 全局配置文件 +│ +│ +├─renren-api API服务 +│ +├─renren-generator 代码生成器 +│ └─resources +│ ├─mapper MyBatis文件 +│ ├─template 代码生成器模板(可增加或修改相应模板) +│ ├─application.yml 全局配置文件 +│ └─generator.properties 代码生成器,配置文件 +│ +``` + +
+ + **技术选型:** +- 核心框架:Spring Boot 2.1 +- 安全框架:Apache Shiro 1.4 +- 视图框架:Spring MVC 5.0 +- 持久层框架:MyBatis 3.5 +- 定时器:Quartz 2.3 +- 数据库连接池:Druid 1.1 +- 日志管理:SLF4J 1.7、Log4j +- 页面交互:Vue2.x + +
+ + **软件需求** +- JDK1.8 +- MySQL5.5+ +- Maven3.0+ + +
+ + **本地部署** +- 通过git下载源码 +- idea、eclipse需安装lombok插件,不然会提示找不到entity的get set方法 +- 创建数据库renren_security,数据库编码为UTF-8 +- 执行db/mysql.sql文件,初始化数据【按需导入表结构及数据】 +- 修改application-dev.yml文件,更新MySQL账号和密码 +- 在renren-security目录下,执行mvn clean install +
+ +- Eclipse、IDEA运行AdminApplication.java,则可启动项目【renren-admin】 +- renren-admin访问路径:http://localhost:8080/renren-admin +- swagger文档路径:http://localhost:8080/renren-admin/swagger/index.html +- swagger注解路径:http://localhost:8080/renren-admin/swagger-ui.html +- 账号密码:admin/admin + +
+ +- Eclipse、IDEA运行ApiApplication.java,则可启动项目【renren-api】 +- renren-api访问路径:http://localhost:8081/renren-api/swagger-ui.html + +
+ +- Eclipse、IDEA运行GeneratorApplication.java,则可启动项目【renren-generator】 +- renren-generator访问路径:http://localhost:8082/renren-generator + + +
+ + **集群部署** +- 集群部署,需要安装redis,并配置redis信息 +- 需要配置【renren.redis.open=true】,表示开启redis缓存 +- 需要配置【renren.cluster=true】,表示开启集群环境 + +
+ + **项目演示** +- 演示地址:http://demo.open.renren.io/renren-security +- 账号密码:admin/admin + +
+ +**如何交流、反馈、参与贡献?** +- 开发文档:https://www.renren.io/guide/security +- 官方社区:https://www.renren.io/community +- gitee仓库:https://gitee.com/renrenio/renren-security +- github仓库:https://github.com/renrenio/renren-security +- [人人开源](https://www.renren.io):https://www.renren.io +- 官方QQ群:324780204、145799952 +- 如需关注项目最新动态,请Watch、Star项目,同时也是对项目最好的支持 +- 技术讨论、二次开发等咨询、问题和建议,请移步到官方社区,我会在第一时间进行解答和回复! +- 微信扫码并关注【人人开源】,获得项目最新动态及更新提醒
+![输入图片说明](http://cdn.renren.io/47c26201804031918312618.jpg "在这里输入图片标题") +
+
+ +**接口文档效果图:** +![输入图片说明](http://cdn.renren.io/img/c8dae596146248d8b4d0639738c2932b "在这里输入图片标题") + +
+ +**Layui主题风格:** +![输入图片说明](http://cdn.renren.io/img/1013aa91fe8542b7b05d82bc9444433a "在这里输入图片标题") + +
+ +**AdminLTE主题风格:** +![输入图片说明](http://cdn.renren.io/img/f9762bc6574545ce908e271995efcf1c "在这里输入图片标题") +![输入图片说明](http://cdn.renren.io/img/a1b8bf1ea3db4844a8652a9cf84048cc "在这里输入图片标题") +![输入图片说明](http://cdn.renren.io/img/e542060605f94b3ebec699b0afffc22d "在这里输入图片标题") +![输入图片说明](http://cdn.renren.io/img/c94be5b4bf0d4387b18e119c91b1a986 "在这里输入图片标题") +![输入图片说明](http://cdn.renren.io/img/ae8c683a01c74d8dbc52d62547efda31 "在这里输入图片标题") +![输入图片说明](http://cdn.renren.io/img/ca38bcf3717c427d82dd67d86b744e18 "在这里输入图片标题") +![输入图片说明](http://cdn.renren.io/img/4862ec46a9ad469b90c30788c4707e35 "在这里输入图片标题") +![输入图片说明](http://cdn.renren.io/img/5d8e7243d30a4421b90f15394b6d1ccd "在这里输入图片标题") + +
+ +![捐赠](http://cdn.renren.io/donate.jpg "捐赠")