Files
junhong_cmp_fiber/openspec/specs/order-management/spec.md
huang 62708892ec
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 6m2s
文档
2026-01-31 13:06:30 +08:00

120 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 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 验证购买权限和强充要求。
#### Scenario: 个人客户创建单卡订单
- **WHEN** 个人客户为自己的卡创建订单,选择一个套餐
- **THEN** 系统创建订单状态为待支付is_purchase_on_behalf = false返回订单信息
#### Scenario: 个人客户创建设备订单
- **WHEN** 个人客户为自己的设备创建订单
- **THEN** 系统创建订单订单类型为设备购买is_purchase_on_behalf = false
#### Scenario: 代理创建订单
- **WHEN** 代理为店铺关联的卡/设备创建订单
- **THEN** 系统创建订单买家类型为代理商买家ID为店铺IDis_purchase_on_behalf = false
#### Scenario: 平台创建代购订单
- **WHEN** 平台账号为代理的卡/设备创建订单,支付方式选择 offline
- **THEN** 系统创建订单is_purchase_on_behalf = truepayment_method = "offline"payment_status = 2已支付
#### Scenario: 套餐购买验证强充要求
- **WHEN** 个人客户创建订单,存在强充要求,订单金额低于强充金额
- **THEN** 系统返回错误 "支付金额不符合强充要求"
#### Scenario: 套餐不在可购买范围
- **WHEN** 买家尝试购买不在关联系列下的套餐
- **THEN** 系统返回错误 "该套餐不在可购买范围内"
#### Scenario: 套餐已下架
- **WHEN** 买家尝试购买已下架的套餐
- **THEN** 系统返回错误 "该套餐已下架"
---
### Requirement: 查询订单列表
系统 SHALL 提供订单列表查询,支持按支付状态、订单类型、是否代购筛选。
#### Scenario: 个人客户查询自己的订单
- **WHEN** 个人客户查询订单列表
- **THEN** 系统只返回该客户的订单
#### Scenario: 代理查询店铺订单
- **WHEN** 代理查询订单列表
- **THEN** 系统返回该店铺及下级店铺的订单(包含代购订单和普通订单)
#### Scenario: 按代购类型筛选
- **WHEN** 指定 is_purchase_on_behalf = true 筛选
- **THEN** 系统只返回代购订单
#### Scenario: 按支付状态筛选
- **WHEN** 指定支付状态筛选
- **THEN** 系统只返回匹配状态的订单
---
### Requirement: 查询订单详情
系统 SHALL 允许买家查询订单详情,包含订单明细。
#### Scenario: 查询订单详情
- **WHEN** 买家查询指定订单详情
- **THEN** 系统返回订单信息和订单明细列表
#### Scenario: 查询他人订单
- **WHEN** 买家尝试查询不属于自己的订单
- **THEN** 系统返回 "订单不存在" 错误
---
### Requirement: 取消订单
系统 SHALL 允许买家取消未支付的订单,但代购订单不可取消。
#### Scenario: 取消待支付的普通订单
- **WHEN** 买家取消一个待支付的普通订单is_purchase_on_behalf = false
- **THEN** 系统更新订单状态为已取消
#### Scenario: 取消已支付订单
- **WHEN** 买家尝试取消已支付的订单
- **THEN** 系统返回错误 "已支付订单无法取消"
#### Scenario: 尝试取消代购订单
- **WHEN** 买家尝试取消代购订单is_purchase_on_behalf = true
- **THEN** 系统返回错误 "代购订单不可取消"
---
### Requirement: 订单号生成
系统生成的订单号 MUST 全局唯一,格式为 ORD{YYYYMMDDHHMMSS}{6位随机数}。
#### Scenario: 订单号格式
- **WHEN** 创建新订单
- **THEN** 订单号格式为 ORD + 14位时间戳 + 6位随机数
#### Scenario: 订单号唯一
- **WHEN** 并发创建多个订单
- **THEN** 每个订单的订单号都唯一