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

@@ -32,6 +32,11 @@
系统 SHALL 允许代理为其直属下级店铺分配套餐系列。分配时 MUST 指定基础返佣配置返佣模式和返佣值MAY 启用一次性佣金和强充配置。分配者只能分配自己已被分配的套餐系列。
**API 接口 MUST 在请求和响应中包含强充配置字段**
- `enable_force_recharge`:是否启用强充
- `force_recharge_amount`强充金额0 表示使用阈值)
- `force_recharge_trigger_type`强充触发类型1: 单次充值2: 累计充值)
#### Scenario: 成功分配套餐系列
- **WHEN** 代理为直属下级店铺分配一个自己拥有的套餐系列设置基础返佣为百分比20020%
- **THEN** 系统创建分配记录
@@ -40,6 +45,14 @@
- **WHEN** 代理为下级分配系列,启用一次性佣金,触发类型为累计充值,阈值 1000001000元启用强充强充金额 10000100元
- **THEN** 系统保存配置enable_one_time_commission = truetrigger = "accumulated_recharge"threshold = 100000enable_force_recharge = trueforce_recharge_amount = 10000
#### Scenario: API 请求包含强充配置字段
- **WHEN** 创建分配时,请求包含 enable_force_recharge = trueforce_recharge_amount = 10000force_recharge_trigger_type = 2
- **THEN** 系统接受并保存这些字段,响应中返回相同的配置
#### Scenario: API 响应包含强充配置字段
- **WHEN** 查询分配详情或列表
- **THEN** 响应 MUST 包含 enable_force_recharge、force_recharge_amount、force_recharge_trigger_type 字段
#### Scenario: 尝试分配未拥有的系列
- **WHEN** 代理尝试分配自己未被分配的套餐系列
- **THEN** 系统返回错误 "您没有该套餐系列的分配权限"
@@ -56,21 +69,25 @@
### Requirement: 查询套餐系列分配列表
系统 SHALL 提供分配列表查询,支持按下级店铺筛选、按套餐系列筛选、按状态筛选。
系统 SHALL 提供分配列表查询,支持按下级店铺筛选、按套餐系列筛选、按状态筛选。**响应 MUST 包含强充配置字段**。
#### Scenario: 查询所有分配
- **WHEN** 代理查询分配列表,不带筛选条件
- **THEN** 系统返回该代理创建的所有分配记录
- **THEN** 系统返回该代理创建的所有分配记录,每条记录包含强充配置字段
#### Scenario: 按店铺筛选
- **WHEN** 代理指定下级店铺 ID 筛选
- **THEN** 系统只返回该店铺的分配记录
- **THEN** 系统只返回该店铺的分配记录,记录包含强充配置字段
#### Scenario: 响应包含强充配置
- **WHEN** 查询分配列表
- **THEN** 每条记录包含 enable_force_recharge、force_recharge_amount、force_recharge_trigger_type 字段
---
### Requirement: 更新套餐系列分配
系统 SHALL 允许代理更新分配的基础返佣配置、一次性佣金配置和强充配置。更新返佣配置时 MUST 创建新的配置版本。
系统 SHALL 允许代理更新分配的基础返佣配置、一次性佣金配置和强充配置。更新返佣配置时 MUST 创建新的配置版本。**API 请求 MUST 支持更新强充配置字段**。
#### Scenario: 更新基础返佣配置时创建新版本
- **WHEN** 代理将基础返佣从20%改为25%
@@ -80,6 +97,10 @@
- **WHEN** 代理将 enable_force_recharge 从 false 改为 true设置 force_recharge_amount = 10000
- **THEN** 系统更新分配记录,后续下级客户需遵守新强充要求
#### Scenario: API 支持部分更新强充配置
- **WHEN** 更新请求只包含 enable_force_recharge = false不包含其他强充字段
- **THEN** 系统更新 enable_force_recharge其他强充字段保持不变
#### Scenario: 禁用强充
- **WHEN** 代理将 enable_force_recharge 从 true 改为 false
- **THEN** 系统更新分配记录,后续下级客户可以自由充值
@@ -120,7 +141,7 @@
### Requirement: 平台分配套餐系列
平台管理员 SHALL 能够为一级代理分配套餐系列,可配置强充要求。平台的成本价基准为 Package.suggested_cost_price。
平台管理员 SHALL 能够为一级代理分配套餐系列,可配置强充要求。平台的成本价基准为 Package.suggested_cost_price。**API 接口 MUST 支持强充配置字段的输入和输出**。
#### Scenario: 平台为一级代理分配
- **WHEN** 平台管理员为一级代理分配套餐系列
@@ -130,6 +151,10 @@
- **WHEN** 平台为一级代理分配系列启用强充force_recharge_amount = 10000
- **THEN** 系统保存强充配置,一级代理的客户需遵守强充要求
#### Scenario: API 请求和响应包含强充配置
- **WHEN** 平台创建或查询分配
- **THEN** 请求和响应都包含强充配置字段
---
## REMOVED Requirements