README.en.md · Yzi/tacomall-springboot

<a href="#"><img src="https://img.codingtalk.cn/B44paPc1585145412609"></a>

[power by 码上talk©]

	<a target="_blank" href="https://gitee.com/running-cat/tacomall-springboot/blob/master/LICENSE">
		<img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="LICENSE"/>
	</a>
 <a target="_blank" href="https://spring.io/projects/spring-boot">
		<img src="https://img.shields.io/badge/springboot-2.1.7.RELEASE-green" alt="springboot-2.1.7.RELEASE"/>
	</a>
	<a target="_blank" href="https://www.oracle.com/technetwork/java/javase/downloads/index.html">
		<img src="https://img.shields.io/badge/JDK-1.8+-green.svg"/>
	</a>
	<a target="_blank" href="https://swagger.io">
		<img src="https://img.shields.io/badge/swagger-2.0-orange.svg"/>
	</a>


基于springboot开发的maven多模块聚合商城后台，弹性的水平架构设计，适用于中大型项目的开发，同时让大家免于项目搭建的繁琐，将主要的精力用于业务开发。

基于spring cloud开发的微服务商城后台。 高可用、高并发架构设计，弹性的水平架构设计，优雅的代码，合理的注释，丰富的接口文档，面对企业级微服务架构设计。 =====>
<a href="https://gitee.com/running-cat/tacomall-springcloud" target="_blank">另有springcloud版本</a>

tacomall并不是一个单纯的后台项目，你可能还需要跨平台小程序=====>
<a href="https://gitee.com/running-cat/tacomall-uniapp" target="_blank">tacomall-uniapp</a>

除此之外，你希望我们有一个完整的商城开源项目=====>
<a href="https://gitee.com/running-cat/tacomall-enterprise" target="_blank">商家管理后台</a>
<a href="https://gitee.com/running-cat/tacomall-admin" target="_blank">平台管理后台</a>

[TOC]

```
                                                                
                                                                
                                                                
 __  ___  ___      ___      ___      _   __      ___     // //  
  / /   //   ) ) //   ) ) //   ) ) // ) )  ) ) //   ) ) // //   
 / /   //   / / //       //   / / // / /  / / //   / / // //    
/ /   ((___( ( ((____   ((___/ / // / /  / / ((___( ( // //

如果你发现项目不错，不要忘记给项目点个赞👍，你的支持是我们前进的动力 :)

```

## 演示

<table border="0">
 <tr>
 <td>微信小程序（微信扫一扫）</td>
 <td>商家管理后台</td>
 <td>平台管理后台</td>
 </tr>
 <tr>
 <td><img title="码上talk" src="https://img.codingtalk.cn/3Y4h5Zz1608078777538" height="200" width="200"/></td>
 <td><a href="http://merchant.webtc.codingtalk.cn/login?t=trial">>>>点击进入商家管理后台</td>
 <td><a href="http://admin.webtc.codingtalk.cn/login?t=trial">>>>点击进入平台管理后台</td>
 </tr>
</table>

## 社区

<table border="0">
 <tr>
 <td>关注“码上talk”微信公众号</td>
 <td>tacomall QQ交流群</td>
 <td>我的微信</td>
 </tr>
 <tr>
 <td><img title="码上talk" src="https://img.codingtalk.cn/ncr3m3k1585147351285" height="200" width="200"/></td>
 <td><img title="tacomall QQ交流群" src="https://img.codingtalk.cn/haPkJxc1585147447571" height="200" width="220"/></td>
 <td><img title="码上talk|RC" src="https://img.codingtalk.cn/meJzskn1584540440273" height="200" width="220"/></td>
 </tr>
</table>

如果您觉得有帮助，请点右上角 "Star" 支持一下谢谢

如果您对此项目感兴趣，请点右上角 "Star" 支持一下谢谢

如果需要帮助请留言或者加微信，晚上20：00后统一回复解决

## SPRINGBOOT版本与SPRINGCLOUD版本区别

### SPRINGBOOT版本

> 面对用户量不高、部署条件受限，同时需要快速开发的项目需求（业务代码覆盖广）

### SPRINGCLOUD版本

> 面对PV高并发，架构高可用设计，对技术栈要求较高，同时部署设备有一定要求（架构性项目），注意，由于中间件项目很大，没有上传，所以本项目不含docker配置，整个系统运行需要中间件支持，需要docker配置的请加上面》》 tacomallQQ群《《 获取

## 项目结构

通过项目结构，你将清楚明白你即将入手的是一个怎么样的项目，你可能需要什么，如何快速的把它变成自己的产品。

### 核心业务

