- 移除工位模板体系(handler/logic 全删),同步路由与 seed - AGV 链路增强:点位锁、车辆状态、退料派车调整,新增海康 RCS Postman 调试集合 - MES 产品BOM/混产模板完善:新增 ProductBOMDialog 组件,调整 handler/logic;日排产达成对比调整 - WMS 业务完善:出入库、检验、备料、退料、成品入库、缺料代报等 handler 与前端页面调整 - 前端通用:双端新增 RemotePageSelect 组件,统一 nextStep 规则/帮助文档/布局/请求拦截 - 文档:更新产线API/案例/部署手册/问题记录等
222 lines
10 KiB
Go
222 lines
10 KiB
Go
package logic
|
||
|
||
import (
|
||
"context"
|
||
"errors"
|
||
"fmt"
|
||
"strings"
|
||
"time"
|
||
|
||
"bj_power_mes/ent"
|
||
"bj_power_mes/ent/agvpoint"
|
||
"bj_power_mes/ent/agvtask"
|
||
)
|
||
|
||
// ============ 派车锁(点位锁定,2026-11-06 拍板) ============
|
||
// 目的:防止两个任务同时抢同一个点位(逻辑闸门,与 PLC 传感器物理校验互补)。
|
||
// - 派车成功 → 目标点位 locked=true、locked_by=system、locked_reason=任务号;
|
||
// - 装货离场(ConfirmLoadAndGo)/卸货放行(ConfirmUnloadRelease)/链推进/结束/取消 → 自动释放;
|
||
// - JBT21(库房接驳台)例外:卸货完成后不自动释放,保持锁定,库管在「点位管理」手动解锁;
|
||
// - manual 锁=库管手动锁定,仅手动解锁,任务终态不释放;
|
||
// - 锁与 PLC 传感器比对不一致 → 落预警不拦车(传感器是物理校验,不是派车闸门)。
|
||
// 充电位(agvChargePoint)不参与锁(多链空车回充共用同一目标)。
|
||
|
||
// agvPointLockMsg 派车锁拒绝文案(2026-11-06 拍板原文)。
|
||
const agvPointLockMsg = "目标点位被占用,请稍后或联系库管"
|
||
|
||
// agvPointByCode 按点位编码取点位行;不存在返回 nil(调用方自行处理)。
|
||
func (s *Service) agvPointByCode(ctx context.Context, code string) *ent.AgvPoint {
|
||
if strings.TrimSpace(code) == "" {
|
||
return nil
|
||
}
|
||
pt, err := s.ctx.EntClient.AgvPoint.Query().
|
||
Where(agvpoint.PositionCode(code)).Only(ctx)
|
||
if err != nil || pt == nil {
|
||
return nil
|
||
}
|
||
return pt
|
||
}
|
||
|
||
// preDispatchPointCheck 派车前点位检查(所有派车入口统一走此口):
|
||
//
|
||
// ① 派车锁:locked=true 拒绝(文案=拍板原文);
|
||
// ② 强提标记:force_pick=true 且未人工确认 → 拒绝(要求人工二次确认,确认后由调用方清标);
|
||
// ③ 传感器↔锁比对:点位未锁但传感器检到托盘 → 落预警不拦车(账实不符提示现场核实)。
|
||
//
|
||
// 充电位免检。返回 error 即拒绝派车。
|
||
func (s *Service) preDispatchPointCheck(ctx context.Context, target, confirmForcePick string) error {
|
||
if target == "" || target == agvChargePoint {
|
||
return nil
|
||
}
|
||
pt := s.agvPointByCode(ctx, target)
|
||
if pt == nil {
|
||
return nil // 点位不存在由模板推导/防撞校验兜底报错
|
||
}
|
||
// ① 派车锁(2026-11-17 用户要求:报错必须带任务详情,人要有判定依据)
|
||
if pt.Locked {
|
||
detail := pt.LockedReason
|
||
if pt.LockedBy == "system" && pt.LockedReason != "" {
|
||
if t, terr := s.ctx.EntClient.AgvTask.Query().Where(agvtask.TaskNo(pt.LockedReason)).First(ctx); terr == nil {
|
||
detail = pt.LockedReason + "(" + agvTaskStatusText(t.Status) + ",模板 " + t.TemplateType + "," + t.SourceDock + "→" + t.TargetDock + ")"
|
||
}
|
||
}
|
||
return errors.New(agvPointLockMsg + "(" + target + ",锁定原因:" + detail + ")")
|
||
}
|
||
// ② 强提标记:未确认拒绝
|
||
if pt.ForcePick && confirmForcePick != "1" {
|
||
return errors.New("目标点位 " + target + " 存在强提风险标记(PLC 离线期间强行提交过叫料),请确认现场安全后勾选人工确认重试")
|
||
}
|
||
// ③ 传感器↔锁比对(不一致落预警不拦车)
|
||
// B8(2026-11-08):设备失联统一降级为「提示 + 人工确认 + 留痕」(案例.md:450/550)。
|
||
// 旧实现把 PLC 读取错误 err!=nil 静默吞掉(fail-open 无任何留痕),现改为:
|
||
// 先落预警中心 + 操作日志留痕,再要求人工确认;确认后放行,未确认则拦截并提示。
|
||
// 系统不做任何自动补偿,单据与台账照常落库,现场状态由人工目视兜底。
|
||
if !pt.Locked && pt.IsDock && s.ctx.PLC != nil && !s.ctx.PLC.IsMock() {
|
||
has, derr := s.ctx.PLC.Get().QueryDockPallet(ctx, target)
|
||
if derr != nil {
|
||
s.ctx.EventLog.Write(ctx, "agv.plc_unavailable", "system", "", "agv_point", target,
|
||
"派车前读取接驳台传感器失败(设备失联):"+derr.Error()+",已降级为人工确认", nil)
|
||
_ = s.CreateAlert(ctx, "agv_plc_unavailable", "警告", target,
|
||
"派车前无法读取接驳台 "+target+" 的传感器(PLC 不可达),需人工核对现场托盘状态后确认派车")
|
||
if confirmForcePick != "1" {
|
||
return fmt.Errorf("设备失联:无法读取接驳台 %s 的传感器(%v)。请人工确认现场安全后勾选人工确认重试派车;系统不做自动补偿", target, derr)
|
||
}
|
||
return nil // 已人工确认:放行并留痕
|
||
}
|
||
if has {
|
||
s.ctx.EventLog.Write(ctx, "agv.point_sensor_mismatch", "system", "", "agv_point", target,
|
||
"派车前比对:点位未锁定但传感器检测到托盘(无在途任务占用),请现场核实", nil)
|
||
}
|
||
}
|
||
return nil
|
||
}
|
||
|
||
// lockAgvPointForTask 派车成功后置系统锁(best-effort:失败仅记日志,不回滚派车)。
|
||
func (s *Service) lockAgvPointForTask(ctx context.Context, target, taskNo string) {
|
||
if target == "" || target == agvChargePoint {
|
||
return
|
||
}
|
||
pt := s.agvPointByCode(ctx, target)
|
||
if pt == nil || pt.Locked {
|
||
return // 已被锁(并发窗口极小,派车前置检查已拦)
|
||
}
|
||
if err := s.ctx.EntClient.AgvPoint.UpdateOneID(pt.ID).
|
||
SetLocked(true).SetLockedBy("system").
|
||
SetLockedReason(taskNo).SetLockedAt(time.Now().Unix()).Exec(ctx); err != nil {
|
||
fmt.Println("AGV 点位锁定写入失败:", err)
|
||
return
|
||
}
|
||
s.ctx.EventLog.Write(ctx, "agv.point_lock", "system", "", "agv_point", target,
|
||
"派车成功自动锁定(任务 "+taskNo+")", nil)
|
||
}
|
||
|
||
// unlockAgvPointByTask 任务终态释放系统锁:仅当 locked_by=system 且 locked_reason=该任务号才清锁;
|
||
// manual 锁不受任务终态影响。JBT21 由调用方按例外规则跳过本函数。
|
||
func (s *Service) unlockAgvPointByTask(ctx context.Context, target, taskNo string) {
|
||
if target == "" || target == agvChargePoint || taskNo == "" {
|
||
return
|
||
}
|
||
pt := s.agvPointByCode(ctx, target)
|
||
if pt == nil || !pt.Locked || pt.LockedBy != "system" || pt.LockedReason != taskNo {
|
||
return
|
||
}
|
||
if err := s.ctx.EntClient.AgvPoint.UpdateOneID(pt.ID).
|
||
SetLocked(false).SetLockedBy("").SetLockedReason("").SetLockedAt(0).Exec(ctx); err != nil {
|
||
fmt.Println("AGV 点位解锁写入失败:", err)
|
||
return
|
||
}
|
||
s.ctx.EventLog.Write(ctx, "agv.point_unlock", "system", "", "agv_point", target,
|
||
"任务 "+taskNo+" 终态自动解锁", nil)
|
||
}
|
||
|
||
// SetAgvPointLockManual 库管手动锁定/解锁(「点位管理」入口,操作留痕)。
|
||
// locked=true → manual 锁(必须填原因);locked=false → 清任意锁(含 system 锁,JBT21 手动解锁走这里)。
|
||
func (s *Service) SetAgvPointLockManual(ctx context.Context, id int, locked bool, reason, operator string) error {
|
||
pt, err := s.ctx.EntClient.AgvPoint.Get(ctx, id)
|
||
if err != nil || pt == nil {
|
||
return errors.New("点位不存在")
|
||
}
|
||
if locked {
|
||
reason = strings.TrimSpace(reason)
|
||
if reason == "" {
|
||
return errors.New("手动锁定必须填写原因")
|
||
}
|
||
if err := s.ctx.EntClient.AgvPoint.UpdateOneID(id).
|
||
SetLocked(true).SetLockedBy("manual").
|
||
SetLockedReason(reason).SetLockedAt(time.Now().Unix()).Exec(ctx); err != nil {
|
||
return err
|
||
}
|
||
s.ctx.EventLog.Write(ctx, "agv.point_lock", operator, "", "agv_point", pt.PositionCode,
|
||
"人工锁定点位,原因:"+reason, nil)
|
||
return nil
|
||
}
|
||
if err := s.ctx.EntClient.AgvPoint.UpdateOneID(id).
|
||
SetLocked(false).SetLockedBy("").SetLockedReason("").SetLockedAt(0).Exec(ctx); err != nil {
|
||
return err
|
||
}
|
||
s.ctx.EventLog.Write(ctx, "agv.point_unlock", operator, "", "agv_point", pt.PositionCode,
|
||
"人工解锁点位(含 JBT21 手动解锁/系统锁人工释放)", nil)
|
||
return nil
|
||
}
|
||
|
||
// ClearAgvPointForcePick 清除强提风险标记(人工确认现场安全后,在「点位管理」清除;留痕)。
|
||
func (s *Service) ClearAgvPointForcePick(ctx context.Context, id int, operator string) error {
|
||
pt, err := s.ctx.EntClient.AgvPoint.Get(ctx, id)
|
||
if err != nil || pt == nil {
|
||
return errors.New("点位不存在")
|
||
}
|
||
if !pt.ForcePick {
|
||
return errors.New("该点位无强提风险标记")
|
||
}
|
||
if err := s.ctx.EntClient.AgvPoint.UpdateOneID(id).
|
||
SetForcePick(false).SetForcePickAt(0).Exec(ctx); err != nil {
|
||
return err
|
||
}
|
||
s.ctx.EventLog.Write(ctx, "agv.force_pick_clear", operator, "", "agv_point", pt.PositionCode,
|
||
"人工清除强提风险标记(已确认现场安全)", nil)
|
||
return nil
|
||
}
|
||
|
||
// clearForcePickOnDispatch 强提点位确认派车成功后自动清标(二次确认已完成,标记使命结束;留痕)。
|
||
func (s *Service) clearForcePickOnDispatch(ctx context.Context, target string) {
|
||
pt := s.agvPointByCode(ctx, target)
|
||
if pt == nil || !pt.ForcePick {
|
||
return
|
||
}
|
||
if err := s.ctx.EntClient.AgvPoint.UpdateOneID(pt.ID).
|
||
SetForcePick(false).SetForcePickAt(0).Exec(ctx); err != nil {
|
||
fmt.Println("强提标记清除失败:", err)
|
||
return
|
||
}
|
||
s.ctx.EventLog.Write(ctx, "agv.force_pick_clear", "system", "", "agv_point", target,
|
||
"强提点位人工确认后派车成功,自动清除标记", nil)
|
||
}
|
||
|
||
// MarkForcePickOnCallOrders PLC 离线强提叫料 → 目标点位打「强提」风险标记 + 推预警
|
||
// (2026-11-06 拍板:强提后该点位派车要求人工二次确认)。
|
||
// dockCodes=叫料行期望接驳台(为空时由调用方补全为该工位全部启用接驳台)。
|
||
func (s *Service) MarkForcePickOnCallOrders(ctx context.Context, dockCodes []string, ref string) {
|
||
now := time.Now().Unix()
|
||
marked := 0
|
||
for _, code := range dockCodes {
|
||
pt := s.agvPointByCode(ctx, code)
|
||
if pt == nil || pt.ForcePick {
|
||
continue
|
||
}
|
||
if err := s.ctx.EntClient.AgvPoint.UpdateOneID(pt.ID).
|
||
SetForcePick(true).SetForcePickAt(now).Exec(ctx); err != nil {
|
||
fmt.Println("强提标记写入失败:", err)
|
||
continue
|
||
}
|
||
marked++
|
||
}
|
||
if marked > 0 {
|
||
if aerr := s.CreateAlert(ctx, "force_pick_marked", "警告", ref,
|
||
"PLC 离线强提叫料,以下点位已打强提风险标记(后续派车需人工二次确认):"+strings.Join(dockCodes, "、")); aerr != nil {
|
||
fmt.Println("强提预警写入失败:", aerr)
|
||
}
|
||
s.ctx.EventLog.Write(ctx, "agv.force_pick_mark", "system", "", "agv_point", strings.Join(dockCodes, ","),
|
||
"PLC 离线强提,点位打强提标记 ref="+ref, nil)
|
||
}
|
||
}
|