package schema import ( "time" "entgo.io/ent" "entgo.io/ent/dialect" "entgo.io/ent/dialect/entsql" "entgo.io/ent/schema" "entgo.io/ent/schema/field" "entgo.io/ent/schema/index" ) // EventLog 事件日志,记录系统中所有关键事件的审计追踪信息 type EventLog struct { ent.Schema } func (EventLog) Annotations() []schema.Annotation { return []schema.Annotation{ entsql.Annotation{ Table: "event_log", Options: "COMMENT='事件日志表,记录系统所有关键事件的审计追踪,用于故障回溯和行为分析'", }, entsql.WithComments(true), } } func (EventLog) Fields() []ent.Field { return []ent.Field{ field.Int("id").Positive().Comment("主键ID"), field.String("eventType").MaxLen(50).Comment("事件类型,如 job_started/job_completed/equipment_error"), field.String("sourceId").Default("").Comment("事件源ID,产生事件的系统模块标识"), field.String("entityType").Default("").MaxLen(30).Comment("关联实体类型,如 job/equipment/temp_slot"), field.String("entityId").Default("").MaxLen(50).Comment("关联实体ID,对应实体表的主键"), field.Int64("entityVersion").Default(0).Comment("实体版本号,用于乐观锁并发控制"), field.Int("jobId").Optional().Comment("关联工件ID"), field.Int("equipmentId").Optional().Comment("关联设备ID"), field.String("equipmentName").MaxLen(64).Default("").Comment("设备名称,冗余存储便于查询"), field.Int("tempSlotNo").Optional().Comment("暂存台槽位号"), field.Text("description").Default("").Comment("事件描述,人可读的事件说明"), field.JSON("payload", map[string]any{}).Optional().SchemaType(map[string]string{ dialect.Postgres: "jsonb", }).Comment("事件载荷,携带事件相关的结构化业务数据"), field.Time("startedAt").Optional().Comment("事件开始时间"), field.Time("endedAt").Optional().Comment("事件结束时间"), field.Time("createdAt").Default(time.Now).Immutable().Comment("日志记录创建时间"), } } func (EventLog) Indexes() []ent.Index { return []ent.Index{ index.Fields("eventType"), index.Fields("createdAt"), index.Fields("entityType", "entityId"), index.Fields("jobId"), index.Fields("equipmentId"), } }