feat: 移除工艺物料与混产模板实体、新增产线清线与 PLC 监控实时推送、看板双屏增强

- 移除实体:MES 删除 FlowMaterial(工艺物料)与 MixProductionTemplate(混产模板)全套(schema/ent 生成码/handler/logic),清理关联路由与种子
- 新增功能:产线清线(line_clearance handler + logic)、PLC 监控 WebSocket 实时推送(ws/plc_monitor_hub + handler)
- 看板增强:新增管理屏与 KPI 组件(BoardManage/BoardKpi),调整演示屏 Mock 与各看板面板
- MES 完善:PLC 匹配/扭矩扫描/签收、工艺卡 PDF 与工单、AGV 链路、叫料/备料/在制品/短料预测等逻辑与前端调整
- 工位终端:删除离线面板 OfflinePanel,调整主界面/物料面板与 api/store/handler/路由
- WMS:AGV 托盘、物料与 MES 客户端调整及前端帮助/基础数据/叫料/托盘页
- 文档:更新产线API/客户问题/案例/部署手册/问题记录
This commit is contained in:
SunYF
2026-11-19 08:31:05 +08:00
parent f8482b18f6
commit 4c4cda1d41
148 changed files with 2511 additions and 9735 deletions
@@ -154,7 +154,7 @@ func pdfOpenHandler(ctx *svc.ServiceContext) http.HandlerFunc {
// pdfViewHandler GET /pdfview?name=<encoded>(免鉴权,注册在鉴权中间件之前的路由组)。
// 以 query 传文件名,天然支持 MES 落盘的「日期子目录/文件名」(如 2026-09-16/xxx.pdf),
// 供工艺流程 PDF 与工序步骤图纸附件(Item J)统一使用。
// 供工艺流程 PDF 与工艺步骤图纸附件(Item J)统一使用。
func pdfViewHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
forwardFile(w, ctx.Mes, ctx.PdfCache, strings.TrimSpace(r.URL.Query().Get("name")))
@@ -125,14 +125,14 @@ func processDoneHandler(ctx *svc.ServiceContext) http.HandlerFunc {
// 拒绝痕:记「被拒」而非「完成上报」,避免事件日志误导(成功才记完成痕)
ctx.Store.AddEventLog(req.OrderNo, op, "process_done_rejected",
"报工被MES拒绝 sn="+req.Sn+" stationNo="+itoa(req.StationNo)+":"+msg)
logx.Errorf("工序完成上报被 MES 拒绝(不入队): %s", msg)
logx.Errorf("工艺完成上报被 MES 拒绝(不入队): %s", msg)
fail(w, http.StatusConflict, msg)
return
}
// 网络失败:直接报错(2026-11-05 拍板:断网即失败,无离线队列/自动重试,工人重做即可)
ctx.Store.AddEventLog(req.OrderNo, op, "process_done_failed",
"报工失败(MES不可达) sn="+req.Sn+" stationNo="+itoa(req.StationNo))
logx.Errorf("工序完成上报失败(MES不可达): %v", err)
logx.Errorf("工艺完成上报失败(MES不可达): %v", err)
failMes(w, err, "MES 服务不可达,报工未成功,请检查网络后重试")
return
}
@@ -140,7 +140,7 @@ func processDoneHandler(ctx *svc.ServiceContext) http.HandlerFunc {
if msg := mesRespCode(respBody); msg != "" {
ctx.Store.AddEventLog(req.OrderNo, op, "process_done_rejected",
"报工被MES拒绝 sn="+req.Sn+" stationNo="+itoa(req.StationNo)+":"+msg)
logx.Errorf("工序完成上报被 MES 拒绝: %s", msg)
logx.Errorf("工艺完成上报被 MES 拒绝: %s", msg)
fail(w, http.StatusConflict, msg)
return
}
@@ -92,14 +92,13 @@ func RegisterHandlers(server *rest.Server, ctx *svc.ServiceContext) {
{Method: http.MethodPost, Path: "/api/off-duty", Handler: offDutyHandler(ctx)},
{Method: http.MethodPost, Path: "/api/inspection/upload", Handler: inspectionUploadHandler(ctx)},
// 在制品 / 0-13 上下线建档完工 / 物料清单领料 / 追溯(代理 MES 内部 API)
// 在制品 / 上下线建档 / 物料清单领料 / 追溯(代理 MES 内部 API)
{Method: http.MethodGet, Path: "/api/wip", Handler: wipHandler(ctx)},
{Method: http.MethodGet, Path: "/api/bom", Handler: bomHandler(ctx)},
{Method: http.MethodGet, Path: "/api/order/query", Handler: orderQueryHandler(ctx)},
{Method: http.MethodGet, Path: "/api/order/by-sn", Handler: snOrderLookupHandler(ctx)},
{Method: http.MethodGet, Path: "/api/trace", Handler: traceHandler(ctx)},
{Method: http.MethodPost, Path: "/api/workpiece/online", Handler: onlineHandler(ctx)},
{Method: http.MethodPost, Path: "/api/workpiece/done", Handler: doneHandler(ctx)},
// 本工位相关报警(谁受影响谁播报,2026-10-20):终端前端轮询 + 语音播报
{Method: http.MethodGet, Path: "/api/alerts/station", Handler: stationAlertsHandler(ctx)},
@@ -21,9 +21,9 @@ func passJSON(w http.ResponseWriter, body []byte) {
_, _ = w.Write(body)
}
// wipHandler GET /api/wip?stationNo=(>0=停在该工位)/ ?scope=(pending=待流转 / end-pending=末端待取件)
// wipHandler GET /api/wip?stationNo=(>0=停在该工位)/ ?scope=pending(待流转)/ ?status=SEMI_STORED(半成品)
// —— 代理 MES /api/internal/workpieces/in-process。
// 在制品默认展示(5.2):停在本工位的未完工工件列表;上下线面板按 scope 拉待流转/末端待取件。
// 在制品默认展示(5.2):停在本工位的未完工工件列表。
func wipHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
params := url.Values{}
@@ -33,6 +33,9 @@ func wipHandler(ctx *svc.ServiceContext) http.HandlerFunc {
if sc := strings.TrimSpace(r.URL.Query().Get("scope")); sc != "" {
params.Set("scope", sc)
}
if st := strings.TrimSpace(r.URL.Query().Get("status")); st != "" {
params.Set("status", st)
}
body, _, err := ctx.Mes.Get("/api/internal/workpieces/in-process", params)
if err != nil {
failMes(w, err, "MES 服务不可达:"+errString(err))
@@ -65,7 +68,7 @@ func bomHandler(ctx *svc.ServiceContext) http.HandlerFunc {
// orderQueryHandler GET /api/order/query?orderNo=&keyword=&status=&limit=&stationNo= —— 代理 MES /api/internal/order/query。
// 上线建档选工单后带出产品编码/名称(用于查物料清单应领料)。
// 2026-11-10:透传远程搜索关键字与条数上限,工单下拉不再一次拉全量。
// 2026-11-16:透传 stationNo(MES 侧按「第1道工序候选工位含本工位」过滤,与建档落点资格校验同口径)。
// 2026-11-16:透传 stationNo(MES 侧按「第1道工艺候选工位含本工位」过滤,与建档落点资格校验同口径)。
func orderQueryHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
params := url.Values{}
@@ -116,7 +119,7 @@ func snOrderLookupHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
// traceHandler GET /api/trace?sn= —— 代理 MES /api/internal/workpiece/trace。
// 下线完工面板扫 SN 后展示工件状态/工序时间线/拧紧等追溯信息。
// 下线完工面板扫 SN 后展示工件状态/工艺时间线/拧紧等追溯信息。
func traceHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
sn := strings.TrimSpace(r.URL.Query().Get("sn"))
@@ -195,60 +198,3 @@ func onlineHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
}
// doneHandler POST /api/workpiece/done —— 下线完工入库(StationNo=13)。
// {sn, batchItems, serialItems, operator};完工内部自动回流 WMS 成品库存;
// MES 不可达时写离线队列(kind=offline_finish)稍后重传。
func doneHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
payload, err := io.ReadAll(r.Body)
if err != nil {
fail(w, http.StatusBadRequest, "请求体读取失败")
return
}
var req struct {
Sn string `json:"sn"`
Operator string `json:"operator"`
}
_ = json.Unmarshal(payload, &req)
if strings.TrimSpace(req.Sn) == "" {
fail(w, http.StatusBadRequest, "缺少 sn")
return
}
// 操作人取当前请求 Bearer 对应登录会话的可信身份(防冒名 · 多会话版),仅用于本地操作日志落痕
opName := req.Operator
if ss, sErr := ctx.Store.GetStationSessionByToken(bearerOf(r)); sErr == nil && ss != nil && ss.Name != "" {
opName = ss.Name
}
q := url.Values{}
if req.Operator != "" {
q.Set("operator", req.Operator)
}
respBody, _, err := ctx.Mes.Post("/api/internal/workpiece/done?"+q.Encode(), json.RawMessage(payload), bearerOf(r))
if err != nil {
// MES 业务拒绝(HTTP200+code≠0):数据不合法,直接失败回前端
var bizErr *mes.BizError
if errors.As(err, &bizErr) {
msg := mesRespCode(bizErr.Body)
if msg == "" {
msg = bizErr.Error()
}
ctx.Store.AddEventLog("", opName, "offline_finish_rejected", "下线完工被MES拒绝 sn="+req.Sn+":"+msg)
logx.Errorf("下线完工被 MES 拒绝: %s", msg)
fail(w, http.StatusConflict, msg)
return
}
// 网络失败:直接报错(2026-11-05 拍板:断网即失败,无离线队列/自动重试,工人重做即可)
ctx.Store.AddEventLog("", opName, "offline_finish_failed", "下线完工失败(MES不可达) sn="+req.Sn)
logx.Errorf("下线完工失败(MES不可达): %v", err)
failMes(w, err, "MES 服务不可达,完工未成功,请检查网络后重试")
return
}
if msg := mesRespCode(respBody); msg != "" {
ctx.Store.AddEventLog("", opName, "offline_finish_rejected", "下线完工被MES拒绝 sn="+req.Sn+":"+msg)
fail(w, http.StatusConflict, msg)
return
}
ctx.Store.AddEventLog("", opName, "offline_finish", "下线完工入库 sn="+req.Sn)
ok(w, map[string]any{"ok": true})
}
}