速卖通全托管

# 前言
本文主要针对速卖通全托管基础信息，在线商品，商品发布三大模块进行业务的梳理
api：https://open.aliexpress.com/doc/api.htm?spm=a2o9m.11193531.0.0.118f4bd6fo3Adx#/api?cid=3&path=/document/test/{name}&methodType=GET
其中在调用平台接口的时候需要传入公共参数channel、channel_seller_id等
授权后通

## 一、基础信息
### - 业务线
刊登商品前的准备工作，发布前的数据支撑，跟其他平台业务逻辑类似。主要分为分类、分类属性、分类品牌、服务模板、运费模板等基础数据。其中分类、分类属性是走的异步消息模式进行同步，品牌开发了异步消息但是线上目前使用的是直接通过fegin调用获取。由于文档结构比较混乱这里，接口可能不是很好找。这里将列出接口在文档的位置
#### 1. 分类信息
文档接口在`AE类目`下
aliexpress.category.redefining.getpostcategorybyid &emsp;  通过传入分类id查询指定分类
aliexpress.category.tree.list  &emsp;  获取类目数据
获取到类目数据后通过isLeaf判断是否有子节点，如果有子节点则继续递归调用接口获取类目，获取到所有类目树后组装成功每个父节点为根节点的类目树推送至广州服务
分类信息未向PHP提供入口，是通过定时程序每晚8点执行丢入消息队列

#### 2. 类目属性
使用接口`AE类目`下
根据发布类目id、父属性路径（可选）获取子属性信息，只返回有权限品牌
aliexpress.category.redefining.getchildattributesresultbypostcateidandpath

`车型库：`该接口会返回车型库数据以及品牌数据，字段`features`为 `AE_FEATURE_car_cascade_property`就代表车型库数据，车型库数据非常多，总层级能达到6级左右。这里由于速卖通获取过车型库数据可以公用，这里就过滤去掉了车型库数据。

`品牌数据：`通过返回的数据判断attr_id为2的就代表是品牌数据。这里单独过滤出品牌数据推送到广州服务

`分类属性：`需要递归调用，通过字段`has_sub_attr `判断是否存在子属性，除开车型库属性，目前最多只有3级属性

分类属性信息未向PHP提供入口，是通过定时程序每晚8点执行丢入消息队列

#### 3. 品牌
同上面属性接口一样，attr_id为2代表品牌，这里在做品牌的时候先是做了一份异步消息推送方式的接口，后来又做了一套通过接口直调fegin的方式调用。

#### 4. 其他接口
欧盟负责人列表、类目资质列表、运费模板列表、尺码模板列表等都是通过直调方式进行fegin调用
尺码模板列表  &emsp;  `AE-商品`下aliexpress.offer.redefining.getsizetemplatesbycategoryid
运费模板列表  &emsp;  `AE-运费` 下  aliexpress.freight.redefining.listfreighttemplate
类目资质列表  &emsp;  `AE-类目` 下  aliexpress.category.qualifications.list
欧盟负责人列表  &emsp; `AE-类目` 下  aliexpress.category.eu.responsible.persons.list

### - 代码线
#### 1.简介
速卖通全托管开发，mps-aliexpress-choice-meta（香港端）和mdc-aliexpress-choice-meta(广州端),其中香港端主要调用接口获取数据并组装香港端服务需要的数据格式，推送到广州端，广州端接收到后存入到erp数据库，供前端页面展示的数据
#### 2.设计模式
全托管主要使用到的设计模式为 策略模式、每个接口调用平台使用自己的策略方式进行调用。通过新建对应接口的handler继承AbstractHandleProcess，重写handle()和typeEnum()方法，handle()方法中组装调用当前接口的参数信息，typeEnum()中返回当前接口的enum。需要提前在TypeEnum类中配置接口的地址，接口描述信息，接口的请求方式等。

