pig-farm-controller/internal/infra/repository/plan_repository.go

package repository

import (
	"errors"
	"fmt"

	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
	"gorm.io/gorm"
)

// 定义仓库层可导出的公共错误
var (
	ErrUpdateWithInvalidRoot    = errors.New("更新操作的目标根计划无效或ID为0")
	ErrNewSubPlanInUpdate       = errors.New("计划树中包含一个ID为0的新子计划，更新操作只允许关联已存在的计划")
	ErrNodeDoesNotExist         = errors.New("计划树中包含一个或多个在数据库中不存在的计划")
	ErrCreateWithNonZeroID      = errors.New("创建操作的计划ID必须为0")
	ErrSubPlanIDIsZeroOnCreate  = errors.New("子计划ID为0，创建操作只允许关联已存在的计划")
	ErrMixedContent             = errors.New("计划不能同时包含任务和子计划")
	ErrDeleteWithReferencedPlan = errors.New("禁止删除正在被引用的计划")
)

// PlanRepository 定义了与计划模型相关的数据库操作接口
// 这是为了让业务逻辑层依赖于抽象，而不是具体的数据库实现
type PlanRepository interface {
	// ListBasicPlans 获取所有计划的基本信息，不包含子计划和任务详情
	ListBasicPlans() ([]models.Plan, error)
	// GetBasicPlanByID 根据ID获取计划的基本信息，不包含子计划和任务详情
	GetBasicPlanByID(id uint) (*models.Plan, error)
	// GetPlanByID 根据ID获取计划，包含子计划和任务详情
	GetPlanByID(id uint) (*models.Plan, error)
	// CreatePlan 创建一个新的计划
	CreatePlan(plan *models.Plan) error
	// UpdatePlan 更新计划，包括子计划和任务
	UpdatePlan(plan *models.Plan) error
	// DeletePlan 根据ID删除计划，同时删除其关联的任务（非子任务）或子计划关联
	DeletePlan(id uint) error
}

// gormPlanRepository 是 PlanRepository 的 GORM 实现
type gormPlanRepository struct {
	db *gorm.DB
}

// NewGormPlanRepository 创建一个新的 PlanRepository GORM 实现实例
func NewGormPlanRepository(db *gorm.DB) PlanRepository {
	return &gormPlanRepository{
		db: db,
	}
}

// ListBasicPlans 获取所有计划的基本信息，不包含子计划和任务详情
func (r *gormPlanRepository) ListBasicPlans() ([]models.Plan, error) {
	var plans []models.Plan
	// GORM 默认不会加载关联，除非使用 Preload，所以直接 Find 即可满足要求
	result := r.db.Find(&plans)
	if result.Error != nil {
		return nil, result.Error
	}
	return plans, nil
}

// GetBasicPlanByID 根据ID获取计划的基本信息，不包含子计划和任务详情
func (r *gormPlanRepository) GetBasicPlanByID(id uint) (*models.Plan, error) {
	var plan models.Plan
	// GORM 默认不会加载关联，除非使用 Preload，所以直接 First 即可满足要求
	result := r.db.First(&plan, id)
	if result.Error != nil {
		return nil, result.Error
	}
	return &plan, nil
}

// GetPlanByID 根据ID获取计划，包含子计划和任务详情
func (r *gormPlanRepository) GetPlanByID(id uint) (*models.Plan, error) {
	var plan models.Plan

	// 先获取基本计划信息
	result := r.db.First(&plan, id)
	if result.Error != nil {
		return nil, result.Error
	}

	// 根据内容类型加载关联数据
	switch plan.ContentType {
	case models.PlanContentTypeSubPlans:
		// 加载子计划引用
		var subPlans []models.SubPlan
		result = r.db.Where("parent_plan_id = ?", plan.ID).Order("execution_order").Find(&subPlans)
		if result.Error != nil {
			return nil, result.Error
		}

		// 递归加载每个子计划的完整信息
		for i := range subPlans {
			childPlan, err := r.GetPlanByID(subPlans[i].ChildPlanID)
			if err != nil {
				return nil, err
			}
			subPlans[i].ChildPlan = childPlan
		}

		plan.SubPlans = subPlans
	case models.PlanContentTypeTasks:
		// 加载任务
		result = r.db.Preload("Tasks", func(taskDB *gorm.DB) *gorm.DB {
			return taskDB.Order("execution_order")
		}).First(&plan, id)
		if result.Error != nil {
			return nil, result.Error
		}
	default:
		return nil, fmt.Errorf("未知的计划内容类型: %v; 计划ID: %v", plan.ContentType, plan.ID)
	}

	return &plan, nil
}

