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
+44
View File
@@ -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()
+24 -15
View File
@@ -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
}
+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)
@@ -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"},
+36 -2
View File
@@ -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,
+27 -1
View File
@@ -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))
}
+15 -3
View File
@@ -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),
})
}
}
+37 -1
View File
@@ -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(),
+34
View File
@@ -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)
}
}