{"id":13458834,"url":"https://github.com/macrozheng/mall-swarm","last_synced_at":"2025-05-15T00:05:56.169Z","repository":{"id":37678081,"uuid":"223881576","full_name":"macrozheng/mall-swarm","owner":"macrozheng","description":"mall-swarm是一套微服务商城系统，采用了 Spring Cloud Alibaba、Spring Boot 3.2、Sa-Token、MyBatis、Elasticsearch、Docker、Kubernetes等核心技术，同时提供了基于Vue的管理后台方便快速搭建系统。mall-swarm在电商业务的基础集成了注册中心、配置中心、监控中心、网关等系统功能。","archived":false,"fork":false,"pushed_at":"2025-04-18T06:20:59.000Z","size":54602,"stargazers_count":12313,"open_issues_count":9,"forks_count":5387,"subscribers_count":273,"default_branch":"master","last_synced_at":"2025-05-07T23:39:11.402Z","etag":null,"topics":["docker","elasticsearch","java","k8s","kubernetes","mongodb","mybatis","mysql","rabbitmq","redis","spring-boot","spring-cloud","springboot","springcloud"],"latest_commit_sha":null,"homepage":"https://cloud.macrozheng.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/macrozheng.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-11-25T06:55:31.000Z","updated_at":"2025-05-07T07:36:01.000Z","dependencies_parsed_at":"2023-02-01T17:32:36.771Z","dependency_job_id":"29163ddf-14f7-4858-a23a-1f9adac2083c","html_url":"https://github.com/macrozheng/mall-swarm","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macrozheng%2Fmall-swarm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macrozheng%2Fmall-swarm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macrozheng%2Fmall-swarm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macrozheng%2Fmall-swarm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/macrozheng","download_url":"https://codeload.github.com/macrozheng/mall-swarm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254249199,"owners_count":22039029,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","elasticsearch","java","k8s","kubernetes","mongodb","mybatis","mysql","rabbitmq","redis","spring-boot","spring-cloud","springboot","springcloud"],"created_at":"2024-07-31T09:00:58.005Z","updated_at":"2025-05-15T00:05:51.148Z","avatar_url":"https://github.com/macrozheng.png","language":"Java","funding_links":[],"categories":["Java","Practical Project","前端开发框架及项目","实战项目","Web Development"],"sub_categories":["Others","管理面板","SpringCloud项目","C++/C Toolkit"],"readme":"# mall-swarm\n\n\u003cp\u003e\n  \u003ca href=\"#公众号\"\u003e\u003cimg src=\"http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%85%AC%E4%BC%97%E5%8F%B7-macrozheng-blue.svg\" alt=\"公众号\"\u003e\u003c/a\u003e\n  \u003ca href=\"#公众号\"\u003e\u003cimg 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=\"交流\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/macrozheng/mall-learning\"\u003e\u003cimg 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=\"学习教程\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/macrozheng/mall\"\u003e\u003cimg 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=\"后台项目\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/macrozheng/mall-admin-web\"\u003e\u003cimg 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=\"前端项目\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/macrozheng/mall-app-web\"\u003e\u003cimg 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=\"前台商城项目\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://gitee.com/macrozheng/mall-swarm\"\u003e\u003cimg 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=\"码云\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## 友情提示\n\n\u003e 1. **快速体验项目**：[在线访问地址](https://cloud.macrozheng.com/admin/index.html) 。\n\u003e 2. **全套学习教程**：[《mall-swarm微服务学习教程》](https://cloud.macrozheng.com) 。\n\u003e 3. **视频教程（2024最新版）**：[《mall-swarm视频教程》](https://cloud.macrozheng.com/video/) 。\n\u003e 4. **Spring Cloud全套教程**：[《SpringCloud学习教程》](https://github.com/macrozheng/springcloud-learning) 。\n\u003e 5. **分支说明**：`master`分支基于Spring Cloud 2023+Spring Boot 3.2，`dev-v2`分支基于Spring Cloud 2021+Spring Boot 2.7。\n\n## 项目简介\n\n`mall-swarm`是一套微服务商城系统，采用了 Spring Cloud 2023 \u0026 Alibaba、Spring Boot 3.2、Sa-Token、MyBatis、Elasticsearch、Docker、Kubernetes等核心技术，同时提供了基于Vue的管理后台方便快速搭建系统。`mall-swarm`在电商业务的基础集成了注册中心、配置中心、监控中心、网关等系统功能。文档齐全，附带全套Spring Cloud教程。\n\n## 项目演示\n\n### 后台管理系统\n\n前端项目`mall-admin-web`地址：https://github.com/macrozheng/mall-admin-web\n\n项目演示地址： [https://www.macrozheng.com/admin/index.html](https://www.macrozheng.com/admin/index.html)\n\n![后台管理系统功能演示](./document/resource/mall_admin_show.png)\n\n### 前台商城系统\n\n前端项目`mall-app-web`地址：https://github.com/macrozheng/mall-app-web\n\n项目演示地址（将浏览器切换为手机模式效果更佳）：[https://www.macrozheng.com/app/](https://www.macrozheng.com/app/)\n\n![前台商城系统功能演示](./document/resource/re_mall_app_show.jpg)\n\n## 项目架构\n\n### 系统架构\n\n![系统架构图](./document/resource/mall_micro_service_arch.jpg)\n\n### 业务架构\n\n![业务架构图](./document/resource/re_mall_business_arch.jpg)\n\n### 组织结构\n\n``` lua\nmall\n├── mall-common -- 工具类及通用代码模块\n├── mall-mbg -- MyBatisGenerator生成的数据库操作代码模块\n├── mall-auth -- 基于Spring Security Oauth2的统一的认证中心\n├── mall-gateway -- 基于Spring Cloud Gateway的微服务API网关服务\n├── mall-monitor -- 基于Spring Boot Admin的微服务监控中心\n├── mall-admin -- 后台管理系统服务\n├── mall-search -- 基于Elasticsearch的商品搜索系统服务\n├── mall-portal -- 移动端商城系统服务\n├── mall-demo -- 微服务远程调用测试服务\n└── config -- 配置中心存储的配置\n```\n\n## 技术选型\n\n### 后端技术\n\n| 技术                   | 说明                 | 官网                                                 |\n| ---------------------- | -------------------- | ---------------------------------------------------- |\n| Spring Cloud           | 微服务框架           | https://spring.io/projects/spring-cloud              |\n| Spring Cloud Alibaba   | 微服务框架           | https://github.com/alibaba/spring-cloud-alibaba      |\n| Spring Boot            | 容器+MVC框架         | https://spring.io/projects/spring-boot               |\n| Sa-Token               | 认证和授权框架       | https://github.com/dromara/Sa-Token                   |\n| MyBatis                | ORM框架              | http://www.mybatis.org/mybatis-3/zh/index.html       |\n| MyBatisGenerator       | 数据层代码生成       | http://www.mybatis.org/generator/index.html          |\n| PageHelper             | MyBatis物理分页插件  | http://git.oschina.net/free/Mybatis_PageHelper       |\n| Knife4j                | 文档生产工具         | https://github.com/xiaoymin/swagger-bootstrap-ui     |\n| Elasticsearch          | 搜索引擎             | https://github.com/elastic/elasticsearch             |\n| RabbitMq               | 消息队列             | https://www.rabbitmq.com/                            |\n| Redis                  | 分布式缓存           | https://redis.io/                                    |\n| MongoDb                | NoSql数据库          | https://www.mongodb.com/                             |\n| Docker                 | 应用容器引擎         | https://www.docker.com/                              |\n| Druid                  | 数据库连接池         | https://github.com/alibaba/druid                     |\n| OSS                    | 对象存储             | https://github.com/aliyun/aliyun-oss-java-sdk        |\n| MinIO                  | 对象存储             | https://github.com/minio/minio                       |\n| LogStash               | 日志收集             | https://github.com/logstash/logstash-logback-encoder |\n| Lombok                 | 简化对象封装工具     | https://github.com/rzwitserloot/lombok               |\n| Seata                  | 全局事务管理框架     | https://github.com/seata/seata                       |\n| Portainer              | 可视化Docker容器管理 | https://github.com/portainer/portainer               |\n| Jenkins                | 自动化部署工具       | https://github.com/jenkinsci/jenkins                 |\n| Kubernetes             | 应用容器管理平台     | https://kubernetes.io/                               |\n\n### 前端技术\n\n| 技术       | 说明                  | 官网                           |\n| ---------- | --------------------- | ------------------------------ |\n| Vue        | 前端框架              | https://vuejs.org/             |\n| Vue-router | 路由框架              | https://router.vuejs.org/      |\n| Vuex       | 全局状态管理框架      | https://vuex.vuejs.org/        |\n| Element    | 前端UI框架            | https://element.eleme.io/      |\n| Axios      | 前端HTTP框架          | https://github.com/axios/axios |\n| v-charts   | 基于Echarts的图表框架 | https://v-charts.js.org/       |\n\n### 移动端技术\n\n| 技术         | 说明             | 官网                                    |\n| ------------ | ---------------- | --------------------------------------- |\n| Vue          | 核心前端框架     | https://vuejs.org                       |\n| Vuex         | 全局状态管理框架 | https://vuex.vuejs.org                  |\n| uni-app      | 移动端前端框架   | https://uniapp.dcloud.io                |\n| mix-mall     | 电商项目模板     | https://ext.dcloud.net.cn/plugin?id=200 |\n| luch-request | HTTP请求框架     | https://github.com/lei-mu/luch-request  |\n\n## 环境搭建\n\n### 开发环境\n\n| 工具          | 版本号 | 下载                                                         |\n| ------------- | ------ | ------------------------------------------------------------ |\n| JDK           | 17     | https://www.oracle.com/cn/java/technologies/downloads/#java17 |\n| Mysql         | 5.7    | https://www.mysql.com/                                       |\n| Redis         | 7.0    | https://redis.io/download                                    |\n| Elasticsearch | 7.17.3 | https://www.elastic.co/cn/downloads/elasticsearch            |\n| Kibana        | 7.17.3 | https://www.elastic.co/cn/downloads/kibana                   |\n| Logstash      | 7.17.3 | https://www.elastic.co/cn/downloads/logstash                 |\n| MongoDb       | 5.0    | https://www.mongodb.com/download-center                      |\n| RabbitMq      | 3.10.5 | http://www.rabbitmq.com/download.html                        |\n| nginx         | 1.22   | http://nginx.org/en/download.html                            |\n\n### 搭建步骤\n\n- Windows环境搭建请参考：[mall-swarm项目后端开发环境搭建](https://cloud.macrozheng.com/start/mall_swarm_deploy_windows.html);\n- `mall-admin-web`项目的安装及部署请参考：[mall-swarm前端开发环境搭建](https://cloud.macrozheng.com/start/mall_swarm_deploy_windows_web.html);\n\n## 运行效果展示\n\n- 查看注册中心注册服务信息，访问地址：http://192.168.3.101:8848/nacos/\n\n![](./document/resource/re_mall_swarm_run_01.png)\n\n- 监控中心应用信息，访问地址：http://192.168.3.101:8101\n\n![](./document/resource/re_mall_swarm_run_02.png)\n\n![](./document/resource/re_mall_swarm_run_03.png)\n\n- API文档信息，访问地址：http://192.168.3.101:8201\n\n![](./document/resource/re_mall_swarm_run_04.png)\n\n- 日志收集系统信息，访问地址：http://192.168.3.101:5601\n\n![](./document/resource/re_mall_swarm_run_05.png)\n\n- 使用Kubernetes部署后项目运行状态，访问地址：http://192.168.3.101:30880\n\n![](document/resource/re_mall_swarm_run_06.png)\n\n![](document/resource/re_mall_swarm_run_07.png)\n\n## 公众号\n\n加微信群交流，关注公众号「**macrozheng**」，回复「**加群**」即可。\n\n![公众号图片](http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/banner/qrcode_for_macrozheng_258.jpg)\n\n## 许可证\n\n[Apache License 2.0](https://github.com/macrozheng/mall-swarm/blob/master/LICENSE)\n\nCopyright (c) 2018-2025 macrozheng","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacrozheng%2Fmall-swarm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmacrozheng%2Fmall-swarm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacrozheng%2Fmall-swarm/lists"}