基础架构

internal/infrastructure/database/repositories/user/gorm_enterprise_info_repository.go

@@ -0,0 +1,273 @@
+package repositories
+
+import (
+	"context"
+	"fmt"
+	"time"
+
+	"go.uber.org/zap"
+	"gorm.io/gorm"
+
+	"tyapi-server/internal/domains/user/entities"
+	"tyapi-server/internal/domains/user/repositories"
+	"tyapi-server/internal/shared/interfaces"
+)
+
+// GormEnterpriseInfoRepository 企业信息GORM仓储实现
+type GormEnterpriseInfoRepository struct {
+	db     *gorm.DB
+	logger *zap.Logger
+}
+
+// NewGormEnterpriseInfoRepository 创建企业信息GORM仓储
+func NewGormEnterpriseInfoRepository(db *gorm.DB, logger *zap.Logger) repositories.EnterpriseInfoRepository {
+	return &GormEnterpriseInfoRepository{
+		db:     db,
+		logger: logger,
+	}
+}
+
+// Create 创建企业信息
+func (r *GormEnterpriseInfoRepository) Create(ctx context.Context, enterpriseInfo entities.EnterpriseInfo) (entities.EnterpriseInfo, error) {
+	if err := r.db.WithContext(ctx).Create(&enterpriseInfo).Error; err != nil {
+		r.logger.Error("创建企业信息失败", zap.Error(err))
+		return entities.EnterpriseInfo{}, fmt.Errorf("创建企业信息失败: %w", err)
+	}
+	return enterpriseInfo, nil
+}
+
+// GetByID 根据ID获取企业信息
+func (r *GormEnterpriseInfoRepository) GetByID(ctx context.Context, id string) (entities.EnterpriseInfo, error) {
+	var enterpriseInfo entities.EnterpriseInfo
+	if err := r.db.WithContext(ctx).Where("id = ?", id).First(&enterpriseInfo).Error; err != nil {
+		if err == gorm.ErrRecordNotFound {
+			return entities.EnterpriseInfo{}, fmt.Errorf("企业信息不存在")
+		}
+		r.logger.Error("获取企业信息失败", zap.Error(err))
+		return entities.EnterpriseInfo{}, fmt.Errorf("获取企业信息失败: %w", err)
+	}
+	return enterpriseInfo, nil
+}
+
+// Update 更新企业信息
+func (r *GormEnterpriseInfoRepository) Update(ctx context.Context, enterpriseInfo entities.EnterpriseInfo) error {
+	// 检查企业信息是否已认证完成，认证完成后不可修改
+	if enterpriseInfo.IsReadOnly() {
+		return fmt.Errorf("企业信息已认证完成，不可修改")
+	}
+
+	if err := r.db.WithContext(ctx).Save(&enterpriseInfo).Error; err != nil {
+		r.logger.Error("更新企业信息失败", zap.Error(err))
+		return fmt.Errorf("更新企业信息失败: %w", err)
+	}
+	return nil
+}
+
+// Delete 删除企业信息
+func (r *GormEnterpriseInfoRepository) Delete(ctx context.Context, id string) error {
+	if err := r.db.WithContext(ctx).Delete(&entities.EnterpriseInfo{}, "id = ?", id).Error; err != nil {
+		r.logger.Error("删除企业信息失败", zap.Error(err))
+		return fmt.Errorf("删除企业信息失败: %w", err)
+	}
+	return nil
+}
+
+// SoftDelete 软删除企业信息
+func (r *GormEnterpriseInfoRepository) SoftDelete(ctx context.Context, id string) error {
+	if err := r.db.WithContext(ctx).Delete(&entities.EnterpriseInfo{}, "id = ?", id).Error; err != nil {
+		r.logger.Error("软删除企业信息失败", zap.Error(err))
+		return fmt.Errorf("软删除企业信息失败: %w", err)
+	}
+	return nil
+}
+
+// Restore 恢复软删除的企业信息
+func (r *GormEnterpriseInfoRepository) Restore(ctx context.Context, id string) error {
+	if err := r.db.WithContext(ctx).Unscoped().Model(&entities.EnterpriseInfo{}).Where("id = ?", id).Update("deleted_at", nil).Error; err != nil {
+		r.logger.Error("恢复企业信息失败", zap.Error(err))
+		return fmt.Errorf("恢复企业信息失败: %w", err)
+	}
+	return nil
+}
+
+// GetByUserID 根据用户ID获取企业信息
+func (r *GormEnterpriseInfoRepository) GetByUserID(ctx context.Context, userID string) (*entities.EnterpriseInfo, error) {
+	var enterpriseInfo entities.EnterpriseInfo
+	if err := r.db.WithContext(ctx).Where("user_id = ?", userID).First(&enterpriseInfo).Error; err != nil {
+		if err == gorm.ErrRecordNotFound {
+			return nil, fmt.Errorf("企业信息不存在")
+		}
+		r.logger.Error("获取企业信息失败", zap.Error(err))
+		return nil, fmt.Errorf("获取企业信息失败: %w", err)
+	}
+	return &enterpriseInfo, nil
+}
+
+// GetByUnifiedSocialCode 根据统一社会信用代码获取企业信息
+func (r *GormEnterpriseInfoRepository) GetByUnifiedSocialCode(ctx context.Context, unifiedSocialCode string) (*entities.EnterpriseInfo, error) {
+	var enterpriseInfo entities.EnterpriseInfo
+	if err := r.db.WithContext(ctx).Where("unified_social_code = ?", unifiedSocialCode).First(&enterpriseInfo).Error; err != nil {
+		if err == gorm.ErrRecordNotFound {
+			return nil, fmt.Errorf("企业信息不存在")
+		}
+		r.logger.Error("获取企业信息失败", zap.Error(err))
+		return nil, fmt.Errorf("获取企业信息失败: %w", err)
+	}
+	return &enterpriseInfo, nil
+}
+
+// CheckUnifiedSocialCodeExists 检查统一社会信用代码是否已存在
+func (r *GormEnterpriseInfoRepository) CheckUnifiedSocialCodeExists(ctx context.Context, unifiedSocialCode string, excludeUserID string) (bool, error) {
+	var count int64
+	query := r.db.WithContext(ctx).Model(&entities.EnterpriseInfo{}).Where("unified_social_code = ?", unifiedSocialCode)
+
+	if excludeUserID != "" {
+		query = query.Where("user_id != ?", excludeUserID)
+	}
+
+	if err := query.Count(&count).Error; err != nil {
+		r.logger.Error("检查统一社会信用代码失败", zap.Error(err))
+		return false, fmt.Errorf("检查统一社会信用代码失败: %w", err)
+	}
+
+	return count > 0, nil
+}
+
+// UpdateVerificationStatus 更新验证状态
+func (r *GormEnterpriseInfoRepository) UpdateVerificationStatus(ctx context.Context, userID string, isOCRVerified, isFaceVerified, isCertified bool) error {
+	updates := map[string]interface{}{
+		"is_ocr_verified":  isOCRVerified,
+		"is_face_verified": isFaceVerified,
+		"is_certified":     isCertified,
+	}
+
+	if err := r.db.WithContext(ctx).Model(&entities.EnterpriseInfo{}).Where("user_id = ?", userID).Updates(updates).Error; err != nil {
+		r.logger.Error("更新验证状态失败", zap.Error(err))
+		return fmt.Errorf("更新验证状态失败: %w", err)
+	}
+
+	return nil
+}
+
+// UpdateOCRData 更新OCR数据
+func (r *GormEnterpriseInfoRepository) UpdateOCRData(ctx context.Context, userID string, rawData string, confidence float64) error {
+	updates := map[string]interface{}{
+		"ocr_raw_data":    rawData,
+		"ocr_confidence":  confidence,
+		"is_ocr_verified": true,
+	}
+
+	if err := r.db.WithContext(ctx).Model(&entities.EnterpriseInfo{}).Where("user_id = ?", userID).Updates(updates).Error; err != nil {
+		r.logger.Error("更新OCR数据失败", zap.Error(err))
+		return fmt.Errorf("更新OCR数据失败: %w", err)
+	}
+
+	return nil
+}
+
+// CompleteCertification 完成认证
+func (r *GormEnterpriseInfoRepository) CompleteCertification(ctx context.Context, userID string) error {
+	now := time.Now()
+	updates := map[string]interface{}{
+		"is_certified": true,
+		"certified_at": &now,
+	}
+
+	if err := r.db.WithContext(ctx).Model(&entities.EnterpriseInfo{}).Where("user_id = ?", userID).Updates(updates).Error; err != nil {
+		r.logger.Error("完成认证失败", zap.Error(err))
+		return fmt.Errorf("完成认证失败: %w", err)
+	}
+
+	return nil
+}
+
+// Count 统计企业信息数量
+func (r *GormEnterpriseInfoRepository) Count(ctx context.Context, options interfaces.CountOptions) (int64, error) {
+	var count int64
+	query := r.db.WithContext(ctx).Model(&entities.EnterpriseInfo{})
+
+	if options.Filters != nil {
+		for key, value := range options.Filters {
+			query = query.Where(key+" = ?", value)
+		}
+	}
+
+	if options.Search != "" {
+		query = query.Where("company_name LIKE ? OR unified_social_code LIKE ?", "%"+options.Search+"%", "%"+options.Search+"%")
+	}
+
+	err := query.Count(&count).Error
+	return count, err
+}
+
+// Exists 检查企业信息是否存在
+func (r *GormEnterpriseInfoRepository) Exists(ctx context.Context, id string) (bool, error) {
+	var count int64
+	err := r.db.WithContext(ctx).Model(&entities.EnterpriseInfo{}).Where("id = ?", id).Count(&count).Error
+	return count > 0, err
+}
+
+// CreateBatch 批量创建企业信息
+func (r *GormEnterpriseInfoRepository) CreateBatch(ctx context.Context, enterpriseInfos []entities.EnterpriseInfo) error {
+	return r.db.WithContext(ctx).Create(&enterpriseInfos).Error
+}
+
+// GetByIDs 根据ID列表获取企业信息
+func (r *GormEnterpriseInfoRepository) GetByIDs(ctx context.Context, ids []string) ([]entities.EnterpriseInfo, error) {
+	var enterpriseInfos []entities.EnterpriseInfo
+	err := r.db.WithContext(ctx).Where("id IN ?", ids).Find(&enterpriseInfos).Error
+	return enterpriseInfos, err
+}
+
+// UpdateBatch 批量更新企业信息
+func (r *GormEnterpriseInfoRepository) UpdateBatch(ctx context.Context, enterpriseInfos []entities.EnterpriseInfo) error {
+	return r.db.WithContext(ctx).Save(&enterpriseInfos).Error
+}
+
+// DeleteBatch 批量删除企业信息
+func (r *GormEnterpriseInfoRepository) DeleteBatch(ctx context.Context, ids []string) error {
+	return r.db.WithContext(ctx).Delete(&entities.EnterpriseInfo{}, "id IN ?", ids).Error
+}
+
+// List 获取企业信息列表
+func (r *GormEnterpriseInfoRepository) List(ctx context.Context, options interfaces.ListOptions) ([]entities.EnterpriseInfo, error) {
+	var enterpriseInfos []entities.EnterpriseInfo
+	query := r.db.WithContext(ctx).Model(&entities.EnterpriseInfo{})
+
+	if options.Filters != nil {
+		for key, value := range options.Filters {
+			query = query.Where(key+" = ?", value)
+		}
+	}
+
+	if options.Search != "" {
+		query = query.Where("company_name LIKE ? OR unified_social_code LIKE ?", "%"+options.Search+"%", "%"+options.Search+"%")
+	}
+
+	if options.Sort != "" {
+		order := "ASC"
+		if options.Order != "" {
+			order = options.Order
+		}
+		query = query.Order(options.Sort + " " + order)
+	}
+
+	if options.Page > 0 && options.PageSize > 0 {
+		offset := (options.Page - 1) * options.PageSize
+		query = query.Offset(offset).Limit(options.PageSize)
+	}
+
+	err := query.Find(&enterpriseInfos).Error
+	return enterpriseInfos, err
+}
+
+// WithTx 使用事务
+func (r *GormEnterpriseInfoRepository) WithTx(tx interface{}) interfaces.Repository[entities.EnterpriseInfo] {
+	if gormTx, ok := tx.(*gorm.DB); ok {
+		return &GormEnterpriseInfoRepository{
+			db:     gormTx,
+			logger: r.logger,
+		}
+	}
+	return r
+}

