youlai-mall/README.md

<p align="center">
    <img src="https://img.shields.io/badge/SpringBoot-2.6.3-brightgreen.svg"/>
    <img src="https://img.shields.io/badge/SpringCloud & Alibaba -2021-green.svg"/>
    <a src="https://github.com/hxrui" target="_blank">
        <img src="https://img.shields.io/github/stars/youlaitech/youlai-mall.svg?style=social&label=Stars"/>
    </a>
    <a href="https://gitee.com/youlaitech/youlai-mall" target="_blank">
        <img src="https://gitee.com/youlaitech/youlai-mall/badge/star.svg"/>
    </a> 
    <br/>
    <img src="https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg"/>
    <a href="https://gitee.com/youlaiorg" target="_blank">
        <img src="https://img.shields.io/badge/Author-有来开源组织-orange.svg"/>
    </a>
</p>
<p align="center">
<strong>在线预览：</strong><a target="_blank" href="http://www.youlai.tech">www.youlai.tech</a> 
</p>

<p align="center">
<strong>H5商城在线预览：</strong><a target="_blank" href="http://www.youlai.tech:81">mall.youlai.tech</a> 
</p>


<p align="center">
<strong>开源地址：</strong>  <a target="_blank" href='https://github.com/hxrui'>Github</a> | <a target="_blank" href='https://gitee.com/haoxr'>Gitee</a> | <a target="_blank" href='https://gitcode.net/youlai'>GitCode</a> 
</p>



<p align="center">
<strong>博客主页：</strong><a target="_blank" href="https://www.cnblogs.com/haoxianrui/"> https://www.cnblogs.com/haoxianrui</a> 
</p>



<p align="center">
<strong>开发者文档：</strong><a target="_blank" href="http://youlaitech.gitee.io/youlai-mall">http://youlaitech.gitee.io/youlai-mall</a> 
</p>



## 🈶 项目介绍


### 🗁 项目简介

