fix(force-recharge): 补充强充配置缺失的接口和数据库字段
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 6m19s

- 订单管理:增加 payment_method 字段支持,合并代购订单逻辑
- 套餐系列分配:增加强充配置字段(enable_force_recharge、force_recharge_amount、force_recharge_trigger_type)
- 数据库迁移:添加 force_recharge_trigger_type 字段
- 测试:更新订单服务测试用例
- OpenSpec:归档 fix-force-recharge-missing-interfaces 变更
This commit is contained in:
2026-01-31 15:34:32 +08:00
parent d309951493
commit d81bd242a4
21 changed files with 1090 additions and 388 deletions

View File

@@ -1,4 +1,10 @@
## ADDED Requirements
# Capability: 订单管理
## Purpose
本 capability 定义套餐购买订单的创建、查询、取消等完整生命周期管理,包括普通订单和代购订单的区分、支付方式的处理、强充要求的验证。
## Requirements
### Requirement: 订单类型标识
@@ -20,7 +26,15 @@
### Requirement: 创建套餐购买订单
系统 SHALL 允许买家创建套餐购买订单。订单类型分为单卡购买和设备购买。创建前 MUST 验证购买权限和强充要求。
系统 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** 个人客户为自己的卡创建订单,选择一个套餐
@@ -30,13 +44,21 @@
- **WHEN** 个人客户为自己的设备创建订单
- **THEN** 系统创建订单订单类型为设备购买is_purchase_on_behalf = false
#### Scenario: 代理创建订单
- **WHEN** 代理为店铺关联的卡/设备创建订单
- **THEN** 系统创建订单买家类型为代理商买家ID为店铺IDis_purchase_on_behalf = false
#### Scenario: 代理创建普通订单(钱包支付)
- **WHEN** 代理为店铺关联的卡/设备创建订单payment_method = "wallet"
- **THEN** 系统创建订单买家类型为代理商买家ID为店铺IDis_purchase_on_behalf = falsepayment_status = 1待支付
#### Scenario: 平台创建代购订单
- **WHEN** 平台账号为代理的卡/设备创建订单,支付方式选择 offline
- **THEN** 系统创建订单is_purchase_on_behalf = truepayment_method = "offline"payment_status = 2已支付
#### Scenario: 平台创建代购订单(线下支付)
- **WHEN** 平台账号为代理的卡/设备创建订单,payment_method = "offline"
- **THEN** 系统创建订单is_purchase_on_behalf = truepayment_method = "offline"payment_status = 2已支付,直接激活套餐
#### Scenario: 代理尝试使用线下支付
- **WHEN** 代理账号创建订单payment_method = "offline"
- **THEN** 系统返回错误 "只有平台可以使用线下支付"
#### Scenario: 平台使用钱包支付
- **WHEN** 平台账号创建订单payment_method = "wallet",指定目标代理
- **THEN** 系统创建普通订单扣目标代理钱包is_purchase_on_behalf = false
#### Scenario: 套餐购买验证强充要求
- **WHEN** 个人客户创建订单,存在强充要求,订单金额低于强充金额
@@ -117,3 +139,53 @@
#### Scenario: 订单号唯一
- **WHEN** 并发创建多个订单
- **THEN** 每个订单的订单号都唯一
---
### 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 = falsepayment_status = 1待支付
#### Scenario: payment_method 为 offline
- **WHEN** 创建订单时 payment_method = "offline"
- **THEN** 系统设置 is_purchase_on_behalf = truepayment_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 = trueSHALL 计算差价佣金MUST NOT 触发一次性佣金MUST NOT 更新累计充值。
#### Scenario: 代购订单计算差价佣金
- **WHEN** 代购订单支付成功,买家成本价 100 元,套餐建议成本价 80 元
- **THEN** 系统计算差价佣金 20 元,分配给上级代理
#### Scenario: 代购订单不触发一次性佣金
- **WHEN** 代购订单支付成功,符合一次性佣金触发条件
- **THEN** 系统 MUST NOT 触发一次性佣金
#### Scenario: 代购订单不更新累计充值
- **WHEN** 代购订单支付成功
- **THEN** 系统 MUST NOT 更新卡/设备的 accumulated_recharge 字段