internal/infrastructure/database/repositories/user/gorm_sms_code_repository.go

@@ -0,0 +1,499 @@
+//go:build !test
+// +build !test
+
+package repositories
+
+import (
+	"context"
+	"fmt"
+	"time"
+
+	"go.uber.org/zap"
+	"gorm.io/gorm"
+
+	"tyapi-server/internal/domains/user/entities"
+	"tyapi-server/internal/domains/user/repositories"
+	"tyapi-server/internal/domains/user/repositories/queries"
+	"tyapi-server/internal/shared/interfaces"
+)
+
+// SMSCodeRepository 短信验证码仓储
+type GormSMSCodeRepository struct {
+	db     *gorm.DB
+	cache  interfaces.CacheService
+	logger *zap.Logger
+}
+
+// NewGormSMSCodeRepository 创建短信验证码仓储
+func NewGormSMSCodeRepository(db *gorm.DB, cache interfaces.CacheService, logger *zap.Logger) repositories.SMSCodeRepository {
+	return &GormSMSCodeRepository{
+		db:     db,
+		cache:  cache,
+		logger: logger,
+	}
+}
+
+// 确保 GormSMSCodeRepository 实现了 SMSCodeRepository 接口
+var _ repositories.SMSCodeRepository = (*GormSMSCodeRepository)(nil)
+
+// ================ 基础CRUD操作 ================
+
+// Create 创建短信验证码记录
+func (r *GormSMSCodeRepository) Create(ctx context.Context, smsCode entities.SMSCode) (entities.SMSCode, error) {
+	if err := r.db.WithContext(ctx).Create(&smsCode).Error; err != nil {
+		r.logger.Error("创建短信验证码失败", zap.Error(err))
+		return entities.SMSCode{}, err
+	}
+
+	// 缓存验证码
+	cacheKey := r.buildCacheKey(smsCode.Phone, smsCode.Scene)
+	r.cache.Set(ctx, cacheKey, &smsCode, 5*time.Minute)
+
+	return smsCode, nil
+}
+
+// GetByID 根据ID获取短信验证码
+func (r *GormSMSCodeRepository) GetByID(ctx context.Context, id string) (entities.SMSCode, error) {
+	var smsCode entities.SMSCode
+	if err := r.db.WithContext(ctx).Where("id = ?", id).First(&smsCode).Error; err != nil {
+		if err == gorm.ErrRecordNotFound {
+			return entities.SMSCode{}, fmt.Errorf("短信验证码不存在")
+		}
+		r.logger.Error("获取短信验证码失败", zap.Error(err))
+		return entities.SMSCode{}, err
+	}
+
+	return smsCode, nil
+}
+
+// Update 更新验证码记录
+func (r *GormSMSCodeRepository) Update(ctx context.Context, smsCode entities.SMSCode) error {
+	if err := r.db.WithContext(ctx).Save(&smsCode).Error; err != nil {
+		r.logger.Error("更新验证码记录失败", zap.Error(err))
+		return err
+	}
+
+	// 更新缓存
+	cacheKey := r.buildCacheKey(smsCode.Phone, smsCode.Scene)
+	r.cache.Set(ctx, cacheKey, &smsCode, 5*time.Minute)
+
+	r.logger.Info("验证码记录更新成功", zap.String("code_id", smsCode.ID))
+	return nil
+}
+
+// Delete 删除短信验证码
+func (r *GormSMSCodeRepository) Delete(ctx context.Context, id string) error {
+	if err := r.db.WithContext(ctx).Delete(&entities.SMSCode{}, "id = ?", id).Error; err != nil {
+		r.logger.Error("删除短信验证码失败", zap.Error(err))
+		return err
+	}
+
+	r.logger.Info("短信验证码删除成功", zap.String("id", id))
+	return nil
+}
+
+// SoftDelete 软删除短信验证码
+func (r *GormSMSCodeRepository) SoftDelete(ctx context.Context, id string) error {
+	return r.Delete(ctx, id)
+}
+
+// Restore 恢复短信验证码
+func (r *GormSMSCodeRepository) Restore(ctx context.Context, id string) error {
+	if err := r.db.WithContext(ctx).Unscoped().Model(&entities.SMSCode{}).Where("id = ?", id).Update("deleted_at", nil).Error; err != nil {
+		r.logger.Error("恢复短信验证码失败", zap.Error(err))
+		return err
+	}
+
+	r.logger.Info("短信验证码恢复成功", zap.String("id", id))
+	return nil
+}
+
+// Count 统计短信验证码数量
+func (r *GormSMSCodeRepository) Count(ctx context.Context, options interfaces.CountOptions) (int64, error) {
+	var count int64
+	query := r.db.WithContext(ctx).Model(&entities.SMSCode{})
+
+	if options.Filters != nil {
+		for key, value := range options.Filters {
+			query = query.Where(key+" = ?", value)
+		}
+	}
+
+	if options.Search != "" {
+		query = query.Where("phone LIKE ? OR code LIKE ?", "%"+options.Search+"%", "%"+options.Search+"%")
+	}
+
+	err := query.Count(&count).Error
+	return count, err
+}
+
+// Exists 检查短信验证码是否存在
+func (r *GormSMSCodeRepository) Exists(ctx context.Context, id string) (bool, error) {
+	var count int64
+	err := r.db.WithContext(ctx).Model(&entities.SMSCode{}).Where("id = ?", id).Count(&count).Error
+	return count > 0, err
+}
+
+// CreateBatch 批量创建短信验证码
+func (r *GormSMSCodeRepository) CreateBatch(ctx context.Context, smsCodes []entities.SMSCode) error {
+	r.logger.Info("批量创建短信验证码", zap.Int("count", len(smsCodes)))
+	return r.db.WithContext(ctx).Create(&smsCodes).Error
+}
+
+// GetByIDs 根据ID列表获取短信验证码
+func (r *GormSMSCodeRepository) GetByIDs(ctx context.Context, ids []string) ([]entities.SMSCode, error) {
+	var smsCodes []entities.SMSCode
+	err := r.db.WithContext(ctx).Where("id IN ?", ids).Find(&smsCodes).Error
+	return smsCodes, err
+}
+
+// UpdateBatch 批量更新短信验证码
+func (r *GormSMSCodeRepository) UpdateBatch(ctx context.Context, smsCodes []entities.SMSCode) error {
+	r.logger.Info("批量更新短信验证码", zap.Int("count", len(smsCodes)))
+	return r.db.WithContext(ctx).Save(&smsCodes).Error
+}
+
+// DeleteBatch 批量删除短信验证码
+func (r *GormSMSCodeRepository) DeleteBatch(ctx context.Context, ids []string) error {
+	r.logger.Info("批量删除短信验证码", zap.Strings("ids", ids))
+	return r.db.WithContext(ctx).Delete(&entities.SMSCode{}, "id IN ?", ids).Error
+}
+
+// List 获取短信验证码列表
+func (r *GormSMSCodeRepository) List(ctx context.Context, options interfaces.ListOptions) ([]entities.SMSCode, error) {
+	var smsCodes []entities.SMSCode
+	query := r.db.WithContext(ctx).Model(&entities.SMSCode{})
+
+	if options.Filters != nil {
+		for key, value := range options.Filters {
+			query = query.Where(key+" = ?", value)
+		}
+	}
+
+	if options.Search != "" {
+		query = query.Where("phone LIKE ? OR code LIKE ?", "%"+options.Search+"%", "%"+options.Search+"%")
+	}
+
+	if options.Sort != "" {
+		order := "ASC"
+		if options.Order != "" {
+			order = options.Order
+		}
+		query = query.Order(options.Sort + " " + order)
+	}
+
+	if options.Page > 0 && options.PageSize > 0 {
+		offset := (options.Page - 1) * options.PageSize
+		query = query.Offset(offset).Limit(options.PageSize)
+	}
+
+	return smsCodes, query.Find(&smsCodes).Error
+}
+
+// WithTx 使用事务
+func (r *GormSMSCodeRepository) WithTx(tx interface{}) interfaces.Repository[entities.SMSCode] {
+	if gormTx, ok := tx.(*gorm.DB); ok {
+		return &GormSMSCodeRepository{
+			db:     gormTx,
+			cache:  r.cache,
+			logger: r.logger,
+		}
+	}
+	return r
+}
+
+// ================ 业务方法 ================
+
+// GetByPhone 根据手机号获取短信验证码
+func (r *GormSMSCodeRepository) GetByPhone(ctx context.Context, phone string) (*entities.SMSCode, error) {
+	var smsCode entities.SMSCode
+	if err := r.db.WithContext(ctx).Where("phone = ?", phone).Order("created_at DESC").First(&smsCode).Error; err != nil {
+		if err == gorm.ErrRecordNotFound {
+			return nil, fmt.Errorf("短信验证码不存在")
+		}
+		r.logger.Error("根据手机号获取短信验证码失败", zap.Error(err))
+		return nil, err
+	}
+
+	return &smsCode, nil
+}
+
+// GetLatestByPhone 根据手机号获取最新的短信验证码
+func (r *GormSMSCodeRepository) GetLatestByPhone(ctx context.Context, phone string) (*entities.SMSCode, error) {
+	return r.GetByPhone(ctx, phone)
+}
+
+// GetValidByPhone 根据手机号获取有效的短信验证码
+func (r *GormSMSCodeRepository) GetValidByPhone(ctx context.Context, phone string) (*entities.SMSCode, error) {
+	return r.GetValidCode(ctx, phone, "")
+}
+
+// GetValidByPhoneAndScene 根据手机号和场景获取有效的验证码
+func (r *GormSMSCodeRepository) GetValidByPhoneAndScene(ctx context.Context, phone string, scene entities.SMSScene) (*entities.SMSCode, error) {
+	return r.GetValidCode(ctx, phone, scene)
+}
+
+// ListSMSCodes 获取短信验证码列表（带分页和筛选）
+func (r *GormSMSCodeRepository) ListSMSCodes(ctx context.Context, query *queries.ListSMSCodesQuery) ([]*entities.SMSCode, int64, error) {
+	var smsCodes []entities.SMSCode
+	var total int64
+
+	dbQuery := r.db.WithContext(ctx).Model(&entities.SMSCode{})
+
+	// 应用筛选条件
+	if query.Phone != "" {
+		dbQuery = dbQuery.Where("phone = ?", query.Phone)
+	}
+	if query.Purpose != "" {
+		dbQuery = dbQuery.Where("scene = ?", query.Purpose)
+	}
+	if query.Status != "" {
+		dbQuery = dbQuery.Where("status = ?", query.Status)
+	}
+	if query.StartDate != "" {
+		dbQuery = dbQuery.Where("created_at >= ?", query.StartDate)
+	}
+	if query.EndDate != "" {
+		dbQuery = dbQuery.Where("created_at <= ?", query.EndDate)
+	}
+
+	// 统计总数
+	if err := dbQuery.Count(&total).Error; err != nil {
+		return nil, 0, err
+	}
+
+	// 应用分页
+	offset := (query.Page - 1) * query.PageSize
+	dbQuery = dbQuery.Offset(offset).Limit(query.PageSize)
+
+	// 默认排序
+	dbQuery = dbQuery.Order("created_at DESC")
+
+	// 查询数据
+	if err := dbQuery.Find(&smsCodes).Error; err != nil {
+		return nil, 0, err
+	}
+
+	// 转换为指针切片
+	smsCodePtrs := make([]*entities.SMSCode, len(smsCodes))
+	for i := range smsCodes {
+		smsCodePtrs[i] = &smsCodes[i]
+	}
+
+	return smsCodePtrs, total, nil
+}
+
+// CreateCode 创建验证码
+func (r *GormSMSCodeRepository) CreateCode(ctx context.Context, phone string, code string, purpose string) (entities.SMSCode, error) {
+	smsCode := entities.SMSCode{
+		Phone:     phone,
+		Code:      code,
+		Scene:     entities.SMSScene(purpose),
+		ExpiresAt: time.Now().Add(5 * time.Minute), // 5分钟过期
+		Used:      false,
+	}
+
+	return r.Create(ctx, smsCode)
+}
+
+// ValidateCode 验证验证码
+func (r *GormSMSCodeRepository) ValidateCode(ctx context.Context, phone string, code string, purpose string) (bool, error) {
+	var smsCode entities.SMSCode
+	if err := r.db.WithContext(ctx).
+		Where("phone = ? AND code = ? AND scene = ? AND expires_at > ? AND used_at IS NULL",
+			phone, code, purpose, time.Now()).
+		First(&smsCode).Error; err != nil {
+		if err == gorm.ErrRecordNotFound {
+			return false, nil
+		}
+		r.logger.Error("验证验证码失败", zap.Error(err))
+		return false, err
+	}
+
+	// 标记为已使用
+	if err := r.MarkAsUsed(ctx, smsCode.ID); err != nil {
+		r.logger.Error("标记验证码为已使用失败", zap.Error(err))
+		return false, err
+	}
+
+	return true, nil
+}
+
+// InvalidateCode 使验证码失效
+func (r *GormSMSCodeRepository) InvalidateCode(ctx context.Context, phone string) error {
+	if err := r.db.WithContext(ctx).
+		Model(&entities.SMSCode{}).
+		Where("phone = ? AND used_at IS NULL", phone).
+		Update("used_at", time.Now()).Error; err != nil {
+		r.logger.Error("使验证码失效失败", zap.Error(err))
+		return err
+	}
+
+	// 清除缓存
+	cacheKey := r.buildCacheKey(phone, "")
+	r.cache.Delete(ctx, cacheKey)
+
+	r.logger.Info("验证码已失效", zap.String("phone", phone))
+	return nil
+}
+
+// CheckSendFrequency 检查发送频率
+func (r *GormSMSCodeRepository) CheckSendFrequency(ctx context.Context, phone string, purpose string) (bool, error) {
+	// 检查最近1分钟内是否已发送
+	oneMinuteAgo := time.Now().Add(-1 * time.Minute)
+	var count int64
+	if err := r.db.WithContext(ctx).
+		Model(&entities.SMSCode{}).
+		Where("phone = ? AND scene = ? AND created_at > ?", phone, purpose, oneMinuteAgo).
+		Count(&count).Error; err != nil {
+		r.logger.Error("检查发送频率失败", zap.Error(err))
+		return false, err
+	}
+
+	return count == 0, nil
+}
+
+// GetTodaySendCount 获取今日发送次数
+func (r *GormSMSCodeRepository) GetTodaySendCount(ctx context.Context, phone string) (int64, error) {
+	today := time.Now().Truncate(24 * time.Hour)
+	var count int64
+	if err := r.db.WithContext(ctx).
+		Model(&entities.SMSCode{}).
+		Where("phone = ? AND created_at >= ?", phone, today).
+		Count(&count).Error; err != nil {
+		r.logger.Error("获取今日发送次数失败", zap.Error(err))
+		return 0, err
+	}
+
+	return count, nil
+}
+
+// GetCodeStats 获取验证码统计信息
+func (r *GormSMSCodeRepository) GetCodeStats(ctx context.Context, phone string, days int) (*repositories.SMSCodeStats, error) {
+	var stats repositories.SMSCodeStats
+
+	// 计算指定天数前的日期
+	startDate := time.Now().AddDate(0, 0, -days)
+
+	// 总发送数
+	if err := r.db.WithContext(ctx).
+		Model(&entities.SMSCode{}).
+		Where("phone = ? AND created_at >= ?", phone, startDate).
+		Count(&stats.TotalSent).Error; err != nil {
+		return nil, err
+	}
+
+	// 总验证数
+	if err := r.db.WithContext(ctx).
+		Model(&entities.SMSCode{}).
+		Where("phone = ? AND created_at >= ? AND used_at IS NOT NULL", phone, startDate).
+		Count(&stats.TotalValidated).Error; err != nil {
+		return nil, err
+	}
+
+	// 成功率
+	if stats.TotalSent > 0 {
+		stats.SuccessRate = float64(stats.TotalValidated) / float64(stats.TotalSent) * 100
+	}
+
+	// 今日发送数
+	today := time.Now().Truncate(24 * time.Hour)
+	if err := r.db.WithContext(ctx).
+		Model(&entities.SMSCode{}).
+		Where("phone = ? AND created_at >= ?", phone, today).
+		Count(&stats.TodaySent).Error; err != nil {
+		return nil, err
+	}
+
+	return &stats, nil
+}
+
+// GetValidCode 获取有效的验证码
+func (r *GormSMSCodeRepository) GetValidCode(ctx context.Context, phone string, scene entities.SMSScene) (*entities.SMSCode, error) {
+	// 先从缓存查找
+	cacheKey := r.buildCacheKey(phone, scene)
+	var smsCode entities.SMSCode
+	if err := r.cache.Get(ctx, cacheKey, &smsCode); err == nil {
+		return &smsCode, nil
+	}
+
+	// 从数据库查找最新的有效验证码
+	if err := r.db.WithContext(ctx).
+		Where("phone = ? AND scene = ? AND expires_at > ? AND used_at IS NULL",
+			phone, scene, time.Now()).
+		Order("created_at DESC").
+		First(&smsCode).Error; err != nil {
+		return nil, err
+	}
+
+	// 缓存结果
+	r.cache.Set(ctx, cacheKey, &smsCode, 5*time.Minute)
+
+	return &smsCode, nil
+}
+
+// MarkAsUsed 标记验证码为已使用
+func (r *GormSMSCodeRepository) MarkAsUsed(ctx context.Context, id string) error {
+	now := time.Now()
+	if err := r.db.WithContext(ctx).
+		Model(&entities.SMSCode{}).
+		Where("id = ?", id).
+		Update("used_at", now).Error; err != nil {
+		r.logger.Error("标记验证码为已使用失败", zap.Error(err))
+		return err
+	}
+
+	r.logger.Info("验证码已标记为使用", zap.String("code_id", id))
+	return nil
+}
+
+// GetRecentCode 获取最近的验证码记录（不限制有效性）
+func (r *GormSMSCodeRepository) GetRecentCode(ctx context.Context, phone string, scene entities.SMSScene) (*entities.SMSCode, error) {
+	var smsCode entities.SMSCode
+	if err := r.db.WithContext(ctx).
+		Where("phone = ? AND scene = ?", phone, scene).
+		Order("created_at DESC").
+		First(&smsCode).Error; err != nil {
+		return nil, err
+	}
+
+	return &smsCode, nil
+}
+
+// CleanupExpired 清理过期的验证码
+func (r *GormSMSCodeRepository) CleanupExpired(ctx context.Context) error {
+	result := r.db.WithContext(ctx).
+		Where("expires_at < ?", time.Now()).
+		Delete(&entities.SMSCode{})
+
+	if result.Error != nil {
+		r.logger.Error("清理过期验证码失败", zap.Error(result.Error))
+		return result.Error
+	}
+
+	if result.RowsAffected > 0 {
+		r.logger.Info("清理过期验证码完成", zap.Int64("count", result.RowsAffected))
+	}
+
+	return nil
+}
+
+// CountRecentCodes 统计最近发送的验证码数量
+func (r *GormSMSCodeRepository) CountRecentCodes(ctx context.Context, phone string, scene entities.SMSScene, duration time.Duration) (int64, error) {
+	var count int64
+	if err := r.db.WithContext(ctx).
+		Model(&entities.SMSCode{}).
+		Where("phone = ? AND scene = ? AND created_at > ?",
+			phone, scene, time.Now().Add(-duration)).
+		Count(&count).Error; err != nil {
+		r.logger.Error("统计最近验证码数量失败", zap.Error(err))
+		return 0, err
+	}
+
+	return count, nil
+}
+
+// buildCacheKey 构建缓存键
+func (r *GormSMSCodeRepository) buildCacheKey(phone string, scene entities.SMSScene) string {
+	return fmt.Sprintf("sms_code:%s:%s", phone, string(scene))
+}

