How macrozheng/mall-swarm works
识别项目类型和目的
• 这是一个基于 Spring Cloud 2023 + Alibaba 微服务架构的电商平台(mall-swarm),包含注册中心、配置中心、API 网关、监控中心、认证中心和若干业务微服务(admin、portal、search、auth、monitor、demo)。
• 主要面向“前台商城 + 后台管理 + 搜索 + 认证 + 监控”全链路电商场景。
文件结构分析
• 顶层 pom.xml:父工程聚合模块。
• config:Nacos 配置中心存储。
• mall-common:通用工具/公共 DTO、异常、Redis 服务等。
• mall-mbg:MyBatis Generator 生成的模型 & DAO。
• mall-auth:统一认证中心(Spring Security/OAuth2 + Sa-Token)。
• mall-gateway:Spring Cloud Gateway 实现的 API 网关。
• mall-monitor:基于 Spring Boot Admin 的监控中心。
• mall-admin:后台管理系统业务服务。
• mall-search:Elasticsearch 搜索服务。
• mall-portal:移动端/PC 端商城服务,包含 RabbitMQ、定时任务、支付、购物车、订单等。
• mall-demo:用于远程调用测试的示例服务。
README 中的架构洞察
• 系统架构图(document/resource/mall_micro_service_arch.jpg)展示了服务注册、配置、网关、各业务微服务、数据库、缓存、MQ、对象存储、ES、Logstash/Kibana 日志系统、容器编排等全景。
• 业务架构图(document/resource/re_mall_business_arch.jpg)展示了电商各业务边界。
画系统设计图的步骤
a. 划分主要组件
• 基础设施层:Nacos 注册 & 配置中心、Docker/Kubernetes、监控(Prometheus + Spring Boot Admin)、日志收集(Logstash + Kibana)。
• 网关层:API Gateway(mall-gateway),统一鉴权、路由、限流、CORS 等。
• 认证层:认证中心(mall-auth)。
• 公共模块:mall-common、mall-mbg(代码生成 & 公共 DTO/Mapper)。
• 业务微服务:mall-admin、mall-portal、mall-search、mall-demo。
• 监控层:mall-monitor。
• 外部依赖:MySQL、Redis、MongoDB、Elasticsearch、RabbitMQ、OSS/MinIO、Seata(分布式事务)、外部支付(支付宝)。
b. 组件之间的关系和交互
• 客户端(后台 Vue 管理系统 & 前台 uni-app/vue APP)→ API Gateway → 各业务微服务。
• Gateway 调用前先向 mall-auth 验证 Token(Sa-Token + OAuth2)。
• 业务微服务内部通过 Feign/Ribbon 调用、或通过 MQ(RabbitMQ)异步通信(如订单超时取消)。
• 微服务直接读写自己的数据库(MySQL)和缓存(Redis),mall-search 同步商品数据到 ES。
• 对象存储:mall-admin 和 mall-portal 使用 MinIO/OSS 上传与下载文件。
• 监控:所有微服务注册到 Spring Boot Admin(mall-monitor),日志通过 Logstash 发送到 ES/Kibana。
c. 重要架构模式与设计原则
• 微服务分层:注册中心 → 配置中心 → 网关 → 认证 → 业务服务 → 数据存储。
• API Gateway 模式 + 认证/授权聚合。
• 业务解耦:各服务独立部署,内部使用 Feign + Ribbon 调用。
• 异步消息驱动:RabbitMQ 处理订单回滚、超时取消等。
• 分布式事务(Seata,仅在必要场景)。
• 日志与监控:集中式日志收集 + 统一监控面板。
d. 关键技术栈标注
• Spring Cloud Alibaba(Nacos、Gateway、Sentinel 可选)、Spring Boot 3.2
• Sa-Token + OAuth2
• MyBatis + MBG + PageHelper
• Elasticsearch + Spring Data ES
• RabbitMQ
• Redis
• MongoDB
• Docker + Kubernetes
• Logstash + Kibana + Spring Boot Admin
针对全栈微服务电商的图表定制建议
• 强调各业务服务的依赖:搜索服务同步 ES,Portal 服务发送/接收 MQ,Admin 服务依赖公共模块和 MBG 模块。
• 将配置中心、注册中心、监控、日志等基础设施放在图的上方,共同指向所有微服务。
• 在 Kubernetes 部署视图中,可用 Pods/Services/Ingress 图示,或简化为容器图标 + 服务名称。
图示元素要求
• 每个组件都要有清晰标签(服务名 + 技术框架)。
• 使用有向箭头表示调用/依赖方向。
• 用颜色或形状区分:
• 灰色箱子:基础设施(Nacos、Docker/K8s、日志、监控)
• 蓝色:网关 & 认证
• 绿色:业务微服务
• 橙色:外部系统(DB、Cache、ES、MQ、OSS、第三方支付)
• 在组件旁标注交互协议(HTTP/REST、gRPC、Feign、AMQP)。
细节与深度
• 在网关与业务服务之间注明鉴权流程(网关 → auth → 返回 token 验证)。
• 在 Portal 服务框里,画出 RabbitMQ 交换机、队列、消费者(CancelOrderSender → CancelOrderReceiver)。
• 标注 Seata TC/AT 协议触发点(若使用分布式事务)。
• 在搜索管道中,画出“商品上架 → MySQL → 同步到 ES → 前端搜索”。
通过以上步骤和要点,即可产出一份涵盖注册中心、配置中心、网关、认证、业务服务、数据存储、消息队列、监控与日志等核心要素的详尽系统设计图。