# zpw-boot-cloud

**Repository Path**: PaperHouse/zpw-boot-cloud

## Basic Information

- **Project Name**: zpw-boot-cloud
- **Description**: 基于 Spring Boot 3 + Vue 3 的企业级后台管理系统，采用微服务架构设计。技术栈：
后端： Spring Boot 3、Spring Security、MyBatis、Druid、Redis
前端： Vue 3、Vite、TypeScript
模块划分： 多模块 Maven 项目，包含系统管理、代码生成器、业务模块等
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2025-05-07
- **Last Updated**: 2026-03-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ZPW-Boot-Cloud

基于 Spring Boot 3 + Spring Cloud Alibaba + Vue3 构建的微服务后台管理系统。

---

## 项目简介

`zpw-boot-cloud` 是一套前后端分离的微服务权限管理平台，后端采用 Spring Boot 3、Spring Cloud Alibaba、Spring Security + JWT 构建，前端采用 Vue3 + Vite + Element Plus 构建，具备完善的用户权限体系、系统监控、代码生成等功能，适用于企业级后台管理系统快速开发。
单体版请参考：https://gitee.com/PaperHouse/zpw-boot
---

## 技术栈

### 后端

| 技术 | 版本 | 说明 |
|---|---|---|
| Java | 17 | 运行环境 |
| Spring Boot | 3.2.12 | 基础框架 |
| Spring Cloud | 2023.0.3 | 微服务框架 |
| Spring Cloud Alibaba | 2022.0.0.0 | 阿里微服务套件 |
| Nacos | - | 服务注册与配置中心 |
| Spring Security | - | 安全框架 |
| JWT (jjwt) | 0.12.3 | Token 认证 |
| MyBatis-Plus | 3.5.7 | ORM 框架 |
| Druid | 1.2.24 | 数据库连接池 & 监控 |
| Dynamic-Datasource | 4.3.1 | 动态多数据源 |
| Redis | - | 缓存 |
| MySQL | 8.0.33 | 关系型数据库 |
| EasyPOI | 4.1.0 | Excel 导入导出 |
| Springdoc OpenAPI | 2.6.0 | API 文档（Swagger UI） |
| FreeMarker / Velocity | - | 代码生成模板引擎 |
| HuTool | 5.8.11 | Java 工具库 |
| Lombok | - | 简化代码 |

### 前端

| 技术 | 版本 | 说明 |
|---|---|---|
| Vue 3 | ^3.4.21 | 前端框架 |
| Vite | ^5.1.6 | 构建工具 |
| TypeScript | ^5.4.2 | 类型支持 |
| Element Plus | ^2.6.1 | UI 组件库 |
| Pinia | ^2.1.7 | 状态管理 |
| Vue Router | ^4.3.0 | 路由管理 |
| Axios | ^1.6.8 | HTTP 请求 |
| ECharts | ^5.5.0 | 数据可视化 |
| vue-i18n | ^9.10.2 | 国际化 |
| WangEditor | ^5.1.23 | 富文本编辑器 |

---

## 项目结构

```
zpw-boot-cloud
├── zpw-gateway              # API 网关（Spring Cloud Gateway）
├── zpw-auth                 # 认证授权服务（登录/注销/Token校验）
├── zpw-base                 # 公共基础模块
│   ├── zpw-base-core        # 核心工具类、通用实体、常量
│   ├── zpw-base-web         # Web 层公共配置
│   ├── zpw-base-security    # Security & JWT 公共配置
│   ├── zpw-base-redis       # Redis 封装
│   ├── zpw-base-datasource  # 动态数据源（Druid）
│   ├── zpw-base-log         # 操作日志切面
│   ├── zpw-base-excel       # Excel 导入导出
│   ├── zpw-base-swagger     # Swagger/OpenAPI 配置
│   ├── zpw-base-feign       # Feign 公共配置
│   ├── zpw-base-dict        # 数据字典公共模块
│   └── zpw-base-servlet     # Servlet 过滤器等
├── zpw-module-system        # 系统管理模块
│   ├── zpw-system-api       # 系统模块对外 API（实体/DTO/VO）
│   └── zpw-system-biz       # 系统模块业务实现
├── zpw-module-business      # 业务模块（可扩展）
│   ├── zpw-business-api
│   └── zpw-business-biz
├── zpw-module-admin         # 管理员模块
│   ├── zpw-admin-api
│   └── zpw-admin-biz
├── zpw-module-generator     # 代码生成器模块
├── ui/pc                    # 前端 Vue3 项目
└── db                       # 数据库初始化 SQL
```

