项目介绍
youlai-mall
是基于Spring Boot 2.5.0、Spring Cloud 2020 &
Alibaba 2021、Vue、Element-UI、uni-app快速构建的一套全栈开源商城项目,包括微服务应用、管理平台、微信小程序及APP应用
项目特色
-
项目使用都是最新主流的开源框架,无过度自定义封装的逻辑,易理解上手和方便扩展
-
基于Spring Boot 2.5.0、Spring Cloud 2020 & Alibaba 2021一站式微服务解决方案快速开发分布式服务
-
实现Spring Cloud OAuth2、Spring Cloud Gateway、JWT分布式统一认证鉴权和
RBAC
权限系统设计 -
使用vue-element-admin的后台前端解决方案,基于Vue和Element-UI快速搭建前后端分离的商城管理平台
-
通过
uni-app
使用Vue开发实现跨所有前端的应用,包含微信小程序、APP应用 -
使用Docker快速构建项目环境和一键打包部署微服务项目
项目愿景
项目从0
到1
的构建过程已无保留的在项目文章中说明,真正的开源不图利益。
项目慢慢成型的路上离不开支持还有默默点star的那些小伙伴,在这里抱拳谢过各位道友了。
项目地址
1. 体验
商城管理平台访问地址: http://www.youlai.tech
【有来小店】微信小程序体验码,扫描后申请体验看到直接通过
交流群二维码过期,加我微信我直接拉你进群
2. 源码
项目名称 | Github | 码云 |
---|---|---|
微服务后台 | youlai-mall | youlai-mall |
管理前端 | youlai-mall-admin | youlai-mall-admin |
微信小程序 | youlai-mall-weapp | youlai-mall-weapp |
APP应用 | youlai-mall-app | youlai-mall-app |
项目预览
1. 商城管理平台
1.1 系统管理
1.2 商品管理
2. 微信小程序
项目结构
youlai-mall
├── docs
├── nacos -- Nacos配置文件
├── sql -- mysql数据库脚本
├── mall-oms
├── oms-api -- 订单中心对外Feign接口
├── oms-boot -- 订单中心
├── mall-pms
├── pms-api -- 商品中心对外Feign接口
├── pms-boot -- 商品中心
├── mall-sms
├── sms-api -- 营销中心对外Feign接口
├── sms-boot -- 营销中心
├── mall-ums
├── ums-api -- 会员中心对外Feign接口
├── ums-boot -- 会员中心
├── middleware -- 中间件(Nacos、Sentinel)
├── youlai-admin
├── admin-api -- 系统管理对外Feign接口
├── admin-boot -- 系统管理
├── youlai-auth -- 认证中心【Oauth2认证服务器】
├── youlai-common -- 公共模块
└── youlai-gateway -- Gateway网关【Oauth2资源服务器】
核心技术栈
后端技术 | 版本号 |
---|---|
SpringBoot | 2.5.0 |
Spring Cloud | 2020.0.3 |
Spring Cloud Alibaba | 2021.1 |
Nacos | 2.0.1 |
Seata | 1.4.1 |
Sentinel | 1.8.1 |
MyBatis-Plus | 3.4.3 |
Lombok | 1.18.18 |
Hutool | 5.5.8 |
Knife4j | 2.0.8 |
MinIO | 7.1.0 |
后台前端 | 版本号 | 微信小程序 | 版本号 | APP | 版本号 |
---|---|---|---|---|---|
element-ui | 2.13.2 | uni-app | 2.8.11 | vant | 2.5.4 |
项目启动
1. 后台微服务启动
云环境项目启动
项目依赖环境(MySQL8、Redis、MinIO、Nacos)默认均使用有来技术
云环境,项目启动极其方便,步骤如下:
-
启动
Nacos
服务IDEA下方工具栏点击Terminal终端命令行,执行
cd middleware/nacos/bin
命令切换到Nacos的启动脚本文件夹下,然后执行startup -m standalone
命令启动Nacos服务; -
启动平台基础服务
分别启动
youlai-gateway
、youlai-auth
、youlai-admin
模块, 启动类分别对应的是GatewayApplication、AuthApplication以及youlai-admin
的子模块admin-boot
的AdminApplication类,至此完成整个项目的启动; -
至此后台服务启动完毕,如需商城服务,启动对应模块的子模块biz的启动类即可。
注: 云环境是无条件的提供给大家,但千万不要改动云环境的数据和配置,因为改动会导致整个项目无法运行,考虑下开发人员和其他小伙伴,手下留情。
本地环境项目启动
云环境不能改动数据和配置,如需修改,建议本地环境搭建启动,步骤如下:
-
安装环境
安装
MySQL8
、Redis
-
创建数据库
-
新建平台数据库,执行项目
document/sql
下的SQL脚本完成数据库创建,基础sql脚本为youlai.sql
,商城脚本为mall-*
,商城数据库按需创建 -
创建
Nacos
数据库,执行脚本middleware/nacos/conf/nacos-mysql.sql
完成Nacos
数据库的初始化
-
-
Nacos配置
-
修改
Nacos
数据源,进入配置middleware/nacos/conf/application.properties
将数据源修改为自己的环境连接 -
导入
Nacos
配置,在启动Nacos
服务进入控制台导入document/nacos/DEFAULT_GROUP.zip
配置,然后分别进入各个微服务配置修改Redis、MySQL连接
-
-
至此环境配置准备完毕,接下来按照云环境
启动平台基础服务
步骤启动服务即可。
2. 后台前端启动
- 本机安装Node环境
- npm install
- npm run dev
- 访问 http://localhost:9527
3. 微信小程序启动
- 下载
HBuilder X
和微信开发者工具
- 微信公众平台申请小程序,获得小程序的AppID
微信开发者工具
微信扫码登录,开启服务端口,点击工具栏设置
->安全设置
->安全
->服务端口
选择打开Hbuilder X
替换项目AppID成自己的,点击manifest.json
文件->微信小程序配置- Nacos控制台修改
youlai-auth
配置中的微信小程序AppID和AppSecret为自己申请的小程序 Hbuilder X
工具栏点击运行
->运行到小程序模拟器
->微信开发者工具
项目文档
后台微服务
- Spring Cloud实战 | 第一篇:Windows搭建Nacos服务
- Spring Cloud实战 | 第二篇:Spring Cloud整合Nacos实现注册中心
- Spring Cloud实战 | 第三篇:Spring Cloud整合Nacos实现配置中心
- Spring Cloud实战 | 第四篇:Spring Cloud整合Gateway实现API网关
- Spring Cloud实战 | 第五篇:Spring Cloud整合OpenFeign实现微服务之间的调用
- Spring Cloud实战 | 第六篇:Spring Cloud Gateway+Spring Security OAuth2+JWT实现微服务统一认证授权
- Spring Cloud实战 | 最七篇:Spring Cloud Gateway+Spring Security OAuth2集成统一认证授权平台下实现注销使JWT失效方案
- Spring Cloud实战 | 最八篇:Spring Cloud +Spring Security OAuth2+ Vue前后端分离模式下无感知刷新实现JWT续期
- Spring Cloud实战 | 最九篇:Spring Security OAuth2认证服务器统一认证自定义异常处理
- Spring Cloud& Alibaba 实战 | 第十篇 :Spring Cloud + Nacos整合Seata 1.4.1最新版本实现微服务架构中的分布式事务,进阶之路必须要迈过的槛
- Spring Cloud & Alibaba 实战 | 第十一篇 :Spring Cloud Gateway网关实现对RESTful接口权限和按钮权限细粒度控制
- Spring Cloud & Alibaba 实战 | 第十二篇: Sentinel+Nacos实现流控、熔断降级,赋能拥有降级功能的Feign新技能熔断,做到熔断降级双剑合璧
后台管理前端
- vue-element-admin实战 | 第一篇: 移除mock接入微服务接口,搭建SpringCloud+Vue前后端分离管理平台
- vue-element-admin实战 | 第二篇: 最小改动接入后台实现根据权限动态加载菜单
微信小程序
应用部署
- Docker实战 | 第一篇:Linux 安装 Docker
- Docker实战 | 第二篇:Docker部署nacos-server:1.4.0
- Docker实战 | 第三篇:IDEA集成Docker插件实现一键自动打包部署微服务项目,一劳永逸的技术手段值得一试
- Docker实战 | 第四篇:Docker安装Nginx,实现基于vue-element-admin框架构建的项目线上部署
- Docker实战 | 第五篇:Docker启用TLS加密解决暴露2375端口引发的安全漏洞,被黑掉三台云主机的教训总结
分布式
接口文档
本地启动网关youlai-gateway
和相应的服务,访问 http://localhost:9999/doc.html
其他说明
-
如果github拉取失败请移步至码云https://gitee.com/haoxr,代码是同步的
-
项目在搭建的过程中如您遇到任何问题,可加我微信(haoxianrui)或者微信群,也可在github提issue
-
演示环境禁止修改、删除重要数据,请本地部署后操作