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
+63 -2
View File
@@ -58,6 +58,16 @@ type MaterialRequest struct {
BorrowFrom map[string]int `json:"borrowFrom,omitempty"`
// Operator holds the value of the "operator" field.
Operator string `json:"operator,omitempty"`
// 关联工单号(转产按工单精确退料;普通叫料单为空)
WorkOrderNo string `json:"workOrderNo,omitempty"`
// 退料接驳台(退料/还库时指定从哪个接驳台拉走,AGV 派车依据)
ReturnDock string `json:"returnDock,omitempty"`
// 理论应退量(转产/下班退料按 BOM 计算;实际<理论差额=损耗)
TheoryQty *float64 `json:"theoryQty,omitempty"`
// 损耗量(理论应退-实际退回>0 时记录)
LossQty *float64 `json:"lossQty,omitempty"`
// 损耗原因(有损耗时必填,主管在损耗台账批注)
LossReason string `json:"lossReason,omitempty"`
// CreatedAt holds the value of the "createdAt" field.
CreatedAt time.Time `json:"createdAt,omitempty"`
// UpdatedAt holds the value of the "updatedAt" field.
@@ -74,11 +84,11 @@ func (*MaterialRequest) scanValues(columns []string) ([]any, error) {
values[i] = new([]byte)
case materialrequest.FieldNeedAgv, materialrequest.FieldCrossDay:
values[i] = new(sql.NullBool)
case materialrequest.FieldReqQty, materialrequest.FieldSentQty, materialrequest.FieldReturnedQty:
case materialrequest.FieldReqQty, materialrequest.FieldSentQty, materialrequest.FieldReturnedQty, materialrequest.FieldTheoryQty, materialrequest.FieldLossQty:
values[i] = new(sql.NullFloat64)
case materialrequest.FieldID, materialrequest.FieldSnMode, materialrequest.FieldStationNo:
values[i] = new(sql.NullInt64)
case materialrequest.FieldRequestNo, materialrequest.FieldMaterialCode, materialrequest.FieldMaterialName, materialrequest.FieldUnit, materialrequest.FieldStatus, materialrequest.FieldTargetDock, materialrequest.FieldSource, materialrequest.FieldRefReportNo, materialrequest.FieldAgvTaskNo, materialrequest.FieldOutboundNo, materialrequest.FieldRejectReason, materialrequest.FieldOperator:
case materialrequest.FieldRequestNo, materialrequest.FieldMaterialCode, materialrequest.FieldMaterialName, materialrequest.FieldUnit, materialrequest.FieldStatus, materialrequest.FieldTargetDock, materialrequest.FieldSource, materialrequest.FieldRefReportNo, materialrequest.FieldAgvTaskNo, materialrequest.FieldOutboundNo, materialrequest.FieldRejectReason, materialrequest.FieldOperator, materialrequest.FieldWorkOrderNo, materialrequest.FieldReturnDock, materialrequest.FieldLossReason:
values[i] = new(sql.NullString)
case materialrequest.FieldCreatedAt, materialrequest.FieldUpdatedAt:
values[i] = new(sql.NullTime)
@@ -225,6 +235,38 @@ func (_m *MaterialRequest) assignValues(columns []string, values []any) error {
} else if value.Valid {
_m.Operator = value.String
}
case materialrequest.FieldWorkOrderNo:
if value, ok := values[i].(*sql.NullString); !ok {
return fmt.Errorf("unexpected type %T for field workOrderNo", values[i])
} else if value.Valid {
_m.WorkOrderNo = value.String
}
case materialrequest.FieldReturnDock:
if value, ok := values[i].(*sql.NullString); !ok {
return fmt.Errorf("unexpected type %T for field returnDock", values[i])
} else if value.Valid {
_m.ReturnDock = value.String
}
case materialrequest.FieldTheoryQty:
if value, ok := values[i].(*sql.NullFloat64); !ok {
return fmt.Errorf("unexpected type %T for field theoryQty", values[i])
} else if value.Valid {
_m.TheoryQty = new(float64)
*_m.TheoryQty = value.Float64
}
case materialrequest.FieldLossQty:
if value, ok := values[i].(*sql.NullFloat64); !ok {
return fmt.Errorf("unexpected type %T for field lossQty", values[i])
} else if value.Valid {
_m.LossQty = new(float64)
*_m.LossQty = value.Float64
}
case materialrequest.FieldLossReason:
if value, ok := values[i].(*sql.NullString); !ok {
return fmt.Errorf("unexpected type %T for field lossReason", values[i])
} else if value.Valid {
_m.LossReason = value.String
}
case materialrequest.FieldCreatedAt:
if value, ok := values[i].(*sql.NullTime); !ok {
return fmt.Errorf("unexpected type %T for field createdAt", values[i])
@@ -334,6 +376,25 @@ func (_m *MaterialRequest) String() string {
builder.WriteString("operator=")
builder.WriteString(_m.Operator)
builder.WriteString(", ")
builder.WriteString("workOrderNo=")
builder.WriteString(_m.WorkOrderNo)
builder.WriteString(", ")
builder.WriteString("returnDock=")
builder.WriteString(_m.ReturnDock)
builder.WriteString(", ")
if v := _m.TheoryQty; v != nil {
builder.WriteString("theoryQty=")
builder.WriteString(fmt.Sprintf("%v", *v))
}
builder.WriteString(", ")
if v := _m.LossQty; v != nil {
builder.WriteString("lossQty=")
builder.WriteString(fmt.Sprintf("%v", *v))
}
builder.WriteString(", ")
builder.WriteString("lossReason=")
builder.WriteString(_m.LossReason)
builder.WriteString(", ")
builder.WriteString("createdAt=")
builder.WriteString(_m.CreatedAt.Format(time.ANSIC))
builder.WriteString(", ")