// CreatePlan 创建一个新的计划
func (r *gormPlanRepository) CreatePlan(plan *models.Plan) error {
	return r.db.Transaction(func(tx *gorm.DB) error {
		// 1. 前置校验
		if plan.ID != 0 {
			return ErrCreateWithNonZeroID
		}

		// 检查是否同时包含任务和子计划
		if len(plan.Tasks) > 0 && len(plan.SubPlans) > 0 {
			return ErrMixedContent
		}

		// 检查是否有重复的执行顺序
		if err := plan.ValidateExecutionOrder(); err != nil {
			return fmt.Errorf("计划 (ID: %d) 的执行顺序无效: %w", plan.ID, err)
		}

		// 如果是子计划类型，验证所有子计划是否存在且ID不为0
		if plan.ContentType == models.PlanContentTypeSubPlans {
			childIDsToValidate := make(map[uint]bool)
			for _, subPlanLink := range plan.SubPlans {
				if subPlanLink.ChildPlan == nil || subPlanLink.ChildPlan.ID == 0 {
					return ErrSubPlanIDIsZeroOnCreate
				}
				childIDsToValidate[subPlanLink.ChildPlan.ID] = true
			}

			var ids []uint
			for id := range childIDsToValidate {
				ids = append(ids, id)
			}

			if len(ids) > 0 {
				var count int64
				if err := tx.Model(&models.Plan{}).Where("id IN ?", ids).Count(&count).Error; err != nil {
					return fmt.Errorf("验证子计划存在性失败: %w", err)
				}
				if int(count) != len(ids) {
					return ErrNodeDoesNotExist
				}
			}
		}

		// 2. 创建根计划
		// GORM 会自动处理关联的 Tasks (如果 ContentType 是 tasks 且 Task.ID 为 0)
		if err := tx.Create(plan).Error; err != nil {
			return err
		}
		return nil
	})
}

// UpdatePlan 是更新计划的公共入口点
func (r *gormPlanRepository) UpdatePlan(plan *models.Plan) error {
	return r.db.Transaction(func(tx *gorm.DB) error {
		return r.updatePlanTx(tx, plan)
	})
}

// updatePlanTx 在事务中协调整个更新过程
func (r *gormPlanRepository) updatePlanTx(tx *gorm.DB, plan *models.Plan) error {
	if err := r.validatePlanTree(tx, plan); err != nil {
		return err
	}
	return r.reconcilePlanNode(tx, plan)
}

// validatePlanTree 对整个计划树进行全面的只读健康检查
func (r *gormPlanRepository) validatePlanTree(tx *gorm.DB, plan *models.Plan) error {
	// 1. 检查根节点
	if plan == nil || plan.ID == 0 {
		return ErrUpdateWithInvalidRoot
	}
	if len(plan.Tasks) > 0 && len(plan.SubPlans) > 0 {
		return fmt.Errorf("计划 (ID: %d) 不能同时包含任务和子计划", plan.ID)
	}

	// 2. 递归验证所有子节点，并检测循环引用
	allIDs := make(map[uint]bool)
	recursionStack := make(map[uint]bool)
	if err := validateNodeAndDetectCycles(plan, allIDs, recursionStack); err != nil {
		return err
	}

	// 3. 检查是否有重复的执行顺序
	if err := plan.ValidateExecutionOrder(); err != nil {
		return fmt.Errorf("计划 (ID: %d) 的执行顺序无效: %w", plan.ID, err)
	}

	// 4. 一次性数据库存在性校验
	var idsToCheck []uint
	for id := range allIDs {
		idsToCheck = append(idsToCheck, id)
	}

	if len(idsToCheck) > 0 {
		var count int64
		if err := tx.Model(&models.Plan{}).Where("id IN ?", idsToCheck).Count(&count).Error; err != nil {
			return fmt.Errorf("检查计划存在性时出错: %w", err)
		}
		if int(count) != len(idsToCheck) {
			return ErrNodeDoesNotExist
		}
	}
	return nil
}

// validateNodeAndDetectCycles 递归地验证节点有效性并检测循环引用
func validateNodeAndDetectCycles(plan *models.Plan, allIDs, recursionStack map[uint]bool) error {
	if plan == nil {
		return nil
	}
	if plan.ID == 0 {
		return ErrNewSubPlanInUpdate
	}
	if recursionStack[plan.ID] {
		return fmt.Errorf("检测到循环引用：计划 (ID: %d) 是其自身的祖先", plan.ID)
	}
	if allIDs[plan.ID] {
		return nil // 已经验证过这个节点及其子树，无需重复
	}

	recursionStack[plan.ID] = true
	allIDs[plan.ID] = true

	for _, subPlanLink := range plan.SubPlans {
		if err := validateNodeAndDetectCycles(subPlanLink.ChildPlan, allIDs, recursionStack); err != nil {
			return err
		}
	}

	delete(recursionStack, plan.ID) // 回溯，将节点移出当前递归路径
	return nil
}

