docs: 同步 OpenSpec 主规范,新增系列授权 capability 并更新强充预检规范

三个 capability 同步:
- agent-series-grant(新建):定义系列授权 CRUD,覆盖固定/梯度佣金模式和强充层级场景
- force-recharge-check(更新):新增「代理层强充层级判断」Requirement,更新钱包充值和套餐购买预检场景以反映平台/代理层级规则
- shop-series-allocation(更新):在 REMOVED 区域追加三个已废弃接口的文档说明(/shop-series-allocations、/shop-package-allocations、enable_one_time_commission 等字段)

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
2026-03-04 11:37:46 +08:00
parent e0cb4498e6
commit f40abaf93c
3 changed files with 270 additions and 15 deletions

View File

@@ -172,3 +172,47 @@
- 一次性佣金支持按销售数量或销售金额设置多个梯度档位
- API 请求中删除 `enable_tier_commission``tier_config` 字段
- API 响应中不再包含 `enable_tier_commission` 字段
---
### Requirement: /shop-series-allocations 接口
**❌ REMOVED** - 此 requirement 已废弃
**Reason**: 已被 `/shop-series-grants` 完全替代。开发阶段干净重构,不保留兼容接口。
**删除范围**
- `internal/handler/admin/shop_series_allocation.go`
- `internal/routes/shop_series_allocation.go`
- `internal/model/dto/shop_series_allocation.go`
- `internal/service/shop_series_allocation/`
-`bootstrap/types.go``bootstrap/handlers.go``bootstrap/services.go``pkg/openapi/handlers.go``routes/admin.go` 移除引用
**保留**`internal/store/postgres/shop_series_allocation_store.go`被佣金计算、订单服务、Grant Service 使用)
---
### Requirement: /shop-package-allocations 接口
**❌ REMOVED** - 此 requirement 已废弃
**Reason**: 套餐分配已合并进 `/shop-series-grants` 的创建和套餐管理接口。开发阶段干净重构,不保留兼容接口。
**删除范围**
- `internal/handler/admin/shop_package_allocation.go`
- `internal/routes/shop_package_allocation.go`
- `internal/model/dto/shop_package_allocation.go`
- `internal/service/shop_package_allocation/`
- 从 bootstrap、openapi/handlers、routes/admin 移除引用
**保留**`internal/store/postgres/shop_package_allocation_store.go`(被多处使用)
---
### Requirement: 分配时配置 enable_one_time_commission 等字段
**❌ REMOVED** - 此 requirement 已废弃
**Reason**: `enable_one_time_commission``one_time_commission_trigger``one_time_commission_threshold` 三个字段从未被计算引擎读取,与 PackageSeries 的配置语义完全重复。
**Migration**:一次性佣金是否启用由 `PackageSeries.enable_one_time_commission` 控制;分配表中仅保留 `one_time_commission_amount`(固定模式天花板)、`commission_tiers_json`(梯度模式专属阶梯)和强充 3 个字段。