Files
bj_power/bj_power_mes/internal/logic/agv_vehicle_state.go
T
SunYF f8482b18f6 feat: 移除工位模板、AGV 链路增强与产品BOM/混产模板完善
- 移除工位模板体系(handler/logic 全删),同步路由与 seed
- AGV 链路增强:点位锁、车辆状态、退料派车调整,新增海康 RCS Postman 调试集合
- MES 产品BOM/混产模板完善:新增 ProductBOMDialog 组件,调整 handler/logic;日排产达成对比调整
- WMS 业务完善:出入库、检验、备料、退料、成品入库、缺料代报等 handler 与前端页面调整
- 前端通用:双端新增 RemotePageSelect 组件,统一 nextStep 规则/帮助文档/布局/请求拦截
- 文档:更新产线API/案例/部署手册/问题记录等
2026-11-18 09:53:42 +08:00

167 lines
7.0 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/agvvehiclestate"
"bj_power_mes/ent/dock"
)
// ============ AGV 载货状态台账(2026-11-04 防撞校验补做) ============
// 背景:海康 RCS-Lite 协议无直接「载货/有无货」布尔字段(queryAgvStatus 仅 podCode 背货架编号可间接参考,
// 见 internal/agv/client.go),故本系统按车辆编号自维护载货台账 agv_vehicle_state:
// - 取货确认(ConfirmLoadAndGo)→ has_pallet=true(source=AUTO_LOAD)
// - 卸货确认(ConfirmUnloadRelease,含传感器自动放行路径)→ has_pallet=false(source=AUTO_UNLOAD)
// - RCS 回调/任务查询回写的 agv_code 绑定具体车辆;RCS 未分车时记为 DEFAULT(未知车辆)
// - MES「AGV配送 → 车辆状态」页提供人工维护入口(B2),留痕操作人与时间
// 消费方:dispatchAgvSegment 派车前防撞硬拒(B3)——AGV 载货=true 且 目标接驳台有托盘(台账/PLC 传感器)→ 拒派。
// agvUnknownCode RCS 未分车(agv_code 为空)时的兜底台账键。
const agvUnknownCode = "DEFAULT"
// AgvVehicleStateView 载货状态视图(camelCase,与前端契约一致)。
type AgvVehicleStateView struct {
ID int `json:"id"`
AgvCode string `json:"agvCode"`
HasPallet bool `json:"hasPallet"`
Source string `json:"source"`
UpdatedBy string `json:"updatedBy"`
UpdatedAt int64 `json:"updatedAt"`
Remark string `json:"remark"`
}
// setAgvLoadedState 写载货台账(upsert,按 agv_code)。agvCode 为空 → DEFAULT(未知车辆)。
// best-effort:写失败仅打日志,不阻断装卸确认主链路(台账仅用于派车防撞,可人工修正)。
func (s *Service) setAgvLoadedState(ctx context.Context, agvCode string, hasPallet bool, source, operator string) {
code := strings.TrimSpace(agvCode)
if code == "" {
code = agvUnknownCode
}
now := time.Now().Unix()
exist, err := s.ctx.EntClient.AgvVehicleState.Query().
Where(agvvehiclestate.AgvCode(code)).Only(ctx)
if err != nil || exist == nil {
if _, cerr := s.ctx.EntClient.AgvVehicleState.Create().
SetAgvCode(code).SetHasPallet(hasPallet).
SetSource(source).SetUpdatedBy(operator).SetUpdatedAt(now).
Save(ctx); cerr != nil {
fmt.Println("AGV 载货台账写入失败:", cerr)
}
return
}
if uerr := s.ctx.EntClient.AgvVehicleState.UpdateOneID(exist.ID).
SetHasPallet(hasPallet).SetSource(source).
SetUpdatedBy(operator).SetUpdatedAt(now).Exec(ctx); uerr != nil {
fmt.Println("AGV 载货台账更新失败:", uerr)
}
}
// ListAgvVehicleStates 列出载货台账(含 DEFAULT 未知车辆行),供 MES 车辆状态页维护。
func (s *Service) ListAgvVehicleStates(ctx context.Context) ([]AgvVehicleStateView, error) {
rows, err := s.ctx.EntClient.AgvVehicleState.Query().
Order(ent.Asc(agvvehiclestate.FieldAgvCode)).All(ctx)
if err != nil {
return nil, err
}
out := make([]AgvVehicleStateView, 0, len(rows))
for _, r := range rows {
out = append(out, AgvVehicleStateView{
ID: r.ID, AgvCode: r.AgvCode, HasPallet: r.HasPallet,
Source: r.Source, UpdatedBy: r.UpdatedBy, UpdatedAt: r.UpdatedAt, Remark: r.Remark,
})
}
return out, nil
}
// SetAgvVehicleStateManual 人工维护载货状态(B2):手动改「有托盘/空车」,留痕操作人/时间/来源。
func (s *Service) SetAgvVehicleStateManual(ctx context.Context, agvCode string, hasPallet bool, operator, remark string) error {
code := strings.TrimSpace(agvCode)
if code == "" {
return errors.New("车辆编号(agvCode)必填")
}
if len(code) > 32 {
return errors.New("车辆编号过长(≤32 字符)")
}
if operator == "" {
operator = "manual"
}
now := time.Now().Unix()
exist, err := s.ctx.EntClient.AgvVehicleState.Query().
Where(agvvehiclestate.AgvCode(code)).Only(ctx)
if err != nil || exist == nil {
if _, cerr := s.ctx.EntClient.AgvVehicleState.Create().
SetAgvCode(code).SetHasPallet(hasPallet).
SetSource("MANUAL").SetUpdatedBy(operator).SetUpdatedAt(now).
SetRemark(strings.TrimSpace(remark)).Save(ctx); cerr != nil {
return cerr
}
} else if uerr := s.ctx.EntClient.AgvVehicleState.UpdateOneID(exist.ID).
SetHasPallet(hasPallet).SetSource("MANUAL").
SetUpdatedBy(operator).SetUpdatedAt(now).
SetRemark(strings.TrimSpace(remark)).Exec(ctx); uerr != nil {
return uerr
}
s.ctx.EventLog.Write(ctx, "agv.vehicle_state", operator, "", "agv_vehicle_state", code,
"人工修改 AGV 载货状态:"+boolCn2(hasPallet), map[string]any{"hasPallet": hasPallet, "remark": remark})
return nil
}
// anyAgvLoaded 是否存在载货=true 的车辆。
func (s *Service) anyAgvLoaded(ctx context.Context) bool {
n, err := s.ctx.EntClient.AgvVehicleState.Query().
Where(agvvehiclestate.HasPallet(true)).Count(ctx)
return err == nil && n > 0
}
// guardLoadedAgvVsTarget 派车前防撞硬拒(B3):AGV 载货=true 且 目标接驳台有托盘
//(dock 台账或 PLC 传感器任一判定有托盘)→ 拒绝派车。
// 仅对「目标为接驳台(dock)」的段生效;纯点位(充电位等)直接放行。
func (s *Service) guardLoadedAgvVsTarget(ctx context.Context, target string) error {
if target == "" || target == agvChargePoint {
return nil
}
if !s.anyAgvLoaded(ctx) {
// 2026-11-06 JBT21 危险场景加固:载货台账双源校验——台账全空时强制回查 RCS 车载货架
//(podCode 非空且非"0"=车上背着货);台账与 RCS 不一致以 RCS 为准:回写台账并硬拒。
// mock 模式(未接真实 RCS)返回的是示例车,跳过双源校验。
if s.ctx.Agv != nil && !s.ctx.Agv.Disable() {
if vs, verr := s.ctx.Agv.QueryAgvStatus(ctx, s.agvMapShortName(ctx)); verr == nil {
for _, v := range vs {
if v.PodCode != "" && v.PodCode != "0" {
s.setAgvLoadedState(ctx, v.RobotCode, true, "RCS_SYNC", "system")
return errors.New("载货台账与 RCS 不一致(RCS 上报 AGV " + v.RobotCode + " 载货 " + v.PodCode + "),已按 RCS 为准回写台账并拒绝派车;请先人工核实并卸货")
}
}
}
}
return nil
}
d, err := s.ctx.EntClient.Dock.Query().Where(dock.DockCodeEQ(target)).First(ctx)
if err != nil || d == nil {
return nil // 非接驳台点位(纯点位),不适用本防撞
}
if d.HasPallet {
return errors.New("AGV载有托盘,不能前往已有托盘的接驳台(" + target + " 台账有托盘;请先人工修正载货状态或清空接驳台)")
}
// PLC 传感器兜底判定(台账无托盘但传感器检到 → 同样硬拒;PLC 不可达不阻断,走台账)
if s.ctx.PLC != nil && !s.ctx.PLC.IsMock() {
if has, perr := s.ctx.PLC.Get().QueryDockPallet(ctx, target); perr == nil && has {
return errors.New("AGV载有托盘,不能前往已有托盘的接驳台(" + target + " 传感器检到托盘;请先人工修正载货状态或清空接驳台)")
}
}
return nil
}
// boolCn2 bool 转中文(有托盘/空车)。
func boolCn2(b bool) string {
if b {
return "有托盘"
}
return "空车"
}