pig-farm-controller/internal/infra/models/schedule.go

package models

import (
	"time"
)

// PendingTask 是一个待执行任务队列, 里面会储存待执行的Task以及这个Task什么时候执行
// 它是一个纯粹的工作队列，任务被认领后即被删除。
type PendingTask struct {
	// 手动填充必须字段以实现硬删除，不内嵌 gorm.Model
	ID        uint `gorm:"primarykey"`
	CreatedAt time.Time
	UpdatedAt time.Time

	// 业务字段

	// TaskID 使用 int 类型以容纳特殊的负数ID，代表系统任务
	TaskID int `gorm:"index"`
	// Task 字段，用于在代码中访问关联的任务详情
	// GORM 会根据 TaskID 字段自动填充此关联
	Task *Task `gorm:"foreignKey:TaskID"`

	ExecuteAt          time.Time `gorm:"index"`                 // 任务执行时间
	TaskExecutionLogID uint      `gorm:"unique;not null;index"` // 对应的执行历史记录ID

	// 通过 TaskExecutionLogID 关联到唯一的 TaskExecutionLog 记录
	// ON DELETE CASCADE 确保如果日志被删除，这个待办任务也会被自动清理
	TaskExecutionLog TaskExecutionLog `gorm:"foreignKey:TaskExecutionLogID;references:ID;constraint:OnUpdate:CASCADE,OnDelete:CASCADE;"`
}

// TableName 自定义 GORM 使用的数据库表名
func (PendingTask) TableName() string {
	return "pending_tasks"
}