记浅析开源电商框架《flamingo-commerce》

简介

框架旨在构建电商系统的完整解决实现，通过DDD领域驱动设计，将抽象出来的具体领域模型实现，在核心域的基础上采用的六边形的设计思想，通过端口与适配器，实现灵活多变的电商架构体系

初识

开源地址：https://github.com/i-love-flamingo/flamingo-commerce

首先我们看看效果
官方示例：https://demoshop.flamingo.me
我部署的示例：http://www.itfan.top:3210
尝试自己部署
提供了DEMO，地址：https://github.com/i-love-flamingo/commerce-demo-carotene
我部署的过程（略显坎坷）
1. 踩过的坑：
  1. 首先我使用阿里云服务器（国内节点），搭建环境，包括golang、nodejs（当前最新版）；部署的过程中发现版本不兼容，回退go（v1.13.6）、node（v12.16.3）
  2. 报错 Get https://accounts.google.com/.well-known/openid-configuration: dial tcp 172.217.27.141:443: i/o timeout 这里发现oauth认证使用的是google，我是国内的节点，无法访问，只能vpn解决了，借了mac，上了vpn一顿环境搭建，最后发现还是 timeout
  3. MAC部署，一样超时，浏览器访问google认证正常，查阅资料有说是google的秘钥认证失败后也不会给结果，同样是超时效果，然后去配了自己的秘钥，还是超时。最后发现mac终端是不走这个代理的，用了各种办法，无果；
  4. 直接上国外的节点，我的是香港的节点，20分钟搞定
  5. 总结，网络问题，奔溃
  6. 下列指令来自remark:
```
# clone the repo:
git clone https://github.com/i-love-flamingo/commerce-demo-      carotene.git
cd commerce-demo-carotene
# Download the test catalog  - you only need to do it once - it includes             products.csv and images:
make download-product-data
# Prepare translation files:
make translation
# Build the flamingo-carotene bases templates:
make frontend-build
# Run flamingo with flamingo-commerce
make serve 
```
整体架构
进入正题，项目采用前后端分离，各司其职，后端是基于commerce，
commerce集成各个模块（模块边界采用DDD领域驱动设计思想），每个模块又基于flamingo框架进行具体的设计开发，系统间的交互采用了六边形的架构思想，通过端口与适配器达到一个可插拔的灵活性；首先我们看下flamingo框架做了什么事；

Flamingo框架特性

这里官网提供了demo 地址：git clone git@github.com:i-love-flamingo/example-helloworld.git
依赖注入（Dingo）：用在端口 + 适配器、扩展点，上下文的准确映射

injector.Bind().To();
config：配置信息的读取、解析、映射封装
even：事件的出发与监听
session：支持多种存储（通过配置中心注入）

image.png
Healthcheck：系统指标监控
router：路由规则（支持配置 + 代码）

image.png

image.png
cache：响应数据、基础数据缓存

image.png
template：数据对view渲染，该框架集成了bug，通过

image.png

image.png
SSO：支持单点登录

image.png
security：提供了功能权限、CSRF
Logger trace ：日志最终
form ->controller : 通过将数据封装到FormHandlerFactory注入到控制层获取数据
GraphQL ：自动生成，映射数据库，提供数据操作；

flamingo-commerce模块简绍

1.png

项目采用DDD(领域驱动设计)的设计思想，将整个电商业务领域分析和建模，划分为各个子领域，再将各个子域分层处理，提供了一套完整的默认电商实现

下面我们具体分析DDD在项目中如何落地的

整个电商系统是一个领域，项目业务将这整个领域细分为产品子域、客户子域、价格子域、订单子域、付款子域、结账子域、交货子域等，通过分析边界，定义了各个子域的界限上下文，通过分析与建模将各个子域领域模型抽象出来，通过DDD的分层思想，将各个领域服务分层
下面具体看下car项目的分层

image.png

application：包含了购物车的缓存、获取、修改操作，主要协调组织了业务的流程，当前模块与其模块比如：consumerService、userService进行一个交互

domain：主要提现业务的概念、状态、规则，包含以下内容
实体：Car；值对象：Address；聚合：Delivery；工厂：DeliveryInfoBuilder；
car：其中包含了觉和信息，如Car（// Cart Value Object (immutable data - because the cartservice is responsible to return a cart).）是一个值对象，其中包含了对送货的操作、对购物车的操作、对总价计算操作，
属性 + 行为

