联盟订单退货、退款与收益撤销闭环

flowchart TD
  A["平台订单 API 返回新状态或新金额"] --> B["平台同步服务标准化单条订单"]
  B --> C["统一状态策略"]
  C --> D["订单事务：行锁 + upsert + 乱序保护"]
  D --> E{"发生什么变化？"}
  E -- "确认取消/全额退款" --> F["订单 CANCELLED"]
  E -- "退款中/金额减少" --> G["订单 FROZEN"]
  E -- "退款驳回/撤回" --> H["订单 COMPLETED"]
  F --> I["全部关联佣金失效"]
  I --> J{"佣金资金阶段"}
  J -- "PENDING" --> K["扣回 pending 钱包"]
  J -- "AVAILABLE/PAID" --> L["追偿风控记录 + 阻断提现"]
  F --> M["释放活动券预占，顺延后续合格订单"]
  G --> N["冻结仍为 PENDING 的佣金"]
  G --> O["已释放收益进入人工复核"]
  H --> P["恢复此前冻结的佣金并解除退款复核"]
      

sequenceDiagram
  participant P as 平台 API
  participant S as 平台同步服务
  participant O as AffiliateOrderRepository
  participant R as 退款与部分退款服务
  participant W as WalletRepository
  participant C as 券/活动权益
  participant K as 风控与提现
  participant A as App
  S->>P: 按时间窗分页查询订单
  P-->>S: 一页原始订单记录
  loop 每条记录独立处理
    S->>O: 标准化订单并 upsert
    O-->>R: 发布取消、退款或金额减少事件
    alt 确认退款，佣金仍 PENDING
      R->>W: 幂等撤销 pending 钱包
      R->>C: 释放活动预占/恢复券额度
    else 确认退款，佣金 AVAILABLE/PAID
      R->>K: 创建追偿事件并阻断提现
    else 部分退款或退款处理中
      R->>W: 冻结未释放佣金
      R->>K: 标记复核
    else 退款驳回或撤回
      R->>W: 恢复此前冻结佣金
      R->>K: 解除复核
    end
  end
  A->>O: 查询订单列表/详情
  O-->>A: reviewing / cancelled / pending / returned