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, собрать mall-admin-web в IDEA) или через Docker на Linux, включая руководства по 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