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:
@@ -87,6 +87,50 @@ func sendExcel(w http.ResponseWriter, filename string, headers []string, rows []
|
||||
_, _ = w.Write(buf.Bytes())
|
||||
}
|
||||
|
||||
// sendExcelWithGuide 生成带「填写说明」页的导入模板(2026-11-10:与 MES 模板对齐,含示例行+字段说明)。
|
||||
// 数据页仍用 buildXlsx,额外追加一个说明 sheet;导入端只读第一个 sheet,说明页不影响解析。
|
||||
func sendExcelWithGuide(w http.ResponseWriter, filename string, headers []string, rows [][]any, guides []string) {
|
||||
buf, err := buildXlsx(headers, rows)
|
||||
if err != nil {
|
||||
fail(w, http.StatusInternalServerError, "生成 Excel 失败: "+err.Error())
|
||||
return
|
||||
}
|
||||
f, err := excelize.OpenReader(bytes.NewReader(buf.Bytes()))
|
||||
if err != nil {
|
||||
fail(w, http.StatusInternalServerError, "生成 Excel 说明页失败: "+err.Error())
|
||||
return
|
||||
}
|
||||
defer f.Close()
|
||||
if _, err = f.NewSheet("填写说明"); err != nil {
|
||||
fail(w, http.StatusInternalServerError, "生成 Excel 说明页失败: "+err.Error())
|
||||
return
|
||||
}
|
||||
for i, g := range guides {
|
||||
cell, _ := excelize.CoordinatesToCellName(1, i+1)
|
||||
_ = f.SetCellValue("填写说明", cell, g)
|
||||
}
|
||||
_ = f.SetColWidth("填写说明", "A", "A", 110)
|
||||
out, err := f.WriteToBuffer()
|
||||
if err != nil {
|
||||
fail(w, http.StatusInternalServerError, "生成 Excel 失败: "+err.Error())
|
||||
return
|
||||
}
|
||||
asciiName := "export.xlsx"
|
||||
encName := ""
|
||||
if utf8.ValidString(filename) {
|
||||
encName = "filename*=UTF-8''" + url.QueryEscape(filename)
|
||||
}
|
||||
w.Header().Set("Content-Type", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
|
||||
cd := fmt.Sprintf("attachment; filename=\"%s\"", asciiName)
|
||||
if encName != "" {
|
||||
cd += "; " + encName
|
||||
}
|
||||
w.Header().Set("Content-Disposition", cd)
|
||||
w.Header().Set("X-Excel-Filename", url.QueryEscape(filename))
|
||||
w.WriteHeader(http.StatusOK)
|
||||
_, _ = w.Write(out.Bytes())
|
||||
}
|
||||
|
||||
// buildXlsx 生成 xlsx 字节流(含表头样式、列宽自适应)
|
||||
func buildXlsx(headers []string, rows [][]any) (*bytes.Buffer, error) {
|
||||
f := excelize.NewFile()
|
||||
|
||||
@@ -303,11 +303,18 @@ func internalDisplayCallsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
if ctx.Mes != nil {
|
||||
if list, err := ctx.Mes.ListMaterialRequests(r.Context(), ""); err == nil {
|
||||
mesOk = true
|
||||
keep := map[string]string{
|
||||
"PENDING": "待备料",
|
||||
"SHIPPED": "配送中",
|
||||
"DONE": "已送达",
|
||||
keep := map[string]string{
|
||||
"PENDING": "待备料",
|
||||
"SHIPPED": "配送中",
|
||||
"DONE": "已送达",
|
||||
}
|
||||
// 大屏分区:待备料/配送中归入「待出库」,已送达归入「已送达」。
|
||||
callGroup := func(st string) string {
|
||||
if st == "PENDING" || st == "SHIPPED" {
|
||||
return "pending"
|
||||
}
|
||||
return "done"
|
||||
}
|
||||
// 2026-11-05 叫料包拍板:同一叫料包(package_no)在大屏聚合为一行——
|
||||
// 名称=首物料+“等N种”,数量=包内请求量合计;状态取包内最落后进度
|
||||
//(PENDING > SHIPPED > DONE);无包号(存量单)逐单展示,兼容不变。
|
||||
@@ -337,13 +344,14 @@ func internalDisplayCallsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
if mat == "" {
|
||||
mat = m.MaterialCode
|
||||
}
|
||||
if m.PackageNo == "" {
|
||||
calls = append(calls, map[string]any{
|
||||
"time": t, "stationNo": m.StationNo, "material": mat,
|
||||
"qty": m.ReqQty, "status": label, "statusKey": m.Status,
|
||||
})
|
||||
continue
|
||||
}
|
||||
if m.PackageNo == "" {
|
||||
calls = append(calls, map[string]any{
|
||||
"time": t, "stationNo": m.StationNo, "material": mat,
|
||||
"qty": m.ReqQty, "status": label, "statusKey": m.Status,
|
||||
"group": callGroup(m.Status),
|
||||
})
|
||||
continue
|
||||
}
|
||||
pg := pkgs[m.PackageNo]
|
||||
if pg == nil {
|
||||
pg = &pkgAgg{time: t, stationNo: m.StationNo, material: mat, rank: 0}
|
||||
@@ -364,10 +372,11 @@ func internalDisplayCallsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
mat = fmt.Sprintf("%s 等%d种", mat, pg.kinds)
|
||||
}
|
||||
sk := statusKeys[pg.rank]
|
||||
calls = append(calls, map[string]any{
|
||||
"time": pg.time, "stationNo": pg.stationNo, "material": mat,
|
||||
"qty": pg.qty, "status": keep[sk], "statusKey": sk,
|
||||
})
|
||||
calls = append(calls, map[string]any{
|
||||
"time": pg.time, "stationNo": pg.stationNo, "material": mat,
|
||||
"qty": pg.qty, "status": keep[sk], "statusKey": sk,
|
||||
"group": callGroup(sk),
|
||||
})
|
||||
if len(calls) >= 30 {
|
||||
break
|
||||
}
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -34,6 +34,9 @@ var seedPermissions = []seedPerm{
|
||||
{"call:view", "叫料队列", "MENU", "/call-queue", "Bell", 35, ""},
|
||||
// P1(2026-11-04 用户拍板):备料清单——只读展示"今天及以后×工单×工位×物料×数量",数据源 MES 日排产实时算
|
||||
{"preparation:view", "备料清单", "MENU", "/preparation", "Tickets", 36, ""},
|
||||
// 菜单 code 不得共用:配送单/托盘工作台从 call:view、return:view 拆出独立权限(问题18)
|
||||
{"delivery:view", "配送单", "MENU", "/delivery", "Bell", 37, ""},
|
||||
{"pallet:view", "托盘工作台", "MENU", "/pallet-workbench", "Box", 38, ""},
|
||||
{"inventory:view", "库存查询", "MENU", "/inventory", "Search", 40, ""},
|
||||
{"inspection:view", "来料检验", "MENU", "/inspection-incoming", "CircleCheck", 50, ""},
|
||||
{"stocktake:view", "库存盘点", "MENU", "/stocktake", "List", 60, ""},
|
||||
@@ -51,6 +54,9 @@ var seedPermissions = []seedPerm{
|
||||
{"sys.settings:view", "基础设置", "MENU", "/settings", "Setting", 150, ""},
|
||||
// 同步失败台账(2026-11-08):跨系统通知失败人工重试,菜单码同时作为后端 requirePerm 校验码
|
||||
{"sync:retry", "同步失败台账", "MENU", "/sync-failure", "Refresh", 152, ""},
|
||||
// 预警中心/预警规则原先无独立 code,补登独立 MENU 权限(问题18)
|
||||
{"alert.center:view", "预警中心", "MENU", "/alert-center", "Bell", 154, ""},
|
||||
{"alert.rule:view", "预警规则", "MENU", "/alert-rule", "Bell", 156, ""},
|
||||
{"sys.settings:edit", "保存基础设置", "BUTTON", "", "", 290, "sys.settings:view"},
|
||||
// ===== 按钮权限 =====
|
||||
{"inbound:create", "批量入库", "BUTTON", "", "", 200, "inbound:view"},
|
||||
|
||||
@@ -4,6 +4,7 @@ import (
|
||||
"errors"
|
||||
"fmt"
|
||||
"net/http"
|
||||
"strings"
|
||||
|
||||
"bj_power_wms/internal/verr"
|
||||
|
||||
@@ -21,12 +22,45 @@ func ok(w http.ResponseWriter, data any) {
|
||||
httpx.WriteJson(w, http.StatusOK, Response{Code: 0, Message: "ok", Data: data})
|
||||
}
|
||||
|
||||
// friendlyMessage 把数据库唯一约束冲突(SQLSTATE 23505)等技术错误转成业务语言提示,
|
||||
// 覆盖所有错误出口(fail / failCode / FailErr / FailValidation),避免把
|
||||
// "重复键违反唯一约束xxx (SQLSTATE 23505)" 原样弹给业务人员。
|
||||
func friendlyMessage(raw string) string {
|
||||
if raw == "" {
|
||||
return raw
|
||||
}
|
||||
lower := strings.ToLower(raw)
|
||||
isDup := strings.Contains(lower, "23505") ||
|
||||
strings.Contains(lower, "duplicate key") ||
|
||||
strings.Contains(lower, "violates unique constraint") ||
|
||||
strings.Contains(lower, "重复键")
|
||||
if !isDup {
|
||||
return raw
|
||||
}
|
||||
switch {
|
||||
case strings.Contains(lower, "sys_config"):
|
||||
return "该配置项已存在,请勿重复添加(同名模板/配置只能保存一次)"
|
||||
case strings.Contains(lower, "outbound_order") || strings.Contains(lower, "delivery"):
|
||||
return "该单据号已存在,请勿重复提交"
|
||||
case strings.Contains(lower, "material") || strings.Contains(lower, "_code"):
|
||||
return "该物料已存在,请勿重复添加(图号/编码不能重复)"
|
||||
case strings.Contains(lower, "inbound") || strings.Contains(lower, "_sn"):
|
||||
return "该产品序号(SN)已存在,请勿重复添加"
|
||||
case strings.Contains(lower, "return_order"):
|
||||
return "该退料单号已存在,请勿重复提交"
|
||||
case strings.Contains(lower, "user") || strings.Contains(lower, "username"):
|
||||
return "该账号已存在,请勿重复添加"
|
||||
default:
|
||||
return "该记录已存在,请勿重复添加(同名或同编号的记录只能保存一次)"
|
||||
}
|
||||
}
|
||||
|
||||
func fail(w http.ResponseWriter, httpStatus int, message string) {
|
||||
httpx.WriteJson(w, httpStatus, Response{Code: -1, Message: message})
|
||||
httpx.WriteJson(w, httpStatus, Response{Code: -1, Message: friendlyMessage(message)})
|
||||
}
|
||||
|
||||
func failCode(w http.ResponseWriter, httpStatus, code int, message string) {
|
||||
httpx.WriteJson(w, httpStatus, Response{Code: code, Message: message})
|
||||
httpx.WriteJson(w, httpStatus, Response{Code: code, Message: friendlyMessage(message)})
|
||||
}
|
||||
|
||||
// FailValidation 收集式校验失败(2026-10-20 报错规范):HTTP 200,code=3015,
|
||||
|
||||
@@ -4,6 +4,7 @@ import (
|
||||
"net/http"
|
||||
|
||||
"bj_power_wms/internal/svc"
|
||||
"bj_power_wms/internal/ws"
|
||||
|
||||
"github.com/zeromicro/go-zero/rest"
|
||||
)
|
||||
@@ -23,7 +24,19 @@ func RegisterHandlers(server *rest.Server, ctx *svc.ServiceContext) {
|
||||
},
|
||||
)
|
||||
|
||||
server.Use(authInterceptor(ctx))
|
||||
// WebSocket 握手浏览器无法携带 Authorization 头,故 /api/todos/ws 跳过全局 JWT 中间件,
|
||||
// 改由 todoWebSocketHandler 内部用 query 中的 token 复用 ParseToken 校验(问题8)。
|
||||
jwtGuard := authInterceptor(ctx)
|
||||
server.Use(func(next http.HandlerFunc) http.HandlerFunc {
|
||||
guarded := jwtGuard(next)
|
||||
return func(w http.ResponseWriter, r *http.Request) {
|
||||
if r.URL.Path == "/api/todos/ws" {
|
||||
next.ServeHTTP(w, r)
|
||||
return
|
||||
}
|
||||
guarded(w, r)
|
||||
}
|
||||
})
|
||||
|
||||
// 当前登录用户(JWT 鉴权)
|
||||
server.AddRoutes(
|
||||
@@ -386,4 +399,17 @@ func RegisterHandlers(server *rest.Server, ctx *svc.ServiceContext) {
|
||||
{Method: http.MethodGet, Path: "/api/internal/delivery/status", Handler: wrapInternal(ctx)(deliveryStatusInternalHandler(ctx))},
|
||||
},
|
||||
)
|
||||
|
||||
// 待办统计 + WebSocket 推送(问题8):菜单角标实时刷新 + 本机语音播报触发源
|
||||
todoHub := ws.NewTodoHub(ctx)
|
||||
todoHub.Start()
|
||||
server.AddRoutes(
|
||||
[]rest.Route{
|
||||
{Method: http.MethodGet, Path: "/api/todos/stats", Handler: todoStatsHandler(todoHub)},
|
||||
},
|
||||
)
|
||||
// WebSocket 长连接单独注册并放大超时,避免被全局超时掐断
|
||||
server.AddRoute(rest.Route{
|
||||
Method: http.MethodGet, Path: "/api/todos/ws", Handler: todoWebSocketHandler(ctx, todoHub),
|
||||
}, rest.WithTimeout(3600_000_000_000))
|
||||
}
|
||||
|
||||
@@ -25,6 +25,8 @@ const (
|
||||
CfgDisplayAgeBuckets = "display.age.buckets" // 库龄分档阈值(天,逗号分隔 3 档,升序)
|
||||
// MES 对接(2026-11-02:页面可配,保存即生效;空=回退 yaml 配置)
|
||||
CfgMesBaseURL = "mes.base.url" // MES 服务地址(如 http://127.0.0.1:8888)
|
||||
// 新待办语音播报(问题8):0=关闭 1=开启;每台电脑各自读取、各自播报
|
||||
CfgVoiceNotify = "wms.voice.notify"
|
||||
)
|
||||
|
||||
var wmsSettingsDefaults = map[string]string{
|
||||
@@ -39,6 +41,7 @@ var wmsSettingsDefaults = map[string]string{
|
||||
CfgDisplayStockRefresh: "5",
|
||||
CfgDisplayCallsRefresh: "10",
|
||||
CfgDisplayAgeBuckets: "30,90,180",
|
||||
CfgVoiceNotify: "0",
|
||||
}
|
||||
|
||||
// SettingsVO WMS 基础设置视图(保存即生效)。
|
||||
@@ -54,6 +57,7 @@ type SettingsVO struct {
|
||||
DisplayCallsRefresh int `json:"displayCallsRefresh"` // 备料叫料池刷新间隔(秒)
|
||||
DisplayAgeBuckets string `json:"displayAgeBuckets"` // 库龄分档阈值(天,逗号分隔 3 档)
|
||||
MesBaseURL string `json:"mesBaseURL"` // MES 服务地址(空=用配置文件默认)
|
||||
VoiceNotify int `json:"voiceNotify"` // 新待办语音播报 0=关闭 / 1=开启
|
||||
}
|
||||
|
||||
func cfgStr(kv map[string]string, key, def string) string {
|
||||
@@ -104,6 +108,7 @@ func SettingsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
DisplayCallsRefresh: cfgInt(kv, CfgDisplayCallsRefresh, 10),
|
||||
DisplayAgeBuckets: cfgStr(kv, CfgDisplayAgeBuckets, wmsSettingsDefaults[CfgDisplayAgeBuckets]),
|
||||
MesBaseURL: strings.TrimRight(cfgStr(kv, CfgMesBaseURL, ""), "/"),
|
||||
VoiceNotify: cfgInt(kv, CfgVoiceNotify, 0),
|
||||
}
|
||||
ok(w, vo)
|
||||
}
|
||||
@@ -164,6 +169,10 @@ func SaveSettingsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
return
|
||||
}
|
||||
}
|
||||
if req.VoiceNotify != 0 && req.VoiceNotify != 1 {
|
||||
fail(w, http.StatusBadRequest, "新待办语音播报开关仅支持 0(关闭)/ 1(开启)")
|
||||
return
|
||||
}
|
||||
kv := map[string]string{
|
||||
CfgArchiveRemindDays: strconv.Itoa(req.ArchiveRemindDays),
|
||||
CfgArchiveBackupPath: strings.TrimSpace(req.ArchiveBackupPath),
|
||||
@@ -175,8 +184,9 @@ func SaveSettingsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
CfgDisplayStockRefresh: strconv.Itoa(req.DisplayStockRefresh),
|
||||
CfgDisplayCallsRefresh: strconv.Itoa(req.DisplayCallsRefresh),
|
||||
CfgDisplayAgeBuckets: strconv.Itoa(buckets[0]) + "," + strconv.Itoa(buckets[1]) + "," + strconv.Itoa(buckets[2]),
|
||||
CfgMesBaseURL: mesURL,
|
||||
}
|
||||
CfgMesBaseURL: mesURL,
|
||||
CfgVoiceNotify: strconv.Itoa(req.VoiceNotify),
|
||||
}
|
||||
for k, v := range kv {
|
||||
if err := upsertConfig(ctx, k, v, ""); err != nil {
|
||||
fail(w, http.StatusInternalServerError, err.Error())
|
||||
@@ -224,6 +234,7 @@ type DisplayConfigVO struct {
|
||||
RefreshSeconds int `json:"refreshSeconds"` // 概览刷新间隔(秒)
|
||||
CallsRefreshSeconds int `json:"callsRefreshSeconds"` // 备料叫料池刷新间隔(秒)
|
||||
AgeBuckets []int `json:"ageBuckets"` // 库龄分档阈值(天,3 档升序)
|
||||
VoiceNotify int `json:"voiceNotify"` // 新待办语音播报 0=关闭 / 1=开启(免登录供前端读取)
|
||||
}
|
||||
|
||||
// displayConfigHandler GET /api/display/config 大屏运行配置(免登录,与 overview 同组)。
|
||||
@@ -236,7 +247,8 @@ func displayConfigHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
RefreshSeconds: cfgInt(kv, CfgDisplayStockRefresh, 5),
|
||||
CallsRefreshSeconds: cfgInt(kv, CfgDisplayCallsRefresh, 10),
|
||||
AgeBuckets: AgeBucketsFromConfig(ctx),
|
||||
})
|
||||
VoiceNotify: cfgInt(kv, CfgVoiceNotify, 0),
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -1,9 +1,12 @@
|
||||
package handler
|
||||
|
||||
import (
|
||||
"fmt"
|
||||
"net"
|
||||
"net/http"
|
||||
"os"
|
||||
"runtime"
|
||||
"strings"
|
||||
"time"
|
||||
|
||||
"bj_power_wms/internal/svc"
|
||||
@@ -12,17 +15,50 @@ import (
|
||||
// processStartTime 进程启动时刻(包加载即服务启动,用于计算运行时长)。
|
||||
var processStartTime = time.Now()
|
||||
|
||||
// localIPv4s 枚举本机非环回 IPv4(内网 IP 展示)。
|
||||
// 与 MES internal/logic/settings.go:378-397 同口径:首项为主机名,其后为各网卡 IPv4。
|
||||
// 每次请求现场读取,不做启动快照/缓存——换网卡或改 IP 后刷新页面即可看到新值,无需重启服务。
|
||||
func localIPv4s() []string {
|
||||
hostname, _ := os.Hostname()
|
||||
out := []string{}
|
||||
if hostname != "" {
|
||||
out = append(out, hostname)
|
||||
}
|
||||
addrs, err := net.InterfaceAddrs()
|
||||
if err != nil {
|
||||
return out
|
||||
}
|
||||
for _, a := range addrs {
|
||||
ipnet, ok := a.(*net.IPNet)
|
||||
if !ok || ipnet.IP.IsLoopback() || ipnet.IP.To4() == nil {
|
||||
continue
|
||||
}
|
||||
out = append(out, ipnet.IP.String())
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
// SystemInfoHandler GET /api/system/info 只读本机信息面板数据。
|
||||
// 含 OS / 主机名 / Go 版本 / 监听端口 / 启动时间 / MES 地址(当前生效值:sys_config 覆盖优先)。
|
||||
// 含 OS / 主机名 + 内网 IP / Go 版本 / 监听地址 / 数据库 / 启动时间 / MES 地址(当前生效值:sys_config 覆盖优先)。
|
||||
// 2026-11-10:对齐 MES 基础设置「本机基础信息」,补 localIPs / listenAddr / dbInfo 三项。
|
||||
func SystemInfoHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
|
||||
return func(w http.ResponseWriter, r *http.Request) {
|
||||
host, _ := os.Hostname()
|
||||
c := svcCtx.Config
|
||||
// 数据库信息只暴露 host:port/db,绝不带密码(与 MES settings.go:164 同口径)。
|
||||
dbInfo := fmt.Sprintf("%s:%d/%s", c.Postgres.Host, c.Postgres.Port, c.Postgres.DBName)
|
||||
listenAddr := fmt.Sprintf("%s:%d", c.Host, c.Port)
|
||||
if strings.TrimSpace(c.Host) == "" || c.Host == "0.0.0.0" {
|
||||
listenAddr = fmt.Sprintf("0.0.0.0:%d(本机所有网卡,可用下面的内网 IP 访问)", c.Port)
|
||||
}
|
||||
ok(w, map[string]any{
|
||||
"os": runtime.GOOS,
|
||||
"hostname": host,
|
||||
"localIPs": localIPv4s(),
|
||||
"goVersion": runtime.Version(),
|
||||
"port": c.Port,
|
||||
"listenAddr": listenAddr,
|
||||
"dbInfo": dbInfo,
|
||||
"startTime": processStartTime.Unix(),
|
||||
"uptimeSeconds": int64(time.Since(processStartTime).Seconds()),
|
||||
"mesAddress": svcCtx.Mes.BaseURL(),
|
||||
|
||||
@@ -0,0 +1,34 @@
|
||||
package handler
|
||||
|
||||
import (
|
||||
"net/http"
|
||||
"strings"
|
||||
|
||||
"bj_power_wms/internal/svc"
|
||||
"bj_power_wms/internal/ws"
|
||||
)
|
||||
|
||||
// todoStatsHandler GET /api/todos/stats 拉取 6 类待办全量(前端初始化角标用)
|
||||
func todoStatsHandler(hub *ws.Hub) http.HandlerFunc {
|
||||
return func(w http.ResponseWriter, r *http.Request) {
|
||||
ok(w, hub.Snapshot())
|
||||
}
|
||||
}
|
||||
|
||||
// todoWebSocketHandler GET /api/todos/ws?token=<JWT> 待办变化推送长连接。
|
||||
// 浏览器 WebSocket 握手无法携带 Authorization 头,故从 query 取 token,
|
||||
// 复用 WMS 现有 ParseToken 校验(非空 + 有效),不通过则 401。
|
||||
func todoWebSocketHandler(ctx *svc.ServiceContext, hub *ws.Hub) http.HandlerFunc {
|
||||
return func(w http.ResponseWriter, r *http.Request) {
|
||||
token := strings.TrimSpace(r.URL.Query().Get("token"))
|
||||
if token == "" {
|
||||
failCode(w, http.StatusUnauthorized, 401, "缺少登录凭证")
|
||||
return
|
||||
}
|
||||
if _, err := ParseToken(ctx, token); err != nil {
|
||||
failCode(w, http.StatusUnauthorized, 401, "登录已失效,请重新登录")
|
||||
return
|
||||
}
|
||||
hub.Serve(w, r)
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user