huang
1cf17e8f14
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") 替代
3.3 KiB
3.3 KiB
Capability: 店铺返佣梯度管理
❌ CAPABILITY REMOVED - 此 capability 已完全废弃
Purpose
本 capability 定义代理如何为套餐系列分配配置和管理梯度返佣，包括添加、查询、更新和删除梯度配置。
废弃原因: 整个店铺返佣梯度管理 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: 添加销量梯度佣金
- WHEN 代理为分配添加梯度：类型=销量，周期=月度，阈值=100，返佣模式=百分比，返佣值=300（30%）
- THEN 系统创建梯度配置，当下级月销量达到 100 时，返佣提升到 30%
Scenario: 添加销售额梯度佣金
- WHEN 代理添加梯度：类型=销售额，周期=季度，阈值=100000分，返佣模式=固定，返佣值=3000分（30元）
- THEN 系统创建梯度配置，当下级季度销售额达到 1000 元时，返佣提升到固定 30 元
Scenario: 添加多个梯度档位
- WHEN 代理为同一分配添加多个梯度（如：100件=30%，200件=40%，500件=50%）
- THEN 系统创建多个梯度记录，支持阶梯提升
Requirement: 查询梯度佣金配置
❌ REMOVED
系统 SHALL 提供梯度佣金配置的查询功能，按分配 ID 查询，返回结果按阈值升序排列。
Scenario: 查询分配的梯度配置
- WHEN 代理查询指定分配的梯度配置
- THEN 系统返回该分配下的所有梯度配置，按阈值升序排列
Scenario: 分配无梯度配置
- WHEN 代理查询一个没有配置梯度的分配
- THEN 系统返回空列表
Requirement: 更新梯度佣金配置
❌ REMOVED
系统 SHALL 允许代理更新梯度配置的阈值和返佣配置。
Scenario: 更新梯度阈值
- WHEN 代理将梯度阈值从 100 改为 150
- THEN 系统更新梯度记录
Scenario: 更新梯度返佣配置
- WHEN 代理将返佣配置从百分比300（30%）改为百分比400（40%）
- THEN 系统更新梯度记录
Requirement: 删除梯度佣金配置
❌ REMOVED
系统 SHALL 允许代理删除梯度配置。
Scenario: 删除梯度配置
- WHEN 代理删除指定的梯度配置
- THEN 系统软删除该梯度记录