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
@@ -0,0 +1,69 @@
package logic
import (
"context"
"fmt"
"bj_power_mes/ent/lossledger"
"bj_power_mes/ent/materialrequest"
)
// ---------- T2 收货差异"确认损耗"(2026-11-04 拍板:人工点击才落账,不自动转) ----------
//
// R18 口径(2026-11-03):收货差异记「待核」,核实为损耗才写损耗台账、挂工单。
// 本接口 = 人工核实后的落账入口:库管在 MES 叫料单列表对差异行点「确认损耗」,填原因后提交。
// 防重复:同一叫料单(returnNo=requestNo)只允许确认一次。
// ConfirmReceiveLoss 差异确认损耗:material_request(receiveDiff>0) → loss_ledgers 落账。
func (s *Service) ConfirmReceiveLoss(ctx context.Context, requestNo, reason, operator string) error {
if requestNo == "" {
return fmt.Errorf("缺少叫料单号")
}
if reason == "" {
return fmt.Errorf("损耗原因必填:请填写核实后的差异原因(如运输丢失/损坏/少发未补)")
}
mr, err := s.ctx.EntClient.MaterialRequest.Query().
Where(materialrequest.RequestNo(requestNo)).First(ctx)
if err != nil {
return fmt.Errorf("叫料单 %s 不存在", requestNo)
}
// Nillable 字段安全解包(receiveQty/receiveDiff 为 T2/R18 新增 Optional Nillable 列)
ret := mr.ReturnedQty // 理论应退量(非 Nillable,Default 0)
recv := 0.0 // 库管实收量
if mr.ReceiveQty != nil {
recv = *mr.ReceiveQty
}
diff := 0.0 // 收货差异 = 应退 − 实收
if mr.ReceiveDiff != nil {
diff = *mr.ReceiveDiff
}
if diff <= 0 {
return fmt.Errorf("叫料单 %s 无收货差异(实收 %v / 应退 %v),无需确认损耗", requestNo, recv, ret)
}
// 防重复:同一叫料单已落账则拒绝
if exists, _ := s.ctx.EntClient.LossLedger.Query().
Where(lossledger.ReturnNo(requestNo)).Exist(ctx); exists {
return fmt.Errorf("叫料单 %s 的差异已确认过损耗,请勿重复提交", requestNo)
}
_, err = s.ctx.EntClient.LossLedger.Create().
SetStationNo(mr.StationNo).
SetMaterialCode(mr.MaterialCode).
SetMaterialName(mr.MaterialName).
SetTheoryQty(ret). // 理论应退量
SetActualQty(recv). // 实际退回量(库管实收)
SetLossQty(diff). // 损耗量 = 应退 − 实收
SetReason(reason).
SetReturnNo(requestNo).
SetWorkOrderNo(mr.WorkOrderNo). // 转产单关联工单(普通叫料单为空)
SetStatus("PENDING").
SetOperator(operator).
Save(ctx)
if err != nil {
return fmt.Errorf("写损耗台账失败: %w", err)
}
s.ctx.EventLog.Write(ctx, "material.loss_confirm", mr.MaterialCode, operator,
"material_request", requestNo,
fmt.Sprintf("收货差异确认损耗:应退 %v / 实收 %v / 损耗 %v,原因=%s,挂工单=%s",
ret, recv, diff, reason, mr.WorkOrderNo), nil)
return nil
}