🎉 刚果商城，不一样的C端商城系统
官网地址：magestack.cn
体验地址：cmall.magestack.cn
刚果商城是个从零到一的C端商城项目，包含商城核心业务和基础架构两大模块。
参照商城系统原型，推出用户、消息、商品、订单、优惠券、支付、网关、购物车等业务模块，通过商城系统中复杂场景，给出对应解决方案。使用 DDD 模型开发系统功能，帮助对 DDD 一知半解的开发者树立正确地开发思路。
如果对开源感兴趣，可以关注马哥的中间件项目：动态线程池框架 Hippo4j。6.2kStar，43家企业使用。
有几位同学参与 Hippo4j 的贡献后，将这段经历写到了简历上，都拿了不错的大厂offer。
📚 能学到什么
刚果商城系统是我从事开发以来，在实际工作中遇到各种场景问题的“疑难杂症”汇总。
这些问题有些是自己遇到的，有些是其他人遇到帮忙解决的，最终把解决方案和代码实战放在刚果商城这个系统里。
这个系统没有很完整的商城业务，但是提供了偏架构层面有用的工具和参考，能帮助大家在实际项目中更好地解决问题。
如果你能够认真且坚持把项目看完，我相信你会收获包括不限于下面这些知识点：
-
基于 DDD 领域驱动模型设计实现的商品、购物车、订单、用户、消息以及支付服务。
-
掌握分布式锁、分布式事务、分布式搜索、分布式缓存、分布式限流以及分库分表等核心技术。
-
完成基础组件抽象，规约、缓存、幂等、分布式 ID、数据持久层、脱敏以及日志等底层组件库。
-
基于 Agent 开发字节码流量监控，监控项目接口 QPS、响应时间和异常请求等核心指标。
-
掌握常用设计模式实战场景，策略、责任链、装饰器、观察者以及适配器等设计模式。
🛒 拿个offer 组织项目
组织简介：拿个offer - 开源&项目实战，🚀 助力你在校招或社招上拿个offer。
目前组织下已支持业务、中间件等多种类型项目，项目列表如下：
| Project | Gitee | GitHub | Intro |
|---|---|---|---|
| 刚果商城 |  |
 |
企业级 TOC 商城，基于 DDD 领域驱动模型开发 |
| Hippo4j |  |
 |
异步线程池框架，支持线程池动态变更&监控&报警 |
| 12306 |  |
 |
