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

4.2 KiB
Raw Blame History

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 每个订单的订单号都唯一