feat: 核心业务实体扩充(混产模板/产品BOM/试制记录)、WMS 库存检验增强与前端通用能力

- MES 新增实体:混产模板、产品BOM、产品工艺物料、试制记录(schema + ent 生成码 + logic/handler/前端页)
- WMS 实体增强:检验记录、库存、半成品重构;新增序列号库存与短缺代报
- AGV 与产能:AGV 手动点位与链路、物料守卫、短缺预测、原因字典
- 前端通用能力:新增下一步引导组件 NextStepBar,统一帮助文档/布局/请求拦截与操作列
- 工位终端:界面与各 handler 调整(api/store/绑定/PLC/拧紧/上报等)
- 配置与文档:更新 mes-api.yaml、WMS README 及案例/产线API/问题记录/项目说明/流程说明
This commit is contained in:
SunYF
2026-11-15 12:17:39 +08:00
parent 7e8066ab66
commit 1e92b2a596
221 changed files with 26421 additions and 2230 deletions
+13 -13
View File
@@ -81,11 +81,11 @@ func retryMaterialSyncHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
// itemTypeLabel 物料类别标签:1原材料/3成品(「其他」类别已按 2026-10-19 裁决全项目移除,
// 半成品类别早已下线,2 仅为历史存量数据防御性显示)
// 在制品类别早已下线,2 仅为历史存量数据防御性显示)
func itemTypeLabel(t int) string {
switch t {
case invCatSemi:
return "半成品"
return "在制品"
case invCatFinished:
return "成品"
default:
@@ -108,8 +108,8 @@ func validateMaterialRequired(name, spec, unit string, itemType, manageMode, snM
case strings.TrimSpace(unit) == "":
return "单位为必填项"
case itemType == invCatSemi:
// 2026-09-22 定稿:半成品是工件状态(由库存 category=2 承载),不再是物料类别
return "半成品不再是物料类别,请选择成品档案并在库存中记录工序状态"
// 2026-09-22 定稿:在制品是工件状态(由库存 category=2 承载),不再是物料类别
return "在制品不再是物料类别,请选择成品档案并在库存中记录工序状态"
case itemType != invCatRaw && itemType != invCatFinished:
return "物料类别为必填项(原材料 / 成品)"
case manageMode != 1 && manageMode != 2 && manageMode != invManageOther:
@@ -143,8 +143,8 @@ func collectMaterialRequired(ve *verr.ValidationError, name, spec, unit string,
ve.Add("unit", "单位为必填项", "请填写计量单位(如 件 / 个 / 米)")
}
if itemType == invCatSemi {
// 2026-09-22 定稿:半成品是工件状态(由库存 category=2 承载),不再是物料类别
ve.Add("itemType", "半成品不再是物料类别", "请选择「成品」档案;半成品在库存中记录工序状态")
// 2026-09-22 定稿:在制品是工件状态(由库存 category=2 承载),不再是物料类别
ve.Add("itemType", "在制品不再是物料类别", "请选择「成品」档案;在制品在库存中记录工序状态")
} else if itemType != invCatRaw && itemType != invCatFinished {
ve.Add("itemType", "物料类别为必填项", "在「物料类别」里选择 原材料 或 成品")
}
@@ -169,7 +169,7 @@ func createMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
ManageMode int `json:"manageMode"` // 类型 1结构件/2电气件/3其他
SnMode int `json:"snMode"` // 序列号 1序列号=是/2序列号=否(0未选择不可保存)
TemplateCode string `json:"templateCode"`
ItemType int `json:"itemType"` // 1原材料/3成品(半成品不是物料类别)
ItemType int `json:"itemType"` // 1原材料/3成品(在制品不是物料类别)
SafetyStock int `json:"safetyStock"` // 安全库存(低于触发缺货预警)
IsActive *bool `json:"isActive"` // 启用状态(nil 视为启用)
}
@@ -607,7 +607,7 @@ func getMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
// materialManageModesHandler 内部接口:批量查询物料「类型」(manage_mode: 1结构件/2电气件/3其他)。
// 注意:物料类别(item_type=1原材料/2半成品/3成品/4其他,成品/组件类维度)与「类型」(结构件/电气件/其他)是两个独立维度,本接口只查后者。
// 注意:物料类别(item_type=1原材料/2在制品/3成品/4其他,成品/组件类维度)与「类型」(结构件/电气件/其他)是两个独立维度,本接口只查后者。
// body: {"codes":["A","B"]} → data: {"manageModes": {"A":1}}(不存在的编码不返回)。
func materialManageModesHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
@@ -796,7 +796,7 @@ func parseManageMode(s string) int {
}
// parseItemType 解析导入模板"物料类别"列(兼容旧模板"品类"列名):原材料/成品(兼容 1/3);无法识别返回 0。
// 注意:"半成品"不再是物料类别(2026-09-22),且含"成品"子串,必须先排除再判成品;
// 注意:"在制品"不再是物料类别(2026-09-22),且含"成品"子串,必须先排除再判成品;
// 「其他」类别已按 2026-10-19 裁决全项目移除,历史含"其他"的导入行按无法识别整体拒绝。
func parseItemType(s string) int {
s = strings.TrimSpace(s)
@@ -806,8 +806,8 @@ func parseItemType(s string) int {
switch {
case strings.Contains(s, "原材料"):
return 1
case strings.Contains(s, "半成品"):
return 0 // 半成品已不是物料类别,导入该行按"物料类别无法识别"整体拒绝
case strings.Contains(s, "在制品"):
return 0 // 在制品已不是物料类别,导入该行按"物料类别无法识别"整体拒绝
case strings.Contains(s, "成品"):
return 3
}
@@ -839,7 +839,7 @@ func excelMaterialImportTemplateHandler(ctx *svc.ServiceContext) http.HandlerFun
"3. 物料编码:选填,普通档案字段(如 WL-0001),不参与业务与必填校验。",
"4. 名称 / 规格 / 单位:必填,不可为空。",
"5. 类型:填「结构件」「电气件」「其他」或数字 1/2/3(决定按批次还是按序列号记账)。",
"6. 类别:填「原材料」或「成品」,留空默认原材料(兼容旧列名「物料类别」;半成品不是物料类别)。",
"6. 类别:填「原材料」或「成品」,留空默认原材料(兼容旧列名「物料类别」;在制品不是物料类别)。",
"7. 序列号:MES 模板字段,WMS 导入忽略(本端按类型自动派生,成品强制序列号=是)。",
"8. 启用:MES 模板字段,WMS 导入忽略(本端默认启用)。",
"9. 说明:可空,备注信息。",
@@ -1045,7 +1045,7 @@ func parseMaterialImportPlan(ctx *svc.ServiceContext, rows [][]string) ([]materi
continue
}
if catCol >= 0 && cell(catCol) != "" && pr.itemType == 0 {
errs = append(errs, importErr{pr.row, pr.code, "物料类别无法识别,请填写「原材料/成品」(兼容 1/3;半成品不是物料类别,「其他」已取消)"})
errs = append(errs, importErr{pr.row, pr.code, "物料类别无法识别,请填写「原材料/成品」(兼容 1/3;在制品不是物料类别,「其他」已取消)"})
continue
}
exists, _ := ctx.EntClient.Material.Query().