macrozheng / mall-swarm
mall-swarm是一套微服务商城系统,采用了 Spring Cloud Alibaba、Spring Boot 3.2、Sa-Token、MyBatis、Elasticsearch、Docker、Kubernetes等核心技术,同时提供了基于Vue的管理后台方便快速搭建系统。mall-swarm在电商业务的基础集成了注册中心、配置中心、监控中心、网关等系统功能。
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing macrozheng/mall-swarm in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Repository Summary (README)
Previewmall-swarm
<p> <a href="#公众号"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%85%AC%E4%BC%97%E5%8F%B7-macrozheng-blue.svg" alt="公众号"></a> <a href="#公众号"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E4%BA%A4%E6%B5%81-%E5%BE%AE%E4%BF%A1%E7%BE%A4-2BA245.svg" alt="交流"></a> <a href="https://github.com/macrozheng/mall-learning"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%AD%A6%E4%B9%A0%E6%95%99%E7%A8%8B-mall--learning-green.svg" alt="学习教程"></a> <a href="https://github.com/macrozheng/mall"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%90%8E%E5%8F%B0%E9%A1%B9%E7%9B%AE-mall-blue.svg" alt="后台项目"></a> <a href="https://github.com/macrozheng/mall-admin-web"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%89%8D%E7%AB%AF%E9%A1%B9%E7%9B%AE-mall--admin--web-green.svg" alt="前端项目"></a> <a href="https://github.com/macrozheng/mall-app-web"><img src="https://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%89%8D%E5%8F%B0%E5%95%86%E5%9F%8E%E9%A1%B9%E7%9B%AE-mall--app--web-green.svg" alt="前台商城项目"></a> <a href="https://gitee.com/macrozheng/mall-swarm"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E7%A0%81%E4%BA%91-%E9%A1%B9%E7%9B%AE%E5%9C%B0%E5%9D%80-orange.svg" alt="码云"></a> </p>友情提示
- 快速体验项目:在线访问地址 。
- 全套学习教程:《mall-swarm微服务学习教程》 。
- 视频教程(2024最新版):《mall-swarm视频教程》 。
- Spring Cloud全套教程:《SpringCloud学习教程》 。
- 分支说明:
master分支基于Spring Cloud 2023+Spring Boot 3.2,dev-v2分支基于Spring Cloud 2021+Spring Boot 2.7。
项目简介
mall-swarm是一套微服务商城系统,采用了 Spring Cloud 2023 & Alibaba、Spring Boot 3.2、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 -- 配置中心存储的配置
技术选型
后端技术
前端技术
| 技术 | 说明 | 官网 |
|---|---|---|
| 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 |
搭建步骤
- Windows环境搭建请参考:mall-swarm项目后端开发环境搭建;
mall-admin-web项目的安装及部署请参考:mall-swarm前端开发环境搭建;
运行效果展示
- 查看注册中心注册服务信息,访问地址:http://192.168.3.101:8848/nacos/

- 监控中心应用信息,访问地址:http://192.168.3.101:8101


- API文档信息,访问地址:http://192.168.3.101:8201

- 日志收集系统信息,访问地址:http://192.168.3.101:5601

- 使用Kubernetes部署后项目运行状态,访问地址:http://192.168.3.101:30880


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

许可证
Copyright (c) 2018-2025 macrozheng