淘客返利APP开发全流程：从需求分析到架构落地的技术决策

大家好，我是省赚客APP研发者阿可！省赚客APP（juwatech.cn）是一款聚合淘宝、京东、拼多多等平台的导购返利应用。本文将完整复盘其从0到1的开发流程，聚焦关键阶段的技术决策与代码实现，涵盖需求拆解、微服务划分、第三方对接、数据一致性保障及部署体系。

需求分析与核心功能建模

初期需求明确三大模块：

商品解析：支持淘口令、短链、H5链接自动识别并转为标准商品ID；
佣金计算：根据用户等级、活动规则动态计算返利金额；
订单跟踪：接收电商平台回调，幂等地发放佣金。

我们使用事件风暴方法识别出核心聚合根：User、Product、CommissionOrder，并定义领域事件如 ProductParsedEvent、CommissionGrantedEvent。

微服务架构划分

基于业务边界，拆分为四个独立服务：

product-parse-service：统一解析各平台商品链接；
rebate-calculation-service：返利策略引擎；
commission-service：佣金发放与记录；
callback-gateway：接收并验证第三方回调。

所有服务通过 Dubbo 3.0 进行 RPC 调用，注册中心使用 Nacos。

java 复制代码

// juwatech.cn.service.ProductParseService
@DubboService(version = "1.0")
public class ProductParseServiceImpl implements ProductParseService {
    @Override
    public ParsedProduct parse(String input) {
        if (input.contains("taobao.com")) {
            return taobaoParser.parse(input);
        } else if (input.contains("jd.com")) {
            return jdParser.parse(input);
        }
        throw new UnsupportedPlatformException();
    }
}

第三方平台对接：统一适配器模式

为屏蔽淘宝联盟、京东联盟、多多进宝 API 差异，设计 PlatformAdapter 接口：

java 复制代码

package juwatech.cn.platform;

public interface PlatformAdapter {
    String getPlatform();
    ParsedProduct fetchProductById(String itemId);
    boolean verifyCallbackSignature(Map<String, String> params, String sign);
}

@Component
public class TaobaoPlatformAdapter implements PlatformAdapter {
    @Override
    public String getPlatform() { return "TAOBAO"; }

    @Override
    public ParsedProduct fetchProductById(String itemId) {
        // 调用 taobao.tbk.item.info.get
        return taobaoOpenApiClient.call("taobao.tbk.item.info.get", params, TaobaoProduct.class);
    }

    @Override
    public boolean verifyCallbackSignature(Map<String, String> params, String sign) {
        return TaobaoSignUtil.verify(params, appSecret, sign);
    }
}

回调网关动态路由：

java 复制代码

@PostMapping("/callback/{platform}")
public ResponseEntity<String> handleCallback(@PathVariable String platform,
                                            @RequestBody Map<String, String> payload) {
    PlatformAdapter adapter = platformAdapterManager.getAdapter(platform);
    if (!adapter.verifyCallbackSignature(payload, payload.get("sign"))) {
        return ResponseEntity.status(403).body("Invalid signature");
    }
    callbackEventProducer.send(platform, payload); // 异步入队
    return ResponseEntity.ok("OK");
}

数据一致性：Saga 模式保障佣金发放

佣金发放涉及账户余额增加与记录插入，需跨服务事务。我们采用 Saga 模式 + 补偿机制：

java 复制代码

// juwatech.cn.service.CommissionService
@Transactional
public void grantCommission(Long userId, BigDecimal amount, String tradeId) {
    // 1. 创建待处理记录
    commissionRecordMapper.insertPending(tradeId, userId, amount);

    // 2. 调用账户服务
    try {
        accountService.credit(userId, amount, "返利入账");
    } catch (Exception e) {
        // 触发补偿：标记失败，后续由定时任务重试或人工介入
        commissionRecordMapper.markFailed(tradeId);
        throw new CommissionGrantException("Account credit failed", e);
    }

    // 3. 标记成功
    commissionRecordMapper.markSuccess(tradeId);
}

为防重复，前置加分布式锁（见前文拼多多锁设计）。

技术栈选型依据

语言/框架：Java 17 + Spring Boot 3.x，生态成熟，团队熟悉；
数据库：MySQL 8.0（InnoDB），主从读写分离，ShardingSphere 分库分表（按 user_id）；
缓存：Redis 7，用于商品缓存、分布式锁、限流计数；
消息队列：RabbitMQ，解耦回调处理与佣金发放；
搜索：Elasticsearch 8，支持高并发商品检索；
部署：Docker + Kubernetes，Harbor 镜像仓库，Prometheus + Grafana 监控。

CI/CD 流水线

GitLab CI 自动构建镜像并部署至测试环境：

yaml 复制代码

# .gitlab-ci.yml
stages:
  - build
  - deploy

build-image:
  stage: build
  script:
    - docker build -t harbor.juwatech.cn/micro/$CI_PROJECT_NAME:$CI_COMMIT_SHORT_SHA .
    - docker push harbor.juwatech.cn/micro/$CI_PROJECT_NAME:$CI_COMMIT_SHORT_SHA

deploy-to-staging:
  stage: deploy
  script:
    - sed "s/{{IMAGE_TAG}}/$CI_COMMIT_SHORT_SHA/g" k8s/deployment.yaml | kubectl apply -f -
  only:
    - develop

生产环境通过 Argo CD 实现 GitOps 声明式部署。

本文著作权归聚娃科技省赚客app开发者团队，转载请注明出处！