重构: 店铺套餐分配系统从加价模式改为返佣模式
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 5m18s

主要变更:
- 重构分配模型:从加价模式(pricing_mode/pricing_value)改为返佣模式(base_commission + tier_commission)
- 删除独立的 my_package 接口,统一到 /api/admin/packages(通过数据权限自动过滤)
- 新增批量分配和批量调价功能,支持事务和性能优化
- 新增配置版本管理,订单创建时锁定返佣配置
- 新增成本价历史记录,支持审计和纠纷处理
- 新增统计缓存系统(Redis + 异步任务),优化梯度返佣计算性能
- 删除冗余的梯度佣金独立 CRUD 接口(合并到分配配置中)
- 归档 3 个已完成的 OpenSpec changes 并同步 8 个新 capabilities 到 main specs

技术细节:
- 数据库迁移:000026_refactor_shop_package_allocation
- 新增 Store:AllocationConfigStore, PriceHistoryStore, CommissionStatsStore
- 新增 Service:BatchAllocationService, BatchPricingService, CommissionStatsService
- 新增异步任务:统计更新、定时同步、周期归档
- 测试覆盖:批量操作集成测试、梯度佣金 CRUD 清理验证

影响:
- API 变更:删除 4 个梯度 CRUD 接口(POST/GET/PUT/DELETE /:id/tiers)
- API 新增:批量分配、批量调价接口
- 数据模型:重构 shop_series_allocation 表结构
- 性能优化:批量操作使用 CreateInBatches,统计使用 Redis 缓存

相关文档:
- openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/
- openspec/specs/agent-available-packages/
- openspec/specs/allocation-config-versioning/
- 等 8 个新 capability specs
This commit is contained in:
2026-01-28 17:11:55 +08:00
parent 23eb0307bb
commit 1da680a790
97 changed files with 6810 additions and 3622 deletions

View File

@@ -0,0 +1,61 @@
# Capability: 店铺返佣梯度管理
## Purpose
本 capability 定义代理如何为套餐系列分配配置和管理梯度返佣,包括添加、查询、更新和删除梯度配置。
## Requirements
### Requirement: 配置梯度佣金
系统 SHALL 允许代理为套餐系列分配配置梯度佣金。每个梯度包含:梯度类型(销量/销售额)、周期类型(月度/季度/年度)、阈值、达标后的返佣配置(返佣模式和返佣值)。
#### Scenario: 添加销量梯度佣金
- **WHEN** 代理为分配添加梯度:类型=销量,周期=月度,阈值=100返佣模式=百分比,返佣值=30030%
- **THEN** 系统创建梯度配置,当下级月销量达到 100 时,返佣提升到 30%
#### Scenario: 添加销售额梯度佣金
- **WHEN** 代理添加梯度:类型=销售额,周期=季度,阈值=100000分返佣模式=固定,返佣值=3000分30元
- **THEN** 系统创建梯度配置,当下级季度销售额达到 1000 元时,返佣提升到固定 30 元
#### Scenario: 添加多个梯度档位
- **WHEN** 代理为同一分配添加多个梯度100件=30%200件=40%500件=50%
- **THEN** 系统创建多个梯度记录,支持阶梯提升
---
### Requirement: 查询梯度佣金配置
系统 SHALL 提供梯度佣金配置的查询功能,按分配 ID 查询,返回结果按阈值升序排列。
#### Scenario: 查询分配的梯度配置
- **WHEN** 代理查询指定分配的梯度配置
- **THEN** 系统返回该分配下的所有梯度配置,按阈值升序排列
#### Scenario: 分配无梯度配置
- **WHEN** 代理查询一个没有配置梯度的分配
- **THEN** 系统返回空列表
---
### Requirement: 更新梯度佣金配置
系统 SHALL 允许代理更新梯度配置的阈值和返佣配置。
#### Scenario: 更新梯度阈值
- **WHEN** 代理将梯度阈值从 100 改为 150
- **THEN** 系统更新梯度记录
#### Scenario: 更新梯度返佣配置
- **WHEN** 代理将返佣配置从百分比30030%改为百分比40040%
- **THEN** 系统更新梯度记录
---
### Requirement: 删除梯度佣金配置
系统 SHALL 允许代理删除梯度配置。
#### Scenario: 删除梯度配置
- **WHEN** 代理删除指定的梯度配置
- **THEN** 系统软删除该梯度记录