infrastructure：提供了基于内存的购物车管理、email的集成
这里可以重代码中看到框架的灵活

   func (m *Module) Inject(routerRegistry *web.RouterRegistry,config *struct {
    UseInMemoryCart bool `inject:"config:commerce.cart.useInMemoryCartServiceAdapters,optional"`
    EnableCartCache bool `inject:"config:commerce.cart.enableCartCache,optional"`
    UseEmailAdapter bool `inject:"config:commerce.cart.useEmailPlaceOrderAdapter,optional"`
},) {
m.routerRegistry = routerRegistry
if config != nil {
    m.useInMemoryCart = config.UseInMemoryCart
    m.enableCartCache = config.EnableCartCache
    m.useEmailAdapter = config.UseEmailAdapter
}
    if m.useInMemoryCart {
    injector.Bind((*infrastructure.CartStorage)(nil)).To(infrastructure.InMemoryCartStorage{}).AsEagerSingleton()
    injector.Bind((*infrastructure.GiftCardHandler)(nil)).To(infrastructure.DefaultGiftCardHandler{})
    injector.Bind((*infrastructure.VoucherHandler)(nil)).To(infrastructure.DefaultVoucherHandler{})
    injector.Bind((*cart.GuestCartService)(nil)).To(infrastructure.InMemoryGuestCartService{})
    injector.Bind((*cart.CustomerCartService)(nil)).To(infrastructure.InMemoryCustomerCartService{})
}

配置指定，通过依赖注入到容器，这里主要就是系统提了默认的数据存储方式，里面是数据的一个存储细节比如增、删、改、查

interfaces：通过Form将请求数据封装，Controller接收后获取数据，并渲染前端页面；
主要的逻辑：
1. 从*web.Request 中获取数据等一系列操作，底层看框架提供了通用的方法
func (p *DeliveryFormService) GetFormData(ctx context.Context, req *web.Request) (interface{}, error)
2. 注入service，并调用相应业务
controller：func (cc *CartViewController) Inject(
applicationCartService *application.CartService,
applicationCartReceiverService *application.CartReceiverService,
3. 在grgraphQL中提供查询统计方法
func (cs CartSummary) SumGrandTotalWithGiftCards() *domain.Price {
sum, err := cs.cart.SumGrandTotalWithGiftCards()
if err != nil {
return nil
}
return &sum
}

总结，通过清晰的领域定义，我们可以很清晰的看到购物车模块的设计与每一层的作用，体会到DDD设计的可测试、可维护性、灵活性、可扩展性

在项目中六边形架构是如何落地实现的

首先总结六边形架构的优点
优点：使用六边形架构开发的软件与通道独立，因此能支持多通道
易于置换入站和出站整合点
测试软件变得更简单，因为可以很容易地模拟集成点
通俗讲，该架构就是为了处理系统交互的，通过内部开通单端口，外部实现端口的适配器进行交互，这样我的核心服务不需要变动，可以支持多种协议或组件，做到灵活可插拔性，同时也为测试提供了方便
在项目中的实现
cartServicePorts提供了端口，其中包括GuestCartService、CustomerCartService、ModifyBehaviour、、、等系列端口
我们就拿GuestCartService端口来说，

image.png

这里是定义的一些借口方法，外部实现这些方法通过adapter，
看下系统如何实现的

image.png

通过Adaptter 实现了对数据的内存储
总结上面的实现：这里很清晰的感觉到，模块不会关心你的数据是如何存储的，我给你开了端口，你去实现，如何存储是外部的时，这样就可以兼容通道

总结

这里我主要介绍了项目的几个点，基础框架依赖flamingo，flamingo提供了通用域的实现比如配置、依赖注入、安全、缓存与前前端的一个模板渲染，在此基础上项目只需要关心业务，整个项目采用DDD（领域驱动设计）的架构思想，完成领域的拆分，各个模块依赖降到最低，通过对模块的分层，将各个层的职责单一化；同时结合六边形架构，解耦了模块间的依赖，通过端口 + 适配器的模式，实现多通道、多协议的支持，使项目扩展性更加强