一飞开源,介绍创意、新奇、有趣、实用的免费开源应用、系统、软件、硬件及技术,一个探索、发现、分享、使用与互动交流的开源技术社区平台。致力于打造活力开源社区,共建开源新生态!
一、开源项目简介
youlai-mall 是基于Spring Boot 2.7、Spring Cloud 2021 & Alibaba 2021、Vue3、Element-Plus、uni-app等主流技术栈构建的一整套全栈开源商城项目, 涉及 后端微服务、 前端管理 、 微信小程序和 APP应用 等多端的开发。
二、开源协议
使用Apache-2.0开源协议
三、界面展示
项目预览
「App」Spring Security OAuth2 手机短信验证码模式 | 「小程序」Spring Security OAuth2 微信授权模式 |
「管理前端」Spring Security OAuth2 密码模式 | 「管理前端」Spring Security OAuth2 验证码模式 |
四、功能概述
项目特色
- 项目使用皆是当前主流前后端技术栈(持续更新...),无过度自定义封装,易理解学习和二次扩展;
- 极速启动,在IDEA和Java环境OK的情况下1分钟之内可正常启动微服务,可以快速拥有微服务环境和上手微服务;
- SpringBoot 2.7、SpringCloud 2021 & Alibaba 2021 一站式微服务开箱即用的解决方案;
- Spring Security OAuth2 、 Spring Cloud Gateway 、 JWT 统一认证鉴权和常用 OAuth2 授权模式扩展;
- 移动端采用终极跨平台解决方案 uni-app, 一套代码编译iOS、Android、H5和小程序等多个平台;
- Jenkins、K8s、Docker实现微服务持续集成与交付(CI/CD)。
五、技术选型
项目启动
后端启动
极速启动 是方便快速启动查看效果的启动方式,其中的数据库和Redis等中间件使用的是有来提供的云环境,切勿修改数据,有时间条件建议本地启动。
1️⃣极速启动
- 启动 Nacos
- IDEA 打开命令行终端 Terminal,输入 cd middleware/nacos/bin 切换到 Nacos 的 bin 目录,执行 startup -m standalone 启动 Nacos 服务。
- 服务启动
- youlai-gateway 模块的启动类 GatewayApplication 启动网关;
- youlai-auth 模块的启动类 AuthApplication 启动认证中心;
- youlai-admin → admin-boot 模块的启动类 AdminApplication 启动系统服务;
- 至此完成基础服务的启动,商城服务按需启动,启动方式和 youlai-admin 一致;
- 访问接口文档地址测试: http://localhost:9999/doc.html
2️⃣本地启动
- 中间件安装
- 为了避免数据和线上环境冲突,MySQL 和 Redis 必装,其他不安装可默认使用有来线上环境(必装 ⚪可选)
- MySQL Linux部署
- Redis Linux部署
- ⚪ RabbitMQ Linux部署
- ⚪ Seata 本地启动 | Linux部署
- ⚪ Sentinel 本地启动 | Linux部署
- ⚪ Canal 本地启动 | Linux部署
- 数据库创建和数据初始化
- 系统数据库
- 进入 docs/sql 目录 , 根据 MySQL 版本选择对应的脚本;
- 先执行 database.sql 完成数据库的创建;
- 再执行 youlai.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/DEFAULT_GROUP.zip 文件。
- 修改Nacos配置
- 在 Nacos 控制台配置列表选择共享配置 youlai-common.yaml 进行编辑,修改 MySQL、Redis、RabbitMQ等中间件信息为您自己本地环境,默认「有来」线上环境。
- 修改Nacos配置中心地址
- 批量替换应用的 bootstrap-dev.yml 文件的配置中心地址 http://c.youlai.tech:8848 → http://localhost:8848 ,默认「有来」线上的配置中心地址。
- 服务启动
- 进入 youlai-gateway 模块的启动类 GatewayApplication 启动网关;
- 进入 youlai-auth 模块的启动类 AuthApplication 启动认证授权中心;
- 进入 youlai-admin → admin-boot 模块的启动类 AdminApplication 启动系统服务;
- 至此完成基础服务的启动,商城服务按需启动,启动方式和 youlai-admin 一致;
- 访问接口文档地址测试: http://localhost:9999/doc.html
管理前端启动
- 本机安装 Node 环境
- npm install
- npm run dev
- 访问 http://localhost:9527
微信小程序启动
- 下载 HBuilder X 和 微信开发者工具 ;
- 导入 mall-app 源码至 HBuilder X ;
- 微信公众平台申请小程序,获得小程序的AppID ;
- 微信开发者工具 微信扫码登录,开启服务端口,点击工具栏 设置 -> 安全设置 -> 安全 -> 服务端口选择打开 ;
- Hbuilder X 替换项目AppID成自己的,点击 manifest.json 文件->微信小程序配置 ;
- Nacos控制台替换 youlai-auth 配置中的微信小程序 AppID 和 AppSecret 为自己申请的小程序 ;
- Hbuilder X 工具栏点击 运行 -> 运行到小程序模拟器 -> 微信开发者工具。
H5/移动端启动
- 下载 HBuilder X ;
- 导入 mall-app 源码至 HBuilder X;
- Hbuilder X 工具栏点击 运行 -> 运行到内置浏览器 。
六、源码地址
访问一飞开源:https://code.exmay.com/
版权声明:内容来源于互联网和用户投稿 如有侵权请联系删除