youlai-mall/README.md

169 lines
9.9 KiB
Markdown
Raw Normal View History

2023-05-07 12:21:22 +08:00
<p align="center">
2023-11-04 15:36:02 +08:00
<img alt="有来技术" src="https://img.shields.io/badge/Java-17-brightgreen.svg"/>
<img alt="有来技术" src="https://img.shields.io/badge/SpringBoot-3.1.5-green.svg"/>
<img alt="有来技术" src="https://img.shields.io/badge/SpringCloud & Alibaba-2022-yellowgreen.svg"/>
2023-05-07 09:07:46 +08:00
<a href="https://gitee.com/youlaitech/youlai-mall" target="_blank">
<img alt="有来技术" src="https://gitee.com/youlaitech/youlai-mall/badge/star.svg"/>
</a>
<a href="https://github.com/hxrui" target="_blank">
<img alt="有来技术" src="https://img.shields.io/github/stars/youlaitech/youlai-mall.svg?style=social&label=Stars"/>
</a>
<br/>
2023-05-07 09:07:46 +08:00
<img alt="有来技术" src="https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg"/>
<a href="https://gitee.com/youlaiorg" target="_blank">
2023-05-07 09:07:46 +08:00
<img alt="有来技术" src="https://img.shields.io/badge/Author-有来开源组织-orange.svg"/>
</a>
</p>
2023-05-07 12:21:22 +08:00
<p align="center">
<a target="_blank" href="https://www.youlai.tech">有来技术官网</a> |
<a target="_blank" href="https://youlai.blog.csdn.net">有来技术博客</a>|
<a target="_blank" href="https://gitee.com/haoxr">Gitee</a>|
2023-11-03 10:54:20 +08:00
<a target="_blank" href="https://github.com/haoxianrui">Github</a>
</p>
2023-11-04 15:40:57 +08:00
## 🌱分支说明
2023-11-12 01:01:24 +08:00
| | 说明 | 适配管理前端分支 | 适配移动端分支 |
|-------------------|-------------------------------------------------------|------------------------------------------------------------------------|--------------------------------------------------------------------|
| ✅master | Java 17 + Spring Boot 3 + Spring Authorization Server | [mall-admin:master](https://gitee.com/youlaiorg/mall-admin) | [mall-app:master](https://gitee.com/youlaiorg/mall-app) |
| java8 | Java 8 + Spring Boot 2 + Spring Security OAuth2 | [mall-admin:java8](https://gitee.com/youlaiorg/mall-admin/tree/java8/) | [mall-app:java8](https://gitee.com/youlaiorg/mall-app/tree/java8/) |
2023-11-04 15:40:57 +08:00
## 🚀项目简介
[youlai-mall](https://gitee.com/haoxr) 是基于Spring Boot 3 、Spring Cloud & Alibaba
2022、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)
2023-05-07 09:07:46 +08:00
和 [APP应用](https://gitee.com/youlaitech/youlai-mall-weapp)等多端的开发。
2022-02-16 12:50:47 +08:00
- 项目使用皆是当前主流前后端技术栈(持续更新...),无过度自定义封装,易理解学习和二次扩展;
2023-11-04 15:36:02 +08:00
- Spring Boot 3 、SpringCloud & Alibaba 2022 一站式微服务开箱即用的解决方案;
- Spring Authorization Server 、 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 |
| 微信小程序 | 关注【有来技术】公众号| 获取体验码申请体验 |
2022-02-16 12:50:47 +08:00
## 🍀源码地址
2022-02-16 12:50:47 +08:00
| | Gitee | Github | GitCode |
|------|--------------------------------------------------------|----------------------------------------------------------|---------|
| 后端接口 | [youlai-mall](https://gitee.com/youlaiorg/youlai-mall) | [youlai-mall](https://github.com/youlaitech/youlai-mall) | - |
| 管理前端 | [mall-admin](https://gitee.com/youlaiorg/mall-admin) | [mall-admin](https://github.com/youlaitech/mall-admin) | - |
| 移动端 | [mall-app](https://gitee.com/youlaiorg/mall-app) | [mall-app](https://github.com/youlaitech/mall-app) | - |
2020-09-08 01:39:13 +08:00
2023-11-03 10:54:20 +08:00
## 📁目录结构
2023-05-07 12:20:40 +08:00
``` text
youlai-mall
├── docs
├── nacos # Nacos配置
2024-02-24 20:16:56 +08:00
├── nacos_config.zip # Nacos脚本
├── sql # SQL脚本
2024-02-24 20:16:56 +08:00
├── mysql5 # MySQL5脚本
├── mysql8 # MySQL8脚本
2024-06-17 08:25:01 +08:00
├── mall-sales # 营销服务(Sales Management Service)
2024-04-04 23:51:42 +08:00
├── sms-api # 营销服务-Feign客户端
2024-06-17 08:25:01 +08:00
├── sales-boot # 营销服务-启动应用
2024-05-05 23:55:54 +08:00
├── mall-product # 商品服务(Product Management Service)
├── product-api # 商品服务-Feign客户端
├── product-boot # 商品服务-启动应用
2024-06-04 18:17:32 +08:00
├── mall-order # 订单服务(Order Management Service)
├── order-boot # 订单服务-启动应用
├── mall-member # 会员服务(User Management Service)
├── member-api # 会员服务-Feign客户端
├── member-boot # 会员服务-启动应用
2024-02-24 20:16:56 +08:00
├── youlai-auth # 认证授权中心
├── youlai-common # 公共模块
2024-02-24 20:16:56 +08:00
├── common-core # 基础依赖
├── common-log # 日志公共模块
2024-02-24 20:16:56 +08:00
├── common-mybatis # Mybatis 公共模块
├── common-rabbitmq # RabbitMQ 公共模块
├── common-redis # Redis 公共模块
├── common-seata # Seata 公共模块
├── common-security # 资源服务器安全公共模块
2024-02-24 20:16:56 +08:00
├── common-web # Web 公共模块
├── youlai-gateway # 网关
├── youlai-system # 系统服务
├── system-api # 系统Feign接口
├── system-boot # 系统管理接口
└── end
```
## 🌌启动项目
2022-02-16 12:50:47 +08:00
### 环境要求
- JDK 17
- MySQL 8 或 MySQL 5.7
- Nacos 2.2+
2022-02-16 12:50:47 +08:00
### 安装中间件
2022-02-16 12:50:47 +08:00
| | Windows | Linux | 是否必装 |
| -------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------ |
| Nacos | [Windows 安装 Nacos 2.2](https://youlai.blog.csdn.net/article/details/130864925) | [Linux 安装 Nacos 2.3](https://youlai.blog.csdn.net/article/details/132592040) | 是 |
| MySQL | [Windows 安装 MySQL 8](https://youlai.blog.csdn.net/article/details/133272887) | [Linux 安装 MySQL8](https://youlai.blog.csdn.net/article/details/130398179) | 否(建议安装) |
| Redis | [Windows 安装 Redis](https://youlai.blog.csdn.net/article/details/133410293) | [Linux 安装 Redis](https://youlai.blog.csdn.net/article/details/130439335) | 否(建议安装) |
| Seata | [Windows 安装 Seata 1.6](https://youlai.blog.csdn.net/article/details/133295970) | [Linux 安装 Seata 1.7](https://youlai.blog.csdn.net/article/details/133376131) | 否 |
| RabbitMQ | / | [Linux 安装 RabbitMQ](https://blog.csdn.net/u013737132/article/details/130439122) | 否 |
2023-11-03 10:54:20 +08:00
💡默认中间件使用有来线上的环境,其中线上 MySQL 数据是只读的,如果需要进行修改或删除操作,建议自己安装 MySQL。
2022-02-16 12:50:47 +08:00
### 初始化数据库
2022-02-16 12:50:47 +08:00
进入 `docs/sql` 目录 根据 MySQL 版本选择对应的脚本;
先执行 [database.sql](docs%2Fsql%2Fmysql8%2Fdatabase.sql) 完成数据库的创建;
2024-04-08 23:59:10 +08:00
再执行 [youlai_system.sql](docs%2Fsql%2Fmysql8%2Fyoulai_system.sql) 、[youlai_oauth2_server.sql](docs%2Fsql%2Fmysql8%2Foauth2_server.sql)、mall_*.sql 完成数据表的创建和数据初始化。
### 导入 Nacos 配置
2022-02-16 12:50:47 +08:00
打开浏览器,地址栏输入 Nacos 控制台的地址 [ http://localhost:8848/nacos]( http://localhost:8848/nacos)
输入用户名/密码nacos/nacos
进入控制台,点击左侧菜单 `配置管理``配置列表` 进入列表页面,点击 `导入配置`
选择项目中的 `docs/nacos/nacos_config.zip` 文件。
### 修改 Nacos 配置
在共享配置文件 youlai-common.yaml 中,包括 MySQL、Redis、RabbitMQ 和 Seata 的连接信息,默认是有来线上的环境。
2022-02-16 12:50:47 +08:00
如果您有自己的环境,可以按需修改相应的配置信息。
2022-02-16 12:50:47 +08:00
如果没有自己的 MySQL、Redis、RabbitMQ 和 Seata 环境,可以直接使用默认的配置。
### 启动服务
2022-02-16 12:50:47 +08:00
2023-11-03 10:54:20 +08:00
- 进入 `youlai-gateway` 模块的启动类 GatewayApplication 启动网关;
2021-02-25 20:08:21 +08:00
2023-11-03 10:54:20 +08:00
- 进入 `youlai-auth` 模块的启动类 AuthApplication 启动认证授权中心;
2023-11-03 10:54:20 +08:00
- 进入 `youlai-system``system-boot` 模块的启动类 SystemApplication 启动系统服务;
2023-11-03 10:54:20 +08:00
- 至此完成基础服务的启动,商城服务按需启动,启动方式和 `youlai-system` 一致;
2023-11-03 10:54:20 +08:00
- 访问接口文档地址测试: [http://localhost:9999/doc.html](http://localhost:9999/doc.html)
## 📝开发文档
- [Spring Authorization Server 扩展 OAuth2 密码模式](https://youlai.blog.csdn.net/article/details/134024381)
- [Spring Cloud Gateway + Knife4j 网关聚合和 OAuth2 密码模式测试](https://youlai.blog.csdn.net/article/details/134081509)
## 💖加交流群
> 关注公众号【有来技术】,获取交流群二维码,二维码过期请加我微信(`haoxianrui`)备注“有来”,我拉你进群。
| ![](https://s2.loli.net/2022/11/19/OGjum9wr8f6idLX.png) |
2023-05-07 09:07:46 +08:00
|---------------------------------------------------------|