feat: 同步失败台账双向可重试 + 拧紧枪按工位配置 + 虚拟工位体系 + 去Redis与文档口径对齐

- 同步失败台账:MES/WMS 双端新增台账与页面,跨系统通知失败落台账、人工重试或标记已处理,不自动重传;重试前先判对端终态;叫料、配送、出库回写失败提示指向台账;补幂等建表脚本与菜单权限。
- 拧紧枪:新增按工位配置页,展示控制器地址与三把枪通道号(仅供查看,不参与采集校验);「允许手填」由全局开关改为每工位开关,关闭时校验该工位已配控制器;终端启动/登录上报配置并按本工位拉取,扭矩手填框按本工位置灰;补全局值迁移到各工位的脚本。
- 工位体系:终端未配置工位号时登录页可选(含虚拟工位),固定工位模式保留;虚拟/线下位不叫料、不退料、不作转产目标,未采集绑定放行并说明原因;叫料期望接驳台改为选填。
- AGV与出库:补「出库单已送达」回写;空车回充、接驳台传感器失联、配送状态更新失败均落预警或留痕并提示人工核对;人工出库不引入送达状态;出库单支持目标工位/接驳台并扩展导出列。
- 基础设施:看板缓存由Redis改为MES进程内实现,文档与启动脚本同步去Redis;扫码监听支持多地址、端口被占自动降级;PLC对账与工位报警在MES不可达时降级放行并留日志。
- 文档与帮助:案例与部署手册按实测订正(工位绑定、菜单名称、补料由班组长代提、菜单覆盖对照、虚拟工位);迁移脚本改为本地即时执行并登记7个已执行脚本;三端页面帮助改为「业务/操作/影响范围/后果」四要素。
- 测试:新增独立Go模块,按三个业务场景做真实HTTP与真实写库的流水测试,含运行报告。
This commit is contained in:
SunYF
2026-11-09 18:58:47 +08:00
parent 5e2640c13a
commit af554cea75
149 changed files with 35119 additions and 296 deletions
+27 -3
View File
@@ -46,6 +46,11 @@ func loginHandler(ctx *svc.ServiceContext) http.HandlerFunc {
fail(w, http.StatusBadRequest, "用户名和密码必填")
return
}
// 2026-11-09 拍板:配置固定工位(>0)时忽略前端传值、强制用配置工位(防串位);
// 未配置(<=0)时接受前端选择的工位(实体+虚拟 0/13 都可选,MES 端对 <=0 免工位权限校验)。
if ctx.Config.Station.StationNo > 0 {
req.StationNo = ctx.Config.Station.StationNo
}
body, _, err := ctx.Mes.Post("/api/internal/station/login", map[string]any{
"username": strings.TrimSpace(req.Username),
@@ -87,6 +92,16 @@ func loginHandler(ctx *svc.ServiceContext) http.HandlerFunc {
_ = ctx.Store.SaveStationSession(loginResp.Data.AccessToken, loginResp.Data.User.Username,
loginResp.Data.User.Name, loginResp.Data.StationNo, loginResp.Data.ExpireAt, userID)
ctx.Mes.SetStationToken(loginResp.Data.AccessToken)
// 拧紧枪配置快照补报(2026-11-09):仅 MES 展示记录,不参与数据收集;
// 启动时若 MES 未就绪,登录这一刻补上,失败只记日志不影响登录。
go func(no int) {
if no <= 0 {
no = ctx.Config.Station.StationNo
}
if err := ctx.Mes.ReportTighteningConfig(ctx.Config.Tightening, no); err != nil {
logx.Infof("拧紧枪配置上报 MES 失败(仅展示记录,不影响登录): %v", err)
}
}(loginResp.Data.StationNo)
}
w.Header().Set("Content-Type", "application/json; charset=utf-8")
w.WriteHeader(http.StatusOK)
@@ -169,13 +184,22 @@ func refreshTokenHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
}
// configHandler GET /api/config 返回工位配置:固定工位号 stationNo、固定接驳台 dock
// (均由 yaml 配置在启动时加载,终端不可修改)。
// configHandler GET /api/config 返回工位配置(yaml 加载,终端不可修改):
// stationNo>0=固定工位(登录页不允许选择);<=0=未配置(登录页可选工位,实体+虚拟都可选)。
// 2026-11-09 拍板:固定接驳台 dock 配置已删除(叫料期望接驳台工人当次可选,留空=配送时库房定)。
func configHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
ok(w, map[string]any{
"stationNo": ctx.Config.Station.StationNo,
"dock": ctx.Config.Station.Dock,
})
}
}
// stationOptionsHandler GET /api/station-options(免鉴权,登录前调用):
// 代理 MES 启用工位列表(实体 LINE + 虚拟 OFFLINE 0/13),供未配置工位的终端登录页选择。
func stationOptionsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
body, _, err := ctx.Mes.Get("/api/internal/station/options", nil)
mesJSON(w, body, err)
}
}
+4 -16
View File
@@ -60,7 +60,8 @@ func lineOccupyHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
// ============ B5 叫料(代理 MES 内部 API,2026-10-13 定稿) ============
// 接驳台:每行可选(本工位 左L/右R 两个接驳台),未选时用 yaml Station.Dock 配置兜底(本工位固定接驳台)。
// 接驳台(2026-11-09 拍板):期望接驳台由工人当次可选(可空),终端不再有固定接驳台配置;
// 留空=配送时库房定实际接驳台。
// callPoolHandler GET /api/call/pool 叫料池(本工位物料行四数:需求/调整/已发/占用/可用)
func callPoolHandler(ctx *svc.ServiceContext) http.HandlerFunc {
@@ -75,7 +76,8 @@ func callPoolHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
// callCreateHandler POST /api/call/create 发起叫料(按物料行拆 N 张单,占用池子可用量)
// 请求体:{stationNo, items:[{materialCode, qty, dock?}]};每行缺省接驳台用 yaml Station.Dock 兜底。
// 请求体:{stationNo, items:[{materialCode, qty, dock?}]};dock=期望接驳台(可空,不兜底——
// 2026-11-09 拍板:删除终端固定接驳台配置,留空=配送时库房定实际接驳台)。
func callCreateHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
payload, err := io.ReadAll(r.Body)
@@ -88,20 +90,6 @@ func callCreateHandler(ctx *svc.ServiceContext) http.HandlerFunc {
fail(w, http.StatusBadRequest, "请求体解析失败")
return
}
// 2026-11-05 拍板:接驳台降级为「期望接驳台」(可空)——未选时用 yaml Station.Dock 兜底预填,
// 配置也为空则留空(配送时 WMS 确定实际接驳台),不再硬性要求。
dock := strings.TrimSpace(ctx.Config.Station.Dock)
if items, ok := req["items"].([]any); ok {
for _, it := range items {
m, ok := it.(map[string]any)
if !ok {
continue
}
if d, _ := m["dock"].(string); strings.TrimSpace(d) == "" && dock != "" {
m["dock"] = dock // 兜底:期望接驳台取本工位配置
}
}
}
if req["operator"] == nil || req["operator"] == "" {
if u := currentUsername(r); u != "" {
req["operator"] = u
@@ -22,8 +22,10 @@ func plcMismatchCheckHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
respBody, _, err := ctx.Mes.Post("/api/internal/plc/mismatch/check", json.RawMessage(payload))
if err != nil {
// MES 不可达:静默跳过,提示不拦,不影响终端作业
// 查询类静默降级(2026-11-08):仍不拦作业,但必须落本地操作日志留痕
logx.Errorf("PLC↔MES 对账检查 MES 不可达,静默跳过: %v", err)
ctx.Store.AddEventLog("", "system", "plc_mismatch_unreachable",
"PLC↔MES 对账检查 MES 不可达,已降级放行: "+err.Error())
ok(w, map[string]any{"hasMismatch": false})
return
}
@@ -6,6 +6,7 @@ import (
"fmt"
"net/http"
"net/url"
"strconv"
"bj_power_workstation/internal/mes"
"bj_power_workstation/internal/svc"
@@ -279,11 +280,17 @@ func scrapHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
}
// mesConfigHandler GET /api/mes-config 代理 MES 公开配置快照(拧紧手填开关 / 缓存策略 / AGV 超时等),
// 供工位终端前端按配置显隐或约束交互(2026-11-03 拍板:拧紧禁止手填时输入框置灰,只能由枪自动采集)。
// mesConfigHandler GET /api/mes-config 代理 MES 公开配置快照(本工位允许手填 / 缓存策略 / AGV 超时等)。
// 2026-11-09 改:带本机工位号拉 MES「拧紧枪配置」页里该工位的允许手填开关,不再用全局 torque.manual.input。
// 工位号来源:登录会话优先(登录页可选工位),否则取 yaml 固定工位号。
func mesConfigHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
b, _, err := ctx.Mes.Get("/api/internal/public-config", nil)
stationNo := ctx.Config.Station.StationNo
if ss, sErr := ctx.Store.GetStationSession(); sErr == nil && ss != nil && ss.StationNo > 0 {
stationNo = ss.StationNo
}
q := url.Values{"stationNo": {strconv.Itoa(stationNo)}}
b, _, err := ctx.Mes.Get("/api/internal/public-config", q)
if err != nil {
fail(w, http.StatusBadGateway, "MES 不可达,配置获取失败")
return
@@ -16,6 +16,8 @@ func RegisterHandlers(server *rest.Server, ctx *svc.ServiceContext) {
{Method: http.MethodGet, Path: "/api/health", Handler: healthHandler(ctx)},
{Method: http.MethodPost, Path: "/api/auth/login", Handler: loginHandler(ctx)},
{Method: http.MethodGet, Path: "/api/config", Handler: configHandler(ctx)},
// 工位选项(免鉴权,登录前调用):未配置工位的终端登录页选择工位用(2026-11-09 拍板)
{Method: http.MethodGet, Path: "/api/station-options", Handler: stationOptionsHandler(ctx)},
// 工艺文件免鉴权直链(query 传名,支持日期子目录;供 iframe/window.open)
{Method: http.MethodGet, Path: "/pdfview", Handler: pdfViewHandler(ctx)},
// 本机工位报警 SSE(免鉴权:EventSource 无法携带 JWT;数据已按本机工位过滤,LAN 内低敏感)
@@ -27,8 +27,10 @@ func stationAlertsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
"minutes": {strconv.Itoa(minutes)},
})
if err != nil {
// MES 不可达:静默返回空,终端语音播报不因后端抖动而报错刷屏
// 查询类静默降级(2026-11-08):仍返回空不刷屏,但必须落本地操作日志留痕,不再无声吞掉
logx.Errorf("工位报警查询 MES 不可达,静默跳过: %v", err)
ctx.Store.AddEventLog("", "system", "station_alerts_unreachable",
"工位报警查询 MES 不可达,已降级返回空列表: "+err.Error())
ok(w, []any{})
return
}
@@ -189,9 +189,16 @@ func offDutyHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
}
// stationNoFromRequest 固定工位号(与 /api/config 同源:workstation 配置)。
// stationNoFromRequest 业务工位号(2026-11-09 拍板):配置固定工位(>0)直接用配置;
// 未配置(<=0,登录页选择)时回退登录会话保存的实际工位号(登录响应 stationNo 落 SQLite session)。
func stationNoFromRequest(ctx *svc.ServiceContext) int {
return ctx.Config.Station.StationNo
if ctx.Config.Station.StationNo > 0 {
return ctx.Config.Station.StationNo
}
if ss, err := ctx.Store.GetStationSession(); err == nil && ss != nil {
return ss.StationNo
}
return 0
}
// inspectionUploadHandler POST /api/inspection/upload(巡检拍照 base64 上传,代理 MES 内部接口)
@@ -61,14 +61,16 @@ func tighteningRecordHandler(ctx *svc.ServiceContext) http.HandlerFunc {
if ss != nil && ss.Name != "" {
op = ss.Name
}
// 拧紧域工位标签载体:DOCK%02d 由本机固定工位号生成(与接驳台 dock 表编码无关),
// 拧紧域工位标签载体:DOCK%02d 由业务工位号生成(与接驳台 dock 表编码无关),
// MES 侧按 stationNo(数字工位号)落库并做应拧/实拧分组统计。
dockCode := fmt.Sprintf("DOCK%02d", ctx.Config.Station.StationNo)
// 2026-11-09:选择模式(配置<=0)用登录会话工位(stationNoFromRequest 统一口径)。
bizStationNo := stationNoFromRequest(ctx)
dockCode := fmt.Sprintf("DOCK%02d", bizStationNo)
body := map[string]any{
"workOrderNo": req.WorkOrderNo,
"sn": req.Sn,
"dockCode": dockCode,
"stationNo": strconv.Itoa(ctx.Config.Station.StationNo),
"stationNo": strconv.Itoa(bizStationNo),
"screwNo": req.ScrewNo,
"stepId": req.StepId,
"stepName": req.StepName,