# wallpaper-swarm

**Repository Path**: theOS/wallpaper-swarm

## Basic Information

- **Project Name**: wallpaper-swarm
- **Description**: 前后端分离的壁纸摄影图库项目-后端API
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 12
- **Forks**: 5
- **Created**: 2021-03-04
- **Last Updated**: 2024-01-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wallpaper-swarm

<p>
  <a href="https://gitee.com/theOS/wallpaper-swarm"><img src="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/4fb8d7b5-6d3b-4df9-ac39-07bd467a3412.svg" alt="后台项目"></a>
  <a href="https://gitee.com/theOS/wallpaper-admin-web"><img src="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/0778dac7-70a2-4437-aaef-f88540a33cc3.svg" alt="管理端前台"></a>
  <a href="https://gitee.com/theOS/wallpaper-uniapp-wx"><img src="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/11d2af06-ce1f-4ce3-b694-b00234f55094.svg" alt="uni-app用户端"></a>
  <a href="https://theos.gitee.io/"><img src="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/0f2f32ac-c0c6-4075-97f1-ff1ab60b02b7.svg" alt="文档地址"></a>
</p>


## 项目介绍

`wallpaper-swarm`是一套微服务系统，采用了 Spring Cloud Hoxton & Alibaba、Spring Boot 2.3、Oauth2、MyBatis、Docker、Elasticsearch等核心技术，同时提供了基于Vue的管理后台方便快速搭建系统。`wallpaper-swarm`集成了注册中心、配置中心、监控中心、网关等系统功能。

## 项目地址

