2023-08-22 12:46:39 +08:00
|
|
|
|
<p align="center">
|
|
|
|
|
<img src="https://img.shields.io/badge/Pig-3.7-success.svg" alt="Build Status">
|
2023-12-07 13:04:09 +08:00
|
|
|
|
<img src="https://img.shields.io/badge/Spring%20Cloud-2023.0.0-blue.svg" alt="Coverage Status">
|
2023-12-24 20:24:06 +08:00
|
|
|
|
<img src="https://img.shields.io/badge/Spring%20Boot-3.2.1-blue.svg" alt="Downloads">
|
2023-08-22 12:46:39 +08:00
|
|
|
|
<img src="https://img.shields.io/badge/Vue-3.2-blue.svg" alt="Downloads">
|
|
|
|
|
<img src="https://img.shields.io/github/license/pig-mesh/pig"/>
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
## 分支说明
|
|
|
|
|
|
|
|
|
|
- master: java8 + springboot 2.7 + springcloud 2021
|
2023-12-07 13:04:09 +08:00
|
|
|
|
- jdk17: java17 + springboot 3.2 + springcloud 2023
|
2023-08-22 12:46:39 +08:00
|
|
|
|
|
|
|
|
|
## 系统说明
|
|
|
|
|
|
|
|
|
|
- 基于 Spring Cloud 、Spring Boot、 OAuth2 的 RBAC **权限管理系统**
|
|
|
|
|
- 基于数据驱动视图的理念封装 element-plus,即使没有 vue 的使用经验也能快速上手
|
|
|
|
|
- 提供对常见容器化支持 Docker、Kubernetes、Rancher2 支持
|
|
|
|
|
- 提供 lambda 、stream api 、webflux 的生产实践
|
|
|
|
|
|
|
|
|
|
## 文档视频
|
|
|
|
|
|
|
|
|
|
[ 🚀🚀🚀 低代码数据可视化](http://datav.pig4cloud.com)
|
|
|
|
|
|
|
|
|
|
[ 配套文档 wiki.pig4cloud.com](https://wiki.pig4cloud.com)
|
|
|
|
|
|
|
|
|
|
[ 配套视频 tv.pig4cloud.com](https://www.bilibili.com/video/BV12t411B7e9)
|
|
|
|
|
|
|
|
|
|
[PIGX 在线体验 pigx.pigx.top](http://pigx.pigx.top)
|
|
|
|
|
|
|
|
|
|
[产品白皮书 paper.pig4cloud.com](https://paper.pig4cloud.com)
|
|
|
|
|
|
|
|
|
|
## 微信群 [禁广告]
|
|
|
|
|
|
|
|
|
|
![](https://minio.pigx.top/oss/1648184189.png)
|
|
|
|
|
|
|
|
|
|
## 快速开始
|
|
|
|
|
|
|
|
|
|
|
2020-10-09 15:59:34 +08:00
|
|
|
|
### 核心依赖
|
2019-10-26 16:23:16 +08:00
|
|
|
|
|
2023-08-24 13:30:36 +08:00
|
|
|
|
| 依赖 | 版本 |
|
|
|
|
|
|-----------------------------|------------|
|
2023-12-24 20:24:06 +08:00
|
|
|
|
| Spring Boot | 3.2.1 |
|
2023-12-07 13:01:55 +08:00
|
|
|
|
| Spring Cloud | 2023.0.0 |
|
2023-08-24 13:30:36 +08:00
|
|
|
|
| Spring Cloud Alibaba | 2022.0.0.0 |
|
2023-12-07 13:01:55 +08:00
|
|
|
|
| Spring Authorization Server | 1.2.0 |
|
2023-12-25 19:22:21 +08:00
|
|
|
|
| Mybatis Plus | 3.5.5 |
|
2023-10-08 19:42:49 +08:00
|
|
|
|
| hutool | 5.8.22 |
|
2019-02-01 21:06:59 +08:00
|
|
|
|
|
2020-10-09 15:59:34 +08:00
|
|
|
|
### 模块说明
|
|
|
|
|
|
|
|
|
|
```lua
|
|
|
|
|
pig-ui -- https://gitee.com/log4j/pig-ui
|
|
|
|
|
|
|
|
|
|
pig
|
|
|
|
|
├── pig-auth -- 授权服务提供[3000]
|
|
|
|
|
└── pig-common -- 系统公共模块
|
2021-08-26 14:14:22 +08:00
|
|
|
|
├── pig-common-bom -- 全局依赖管理控制
|
2020-10-09 15:59:34 +08:00
|
|
|
|
├── pig-common-core -- 公共工具类核心包
|
|
|
|
|
├── pig-common-datasource -- 动态数据源包
|
|
|
|
|
├── pig-common-log -- 日志服务
|
2023-08-22 12:46:39 +08:00
|
|
|
|
├── pig-common-oss -- 文件上传工具类
|
2020-10-09 15:59:34 +08:00
|
|
|
|
├── pig-common-mybatis -- mybatis 扩展封装
|
2022-03-30 08:46:33 +08:00
|
|
|
|
├── pig-common-seata -- 分布式事务
|
2020-10-09 15:59:34 +08:00
|
|
|
|
├── pig-common-security -- 安全工具类
|
|
|
|
|
├── pig-common-swagger -- 接口文档
|
2022-10-10 15:34:59 +08:00
|
|
|
|
├── pig-common-feign -- feign 扩展封装
|
|
|
|
|
└── pig-common-xss -- xss 安全封装
|
2020-10-09 15:59:34 +08:00
|
|
|
|
├── pig-register -- Nacos Server[8848]
|
|
|
|
|
├── pig-gateway -- Spring Cloud Gateway网关[9999]
|
|
|
|
|
└── pig-upms -- 通用用户权限管理模块
|
|
|
|
|
└── pig-upms-api -- 通用用户权限管理系统公共api模块
|
|
|
|
|
└── pig-upms-biz -- 通用用户权限管理系统业务处理模块[4000]
|
|
|
|
|
└── pig-visual
|
|
|
|
|
└── pig-monitor -- 服务监控 [5001]
|
2023-08-22 12:46:39 +08:00
|
|
|
|
├── pig-codegen -- 图形化代码生成 [5002]
|
|
|
|
|
└── pig-quartz -- 定时任务管理台 [5007]
|
2019-11-05 01:07:27 +08:00
|
|
|
|
```
|
|
|
|
|
|
2020-10-09 16:06:35 +08:00
|
|
|
|
### 本地开发 运行
|
|
|
|
|
|
2023-08-22 12:46:39 +08:00
|
|
|
|
pig 提供了详细的[部署文档 wiki.pig4cloud.com](https://www.yuque.com/pig4cloud/pig/vsdox9),包括开发环境安装、服务端代码运行、前端代码运行等。
|
2020-10-09 16:06:35 +08:00
|
|
|
|
|
|
|
|
|
请务必**完全按照**文档部署运行章节 进行操作,减少踩坑弯路!!
|
|
|
|
|
|
2021-09-11 14:30:16 +08:00
|
|
|
|
|
2020-10-09 15:59:34 +08:00
|
|
|
|
### Docker 运行
|
2019-08-23 19:45:25 +08:00
|
|
|
|
|
2019-02-01 21:06:59 +08:00
|
|
|
|
```
|
2020-10-09 15:59:34 +08:00
|
|
|
|
# 下载并运行服务端代码
|
2023-08-22 12:46:39 +08:00
|
|
|
|
git clone https://gitee.com/log4j/pig.git -b jdk17
|
2019-02-01 21:06:59 +08:00
|
|
|
|
|
2020-10-09 15:59:34 +08:00
|
|
|
|
cd pig && mvn clean install && docker-compose up -d
|
2019-02-01 21:06:59 +08:00
|
|
|
|
|
2020-10-09 15:59:34 +08:00
|
|
|
|
# 下载并运行前端UI
|
|
|
|
|
git clone https://gitee.com/log4j/pig-ui.git
|
2019-02-01 21:06:59 +08:00
|
|
|
|
|
2020-10-09 15:59:34 +08:00
|
|
|
|
cd pig-ui && npm install -g cnpm --registry=https://registry.npm.taobao.org
|
2020-03-14 14:27:18 +08:00
|
|
|
|
|
2021-10-20 22:07:54 +08:00
|
|
|
|
|
|
|
|
|
cnpm install && cnpm run build:docker && cd docker && docker-compose up -d
|
2020-10-09 15:59:34 +08:00
|
|
|
|
```
|
2020-09-14 21:39:42 +08:00
|
|
|
|
|
2020-10-09 15:59:34 +08:00
|
|
|
|
## 免费公开课
|
2019-02-01 21:06:59 +08:00
|
|
|
|
|
2019-12-08 20:11:37 +08:00
|
|
|
|
<table>
|
|
|
|
|
<tr>
|
2023-08-18 15:37:37 +08:00
|
|
|
|
<td><a href="https://www.bilibili.com/video/av45084065" target="_blank"><img src="https://minio.pigx.top/oss/1655474345.jpg"></a></td>
|
|
|
|
|
<td><a href="https://www.bilibili.com/video/av77344954" target="_blank"><img src="https://minio.pigx.top/oss/1656837143.jpg"></a></td>
|
2019-12-08 20:11:37 +08:00
|
|
|
|
</tr>
|
2020-05-04 21:04:02 +08:00
|
|
|
|
<tr>
|
2023-08-18 15:37:37 +08:00
|
|
|
|
<td><a href="https://www.bilibili.com/video/BV1J5411476V" target="_blank"><img src="https://minio.pigx.top/oss/1655474369.jpg"></a></td>
|
|
|
|
|
<td><a href="https://www.bilibili.com/video/BV14p4y197K5" target="_blank"><img src="https://minio.pigx.top/oss/1655474381.jpg"></a></td>
|
2020-05-04 21:04:02 +08:00
|
|
|
|
</tr>
|
2019-12-08 20:11:37 +08:00
|
|
|
|
</table>
|
2019-02-01 21:06:59 +08:00
|
|
|
|
|
2020-10-09 15:59:34 +08:00
|
|
|
|
## 开源共建
|
|
|
|
|
|
|
|
|
|
### 开源协议
|
|
|
|
|
|
|
|
|
|
pig 开源软件遵循 [Apache 2.0 协议](https://www.apache.org/licenses/LICENSE-2.0.html)。
|
|
|
|
|
允许商业使用,但务必保留类作者、Copyright 信息。
|
|
|
|
|
|
2023-08-18 15:37:37 +08:00
|
|
|
|
![](https://minio.pigx.top/oss/1655474288.jpg)
|
2022-06-17 22:02:31 +08:00
|
|
|
|
|
2020-10-09 15:59:34 +08:00
|
|
|
|
### 其他说明
|
|
|
|
|
|
2022-03-25 15:36:05 +08:00
|
|
|
|
1. 欢迎提交 [PR](https://dwz.cn/2KURd5Vf),注意对应提交对应 `dev` 分支
|
|
|
|
|
代码规范 [spring-javaformat](https://github.com/spring-io/spring-javaformat)
|
2020-10-09 15:59:34 +08:00
|
|
|
|
|
2022-06-28 14:08:19 +08:00
|
|
|
|
<details>
|
|
|
|
|
<summary>代码规范说明</summary>
|
|
|
|
|
|
|
|
|
|
1. 由于 <a href="https://github.com/spring-io/spring-javaformat" target="_blank">spring-javaformat</a>
|
|
|
|
|
强制所有代码按照指定格式排版,未按此要求提交的代码将不能通过合并(打包)
|
|
|
|
|
2. 如果使用 IntelliJ IDEA
|
|
|
|
|
开发,请安装自动格式化软件 <a href="https://repo1.maven.org/maven2/io/spring/javaformat/spring-javaformat-intellij-idea-plugin/" target="_blank">
|
|
|
|
|
spring-javaformat-intellij-idea-plugin</a>
|
2023-08-22 12:46:39 +08:00
|
|
|
|
3. 其他开发工具,请参考 <a href="https://github.com/spring-io/spring-javaformat" target="_blank">
|
|
|
|
|
spring-javaformat</a>
|
2022-06-28 14:08:19 +08:00
|
|
|
|
说明,或`提交代码前`在项目根目录运行下列命令(需要开发者电脑支持`mvn`命令)进行代码格式化
|
|
|
|
|
```
|
|
|
|
|
mvn spring-javaformat:apply
|
|
|
|
|
```
|
|
|
|
|
</details>
|
|
|
|
|
|
2020-10-09 15:59:34 +08:00
|
|
|
|
2. 欢迎提交 [issue](https://gitee.com/log4j/pig/issues),请写清楚遇到问题的原因、开发环境、复显步骤。
|