Mastering mall-swarm: Build a Spring Cloud Microservice E‑Commerce System

mall-swarm is the Spring Cloud version of the mall project, now updated with permission management. The code stays up‑to‑date, merging from mall periodically. This article introduces the basics and learning path of mall-swarm .

mall-swarm Introduction

mall-swarm

is a microservice e‑commerce system built with Spring Cloud Greenwich, Spring Boot 2, MyBatis, Docker, Elasticsearch, and provides a Vue‑based admin UI. It integrates registration, configuration, monitoring, and gateway services.

System Architecture Diagram

Backend Technology Stack

Technology

Description

Spring Cloud

Microservice framework

Spring Boot

Container + MVC framework

Spring Security

Authentication and authorization framework

MyBatis

ORM framework

MyBatisGenerator

Data layer code generator

PageHelper

MyBatis pagination plugin

Swagger-UI

API documentation tool

Elasticsearch

Search engine

RabbitMq

Message queue

Redis

Distributed cache

MongoDb

NoSQL database

Docker

Application container engine

Druid

Database connection pool

OSS

Object storage

MinIO

Object storage

JWT

JWT login support

LogStash

Log collection

Lombok

Code simplification tool

Seata

Global transaction management framework

Portainer

Docker container visual management

Jenkins

Automated deployment tool

Project Structure

<code>mall
├── mall-common -- utility and common code module
├── mall-mbg -- MyBatisGenerator generated data access module
├── mall-security -- Spring Security + JWT authentication module
├── mall-registry -- Eureka based service registry
├── mall-config -- Spring Cloud Config based configuration center
├── mall-gateway -- Spring Cloud Gateway API gateway service
├── mall-monitor -- Spring Boot Admin based monitoring center
├── mall-admin -- Backend admin system service
├── mall-search -- Elasticsearch based product search service
├── mall-portal -- Mobile portal service
└── mall-demo -- Remote call test service
</code>

Learning Roadmap

A friend asked whether there is a tutorial for mall-swarm . Its functionality is essentially the same as the mall project, but converted to a microservice version. You can follow the "mall tutorial" and the "Spring Cloud tutorial" to get started.

Learning mall

The "mall tutorial" is divided into the following parts; the recommended order is to follow the sequence below, except for the reference section which can be consulted as needed.

Preface: overall architecture and feature overview of

mall

, plus recommended books for beginners.

Architecture: step‑by‑step guide to building the basic project skeleton used by

mall

.

Business: e‑commerce business tutorials of the

mall

project.

Technical Highlights: analysis of key technologies and their usage in the project.

Deployment: deployment tutorials for Windows, Linux, and automated solutions.

Reference: introductory tutorials for each technology and tool used in

mall

, each of which can be studied independently.

Project address: https://github.com/macrozheng/mall-learning

Learning Spring Cloud

The "Spring Cloud tutorial" covers most core components, including Spring Cloud Alibaba and Seata distributed transactions, based on Spring Cloud Greenwich and Spring Boot 2.1.7. It contains 20 articles, 30 demos, and covers most application scenarios used in

mall-swarm

.

Project address: https://github.com/macrozheng/springcloud-learning

Learning mall-swarm

After completing the "mall" and "Spring Cloud" tutorials, you can start learning

mall-swarm

. First run the project as described in the previous tutorials, then study the source code. Below are deployment guides for

mall-swarm

:

mall-swarm deployment on Windows: https://mp.weixin.qq.com/s?__biz=MzU1Nzg4NjgyMw==∣=2247484223&idx=1&sn=9089a6db7274c1c6b8b81710bcab88f3&scene=21#wechat_redirect

mall-swarm deployment on Linux (Docker based): https://mp.weixin.qq.com/s?__biz=MzU1Nzg4NjgyMw==∣=2247484228&idx=2&sn=8dc7a65079995645696507bb2e33cfa1&scene=21#wechat_redirect

Automated deployment under microservice architecture using Jenkins: https://mp.weixin.qq.com/s?__biz=MzU1Nzg4NjgyMw==∣=2247484277&idx=1&sn=baad346ec83fd81780b632fc48db336e&scene=21#wechat_redirect

Project address: https://github.com/macrozheng/mall-swarm

Integrating Frontend Project

Many users connect the

mall-admin-web

frontend with

mall-swarm

. Since

mall-swarm

uses Spring Cloud Gateway as the gateway service, all frontend requests must go through the gateway. See the article "Front‑back separation project, Spring Cloud Gateway issue" for details.

Frontend project address: https://github.com/macrozheng/mall-admin-web

Project Address

https://github.com/macrozheng/mall-swarm

Recommended Reading

127.0.0.1 vs 0.0.0.0 address differences

Two clever ways to handle validation in SpringBoot

Internet buzzwords collection

Spring Boot + Vue: building C/S architecture applications

Handy tools I use

Tomcat high‑risk vulnerability alert

Product SKU design and optimization

Step‑by‑step permission management with Vue dynamic menus

GitHub 25K+ stars: SpringBoot e‑commerce project mall goes Spring Cloud

My GitHub open‑source journey from 0 to 20K stars

Welcome to follow and like