mall README

The project's README from github.com/macrozheng/mall. As one markdown file: README.md.

mall

公众号 交流 学习教程 SpringCloud版本 后台管理系统 前台商城项目 码云

友情提示

  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
前台商城系统 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环境部署

Docker环境部署

相关环境部署

公众号

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

公众号图片

许可证

Apache License 2.0

Copyright (c) 2018-2026 macrozheng

mall (macrozheng/mall)

Searching Database…

84.9K ·GitHub
Mall
这是什么？Mall 是一个完整的电商系统，包含前台商城（mall-portal）和后台管理（mall-admin），基于 Spring Boot 和 MyBatis 构建，旨在作为网上购物的完整参考实现。
这是一个整体的应用，还是前后端分开的项目？它是分开的多个代码仓库：本仓库是后端（Java/Spring Boot），另外配套的前端项目有 mall-admin-web（Vue，后台管理界面）和 mall-app-web（Vue/uni-app，移动端商城）。
我该如何把它跑起来？你可以在 Windows 上部署（安装 MySQL/Redis，在 IDEA 中构建 mall-admin-web），也可以在 Linux 上通过 Docker 部署，相关指南包括 Docker Compose 和基于 Jenkins 的自动化部署。
除了 Java 应用本身，它还需要哪些基础设施？开发环境包括 JDK 17、MySQL 5.7、Redis 7.0、MongoDB 5.0、RabbitMQ 3.10.5、Nginx，日志方面则使用 ELK 技术栈（Elasticsearch、Logstash、Kibana）。
我可以只运行其中一部分吗，比如只运行后台管理模块？可以。如果只启动 mall-admin，你只需安装 MySQL 和 Redis，无需部署完整的 Elasticsearch/MongoDB/RabbitMQ/ELK 技术栈。
这个项目面向哪些人？它面向学习或开发电商系统的 Java 开发者，作者在代码之外还提供了完整的图文和视频教程。
这个项目有微服务版本吗？有。macrozheng 还维护着 mall-swarm，这是基于 Spring Cloud Alibaba 构建的微服务版本。
后台管理包含哪些模块？包括商品、订单、会员、促销、运营、内容管理、统计报表、财务和权限管理等模块。
移动端/网页商城有哪些功能？包括首页门户、商品推荐、搜索、商品展示、购物车、下单流程、会员中心，以及客服与帮助中心。
我可以不安装任何东西就先试用吗？README 中提供了在线演示的链接，可以在搭建本地环境之前快速体验。
What are similar projects?mall-swarm, spring-boot-examples, SpringBoot-Labs, yudao-cloud, newbee-mall, mall-learning, SpringAll, JeecgBoot
Which topics is it in?swagger-ui, springcloud, spring-security, e-commerce, rabbitmq, mybatis, springboot, spring-cloud, spring, spring-boot, elasticsearch, jwt
Creator
macrozheng
Size
57.4 MB
Stars
84.9K
Updated
CommitSep 15Releasev1.0.3Mar 01
Age
8y
Commits · 90 Days