Files
bj_power/bj_power_mes/schema/material_request.go
T
SunYF 42bcf395d2 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 散点,
清理修订痕迹为最终态描述。
2026-11-03 18:29:31 +08:00

89 lines
6.0 KiB
Go

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"
)
// MaterialRequest 叫料单(B5 定稿 2026-10-13):工位终端/数量不符补发从叫料池发起,
// 不绑工单、不绑排产;一次叫料按物料行拆 N 张单,每单 = 一个物料 + 一个量 + 一个目标接驳台 = 一个托盘 = 一次配送。
// 数量账在叫料池 call_pool(四数:需求/调整/已发/占用);本单只记请求量与实发量。
type MaterialRequest struct {
ent.Schema
}
func (MaterialRequest) Annotations() []schema.Annotation {
return []schema.Annotation{entsql.Annotation{Table: "material_request"}, entsql.WithComments(true), schema.Comment("MaterialRequest 叫料单:从叫料池发起,不绑工单/排产;七态状态机")}
}
func (MaterialRequest) Fields() []ent.Field {
return []ent.Field{
field.Int("id").Positive(),
field.String("requestNo").MaxLen(64).Comment("叫料单号"),
field.String("materialCode").MaxLen(64).Comment("物料编码"),
field.String("materialName").Default("").MaxLen(128),
field.String("unit").Default("").MaxLen(16),
// 是否逐件SN管理(冗余自物料档案 sn_mode,出库口径唯一依据):1 序列号=是(逐件SN) / 2 序列号=否
field.Int("snMode").Default(2),
field.Float("reqQty").Default(0).Comment("请求量(发起时占用叫料池可用量)"),
// 七态状态机(B5 定稿):
// PENDING 待备料(占用中)/ SHIPPED 已发货(仓库完成备料,WMS 已扣库存)
// DONE 已完成(工位签收)/ CANCELLED 已取消(待备料时工位撤销)
// REJECTED 已驳回(仓库拒发,带理由)/ RETURNING 退库中(签收前整单退,仓库取回中)
// RETURNED 已退库(仓库确认收回,叫料池已发额度回补)
field.String("status").Default("PENDING").MaxLen(20),
field.String("targetDock").Default("").MaxLen(20).Comment("目标接驳台(GxR1/GxR2,一单一个托盘)"),
// 工位级叫料:物料送达的工位号(叫料池行主体;工位只能叫自己的料)
field.Int("stationNo").Default(0).Comment("目标工位号"),
// 字段口径(2026-10-13 B5 定稿,一个字段只有一个写者):
// reqQty 请求量 [写者:发起叫料] —— 发起时占用 +reqQty
// sentQty 实发量 [写者:仓库完成备料] —— 完成时 已发 +sentQty、占用 −reqQty(差额自动释放)
// returnedQty 退库量 [写者:仓库确认收回] —— 退库收回时 已发 −returnedQty(额度回补)
field.Float("sentQty").Default(0).Comment("实发量(仓库完成备料时确定,禁单内分批)"),
field.Float("returnedQty").Default(0).Comment("退库量(整单退;仓库确认收回后叫料池额度回补)"),
// 来源:CALL=工位终端叫料(默认) / REFILL=数量不符补发(处理页定稿在 MES,同样消耗叫料池)
field.String("source").Default("CALL").MaxLen(16).Comment("来源 CALL/REFILL"),
// 补发来源:关联的数量不符单号(source=REFILL 且有值时填写)
field.String("refReportNo").Default("").MaxLen(64).Comment("关联数量不符单号"),
field.Bool("needAgv").Default(true).Comment("是否需要AGV配送到接驳台"),
// AGV 任务号(派车成功后由 DispatchAgvForCall 回写;派车失败不改状态机、只落预警)
field.String("agvTaskNo").Default("").MaxLen(64).Comment("AGV 任务号(派车成功后回写)"),
field.Bool("crossDay").Default(false).Comment("跨日标记:叫料池行含非今日排产(工位预警+仓库可驳回异常)"),
field.String("outboundNo").Default("").MaxLen(255).Comment("WMS 出库单号(完成备料回写,多个逗号分隔)"),
field.String("rejectReason").Default("").MaxLen(128).Comment("驳回理由(仓库拒发时必填)"),
// 跨工位借料来源:sourceStationNo(字符串键)→实际借用量;空 {} = 本工位自取(不借)。
// 当本工位可用不足时,系统自动从「同工艺候选工位」的剩余额度借用并如实记录;借出工位额度相应扣减。
// 叫料池四数账按真实消耗的工位行记账(与是否借料无关),来源仅用于追溯与额度回补。
field.JSON("borrowFrom", map[string]int{}).Optional().SchemaType(map[string]string{
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(),
}
}
func (MaterialRequest) Indexes() []ent.Index {
return []ent.Index{
index.Fields("stationNo"),
index.Fields("materialCode"),
index.Fields("status"),
index.Fields("workOrderNo"),
}
}