# 微服务框架

**Repository Path**: zmd1992/springcloud-demo

## Basic Information

- **Project Name**: 微服务框架
- **Description**: Spring Boot	应用框架	3.2.0
Spring Cloud	微服务架构	2023.0.0
Spring Cloud Alibaba	阿里增强	2023.0.1.0
Nacos	注册中心/配置中心	2.2.x
Sentinel	流量控制/熔断	1.8.6
Gateway	API网关	4.1.x
OpenFeign	服务调用	4.0.x
MyBatis-Plus	ORM框架	3.5.5
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-06-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SpringCloud Enterprise Framework

企业级微服务架构，基于SpringCloud 2023.x + Spring Boot 3.2.x

## 技术栈

### 后端技术
| 技术 | 说明 | 版本 |
|------|------|------|
| Spring Boot | 应用框架 | 3.2.0 |
| Spring Cloud | 微服务架构 | 2023.0.0 |
| Spring Cloud Alibaba | 阿里增强 | 2023.0.1.0 |
| Nacos | 注册中心/配置中心 | 2.2.x |
| Sentinel | 流量控制/熔断 | 1.8.6 |
| Gateway | API网关 | 4.1.x |
| OpenFeign | 服务调用 | 4.0.x |
| MyBatis-Plus | ORM框架 | 3.5.5 |
| Redis | 分布式缓存 | 7.x |
| MySQL | 关系型数据库 | 8.0 |
| Kafka | 消息队列 | 3.x |
| MinIO | 对象存储 | 8.x |
| XXL-Job | 定时任务 | 2.3.1 |
| JWT | 认证授权 | 0.12.3 |

### 前端技术
| 技术 | 说明 |
|------|------|
| Vue3 | 渐进式框架 |
| TypeScript | 类型安全 |
| Vite | 构建工具 |
| Pinia | 状态管理 |
| Element Plus | UI组件库 |

## 项目结构

```
springcloud-demo/
├── common/                 # 公共模块
│   └── common-core/       # 核心工具类、异常处理、响应封装
├── modules/                # 业务模块
│   ├── system/           # 系统服务(权限/字典/参数/通知)
│   ├── gateway/          # 网关服务
│   ├── gen/              # 代码生成器
│   ├── job/              # 定时任务服务
│   └── msg/              # 消息队列服务
└── frontend/              # Vue3前端项目
```

## 项目截图

![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20161948.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162027.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162100.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162123.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162136.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162149.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162202.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162215.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162227.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162242.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162254.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162308.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162323.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162333.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162343.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162359.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162417.png)
![输入图片说明](img%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202026-06-02%20162513.png)


## 快速开始

### 环境要求
- JDK 17+
- Maven 3.8+
- Node.js 18+
- MySQL 8.0+
- Redis 7.x
- Nacos 2.2.x

### 后端启动

1. 启动Nacos
```bash
./startup.sh -m standalone  # Linux
cmd startup.cmd -m standalone  # Windows
```

2. 创建数据库
```sql
CREATE DATABASE springcloud_demo;
-- 导入 docs/sql 目录下的SQL文件
```

3. 修改配置
- 修改 bootstrap.yml 中的Nacos地址

4. 启动服务
```bash
cd springcloud-demo
mvn clean install -DskipTests
```

### 前端启动

```bash
cd frontend
npm install
npm run dev
```

## 模块说明

### common-core
- 通用工具类
- 统一异常处理
- 响应封装
- JWT认证
- Redis缓存封装
- Swagger文档

### system
- 用户/角色/菜单管理
- 字典/参数配置
- 通知公告
- 部门/岗位管理
- 操作日志

### gateway
- 路由转发
- JWT校验
- 限流熔断
- 跨域处理

### gen
- 在线代码生成器
- 支持SpringBoot/MyBatis-Plus/Vue3

### job
- 分布式任务调度
- 可视化管理

### msg
- Kafka消息队列
- 消息消费处理

## License

MIT