mall

友情提示

1. 快速体验项目：在线访问地址 。
2. 全套学习教程：《mall学习教程》 。
3. 视频教程：《mall视频教程》 。
4. 微服务版本：基于Spring Cloud Alibaba的项目：mall-swarm 。
5. 分支说明：master分支基于Spring Boot 3.5+JDK 17，dev-v2分支基于Spring Boot 2.7+JDK 8。

前言

mall项目致力于打造一个完整的电商系统，采用现阶段主流技术实现。

项目文档

文档地址：https://www.macrozheng.com

项目介绍

mall项目是一套电商系统，包括前台商城系统及后台管理系统，基于SpringBoot+MyBatis实现，采用Docker容器化部署。前台商城系统包含首页门户、商品推荐、商品搜索、商品展示、购物车、订单流程、会员中心、客户服务、帮助中心等模块。后台管理系统包含商品管理、订单管理、会员管理、促销管理、运营管理、内容管理、统计报表、财务管理、权限管理、设置等模块。

项目演示

后台管理系统

前端项目mall-admin-web地址：https://github.com/macrozheng/mall-admin-web

项目演示地址： https://www.macrozheng.com/admin/index.html

前台商城系统

前端项目mall-app-web地址：https://github.com/macrozheng/mall-app-web

项目演示地址（将浏览器切换为手机模式效果更佳）：https://www.macrozheng.com/app/

组织结构

mall
├── mall-common -- 工具类及通用代码
├── mall-mbg -- MyBatisGenerator生成的数据库操作代码
├── mall-security -- SpringSecurity封装公用模块
├── mall-admin -- 后台商城管理系统接口
├── mall-search -- 基于Elasticsearch的商品搜索系统
├── mall-portal -- 前台商城系统接口
└── mall-demo -- 框架搭建时的测试代码

技术选型

后端技术

技术	说明	官网
SpringBoot	Web应用开发框架	https://spring.io/projects/spring-boot
SpringSecurity	认证和授权框架	https://spring.io/projects/spring-security
MyBatis	ORM框架	http://www.mybatis.org/mybatis-3/zh/index.html
MyBatisGenerator	数据层代码生成器	http://www.mybatis.org/generator/index.html
Elasticsearch	搜索引擎	https://github.com/elastic/elasticsearch
RabbitMQ	消息队列	https://www.rabbitmq.com/
Redis	内存数据存储	https://redis.io/
MongoDB	NoSql数据库	https://www.mongodb.com
LogStash	日志收集工具	https://github.com/elastic/logstash
Kibana	日志可视化查看工具	https://github.com/elastic/kibana
Nginx	静态资源服务器	https://www.nginx.com/
Docker	应用容器引擎	https://www.docker.com
Jenkins	自动化部署工具	https://github.com/jenkinsci/jenkins
Druid	数据库连接池	https://github.com/alibaba/druid
OSS	对象存储	https://github.com/aliyun/aliyun-oss-java-sdk
MinIO	对象存储	https://github.com/minio/minio
JWT	JWT登录支持	https://github.com/jwtk/jjwt
Lombok	Java语言增强库	https://github.com/rzwitserloot/lombok
Hutool	Java工具类库	https://github.com/looly/hutool
PageHelper	MyBatis物理分页插件	http://git.oschina.net/free/Mybatis_PageHelper
SpringDoc	API文档生成工具	https://github.com/springdoc/springdoc-openapi
Hibernator-Validator	验证框架	http://hibernate.org/validator

前端技术

技术	说明	官网
Vue	前端框架	https://vuejs.org/
Vue-router	路由框架	https://router.vuejs.org/
Vuex	全局状态管理框架	https://vuex.vuejs.org/
Element	前端UI框架	https://element.eleme.io
Axios	前端HTTP框架	https://github.com/axios/axios
v-charts	基于Echarts的图表框架	https://v-charts.js.org/
Js-cookie	cookie管理工具	https://github.com/js-cookie/js-cookie
nprogress	进度条控件	https://github.com/rstacruz/nprogress

移动端技术

技术	说明	官网
Vue	核心前端框架	https://vuejs.org
Vuex	全局状态管理框架	https://vuex.vuejs.org
uni-app	移动端前端框架	https://uniapp.dcloud.io
mix-mall	电商项目模板	https://ext.dcloud.net.cn/plugin?id=200
luch-request	HTTP请求框架	https://github.com/lei-mu/luch-request

架构图

系统架构图

业务架构图

模块介绍

后台管理系统 mall-admin

• 商品管理：功能结构图-商品.jpg
• 订单管理：功能结构图-订单.jpg
• 促销管理：功能结构图-促销.jpg
• 内容管理：功能结构图-内容.jpg
• 用户管理：功能结构图-用户.jpg

前台商城系统 mall-portal

功能结构图-前台.jpg

开发进度

环境搭建

开发工具

工具	说明	官网
IDEA	开发IDE	https://www.jetbrains.com/idea/download
RedisDesktop	redis客户端连接工具	https://github.com/qishibo/AnotherRedisDesktopManager
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/
ProcessOn	流程图绘制工具	https://www.processon.com/
PicPick	图片处理工具	https://picpick.app/zh/
Snipaste	屏幕截图工具	https://www.snipaste.com/
Postman	API接口调试工具	https://www.postman.com/
Typora	Markdown编辑器	https://typora.io/

开发环境

工具	版本号	下载
JDK	17	https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html
MySQL	5.7	https://www.mysql.com/
Redis	7.0	https://redis.io/download
MongoDB	5.0	https://www.mongodb.com/download-center
RabbitMQ	3.10.5	http://www.rabbitmq.com/download.html
Nginx	1.22	http://nginx.org/en/download.html
Elasticsearch	7.17.3	https://www.elastic.co/downloads/elasticsearch
Logstash	7.17.3	https://www.elastic.co/cn/downloads/logstash
Kibana	7.17.3	https://www.elastic.co/cn/downloads/kibana

搭建步骤

Windows环境部署

• Windows环境搭建请参考：mall在Windows环境下的部署;
• 注意：如果只启动mall-admin模块，仅需安装MySQL、Redis即可;
• 克隆mall-admin-web项目，并导入到IDEA中完成编译：前端项目地址;
• mall-admin-web项目的安装及部署请参考：mall前端项目的安装与部署 。

Docker环境部署

• 使用虚拟机安装CentOS7.6请参考：虚拟机安装及使用Linux，看这一篇就够了;
• 本项目Docker镜像构建请参考：使用Maven插件为SpringBoot应用构建Docker镜像;
• 本项目在Docker容器下的部署请参考：mall在Linux环境下的部署（基于Docker容器）;
• 本项目使用Docker Compose请参考： mall在Linux环境下的部署（基于Docker Compose）;
• 本项目在Linux下的自动化部署请参考：mall在Linux环境下的自动化部署（基于Jenkins）;

相关环境部署

• ELK日志收集系统的搭建请参考：mall项目ELK日志收集解决方案;
• 使用MinIO存储文件请参考：使用MinIO实现文件存储;
• 读写分离解决方案请参考：你还在代码里做读写分离么，试试这个中间件吧;
• Redis集群解决方案请参考：Docker环境下秒建Redis集群 。

公众号

加微信群交流，关注公众号「macrozheng」，回复「加群」即可。

许可证

Apache License 2.0

Copyright (c) 2018-2026 macrozheng