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

package repository

import (
	"time"

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

// PendingTaskRepository 定义了与待执行任务队列交互的接口。
type PendingTaskRepository interface {
	CreatePendingTasksInBatch(tasks []*models.PendingTask) error
	// ClaimNextAvailableTask 原子地认领下一个可用的任务。
	// 它会同时返回被认领任务对应的日志对象，以及被删除的待办任务对象的内存副本。
	ClaimNextAvailableTask(excludePlanIDs []uint) (*models.TaskExecutionLog, *models.PendingTask, error)
	// RequeueTask 安全地将一个任务重新放回队列。
	RequeueTask(originalPendingTask *models.PendingTask) error
}

// gormPendingTaskRepository 是使用 GORM 的具体实现。
type gormPendingTaskRepository struct {
	db *gorm.DB
}

// NewGormPendingTaskRepository 创建一个新的待执行任务队列仓库。
func NewGormPendingTaskRepository(db *gorm.DB) PendingTaskRepository {
	return &gormPendingTaskRepository{db: db}
}

// CreatePendingTasksInBatch 在一次数据库调用中创建多个待执行任务条目。
func (r *gormPendingTaskRepository) CreatePendingTasksInBatch(tasks []*models.PendingTask) error {
	return r.db.Create(&tasks).Error
}

// ClaimNextAvailableTask 以原子方式认领下一个可用的任务。
func (r *gormPendingTaskRepository) ClaimNextAvailableTask(excludePlanIDs []uint) (*models.TaskExecutionLog, *models.PendingTask, error) {
	var log models.TaskExecutionLog
	var pendingTask models.PendingTask

	err := r.db.Transaction(func(tx *gorm.DB) error {
		query := tx.Clauses(clause.Locking{Strength: "UPDATE"}).
			Where("execute_at <= ?", time.Now()).
			Order("execute_at ASC")

		if len(excludePlanIDs) > 0 {
			query = query.Where("plan_execution_log_id NOT IN ?", excludePlanIDs)
		}

		if err := query.First(&pendingTask).Error; err != nil {
			return err
		}

		if err := tx.Unscoped().Delete(&pendingTask).Error; err != nil {
			return err
		}

		updates := map[string]interface{}{
			"status":     models.ExecutionStatusStarted,
			"started_at": time.Now(),
		}
		if err := tx.Model(&models.TaskExecutionLog{}).Where("id = ?", pendingTask.TaskExecutionLogID).Updates(updates).Error; err != nil {
			return err
		}

		if err := tx.Preload("Task").First(&log, pendingTask.TaskExecutionLogID).Error; err != nil {
			return err
		}

		return nil
	})

	if err != nil {
		return nil, nil, err
	}

	return &log, &pendingTask, nil
}

// RequeueTask 安全地将一个任务重新放回队列。
// 它通过将原始 PendingTask 的 ID 重置为 0，并重新创建它来实现。
func (r *gormPendingTaskRepository) RequeueTask(originalPendingTask *models.PendingTask) error {
	return r.db.Transaction(func(tx *gorm.DB) error {
		// 1. 将日志状态恢复为 waiting
		if err := tx.Model(&models.TaskExecutionLog{}).Where("id = ?", originalPendingTask.TaskExecutionLogID).Update("status", models.ExecutionStatusWaiting).Error; err != nil {
			return err
		}

		// 2. 关键：将传入的 PendingTask 的 ID 重置为 0。
		//    这会告诉 GORM，这是一个需要创建（INSERT）的新记录，而不是更新。
		originalPendingTask.ID = 0

		// 3. 重新创建待办任务。GORM 会忽略掉已被重置的 ID，并让数据库生成一个新的主键。
		return tx.Create(originalPendingTask).Error
	})
}