feat: 全端体验与稳定性整改(帮助文档清理/收集式报错/操作列统一/托盘与WS通知/物料同步重推)

- 移除 bj_power_dashboard 旧 React 大屏源码(迁移至 2D SVG 方案)
- MES/WMS/工位终端前端:清理 help.js 与 PageHelp 帮助文档,统一操作列与布局,接入请求拦截器
- 新增收集式校验错误弹窗(ErrorListDialog 统一拦截 3015,逐条列现象+建议)
- 新增托盘程序(tray)与 WebSocket(ws) 实时通知模块(三端共用)
- MES/WMS 物料档案新增同步状态字段,补齐双向失败重推与默认角色 seed
- 工单/产能/产品工艺/日排产逻辑调整;拧紧枪按工位配置
- 新增迁移 SQL:扭矩按工位、sysconfig 序列修复
- 更新 技术约束/案例/部署手册/项目说明 等文档
This commit is contained in:
SunYF
2026-11-10 23:42:50 +08:00
parent af554cea75
commit 619fc8983d
219 changed files with 8565 additions and 10739 deletions
+66 -43
View File
@@ -161,6 +161,7 @@ func createMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req struct {
Code string `json:"code"`
MaterialCode string `json:"materialCode"` // 物料编码(普通字段,不参与必填校验)
Name string `json:"name"`
Spec string `json:"spec"`
Unit string `json:"unit"`
@@ -179,11 +180,11 @@ func createMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
// 必填口径(2026-09-19 用户裁决):除「说明」外全部必填 —— 收集式一次列全(2026-10-20 报错规范)
ve := verr.New()
if strings.TrimSpace(req.Code) == "" {
ve.Add("code", "图号为必填项", "请填写物料图号(图号即物料编码)")
ve.Add("code", "图号为必填项", "请填写物料图号")
}
collectMaterialRequired(ve, req.Name, req.Spec, req.Unit, req.ItemType, req.ManageMode, req.SnMode)
if req.ItemType == invCatFinished && req.SnMode != snModeSN {
ve.Add("snMode", "成品物料的序列号必须为「是」", "成品逐件追溯、SN 由系统兜底生成;把序列号改为「序列号=是」")
ve.Add("snMode", "成品物料的序列号必须为「是」", "成品逐件追溯、产品序号(SN) 由系统兜底生成;把序列号改为「序列号=是」")
}
// 校验编码唯一(与其他校验相互独立,一并收集)
if strings.TrimSpace(req.Code) != "" {
@@ -214,6 +215,7 @@ func createMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
m, err := ctx.EntClient.Material.Create().
SetCode(req.Code).
SetMaterialCode(strings.TrimSpace(req.MaterialCode)).
SetName(req.Name).
SetNillableSpec(strPtr(req.Spec)).
SetNillableUnit(strPtr(req.Unit)).
@@ -244,16 +246,17 @@ func createMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
func updateMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req struct {
ID int `json:"id"`
Name string `json:"name"`
Spec string `json:"spec"`
Unit string `json:"unit"`
Description string `json:"description"`
ManageMode int `json:"manageMode"` // 类型 1结构件/2电气件/3其他
SnMode int `json:"snMode"` // 序列号 1序列号=是/2序列号=否(0未选择不可保存)
ItemType int `json:"itemType"`
SafetyStock int `json:"safetyStock"`
IsActive *bool `json:"isActive"`
ID int `json:"id"`
MaterialCode string `json:"materialCode"` // 物料编码(普通字段,不参与必填校验)
Name string `json:"name"`
Spec string `json:"spec"`
Unit string `json:"unit"`
Description string `json:"description"`
ManageMode int `json:"manageMode"` // 类型 1结构件/2电气件/3其他
SnMode int `json:"snMode"` // 序列号 1序列号=是/2序列号=否(0未选择不可保存)
ItemType int `json:"itemType"`
SafetyStock int `json:"safetyStock"`
IsActive *bool `json:"isActive"`
}
if err := parseJSON(r, &req); err != nil || req.ID <= 0 {
fail(w, http.StatusBadRequest, "参数错误")
@@ -274,7 +277,7 @@ func updateMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
// ③ 已有工单引用(工单用料台账有该物料行)→ 物料类别锁死,禁止改;
// ④ 类型(结构件/电气件/其他)已被库存引用 → 锁死(2026-10-20 拍板:三字段已使用不可修改)。
if req.ItemType == invCatFinished && req.SnMode != snModeSN {
ve.Add("snMode", "成品物料的序列号必须为「是」,不可修改", "成品逐件追溯、SN 由系统兜底生成;把序列号改回「序列号=是」")
ve.Add("snMode", "成品物料的序列号必须为「是」,不可修改", "成品逐件追溯、产品序号(SN) 由系统兜底生成;把序列号改回「序列号=是」")
}
if req.SnMode != cur.SnMode {
snRef, cerr := ctx.EntClient.Inventory.Query().
@@ -312,6 +315,7 @@ func updateMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
manageMode := req.ManageMode
m, err := ctx.EntClient.Material.UpdateOneID(req.ID).
SetMaterialCode(strings.TrimSpace(req.MaterialCode)).
SetName(req.Name).
SetSpec(req.Spec).
SetUnit(req.Unit).
@@ -730,34 +734,35 @@ func exportMaterialsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
type exportRow struct {
ID int
Code string
Name string
Spec string
Unit string
ItemType int
ManageMode int
SnMode int
Description string
CreatedAt int64
ID int
Code string
MaterialCode string
Name string
Spec string
Unit string
ItemType int
ManageMode int
SnMode int
Description string
CreatedAt int64
}
rows := make([]exportRow, 0, len(list))
for _, m := range list {
rows = append(rows, exportRow{
ID: m.ID, Code: m.Code, Name: m.Name, Spec: m.Spec,
ID: m.ID, Code: m.Code, MaterialCode: m.MaterialCode, Name: m.Name, Spec: m.Spec,
Unit: m.Unit, ItemType: m.ItemType, ManageMode: m.ManageMode,
SnMode: m.SnMode, Description: m.Description, CreatedAt: m.CreatedAt,
})
}
if r.URL.Query().Get("format") == "xlsx" {
// 图号=物料编码(问题记录 L18 合并裁决):导出表头统一叫「图号」
// 图号列沿用业务主键名;问题12 新增「物料编码」普通字段列(与导入模板一致)
// 「简称」已按 2026-09-19 用户裁决整体删除,导出列同步移除
headers := []string{"ID", "图号", "名称", "规格", "单位", "物料类别", "类型", "序列号", "说明", "创建时间"}
headers := []string{"ID", "图号", "物料编码", "名称", "规格", "单位", "物料类别", "类型", "序列号", "说明", "创建时间"}
matrix := make([][]any, 0, len(rows))
for _, rr := range rows {
matrix = append(matrix, []any{
rr.ID, rr.Code, rr.Name, rr.Spec, rr.Unit,
rr.ID, rr.Code, rr.MaterialCode, rr.Name, rr.Spec, rr.Unit,
itemTypeLabel(rr.ItemType), manageModeLabel(rr.ManageMode), snModeLabel(rr.SnMode),
rr.Description, unixFmt(rr.CreatedAt),
})
@@ -813,20 +818,34 @@ func parseItemType(s string) int {
}
// excelMaterialImportHandler 物料档案 Excel 批量导入
// 模板(首行忽略表头):图号 | 名称 | 规格 | 单位 | 类型(结构件/电气件) | 说明
// (图号=物料编码,问题记录 L18 合并裁决,不再单设图号列;「简称」列已按 2026-09-19 裁决移除)
// 模板(2026-11-10 与 MES 模板统一,10 列同序):图号 | 物料编码 | 名称 | 规格 | 单位 | 类型 | 类别 | 序列号 | 启用 | 说明
// 「物料编码」为选填普通字段;「类别」兼容旧列名「物料类别」;「序列号/启用」为 MES 业务差异列,WMS 导入忽略(按类型派生序列号、默认启用)。
// 强约束:全成功或全失败(一次性全导入 or 全失败,禁止部分成功)。
// 阶段1 逐行解析+校验(图号必填且唯一 / 名称、规格、单位必填 / 类型合法) → 任一错则整体拒绝并列出错误行;
// 阶段2 全部通过 → 开启单事务整体提交,任一步失败整体回滚。
// excelMaterialImportTemplateHandler 物料档案导入模板下载(2026-10-21):
// 第1行表头 + 第2行示例数据(导入前请删除),列顺序与导入说明一致。
// excelMaterialImportTemplateHandler 物料档案导入模板下载:
// 第1行表头 + 第2/3行示例数据(导入前请删除)+「填写说明」页逐列字段说明。
func excelMaterialImportTemplateHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
headers := []string{"图号", "名称", "规格", "单位", "类型", "物料类别", "说明"}
headers := []string{"图号", "物料编码", "名称", "规格", "单位", "类型", "类别", "序列号", "启用", "说明"}
rows := [][]any{
{"DX100-001", "示例物料名称", "300x200x150", "个", "结构件", "原材料", "示例行,导入前请删除"},
{"DX100-001", "WL-0001", "示例成品", "300x200x150", "台", "结构件", "成品", "是", "是", "示例行,导入前请删除"},
{"M-BEARING-6204", "WL-0002", "示例原材料-轴承6204", "6204-RS", "个", "结构件", "原材料", "否", "是", "示例行,导入前请删除"},
}
sendExcel(w, "物料档案导入模板.xlsx", headers, rows)
guides := []string{
"【列顺序】图号 | 物料编码 | 名称 | 规格 | 单位 | 类型 | 类别 | 序列号 | 启用 | 说明(与 MES 模板一致,按表头名识别,请勿改动表头文字)",
"1. 仅保留第一个「Sheet1」数据页,「填写说明」页请勿删除或填入数据;第2/3行是示例,正式导入前请删除。",
"2. 图号:必填且唯一,物料唯一标识(两库同步业务键);已有相同图号的行会被拒绝。",
"3. 物料编码:选填,普通档案字段(如 WL-0001),不参与业务与必填校验。",
"4. 名称 / 规格 / 单位:必填,不可为空。",
"5. 类型:填「结构件」「电气件」「其他」或数字 1/2/3(决定按批次还是按序列号记账)。",
"6. 类别:填「原材料」或「成品」,留空默认原材料(兼容旧列名「物料类别」;半成品不是物料类别)。",
"7. 序列号:MES 模板字段,WMS 导入忽略(本端按类型自动派生,成品强制序列号=是)。",
"8. 启用:MES 模板字段,WMS 导入忽略(本端默认启用)。",
"9. 说明:可空,备注信息。",
"10. 首行为表头,从第二行开始为数据;整批校验,任一行出错则一行不写(导入前可先点「预检」看错误明细)。",
}
sendExcelWithGuide(w, "物料档案导入模板.xlsx", headers, rows, guides)
}
}
@@ -886,6 +905,7 @@ func excelMaterialImportHandler(ctx *svc.ServiceContext) http.HandlerFunc {
for _, pr := range plans {
mc := tx.Material.Create().
SetCode(pr.code).
SetMaterialCode(pr.materialCode).
SetName(pr.name).
SetNillableSpec(strPtr(pr.spec)).
SetNillableUnit(strPtr(pr.unit)).
@@ -921,15 +941,16 @@ func excelMaterialImportHandler(ctx *svc.ServiceContext) http.HandlerFunc {
// materialImportPlan 物料档案导入单行写入计划(预检与写入共用同一解析/校验,规则同源不漂移)。
type materialImportPlan struct {
row int
code string
name string
spec string
unit string
manageMode int
snMode int // 序列号=是/否:按类型默认联动派生(电气件→1,其余→2)
itemType int
description string
row int
code string
materialCode string // 物料编码(普通字段,不参与必填校验)
name string
spec string
unit string
manageMode int
snMode int // 序列号=是/否:按类型默认联动派生(电气件→1,其余→2)
itemType int
description string
}
// parseMaterialImportPlan 阶段1:解析 + 逐行校验(只读不落库):图号必填且库内唯一 /
@@ -971,6 +992,7 @@ func parseMaterialImportPlan(ctx *svc.ServiceContext, rows [][]string) ([]materi
return fallback
}
codeCol := colOf([]string{"图号", "物料编码", "编码"}, 0)
materialCodeCol := colOf([]string{"物料编码"}, -1)
nameCol := colOf([]string{"名称", "物料名称"}, 1)
specCol := colOf([]string{"规格", "规格型号"}, 2)
unitCol := colOf([]string{"单位"}, 3)
@@ -990,6 +1012,7 @@ func parseMaterialImportPlan(ctx *svc.ServiceContext, rows [][]string) ([]materi
}
pr := materialImportPlan{row: i + 1}
pr.code = cell(codeCol)
pr.materialCode = cell(materialCodeCol)
pr.name = cell(nameCol)
pr.spec = cell(specCol)
pr.unit = cell(unitCol)