# yqm-shop
**Repository Path**: ChatGPTCEO/yqm-shop
## Basic Information
- **Project Name**: yqm-shop
- **Description**: yqm-shop基于当前流行技术组合的前后端分离商城系统: SpringBoot2+MybatisPlus+SpringSecurity+jwt+redis+Vue的前后端分离的商城系统, 包含商城、sku、运费模板、素材库、小程序直播、拼团、砍价、商户管理、 秒杀、优惠券、积分、分销、会员、充值、多门店等功能
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.yqmshop.cn
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 1
- **Created**: 2023-10-19
- **Last Updated**: 2024-06-02
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
yqm-shop 商城系统
#### 项目简介
yqm-shop 基于当前流行技术组合的前后端分离商城系统: SpringBoot2+MybatisPlus+SpringSecurity+jwt+redis+Vue的前后端分离的商城系统, 包含分类、sku、运费模板、素材库、小程序直播、拼团、砍价、商户管理、 秒杀、优惠券、积分、分销、会员、充值、多门店等功能,更适合企业或个人二次开发;
# 官网体验地址(里面有演示地址与文档)
| 官网文档地址 | https://www.yqmshop.cn |
|---|---|
| 管理后台演示地址: | http://shop.yqmshop.cn/single |
| 关注公众号点击单商户体验小程序与H5 |  |
#### 重要通知
关于log4j2漏洞说明
- 方式一:拉最新的代码,重新打包运行应用
- 方式二:不更新代码,直接加启动参数,如下:
- java -Dlog4j2.formatMsgNoLookups=true -jar yqm-shop-admin-2.3.jar
#### 核心依赖
| 依赖 | 版本 |
|-----------------|--------|
| Spring Boot | 2.7.10 |
| weixin-java | 4.4.0 |
| Spring Security | 2.7.10 |
| Mybatis Plus | 3.5.2 |
| hutool | 5.8.16 |
| swagger | 3.0.0 |
# 本地安装
### 基本环境(必备)
- 1、JDK:8+
- 2、Redis 3.0+
- 3、Maven 3.0+
- 4、MYSQL 5.7+
- 5、Node v8+
### 开发工具
Idea、webstorm、vscode
### 后台系统工程(JAVA端)
1、请确保redis已经安装启动
2、下载代码
```
git clone https://gitee.com/w907/yqm-shop.git
```
# 本地安装
> yqm-shop-admin 是后台管理端
yqm-shop-app 是C端的后台
### 推荐配置版本:
> 理论上可以版本可以高点
`node 14.17.3`
`jdk 1.8`
`redis 3.0 以上` (推荐 `docker` 安装很舒服...)
## 后端
1. redis 已经启动
> 因为有一些服务依赖它
2. 下载代码
```
git clone https://gitee.com/w907/yqm-shop.git
```
3. 导入项目打开它

4. 找到 `application-dev.yml` 文件,修改里面的 `数据库`、`redis` 信息
5. 然后使用 `mvn clean install` ,或者使用开发工具的快捷操作方式
6. 然后找到项目的启动类 `com.yqm.AppRun` 和 `com.yqm.ApiRun`,启动
> yqm-shop-admin 是 AppRun
yqm-shop-app 是 ApiRun
7. 打包

## 后台前端工程(VUE端)
> 请自行安装好 `nodejs`
1. 下载代码
2. 推荐使用 `pnpm` 或者 `yarn`
项目根目录下 执行 `pnpm install` 或者 `yarn install`

3. 访问 `http://localhost:8013`
5、在控制台输入命令:npm run dev,控制台打印出如下画面,恭喜表示本项目启动成功拉。

