renren-security/README.md

129 lines
4.9 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.

### 项目说明
- renren-security是一个轻量级的前后端分离的Java快速开发平台能快速开发项目并交付【接私活利器】
- 采用SpringBoot、Shiro、MyBatis-Plus框架开发的一套权限系统极低门槛拿来即用。设计之初就非常注重安全性为企业系统保驾护航让一切都变得如此简单。
- 提供了代码生成器只需编写30%左右代码,其余的代码交给系统自动生成,可快速完成开发任务
- 支持MySQL、达梦、Oracle、SQL Server、PostgreSQL等主流数据库
- 前端地址https://gitee.com/renrenio/renren-ui
- 演示地址http://demo.open.renren.io/renren-security 账号密码admin/admin
<br>
### 微信交流群
我们提供了微信交流群,扫码下面的二维码,关注【人人开源】公众号,回复【加群】,即可根据提示加入微信群!
<br><br>
![输入图片说明](renren-admin/src/main/resources/public/wechat.jpg)
<br>
### 具有如下特点
- 友好的代码结构及注释,便于阅读及二次开发
- 实现前后端分离通过token进行数据交互前端再也不用关注后端技术
- 灵活的权限控制,可控制到页面或按钮,满足绝大部分的权限需求
- 提供CrudService接口对增删改查进行封装代码更简洁
- 页面交互使用Vue2.x极大的提高了开发效率
- 完善的部门管理及数据权限,通过注解实现数据权限的控制
- 完善的XSS防范及脚本过滤彻底杜绝XSS攻击
- 完善的代码生成机制可在线生成entity、xml、dao、service、vue、sql代码减少70%以上的开发任务
- 引入quartz定时任务可动态完成任务的添加、修改、删除、暂停、恢复及日志查看等功能
- 引入Hibernate Validator校验框架轻松实现后端校验
- 引入云存储服务,已支持:七牛云、阿里云、腾讯云等
- 引入swagger文档支持方便编写API接口文档
<br>
### 数据权限设计思想
- 用户管理、角色管理、部门管理,可操作本部门及子部门数据
- 菜单管理、定时任务、参数管理、字典管理、系统日志,没有数据权限
- 业务功能,按照用户数据权限,查询、操作数据【没有本部门数据权限,也能查询本人数据】
<br>
**项目结构**
```
renren-security
├─renren-common 公共模块
├─renren-admin 管理后台
│ ├─db 数据库SQL脚本
│ │
│ ├─modules 模块
│ │ ├─job 定时任务
│ │ ├─log 日志管理
│ │ ├─oss 文件存储
│ │ ├─security 安全模块
│ │ └─sys 系统管理(核心)
│ │
│ └─resources
│ ├─mapper MyBatis文件
│ ├─public 静态资源
│ └─application.yml 全局配置文件
├─renren-api API服务
├─renren-generator 代码生成器
│ └─resources
│ ├─mapper MyBatis文件
│ ├─template 代码生成器模板(可增加或修改相应模板)
│ ├─application.yml 全局配置文件
│ └─generator.properties 代码生成器,配置文件
```
<br>
**技术选型:**
- 核心框架Spring Boot 2.7
- 安全框架Apache Shiro 1.10
- 持久层框架MyBatis 3.5
- 定时器Quartz 2.3
- 数据库连接池Druid 1.2
- 日志管理Logback
- 页面交互Vue2.x
<br>
**软件需求**
- JDK1.8
- Maven3.0+
- MySQL8.0
- Oracle 11g+
- SQL Server 2012+
- PostgreSQL 9.4+
- 达梦8
<br>
**本地部署**
- 通过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/doc.html
- 再启动前端项目前端地址https://gitee.com/renrenio/renren-ui
- 账号密码admin/admin
<br>
![输入图片说明](renren-admin/src/main/resources/public/1.png)
<br>
![输入图片说明](renren-admin/src/main/resources/public/2.png)
<br>
### 如何交流、反馈、参与贡献?
- 开发文档https://www.renren.io/guide/security
- 官方社区https://www.renren.io/community
- Gitee仓库https://gitee.com/renrenio/renren-security
- [人人开源](https://www.renren.io)https://www.renren.io
- 如需关注项目最新动态请Watch、Star项目同时也是对项目最好的支持
- 技术讨论、二次开发等咨询、问题和建议,请移步到官方社区,我会在第一时间进行解答和回复!
<br>