feat: AGV三段链安全机制、补料/损耗/下班闭环、接驳台左右互换

AGV 调度:
- 任务重构为 GO_LOAD/TRANSPORT/EMPTY_RETURN/FREE 三段链,到位即停(ARRIVED)需人工确认装卸
- 自由调度单点步进,每段强制弹"请确保路径畅通无杂物";托盘回收独立工作台
- 接驳台 PLC 传感器检测到托盘即自动卸货放行,传感器故障由人工按钮兜底(无轮询)
- 车辆状态只读展示(海康3.1.7 queryAgvStatus),调度仍由 RCS 负责

物料闭环:
- 补料管理(SHORTAGE):工位申请 + 主管审批调增叫料池额度,与借料/差异补发三轨并行
- 损耗台账(loss_ledger):退料实际 < 理论必填原因、后审核,工单不记损耗
- 退料强制指定左/右接驳台,WMS 库管可代工位退料

下班闭环:
- 工位终端自检接驳台剩余物料后下班;库管收货 + 托盘拉走后事件驱动自动结班
- 退出登录未下班仅作安全提示(不强制拦截、不新增责任审批)

接驳台左右按操作员朝向建模(dock.side 字段),废除"奇左偶右"隐式约定;
看板标签 / seed / 迁移补丁 / 布局文档统一为中文左/右。

