Files
bj_power/bj_power_mes/internal/logic/station_ops.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

205 lines
7.5 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package logic
import (
"context"
"errors"
"fmt"
"time"
"bj_power_mes/ent"
"bj_power_mes/ent/inspectionrecord"
"bj_power_mes/ent/workorder"
)
// ============ 工位终端业务操作(P0-3 / 数量不符 / 退库 / 工序间检验记录) ============
// EmergencyCall 应急呼叫:落预警消息(type=emergency_call),预警中心实时展示 + pad 顶部提示。
// 纯软件方案(客户 L614 已定:发消息给班组长,不依赖安灯硬件)。
func (s *Service) EmergencyCall(ctx context.Context, stationNo int, orderNo, remark, operator string) error {
if stationNo <= 0 {
return errors.New("缺少工位号")
}
content := fmt.Sprintf("工位 %d 发起应急呼叫", stationNo)
if orderNo != "" {
content += "(工单 " + orderNo + ")"
}
if remark != "" {
content += ":" + remark
}
_, err := s.ctx.EntClient.Alert.Create().
SetRuleId(0).
SetType("emergency_call").
SetTitle("应急呼叫").
SetContent(content).
SetRefType("station").
SetRefId(fmt.Sprintf("%d", stationNo)).
SetReceiver("").
SetStatus("UNREAD").
Save(ctx)
if err != nil {
return err
}
s.ctx.EventLog.Write(ctx, "station.emergency", orderNo, operator, "alert",
fmt.Sprintf("%d", stationNo), "工位应急呼叫", map[string]any{"stationNo": stationNo, "remark": remark})
s.notifyDashboard()
return nil
}
// QtyReportReq 数量不符上报请求(工位收到料数量与下发数量不一致)
type QtyReportReq struct {
StationNo int `json:"stationNo"`
OrderNo string `json:"orderNo"`
Sn string `json:"sn"`
MaterialCode string `json:"materialCode"`
MaterialName string `json:"materialName"`
PlanQty int `json:"planQty"`
ActualQty int `json:"actualQty"`
Cause string `json:"cause"`
Operator string `json:"operator"`
}
// CreateQtyReport 数量不符上报:落 material_qty_report + 预警中心消息(type=qty_diff)。
//
// 归属(2026-09-19 定稿):MES 是唯一真源与处理侧 —— 上报、明细、处理(补发/退库/调整)
// 全在 MES(见 logic/qty_report.go:HandleQtyReport),WMS 只经内部接口被动建单。
// 预警 refId 存差异单业务号 QR{id},处理完成后可精确定位并闭环该预警。
func (s *Service) CreateQtyReport(ctx context.Context, req QtyReportReq) error {
if req.StationNo <= 0 || req.MaterialCode == "" {
return errors.New("工位号与物料编码必填")
}
diff := req.PlanQty - req.ActualQty
rec, err := s.ctx.EntClient.MaterialQtyReport.Create().
SetStationNo(req.StationNo).
SetOrderNo(req.OrderNo).
SetSn(req.Sn).
SetMaterialCode(req.MaterialCode).
SetMaterialName(req.MaterialName).
SetPlanQty(req.PlanQty).
SetActualQty(req.ActualQty).
SetDiffQty(diff).
SetCause(req.Cause).
SetStatus("PENDING").
SetOperator(req.Operator).
Save(ctx)
if err != nil {
return err
}
// 融合成单段文字描述,直接写入预警「内容」(即预警原因)。
cause := req.Cause
if cause == "" {
cause = "未填写"
}
content := fmt.Sprintf("差异单 %s|工位%d 数量不符:物料 %s", qtyReportNo(rec.ID), req.StationNo, req.MaterialCode)
if req.MaterialName != "" {
content += "(" + req.MaterialName + ")"
}
content += fmt.Sprintf(";应发 %d,实收 %d,差异 %d", req.PlanQty, req.ActualQty, diff)
if req.OrderNo != "" {
content += ";工单 " + req.OrderNo
}
if req.Sn != "" {
content += ";序列号 " + req.Sn
}
content += ";上报原因:" + cause
_, _ = s.ctx.EntClient.Alert.Create().
SetRuleId(0).
SetType("qty_diff").
SetTitle("数量不符预警").
SetContent(content).
SetRefType("material_qty_report").
SetRefId(qtyReportNo(rec.ID)).
SetReceiver("").
SetStatus("UNREAD").
Save(ctx)
s.ctx.EventLog.Write(ctx, "station.qty_report", req.OrderNo, req.Operator, "material_qty_report",
req.MaterialCode, "数量不符上报", map[string]any{"stationNo": req.StationNo, "diff": diff, "reportNo": qtyReportNo(rec.ID)})
s.notifyDashboard()
return nil
}
// StationReturnMaterial 工位退料回库房:落事件日志 + 调 WMS 预建待确认退库单。
// returnDock(2026-11-03 拍板)= 退料接驳台(必填,AGV 从该接驳台拉货)。
// 退库单在 WMS 侧由库管确认收货后库存加回(链路封闭,问题记录 L491)。
func (s *Service) StationReturnMaterial(ctx context.Context, orderNo string, stationNo int, sn, materialCode, materialName, spec, reason, operator, unit string, qty int, returnDock string) error {
if stationNo <= 0 || materialCode == "" || qty <= 0 {
return errors.New("工位号、物料编码、退库数量必填")
}
if returnDock == "" {
return errors.New("退料必须指定接驳台(左/右)")
}
s.ctx.EventLog.Write(ctx, "station.return_material", orderNo, operator, "return_order",
materialCode, "工位退料回库房", map[string]any{"stationNo": stationNo, "qty": qty, "reason": reason, "returnDock": returnDock})
// 调 WMS 内部 API 预建退库单(失败降级:记录日志但不阻断工位操作)
if s.ctx.Wms != nil {
if err := s.ctx.Wms.CreateReturnOrder(ctx, orderNo, sn, materialCode, materialName, spec, reason, operator, stationNo, qty, unit, "", returnDock); err != nil {
return fmt.Errorf("通知 WMS 建退库单失败:%w", err)
}
}
return nil
}
// ============ 一键生成工序间检验记录(P0-4) ============
// InterProcessInspection 工序间检验记录汇总项
type InterProcessInspection struct {
OrderNo string `json:"orderNo"`
StationNo int `json:"stationNo"`
StepId int `json:"stepId"`
StepName string `json:"stepName"`
Sn string `json:"sn"`
Result string `json:"result"`
Measured string `json:"measuredValue"`
Photo string `json:"photo"`
Operator string `json:"operator"`
CreatedAt time.Time `json:"createdAt"`
// 装配物料绑定明细(按 SN 跨工艺汇总;客户需求:检验单附装配明细)
Binds []InspectionBindItem `json:"binds,omitempty"`
}
// GenerateInterProcessInspection 汇总某工单 PROCESS 类巡检记录(按步骤维度)生成工序间检验记录。
// 返回结构化列表,前端/H5 据此渲染打印(PDF/Excel);每条记录附该 SN 的装配物料绑定明细。
func (s *Service) GenerateInterProcessInspection(ctx context.Context, orderNo string) ([]*InterProcessInspection, error) {
if orderNo == "" {
return nil, errors.New("工单号必填")
}
if _, err := s.ctx.EntClient.WorkOrder.Query().Where(workorder.WorkOrderNo(orderNo)).First(ctx); err != nil {
return nil, errors.New("工单不存在:" + orderNo)
}
rows, err := s.ctx.EntClient.InspectionRecord.Query().
Where(
inspectionrecord.Category("PROCESS"),
inspectionrecord.OrderNo(orderNo),
).
Order(ent.Desc(inspectionrecord.FieldCreatedAt), ent.Desc(inspectionrecord.FieldID)).
All(ctx)
if err != nil {
return nil, err
}
// 同 SN 的绑定明细只查一次(多条巡检记录常指向同一工件)
bindCache := map[string][]InspectionBindItem{}
out := make([]*InterProcessInspection, 0, len(rows))
for _, r := range rows {
var binds []InspectionBindItem
if r.Sn != "" {
if _, ok := bindCache[r.Sn]; !ok {
bindCache[r.Sn] = s.inspectionBindItems(ctx, r.Sn)
}
binds = bindCache[r.Sn]
}
out = append(out, &InterProcessInspection{
OrderNo: r.OrderNo,
StationNo: atoiSafe(r.StationNo),
StepId: r.StepId,
StepName: r.StepName,
Sn: r.Sn,
Result: r.Result,
Measured: r.MeasuredValue,
Photo: r.Photo,
Operator: r.Operator,
CreatedAt: r.CreatedAt,
Binds: binds,
})
}
return out, nil
}