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
+18
View File
@@ -29,6 +29,14 @@ type TokenInfo struct {
const issuer = "bj_power_workstation"
// SessionValidator 由 main 注入:校验请求 token 是否仍是当前有效登录会话
// (与 station_session.token 比对,实现「后登录踢前一个」)。nil 时跳过该校验。
var SessionValidator func(token string) bool
// SessionTokenSync 由 main 注入:滑动续签重签出新 token 时同步写回当前登录会话,
// 保证前端 token 与会话 token 始终一致,避免续签后被误判为旧会话。
var SessionTokenSync func(token string)
func defaultExpire(expire int64) int64 {
if expire <= 0 {
return 1800
@@ -84,6 +92,10 @@ func renewIfNearExpiry(secret string, expire int64, w http.ResponseWriter, claim
Role: claims.Role,
}); err == nil {
w.Header().Set("X-Renewed-Token", newToken)
// 前端会据此更新本地 token,同步写回会话,保证两者始终一致。
if SessionTokenSync != nil {
SessionTokenSync(newToken)
}
}
}
}
@@ -125,6 +137,12 @@ func Interceptor(secret string, accessExpire int64) func(next http.HandlerFunc)
unauthorized(w, "登录已失效")
return
}
// 在线态校验(后登录踢前一个):请求 token 必须与当前登录会话一致。
// 白名单与静态资源已在上方放行,不会被此处拦截。
if SessionValidator != nil && !SessionValidator(tokenStr) {
unauthorized(w, "已在其他设备登录,请重新登录")
return
}
renewIfNearExpiry(secret, accessExpire, w, claims)
r.Header.Set("X-Username", claims.Username)
next.ServeHTTP(w, r)
+10 -5
View File
@@ -84,6 +84,14 @@ func loginHandler(ctx *svc.ServiceContext) http.HandlerFunc {
} `json:"data"`
}
if err := json.Unmarshal(body, &loginResp); err == nil && loginResp.Data.AccessToken != "" {
// 后登录踢前一个:若已存在不同 token 的旧会话,先通知 MES 记录旧会话登出(尽力而为),
// 随后用新会话覆盖本地单行登录态;旧端下一次请求因 token 与会话不一致被 401 踢下线。
if old, oerr := ctx.Store.GetStationSession(); oerr == nil && old != nil &&
old.Token != "" && old.Token != loginResp.Data.AccessToken {
go func(u string, n int) {
_, _, _ = ctx.Mes.Post("/api/internal/station/logout", map[string]any{"username": u, "stationNo": n})
}(old.Username, old.StationNo)
}
// 解析 MES JWT 取出用户 ID,随登录态保存:离线数据落库 operator_id(按操作人隔离发送)
userID := int64(0)
if claims, perr := auth.ParseToken(ctx.Config.Auth.AccessSecret, loginResp.Data.AccessToken); perr == nil {
@@ -171,11 +179,8 @@ func refreshTokenHandler(ctx *svc.ServiceContext) http.HandlerFunc {
} `json:"data"`
}
if err := json.Unmarshal(respBody, &rr); err == nil && rr.Data.AccessToken != "" {
userID := ss.UserID
if claims, perr := auth.ParseToken(ctx.Config.Auth.AccessSecret, rr.Data.AccessToken); perr == nil {
userID = claims.UserID
}
_ = ctx.Store.SaveStationSession(rr.Data.AccessToken, ss.Username, ss.Name, ss.StationNo, rr.Data.ExpireAt, userID)
// 只更新转发 MES 用的 Bearer;本地会话 token 保持与前端一致,
// 由滑动续签的 X-Renewed-Token + SessionTokenSync 同步,避免前后端 token 不一致被误判为旧会话。
ctx.Mes.SetStationToken(rr.Data.AccessToken)
ok(w, map[string]any{"accessToken": rr.Data.AccessToken, "expireAt": rr.Data.ExpireAt})
return
@@ -2,6 +2,7 @@ package handler
import (
"net/http"
"strings"
"github.com/zeromicro/go-zero/rest/httpx"
)
@@ -17,6 +18,36 @@ func ok(w http.ResponseWriter, data any) {
httpx.WriteJson(w, http.StatusOK, Response{Code: 0, Message: "ok", Data: data})
}
// friendlyMessage 把数据库唯一约束冲突(SQLSTATE 23505)等技术错误转成业务语言提示。
// 2026-11-10 改动10:任何出口都不再向操作员暴露 SQLSTATE / 重复键 / duplicate key 等字样。
func friendlyMessage(raw string) string {
s := strings.TrimSpace(raw)
if s == "" {
return s
}
lower := strings.ToLower(s)
isDup := strings.Contains(lower, "23505") ||
strings.Contains(lower, "duplicate key") ||
strings.Contains(lower, "violates unique constraint") ||
strings.Contains(s, "重复键") ||
strings.Contains(s, "唯一约束")
if !isDup {
return s
}
switch {
case strings.Contains(lower, "workstation") || strings.Contains(s, "登录态"):
return "该工位登录状态已存在,请勿重复登记"
case strings.Contains(lower, "workpiece") || strings.Contains(s, "工件"):
return "该工件已建档,请勿重复上线(如确为同一工件请在提示里选择「绑定已知」)"
case strings.Contains(lower, "material_request") || strings.Contains(s, "叫料"):
return "该叫料记录已存在,请勿重复提交"
case strings.Contains(lower, "torque") || strings.Contains(s, "拧紧"):
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)})
}
@@ -62,13 +62,16 @@ func bomHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
}
// orderQueryHandler GET /api/order/query?orderNo= —— 代理 MES /api/internal/order/query。
// orderQueryHandler GET /api/order/query?orderNo=&keyword=&status=&limit= —— 代理 MES /api/internal/order/query。
// 上线建档选工单后带出产品编码/名称(用于查物料清单应领料)。
// 2026-11-10:透传远程搜索关键字与条数上限,工单下拉不再一次拉全量。
func orderQueryHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
params := url.Values{}
if v := strings.TrimSpace(r.URL.Query().Get("orderNo")); v != "" {
params.Set("orderNo", v)
for _, k := range []string{"orderNo", "keyword", "status", "limit"} {
if v := strings.TrimSpace(r.URL.Query().Get(k)); v != "" {
params.Set(k, v)
}
}
body, _, err := ctx.Mes.Get("/api/internal/order/query", params)
if err != nil {
@@ -210,6 +210,13 @@ func (s *Store) GetStationSession() (*StationSession, error) {
return &ss, nil
}
// UpdateSessionToken 仅更新当前登录会话的 token(滑动续签重签后同步),
// 不动用户名/工位/过期时间等其它字段。
func (s *Store) UpdateSessionToken(token string) error {
_, err := s.db.Exec(`UPDATE station_session SET token=? WHERE id=1`, token)
return err
}
// ClearStationSession 清除登录态(退出登录时调用)。
func (s *Store) ClearStationSession() error {
_, err := s.db.Exec(`DELETE FROM station_session WHERE id=1`)
@@ -0,0 +1,58 @@
// Package tray 提供工位终端的系统托盘:中文标题/提示、「打开页面」与「退出」菜单。
// systray.Run 必须运行在主 goroutine,调用方需先 runtime.LockOSThread()(Windows 消息循环要求)。
package tray
import (
_ "embed"
"os/exec"
"runtime"
"github.com/getlantern/systray"
)
//go:embed tray_icon.ico
var iconData []byte
// Run 运行系统托盘,阻塞至用户点击「退出」。
// title/tooltip 为中文界面文案;url 为「打开页面」用浏览器打开的本地页面地址。
// onQuit 在点「退出」后调用,由调用方停止服务并结束进程。
func Run(title, tooltip, url string, onQuit func()) {
systray.Run(func() {
if len(iconData) > 0 {
systray.SetIcon(iconData)
}
systray.SetTitle(title)
systray.SetTooltip(tooltip)
mOpen := systray.AddMenuItem("打开页面", "用浏览器打开本系统页面")
systray.AddSeparator()
mQuit := systray.AddMenuItem("退出", "退出本系统")
go func() {
for {
select {
case <-mOpen.ClickedCh:
openBrowser(url)
case <-mQuit.ClickedCh:
systray.Quit()
if onQuit != nil {
onQuit()
}
return
}
}
}()
}, func() {})
}
// openBrowser 用系统默认浏览器打开 url。
func openBrowser(url string) {
var cmd *exec.Cmd
switch runtime.GOOS {
case "windows":
cmd = exec.Command("rundll32", "url.dll,FileProtocolHandler", url)
case "darwin":
cmd = exec.Command("open", url)
default:
cmd = exec.Command("xdg-open", url)
}
_ = cmd.Start()
}
Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 KiB