有来技术官网 | 有来技术博客| Gitee| Github
🌱 分支说明
| 说明 | 适配管理前端分支 | 适配移动端分支 | |
|---|---|---|---|
|
|
Java 8 + Spring Boot 2 + Spring Security OAuth2 | mall-admin:master | mall-app:master |
| master | Java 17 + Spring Boot 3 + Spring Authorization Server | mall-admin:master | mall-app:master |
🚀 项目简介
youlai-mall 是基于 Java 8 + Spring Boot 2 、Spring Cloud & Alibaba 2021、Vue3、Element-Plus、uni-app等全栈主流技术栈构建的开源商城项目，涉及 微服务接口、 管理前端、 微信小程序 和 APP应用等多端的开发。
- 项目使用皆是当前主流前后端技术栈(持续更新...)，无过度自定义封装，易理解学习和二次扩展；
- Spring Boot 2 、Spring Cloud & Alibaba 2021 一站式微服务开箱即用的解决方案；
- Spring Security OAuth2 、 Spring Cloud Gateway 、 JWT 统一认证鉴权和常用 OAuth2 授权模式扩展；
- 移动端采用终极跨平台解决方案 uni-app， 一套代码编译iOS、Android、H5和小程序等多个平台；
- Jenkins、K8s、Docker实现微服务持续集成与交付(CI/CD)。
🌈 在线预览
| 项目 | 地址 | 用户名/密码 |
|---|---|---|
| 管理端 | https://admin.youlai.tech | admin/123456 |
| 移动端(H5) | http://app.youlai.tech | 18866668888/666666 |
| 微信小程序 | 关注【有来技术】公众号 | 获取体验码申请体验 |
🍀 源码地址
| Gitee | Github | GitCode | |
|---|---|---|---|
| 后端接口 | youlai-mall | youlai-mall | - |
| 管理前端 | mall-admin | mall-admin | - |
| 移动端 | mall-app | mall-app | - |
🗂 项目目录
youlai-mall
├── docs
├── nacos # Nacos配置
├── sql # SQL脚本
├── laboratory # 实验室
├── mall-oms # 订单服务
├── mall-pms # 商品服务
├── mall-sms # 营销服务
├── mall-ums # 会员服务
├── middleware # 中间件(nacos/seata)
├── youlai-auth # OAuth2认证授权中心
├── youlai-common # 公共依赖
├── youlai-gateway # 网关
├── youlai-system # 系统服务
└── end
🥇 极速启动
极速启动是方便快速启动查看效果的启动方式，其中的数据库和Redis等中间件使用的是有来提供的云环境，切勿修改数据，有时间条件建议本地启动。
- 启动 Nacos
- IDEA 打开命令行终端 Terminal，输入
cd middleware/nacos/bin切换到 Nacos 的 bin 目录，执行startup -m standalone启动 Nacos 服务。
-
服务启动
-
youlai-gateway模块的启动类 GatewayApplication 启动网关； -
youlai-auth模块的启动类 AuthApplication 启动认证中心； -
youlai-system→system-boot模块的启动类 SystemApplication 启动系统服务； -
至此完成基础服务的启动，商城服务按需启动，启动方式和
youlai-system一致； -
访问接口文档地址测试: http://localhost:9999/doc.html
-
🥈 本地启动
-
中间件安装
为了避免数据和线上环境冲突，MySQL 和 Redis 必装，其他不安装可默认使用有来线上环境(
🔴 必装⚪ 可选) -
数据库创建和数据初始化
-
系统数据库
进入
docs/sql目录 ， 根据 MySQL 版本选择对应的脚本；先执行
database.sql完成数据库的创建；再执行
youlai.sql、oauth2.sql、mall_*.sql完成数据表的创建和数据初始化。 -
Nacos 数据库
创建名为
nacos的数据库，执行middleware/nacos/conf/nacos-mysql.sql脚本完成 Nacos 数据库初始化。
-
-
Nacos 配置持久化至 MySQL
进入项目的
middleware/nacos/conf/application.properties文件修改 Nacos 配置的数据连接，需要修改配置如下：spring.datasource.platform=mysql db.num=1 db.url.0=jdbc:mysql://localhost:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC db.user.0=root db.password.0=123456 -
导入Nacos配置
IDEA 打开命令行终端 Terminal，输入
cd middleware/nacos/bin切换到 Nacos 的 bin 目录，执行startup -m standalone启动 Nacos 服务。打开浏览器，地址栏输入 Nacos 控制台的地址 http://localhost:8848/nacos ；
输入用户名/密码：nacos/nacos ；
进入控制台，点击左侧菜单
配置管理→配置列表进入列表页面，点击导入配置选择项目中的docs/nacos/nacos_config.zip文件。 -
修改Nacos配置
在 Nacos 控制台配置列表选择共享配置
youlai-common.yaml进行编辑，修改 MySQL、Redis、RabbitMQ等中间件信息为您自己本地环境，默认「有来」线上环境。 -
修改Nacos配置中心地址
批量替换应用的 bootstrap-dev.yml 文件的配置中心地址
http://f.youlai.tech:8848→http://localhost:8848，默认「有来」线上的配置中心地址。 -
服务启动
-
进入
youlai-gateway模块的启动类 GatewayApplication 启动网关； -
进入
youlai-auth模块的启动类 AuthApplication 启动认证授权中心； -
进入
youlai-system→system-boot模块的启动类 SystemApplication 启动系统服务； -
至此完成基础服务的启动，商城服务按需启动，启动方式和
youlai-system一致; -
访问接口文档地址测试: http://localhost:9999/doc.html
-
🧩项目截图
| 「App」Spring Security OAuth2 手机短信验证码模式 | 「小程序」Spring Security OAuth2 微信授权模式 |
|---|---|
 |
 |
| 「管理前端」Spring Security OAuth2 密码模式 | 「管理前端」Spring Security OAuth2 验证码模式 |
 |
 |
💹 趋势统计
💻 贡献者
🚀 交流群
关注「有来技术」公众号，获取交流群二维码。
如果交流群的二维码过期，加我微信，备注「前端」、「后端」或「全栈」即可。
为了避免营销广告人群混入，此举无奈，望理解！
| 公众号 | 交流群 |
|---|---|
 |
 |
📰 开源协议
Apache Licence 2.0 是著名的非盈利开源组织Apache采用的协议。该协议鼓励代码共享和尊重原作者的著作权，商用或二次开源须要满足的条件：
- 需要给代码的用户一份Apache Licence。
- 如果你修改了代码，需要在被修改的文件中说明。
- 在延伸的代码中（修改和有源代码衍生的代码中）需要带有原来代码中的协议，商标，专利声明和其他原来作者规定需要包括的说明。
- 如果再发布的产品中包含一个Notice文件，则在Notice文件中需要带有Apache Licence。你可以在Notice中增加自己的许可，但不可以表现为对Apache Licence构成更改。 Apache Licence也是对商业应用友好的许可。使用者也可以在需要的时候修改代码来满足需要并作为开源或商业产品发布/销售。
如果你参考或借鉴了本项目的源码，请你在项目的说明文档添加对本项目的引用申明和添加Git仓库地址(https://gitee.com/youlaitech/youlai-mall)。