Files
SunYF 1e92b2a596 feat: 核心业务实体扩充(混产模板/产品BOM/试制记录)、WMS 库存检验增强与前端通用能力
- MES 新增实体:混产模板、产品BOM、产品工艺物料、试制记录(schema + ent 生成码 + logic/handler/前端页)
- WMS 实体增强:检验记录、库存、半成品重构;新增序列号库存与短缺代报
- AGV 与产能:AGV 手动点位与链路、物料守卫、短缺预测、原因字典
- 前端通用能力:新增下一步引导组件 NextStepBar,统一帮助文档/布局/请求拦截与操作列
- 工位终端:界面与各 handler 调整(api/store/绑定/PLC/拧紧/上报等)
- 配置与文档:更新 mes-api.yaml、WMS README 及案例/产线API/问题记录/项目说明/流程说明
2026-11-15 12:17:39 +08:00

148 lines
5.2 KiB
Go
Raw Permalink 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 "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 ""
}