重构: 店铺套餐分配系统从加价模式改为返佣模式
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,115 @@
# Test Infrastructure Specification
统一的测试基础设施规范,定义集成测试的标准化模式。
## ADDED Requirements
### Requirement: 集成测试环境结构体
系统 SHALL 提供 `IntegrationTestEnv` 结构体,封装集成测试所需的所有依赖。
结构体字段:
- `TX *gorm.DB` - 自动回滚的数据库事务
- `Redis *redis.Client` - 全局 Redis 连接
- `Logger *zap.Logger` - 测试用日志记录器
- `TokenManager *auth.TokenManager` - Token 管理器
- `App *fiber.App` - 配置好的 Fiber 应用实例
#### Scenario: 创建集成测试环境
- **WHEN** 测试调用 `testutils.NewIntegrationTestEnv(t)`
- **THEN** 返回包含所有依赖的 `IntegrationTestEnv` 实例
- **AND** 事务在测试结束后自动回滚
- **AND** Redis 测试键在测试结束后自动清理
#### Scenario: 环境自动清理
- **WHEN** 测试函数执行完毕(无论成功或失败)
- **THEN** 数据库事务自动回滚
- **AND** 测试相关的 Redis 键自动删除
- **AND** 无需手动调用 teardown 函数
### Requirement: Fiber App 标准配置
集成测试环境中的 Fiber App MUST 使用与生产环境一致的配置。
配置内容:
- ErrorHandler: 使用 `errors.SafeErrorHandler`
- 路由注册: 使用 `routes.RegisterRoutes`
- 认证中间件: 模拟用户上下文
#### Scenario: ErrorHandler 配置正确
- **WHEN** API 返回错误
- **THEN** 响应格式与生产环境一致JSON 格式,包含 code、message、data
#### Scenario: 路由注册完整
- **WHEN** 创建测试环境
- **THEN** 所有 API 路由都已注册
- **AND** 可以测试任意 API 端点
### Requirement: 测试用户上下文
系统 SHALL 提供便捷的方式设置测试用户上下文。
#### Scenario: 创建超级管理员上下文
- **WHEN** 测试需要超级管理员权限
- **THEN** 可以通过 `env.AsSuperAdmin()` 获取带认证的请求
- **AND** 请求自动包含有效的 Token
#### Scenario: 创建指定用户类型上下文
- **WHEN** 测试需要特定用户类型(平台用户、代理、企业)
- **THEN** 可以通过 `env.AsUser(account)` 设置用户上下文
- **AND** 后续请求使用该用户的权限
### Requirement: 禁止使用 testcontainers
集成测试 MUST NOT 使用 testcontainers 或其他 Docker 容器方式。
#### Scenario: 测试不依赖 Docker
- **WHEN** 运行集成测试
- **THEN** 不需要 Docker 环境
- **AND** 测试可以在任何有数据库连接的环境中运行
### Requirement: 禁止使用 DELETE 清理
集成测试 MUST NOT 使用 `DELETE FROM ... WHERE ...` 语句清理测试数据。
#### Scenario: 数据清理通过事务回滚
- **WHEN** 测试创建数据
- **THEN** 数据通过事务回滚自动清理
- **AND** 不需要编写任何清理代码
### Requirement: 测试数据唯一性
测试生成的数据用户名、手机号、商户代码等MUST 保证唯一性。
#### Scenario: 并行测试不冲突
- **WHEN** 多个测试并行运行
- **THEN** 每个测试生成的数据都是唯一的
- **AND** 不会出现 "duplicate key" 错误
#### Scenario: 使用唯一标识生成器
- **WHEN** 测试需要生成手机号
- **THEN** 使用 `testutils.GenerateUniquePhone()``testutil.GenerateUniquePhone()`
- **AND** 生成的手机号在整个测试运行期间唯一
### Requirement: 测试文件统一模式
所有集成测试文件 MUST 遵循统一的结构模式。
标准模式:
```go
func TestXxx(t *testing.T) {
env := testutils.NewIntegrationTestEnv(t)
// 测试代码...
// 无需 defer teardown
}
```
#### Scenario: 标准测试结构
- **WHEN** 编写新的集成测试
- **THEN** 使用 `testutils.NewIntegrationTestEnv(t)` 创建环境
- **AND** 不需要手动清理或 defer 语句
#### Scenario: 子测试共享环境
- **WHEN** 测试包含多个子测试 (`t.Run`)
- **THEN** 在父测试中创建环境
- **AND** 所有子测试共享同一个环境