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:
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user