Files
bj_power/bj_power_mes/internal/logic/agv_point_lock.go
T
SunYF af554cea75 feat: 同步失败台账双向可重试 + 拧紧枪按工位配置 + 虚拟工位体系 + 去Redis与文档口径对齐
- 同步失败台账:MES/WMS 双端新增台账与页面,跨系统通知失败落台账、人工重试或标记已处理,不自动重传;重试前先判对端终态;叫料、配送、出库回写失败提示指向台账;补幂等建表脚本与菜单权限。
- 拧紧枪:新增按工位配置页,展示控制器地址与三把枪通道号(仅供查看,不参与采集校验);「允许手填」由全局开关改为每工位开关,关闭时校验该工位已配控制器;终端启动/登录上报配置并按本工位拉取,扭矩手填框按本工位置灰;补全局值迁移到各工位的脚本。
- 工位体系:终端未配置工位号时登录页可选(含虚拟工位),固定工位模式保留;虚拟/线下位不叫料、不退料、不作转产目标,未采集绑定放行并说明原因;叫料期望接驳台改为选填。
- AGV与出库:补「出库单已送达」回写;空车回充、接驳台传感器失联、配送状态更新失败均落预警或留痕并提示人工核对;人工出库不引入送达状态;出库单支持目标工位/接驳台并扩展导出列。
- 基础设施:看板缓存由Redis改为MES进程内实现,文档与启动脚本同步去Redis;扫码监听支持多地址、端口被占自动降级;PLC对账与工位报警在MES不可达时降级放行并留日志。
- 文档与帮助:案例与部署手册按实测订正(工位绑定、菜单名称、补料由班组长代提、菜单覆盖对照、虚拟工位);迁移脚本改为本地即时执行并登记7个已执行脚本;三端页面帮助改为「业务/操作/影响范围/后果」四要素。
- 测试:新增独立Go模块,按三个业务场景做真实HTTP与真实写库的流水测试,含运行报告。
2026-11-09 18:58:47 +08:00

213 lines
9.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"
"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)
}
}