internal/infrastructure/database/repositories/user/gorm_user_repository.go

@@ -0,0 +1,511 @@
+//go:build !test
+// +build !test
+
+package repositories
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"time"
+
+	"go.uber.org/zap"
+	"gorm.io/gorm"
+
+	"tyapi-server/internal/domains/user/entities"
+	"tyapi-server/internal/domains/user/repositories"
+	"tyapi-server/internal/domains/user/repositories/queries"
+	"tyapi-server/internal/shared/interfaces"
+)
+
+// 定义错误常量
+var (
+	// ErrUserNotFound 用户不存在错误
+	ErrUserNotFound = errors.New("用户不存在")
+)
+
+// UserRepository 用户仓储实现
+type GormUserRepository struct {
+	db     *gorm.DB
+	cache  interfaces.CacheService
+	logger *zap.Logger
+}
+
+// NewGormUserRepository 创建用户仓储
+func NewGormUserRepository(db *gorm.DB, cache interfaces.CacheService, logger *zap.Logger) repositories.UserRepository {
+	return &GormUserRepository{
+		db:     db,
+		cache:  cache,
+		logger: logger,
+	}
+}
+
+// 确保 GormUserRepository 实现了 UserRepository 接口
+var _ repositories.UserRepository = (*GormUserRepository)(nil)
+
+// ================ 基础CRUD操作 ================
+
+// Create 创建用户
+func (r *GormUserRepository) Create(ctx context.Context, user entities.User) (entities.User, error) {
+	if err := r.db.WithContext(ctx).Create(&user).Error; err != nil {
+		r.logger.Error("创建用户失败", zap.Error(err))
+		return entities.User{}, err
+	}
+
+	// 清除相关缓存
+	r.deleteCacheByPhone(ctx, user.Phone)
+
+	r.logger.Info("用户创建成功", zap.String("user_id", user.ID))
+	return user, nil
+}
+
+// GetByID 根据ID获取用户
+func (r *GormUserRepository) GetByID(ctx context.Context, id string) (entities.User, error) {
+	// 尝试从缓存获取
+	cacheKey := fmt.Sprintf("user:id:%s", id)
+	var userCache entities.UserCache
+	if err := r.cache.Get(ctx, cacheKey, &userCache); err == nil {
+		var user entities.User
+		user.FromCache(&userCache)
+		return user, nil
+	}
+
+	// 从数据库查询
+	var user entities.User
+	if err := r.db.WithContext(ctx).Where("id = ?", id).First(&user).Error; err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			return entities.User{}, ErrUserNotFound
+		}
+		r.logger.Error("根据ID查询用户失败", zap.Error(err))
+		return entities.User{}, err
+	}
+
+	// 缓存结果
+	r.cache.Set(ctx, cacheKey, user.ToCache(), 10*time.Minute)
+
+	return user, nil
+}
+
+// Update 更新用户
+func (r *GormUserRepository) Update(ctx context.Context, user entities.User) error {
+	if err := r.db.WithContext(ctx).Save(&user).Error; err != nil {
+		r.logger.Error("更新用户失败", zap.Error(err))
+		return err
+	}
+
+	// 清除相关缓存
+	r.deleteCacheByID(ctx, user.ID)
+	r.deleteCacheByPhone(ctx, user.Phone)
+
+	r.logger.Info("用户更新成功", zap.String("user_id", user.ID))
+	return nil
+}
+
+// Delete 删除用户
+func (r *GormUserRepository) Delete(ctx context.Context, id string) error {
+	// 先获取用户信息用于清除缓存
+	user, err := r.GetByID(ctx, id)
+	if err != nil {
+		return err
+	}
+
+	if err := r.db.WithContext(ctx).Delete(&entities.User{}, "id = ?", id).Error; err != nil {
+		r.logger.Error("删除用户失败", zap.Error(err))
+		return err
+	}
+
+	// 清除相关缓存
+	r.deleteCacheByID(ctx, id)
+	r.deleteCacheByPhone(ctx, user.Phone)
+
+	r.logger.Info("用户删除成功", zap.String("user_id", id))
+	return nil
+}
+
+// SoftDelete 软删除用户
+func (r *GormUserRepository) SoftDelete(ctx context.Context, id string) error {
+	// 先获取用户信息用于清除缓存
+	user, err := r.GetByID(ctx, id)
+	if err != nil {
+		return err
+	}
+
+	if err := r.db.WithContext(ctx).Delete(&entities.User{}, "id = ?", id).Error; err != nil {
+		r.logger.Error("软删除用户失败", zap.Error(err))
+		return err
+	}
+
+	// 清除相关缓存
+	r.deleteCacheByID(ctx, id)
+	r.deleteCacheByPhone(ctx, user.Phone)
+
+	r.logger.Info("用户软删除成功", zap.String("user_id", id))
+	return nil
+}
+
+// Restore 恢复软删除的用户
+func (r *GormUserRepository) Restore(ctx context.Context, id string) error {
+	if err := r.db.WithContext(ctx).Unscoped().Model(&entities.User{}).Where("id = ?", id).Update("deleted_at", nil).Error; err != nil {
+		r.logger.Error("恢复用户失败", zap.Error(err))
+		return err
+	}
+
+	// 清除相关缓存
+	r.deleteCacheByID(ctx, id)
+
+	r.logger.Info("用户恢复成功", zap.String("user_id", id))
+	return nil
+}
+
+// Count 统计用户数量
+func (r *GormUserRepository) Count(ctx context.Context, options interfaces.CountOptions) (int64, error) {
+	var count int64
+	query := r.db.WithContext(ctx).Model(&entities.User{})
+
+	if options.Filters != nil {
+		for key, value := range options.Filters {
+			query = query.Where(key+" = ?", value)
+		}
+	}
+
+	if options.Search != "" {
+		query = query.Where("phone LIKE ? OR nickname LIKE ?", "%"+options.Search+"%", "%"+options.Search+"%")
+	}
+
+	err := query.Count(&count).Error
+	return count, err
+}
+
+// Exists 检查用户是否存在
+func (r *GormUserRepository) Exists(ctx context.Context, id string) (bool, error) {
+	var count int64
+	err := r.db.WithContext(ctx).Model(&entities.User{}).Where("id = ?", id).Count(&count).Error
+	return count > 0, err
+}
+
+// CreateBatch 批量创建用户
+func (r *GormUserRepository) CreateBatch(ctx context.Context, users []entities.User) error {
+	r.logger.Info("批量创建用户", zap.Int("count", len(users)))
+	return r.db.WithContext(ctx).Create(&users).Error
+}
+
+// GetByIDs 根据ID列表获取用户
+func (r *GormUserRepository) GetByIDs(ctx context.Context, ids []string) ([]entities.User, error) {
+	var users []entities.User
+	err := r.db.WithContext(ctx).Where("id IN ?", ids).Find(&users).Error
+	return users, err
+}
+
+// UpdateBatch 批量更新用户
+func (r *GormUserRepository) UpdateBatch(ctx context.Context, users []entities.User) error {
+	r.logger.Info("批量更新用户", zap.Int("count", len(users)))
+	return r.db.WithContext(ctx).Save(&users).Error
+}
+
+// DeleteBatch 批量删除用户
+func (r *GormUserRepository) DeleteBatch(ctx context.Context, ids []string) error {
+	r.logger.Info("批量删除用户", zap.Strings("ids", ids))
+	return r.db.WithContext(ctx).Delete(&entities.User{}, "id IN ?", ids).Error
+}
+
+// List 获取用户列表
+func (r *GormUserRepository) List(ctx context.Context, options interfaces.ListOptions) ([]entities.User, error) {
+	var users []entities.User
+	query := r.db.WithContext(ctx).Model(&entities.User{})
+
+	if options.Filters != nil {
+		for key, value := range options.Filters {
+			query = query.Where(key+" = ?", value)
+		}
+	}
+
+	if options.Search != "" {
+		query = query.Where("phone LIKE ? OR nickname LIKE ?", "%"+options.Search+"%", "%"+options.Search+"%")
+	}
+
+	if options.Sort != "" {
+		order := "ASC"
+		if options.Order != "" {
+			order = options.Order
+		}
+		query = query.Order(options.Sort + " " + order)
+	}
+
+	if options.Page > 0 && options.PageSize > 0 {
+		offset := (options.Page - 1) * options.PageSize
+		query = query.Offset(offset).Limit(options.PageSize)
+	}
+
+	return users, query.Find(&users).Error
+}
+
+// WithTx 使用事务
+func (r *GormUserRepository) WithTx(tx interface{}) interfaces.Repository[entities.User] {
+	if gormTx, ok := tx.(*gorm.DB); ok {
+		return &GormUserRepository{
+			db:     gormTx,
+			cache:  r.cache,
+			logger: r.logger,
+		}
+	}
+	return r
+}
+
+// ================ 业务方法 ================
+
+// GetByPhone 根据手机号获取用户
+func (r *GormUserRepository) GetByPhone(ctx context.Context, phone string) (*entities.User, error) {
+	// 尝试从缓存获取
+	cacheKey := fmt.Sprintf("user:phone:%s", phone)
+	var userCache entities.UserCache
+	if err := r.cache.Get(ctx, cacheKey, &userCache); err == nil {
+		var user entities.User
+		user.FromCache(&userCache)
+		return &user, nil
+	}
+
+	// 从数据库查询
+	var user entities.User
+	if err := r.db.WithContext(ctx).Where("phone = ?", phone).First(&user).Error; err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			return nil, ErrUserNotFound
+		}
+		r.logger.Error("根据手机号查询用户失败", zap.Error(err))
+		return nil, err
+	}
+
+	// 缓存结果
+	r.cache.Set(ctx, cacheKey, user.ToCache(), 10*time.Minute)
+
+	return &user, nil
+}
+
+// ListUsers 获取用户列表（带分页和筛选）
+func (r *GormUserRepository) ListUsers(ctx context.Context, query *queries.ListUsersQuery) ([]*entities.User, int64, error) {
+	var users []entities.User
+	var total int64
+
+	dbQuery := r.db.WithContext(ctx).Model(&entities.User{})
+
+	// 应用筛选条件
+	if query.Phone != "" {
+		dbQuery = dbQuery.Where("phone LIKE ?", "%"+query.Phone+"%")
+	}
+	if query.StartDate != "" {
+		dbQuery = dbQuery.Where("created_at >= ?", query.StartDate)
+	}
+	if query.EndDate != "" {
+		dbQuery = dbQuery.Where("created_at <= ?", query.EndDate)
+	}
+
+	// 统计总数
+	if err := dbQuery.Count(&total).Error; err != nil {
+		return nil, 0, err
+	}
+
+	// 应用分页
+	offset := (query.Page - 1) * query.PageSize
+	dbQuery = dbQuery.Offset(offset).Limit(query.PageSize)
+
+	// 默认排序
+	dbQuery = dbQuery.Order("created_at DESC")
+
+	// 查询数据
+	if err := dbQuery.Find(&users).Error; err != nil {
+		return nil, 0, err
+	}
+
+	// 转换为指针切片
+	userPtrs := make([]*entities.User, len(users))
+	for i := range users {
+		userPtrs[i] = &users[i]
+	}
+
+	return userPtrs, total, nil
+}
+
+// ValidateUser 验证用户
+func (r *GormUserRepository) ValidateUser(ctx context.Context, phone, password string) (*entities.User, error) {
+	var user entities.User
+	if err := r.db.WithContext(ctx).Where("phone = ? AND password = ?", phone, password).First(&user).Error; err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			return nil, fmt.Errorf("手机号或密码错误")
+		}
+		r.logger.Error("验证用户失败", zap.Error(err))
+		return nil, err
+	}
+
+	return &user, nil
+}
+
+// UpdateLastLogin 更新最后登录时间
+func (r *GormUserRepository) UpdateLastLogin(ctx context.Context, userID string) error {
+	if err := r.db.WithContext(ctx).
+		Model(&entities.User{}).
+		Where("id = ?", userID).
+		Update("last_login_at", time.Now()).Error; err != nil {
+		r.logger.Error("更新最后登录时间失败", zap.Error(err))
+		return err
+	}
+
+	// 清除相关缓存
+	r.deleteCacheByID(ctx, userID)
+
+	r.logger.Info("最后登录时间更新成功", zap.String("user_id", userID))
+	return nil
+}
+
+// UpdatePassword 更新密码
+func (r *GormUserRepository) UpdatePassword(ctx context.Context, userID string, newPassword string) error {
+	if err := r.db.WithContext(ctx).
+		Model(&entities.User{}).
+		Where("id = ?", userID).
+		Update("password", newPassword).Error; err != nil {
+		r.logger.Error("更新密码失败", zap.Error(err))
+		return err
+	}
+
+	// 清除相关缓存
+	r.deleteCacheByID(ctx, userID)
+
+	r.logger.Info("密码更新成功", zap.String("user_id", userID))
+	return nil
+}
+
+// CheckPassword 检查密码
+func (r *GormUserRepository) CheckPassword(ctx context.Context, userID string, password string) (bool, error) {
+	var user entities.User
+	if err := r.db.WithContext(ctx).Where("id = ? AND password = ?", userID, password).First(&user).Error; err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			return false, nil
+		}
+		r.logger.Error("检查密码失败", zap.Error(err))
+		return false, err
+	}
+
+	return true, nil
+}
+
+// ActivateUser 激活用户
+func (r *GormUserRepository) ActivateUser(ctx context.Context, userID string) error {
+	if err := r.db.WithContext(ctx).
+		Model(&entities.User{}).
+		Where("id = ?", userID).
+		Update("status", "ACTIVE").Error; err != nil {
+		r.logger.Error("激活用户失败", zap.Error(err))
+		return err
+	}
+
+	// 清除相关缓存
+	r.deleteCacheByID(ctx, userID)
+
+	r.logger.Info("用户激活成功", zap.String("user_id", userID))
+	return nil
+}
+
+// DeactivateUser 停用用户
+func (r *GormUserRepository) DeactivateUser(ctx context.Context, userID string) error {
+	if err := r.db.WithContext(ctx).
+		Model(&entities.User{}).
+		Where("id = ?", userID).
+		Update("status", "INACTIVE").Error; err != nil {
+		r.logger.Error("停用用户失败", zap.Error(err))
+		return err
+	}
+
+	// 清除相关缓存
+	r.deleteCacheByID(ctx, userID)
+
+	r.logger.Info("用户停用成功", zap.String("user_id", userID))
+	return nil
+}
+
+// GetStats 获取用户统计信息
+func (r *GormUserRepository) GetStats(ctx context.Context) (*repositories.UserStats, error) {
+	var stats repositories.UserStats
+
+	// 总用户数
+	if err := r.db.WithContext(ctx).Model(&entities.User{}).Count(&stats.TotalUsers).Error; err != nil {
+		return nil, err
+	}
+
+	// 活跃用户数
+	if err := r.db.WithContext(ctx).Model(&entities.User{}).Where("status = ?", "ACTIVE").Count(&stats.ActiveUsers).Error; err != nil {
+		return nil, err
+	}
+
+	// 今日注册数
+	today := time.Now().Truncate(24 * time.Hour)
+	if err := r.db.WithContext(ctx).Model(&entities.User{}).Where("created_at >= ?", today).Count(&stats.TodayRegistrations).Error; err != nil {
+		return nil, err
+	}
+
+	// 今日登录数
+	if err := r.db.WithContext(ctx).Model(&entities.User{}).Where("last_login_at >= ?", today).Count(&stats.TodayLogins).Error; err != nil {
+		return nil, err
+	}
+
+	return &stats, nil
+}
+
+// GetStatsByDateRange 根据日期范围获取用户统计信息
+func (r *GormUserRepository) GetStatsByDateRange(ctx context.Context, startDate, endDate string) (*repositories.UserStats, error) {
+	var stats repositories.UserStats
+
+	// 总用户数
+	if err := r.db.WithContext(ctx).Model(&entities.User{}).Where("created_at BETWEEN ? AND ?", startDate, endDate).Count(&stats.TotalUsers).Error; err != nil {
+		return nil, err
+	}
+
+	// 活跃用户数
+	if err := r.db.WithContext(ctx).Model(&entities.User{}).Where("status = ? AND created_at BETWEEN ? AND ?", "ACTIVE", startDate, endDate).Count(&stats.ActiveUsers).Error; err != nil {
+		return nil, err
+	}
+
+	// 今日注册数
+	today := time.Now().Truncate(24 * time.Hour)
+	if err := r.db.WithContext(ctx).Model(&entities.User{}).Where("created_at >= ?", today).Count(&stats.TodayRegistrations).Error; err != nil {
+		return nil, err
+	}
+
+	// 今日登录数
+	if err := r.db.WithContext(ctx).Model(&entities.User{}).Where("last_login_at >= ?", today).Count(&stats.TodayLogins).Error; err != nil {
+		return nil, err
+	}
+
+	return &stats, nil
+}
+
+// FindByPhone 根据手机号查找用户（兼容旧方法）
+func (r *GormUserRepository) FindByPhone(ctx context.Context, phone string) (*entities.User, error) {
+	return r.GetByPhone(ctx, phone)
+}
+
+// ExistsByPhone 检查手机号是否存在
+func (r *GormUserRepository) ExistsByPhone(ctx context.Context, phone string) (bool, error) {
+	var count int64
+	if err := r.db.WithContext(ctx).Model(&entities.User{}).Where("phone = ?", phone).Count(&count).Error; err != nil {
+		r.logger.Error("检查手机号是否存在失败", zap.Error(err))
+		return false, err
+	}
+
+	return count > 0, nil
+}
+
+// 私有辅助方法
+
+// deleteCacheByID 根据ID删除缓存
+func (r *GormUserRepository) deleteCacheByID(ctx context.Context, id string) {
+	cacheKey := fmt.Sprintf("user:id:%s", id)
+	if err := r.cache.Delete(ctx, cacheKey); err != nil {
+		r.logger.Warn("删除用户ID缓存失败", zap.String("cache_key", cacheKey), zap.Error(err))
+	}
+}
+
+// deleteCacheByPhone 根据手机号删除缓存
+func (r *GormUserRepository) deleteCacheByPhone(ctx context.Context, phone string) {
+	cacheKey := fmt.Sprintf("user:phone:%s", phone)
+	if err := r.cache.Delete(ctx, cacheKey); err != nil {
+		r.logger.Warn("删除用户手机号缓存失败", zap.String("cache_key", cacheKey), zap.Error(err))
+	}
+}