feat: 退料闭环定稿(损耗台账/备料清单/退料AGV自动派车/剩余量参考)+ 工位托盘守卫

- MES 新增损耗台账 loss_ledger,差异确认损耗接口 ConfirmReceiveLoss(按工单归集)
- 备料清单 preparation:MES 按 日计划×工单×工位×物料 实时计算,WMS 只读展示 PreparationList
- 退料闭环:N5 工位托盘守卫(未完成禁止退料)、退料 AGV 自动派车(JBT21 空位判定 + 托盘回收链路)、退料参考剩余量接口(应剩余=实备-已耗-已退-已损)
- 新增 AGV 车辆状态表 agv_vehicle_state 及查询
- 整合接驳台/叫料池/库存锁既有闭环,清理 sql 目录注释生成脚本与 catalog,更新文档
This commit is contained in:
SunYF
2026-11-04 19:06:03 +08:00
parent 42bcf395d2
commit 46fcb59079
123 changed files with 10666 additions and 3227 deletions
+19 -2
View File
@@ -33,10 +33,27 @@ func (ReturnOrder) Fields() []ent.Field {
field.Int("qty").Default(0).Comment("退库数量"),
field.String("unit").Default("").Comment("单位"),
field.String("reason").Default("").Comment("退库原因"),
// 待确认 PENDING / 已收货 RECEIVED
field.String("status").Default("PENDING").Comment("PENDING/RECEIVED"),
// 2026-11-04 拍板:损耗原因随退库单落库可查——巡检退料一律必填;转产退料实际<理论时必填;
// WMS 库管代退料(无理论量)一律必填。确认收货差异仍走 receive_diff/receive_note(不混淆)。
field.String("loss_reason").Default("").MaxLen(200).Comment("损耗原因(退料发起方填写;巡检/代退料一律必填,转产退料实际<理论时必填)"),
// 待确认 PENDING / 已收货 RECEIVED / 已取消 CANCELLED(2026-11-04 拍板:PENDING 可取消,
// 库房可取消工位申请、工位可取消自己发起的;已收货不可取消;取消不产生库存变动)
field.String("status").Default("PENDING").Comment("PENDING/RECEIVED/CANCELLED"),
// 2026-11-04 定稿:运输方式 agv/manual(必填)——agv=传感器检测到接驳台有托盘且库房接驳台
// 有空位时自动派车拉运(库管不点派车);manual=无 AGV 人工搬运,退料单照常等库管收货。
field.String("transport_mode").Default("").MaxLen(10).Comment("运输方式 agv=AGV自动派车/manual=人工搬运"),
// 自动派车时间(unix 秒;0=未派车。自动派车扫描成功派车后回写,防重复派车)
field.Int64("dispatched_at").Default(0).Comment("AGV自动派车时间(0=未派车)"),
// 取消留痕(2026-11-04 拍板:PENDING 可取消,库房可取消工位申请、工位可取消自己的)
field.String("cancelled_by").Default("").MaxLen(64).Comment("取消操作人"),
field.String("cancel_reason").Default("").MaxLen(200).Comment("取消原因"),
field.String("operator").Default("").Comment("退库发起人(工位终端操作人)"),
field.String("receive_by").Default("").Comment("WMS 确认收货人"),
// 2026-11-03 拍板(R18):库管可记录收货差异——实收<应退即为差异,按实收加回库存,
// 差异记「待核」不自动进损耗台账;差异经库管真实核实为损耗后,由主管走损耗登记挂工单。
field.Int("receive_qty").Default(0).Comment("库管实收量(确认收货时录入;0=整单全收)"),
field.Int("receive_diff").Default(0).Comment("收货差异=应退-实收(>0 为少收,记待核,不自动进损耗台账)"),
field.String("receive_note").Default("").Comment("收货差异备注(库管填写,说明差异原因)"),
field.Int64("created_at").DefaultFunc(nowUnix).Comment("创建时间"),
field.Int64("receive_at").Default(0).Comment("确认收货时间"),
}