Files
bj_power/bj_power_mes/schema/agv_task.go
T
SunYF 9aaa768e6c feat(mes): AGV挂起动作引擎 + 智能跟车流转 + PLC快照缓存(2026-11-19 主控拍板)
一、AGV 挂起动作引擎(弃显式任务队列、弃并发硬拒)
- 新增 internal/logic/agv_pending.go:待发动作直接挂任务(pending_action + pending_since),
  CONTINUE_LIFT(举升完成→continueTask#1)/ WAIT_DROP_CONFIRM(人工确认放下→continueTask#2)
  / FREE_ROBOT(末组完成→freeRobot);系统动作超 60s 未触发转预警人工重试,绝不自动重发
- Client 新增 ContinueTask(RCS 2.1.2) / FreeRobot(3.1.2),仅点名释放指定车,禁止释放全部
- agv_task 增 pending_action/pending_since 字段,ent 重生成 + db.go 幂等迁移补丁 + migrateonce
- 回调按 B01/B02/C01 模板编排:业务流转到位即自动放行放下、回调自动放车;
  仅人工派车(MANUAL)挂 WAIT_DROP_CONFIRM;新增 /agv/confirm-drop、/agv/pending/retry
- 前端 AgvManual/Agv 确认放下、挂起重试按钮与等待提示联动

二、智能跟车 + 动态目标截断流转引擎
- 新增 internal/logic/flow_engine.go:事件驱动(报工/扫码),读 48 位物理快照,从下游往上游算,
  前方占用则动态截断到最近空闲缓存位;IN_TRANSIT 在途闭锁防重复下发,MW=0 才确认到位落台账;
  主线占用=台账 OR 传感器,工位 G 位只认台账;在途超 5s 落预警
- workpiece 增 flow_transit_mw/target/at 字段,ent 重生成 + 迁移补丁

三、PLC 读取优化与诊断
- 新增 internal/plc/snapshot_cache.go:2s TTL + singleflight + 写失效,合并 SSE/PLC监控/流转引擎
  的重复点位读取;tcp.go 读块重构、localip.go 多网卡、plcdiag 诊断工具、plc_monitor/logging 配套

四、文档与前端
- help.js 重写「工位下发」帮助:明确报工自动驱动流转 vs 下发路线码的定位、缺料/握手/撤回边界
- 案例.md 补充定稿说明;public/index.html 构建指纹更新
2026-11-19 23:08:46 +08:00

67 lines
4.4 KiB
Go

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("我方任务号(内部,同时作为 RCS reqCode/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("template_type").Default("NONE").MaxLen(10).Comment("动作模板类型:LIFT举升(段起点或终点为接驳台,需举升/放下交接托盘)/NONE非举升(纯停靠无交接);下派时按两端点位 is_dock 自动推导并映射 RCS taskTyp,不留给人工选"),
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("pending_action").Default("").MaxLen(30).Comment("挂起待办动作(2026-11-19 主控定稿,弃队列弃硬拒):CONTINUE_LIFT等举升完成→continueTask#1/WAIT_DROP_CONFIRM等人工确认放下→continueTask#2/FREE_ROBOT等末组完成→freeRobot;空=无待办;RCS报错即清+告警,系统动作超60s转预警人工重试"),
field.Int64("pending_since").Default(0).Comment("挂起动作起始时间 unix秒(60s超时告警判定基准)"),
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("chain_no"),
}
}
// nowUnix 与 WMS 端 schema 保持一致:created_at 用 unix 秒(前端 fmtTime 直接消费)。
func nowUnix() int64 {
return time.Now().Unix()
}