bj_power/bj_power_mes/schema/job.go

package schema

import (
	"time"

	"bj_power_mes/constants"

	"entgo.io/ent"
	"entgo.io/ent/dialect"
	"entgo.io/ent/dialect/entsql"
	"entgo.io/ent/schema"
	"entgo.io/ent/schema/edge"
	"entgo.io/ent/schema/field"
	"entgo.io/ent/schema/index"
)

// Job 工件，工�下独立加工的最��元，贯穿整个工艺路线
//
// 字段说明�
// - dockEquipmentID/dockSlotNo: 接驳�设备ID�槽�，工件入线/出线�置
// - tempSlotNo: 缓存�槽��，工件在缓存区中的��
// - cncStartedAt/cncCompletedAt: 加工计时字段，记录设备加工起止时刻（磨床/转�等）
type Job struct {
	ent.Schema
}

func (Job) Annotations() []schema.Annotation {
	return []schema.Annotation{
		entsql.Annotation{
			Table:   "job",
			Options: "COMMENT='工件� 工�下独立加工的最��元，记录工件完整生命周期：状���置�步骤�事件版�",
		},
		entsql.WithComments(true),
	}
}

func (Job) Fields() []ent.Field {
	return []ent.Field{
		field.Int("id").Positive().Comment("主键ID"),
		field.Int("workOrderId").Comment("所属工�ID"),
		field.Int("productTypeId").Comment("产�类型ID，决定工艺路�),
		field.Int("recipeId").Comment("工艺路线ID，当�工件使用的�方"),
		field.String("currentStepId").MaxLen(20).Default("").Comment("当�加工步骤业务ID，如 OP10/OP20/OP90"),
		field.Enum("status").
			GoType(constants.JobStatus("")).
			Default(string(constants.JobStatus_Created)).
			Comment("工件状�：Created/Queued/Processing/Completed/Suspended/Failed"),
		field.Enum("positionType").
			GoType(constants.PositionType("")).
			Default(string(constants.PositionType_OnDock)).
			Comment("�置类型：ON_DOCK（接驳�� ON_EQUIPMENT（设备）/ ON_CACHE（缓存��),
		field.String("positionRefId").Default("").Comment("�置引用ID，格�设备ID:槽��),
		field.Int("tempSlotNo").Optional().Nillable().Comment("缓存�槽��，工件在缓存�中的��),
		field.Int("dockEquipmentId").Optional().Nillable().Comment("接驳�设备ID，工件所在接驳�"),
		field.Int("dockSlotNo").Optional().Nillable().Comment("接驳�槽��，�值范�-42"),
		field.JSON("context", map[string]any{}).Optional().SchemaType(map[string]string{
			dialect.Postgres: "jsonb",
		}).Comment("�行时上下文，存储形状判断�检测结果等动�数�),
		field.Int("priority").Default(2).Comment("调度优先级，数值越�优先级越高"),
		field.String("suspendedReason").Default("").Comment("挂起原因，记录工件被暂�的具体原�),
		field.Int("version").Default(0).Comment("事件版本�，�观�并�控制，�次状���1"),
		field.Int("totalStepCount").Default(0).Comment("累计步骤数，死循环防护：超过 maxStepCount 标记为异�),
		field.Int("maxStepCount").Default(200).Comment("最大步骤数�制，防止死循环"),
		field.String("lastEventId").Default("").Comment("最�处�事件ID，用于事件去�和溯�"),
		field.Time("completedAt").Optional().Comment("完工时间，所有工�执行完毕的时刻"),
		field.Time("cncStartedAt").Optional().Comment("加工开始时间，设备加工开始时�),
		field.Time("cncCompletedAt").Optional().Comment("加工完�时间，设备加工完�时�),
		field.Time("createdAt").Default(time.Now).Immutable().Comment("创建时间"),
		field.Time("updatedAt").Default(time.Now).UpdateDefault(time.Now).Optional().Nillable().Comment("最�更新时�),
		field.Bool("isDel").Default(false).Comment("软删除标记：TRUE=已删除（工�删除时软删，�留审计数�）；查询需过滤 is_del = FALSE"),
	}
}

func (Job) Edges() []ent.Edge {
	return []ent.Edge{
		edge.From("workOrder", WorkOrder.Type).Ref("jobs").Field("workOrderId").Unique().Required().Comment("所属工�),
		edge.From("productType", ProductType.Type).Ref("jobs").Field("productTypeId").Unique().Required().Comment("产�类型"),
		edge.From("recipe", Recipe.Type).Ref("jobs").Field("recipeId").Unique().Required().Comment("工艺路线"),
		edge.To("taskLogs", TaskLog.Type).Comment("任务执行日志"),
		edge.To("tasks", Task.Type).Comment("领域任务"),
		edge.To("stepInstances", JobStepInstance.Type).Comment("步骤执行实例"),
	}
}

func (Job) Indexes() []ent.Index {
	return []ent.Index{
		index.Fields("workOrderId"),
		index.Fields("status"),
		index.Fields("positionType"),
		index.Fields("version"),
	}
}