junhong_cmp_fiber/docs/feature-001-order-operator-and-chain-commission-semantics/手工验收清单.md

手工验收清单

一、平台订单操作者展示

• 创建或查询一条历史平台订单，确认响应中的 operator_name 不再为空。
• 确认该订单的 operator_type=platform，且操作者名称优先来自 creator 对应后台账号。
• 确认 seller_shop_name 与 operator_name 语义分离，不再混用店铺名代替平台账号名。

二、多级代理链差价佣金

• 准备一条 seller_shop_id 存在完整父级链的订单。
• 执行佣金任务后，确认各级代理按父级链逐级生成差价佣金记录。
• 确认订单 commission_status=2、commission_result=1。
• 确认相关代理钱包流水与佣金记录金额一致。

三、无佣金完成态

• 准备一条顶级代理订单或无正差价订单。
• 执行佣金任务后，确认不产生正金额佣金记录。
• 确认订单不会继续停留在待计算，而是落为 commission_status=2、commission_result=2。

四、链路异常待人工处理

• 准备一条上级链断裂、系列配置缺失或套餐分配缺失的订单。
• 执行佣金任务后，确认生成 status=99 的待人工修正佣金记录。
• 确认备注中包含链路断点信息。
• 确认订单落为 commission_status=3、commission_result=3。

五、入队与幂等

• 钱包支付创建订单后，确认差价佣金任务会自动入队。
• 重复触发支付回调或重复调用钱包支付时，确认不会重复入队。
• 对已经完成或待人工处理的订单重复执行佣金任务，确认 worker 会直接跳过。

六、历史兼容读取

• 抽查至少一条历史平台订单，确认 creator 能兜底回填操作者名称。
• 抽查至少一条历史代理订单，确认新字段为空时仍可读出兼容操作者展示。
• 确认历史订单不会把旧 operator_id 误当成新的账号 ID 再写回数据库。