// reconcilePlanNode 递归地同步数据库状态以匹配给定的计划节点
func (r *gormPlanRepository) reconcilePlanNode(tx *gorm.DB, plan *models.Plan) error {
	if plan == nil {
		return nil
	}
	// 1. 更新节点本身的基础字段
	if err := tx.Model(plan).Select("Name", "Description", "ExecutionType", "CronExpression", "ContentType").Updates(plan).Error; err != nil {
		return err
	}

	// 2. 根据内容类型协调子项
	switch plan.ContentType {
	case models.PlanContentTypeTasks:
		// 清理旧的子计划关联
		if err := tx.Where("parent_plan_id = ?", plan.ID).Delete(&models.SubPlan{}).Error; err != nil {
			return fmt.Errorf("更新时清理旧的子计划关联失败: %w", err)
		}
		// 协调任务列表
		return r.reconcileTasks(tx, plan)
	case models.PlanContentTypeSubPlans:
		// 清理旧的任务
		if err := tx.Where("plan_id = ?", plan.ID).Delete(&models.Task{}).Error; err != nil {
			return fmt.Errorf("更新时清理旧的任务失败: %w", err)
		}
		// 协调子计划关联
		return r.reconcileSubPlans(tx, plan)
	}
	return nil
}

// reconcileTasks 精确同步任务列表
func (r *gormPlanRepository) reconcileTasks(tx *gorm.DB, plan *models.Plan) error {
	var existingTasks []models.Task
	if err := tx.Where("plan_id = ?", plan.ID).Find(&existingTasks).Error; err != nil {
		return err
	}

	existingTaskMap := make(map[uint]bool)
	for _, task := range existingTasks {
		existingTaskMap[task.ID] = true
	}

	for i := range plan.Tasks {
		task := &plan.Tasks[i]
		if task.ID == 0 {
			task.PlanID = plan.ID
			if err := tx.Create(task).Error; err != nil {
				return err
			}
		} else {
			delete(existingTaskMap, task.ID) // 从待删除map中移除
			if err := tx.Model(task).Updates(task).Error; err != nil {
				return err
			}
		}
	}

	var tasksToDelete []uint
	for id := range existingTaskMap {
		tasksToDelete = append(tasksToDelete, id)
	}

	if len(tasksToDelete) > 0 {
		if err := tx.Delete(&models.Task{}, tasksToDelete).Error; err != nil {
			return err
		}
	}
	return nil
}

// reconcileSubPlans 精确同步子计划关联并递归
func (r *gormPlanRepository) reconcileSubPlans(tx *gorm.DB, plan *models.Plan) error {
	var existingLinks []models.SubPlan
	if err := tx.Where("parent_plan_id = ?", plan.ID).Find(&existingLinks).Error; err != nil {
		return err
	}

	existingLinkMap := make(map[uint]bool)
	for _, link := range existingLinks {
		existingLinkMap[link.ID] = true
	}

	for i := range plan.SubPlans {
		link := &plan.SubPlans[i]
		link.ParentPlanID = plan.ID
		if link.ID == 0 {
			if err := tx.Create(link).Error; err != nil {
				return err
			}
		} else {
			delete(existingLinkMap, link.ID) // 从待删除map中移除
			if err := tx.Model(link).Updates(link).Error; err != nil {
				return err
			}
		}
		// 递归协调子计划节点
		if err := r.reconcilePlanNode(tx, link.ChildPlan); err != nil {
			return err
		}
	}

	var linksToDelete []uint
	for id := range existingLinkMap {
		linksToDelete = append(linksToDelete, id)
	}

	if len(linksToDelete) > 0 {
		if err := tx.Delete(&models.SubPlan{}, linksToDelete).Error; err != nil {
			return err
		}
	}
	return nil
}

// DeletePlan 根据ID删除计划，同时删除其关联的任务（非子任务）或子计划关联
func (r *gormPlanRepository) DeletePlan(id uint) error {
	return r.db.Transaction(func(tx *gorm.DB) error {
		// 1. 检查该计划是否是其他计划的子计划
		var count int64
		if err := tx.Model(&models.SubPlan{}).Where("child_plan_id = ?", id).Count(&count).Error; err != nil {
			return fmt.Errorf("检查计划是否为子计划失败: %w", err)
		}
		if count > 0 {
			return ErrDeleteWithReferencedPlan
		}

		var plan models.Plan
		// 2. 获取计划以确定其内容类型
		if err := tx.First(&plan, id).Error; err != nil {
			return err
		}

		// 3. 根据内容类型删除关联数据
		switch plan.ContentType {
		case models.PlanContentTypeTasks:
			// 删除与此计划关联的所有非子任务
			if err := tx.Where("plan_id = ?", id).Delete(&models.Task{}).Error; err != nil {
				return fmt.Errorf("删除计划ID %d 的任务失败: %w", id, err)
			}
		case models.PlanContentTypeSubPlans:
			// 删除与此计划关联的所有子计划链接
			if err := tx.Where("parent_plan_id = ?", id).Delete(&models.SubPlan{}).Error; err != nil {
				return fmt.Errorf("删除计划ID %d 的子计划关联失败: %w", id, err)
			}
		}

		// 4. 删除计划本身
		if err := tx.Delete(&models.Plan{}, id).Error; err != nil {
			return fmt.Errorf("删除计划ID %d 失败: %w", id, err)
		}

		return nil
	})
}