5、打开浏览器输入地址如图:
默认超管账户密码:admin/123456
# nginx线上部署
### 后台系统(Java端)
1、mvn install 或者直接idea打成jar包
2、配置nginx 反向代理如下:
```
server{
listen 443 ssl;
server_name yqm-shop api.yqmshop.cn;
#listen [::]:81 default_server ipv6only=on;
#ssl on;
ssl_certificate httpssl/3034302_yqm-shop api.yqmshop.cn.pem;
ssl_certificate_key httpssl/3034302_yqm-shop api.yqmshop.cn.key;
ssl_session_timeout 5m;
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_prefer_server_ciphers on;
#error_page 404 /404.html;
#include enable-php.conf;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Port $server_port;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
access_log /home/wwwlogs/yqm-shop api.log;
}
```
我配置的了ssl证书,如果不需要证书配置如下即可:
```
server{
listen 80;
server_name yqm-shop api.yqmshop.cn;
#listen [::]:81 default_server ipv6only=on;
#error_page 404 /404.html;
#include enable-php.conf;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Port $server_port;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
access_log /home/wwwlogs/yqm-shop api.log;
}
```
### 后台前端工程(VUE端)
1、输入命令:npm run build:prod 编译打包
2、把打包后的dist目录代码上传到服务器
3、配置nginx如下:
```
server
{
listen 443 ssl;
#listen [::]:81 default_server ipv6only=on;
server_name www.yqmshop.cn;
#ssl on;
ssl_certificate httpssl/3414321_www.yqmshop.cn.pem;
ssl_certificate_key httpssl/3414321_www.yqmshop.cn.key;
ssl_session_timeout 5m;
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_prefer_server_ciphers on;
index index.html;
root /home/wwwroot/system/yqm-shop ;
location / {
try_files $uri $uri/ @router;
index index.html;
· }
location @router {
rewrite ^.*$ /index.html last;
}
location ~* \.(eot|ttf|woff)$ {
# add_header Access-Control-Allow-Origin *;
}
location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
{
expires 30d;
}
location ~ .*\.(js|css)?$
{
expires 12h;
}
access_log /home/wwwlogs/yqm-shop .log;
}
```
不需要证书如上面Java端配置一样去掉相关证书配置 改监听端口80即可
# docker部署
- 1、创建一个存储第三方软件服务Docker Compose文件目录:
```
mkdir -p /yqm-shop /soft
```
- 2、然后在该目录下新建一个docker-compose.yml文件:
```
vim /yqm-shop /soft/docker-compose.yml
```
- 3、接着创建上面docker-compose.yml里定义的挂载目录:
```
mkdir -p /yqm-shop /mysql/data /yqm-shop /redis/data /yqm-shop /redis/conf
```
- 4、创建Redis配置文件redis.conf:
```
touch /yqm-shop /redis/conf/redis.conf
```
- 5、docker 部署参考根目录docker文件夹
- 6、以上创建好之后参考docker下文件,先执行软件安装:
```
cd /yqm-shop /soft
docker-compose up -d 启动
docker ps -a 查看镜像
```
- 7、运行docker/applicatiion目录下 docker-compose,当然之前一定要打包jar包,构建镜像
切换到Dockerfile 文件下:
```
docker build -t yqm-shop -admin .
```
# 项目说明
#### 项目源码
| | 后台系统源码 | 后台系统前端源码 |
|--- |--- | --- |
| 码云 | https://gitee.com/w907/yqm-shop.git | https://gitee.com/w907/yqm-shop.git |
| github | https://github.com/weiximei/yqm-shop.git |https://github.com/weiximei/yqm-shop.git |
| 码云 | https://gitee.com/w907/yqm-shop-admin.git | https://gitee.com/w907/yqm-shop-admin.git |
| github | https://github.com/weiximei/yqm-shop-admin.git |https://github.com/weiximei/yqm-shop-admin.git |
### 商城功能
* 一:商品模块:商品添加、规格设置,商品上下架等
* 二:订单模块:下单、购物车、支付,发货、收货、评价、退款等
* 三:营销模块:积分、优惠券、分销、砍价、拼团、秒杀、多门店等
* 四:微信模块:自定义菜单、自动回复、微信授权、图文管理、模板消息推送
* 五:配置模块:各种配置
* 六:用户模块:登陆、注册、会员卡、充值等
* 七:其他等
#### 项目结构
项目采用分模块开发方式
- yqm-shop-weixin 微信相关模块
- yqm-shop-common 公共模块
- yqm-shop-admin 后台模块
- yqm-shop-logging 日志模块
- yqm-shop-tools 第三方工具模块
- yqm-shop-generator 代码生成模块
- yqm-shop-shop 商城模块
- yqm-shop-mproot mybatisPlus
#### 系统预览



### 技术选型
* 1 后端使用技术
* 1.1 SpringBoot2
* 1.2 mybatis、MyBatis-Plus
* 1.3 SpringSecurity
* 1.5 Druid
* 1.6 Slf4j
* 1.7 Fastjson
* 1.8 JWT
* 1.9 Redis
* 1.10 Quartz
* 1.11 Mysql
* 1.12 swagger
* 1.13 WxJava
* 1.14 Lombok
* 1.15 Hutool
* 前端使用技术
* 2.1 Vue 全家桶
* 2.2 Element
* 2.3 uniapp
#### 反馈交流
- 喜欢这个商城后台的小伙伴留下你的小星星啦,star,star哦!
#### 特别鸣谢
- eladmin:https://github.com/elunez/eladmin
- mybaitsplus:https://github.com/baomidou/mybatis-plus
- hutool:https://github.com/looly/hutool
- wxjava:https://github.com/Wechat-Group/WxJava
- vue:https://github.com/vuejs/vue
- element:https://github.com/ElemeFE/element