## MODIFIED Requirements

### Requirement: 成本价差收入计算

系统 SHALL 为代理链上的每一级代理计算成本价差收入。差价佣金 MUST 从订单的 `seller_shop_id` 出发，沿完整父级链逐级计算；佣金归属 MUST NOT 由 `operator_id`、`operator_type` 或“一级/二级代理”特判决定。

#### Scenario: 单级代理
- **WHEN** 一级代理销售套餐，售价 100 元，成本价 80 元
- **THEN** 一级代理获得 20 元（100 - 80）成本价差收入

#### Scenario: 多级代理
- **WHEN** 三级代理销售套餐，售价 100 元，各级成本价为：平台 50 → 一级 60 → 二级 70 → 三级 80
- **THEN** 三级获得 20 元（100 - 80），二级获得 10 元（80 - 70），一级获得 10 元（70 - 60），平台获得 10 元（60 - 50）

#### Scenario: 平台代扣二级及以上代理
- **WHEN** 平台为任意非顶级代理创建并完成订单
- **THEN** 系统仍从该订单的 `seller_shop_id` 向上逐级计算差价佣金
- **AND** 只要上级链存在且存在有效价差，各级上级都获得对应佣金

#### Scenario: 顶级代理订单无上级
- **WHEN** 顶级代理完成订单，`seller_shop_id` 无父级链
- **THEN** 系统完成佣金计算流程
- **AND** 不创建上级差价佣金记录
- **AND** 该结果被标记为“无佣金”而非“待计算”

#### Scenario: 成本价相同
- **WHEN** 某级代理成本价等于下级成本价
- **THEN** 该级代理成本价差收入为 0，不创建佣金记录

---

### Requirement: 代购订单佣金计算规则

代购订单 SHALL 计算差价佣金，但不触发一次性佣金。差价佣金的计算对象 MUST 是买家所属卖方链路上的全部有效上级，而不是仅限最近一级。

#### Scenario: 代购订单计算差价佣金
- **WHEN** 代购订单（is_purchase_on_behalf = true）完成，买家有上级代理链
- **THEN** 系统按 `seller_shop_id` 的完整上级链计算差价佣金
- **AND** 将各级有效价差佣金分别发放给对应上级

#### Scenario: 代购订单不触发一次性佣金
- **WHEN** 代购订单完成，佣金计算时检查订单类型
- **THEN** 系统跳过一次性佣金判断逻辑，不发放一次性佣金

#### Scenario: 代购订单示例
- **WHEN** 平台为三级代理代购，订单金额 100 元（三级成本价），各级成本价：一级 60 → 二级 70 → 三级 80
- **THEN** 三级作为销售代理获得零售价差收入（如适用）
- **AND** 二级获得 10 元（80 - 70）差价佣金，一级获得 10 元（70 - 60）差价佣金
- **AND** 该订单不触发一次性佣金

## ADDED Requirements

### Requirement: 佣金计算结果落单

系统 SHALL 在佣金计算完成后，将订单落为明确的流程状态和业务结果，至少区分“有佣金”“无佣金”“链路异常待人工处理”。

#### Scenario: 计算完成且生成佣金记录
- **WHEN** 订单佣金计算成功，生成一条或多条佣金记录
- **THEN** 订单佣金流程状态为“已完成”
- **AND** 订单佣金业务结果为“有佣金”

#### Scenario: 计算完成但无佣金记录
- **WHEN** 订单佣金计算成功，但整条有效上级链上都没有正差价
- **THEN** 订单佣金流程状态为“已完成”
- **AND** 订单佣金业务结果为“无佣金”

#### Scenario: 上级链断裂
- **WHEN** 佣金计算过程中发现父级链、成本价配置或分配关系无法继续向上求解
- **THEN** 系统创建待人工处理的异常记录或备注
- **AND** 订单佣金流程状态为“待人工处理”
- **AND** 订单佣金业务结果为“链路异常”
