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