- MES 新增实体:混产模板、产品BOM、产品工艺物料、试制记录(schema + ent 生成码 + logic/handler/前端页) - WMS 实体增强:检验记录、库存、半成品重构;新增序列号库存与短缺代报 - AGV 与产能:AGV 手动点位与链路、物料守卫、短缺预测、原因字典 - 前端通用能力:新增下一步引导组件 NextStepBar,统一帮助文档/布局/请求拦截与操作列 - 工位终端:界面与各 handler 调整(api/store/绑定/PLC/拧紧/上报等) - 配置与文档:更新 mes-api.yaml、WMS README 及案例/产线API/问题记录/项目说明/流程说明
148 lines
5.2 KiB
Go
148 lines
5.2 KiB
Go
package logic
|
||
|
||
import "strings"
|
||
|
||
// AGV 点位真源(2026-11-14 用户终版;物理布局唯一权威仍是 产线布局说明.md)。
|
||
//
|
||
// 边界(用户 2026-11-14 三次澄清,逐字对齐):
|
||
// - dock(接驳台)与 agv_point(AGV 点位)本来就是两张独立表,不合并、不重命名、不改编码。
|
||
// - GW* 只是 agv_point.position_code,是将来调用 AGV/RCS 接口时要传的点位参数;
|
||
// 产线布局说明.md 的 GxL/GxR 命名、接驳台 DOCK01~20 / JBT21 编码一律不动。
|
||
// - 本文件只负责把「工位 + 物理左右」与「AGV 传参点位码」及「接驳台」对应上。
|
||
//
|
||
// 命名:Z=左、Y=右(中文简称)。
|
||
// 上排单数工位(1/3/5/7/9):地图左台=GWxZ、地图右台=GWxY。
|
||
// 下排双数工位(2/4/6/8/10):左右名称互换,地图左台=GWxY、地图右台=GWxZ。
|
||
// 与 产线布局说明.md:9「工位2 G2R(地图左)/G2L(地图右)」一一对应:GW2Y↔G2R、GW2Z↔G2L,
|
||
// 与 :131「工位2后接驳台1/2 = G2R/G2L」及 seedDocks 的 side 互换规则一致,不是新口径。
|
||
// 接驳台序号固定:DOCK(2n-1)=工位n地图左台,DOCK(2n)=工位n地图右台。
|
||
//
|
||
// 注意:参数 side 指【物理/地图左右】,不是 dock.side(操作员左右,下排工位与地图相反)。
|
||
// 对应关系自洽:地图左台 = DOCK(2n-1) = 下排 dock.side=right = GW 码名字带 Y(右);
|
||
// 地图右台 = DOCK(2n) = 下排 dock.side=left = GW 码名字带 Z(左)。
|
||
// 现有工位终端界面按 dock.side 显示「左/右」,本轮按用户「不是让你改东西」不动界面;
|
||
// 若后续要求「界面选左」直接出 GW 码,需先拍板两种左右的换算口径(见回包【异议】)。
|
||
|
||
// AgvStorePoint 库房收货接驳台(唯一允许人工派车的接驳台点位)。
|
||
const AgvStorePoint = "JBT21"
|
||
|
||
// AgvPointDef 一条 AGV 点位定义。DockSeq:0=虚拟点;1~20=对应 DOCK 序号;21=库房 JBT21。
|
||
type AgvPointDef struct {
|
||
Code string
|
||
Name string
|
||
IsDock bool
|
||
DockSeq int
|
||
}
|
||
|
||
var agvVirtualPoints = []AgvPointDef{
|
||
{"A1", "虚拟点位 A1", false, 0},
|
||
{"A2", "虚拟点位 A2", false, 0},
|
||
{"A3", "虚拟点位 A3", false, 0},
|
||
{"A4", "虚拟点位 A4", false, 0},
|
||
{"XW", "线尾虚拟点位 XW", false, 0},
|
||
{"XT", "线头虚拟点位 XT", false, 0},
|
||
{"KF1", "库房虚拟点位 KF1", false, 0},
|
||
}
|
||
|
||
// AgvPointOf 工位号 + 物理左右 → AGV 接口传参点位码。
|
||
// 例:AgvPointOf(2, "left") = "GW2Y"(工位2 地图左台,用户终版)。
|
||
// 运行时不用正则:固定格式按字符串比较与拼接解析。
|
||
func AgvPointOf(stationNo int, side string) string {
|
||
if stationNo < 1 || stationNo > 10 {
|
||
return ""
|
||
}
|
||
if side != "left" && side != "right" {
|
||
return ""
|
||
}
|
||
isEven := stationNo%2 == 0
|
||
isLeft := side == "left"
|
||
// 单数:左 Z 右 Y;双数:左 Y 右 Z
|
||
useZ := (!isEven && isLeft) || (isEven && !isLeft)
|
||
suffix := "Y"
|
||
if useZ {
|
||
suffix = "Z"
|
||
}
|
||
return "GW" + strconvItoa(stationNo) + suffix
|
||
}
|
||
|
||
// AgvDockSeqOf 工位号 + 物理左右 → 对应接驳台序号(DOCK 编号尾部数字)。
|
||
func AgvDockSeqOf(stationNo int, side string) int {
|
||
if stationNo < 1 || stationNo > 10 || (side != "left" && side != "right") {
|
||
return 0
|
||
}
|
||
if side == "left" {
|
||
return 2*stationNo - 1
|
||
}
|
||
return 2 * stationNo
|
||
}
|
||
|
||
// AgvAllPoints 全量 28 个点位:20 工位接驳台 + 1 库房接驳台 + 7 虚拟点位。
|
||
func AgvAllPoints() []AgvPointDef {
|
||
out := make([]AgvPointDef, 0, 28)
|
||
for n := 1; n <= 10; n++ {
|
||
for _, side := range []string{"left", "right"} {
|
||
cn := "左"
|
||
if side == "right" {
|
||
cn = "右"
|
||
}
|
||
out = append(out, AgvPointDef{
|
||
Code: AgvPointOf(n, side),
|
||
Name: "工位" + strconvItoa(n) + cn + "接驳台",
|
||
IsDock: true,
|
||
DockSeq: AgvDockSeqOf(n, side),
|
||
})
|
||
}
|
||
}
|
||
out = append(out, AgvPointDef{Code: AgvStorePoint, Name: "库房收货接驳台", IsDock: true, DockSeq: 21})
|
||
out = append(out, agvVirtualPoints...)
|
||
return out
|
||
}
|
||
|
||
// IsAgvVirtualPoint 是否 7 个虚拟点位之一(不在物理图上、无接驳台)。
|
||
func IsAgvVirtualPoint(code string) bool {
|
||
for _, p := range agvVirtualPoints {
|
||
if p.Code == code {
|
||
return true
|
||
}
|
||
}
|
||
return false
|
||
}
|
||
|
||
// AgvManualAllowed 人工派车白名单硬闸门:只允许 JBT21 和 7 个虚拟点位;
|
||
// 所有 GW*(工位接驳台)与 DOCK*(历史业务点位)一律禁止。
|
||
func AgvManualAllowed(code string) bool {
|
||
if code == "" {
|
||
return false
|
||
}
|
||
if code == AgvStorePoint {
|
||
return true
|
||
}
|
||
if strings.HasPrefix(code, "GW") {
|
||
return false
|
||
}
|
||
return IsAgvVirtualPoint(code)
|
||
}
|
||
|
||
// AgvTemplateOf 目标点 → 送 RCS 的任务模板:JBT21 或 GW* → B01 举升;虚拟点 → B02 移动。
|
||
// 返回空串表示历史点位(DOCK*/待命/充电),由调用方按库内 is_dock 兜底,避免动既有派车链路。
|
||
func AgvTemplateOf(code string) string {
|
||
if code == AgvStorePoint || strings.HasPrefix(code, "GW") {
|
||
return "B01"
|
||
}
|
||
if IsAgvVirtualPoint(code) {
|
||
return "B02"
|
||
}
|
||
return ""
|
||
}
|
||
|
||
// strconvItoa 局部封装:避免为 1~10 的工位号引入正则或 fmt 依赖。
|
||
func strconvItoa(n int) string {
|
||
if n == 10 {
|
||
return "10"
|
||
}
|
||
if n >= 1 && n <= 9 {
|
||
return string(rune('0' + n))
|
||
}
|
||
return ""
|
||
}
|