## MODIFIED Requirements

### Requirement: 创建套餐购买订单

系统 SHALL 允许买家创建套餐购买订单。订单类型分为单卡购买和设备购买。创建前 MUST 验证购买权限和强充要求。**后台订单接口 MUST 支持 `payment_method` 字段（wallet/offline），根据支付方式自动设置 `is_purchase_on_behalf` 标识**。

**支付方式和订单类型映射**：
- `payment_method = "wallet"`：扣买家钱包，`is_purchase_on_behalf = false`（普通订单）
- `payment_method = "offline"`：线下已收款，`is_purchase_on_behalf = true`（代购订单）

**权限规则**：
- `wallet` 支付：代理、平台、超级管理员可使用
- `offline` 支付：仅平台、超级管理员可使用

#### Scenario: 个人客户创建单卡订单
- **WHEN** 个人客户为自己的卡创建订单，选择一个套餐
- **THEN** 系统创建订单，状态为待支付，is_purchase_on_behalf = false，返回订单信息

#### Scenario: 个人客户创建设备订单
- **WHEN** 个人客户为自己的设备创建订单
- **THEN** 系统创建订单，订单类型为设备购买，is_purchase_on_behalf = false

#### Scenario: 代理创建普通订单（钱包支付）
- **WHEN** 代理为店铺关联的卡/设备创建订单，payment_method = "wallet"
- **THEN** 系统创建订单，买家类型为代理商，买家ID为店铺ID，is_purchase_on_behalf = false，payment_status = 1（待支付）

#### Scenario: 平台创建代购订单（线下支付）
- **WHEN** 平台账号为代理的卡/设备创建订单，payment_method = "offline"
- **THEN** 系统创建订单，is_purchase_on_behalf = true，payment_method = "offline"，payment_status = 2（已支付），直接激活套餐

#### Scenario: 代理尝试使用线下支付
- **WHEN** 代理账号创建订单，payment_method = "offline"
- **THEN** 系统返回错误 "只有平台可以使用线下支付"

#### Scenario: 平台使用钱包支付
- **WHEN** 平台账号创建订单，payment_method = "wallet"，指定目标代理
- **THEN** 系统创建普通订单，扣目标代理钱包，is_purchase_on_behalf = false

#### Scenario: 套餐购买验证强充要求
- **WHEN** 个人客户创建订单，存在强充要求，订单金额低于强充金额
- **THEN** 系统返回错误 "支付金额不符合强充要求"

#### Scenario: 套餐不在可购买范围
- **WHEN** 买家尝试购买不在关联系列下的套餐
- **THEN** 系统返回错误 "该套餐不在可购买范围内"

#### Scenario: 套餐已下架
- **WHEN** 买家尝试购买已下架的套餐
- **THEN** 系统返回错误 "该套餐已下架"

---

## ADDED Requirements

### Requirement: 后台订单 payment_method 字段

后台订单创建接口 MUST 支持 `payment_method` 字段，值为 `wallet` 或 `offline`。系统 SHALL 根据 payment_method 自动设置 is_purchase_on_behalf 标识。

#### Scenario: payment_method 为 wallet
- **WHEN** 创建订单时 payment_method = "wallet"
- **THEN** 系统设置 is_purchase_on_behalf = false，payment_status = 1（待支付）

#### Scenario: payment_method 为 offline
- **WHEN** 创建订单时 payment_method = "offline"
- **THEN** 系统设置 is_purchase_on_behalf = true，payment_status = 2（已支付），paid_at = 当前时间

#### Scenario: payment_method 验证
- **WHEN** 创建订单时 payment_method 为无效值
- **THEN** 系统返回参数验证错误

---

### Requirement: 代购订单成本价计算

线下支付（代购订单）MUST 使用买家的成本价，钱包支付（普通订单）使用卖家的成本价。

#### Scenario: 线下支付使用买家成本价
- **WHEN** 平台创建线下支付订单，目标卡归属于代理 A，代理 A 的系列分配成本价为 100 元
- **THEN** 订单总金额为 100 元（买家成本价）

#### Scenario: 钱包支付使用卖家成本价
- **WHEN** 代理 A 为自己的卡创建钱包支付订单，代理 A 的上级代理 B 的系列分配成本价为 120 元
- **THEN** 订单总金额为 120 元（卖家成本价）

---

### Requirement: 代购订单不触发佣金和累计充值

代购订单（is_purchase_on_behalf = true）SHALL 计算差价佣金，MUST NOT 触发一次性佣金，MUST NOT 更新累计充值。

#### Scenario: 代购订单计算差价佣金
- **WHEN** 代购订单支付成功，买家成本价 100 元，套餐建议成本价 80 元
- **THEN** 系统计算差价佣金 20 元，分配给上级代理

#### Scenario: 代购订单不触发一次性佣金
- **WHEN** 代购订单支付成功，符合一次性佣金触发条件
- **THEN** 系统 MUST NOT 触发一次性佣金

#### Scenario: 代购订单不更新累计充值
- **WHEN** 代购订单支付成功
- **THEN** 系统 MUST NOT 更新卡/设备的 accumulated_recharge 字段

---

## REMOVED Requirements

### Requirement: 独立的代购订单接口

**❌ REMOVED** - 此 requirement 已废弃

**原内容**: 系统提供独立的代购订单创建接口 `POST /api/admin/orders/purchase-on-behalf`

**Reason**: 代购订单本质是线下支付的订单，不应独立处理。统一使用 `POST /api/admin/orders` 接口，通过 `payment_method` 字段区分。

**Migration**:
- 删除 `CreatePurchaseOnBehalfRequest` DTO
- 使用 `CreateOrderRequest` 替代，增加 `payment_method` 字段
- 前端调用统一接口，传递 `payment_method = "offline"` 创建代购订单
