Files
bj_power/bj_power_mes/internal/logic/agv_vehicle_state.go
T
SunYF 46fcb59079 feat: 退料闭环定稿(损耗台账/备料清单/退料AGV自动派车/剩余量参考)+ 工位托盘守卫
- MES 新增损耗台账 loss_ledger,差异确认损耗接口 ConfirmReceiveLoss(按工单归集)
- 备料清单 preparation:MES 按 日计划×工单×工位×物料 实时计算,WMS 只读展示 PreparationList
- 退料闭环:N5 工位托盘守卫(未完成禁止退料)、退料 AGV 自动派车(JBT21 空位判定 + 托盘回收链路)、退料参考剩余量接口(应剩余=实备-已耗-已退-已损)
- 新增 AGV 车辆状态表 agv_vehicle_state 及查询
- 整合接驳台/叫料池/库存锁既有闭环,清理 sql 目录注释生成脚本与 catalog,更新文档
2026-11-04 19:06:03 +08:00

154 lines
6.2 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) {
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 "空车"
}