- 管理端前台：[https://gitee.com/theOS/wallpaper-admin-web](https://gitee.com/theOS/wallpaper-admin-web)
- 客户端：[https://gitee.com/theOS/wallpaper-uniapp-wx](https://gitee.com/theOS/wallpaper-uniapp-wx)

## 系统架构图

![系统架构图](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/85556889-c873-446a-8160-a8e6251f682b.jpg)

## 组织结构

``` lua
wallpaper-swarm
├── mall-common -- 工具类及通用代码模块
├── mall-mbg -- MyBatisGenerator生成的数据库操作代码模块
├── mall-auth -- 基于Spring Security Oauth2的统一的认证中心
├── mall-gateway -- 基于Spring Cloud Gateway的微服务API网关服务
├── mall-monitor -- 基于Spring Boot Admin的微服务监控中心
├── wallpaper-service -- 后台管理系统服务
├── wallpaper-portal -- 移动端商城系统服务
└── config -- 配置中心存储的配置
```

## 项目文档

- 项目文档`wallpaper`：[https://theos.gitee.io/](https://theos.gitee.io/)

## 技术选型

### 后端技术

| 技术                   | 说明                 | 官网                                                 |
| ---------------------- | -------------------- | ---------------------------------------------------- |
| Spring Cloud           | 微服务框架           | https://spring.io/projects/spring-cloud              |
| Spring Cloud Alibaba   | 微服务框架           | https://github.com/alibaba/spring-cloud-alibaba      |
| Spring Boot            | 容器+MVC框架         | https://spring.io/projects/spring-boot               |
| Spring Security Oauth2 | 认证和授权框架       | https://spring.io/projects/spring-security-oauth     |
| MyBatis                | ORM框架              | http://www.mybatis.org/mybatis-3/zh/index.html       |
| MyBatisGenerator       | 数据层代码生成       | http://www.mybatis.org/generator/index.html          |
| Mybatis-Plus           | MyBatis增强工具      | https://mp.baomidou.com/guide/                       |
| PageHelper             | MyBatis物理分页插件  | http://git.oschina.net/free/Mybatis_PageHelper       |
| Knife4j                | 文档生产工具         | https://github.com/xiaoymin/swagger-bootstrap-ui     |
| Elasticsearch          | 搜索引擎             | https://github.com/elastic/elasticsearch             |
| RabbitMq               | 消息队列             | https://www.rabbitmq.com/                            |
| Redis                  | 分布式缓存           | https://redis.io/                                    |
| Docker                 | 应用容器引擎         | https://www.docker.com/                              |
| Druid                  | 数据库连接池         | https://github.com/alibaba/druid                     |
| OSS                    | 对象存储             | https://github.com/aliyun/aliyun-oss-java-sdk        |
| MinIO                  | 对象存储             | https://github.com/minio/minio                       |
| JWT                    | JWT登录支持          | https://github.com/jwtk/jjwt                         |
| LogStash               | 日志收集             | https://github.com/logstash/logstash-logback-encoder |
| Lombok                 | 简化对象封装工具     | https://github.com/rzwitserloot/lombok               |
| Seata                  | 全局事务管理框架     | https://github.com/seata/seata                       |
| Portainer              | 可视化Docker容器管理 | https://github.com/portainer/portainer               |

### 前端技术

| 技术       | 说明                  | 官网                           |
| ---------- | --------------------- | ------------------------------ |
| Vue        | 前端框架              | https://vuejs.org/             |
| Vue-router | 路由框架              | https://router.vuejs.org/      |
| Vuex       | 全局状态管理框架      | https://vuex.vuejs.org/        |
| Element    | 前端UI框架            | https://element.eleme.io/      |
| Axios      | 前端HTTP框架          | https://github.com/axios/axios |
| v-charts   | 基于Echarts的图表框架 | https://v-charts.js.org/       |


## 环境搭建

### 开发环境

| 工具          | 版本号 | 下载                                                         |
| ------------- | ------ | ------------------------------------------------------------ |
| JDK           | 1.8    | https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html |
| Mysql         | 5.7    | https://www.mysql.com/                                       |
| Redis         | 5.0    | https://redis.io/download                                    |
| Elasticsearch | 7.6.2  | https://www.elastic.co/cn/downloads/elasticsearch            |
| Kibana        | 7.6.2  | https://www.elastic.co/cn/downloads/kibana                   |
| Logstash      | 7.6.2  | https://www.elastic.co/cn/downloads/logstash                 |
| RabbitMq      | 3.7.14 | http://www.rabbitmq.com/download.html                        |
| nginx         | 1.10   | http://nginx.org/en/download.html                            |

### 搭建步骤

> Windows环境部署

- Windows环境搭建请参考：[wallpaper-swarm在Windows环境下的部署](https://theos.gitee.io/#/deploy/wallpaper_swarm_deploy_windows);
- `wallpaper-admin-web`项目的安装及部署请参考：[wallpaper前端项目的安装与部署](https://theos.gitee.io/#/deploy/wallpaper_deploy_web);

> Docker环境部署

- 本项目在Docker容器下的部署请参考：[wallpaper-swarm在Linux环境下的部署（基于Docker容器）](https://theos.gitee.io/#/deploy/wallpaper_swarm_deploy_docker);

## 运行效果展示

- 查看注册中心注册服务信息，访问地址：http://localhost:8848/nacos/

![](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/00e4bce3-72e8-4973-bb7b-daaf0e39764c.png)

- 监控中心应用信息，访问地址：http://localhost:8101/

![](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/7bb638fe-8999-496f-8d5c-97cc5b1efc82.png)

![](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/17c02d78-1ace-4b41-a397-89cd47750e04.png)

![](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/f6494dc0-1bf5-4bbd-8a1d-b497f603f7e8.png)

![https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/fd08382a-eb60-4bf3-8d2d-93f8177560cc.png](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/fd08382a-eb60-4bf3-8d2d-93f8177560cc.png)



- API文档信息，访问地址：http://localhost:8201/doc.html#/home

![](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/a0da9b3d-cefd-4cb8-89a5-031b924bdd81.png)

- 日志收集系统信息，访问地址：http://localhost:5601

![](http://img.macrozheng.com/mall/project/mall_swarm_run_06.png)

- 可视化容器管理，访问地址：http://localhost:9000

![](http://img.macrozheng.com/mall/project/mall_swarm_run_07.png)

![](http://img.macrozheng.com/mall/project/mall_swarm_run_08.png)

## 许可证

[Apache License 2.0](https://gitee.com/theOS/wallpaper-swarm/blob/master/LICENSE)

Copyright (c) 2018-2021 theOS