商城

<p> <a href="#公众号"><img src="https://yellow-cdn.veclightyear.com/835a84d5/7e1cdeb0-ecdf-4054-9f17-7facc1ec86a0.svg" alt="公众号"></a> <a href="#公众号"><img src="https://yellow-cdn.veclightyear.com/835a84d5/c13f67c3-eb8f-4d87-a680-49a3ed1b45c0.svg" alt="交流"></a> <a href="https://github.com/macrozheng/mall-learning"><img src="https://yellow-cdn.veclightyear.com/835a84d5/a9798f0d-eed4-48e7-a8b5-7433d913daa7.svg" alt="学习教程"></a> <a href="https://github.com/macrozheng/mall-swarm"><img src="https://yellow-cdn.veclightyear.com/835a84d5/17cfc8f6-e0e5-4525-b6a2-f455099ad372.svg" alt="SpringCloud版本"></a> <a href="https://github.com/macrozheng/mall-admin-web"><img src="https://yellow-cdn.veclightyear.com/835a84d5/41d916ed-b764-4645-910c-d02b2b1ace6b.svg" alt="后台管理系统"></a> <a href="https://github.com/macrozheng/mall-app-web"><img src="https://yellow-cdn.veclightyear.com/835a84d5/71c5da99-77aa-467b-87f3-c9fa734c164e.svg" alt="前台商城项目"></a> <a href="https://gitee.com/macrozheng/mall"><img src="https://yellow-cdn.veclightyear.com/835a84d5/72627233-a987-4cb9-806f-67ae6a1ed7c3.svg" alt="码云"></a> </p>

友情提示

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

前言

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
Swagger-UI	API文档生成工具	https://github.com/swagger-api/swagger-ui
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	MongoDB客户端连接工具	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	1.8	https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.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 许可证 2.0

版权所有 (c) 2018-2024 macrozheng