huang
1da680a790
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
68 lines
2.8 KiB
Markdown
68 lines
2.8 KiB
Markdown
# Capability: 分配配置版本管理
|
||
|
||
## Purpose
|
||
|
||
本 capability 定义如何管理套餐系列分配的返佣配置版本，确保订单创建时锁定配置，支持配置历史查询和审计。
|
||
|
||
## Requirements
|
||
|
||
### Requirement: 返佣配置变更时创建新版本
|
||
|
||
系统 SHALL 在代理修改套餐系列分配的返佣配置时，创建新的配置版本记录。旧版本 MUST 被标记为失效（设置 effective_to 时间戳），新版本 MUST 记录生效时间（effective_from）。
|
||
|
||
#### Scenario: 修改基础返佣配置时创建新版本
|
||
- **WHEN** 代理将基础返佣从20%修改为25%
|
||
- **THEN** 系统失效当前配置版本，创建新版本（version + 1）
|
||
|
||
#### Scenario: 修改梯度返佣开关时创建新版本
|
||
- **WHEN** 代理启用或禁用梯度返佣
|
||
- **THEN** 系统失效当前配置版本，创建新版本
|
||
|
||
#### Scenario: 仅修改非配置字段时不创建新版本
|
||
- **WHEN** 代理修改分配的状态（启用/禁用），但不修改返佣配置
|
||
- **THEN** 系统不创建新配置版本
|
||
|
||
#### Scenario: 新版本记录正确的生效时间
|
||
- **WHEN** 代理在2026-01-28 10:00:00修改返佣配置
|
||
- **THEN** 新版本的 effective_from 为 2026-01-28 10:00:00
|
||
|
||
#### Scenario: 旧版本记录正确的失效时间
|
||
- **WHEN** 代理在2026-01-28 10:00:00修改返佣配置
|
||
- **THEN** 旧版本的 effective_to 为 2026-01-28 10:00:00
|
||
|
||
---
|
||
|
||
### Requirement: 订单创建时锁定配置版本
|
||
|
||
系统 SHALL 在创建充值订单时，查询当前生效的配置版本并锁定到订单。订单 MUST 记录配置版本ID和配置快照（返佣模式、返佣值）。
|
||
|
||
#### Scenario: 订单创建时查询当前生效配置
|
||
- **WHEN** 下级客户在2026-01-28 10:30:00发起充值
|
||
- **THEN** 系统查询2026-01-28 10:30:00时生效的配置版本（effective_from <= 10:30:00 AND effective_to IS NULL）
|
||
|
||
#### Scenario: 订单锁定配置版本ID
|
||
- **WHEN** 订单创建时，查询到配置版本ID为123
|
||
- **THEN** 订单记录 allocation_config_id = 123
|
||
|
||
#### Scenario: 订单记录配置快照
|
||
- **WHEN** 订单创建时，配置为百分比200（20%）
|
||
- **THEN** 订单记录 locked_commission_mode = "percent", locked_commission_value = 200
|
||
|
||
#### Scenario: 配置变更后订单使用锁定的配置
|
||
- **WHEN** 订单创建后，代理修改了返佣配置
|
||
- **THEN** 订单仍然按照锁定的配置计算返佣
|
||
|
||
---
|
||
|
||
### Requirement: 查询历史配置版本
|
||
|
||
系统 SHALL 允许代理查询指定分配的所有历史配置版本，按生效时间倒序排列。
|
||
|
||
#### Scenario: 查询分配的配置版本历史
|
||
- **WHEN** 代理查询分配ID为123的配置版本历史
|
||
- **THEN** 系统返回该分配的所有版本记录，最新版本在最前
|
||
|
||
#### Scenario: 历史版本包含完整配置信息
|
||
- **WHEN** 查询历史配置版本
|
||
- **THEN** 每个版本包含：版本号、返佣模式、返佣值、梯度开关、生效时间、失效时间
|