134 lines
6.8 KiB
Markdown
134 lines
6.8 KiB
Markdown
# mall
|
||
|
||
## 前言
|
||
|
||
`mall`项目致力于打造一个完整的电商系统，采用现阶段流行技术实现。
|
||
|
||
## 项目介绍
|
||
|
||
`mall`项目是一套电商系统，包括前台商城系统及后台管理系统，基于SpringBoot+MyBatis实现。
|
||
前台商城系统包含用户中心、会员成长、优惠券、积分、运营推广、内容推荐、商品展示、订单流程、订单管理、售后及服务等模块。
|
||
后台管理系统包含商品、订单、用户、促销、运营、内容、统计、财务、设置、权限等管理系统模块。
|
||
|
||
### 项目演示
|
||
|
||
> 后台管理系统
|
||
|
||
- 前端项目`mall-admin-web`地址：https://github.com/macrozheng/mall-admin-web
|
||
- [后台管理系统功能演示.gif](document/resource/mall-admin.gif)
|
||
|
||
### 组织结构
|
||
|
||
``` lua
|
||
mall
|
||
├── mall-mbg -- MyBatisGenerator生成的数据库操作代码
|
||
├── mall-admin -- 后台商城管理系统
|
||
├── mall-search -- 基于Elasticsearch的商品搜索系统
|
||
├── mall-portal -- 前台商城系统
|
||
└── mall-demo -- 框架搭建时的测试代码
|
||
```
|
||
|
||
### 技术选型
|
||
|
||
#### 后端技术
|
||
|
||
技术 | 说明 | 官网
|
||
----|----|----
|
||
Spring Boot | 容器+MVC框架 | [https://spring.io/projects/spring-boot](https://spring.io/projects/spring-boot)
|
||
Spring Security | 认证和授权框架 | [https://spring.io/projects/spring-security](https://spring.io/projects/spring-security)
|
||
MyBatis | ORM框架 | [http://www.mybatis.org/mybatis-3/zh/index.html](http://www.mybatis.org/mybatis-3/zh/index.html)
|
||
MyBatisGenerator | 数据层代码生成 | [http://www.mybatis.org/generator/index.html](http://www.mybatis.org/generator/index.html)
|
||
PageHelper | MyBatis物理分页插件 | [http://git.oschina.net/free/Mybatis_PageHelper](http://git.oschina.net/free/Mybatis_PageHelper)
|
||
Swagger-UI | 文档生产工具 | [https://github.com/swagger-api/swagger-ui](https://github.com/swagger-api/swagger-ui)
|
||
Hibernator-Validator | 验证框架 | [http://hibernate.org/validator/](http://hibernate.org/validator/)
|
||
Elasticsearch | 搜索引擎 | [https://github.com/elastic/elasticsearch](https://github.com/elastic/elasticsearch)
|
||
RabbitMq | 消息队列 | [https://www.rabbitmq.com/](https://www.rabbitmq.com/)
|
||
Redis | 分布式缓存 | [https://redis.io/](https://redis.io/)
|
||
MongoDb | NoSql数据库 | [https://www.mongodb.com/](https://www.mongodb.com/)
|
||
Docker | 应用容器引擎 | [https://www.docker.com/](https://www.docker.com/)
|
||
Druid | 数据库连接池 | [https://github.com/alibaba/druid](https://github.com/alibaba/druid)
|
||
OSS | 对象存储 | [https://github.com/aliyun/aliyun-oss-java-sdk](https://github.com/aliyun/aliyun-oss-java-sdk)
|
||
JWT | JTW登录支持 | [https://github.com/jwtk/jjwt](https://github.com/jwtk/jjwt)
|
||
LogStash | 日志收集 | [https://github.com/logstash/logstash-logback-encoder](https://github.com/logstash/logstash-logback-encoder)
|
||
Lombok | 简化对象封装工具 | [https://github.com/rzwitserloot/lombok](https://github.com/rzwitserloot/lombok)
|
||
|
||
#### 前端技术
|
||
|
||
技术 | 说明 | 官网
|
||
----|----|----
|
||
Vue | 前端框架 | [https://vuejs.org/](https://vuejs.org/)
|
||
Vue-router | 路由框架 | [https://router.vuejs.org/](https://router.vuejs.org/)
|
||
Vuex | 全局状态管理框架 | [https://vuex.vuejs.org/](https://vuex.vuejs.org/)
|
||
Element | 前端UI框架 | [https://element.eleme.io/](https://element.eleme.io/)
|
||
Axios | 前端HTTP框架 | [https://github.com/axios/axios](https://github.com/axios/axios)
|
||
v-charts | 基于Echarts的图表框架 | [https://v-charts.js.org/](https://v-charts.js.org/)
|
||
Js-cookie | cookie管理工具 | [https://github.com/js-cookie/js-cookie](https://github.com/js-cookie/js-cookie)
|
||
nprogress | 进度条控件 | [https://github.com/rstacruz/nprogress](https://github.com/rstacruz/nprogress)
|
||
|
||
#### 架构图
|
||
|
||
#### 模块介绍
|
||
|
||
##### 后台管理系统 `mall-admin`
|
||
|
||
- 商品管理：[功能结构图-商品.jpg](document/resource/mind_product.jpg)
|
||
- 订单管理：[功能结构图-订单.jpg](document/resource/mind_order.jpg)
|
||
- 促销管理：[功能结构图-促销.jpg](document/resource/mind_sale.jpg)
|
||
- 内容管理：[功能结构图-内容.jpg](document/resource/mind_content.jpg)
|
||
- 用户管理：[功能结构图-用户.jpg](document/resource/mind_member.jpg)
|
||
|
||
##### 前台商城系统 `mall-portal`
|
||
|
||
[功能结构图-前台.jpg](document/resource/mind_portal.jpg)
|
||
|
||
## 环境搭建
|
||
|
||
### 开发工具
|
||
|
||
工具 | 说明 | 官网
|
||
----|----|----
|
||
IDEA | 开发IDE | https://www.jetbrains.com/idea/download
|
||
RedisDesktop | redis客户端连接工具 | https://redisdesktop.com/download
|
||
Robomongo | mongo客户端连接工具 | https://robomongo.org/download
|
||
SwitchHosts| 本地host管理 | https://oldj.github.io/SwitchHosts/
|
||
X-shell | Linux远程连接工具 | http://www.netsarang.com/download/software.html
|
||
Navicat | 数据库连接工具 | http://www.formysql.com/xiazai.html
|
||
PowerDesigner | 数据库设计工具 | http://powerdesigner.de/
|
||
Axure | 原型设计工具 | https://www.axure.com/
|
||
MindMaster | 思维导图设计工具 | http://www.edrawsoft.cn/mindmaster
|
||
ScreenToGif | gif录制工具 | https://www.screentogif.com/
|
||
|
||
### 开发环境
|
||
|
||
工具 | 版本号 | 下载
|
||
----|----|----
|
||
JDK | 1.8 | https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
|
||
Mysql | 5.7 | https://www.mysql.com/
|
||
Redis | 3.2 | https://redis.io/download
|
||
Elasticsearch | 2.4 | https://www.elastic.co/downloads
|
||
MongoDb | 3.2 | https://www.mongodb.com/download-center
|
||
RabbitMq | 5.25 | http://www.rabbitmq.com/download.html
|
||
nginx | 1.10 | http://nginx.org/en/download.html
|
||
|
||
### 搭建步骤
|
||
|
||
> 本地环境搭建
|
||
|
||
- 本地安装开发环境中的所有工具并启动，采用默认配置即可;
|
||
- 克隆源代码到本地，使用IDEA打开，并完成编译;
|
||
- 在mysql中新建mall数据库，导入document/sql下的mall.sql文件；
|
||
- 启动mall-admin项目：直接运行com.macro.mall.MallAdminApplication即可，
|
||
接口文档地址：http://localhost:8080/swagger-ui.html;
|
||
- 启动mall-search项目：直接运行com.macro.mall.search.MallSearchApplication即可，
|
||
接口文档地址：http://localhost:8081/swagger-ui.html;
|
||
- 启动mall-portal项目：直接运行com.macro.mall.portal.MallPortalApplication即可，
|
||
接口文档地址：http://localhost:8085/swagger-ui.html;
|
||
- 克隆`mall-admin-web`项目，并导入到IDEA中并完成编译，[mall-admin-web](https://github.com/macrozheng/mall-admin-web);
|
||
- 运行命令：npm run dev,访问地址：[http://localhost:8090](http://localhost:8090) 即可打开后台管理系统页面。
|
||
|
||
> docker环境部署
|
||
|
||
- 安装CenterOs7.2在VirtualBox虚拟机中；
|
||
- 配置本地host:参考[host.txt](document/docker/host.txt),将ip地址改为虚拟机的ip地址;
|
||
- 使用maven构建`mall-admin`、`mall-search`、`mall-portal`的docker镜像，参考[docker.md](document/docker/docker.md)中的使用maven构建Docker镜像；
|
||
- 参考[docker-deploy.md](document/docker/docker-deploy.md)进行部署。 |