README.md · Future_微服务/jpower-ui

# JPower：微服务快速开发平台

[![Gitter](https://img.shields.io/badge/Release-V2.1.9-green.svg)](https://gitee.com/gdzWork/JPower)   [![License](https://img.shields.io/badge/Author-mr.g-orange.svg)](https://gitee.com/gdzWork/JPower)
[![Gitter](https://img.shields.io/badge/Copyright%20-@Jpower-%23ff3f59.svg)](https://gitee.com/gdzWork/JPower)

### QQ群 : <img src="docs/image/qrcode.jpg" width="15%" syt height="5%" />
> tip: 加群后凭Star截图可免费获取代码生成器一份
-------

#### JPower只是刚起步，很多功能还在开发中敬请期待......

## JPower 简介
`JPower`是由一款政府商业项目升级优化而来。

采用前后端分离的模式，前端开源项目：[jpower-ui](https://gitee.com/gdzWork/jpower-ui) (基于 AVue、Vue、Element-UI)、[JPowerWeb](https://gitee.com/deep_letters/jpower)(基于 Vue、Element-UI)

Boot版本：[JPowerBoot](https://gitee.com/gdzWork/JPowerBoot)

`JPower` 基于`SpringCloud(2020.0.1)`  + `SpringBoot(2.4.2)` 的微服务快速开发平台.
具备网关统一鉴权、Xss防跨站攻击、分布式事务等多个模块，支持多业务系统并行开发，
支持多服务并行开发，可以作为后端服务的开发脚手架。代码简洁，注释齐全，架构清晰，非常适合学习和作为基础框架使用。
`JPower` 的目标蓝图是能够打造一款集成各种比较好用的工具于一体的开发框架，例如可在页面配置各种报表，集成echarts可实现快速生成页面，各种场景下的数据传输等等各类工具。
目前只是开发了基础的架构，后续会逐渐开发各种各样的工具到框架中。

核心技术采用Spring Cloud Alibaba、SpringBoot、Mybatis、Seata、Sentinel、SkyWalking等主要框架和中间件。
希望能努力打造一套集 `基础框架` —>`分布式微服务架构` —>  `工具集成` —> `系统监测` 的解决方案。`本项目旨在实现基础能力，不涉及具体业务。`

采用JWT做Token认证，可拓展集成Redis等细颗粒度控制方案。

注册中心、配置中心选型Nacos，为工程瘦身的同时加强各模块之间的联动。

集成Sentinel从流量控制、熔断降级等多个维度保护服务的稳定性。

基于MybatisPlus-generator实现了代码生成器。

## 分支介绍
1. master 分支为最新的稳定版本，每次提交都会升级一个版本号
2. dev 分支为作者的开发分支，作者开发的最新代码会实时提交上来，喜欢尝鲜的可以切换为dev。 但可能有报错、漏提等，对项目不是很熟的朋友千万别尝试。
3. tag 每个固定的版本都会打一个tag方便后续切换任意版本。

## 技术文档
* [JPower开发手册](https://www.kancloud.cn/guodingzhi/jpower/)

## 项目演示地址
- 项目演示地址： http://jpower.top:81
- 超级用户登录（租户编码：000000）：
- 超级管理员： root/123456
- 租户用户登录（租户编码：LXD0DP）：
- 普通账号： admin/123456

> ps: 演示环境中没有写入权限

## 业务功能介绍：
1. 租户管理：超级用户角色管理所有的租户创建
3. 组织管理：部门、用户数据维护、重置用户密码等
4. 权限设置：数据权限、角色管理、给角色绑定用户、给角色授权菜单和资源
6. 系统设置：菜单功能、附件管理、字典、行政地区、系统参数、应用管理等
7. 网关管理：限流和阻止访问、注册中心
8. 系统监控：接口文档、服务监控、SkyWalking监控、ELK日志等

## 项目亮点功能介绍:
1. **服务注册&发现与调用：**

基于Nacos来实现的服务注册与发现，使用使用OpenFeign来实现服务互调, 可以做到使用HTTP请求远程调用时能与调用本地方法一样的编码体验，开发者完全感知不到这是远程方法，更感知不到这是个HTTP请求。

3. **服务鉴权:**

通过JWT的方式来加强服务之间调度的权限验证，保证内部服务的安全性。

4. **熔断机制：**

因为采取了服务的分布，为了避免服务之间的调用“雪崩”，采用了Sentinel的作为熔断器，避免了服务之间的“雪崩”。

5. **监控：**

利用Spring Boot Admin 来监控各个独立Service的运行状态；通过SkyWalking来查看各个服务之间的调用链、堆栈等。

6. **链路调用监控：**

同时实现了SkyWalking作为本项目的全链路性能监控， 从整体维度到局部维度展示各项指标，将跨应用的所有调用链性能信息集中展现，可方便度量整体和局部性能，并且方便找到故障产生的源头，生产上可极大缩短故障排除时间。

7. **数据权限**

利用基于Mybatis的拦截器实现了数据权限功能

8. **防跨站脚本攻击(XSS)**

- 通过过滤器对所有请求中的 表单参数 进行过滤

9. **在线API**

由于原生swagger-ui某些功能支持不够友好，故采用了国内开源的`knife4j`，并制作了stater，方便springboot用户使用。

10. **分布式事务**

集成了阿里的分布式事务中间件：seata，以 **高效** 并且对业务 **0侵入** 的方式，解决 微服务 场景下面临的分布式事务问题。

11. **跨表、跨库、跨服务的字典数据自动查询**

用于解决跨表、跨库、跨服务分页数据的属性或单个对象的属性 回显字典数据之痛, 支持对静态数据属性(数据字典)进行自动注入。

12. **灰度发布**

为了解决频繁的服务更新上线，版本回退，快速迭代，公司内部协同开发，本项目采用修改spring load balancing的负载均衡策略来实现来灰度发布。

13. **接口监控**

为了接口能随时保证畅通，专对于此开发了接口的监控，还可实现对其他任何服务的接口监控，可实现自定义的一些参数设置等。

## 工程结构：
~~~
JPower
├── config -- 配置文件目录
├── jpower-core-login -- 授权登录模块
├── jpower-core-server -- 核心业务模块
├    ├── jpower-file -- 文件模块
├    ├── jpower-user -- 用户模块
├    ├── jpower-system -- 系统模块
├── jpower-feign-api -- feign api模块
├    ├── jpower-file-api -- 文件API模块
├    ├── jpower-system-api -- 系统管理API模块
├    ├── jpower-user-api -- 用户API模块
├── jpower-module-common -- 工具包模块
├    ├── common-auth -- 授权工具包 
├    ├── common-dbs -- 数据库工具包 
├    ├── common-deploy -- 基础启动工具包 
├    ├── common-exception -- 异常工具包
├    ├── common-log -- 日志工具包 
├    ├── common-nacos -- nacos工具包 
├    ├── common-redis -- 缓存工具包 
├    ├── common-feign -- feign工具包同时集成sentinel
├    ├── common-swagger -- swagger工具包 
├    ├── common-tool -- 基础配置工具包 
├    ├── common-transaction -- 分布式事务工具包 
├    └── common-utils -- 工具类 
├── jpower-module-gateway -- 网关模块
├── jpower-op-server -- 运维模块
├    ├── jpower-doc -- swagger聚合文档
├    ├── jpower-log -- 日志服务
└──  └── jpower-admin -- SpringBootAdmin 
~~~

## 技术栈：
* 所涉及的相关的技术有
    *  缓存：Redis
    *  数据库： MySQL 5.7
    *  持久层框架： Mybatis-plus
    *  API网关：Gateway
    *  服务注册与发现: Nacos
    *  服务消费：OpenFeign
    *  负载均衡：spring load balancing
    *  配置中心：Nacos
    *  服务熔断：Sentinel
    *  项目构建：Maven 3.3
    *  分布式事务：seata
    *  分布式系统的流量防卫兵：Sentinel
    *  监控：spring-boot-admin
    *  链路调用跟踪&APM监控：skywalking
    *  Nginx
* 部署方面
    *  服务器：CentOS
    *  Docker 18
    *  Nginx

## 项目截图：

| 预览 | 预览 |
|---|---|
| ![预览.png](docs/image/项目截图/1606371365570.png) | ![预览.png](docs/image/项目截图/1606372161878.png) |
| ![预览.png](docs/image/项目截图/1606371469176.png) | ![预览.png](docs/image/项目截图/1606371969088.png) |
| ![预览.png](docs/image/项目截图/1606372018753.png) | ![预览.png](docs/image/项目截图/1606372215188.png) |
| ![预览.png](docs/image/项目截图/1606372253016.png) | ![预览.png](docs/image/项目截图/1606372274084.png) |
| ![预览.png](docs/image/项目截图/1606372312058.png) | ![预览.png](docs/image/项目截图/1606372363368.png) |
| ![预览.png](docs/image/项目截图/20210307214844.png) | ![预览.png](docs/image/项目截图/20210307214944.png)  |
| ![预览.png](docs/image/项目截图/20210307215009.png) | ![预览.png](docs/image/项目截图/20210307215029.png) |

# 如果觉得本项目对您有任何一点帮助，请点右上角 "Star" 支持一下， 并向您的基友、同事们宣传一下吧，谢谢！

# 发现bug请提交 [issues](https://gitee.com/gdzWork/JPower/issues)

# 参与贡献
1. Fork 本仓库
2. 新建 feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

# 感谢 JetBrains 提供的免费开源 License：

[![JetBrains](docs/image/jetbrains.png)](https://www.jetbrains.com/?from=lamp-cloud)

# 友情链接 & 特别鸣谢
* 微服务快速开发平台：[https://gitee.com/gdzWork/JPower](https://gitee.com/gdzWork/JPower)
* JPowerWeb [https://gitee.com/deep_letters/jpower](https://gitee.com/deep_letters/jpower)
* jpower-ui：[https://gitee.com/gdzWork/jpower-ui](https://gitee.com/gdzWork/jpower-ui)
* Avue：[https://gitee.com/smallweigit/avue](https://www.avuejs.com/)
* JWchat：[https://gitee.com/CodeGI/chat](https://gitee.com/CodeGI/chat)
* SpringBlade [https://gitee.com/CodeGI/chat](https://gitee.com/smallc/SpringBlade)

Future_微服务/jpower-ui

简介

发行版

贡献者

近期动态

Future_微服务/jpower-ui .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

Future_微服务/jpower-ui