Files
bj_power/bj_power_workstation/internal/handler/workpiece.go
T
SunYF 1e92b2a596 feat: 核心业务实体扩充(混产模板/产品BOM/试制记录)、WMS 库存检验增强与前端通用能力
- MES 新增实体:混产模板、产品BOM、产品工艺物料、试制记录(schema + ent 生成码 + logic/handler/前端页)
- WMS 实体增强:检验记录、库存、半成品重构;新增序列号库存与短缺代报
- AGV 与产能:AGV 手动点位与链路、物料守卫、短缺预测、原因字典
- 前端通用能力:新增下一步引导组件 NextStepBar,统一帮助文档/布局/请求拦截与操作列
- 工位终端:界面与各 handler 调整(api/store/绑定/PLC/拧紧/上报等)
- 配置与文档:更新 mes-api.yaml、WMS README 及案例/产线API/问题记录/项目说明/流程说明
2026-11-15 12:17:39 +08:00

222 lines
8.3 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package handler
import (
"encoding/json"
"errors"
"io"
"net/http"
"net/url"
"strings"
"bj_power_workstation/internal/mes"
"bj_power_workstation/internal/svc"
"github.com/zeromicro/go-zero/core/logx"
)
// passJSON 原样透传 MES 的 {code,message,data} 响应体(不再二次包装)。
func passJSON(w http.ResponseWriter, body []byte) {
w.Header().Set("Content-Type", "application/json; charset=utf-8")
w.WriteHeader(http.StatusOK)
_, _ = w.Write(body)
}
// wipHandler GET /api/wip?stationNo=(>0=停在该工位)/ ?scope=(pending=待流转 / end-pending=末端待取件)
// —— 代理 MES /api/internal/workpieces/in-process。
// 在制品默认展示(5.2):停在本工位的未完工工件列表;上下线面板按 scope 拉待流转/末端待取件。
func wipHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
params := url.Values{}
if sn := strings.TrimSpace(r.URL.Query().Get("stationNo")); sn != "" {
params.Set("stationNo", sn)
}
if sc := strings.TrimSpace(r.URL.Query().Get("scope")); sc != "" {
params.Set("scope", sc)
}
body, _, err := ctx.Mes.Get("/api/internal/workpieces/in-process", params)
if err != nil {
failMes(w, err, "MES 服务不可达:"+errString(err))
return
}
passJSON(w, body)
}
}
// bomHandler GET /api/bom?productCode=&bomName= —— 代理 MES /api/internal/bom。
// 上线建档「领料确认」按物料清单展示应领料。
func bomHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
params := url.Values{}
if v := strings.TrimSpace(r.URL.Query().Get("productCode")); v != "" {
params.Set("productCode", v)
}
if v := strings.TrimSpace(r.URL.Query().Get("bomName")); v != "" {
params.Set("bomName", v)
}
body, _, err := ctx.Mes.Get("/api/internal/bom", params)
if err != nil {
failMes(w, err, "MES 服务不可达:"+errString(err))
return
}
passJSON(w, body)
}
}
// 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{}
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 {
failMes(w, err, "MES 服务不可达:"+errString(err))
return
}
passJSON(w, body)
}
}
// traceHandler GET /api/trace?sn= —— 代理 MES /api/internal/workpiece/trace。
// 下线完工面板扫 SN 后展示工件状态/工序时间线/拧紧等追溯信息。
func traceHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
sn := strings.TrimSpace(r.URL.Query().Get("sn"))
if sn == "" {
fail(w, http.StatusBadRequest, "缺少 sn 参数")
return
}
body, _, err := ctx.Mes.Get("/api/internal/workpiece/trace", url.Values{"sn": {sn}})
if err != nil {
failMes(w, err, "MES 服务不可达:"+errString(err))
return
}
passJSON(w, body)
}
}
// onlineHandler POST /api/workpiece/online —— 上线建档(StationNo=0)。
// {sn, orderNo, workOrderId, processSeq, operator};MES 不可达时写离线队列(kind=online_register)稍后重传。
func onlineHandler(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"`
OrderNo string `json:"orderNo"`
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/online?"+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(req.OrderNo, opName, "online_register_rejected",
"上线建档被MES拒绝 sn="+req.Sn+":"+msg)
logx.Errorf("上线建档被 MES 拒绝: %s", msg)
fail(w, http.StatusConflict, msg)
return
}
// 网络失败:直接报错(2026-11-05 拍板:断网即失败,无离线队列/自动重试,工人重做即可)
ctx.Store.AddEventLog(req.OrderNo, opName, "online_register_failed", "上线建档失败(MES不可达) sn="+req.Sn)
logx.Errorf("上线建档失败(MES不可达): %v", err)
failMes(w, err, "MES 服务不可达,建档未成功,请检查网络后重试")
return
}
if msg := mesRespCode(respBody); msg != "" {
ctx.Store.AddEventLog(req.OrderNo, opName, "online_register_rejected",
"上线建档被MES拒绝 sn="+req.Sn+":"+msg)
fail(w, http.StatusConflict, msg)
return
}
ctx.Store.AddEventLog(req.OrderNo, opName, "online_register", "上线建档 sn="+req.Sn)
// 透传 MES 响应(data 即 PLC↔MES 对账 mismatch 对象,无对账时为 null),
// 供前端建档成功后按需弹「两项」提示。
passJSON(w, respBody)
}
}
// 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})
}
}