feat: 实现门店套餐分配功能并统一测试基础设施

新增功能：
- 门店套餐分配管理（shop_package_allocation）：支持门店套餐库存管理
- 门店套餐系列分配管理（shop_series_allocation）：支持套餐系列分配和佣金层级设置
- 我的套餐查询（my_package）：支持门店查询自己的套餐分配情况

测试改进：
- 统一集成测试基础设施，新增 testutils.NewIntegrationTestEnv
- 重构所有集成测试使用新的测试环境设置
- 移除旧的测试辅助函数和冗余测试文件
- 新增 test_helpers_test.go 统一任务测试辅助

技术细节：
- 新增数据库迁移 000025_create_shop_allocation_tables
- 新增 3 个 Handler、Service、Store 和对应的单元测试
- 更新 OpenAPI 文档和文档生成器
- 测试覆盖率：Service 层 > 90%

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

tests/testutil/auth_helper.go

@@ -2,6 +2,9 @@ package testutil
 
 import (
 	"context"
+	"fmt"
+	"math/rand"
+	"sync/atomic"
 	"testing"
 	"time"
 
@@ -14,6 +17,23 @@ import (
 	"gorm.io/gorm"
 )
 
+// phoneCounter 用于生成唯一的手机号
+var phoneCounter uint64
+
+func init() {
+	// 使用当前时间作为随机种子
+	rand.Seed(time.Now().UnixNano())
+	// 初始化计数器为一个随机值，避免不同测试运行之间的冲突
+	phoneCounter = uint64(rand.Intn(10000))
+}
+
+// GenerateUniquePhone 生成唯一的测试手机号（导出供测试使用）
+func GenerateUniquePhone() string {
+	counter := atomic.AddUint64(&phoneCounter, 1)
+	timestamp := time.Now().UnixNano() % 10000
+	return fmt.Sprintf("139%04d%04d", timestamp, counter%10000)
+}
+
 // CreateTestAccount 创建测试账号
 // userType: 1=超级管理员, 2=平台用户, 3=代理账号, 4=企业账号
 func CreateTestAccount(t *testing.T, db *gorm.DB, username, password string, userType int, shopID, enterpriseID *uint) *model.Account {
@@ -22,15 +42,7 @@ func CreateTestAccount(t *testing.T, db *gorm.DB, username, password string, use
 	hashedPassword, err := bcrypt.GenerateFromPassword([]byte(password), bcrypt.DefaultCost)
 	require.NoError(t, err)
 
-	phone := "13800000000"
-	if len(username) >= 8 {
-		phone = "138" + username[len(username)-8:]
-	} else {
-		phone = "138" + username + "00000000"
-		if len(phone) > 11 {
-			phone = phone[:11]
-		}
-	}
+	phone := GenerateUniquePhone()
 
 	account := &model.Account{
 		BaseModel: model.BaseModel{
@@ -83,6 +95,19 @@ func GenerateTestToken(t *testing.T, rdb *redis.Client, account *model.Account,
 	return accessToken, refreshToken
 }
 
+// usernameCounter 用于生成唯一的用户名
+var usernameCounter uint64
+
+func init() {
+	usernameCounter = uint64(rand.Intn(100000))
+}
+
+// GenerateUniqueUsername 生成唯一的测试用户名（导出供测试使用）
+func GenerateUniqueUsername(prefix string) string {
+	counter := atomic.AddUint64(&usernameCounter, 1)
+	return fmt.Sprintf("%s_%d", prefix, counter)
+}
+
 // CreateSuperAdmin 创建或获取超级管理员测试账号
 func CreateSuperAdmin(t *testing.T, db *gorm.DB) *model.Account {
 	t.Helper()
@@ -93,38 +118,45 @@ func CreateSuperAdmin(t *testing.T, db *gorm.DB) *model.Account {
 		return &existing
 	}
 
-	return CreateTestAccount(t, db, "superadmin", "password123", constants.UserTypeSuperAdmin, nil, nil)
+	return CreateTestAccount(t, db, GenerateUniqueUsername("superadmin"), "password123", constants.UserTypeSuperAdmin, nil, nil)
 }
 
 // CreatePlatformUser 创建平台用户测试账号
 func CreatePlatformUser(t *testing.T, db *gorm.DB) *model.Account {
 	t.Helper()
-	return CreateTestAccount(t, db, "platformuser", "password123", constants.UserTypePlatform, nil, nil)
+	return CreateTestAccount(t, db, GenerateUniqueUsername("platformuser"), "password123", constants.UserTypePlatform, nil, nil)
 }
 
 // CreateAgentUser 创建代理账号测试账号
 func CreateAgentUser(t *testing.T, db *gorm.DB, shopID uint) *model.Account {
 	t.Helper()
-	return CreateTestAccount(t, db, "agentuser", "password123", constants.UserTypeAgent, &shopID, nil)
+	return CreateTestAccount(t, db, GenerateUniqueUsername("agentuser"), "password123", constants.UserTypeAgent, &shopID, nil)
 }
 
 // CreateEnterpriseUser 创建企业账号测试账号
 func CreateEnterpriseUser(t *testing.T, db *gorm.DB, enterpriseID uint) *model.Account {
 	t.Helper()
-	return CreateTestAccount(t, db, "enterpriseuser", "password123", constants.UserTypeEnterprise, nil, &enterpriseID)
+	return CreateTestAccount(t, db, GenerateUniqueUsername("enterpriseuser"), "password123", constants.UserTypeEnterprise, nil, &enterpriseID)
 }
 
+// shopCodeCounter 用于生成唯一的商户代码
+var shopCodeCounter uint64
+
 // CreateTestShop 创建测试商户
 func CreateTestShop(t *testing.T, db *gorm.DB, name, code string, level int, parentID *uint) *model.Shop {
 	t.Helper()
 
+	counter := atomic.AddUint64(&shopCodeCounter, 1)
+	uniqueCode := fmt.Sprintf("%s_%d_%d", code, time.Now().UnixNano()%10000, counter)
+	uniqueName := fmt.Sprintf("%s_%d", name, counter)
+
 	shop := &model.Shop{
 		BaseModel: model.BaseModel{
 			Creator: 1,
 			Updater: 1,
 		},
-		ShopName: name,
-		ShopCode: code,
+		ShopName: uniqueName,
+		ShopCode: uniqueCode,
 		Level:    level,
 		Status:   1,
 	}