#### 3.涉及项目
mdc-oapi-product（提供外部调用程序入口）（广州）
mdc-aliexpress-choice-product（erp数据处理服务，香港服务中转）(广州）
mdc-open-api-information （消息基础服务入口）(香港）
mps-aliexpress-choice-meta （基础信息服务）（香港）
mps-product-allproducer（定时任务总控程序）（定时同步）（香港）
mabang-push-message（推送中间程序）（香港）
mabang-receive-message（推送中间程序）（广州)

#### 4.具体流程
消息异步：由定时器  mps-product-allproducer 每晚8点向分类消息队列中丢入一条消息
mps-aliexpress-choice-meta 消费者监听到消息后，开始进行消费，拉取到所有分类消息，循环每个分类并向分类属性队列中丢入消息，开始获取分类属性数据，数据获取之后组装成广州端需要的数据格式推送至广州服务mdc-aliexpress-choice-product，广州消费者在监听到消息后开始消费，拿到香港端传过来的数据后，对erp 基础表的信息进行新增、更新，删除等操作。

fegin直调：PHP调用mdc-oapi-product接口，mdc-oapi-product 调用mdc-aliexpress-choice-product 提供的feign接口，在通过http的方式调用mdc-open-api-information 香港基础服务的入口，由mdc-open-api-information中的fegin调用mps-aliexpress-choice-meta 获取到数据进行返回。

#### 5.表设计

## 二、刊登
### - 业务线
基础数据准备好后进入到刊登流程，刊登前出了准备好上面的基础信息外还需要准备好图片信息，在刊登的时候需要把图片连接替换成速卖通服务器的图片，一切准备好后进行商品发布，商品发布成功后，有点商品还需绑定车型数据
#### 1. 图片上传
接口使用的是`AE-图片银行`下的aliexpress.photobank.redefining.uploadimageforsdk接口
在刊登前需要对multimedia参数中的图片进行上传替换

#### 2. 商品刊登
接口使用的是`AE-全托管-商品` 下的 aliexpress.choice.product.post 接口，
选择类目和品牌->设置服务模板->设置运费模板->尺码模板->上传详情中的图片->上传其他图片->发布商品->设置车型数据
#### 3. 批量更新商品绑定车型信息
接口在`AE-商品`下 aliexpress.carmodel.update.product.carInfo
该接口可以批量的绑定或者解绑商品的车型数据，如果新增则在对应的add_af_ids 中传入车型的adid，删除则在delete_af_ids中传入，本项目中绑定车型的数据是通过用户在前端页面下载车型模板后选择对应的车型传入到我们中台。看刊登成功后就行商品车型的绑定或解绑

### - 代码线
#### 1.简介
刊登流程是由用户在页面填好刊登数据后，通过php组装好数据存入到erp 刊登表中。中台通过广州服务mdc-aliexpress-choice-product组装好数据调用香港端mps-aliexpress-choice-product服务，进行刊登数据的处理（描述处理、图片处理等）调用平台接口刊登。
#### 2.设计模式
mps-aliexpress-choice-product  香港端刊登服务也是采用策略模式，通过在TypeEnum类中增加刊登对应的PUBLISH_PRODUCT 枚举类进行刊登接口地址、调用方式的配置。
新建PublishProductHandler 类作为刊登接口的策略类，通过在公用入参ChoiceSdkDto中组装好刊登参数，传入对应刊登结果的class返回值，handle(ChoiceSdkDto choiceSdkDto, Class<T> clazz)完成刊登接口的调用。其他接口也是使用这种方式设计，好处是不用去关心调用平台以及返回结果的处理，每个接口只需要新建自己的handler继承AbstractHandleProcess类，配置好对应的接口参数就行。其他不用管，专注于业务的处理

#### 3.涉及项目
mdc-oapi-product（提供外部调用程序入口）（广州）
mdc-aliexpress-choice-product（erp数据处理服务，香港服务中转）(广州）
mdc-open-api-publish （香港刊登入口）(香港）
mps-aliexpress-choice-product （刊登服务）（香港）
mabang-push-message（推送中间程序）（香港）
mabang-receive-message（推送中间程序）（广州)

#### 4.具体流程
- 由php存入刊登数据到erp刊登表中同时调用我们的广州端刊登入口mdc-oapi-product，
- 在入口服务里面发送消息到mdc-aliexpress-choice-product队列中
- 监听到消息后查询erp刊登数据组装成中台服务需要的参数格式通过http调用mdc-open-api-publish 的刊登接口
- mdc-open-api-publish收到请求后开始解析数据，并存入数据库，返回存库的任务id到mdc-aliexpress-choice-product服务，并实时发送消息到刊登中台服务mps-aliexpress-choice-product
- mdc-aliexpress-choice-product服务在收到http的返回信息任务id时更新erp任务表。
- mps-aliexpress-choice-product服务收到刊登消息后通过任务id从中台表查询任务信息。并对任务数据进行解析转换成平台需要的格式，处理数据中图片、描述等信息。
- 调用平台接口进行刊登。刊登成功或失败后进行中台任务表的更新。同时推送任务结果到广州服务mdc-aliexpress-choice-product
- mdc-aliexpress-choice-product收到任务结果信息后。解析结果，并把结果更新到erp任务表中
- 同步商品详情.

## 三、在线商品
### - 业务线
#### 1. 同步商品列表
接口使用的是`全托管商品`下的aliexpress.choice.products.list接口
进行店铺商品列表拉取

#### 2. 同步商品详情
接口使用的是`全托管商品`下的aliexpress.choice.product.query接口
进行商品详情同步

#### 3. 同步商品JIT库存
接口使用的是`全托管商品`下的aliexpress.choice.product.stocks.query接口
进行商品库存同步

#### 4. 查询商品绑定的车型信息
接口使用的是`全托管商品`下的aliexpress.carmodel.findListByProductId接口
获取商品车型库

### - 代码线
#### 1.简介
用户在页面上点击店铺同步或同步单个商品。PHP调用`oapi`接口进入`mdc-aliexpress-choice-product`项目。然后进入`ChoiceApiShopPublicConsumer`调用调度中心`mdc-open-api-product`服务的同步全托管店铺或商品详情接口。最后进入`mps-aliexpress-choice-product`项目消费者`ChoiceShopProductConsumer`进行消费

#### 2.涉及项目
mdc-oapi-product（提供外部调用程序入口）（广州）
mdc-aliexpress-choice-product（erp数据处理服务，香港服务中转）(广州）
mdc-open-api-product （香港同步入口）(香港）
mps-aliexpress-choice-product （刊登服务）（香港）
mabang-push-message（推送中间程序）（香港）
mabang-receive-message（推送中间程序）（广州)

#### 3.流程
- 由php同时调用我们的广州端同步店铺入口mdc-oapi-product，
- 在入口服务里面发送消息到mdc-aliexpress-choice-product队列中
- 监听到消息后通过http调用mdc-open-api-product 的同步接口
- mdc-open-api-product收到请求后开始解析数据，并实时发送消息到刊登中台服务mps-aliexpress-choice-product
- mps-aliexpress-choice-product开始优先拉取店铺列表
- 店铺列表拉取完毕以后生成对应的excel全量文件和分批次往下发商品详情Topic
- 在商品详情消费者里进行了获取商品详情，库存，车型库等数据后回传给mdc-aliexpress-choice-product服务进行落库
- mdc-aliexpress-choice-product收到商品信息后。解析结果，并把结果更新到erp商品表中，同时更新ES索引

#### 4.注意
mdc-aliexpress-choice-product服务中iapi是接收mdc-oapi-product接口过来的消息, oapi是接收香港调度中心那边过来的消息