package schema import ( "entgo.io/ent" "entgo.io/ent/dialect/entsql" "entgo.io/ent/schema" "entgo.io/ent/schema/field" "entgo.io/ent/schema/index" "time" ) // AgvTask AGV 搬运任务记录(2026-10-14 由 WMS 迁至 MES 为唯一真源)。 // 2026-11-03 重构为「三段链 + 到位待令」模型(用户拍板三层安全机制): // - 业务自动触发(免弹窗):空车段(GO_LOAD)与空车返回段(EMPTY_RETURN)由系统生成后自动下发; // - 装卸强制确认(到位待令):车辆到达装货/卸货点 → status=ARRIVED,必须人工「确认装车并送货」/ // 「卸货完成并放行」才会继续下一段; // - 人工自由调度(FREE):每一段都由人工发起并弹「请确保路径畅通无杂物」。 // status 流转:PENDING待下发 → 1已创建(RCS) → 2执行中(RCS) → ARRIVED到位待令(人工确认) → 9已结束 / // FAILED下发失败 / 5已取消;auto_end=true 的段(空车回充)到位直接 9,不停留待令。 type AgvTask struct { ent.Schema } func (AgvTask) Annotations() []schema.Annotation { return []schema.Annotation{entsql.Table("agv_tasks"), entsql.WithComments(true), schema.Comment("AgvTask AGV 搬运任务记录:三段链模型(空车去程/重载运输/空车回充),到位进 ARRIVED 待人工确认。")} } func (AgvTask) Fields() []ent.Field { return []ent.Field{ field.String("task_no").Unique().MaxLen(64).Comment("我方任务号(内部)"), field.String("hik_task_code").Default("").MaxLen(64).Comment("RCS-Lite 任务单号(即我方 task_no,下发时透传 taskCode)"), field.String("source_dock").Default("").MaxLen(20).Comment("起点接驳台(空车段可为空=单点path由RCS派最近空闲车)"), field.String("target_dock").Default("").MaxLen(20).Comment("终点接驳台/点位 DOCK01..21 或 AGV-CHARGE01"), field.String("materials_json").Default("").MaxLen(4000).Comment("物料清单 JSON"), field.String("related_request_no").Default("").MaxLen(64).Optional().Comment("关联叫料单号(MES material_request.requestNo)"), field.String("related_outbound_no").Default("").MaxLen(64).Optional().Comment("关联出库单号(可选, WMS 回传)"), field.String("status").Default("PENDING").MaxLen(20).Comment("PENDING/FAILED/1已创建/2执行中/ARRIVED到位待令/5已取消/9已结束"), field.String("kind").Default("TRANSPORT").MaxLen(20).Comment("段类型:GO_LOAD空车去装货点/TRANSPORT重载运输/EMPTY_RETURN空车回充/FREE人工自由调度单点段"), field.String("biz_type").Default("CALL").MaxLen(20).Comment("业务来源:CALL叫料/PALLET托盘回收/FREE自由调度"), field.String("biz_no").Default("").MaxLen(64).Comment("业务单据号(叫料单号/托盘回收标识等)"), field.String("chain_no").Default("").MaxLen(64).Comment("任务链号(=首段taskNo,同链各段关联)"), field.Bool("auto_end").Default(false).Comment("到位自动结束(空车回充段=true,不停留待令)"), field.String("agv_code").Default("").MaxLen(32).Comment("RCS 分配的车辆编号(任务分车后由回调/查询回写)"), field.String("operator").Default("").MaxLen(64).Comment("下发人"), field.Int64("dispatched_at").Default(0).Comment("下发时间 unix秒"), field.Int64("arrived_at").Default(0).Comment("到位时间 unix秒"), field.String("remark").Default("").MaxLen(500).Optional().Comment("备注/失败原因"), field.Int64("created_at").DefaultFunc(nowUnix).Comment("创建时间"), } } func (AgvTask) Indexes() []ent.Index { return []ent.Index{ index.Fields("task_no").Unique(), index.Fields("target_dock"), index.Fields("status"), index.Fields("hik_task_code"), } } // nowUnix 与 WMS 端 schema 保持一致:created_at 用 unix 秒(前端 fmtTime 直接消费)。 func nowUnix() int64 { return time.Now().Unix() }