产线布局说明:C1 前线头 AGV 点、C15 后线尾 AGV 点、外部 O1/O2/O3 散点,
清理修订痕迹为最终态描述。
This commit is contained in:
SunYF
2026-11-03 18:29:31 +08:00
parent 2ccf9bb9ca
commit 42bcf395d2
123 changed files with 19472 additions and 247 deletions
+17 -6
View File
@@ -10,26 +10,37 @@ import (
)
// AgvTask AGV 搬运任务记录(2026-10-14 由 WMS 迁至 MES 为唯一真源)。
// MES 在仓库完成备料后调度海康 RCS 派车,任务落库用于状态跟踪/追溯。
// status 流转:PENDING待下发(未调RCS) → 1已创建(RCS) → 2执行中(RCS) → 9已结束(RCS) / FAILED下发失败 / 5已取消(RCS)
// 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 搬运任务记录:MES 调度海康 RCS 派车后落库,用于状态跟踪/追溯。")}
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("起点接驳台(常为 DOCK21 库房)"),
field.String("target_dock").Default("").MaxLen(20).Comment("终点接驳台 DOCK01..20"),
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执行中/5已取消/9已结束"),
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秒"),
+3
View File
@@ -29,6 +29,9 @@ func (Dock) Fields() []ent.Field {
field.String("dockType").Default("line").MaxLen(16).Comment("类型 line产线/store库房/other其他"),
// 关联工位(产线接驳台 DOCKn↔工位n,1:1);库房/其他接驳台不挂工位,为 0
field.Int("stationNo").Default(0).Comment("关联工位号(与工位1:1,非产线为0)"),
// 左右标识(2026-11-03 拍板:左右按操作员左右区分——下排工位 2/4/6/8/10 与地图左右相反,
// 故以字段显式建模,废除「奇数=左偶数=右」隐式约定;存量库经迁移补丁按新约定刷数)
field.String("side").Default("left").MaxLen(8).Comment("左右:left=操作员左手边/right=右手边(按操作员朝向区分,下排工位与地图左右相反)"),
field.Bool("hasPallet").Default(false).Comment("当前是否有托盘"),
// 有托盘时的关联出库/任务(便于查这个托盘是哪批料、要送到哪)
field.String("palletRef").Default("").MaxLen(64).Optional().Comment("托盘关联(出库单号/备料单号)"),
+50
View File
@@ -0,0 +1,50 @@
package schema
import (
"time"
"entgo.io/ent"
"entgo.io/ent/dialect/entsql"
"entgo.io/ent/schema"
"entgo.io/ent/schema/field"
"entgo.io/ent/schema/index"
)
// LossLedger 损耗台账(2026-11-03 拍板):退料时实际退回 < 理论应退的差额=损耗,
// 差额必填原因;采用「后审核」——先允许直接退库,台账落 MES,主管事后批注回复。
// 工单不记录损耗(损耗只在退库单与台账层);WMS 确认收货后账目可查「哪个人、哪个工位、损耗多少」。
type LossLedger struct {
ent.Schema
}
func (LossLedger) Annotations() []schema.Annotation {
return []schema.Annotation{entsql.Annotation{Table: "loss_ledgers"}, entsql.WithComments(true), schema.Comment("LossLedger 损耗台账:退料差额自动落账,主管批注(后审核)。")}
}
func (LossLedger) Fields() []ent.Field {
return []ent.Field{
field.Int("stationNo").Comment("工位号"),
field.String("materialCode").MaxLen(64).Comment("物料编码(图号)"),
field.String("materialName").Default("").MaxLen(128).Comment("物料名称"),
field.Float("theoryQty").Comment("理论应退量"),
field.Float("actualQty").Comment("实际退回量"),
field.Float("lossQty").Comment("损耗量(理论-实际)"),
field.String("reason").MaxLen(200).Comment("损耗原因(必填)"),
field.String("returnNo").Default("").MaxLen(64).Comment("关联退库单号(material_request.requestNo)"),
field.String("workOrderNo").Default("").MaxLen(64).Comment("关联工单号(可空)"),
field.String("status").Default("PENDING").MaxLen(20).Comment("PENDING待批注/COMMENTED已批注"),
field.String("comment").Default("").MaxLen(300).Comment("主管批注回复"),
field.String("commenter").Default("").MaxLen(64).Comment("批注人"),
field.Int64("commentedAt").Default(0).Comment("批注时间 unix秒"),
field.String("operator").Default("").MaxLen(64).Comment("退料操作人"),
field.Time("createdAt").Default(time.Now).Immutable(),
}
}
func (LossLedger) Indexes() []ent.Index {
return []ent.Index{
index.Fields("stationNo"),
index.Fields("status"),
index.Fields("returnNo"),
}
}
+10
View File
@@ -64,6 +64,15 @@ func (MaterialRequest) Fields() []ent.Field {
dialect.Postgres: "jsonb",
}).Comment("跨工位借料来源 stationNo→借用量;空=本工位自取"),
field.String("operator").Default("").MaxLen(64),
// 关联工单号(2026-11-03 转产按工单精确退料):普通叫料单为空;
// 转产退库单写入对应工单号,实现「按工单归集退料」——叫料池底层「工位×物料」聚合设计不变,
// 仅在退库单上记录工单归属,由库管按工单分别确认收货。
field.String("workOrderNo").Default("").MaxLen(64).Comment("关联工单号(转产按工单精确退料;普通叫料单为空)"),
// 2026-11-03 拍板:退料必须指定接驳台(AGV 要从接驳台出发拉货);退料差额(实际<理论)即损耗,必填原因、后审核
field.String("returnDock").Default("").MaxLen(20).Comment("退料接驳台(退料/还库时指定从哪个接驳台拉走,AGV 派车依据)"),
field.Float("theoryQty").Optional().Nillable().Comment("理论应退量(转产/下班退料按 BOM 计算;实际<理论差额=损耗)"),
field.Float("lossQty").Optional().Nillable().Comment("损耗量(理论应退-实际退回>0 时记录)"),
field.String("lossReason").Default("").MaxLen(200).Comment("损耗原因(有损耗时必填,主管在损耗台账批注)"),
field.Time("createdAt").Default(time.Now).Immutable(),
field.Time("updatedAt").Default(time.Now).UpdateDefault(time.Now).Optional().Nillable(),
}
@@ -74,5 +83,6 @@ func (MaterialRequest) Indexes() []ent.Index {
index.Fields("stationNo"),
index.Fields("materialCode"),
index.Fields("status"),
index.Fields("workOrderNo"),
}
}
+47
View File
@@ -0,0 +1,47 @@
package schema
import (
"time"
"entgo.io/ent"
"entgo.io/ent/dialect/entsql"
"entgo.io/ent/schema"
"entgo.io/ent/schema/field"
"entgo.io/ent/schema/index"
)
// ShortageRequest 补料申请(2026-11-03 拍板,独立于借料/数量不符补发):
// 工位备料按 BOM×台数×(1+损耗率) 送达后仍不够用(损耗超标等),工人申请「补量」,
// 主管审批(批注)通过后由系统调增该工位叫料池可用额度(AdjustPoolQty adj+),
// 工人再正常叫料出库。借料=跨工位额度转移(零和);补料=本工位总额度增加——两回事,不混。
type ShortageRequest struct {
ent.Schema
}
func (ShortageRequest) Annotations() []schema.Annotation {
return []schema.Annotation{entsql.Annotation{Table: "shortage_requests"}, entsql.WithComments(true), schema.Comment("ShortageRequest 补料申请:工位物料不够用申请加量,主管审批后调增叫料池额度。")}
}
func (ShortageRequest) Fields() []ent.Field {
return []ent.Field{
field.Int("stationNo").Comment("申请工位号"),
field.String("materialCode").MaxLen(64).Comment("物料编码(图号)"),
field.String("materialName").Default("").MaxLen(128).Comment("物料名称"),
field.String("unit").Default("").MaxLen(16).Comment("单位"),
field.Int("qty").Comment("补料数量(申请增加的额度)"),
field.String("reason").MaxLen(200).Comment("补料原因(损耗超标/用量超出预估等,必填)"),
field.String("status").Default("PENDING").MaxLen(20).Comment("PENDING待审批/APPROVED已通过/REJECTED已驳回"),
field.String("comment").Default("").MaxLen(300).Comment("主管批注"),
field.String("commenter").Default("").MaxLen(64).Comment("审批人"),
field.Int64("commentedAt").Default(0).Comment("审批时间 unix秒"),
field.String("operator").Default("").MaxLen(64).Comment("申请人"),
field.Time("createdAt").Default(time.Now).Immutable(),
}
}
func (ShortageRequest) Indexes() []ent.Index {
return []ent.Index{
index.Fields("stationNo"),
index.Fields("status"),
}
}
+44
View File
@@ -0,0 +1,44 @@
package schema
import (
"time"
"entgo.io/ent"
"entgo.io/ent/dialect/entsql"
"entgo.io/ent/schema"
"entgo.io/ent/schema/field"
"entgo.io/ent/schema/index"
)
// StationShift 工位班次(2026-11-03 拍板「下班/结束作业」闭环):
// 工人登录建班;下班时工人**自己目视**左右接驳台有无剩余物料(系统不替他查)——
// 确认无 → 直接下班(CLOSED);有剩余 → 走退料流程(指定接驳台/填实际/损耗原因)后即可离场,
// 班次置 CLOSING,待库管收货+空托盘拉走后由系统事件驱动自动置 CLOSED。
// 未下班退出登录 → 终端提示安全警示(不强制拦截,留痕)。
type StationShift struct {
ent.Schema
}
func (StationShift) Annotations() []schema.Annotation {
return []schema.Annotation{entsql.Annotation{Table: "station_shifts"}, entsql.WithComments(true), schema.Comment("StationShift 工位班次:下班/结束作业闭环状态。")}
}
func (StationShift) Fields() []ent.Field {
return []ent.Field{
field.Int("stationNo").Comment("工位号"),
field.String("operator").Default("").MaxLen(64).Comment("当班工人"),
field.String("status").Default("ON_DUTY").MaxLen(20).Comment("ON_DUTY当班/CLOSING待收尾(有剩余物料退料中)/CLOSED已下班"),
field.Int64("startAt").Default(0).Comment("班次开始(登录) unix秒"),
field.Int64("endApplyAt").Default(0).Comment("申请下班时间 unix秒"),
field.Int64("closedAt").Default(0).Comment("实际下班(收尾完成) unix秒"),
field.String("remark").Default("").MaxLen(300).Optional().Comment("备注(如退料单号/退出未下班警示留痕)"),
field.Time("createdAt").Default(time.Now).Immutable(),
}
}
func (StationShift) Indexes() []ent.Index {
return []ent.Index{
index.Fields("stationNo"),
index.Fields("status"),
}
}