---

## 核心功能

### 系统管理
- **用户管理**：用户的增删改查、角色分配、部门归属、岗位分配
- **角色管理**：角色权限配置、菜单授权、数据权限
- **菜单管理**：动态菜单、路由配置、按钮级权限
- **部门管理**：树形部门组织结构管理
- **岗位管理**：岗位信息维护
- **字典管理**：数据字典类型与字典项维护
- **参数配置**：系统参数动态配置
- **通知公告**：系统公告发布与已读状态管理

### 系统监控
- **在线用户**：查看当前登录用户，支持强制下线
- **操作日志**：记录用户操作行为与请求信息
- **登录日志**：登录成功/失败记录
- **服务器监控**：CPU、内存、磁盘等服务器状态监控
- **缓存监控**：Redis 缓存信息查看与清理
- **Druid 监控**：数据库连接池监控面板

### 代码生成
- 根据数据库表结构一键生成前后端代码
- 支持 FreeMarker / Velocity 模板
- 生成 Controller、Service、Mapper、Entity、前端 Vue 页面等

### 其他特性
- **动态路由**：菜单与路由从数据库动态加载
- **验证码**：图形验证码防暴力破解
- **国际化**：前端支持中/英文切换
- **Excel 导入导出**：基于 EasyPOI 封装
- **数据权限**：基于菜单数据规则的行级数据权限控制
- **多数据源**：支持动态切换数据源
- **前端集成**：https://gitee.com/lyt-top/vue-next-admin

---

## 环境要求

| 环境 | 版本要求 |
|---|---|
| JDK | 17+ |
| Maven | 3.6+ |
| MySQL | 8.0+ |
| Redis | 6.0+ |
| Nacos | 2.x |
| Node.js | 16.0+ |
| pnpm / npm | 7.0+ |

---

## 快速开始

### 1. 准备基础服务

确保以下服务已启动：
- **MySQL**：创建数据库并执行 `db/zpw-boot.sql` 初始化脚本
- **Redis**：默认连接 `localhost:6379`
- **Nacos**：导入 `nacos-config/nacos_config_export_*.zip` 配置文件

### 2. 启动后端服务

**启动顺序建议：**

```
1. zpw-gateway          # API 网关（端口 9000）
2. zpw-auth             # 认证服务
3. zpw-module-system    # 系统模块
4. zpw-module-generator # 代码生成器（可选）
```

各服务的 Nacos 地址、数据库连接等配置已由 Nacos 统一管理，本地可在对应模块的 `bootstrap.yml` 中指定 Nacos 地址。

### 3. 启动前端

```bash
cd ui/pc

# 安装依赖
pnpm install
# 或
npm install

# 本地开发启动
pnpm dev
# 或
npm run dev

# 生产打包
pnpm build
```

前端开发环境默认代理到网关，配置见 `ui/pc/.env.development`。

---

## 模块说明

### zpw-gateway（API 网关）
- 基于 Spring Cloud Gateway
- 统一鉴权：请求到达网关时校验 JWT Token
- 路由转发：将请求路由到各业务微服务
- 白名单配置：登录、验证码等接口免鉴权

### zpw-auth（认证服务）
- 提供登录（`/auth/login`）、注销、获取验证码接口
- 基于 Spring Security + JWT 实现认证
- 支持记住我（长有效期 Token）

### zpw-module-system（系统模块）
- 提供用户、角色、菜单、部门、岗位、字典、配置、日志、通知等完整系统管理接口

### zpw-module-generator（代码生成器）
- 读取数据库表结构，通过模板引擎生成标准 CRUD 代码
- 支持预览和下载生成代码


---

## 默认账号

| 账号 | 密码 | 说明 |
|---|---|---|
| admin | 123456 | 超级管理员 |

> 首次使用请及时修改默认密码。

---

## License

[MIT License](LICENSE)