# lemon-cloud

**Repository Path**: lemon-water/lemon-cloud

## Basic Information

- **Project Name**: lemon-cloud
- **Description**: spring cloud alibaba 微服务学习
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2022-06-17
- **Last Updated**: 2026-02-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: SpringCloud, SpringBoot, OAuth

## README

<p align="center">
 <img src="https://img.shields.io/badge/Lemon-1.0-success.svg" alt="Build Status">
 <img src="https://img.shields.io/badge/Spring%20Cloud-2021-blue.svg" alt="Coverage Status">
 <img src="https://img.shields.io/badge/Spring%20Cloud%20Alibaba-2021-blue.svg" alt="Coverage Status">
 <img src="https://img.shields.io/badge/Spring%20Boot-2.7.13-blue.svg" alt="Downloads">
 <img src="https://img.shields.io/badge/Vue-2.6-blue.svg" alt="Downloads">
</p>

## 感谢
本系统是根据优秀的开源框架 Pig 系统的设计和实践，做的学习和借鉴。

Copyright [huangds/Pig](https://gitee.com/log4j/pig)
## 系统说明

- 基于 Spring Cloud 2021、Spring Cloud Alibaba 2021 、Spring Boot 2.7、 OAuth2 的 RBAC **权限管理系统**
- 基于数据驱动视图的理念封装 Avue，未接触前端的开发工程师都可以轻松上手完成CRUD功能
- 提供对常见容器化支持 Docker支持
- 提供 lambda 、stream api 、webflux 的生产实践

## 快速开始

### 分支说明

- master: java8 + springboot 2.7 + springcloud 2021
- oauth: java8 + springboot 2.7 + springcloud 2021

### 核心依赖

| 依赖                          | 版本         |
|-----------------------------|------------|
| Spring Boot                 | 2.7.17     |
| Spring Cloud                | 2021.0.8   |
| Spring Cloud Alibaba        | 2021.0.5.0 |
| Spring Authorization Server | 0.4.1      |
| Mybatis Plus                | 3.5.3.1    |
| hutool                      | 5.8.22     |

### 模块说明

```lua
lemon-ui  -- https://gitee.com/lemon-water/lemon.git

lemon-cloud
├── lemon-admin -- 用户权限管理模块
     ├── admin-api -- 用户权限管理系统公共api模块
     └── admin-service -- 用户权限管理系统业务处理模块[6008]
└── lemon-gateway -- Spring Cloud Gateway网关[6061]
├── lemon-oauth -- 授权服务提供
     └── oauth-server -- 授权服务提供[6000]
└── lemon-platform -- 系统公共模块
     ├── lemon-cache -- 缓存模块
     ├── lemon-comm -- 全局静态变量和公共类
     ├── lemon-config -- nacos的server-addr配置
     ├── lemon-core -- web核心配置
     ├── lemon-datascope -- 数据权限配置
     ├── lemon-elasticsearch -- elasticsear封装
     ├── lemon-feign -- feign 扩展封装
     ├── lemon-gray -- 灰度封装包
     ├── lemon-idempotent -- 幂等请求封装
     ├── lemon-job -- 定时任务
     ├── lemon-log -- 日志监控封装
     ├── lemon-minio -- minio封装
     ├── lemon-mybatis -- 数据源和动态数据源封装
     ├── lemon-springdoc -- 接口文档
     └── lemon-websocket -- 与前端双向通信封装
├── lemon-plugin -- 开发的服务
     └── code-generator -- 代码生成器[6011]
     └── mp-platform -- 企业微信平台
          ├── mp-api -- 企业微信服务api
          └── mp-service -- 企业微信业务平台[6002]
     └── pay-platform -- 支付平台
          ├── pay-api -- 支付服务api
          └── pay-service -- 支付业务平台[6003]
     └── xxl-job-admin -- 定时任务管理台 [5004] 

```
### 接口文档
本项目使用的是 springdoc-openapi 插件，自动生成接口文档
访问地址为：http://localhost:6061/swagger-ui.html

### 本地开发 运行
pig 提供了详细的[部署文档 wiki.pig4cloud.com](https://www.yuque.com/pig4cloud/pig/vsdox9)，包括开发环境安装、服务端代码运行、前端代码运行等。

请务必**完全按照**文档部署运行章节 进行操作，减少踩坑弯路！！


### Docker 运行

```
# 下载并运行服务端代码
git clone https://gitee.com/lemon-water/lemon-cloud.git

cd pig && mvn clean install && docker-compose up -d

# 下载并运行前端UI
git clone https://gitee.com/lemon-water/lemon.git

cd lemon-ui && npm install -g cnpm --registry=https://registry.npm.taobao.org

cnpm install && cnpm run build:docker && cd docker && docker-compose up -d
```