# Pro-Cloud

**Repository Path**: src-main-java/pro-cloud

## Basic Information

- **Project Name**: Pro-Cloud
- **Description**: pro-cloud是一个SpringCloud alibaba 2.2.0 微服务架构springboot2.2x+mybatisplus基于oauth2.0认证,采用Nacos注册和配置中心，集成流量卫兵Sentinel的分布式架构。解决常见的分布式问题, redis/zookeeper分布式锁,分布式事务,sso单点登录log4j2日志,多租户问题等
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 459
- **Created**: 2020-04-28
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Pro-Cloud
**以下是Pro-Cloud架构简介**
#### 介绍(如果喜欢的话，请给个star)
   Pro-Cloud 是一个Security作为安全框架,采用前后端分离的模式. 基于OAuth2 的RBAC权限管理微服务系统. Pro-Cloud后端采用springcloud alibaba架构,集成Sentinel从流量控制、熔断降级、系统负载等多个维度保护服务的稳定性。
注册中心、配置中心选型Nacos，为工程瘦身的同时加强各模块之间的联动。使用OAuth2，实现了多终端认证系统，可控制子系统的token权限互相隔离。
使用SkyWalking链路最终技术,方便了解应用拓扑和慢服务监测等情况,prometheus+grafana+alertManager作为监控中心,它为actuator端点提供了良好的交互界面，并提供了额外的特性.
mybatisplus的使用,大大的节省了开发的工作量,让代码更易维护 前端基于layui开发,降低学习成本,快速上手,
#### Pro-Cloud架构图
![输入图片说明](https://images.gitee.com/uploads/images/2020/0323/221440_892a46d3_1236464.png "spring cloud 微服务.png")
#### master分支 已完成的更新功能说明
1. 容器切换为, 不在使用tomcat
2. springboot升级为2.2  springcloud alibaba 2.2.0  Hoxton.SR2 等
3. seata 分布式事物使用demo
4. 已经添加回多租户的处理
#### develop 分支 进行中
1. 移除admin监控 换成prometheus+grafana+alertManager
2. 多租户进一步优化
3. oauth 功能优化
#### 特别声明
1. 不再使用原有的生成代码,将重写一份
在此带来的不便敬请谅解
#### 下一步的规划
1. 前端抛弃layui,将使用vue版本
2. 将对原有的结构,代码精简优化
#### 项目地址
[gitee项目地址链接](https://gitee.com/gitsc/pro-cloud)  
[github项目地址链接](https://github.com/pro-cloud/pro-cloud)
#### 相关工程
后台管理前端工程layui（pro-layui）：[码云地址](https://gitee.com/gitsc/pro-layui)  
后台管理前端工程vue-element-admin（pro-ui 待支持）：[码云地址](https://gitee.com/gitsc/pro-ui)  

#### 文档
详细请参考: [pro-cloud技术文档](http://doc.eduvipx.cn)

#### 软件架构
前台采用 vue.js 为核心框架;
后台基于 Spring Cloud alibaba、Spring Security Oauth 2.0 开发企业级认证与授权，提供常见服务监控、链路追踪、日志分析、缓存管理、任务调度等实现，
nacos + Spring Cloud Oauth2 + Spring Cloud gateway +  Feign + mybatisplus等，各种组件注解开发，让代码简洁，通俗易通，以提高效率
```
Pro-Cloud
├── cloud-admin -- 系统基础模块
│   ├── cloud-admin-api   -- admin暴露的feign接口
│   └── cloud-admin-service -- admin模块的实现
├── cloud-auth  -- auth服务端 统一登录中心(支持单点登录和三方登录)
├─cloud-common   -- 系统公共模块
│  ├─cloud-common-cache  -- 缓存工具类+redis 分布式锁
│  ├─cloud-common-data  -- 对数据库操作工具类
│  ├─cloud-common-entity  -- 公共实体工具类
│  ├─cloud-common-job   -- 定时任务工具类
│  ├─cloud-common-mq    -- mq工具类
│  ├─cloud-common-oauth  -- oauth授权工具类
│  ├─cloud-common-oss    -- oss文件上传工具类
│  ├─cloud-common-security  -- 客户端安全工具类
│  ├─cloud-common-swagger -- swagger工具类
│  ├─cloud-common-util   -- 基础工具类
│  ├─cloud-common-websocket  -- websocket工具类
│  └─cloud-common-zk   -- zk分布式锁工具类
├─cloud-gateway   -- springcloud gateway 网关 
├─cloud-generator   -- 代码生成
├─cloud-message      -- 发送邮件短信模块
│  ├─cloud-message-api
│  └─cloud-message-service
├─cloud-monitor  -- 监控模块
├─cloud-oss  -- oss文件上传模块
│  ├─cloud-oss-api
│  └─cloud-oss-service
├─cloud-search  -- es收搜模块
├─cloud-sso-demo   -- 单点登录案例
├─cloud-transaction   -- 分布式事务
├─cloud-websocket   -- websocket案例
├─cloud-xxl-job   -- xxl-job案例
└── docs    -- pro-cloud文档
```
   
| 版本规划| 解决问题|
|----: |:--------:|
| v0.5 | 微服务架构的搭建，基础数据，用户，角色，部门，微服务文件上传支持，在线监控等 |
| v0.6 | 定时任务处理xxl-job，分布式事物的解决，代码在线生成器 |
| v0.8 | vue-element-admin的集成和文档的完善 |
| v1.0 | 三方登录的集成, elk日志收集文档完善 |
#### 安装教程

1. 安装mysql redis idea工具
2. 导入代码
3. 使用skywalking 链路追踪

#### 使用说明

1. /auth/oauth/token 获取token 详细请参考docs目录下的接口调用demo(请用postman导入)
2. 先启动auth 统一登录中心，然后启动admin模块，统一管理后台
3. /code 获取验证码 同 1      
4. 生成代码接口示例：
generator/code?tableName=sys_user&moduleName=admin&comments=用户表     
5. 继承授权中心模块需要实现ProUserDetailsService接口（不实现只会走默认方法），如果定制发邮件需要重构SmsCodeSender接口
6. 继承data模块需要实现SystemService。获取当前用户id（不实现只会走默认方法）


#### 参与贡献

1. [Mybatis-Plus](https://mp.baomidou.com/)
2. [Spring Cloud Oauth2](https://spring.io/projects/spring-security-oauth)
3. [Nacos](https://nacos.io/zh-cn/docs/quick-start.html)
4. [hutool](https://www.hutool.cn/docs/#/)

#### 欢迎加群
[![加入QQ群](https://img.shields.io/badge/238254944-blue.svg)](https://jq.qq.com/?_wv=1027&k=57NNidS)

![输入图片说明](https://images.gitee.com/uploads/images/2020/0312/115300_6bd86d98_1236464.png "Pro-Cloud交流群群聊二维码.png")
#### Pro-Cloud建设

1. 官方地址 [www.eduvipx.cn](http://www.eduvipx.cn) 文档地址http://www.eduvipx.cn:8000/ 官方网站正在建设中…… 可以先查看文档
![输入图片说明](https://images.gitee.com/uploads/images/2020/0312/183349_ef4d3278_1236464.png "2.png")
![输入图片说明](https://images.gitee.com/uploads/images/2019/1206/145155_61d3dd66_1236464.png "屏幕截图.png")
![输入图片说明](https://images.gitee.com/uploads/images/2019/1125/205517_9805bb5a_1236464.png "屏幕截图.png")
![输入图片说明](https://images.gitee.com/uploads/images/2019/1125/205612_4e340fbe_1236464.png "屏幕截图.png")
![输入图片说明](https://images.gitee.com/uploads/images/2019/1125/205658_f7fea0ef_1236464.png "屏幕截图.png")
![输入图片说明](https://images.gitee.com/uploads/images/2019/1125/210037_150c54ce_1236464.png "屏幕截图.png")