完成高仿铁路 12306系统，帮助学生主打就业的项目 |
🤩 联系我
开源不易，右上角点个 Star 鼓励一下吧！
如果大家想要实时关注 CongoMall 更新的文章以及分享的干货的话，可以关注我的公众号。
使用过程中有任何问题，或者对项目有什么建议，关注公众号回复：加群，和 1000+ 志同道合的朋友交流讨论。
🔨 如何开始
刚果商城核心有两块，分别是商城业务和基础架构，通过认真学习分别可以收获以下两种能力提升。
-
商城业务：通过学习刚果商城中复杂业务处理场景，增加自己的复杂业务处理能力。
-
基础架构：尝试跟着基础架构部分自己把轮子都造一遍，以此提高自己方案设计和公共代码开发能力。
1）商城核心业务
目前 前端页面 正在开发中，暂时没有开源出来，所以大家需要通过接口请求访问。接口如何访问详细看下文。
- 初始化数据库，比如商品库、订单库、用户库、支付库、购物车库等；
- 通过 Docker 安装项目中依赖的中间件，比如 Nacos2、MySQL、Seata、RocketMQ 等；
- 学习接口调用流程，项目接口目前全量放入 Apifox 软件中，可通过在线访问；
- 查看不同微服务之间的依赖关系，并根据文档中的描述进行修改指定参数；
- 找到自己感兴趣的模块功能 Debug 源代码，参考代码设计。
2）基础架构
基础架构相关的代码都在 congomall-framework-all 模块中，可以通过官网查看如何实现，或者通过 视频教学 来学习如何开发基础架构代码。
👍 服务列表
刚果商城项目是马哥从零到一写出来的，当前已开发模块如下所述，没有完成的请耐心等待。
| 模块名称 | 服务名称 | 访问地址 | |
|---|---|---|---|
| 1 | congomall-message | 消息发送 eg：邮件、公众号、短信等 | http://localhost:8001 |
| 2 | congomall-customer-user | 用户服务 | http://localhost:8002 |
| 3 | congomall-gateway | 外部网关 | http://localhost:8003 |
| 4 | congomall-product | 商品服务 | http://localhost:8004 |
| 5 | congomall-product-job | 商品 Job 服务 | http://localhost:9001 |
| 6 | congomall-cart | 购物车服务 | http://localhost:8005 |
| 7 | congomall-order | 订单服务 | http://localhost:8006 |
| 8 | congomall-pay | 支付服务 | http://localhost:8007 |
| 9 | congomall-basic-data | 基础数据服务 | http://localhost:8008 |
| 10 | congomall-bff | 商城聚合层（BFF） | http://localhost:8009 |
🚅 接口请求
目前刚果商城已开发的接口已汇总至下述接口文档中，本地启动对应项目，通过接口文档访问查看效果。
https://www.apifox.cn/web/project/1038592/apis/api-50106328-run
如果需要通过 Apifox 直接调用，需要安装对应浏览器内网插件，这里把插件安装包装上，跟着教程安装即可使用。
安装文档：https://www.apifox.cn/help/app/web/browser-extension
🛡 模块介绍
刚果商城后端系统模块介绍如下所示。
├── congomall-basic-data || -- # 基础数据服务
│ ├── congomall-basic-data-application
│ ├── congomall-basic-data-domain
│ ├── congomall-basic-data-infrastructure
│ ├── congomall-basic-data-interface
├── congomall-bff || -- # 商城 BFF 聚合层
│ ├── congomall-bff-biz
│ ├── congomall-bff-remote
│ ├── congomall-bff-web
├── congomall-cart || -- # 购物车服务
│ ├── congomall-cart-application
│ ├── congomall-cart-domain
│ ├── congomall-cart-infrastructure
│ ├── congomall-cart-interface
├── congomall-coupon || -- # 优惠券服务
├── congomall-customer-user || -- # C端用户服务
│ ├── congomall-customer-user-application
│ ├── congomall-customer-user-domain
│ ├── congomall-customer-user-infrastructure
│ ├── congomall-customer-user-interface
│ ├── congomall-customer-user-mock
├── congomall-framework-all || -- # 基础组件
│ ├── congomall-base-spring-boot-starter || -- # 顶层抽象基础组件
│ ├── congomall-cache-spring-boot-starter || -- # 缓存组件
│ ├── congomall-common-spring-boot-starter || -- # 公共工具包组件
│ ├── congomall-convention-spring-boot-starter || -- # 项目规约组件
│ ├── congomall-database-spring-boot-starter || -- # 数据库持久层组件
│ ├── congomall-ddd-framework-core || -- # DDD抽象接口组件
│ ├── congomall-designpattern-spring-boot-starter || -- # 设计模式抽象组件
│ ├── congomall-distributedid-spring-boot-starter || -- # 分布式ID组件
│ ├── congomall-flow-monitor-agent || -- # 微服务流量监控组件
│ ├── congomall-httputil-spring-boot-starter || -- # Http网络调用组件
│ ├── congomall-idempotent-spring-boot-starter || -- # 分布式幂等组件
│ ├── congomall-log-spring-boot-starter || -- # 日志打印组件
│ ├── congomall-minio-spring-boot-starter || -- # 文件存储组件
│ ├── congomall-openfeign-spring-boot-starter || -- # 微服务调用组件
│ ├── congomall-rocketmq-spring-boot-starter || -- # 分布式消息队列组件
│ ├── congomall-sensitive-spring-boot-starter || -- # 前端返回数据脱敏组件
│ ├── congomall-swagger-spring-boot-starter || -- # 文档API组件
│ ├── congomall-web-spring-boot-starter || -- # Web组件
│ ├── congomall-xxljob-spring-boot-starter || -- # 定时任务组件
├── congomall-gateway || -- # 网关服务
├── congomall-message || -- # 消息服务
│ ├── congomall-message-application
│ ├── congomall-message-domain
│ ├── congomall-message-infrastructure
│ ├── congomall-message-interface
├── congomall-order || -- # 订单服务
│ ├── congomall-order-application
│ ├── congomall-order-domain
│ ├── congomall-order-infrastructure
│ ├── congomall-order-interface
├── congomall-pay || -- # 支付服务
│ ├── congomall-pay-application
│ ├── congomall-pay-domain
│ ├── congomall-pay-infrastructure
│ ├── congomall-pay-interface
├── congomall-product || -- # 商品服务
│ ├── congomall-product-application
│ ├── congomall-product-domain
│ ├── congomall-product-infrastructure
│ ├── congomall-product-interface
│ ├── congomall-product-job
├── congomall-test-all || -- # 测试用例
│ ├── congomall-flow-monitor-agent-test
│ ├── congomall-h2-test
│ ├── congomall-oom-test
│ ├── congomall-smooth-sharding-test
│ ├── congomall-yaml-test
├── dev-support || -- # 开发工具包📈 技术选型
当前暂时先梳理后端技术，前端开发后再行梳理。