[youlai-mall](https://gitee.com/haoxr) 是基于Spring Boot 2.6、Spring Cloud 2021 & Alibaba 2021、Vue3、Element-Plus、uni-app等主流技术栈构建的一整套全栈开源商城项目， 涉及 [后端微服务](https://gitee.com/youlaitech/youlai-mall)、 [前端管理](https://gitee.com/youlaitech/youlai-mall-admin) 、 [微信小程序](https://gitee.com/youlaitech/youlai-mall-weapp)和 [APP应用](https://gitee.com/youlaitech/youlai-mall-weapp) 等多端的开发。


### 🗁 项目特色


- 项目使用皆是当前主流的技术栈，无过度自定义封装，易理解学习和二次扩展；
- SpringBoot 2.6、SpringCloud 2021 & Alibaba 2021 一站式微服务开箱即用的解决方案；
- Spring Security OAuth2 、 Spring Cloud Gateway 、 JWT 统一认证鉴权和常用 OAuth2 授权模式扩展；
- 移动端采用终极跨平台解决方案 uni-app， 一套代码编译iOS、Android、H5和小程序等多个平台；
- Jenkins、K8s、Docker实现微服务持续集成与交付(CI/CD)。


### 🗁 在线预览


|               | 地址                                                |
| ------------- | --------------------------------------------------- |
| 管理前端 Vue3 | [www.youlai.tech](http://www.youlai.tech)           |
| 管理前端 Vue2 | [www.youlai.tech:9527](http://www.youlai.tech:9527) |
| H5 移动端     | [www.youlai.tech:81](http://www.youlai.tech:9527)   |


### 🗁 预览截图


| 「App」Spring Security OAuth2 手机短信验证码模式             | 「小程序」Spring Security OAuth2 微信授权模式                |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| <img src="https://gitee.com/haoxr/image/raw/master/default/smscode%20(1).gif" width="100%" height="400px"/> | <img src="https://gitee.com/haoxr/image/raw/master/default/wechatlogin.gif" width="100%" height="400px"/> |
| **「管理前端」Spring Security OAuth2 密码模式**              | **「管理前端」Spring Security OAuth2 验证码模式**            |
| <img src="https://gitee.com/haoxr/image/raw/master/default/password.gif" width="100%" height="400px"/> | <img src="https://gitee.com/haoxr/image/raw/master/default/captcha.gif" width="100%" height="400px"/> |


## 🪁 源码地址


|                  | Gitee                                                        | Github                                                       | GitCode                                                      |
| ---------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 开源组织         | [有来开源组织](https://gitee.com/youlaiorg)                  | [有来开源组织](https://github.com/youlaitech)                | [有来开源组织](https://gitcode.net/youlai)                   |
| 后端             | [youlai-mall](https://gitee.com/youlaiorg/youlai-mall)       | [youlai-mall](https://github.com/youlaitech/youlai-mall)     | [youlai-mall](https://gitcode.net/youlai/youlai-mall)        |
| 管理前端         | [mall-admin-web](https://gitee.com/youlaiorg/mall-admin-web) | [mall-admin-web](https://github.com/youlaitech/mall-admin-web) | [mall-admin-web](https://github.com/youlaitech/mall-admin-web) |
| 小程序/H5/移动端 | [mall-app](https://gitee.com/youlaiorg/mall-app)             | [mall-app](https://github.com/youlaitech/mall-app)           | [mall-app](https://gitcode.net/youlai/mall-app)              |


## 🚤 项目启动

###  🗁 后端启动


> `极速启动` 是方便快速启动查看效果的启动方式，其中的数据库和Redis等中间件使用的是有来提供的云环境，切勿修改数据，有时间条件建议`本地启动`。



#### 1️⃣ 极速启动


1. **启动 Nacos**


   - IDEA 打开命令行终端 Terminal，输入 `cd middleware/nacos/bin` 切换到 Nacos 的 bin 目录，执行 `startup -m standalone` 启动 Nacos 服务。


2. **服务启动**

   - `youlai-gateway` 模块的启动类 GatewayApplication 启动网关；

   - `youlai-auth` 模块的启动类 AuthApplication 启动认证中心；

   - `youlai-admin`  → `admin-boot` 模块的启动类 AdminApplication 启动系统服务；

   - 至此完成基础服务的启动，商城服务按需启动，启动方式和 `youlai-admin` 一致；

   - 访问接口文档地址测试: [http://localhost:9999/doc.html](http://localhost:9999/doc.html)
     

#### 2️⃣ 本地启动


1. **中间件安装(🔴必装 ⚪可选)**

   > 为了避免数据和线上环境冲突，MySQL 和 Redis 必装，不安装可默认使用有来线上环境

   - 🔴MySQL 安装
   - 🔴Redis 安装
   - ⚪RabbitMQ
   - ⚪Seata 安装
   - ⚪Sentinel 安装


2. **数据库创建和数据初始化**

   - **系统数据库**

       进入 `docs/sql` 目录 ， 根据 MySQL 版本选择对应的脚本；
    
       先执行 `database.sql` 完成数据库的创建；

       再执行 `youlai.sql` 、`mall_*.sql` 完成数据表的创建和数据初始化。

   - **Nacos 数据库**

     创建名为 `nacos` 的数据库，执行 `middleware/nacos/conf/nacos-mysql.sql` 脚本完成 Nacos 数据库初始化。

3. **Nacos 配置和启动**


   1.  **Nacos 配置持久化至 MySQL**

       进入项目的 `middleware/nacos/conf/application.properties` 文件修改 Nacos 配置的数据连接，需要修改配置如下：

       ```properties
       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
       ```

   2.  **启动Nacos**

       IDEA 打开命令行终端 Terminal，输入 `cd middleware/nacos/bin` 切换到 Nacos 的 bin 目录，执行 `startup -m standalone` 启动 Nacos 服务。

   3.  **导入Nacos配置**

       打开浏览器，地址栏输入 Nacos 控制台的地址 [ http://localhost:8848/nacos]( http://localhost:8848/nacos) ；

       输入用户名/密码：nacos/nacos ；

       进入控制台，点击左侧菜单 `配置管理` → `配置列表` 进入列表页面，点击 `导入配置` 选择项目中的 `docs/nacos/DEFAULT_GROUP.zip` 文件。

   4.  **修改Nacos配置**

       在 Nacos 控制台配置列表选择共享配置 `youlai-common.yaml` 进行编辑，修改 MySQL、Redis、RabbitMQ等中间件信息为您自己本地环境，默认「有来」线上环境。
   
   5. **修改Nacos配置中心地址**
      
        批量替换应用的 bootstrap-dev.yml 文件的配置中心地址 `http://c.youlai.tech/8848` → `http://localhost/8848` ，默认「有来」线上的配置中心地址。 


4. **服务启动**

   - 进入 `youlai-gateway` 模块的启动类 GatewayApplication 启动网关；

   - 进入 `youlai-auth` 模块的启动类 AuthApplication 启动认证授权中心；

   - 进入 `youlai-admin`  → `admin-boot` 模块的启动类 AdminApplication 启动系统服务；

   - 至此完成基础服务的启动，商城服务按需启动，启动方式和 `youlai-admin` 一致;

   - 访问接口文档地址测试:  [http://localhost:9999/doc.html](http://localhost:9999/doc.html))
    

### 🗁 管理前端启动


1. 本机安装 Node 环境
2. npm install
3. npm run dev
4. 访问 http://localhost:9527


### 🗁 微信小程序启动


1. 下载 `HBuilder X` 和 `微信开发者工具` ;
2. 导入 [mall-app](https://gitee.com/youlaitech/youlai-mall-weapp) 源码至 `HBuilder X` ;
3. 微信公众平台申请小程序，获得小程序的AppID ;
4. `微信开发者工具` 微信扫码登录，开启服务端口，点击工具栏 `设置` -> `安全设置` -> `安全` -> `服务端口`选择打开 ;
5. `Hbuilder X` 替换项目AppID成自己的，点击 `manifest.json` 文件->微信小程序配置 ;
6. Nacos控制台替换 `youlai-auth` 配置中的微信小程序 AppID 和 AppSecret 为自己申请的小程序 ;
7. `Hbuilder X` 工具栏点击 `运行` -> `运行到小程序模拟器` -> `微信开发者工具`。


### 🗁 H5/移动端启动


1. 下载 `HBuilder X` ;
2. 导入 [mall-app](https://gitee.com/youlaitech/youlai-mall-weapp) 源码至 `HBuilder X`;
3. `Hbuilder X` 工具栏点击 `运行` -> `运行到内置浏览器` 。


## 💹 趋势统计


- Gitee


<p align="center">
    <a target="_blank" href='https://whnb.wang/stars/youlaitech/youlai-mall'><img src="https://whnb.wang/stars/youlaitech/youlai-mall"></a>
</p>



- Github


<p align="center">
    <a target="_blank" href='https://starchart.cc/hxrui/youlai-mall'><img src="https://starchart.cc/hxrui/youlai-mall.svg"></a>
</p>



## 💬 联系信息 


> 欢迎添加开发者微信，备注「有来」进群



|                         全栈                          |                             全栈                             |                            DevOps                            |
| :---------------------------------------------------: | :----------------------------------------------------------: | :----------------------------------------------------------: |
| ![](https://gitee.com/haoxr/image/raw/master/hxr.jpg) | ![](https://gitee.com/haoxr/image/raw/master/default/ba695a5e70410a066b7052c5dc9db5c.jpg) | ![](https://gitee.com/haoxr/image/raw/master/default/jialin.jpg) |