- [x] [公共依赖](https://gitee.com/running-cat/tacomall-springboot/tree/master/tacomall-common) 公共工具库、异常
- [x] [实体类](https://gitee.com/running-cat/tacomall-springboot/tree/master/tacomall-entity) java bean和数据库的映射
- [x] [代码生成](https://gitee.com/running-cat/tacomall-springboot/tree/master/tacomall-generator) 提供entity和mapper的快速生成
- [x] [数据库操作](https://gitee.com/running-cat/tacomall-springboot/tree/master/tacomall-mapper) 数据库操作
- [x] [任务调度](https://gitee.com/running-cat/tacomall-springboot/tree/master/tacomall-job) 提供任务调度创建，执行
- [x] [微信小程序接口](https://gitee.com/running-cat/tacomall-springboot/tree/master/tacomall-api/tacomall-api-portal) 微信小程序接口,提供用户，商品服务
- [x] [平台管理后台](https://gitee.com/running-cat/tacomall-springboot/tree/master/tacomall-api/tacomall-api-admin) 提供商家，商品, 会员管理
- [ ] [商家管理后台](https://gitee.com/running-cat/tacomall-springboot/tree/master/tacomall-api/tacomall-api-enterprise) 提供商品, 会员管理
- [x] [开放平台](https://gitee.com/running-cat/tacomall-springboot/tree/master/tacomall-api/tacomall-api-open) 开放接口

### 架构原理

通过maven聚合方式开发，将开发过程中可重复依赖的模块提升为公共依赖，从而实现“高内聚，低耦合”的效果。

### 代码描述

~~~
tacomall-springboot                             项目
├─api                                           接口模块
│  ├─admin                                      平台管理后台
│  ├─merchant                                   商家管理后台
│  ├─open                                       开放接口
│  ├─portal                                     小程序接口
├─tacomall-job                                  任务调度
│  ├─admin                                      调度接口
│  ├─executor                                   调度执行
├─common                                        公共依赖
│  ├─config                                     全局spring bean
│  ├─entity                                     实体类
│  ├─enumeration                                枚举类
│  ├─mapper                                     mapper层
│  ├─util                                       公共方法
├─generator                                     代码生成
├─pom.xml                                       依赖构建配置
~~~

## 上手指南

我们希望开源的项目能够让每一个人都能够一看就懂，轻松上手，但这并不意味者我们不需要做任何东西，相反，在正式运行项目前，你必须完成以下步骤。

### 环境要求

为了避免运行开发中遇到一些意想不到的问题，我们推荐你安装如下环境。

1. Git
2. JDK1.8+
3. Maven3.5+
4. Mysql5.7+
5. Idea2019.3.3
6. Postman
7. mysql
8. redis
### 安装步骤

通过以下步骤，你将很快看见项目运行起来了！

1. 克隆项目

```
git clone https://gitee.com/running-cat/tacomall-springboot.git
```
2. 配置idea

为了更好的运行项目，我们需要将idea的jdk环境路径配置为我们上面早已安装好的jdk1.8+,同时配置idea默认maven路径为我们上述安装好的maven并配置好国内源。

3. 导入idea

打开idea导入克隆下来的项目

4. maven依赖安装

右键根目录的pom.xml，maven->reimport

5. 导入数据

打开我们的数据库设计工具（pdman）[下载地址](https://gitee.com/robergroup/pdman?_from=gitee_search)。

```
导入项目（_doc/pdman/tacomall.pdman.json）->配置数据库->运行导入mysql
```

初始化了数据库后，为了有数据展示，我们提供了一个简易的[京东爬虫程序](https://gitee.com/running-cat/tacomall-springboot/tree/master/_doc/jd)用于初始化数据库数据

6. 修改数据库配置

在每个接口模块项目中（src/main/resources/application-dev.yml）修改相应的数据库配置。

7. 运行服务

接口有多个模块，彼此相互独立，我们只需要像普通springboot项目一样启动。

## 测试

看到这里，我们认为你已经正确配置启动项目了，接下来你将通过postman看到实际效果。

```
http://localhost:4000/portal/member/wxMalogin
```

##部署

我们提供了docker容器化部署方案，详情请查看[部署](https://gitee.com/running-cat/tacomall-springboot/blob/master/LICENSE)，但并不意味着你不得不选择docker部署，你仍然可以自由选择你喜欢的部署方式进行部署。

## 使用的框架

项目中使用到以下框架（不限于）

| 框架             | 说明                                                         |
| -------------------- | ------------------------------------------------------------ |
| springboot        | 提供web服务功能 |
| mybatis-plus    | 提供简化的数据库操作接口      |
| dynamic-datasource-spring-boot-starter    | 多数据源解决方案      |
| springfox-swagger2    | 接口文档      |
| weixin-java-miniapp   | 小程序sdk      |

## 版本控制

每个版本的发布我们将在[RELEASE.md](https://gitee.com/running-cat/tacomall-springboot/blob/master/RELEASE.md)记录跟踪。

项目在[Apache License 2.0](https://gitee.com/running-cat/tacomall-springboot/blob/master/LICENSE)下自由使用。

Yzi/tacomall-springboot

简介

发行版

贡献者

近期动态

Yzi/tacomall-springboot .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

Yzi/tacomall-springboot