文档

openspec/specs/order-management/spec.md

@@ -1,20 +1,46 @@
 ## ADDED Requirements
 
+### Requirement: 订单类型标识
+
+系统 SHALL 在订单模型中增加 is_purchase_on_behalf 字段，标识是否为代购订单。
+
+#### Scenario: 普通订单创建
+- **WHEN** 个人客户或代理为自己创建订单
+- **THEN** 系统设置 is_purchase_on_behalf = false
+
+#### Scenario: 代购订单创建
+- **WHEN** 平台或代理为其他代理创建代购订单
+- **THEN** 系统设置 is_purchase_on_behalf = true
+
+#### Scenario: 查询订单列表返回订单类型
+- **WHEN** 查询订单列表或详情
+- **THEN** 响应包含 is_purchase_on_behalf 字段
+
+---
+
 ### Requirement: 创建套餐购买订单
 
-系统 SHALL 允许买家创建套餐购买订单。订单类型分为单卡购买和设备购买。创建前 MUST 验证购买权限。
+系统 SHALL 允许买家创建套餐购买订单。订单类型分为单卡购买和设备购买。创建前 MUST 验证购买权限和强充要求。
 
 #### Scenario: 个人客户创建单卡订单
 - **WHEN** 个人客户为自己的卡创建订单，选择一个套餐
-- **THEN** 系统创建订单，状态为待支付，返回订单信息
+- **THEN** 系统创建订单，状态为待支付，is_purchase_on_behalf = false，返回订单信息
 
 #### Scenario: 个人客户创建设备订单
 - **WHEN** 个人客户为自己的设备创建订单
-- **THEN** 系统创建订单，订单类型为设备购买
+- **THEN** 系统创建订单，订单类型为设备购买，is_purchase_on_behalf = false
 
 #### Scenario: 代理创建订单
 - **WHEN** 代理为店铺关联的卡/设备创建订单
-- **THEN** 系统创建订单，买家类型为代理商，买家ID为店铺ID
+- **THEN** 系统创建订单，买家类型为代理商，买家ID为店铺ID，is_purchase_on_behalf = false
+
+#### Scenario: 平台创建代购订单
+- **WHEN** 平台账号为代理的卡/设备创建订单，支付方式选择 offline
+- **THEN** 系统创建订单，is_purchase_on_behalf = true，payment_method = "offline"，payment_status = 2（已支付）
+
+#### Scenario: 套餐购买验证强充要求
+- **WHEN** 个人客户创建订单，存在强充要求，订单金额低于强充金额
+- **THEN** 系统返回错误 "支付金额不符合强充要求"
 
 #### Scenario: 套餐不在可购买范围
 - **WHEN** 买家尝试购买不在关联系列下的套餐
@@ -28,7 +54,7 @@
 
 ### Requirement: 查询订单列表
 
-系统 SHALL 提供订单列表查询，支持按支付状态、订单类型、时间范围筛选。
+系统 SHALL 提供订单列表查询，支持按支付状态、订单类型、是否代购筛选。
 
 #### Scenario: 个人客户查询自己的订单
 - **WHEN** 个人客户查询订单列表
@@ -36,7 +62,11 @@
 
 #### Scenario: 代理查询店铺订单
 - **WHEN** 代理查询订单列表
-- **THEN** 系统返回该店铺及下级店铺的订单
+- **THEN** 系统返回该店铺及下级店铺的订单（包含代购订单和普通订单）
+
+#### Scenario: 按代购类型筛选
+- **WHEN** 指定 is_purchase_on_behalf = true 筛选
+- **THEN** 系统只返回代购订单
 
 #### Scenario: 按支付状态筛选
 - **WHEN** 指定支付状态筛选
@@ -60,16 +90,20 @@
 
 ### Requirement: 取消订单
 
-系统 SHALL 允许买家取消未支付的订单。
+系统 SHALL 允许买家取消未支付的订单，但代购订单不可取消。
 
-#### Scenario: 取消待支付订单
-- **WHEN** 买家取消一个待支付的订单
+#### Scenario: 取消待支付的普通订单
+- **WHEN** 买家取消一个待支付的普通订单（is_purchase_on_behalf = false）
 - **THEN** 系统更新订单状态为已取消
 
 #### Scenario: 取消已支付订单
 - **WHEN** 买家尝试取消已支付的订单
 - **THEN** 系统返回错误 "已支付订单无法取消"
 
+#### Scenario: 尝试取消代购订单
+- **WHEN** 买家尝试取消代购订单（is_purchase_on_behalf = true）
+- **THEN** 系统返回错误 "代购订单不可取消"
+
 ---
 
 ### Requirement: 订单号生成