mall-swarm README

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

mall-swarm

公众号 交流 学习教程 后台项目 前端项目 前台商城项目 码云

友情提示

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

项目简介

mall-swarm是一套微服务商城系统，采用了 Spring Cloud 2025 & Alibaba、Spring Boot 3.5、Sa-Token、MyBatis、Elasticsearch、Docker、Kubernetes等核心技术，同时提供了基于Vue的管理后台方便快速搭建系统。mall-swarm在电商业务的基础集成了注册中心、配置中心、监控中心、网关等系统功能。文档齐全，附带全套Spring Cloud教程。

项目演示

后台管理系统

前端项目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-auth -- 基于Spring Security Oauth2的统一的认证中心
├── mall-gateway -- 基于Spring Cloud Gateway的微服务API网关服务
├── mall-monitor -- 基于Spring Boot Admin的微服务监控中心
├── mall-admin -- 后台管理系统服务
├── mall-search -- 基于Elasticsearch的商品搜索系统服务
├── mall-portal -- 移动端商城系统服务
├── mall-demo -- 微服务远程调用测试服务
└── config -- 配置中心存储的配置

技术选型

后端技术

技术 说明 官网
Spring Cloud 微服务框架 https://spring.io/projects/spring-cloud
Spring Cloud Alibaba 微服务框架 https://github.com/alibaba/spring-cloud-alibaba
Spring Boot 容器+MVC框架 https://spring.io/projects/spring-boot
Sa-Token 认证和授权框架 https://github.com/dromara/Sa-Token
MyBatis ORM框架 http://www.mybatis.org/mybatis-3/zh/index.html
MyBatisGenerator 数据层代码生成 http://www.mybatis.org/generator/index.html
PageHelper MyBatis物理分页插件 http://git.oschina.net/free/Mybatis_PageHelper
Knife4j 文档生产工具 https://github.com/xiaoymin/swagger-bootstrap-ui
Elasticsearch 搜索引擎 https://github.com/elastic/elasticsearch
RabbitMq 消息队列 https://www.rabbitmq.com/
Redis 分布式缓存 https://redis.io/
MongoDb NoSql数据库 https://www.mongodb.com/
Docker 应用容器引擎 https://www.docker.com/
Druid 数据库连接池 https://github.com/alibaba/druid
OSS 对象存储 https://github.com/aliyun/aliyun-oss-java-sdk
MinIO 对象存储 https://github.com/minio/minio
LogStash 日志收集 https://github.com/logstash/logstash-logback-encoder
Lombok 简化对象封装工具 https://github.com/rzwitserloot/lombok
Seata 全局事务管理框架 https://github.com/seata/seata
Portainer 可视化Docker容器管理 https://github.com/portainer/portainer
Jenkins 自动化部署工具 https://github.com/jenkinsci/jenkins
Kubernetes 应用容器管理平台 https://kubernetes.io/

前端技术

技术 说明 官网
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/

移动端技术

技术 说明 官网
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

环境搭建

开发环境

工具 版本号 下载
JDK 17 https://www.oracle.com/cn/java/technologies/downloads/#java17
Mysql 5.7 https://www.mysql.com/
Redis 7.0 https://redis.io/download
Elasticsearch 7.17.3 https://www.elastic.co/cn/downloads/elasticsearch
Kibana 7.17.3 https://www.elastic.co/cn/downloads/kibana
Logstash 7.17.3 https://www.elastic.co/cn/downloads/logstash
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

搭建步骤

运行效果展示

公众号

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

公众号图片

许可证

Apache License 2.0

Copyright (c) 2018-2026 macrozheng

mall-swarm (macrozheng/mall-swarm)

Searching Database…

13.2K ·GitHub
Mall-swarm
Что это такое?mall-swarm — это платформа электронной коммерции на основе микросервисов, построенная на Spring Cloud и Spring Cloud Alibaba. В неё входят витрина, бэкенд для мобильного приложения и панель администратора, а также полный набор инфраструктуры: реестр сервисов, центр конфигурации, мониторинг и шлюз.
Это одно приложение или набор микросервисов?Это полноценная микросервисная архитектура, разбитая на отдельные сервисы (реестр, конфигурация, шлюз, бизнес-сервисы, мониторинг), а не одно монолитное приложение. Она рассчитана на оркестрацию через Docker или Kubernetes.
Как запустить бэкенд и фронтенд админки?Настройте окружение для разработки бэкенда по отдельному руководству проекта, а затем разверните отдельный проект фронтенда mall-admin-web по его собственному руководству.
Какая инфраструктура нужна перед запуском?Сначала нужно установить и настроить: JDK 17, MySQL 5.7, Redis 7.0, Elasticsearch/Kibana/Logstash 7.17.3, MongoDB 5.0, RabbitMQ 3.10.5 и nginx 1.22.
Какую ветку выбрать для нужной версии Spring Cloud?Ветка master работает на Spring Cloud 2025 и Spring Boot 3.5, а ветка dev-v2 предназначена для более старого стека Spring Cloud 2021 и Spring Boot 2.7. Выберите ветку, которая соответствует вашему окружению.
Для кого этот проект?Он рассчитан на разработчиков на Java и Spring, которые хотят изучить или создать систему электронной коммерции на микросервисах, пригодную для боевой эксплуатации. В комплекте есть полная документация и обучающие материалы.
Можно ли попробовать без установки?Да, в README есть ссылки на онлайн-демо витрины и бэкенда админки, включая вид магазина в мобильном режиме.
На каком фронтенд-стеке работают админка и витрина?Панель администратора (mall-admin-web) использует Vue, Vuex, Vue-router, Element UI и v-charts, а мобильная витрина построена на uni-app и Vuex поверх Vue.
Поддерживаются ли распределённые транзакции и объектное хранилище из коробки?Да, интегрирован Seata для управления глобальными транзакциями, поддерживаются OSS и MinIO для объектного хранилища, а также Druid для пула соединений.
Как устроены мониторинг и логирование?В стек входит центр мониторинга для проверки состояния сервисов. Для централизованного сбора логов используются Logstash, Elasticsearch и Kibana, а для визуального управления контейнерами Docker — Portainer.
What are similar projects?mall, newbee-mall, mall-learning, spring-boot-examples, yudao-cloud, JeecgBoot, vhr, SpringAll
Which topics is it in?springcloud, microservices-architecture, e-commerce, rabbitmq, mybatis, springboot, spring-cloud, vuex, gateway, k8s, nginx, registry
Creator
macrozheng
Size
53.3 MB
Stars
13.2K
Updated
CommitMay 21Releasev1.0.3Mar 01
Age
6y
Commits · 90 Days