package logic import ( "context" "errors" "fmt" "strings" "time" "bj_power_mes/ent" "bj_power_mes/ent/agvpoint" ) // ============ 派车锁(点位锁定,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 // 点位不存在由模板推导/防撞校验兜底报错 } // ① 派车锁 if pt.Locked { return errors.New(agvPointLockMsg + "(" + target + ",锁定原因:" + pt.LockedReason + ")") } // ② 强提标记:未确认拒绝 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) } }