清理冗余的梯度返佣(TierCommission)配置
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 5m46s

- 移除 Model 层:删除 ShopSeriesCommissionTier 模型及相关字段
- 更新 DTO:删除 TierCommissionConfig、TierEntry 类型及相关请求/响应字段
- 删除 Store 层:移除 ShopSeriesCommissionTierStore 及相关查询逻辑
- 简化 Service 层:删除梯度返佣处理逻辑,统计查询移除 tier_bonus 字段
- 数据库迁移:创建 000034_remove_tier_commission 移除相关表和字段
- 更新测试:移除梯度返佣相关测试用例,更新集成测试
- OpenAPI 文档:删除梯度返佣相关 schema 和枚举值
- 归档变更:归档 remove-tier-commission-redundancy 到 archive/2026-01-30-
- 同步规范:更新 4 个主 specs,标记废弃功能并添加迁移指引

原因:梯度返佣功能与一次性梯度佣金功能重复,且从未实现实际计算逻辑
迁移:使用一次性佣金的梯度模式 (OneTimeCommissionConfig.type = "tiered") 替代
This commit is contained in:
2026-01-30 14:57:24 +08:00
parent 409a68d60b
commit 1cf17e8f14
39 changed files with 978 additions and 407 deletions

View File

@@ -1,13 +1,31 @@
# Capability: 店铺返佣梯度管理
**❌ CAPABILITY REMOVED** - 此 capability 已完全废弃
## Purpose
本 capability 定义代理如何为套餐系列分配配置和管理梯度返佣,包括添加、查询、更新和删除梯度配置。
## Requirements
**废弃原因**: 整个店铺返佣梯度管理 capability 被废弃。梯度返佣功能与一次性梯度佣金功能重复,且梯度返佣从未实现实际的佣金计算逻辑。系统简化为只支持基础返佣(成本价差)和一次性佣金两种机制。
**迁移指引**:
- 使用一次性佣金的梯度模式 (OneTimeCommissionConfig.type = "tiered") 替代
- 一次性佣金支持按销售数量 (tier_type = "sales_count") 或销售金额 (tier_type = "sales_amount") 设置梯度
- 一次性佣金每张卡/设备只触发一次,达到阈值后自动发放
- 删除所有梯度佣金配置相关的 API 端点:
- `POST /api/shop-series-allocations/:id/tiers` (添加梯度配置)
- `GET /api/shop-series-allocations/:id/tiers` (查询梯度配置)
- `PUT /api/shop-series-commission-tiers/:id` (更新梯度配置)
- `DELETE /api/shop-series-commission-tiers/:id` (删除梯度配置)
---
## REMOVED Requirements
### Requirement: 配置梯度佣金
**❌ REMOVED**
系统 SHALL 允许代理为套餐系列分配配置梯度佣金。每个梯度包含:梯度类型(销量/销售额)、周期类型(月度/季度/年度)、阈值、达标后的返佣配置(返佣模式和返佣值)。
#### Scenario: 添加销量梯度佣金
@@ -26,6 +44,8 @@
### Requirement: 查询梯度佣金配置
**❌ REMOVED**
系统 SHALL 提供梯度佣金配置的查询功能,按分配 ID 查询,返回结果按阈值升序排列。
#### Scenario: 查询分配的梯度配置
@@ -40,6 +60,8 @@
### Requirement: 更新梯度佣金配置
**❌ REMOVED**
系统 SHALL 允许代理更新梯度配置的阈值和返佣配置。
#### Scenario: 更新梯度阈值
@@ -54,6 +76,8 @@
### Requirement: 删除梯度佣金配置
**❌ REMOVED**
系统 SHALL 允许代理删除梯度配置。
#### Scenario: 删除梯度配置