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
@@ -165,10 +165,19 @@ func DockListInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
if d.Side == "left" {
side = "左"
}
// 实时传感器状态(2026-11-18 定稿):WMS 托盘工作台选择接驳台时据此提示"传感器未检测到托盘"。
// PLC 离线时 sensorOk=false,前端回退看台账 hasPallet 并提示"PLC 离线无法核实"。
sensorHas, sensorOk := d.HasPallet, false
if svcCtx.PLC != nil && !svcCtx.PLC.IsMock() {
if has, e := svcCtx.PLC.Get().QueryDockPallet(r.Context(), d.DockCode); e == nil {
sensorHas, sensorOk = has, true
}
}
out = append(out, map[string]any{
"dockCode": d.DockCode, "name": d.Name, "dockType": d.DockType,
"stationNo": d.StationNo, "side": d.Side, "sideCn": side,
"hasPallet": d.HasPallet, "palletRef": d.PalletRef, "status": d.Status,
"sensorHasPallet": sensorHas, "sensorOk": sensorOk,
})
}
httpx.Ok(w, map[string]any{"list": out})
@@ -1,6 +1,7 @@
package production
import (
"fmt"
"net/http"
"strconv"
@@ -165,6 +166,18 @@ func ResolveAlertHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
}
}
// ResolveAllAlertsHandler POST /alerts/resolve-all 全部标记为已读(批量处置,记录处置人/时间)。
func ResolveAllAlertsHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
n, err := logic.New(svcCtx).ResolveAllAlerts(r.Context(), operator(r, ""))
if err != nil {
httpx.Fail(w, 3308, err.Error())
return
}
httpx.OkMessage(w, fmt.Sprintf("已将 %d 条告警标记为已读", n), map[string]any{"count": n})
}
}
// ListAlertRulesAliasHandler GET /alert-rules 规则列表(GET /alert/rules 的规范别名)
func ListAlertRulesAliasHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return ListAlertRulesHandler(svcCtx)
@@ -239,7 +239,7 @@ func syncAgvPointForDock(ctx context.Context, client *ent.Client, d *ent.Dock, n
SetEnabled(true).Save(ctx)
}
// SaveDockHandler POST /docks 新增或修改接驳台(id=0 为新增)。
// SaveDockHandler POST /docks 修改接驳台(2026-11-18 用户拍板:接驳台与现场实物一一对应,禁止新增)。
func SaveDockHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req dockEditReq
@@ -247,6 +247,10 @@ func SaveDockHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
httpx.BadRequest(w, "请求体解析失败")
return
}
if req.ID <= 0 {
httpx.Fail(w, 3117, "接驳台与现场实物一一对应,不允许新增;现场新增实物后由管理员在数据库登记")
return
}
code, stationNo, ok := validateDock(w, svcCtx, r, req)
if !ok {
return
@@ -257,25 +261,14 @@ func SaveDockHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
if status == "" {
status = "ENABLED"
}
var d *ent.Dock
if req.ID > 0 {
updated, err := svcCtx.EntClient.Dock.UpdateOneID(req.ID).
SetDockCode(code).SetName(name).SetDockType(typ).SetStationNo(stationNo).SetStatus(status).Save(r.Context())
if err != nil {
httpx.Fail(w, 3115, "修改接驳台失败:"+err.Error())
return
}
d = updated
} else {
created, err := svcCtx.EntClient.Dock.Create().
SetDockCode(code).SetName(name).SetDockType(typ).SetStationNo(stationNo).SetStatus(status).Save(r.Context())
if err != nil {
httpx.Fail(w, 3115, "新增接驳台失败:"+err.Error())
return
}
d = created
updated, err := svcCtx.EntClient.Dock.UpdateOneID(req.ID).
SetDockCode(code).SetName(name).SetDockType(typ).SetStationNo(stationNo).SetStatus(status).Save(r.Context())
if err != nil {
httpx.Fail(w, 3115, "修改接驳台失败:"+err.Error())
return
}
// 新增/修改接驳台 → 强制同步一条强绑定的 AGV 点位(硬件级一一对应闭环)
d := updated
// 修改接驳台 → 强制同步一条强绑定的 AGV 点位(硬件级一一对应闭环)
syncAgvPointForDock(r.Context(), svcCtx.EntClient, d, name)
httpx.Ok(w, dockRowOf(d))
}
@@ -1,42 +0,0 @@
package production
import (
"net/http"
"bj_power_mes/common/httpx"
"bj_power_mes/internal/logic"
"bj_power_mes/internal/svc"
)
// ListFlowMaterialsHandler GET /api/v1/process-flows/:id/materials —— 查某工艺的物料清单(flow_material)
func ListFlowMaterialsHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
flowId := pathID(r)
data, err := logic.New(svcCtx).ListFlowMaterials(r.Context(), flowId)
if err != nil {
httpx.Fail(w, 2113, err.Error())
return
}
httpx.Ok(w, data)
}
}
// SaveFlowMaterialsHandler POST /api/v1/process-flows/:id/materials —— 整表覆盖保存工艺物料清单
// body: {items: [{materialCode, materialName, spec, unit, snMode, unitQty, lossRate}]}
func SaveFlowMaterialsHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
flowId := pathID(r)
var req struct {
Items []logic.FlowMaterialReq `json:"items"`
}
if err := httpx.ParseJSON(r, &req); err != nil {
httpx.BadRequest(w, "请求体解析失败")
return
}
if err := logic.New(svcCtx).SaveFlowMaterials(r.Context(), flowId, req.Items, operator(r, "")); err != nil {
httpx.Fail(w, 2114, err.Error())
return
}
httpx.OkMessage(w, "工艺物料清单已保存", nil)
}
}
@@ -0,0 +1,32 @@
package production
import (
"encoding/json"
"net/http"
"bj_power_mes/common/httpx"
"bj_power_mes/internal/logic"
"bj_power_mes/internal/svc"
)
// CheckLineClearanceHandler POST /line/clearance-check
// 换绑前的产线五项台账检查(在制工件 / 余料 / 带工件托盘 / PLC 未完成任务 / AGV 在途):
// passed=true 表示全清;否则逐项给数量与处理办法,confirmed 为人工逐项确认放行的 key,
// 确认放行在 logic 层写 event_log 留痕。空托盘不算占位、不触发提示(2026-11-18 定稿)。
func CheckLineClearanceHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req struct {
Confirmed []string `json:"confirmed"`
}
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
httpx.BadRequest(w, "参数错误: "+err.Error())
return
}
res, err := logic.New(svcCtx).CheckLineClearance(r.Context(), req.Confirmed, r.Header.Get("X-Username"))
if err != nil {
httpx.Fail(w, 500, err.Error())
return
}
httpx.Ok(w, res)
}
}
@@ -1,89 +0,0 @@
package production
import (
"encoding/json"
"net/http"
"strings"
"bj_power_mes/common/httpx"
"bj_power_mes/internal/logic"
"bj_power_mes/internal/svc"
)
// ListMixTemplatesHandler GET /mix-templates 混产模板列表(圈定哪几个产品可混线生产,带 isActive)。
func ListMixTemplatesHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
rows, err := logic.New(svcCtx).ListMixTemplates(r.Context())
if err != nil {
httpx.Fail(w, 500, err.Error())
return
}
httpx.Ok(w, map[string]any{"list": rows})
}
}
// SaveMixTemplateHandler POST /mix-templates/save 新增/编辑混产模板(圈定哪几个产品可混线生产)。
func SaveMixTemplateHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req struct {
Id int `json:"id"`
Name string `json:"name"`
ProductCodes string `json:"productCodes"`
Remark string `json:"remark"`
Status string `json:"status"`
}
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
httpx.BadRequest(w, "参数错误: "+err.Error())
return
}
op := r.Header.Get("X-Username")
if err := logic.New(svcCtx).SaveMixTemplate(r.Context(), req.Id, req.Name, req.ProductCodes, req.Remark, req.Status, op); err != nil {
httpx.Fail(w, 400, err.Error())
return
}
httpx.Ok(w, map[string]any{"ok": true})
}
}
// SetActiveMixTemplateHandler POST /mix-templates/active 切换「当前产线在用的混产模板」。
// 排产/建工单按当前模板校验产品范围,同模板内混产切换才免清线。
func SetActiveMixTemplateHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req struct {
Name string `json:"name"`
}
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
httpx.BadRequest(w, "参数错误: "+err.Error())
return
}
if err := logic.New(svcCtx).SetActiveMixTemplate(r.Context(), req.Name, r.Header.Get("X-Username")); err != nil {
httpx.Fail(w, 400, err.Error())
return
}
httpx.Ok(w, map[string]any{"ok": true})
}
}
// CheckLineClearanceHandler POST /mix-templates/clearance-check
// 返回结构化「清线确认单」:needClearance=false 表示同模板混产免清线;
// 否则给出五项(在制品/余料/托盘/PLC 未完成任务/AGV 在途)实测数量与 passed 结论。
// confirmed 为人工逐项确认放行的 key;确认结果在 logic 层写 event_log 留痕。
func CheckLineClearanceHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req struct {
ProductCode string `json:"productCode"`
Confirmed []string `json:"confirmed"`
}
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
httpx.BadRequest(w, "参数错误: "+err.Error())
return
}
res, err := logic.New(svcCtx).CheckLineClearance(r.Context(),
strings.TrimSpace(req.ProductCode), req.Confirmed, r.Header.Get("X-Username"))
if err != nil {
httpx.Fail(w, 500, err.Error())
return
}
httpx.Ok(w, res)
}
}
@@ -136,36 +136,8 @@ func PlcPositionCorrectHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
}
}
// PlcEndPointOccupiedHandler GET /plc/monitor/end-points 列出末端下料检测位(G11/G12)占用记录(取件释放用)。
func PlcEndPointOccupiedHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
data, err := logic.New(svcCtx).ListEndPointOccupied(r.Context())
if err != nil {
httpx.Fail(w, 3310, err.Error())
return
}
httpx.Ok(w, map[string]any{"list": data})
}
}
// PlcReleaseEndPointHandler POST /plc/monitor/release-end-point 人工确认末端取件,释放 G11/G12 点位占用。
func PlcReleaseEndPointHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req logic.ReleaseEndPointReq
if err := httpx.ParseJSON(r, &req); err != nil {
httpx.BadRequest(w, "请求体解析失败")
return
}
if err := logic.New(svcCtx).ReleaseEndPoint(r.Context(), req, operator(r, "")); err != nil {
httpx.Fail(w, 3311, err.Error())
return
}
httpx.OkMessage(w, "已释放", nil)
}
}
// ScanFlowChainHandler POST /plc/flow-scan 手动全线流转扫描:
// 与报工后自动连锁(triggerFlowChain)同一套逻辑(送下一工序候选工位 / 缓存策略 / 层层拉入)。
// 与报工后自动连锁(triggerFlowChain)同一套逻辑(送下一工艺候选工位 / 缓存策略 / 层层拉入)。
func ScanFlowChainHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
res, err := logic.New(svcCtx).ScanFlowChain(r.Context(), operator(r, ""))
@@ -0,0 +1,44 @@
package production
import (
"net/http"
"strings"
"sync"
"time"
"bj_power_mes/common/httpx"
tokenx "bj_power_mes/common/token"
"bj_power_mes/internal/svc"
"bj_power_mes/internal/ws"
)
var (
plcMonitorHubOnce sync.Once
plcMonitorHub *ws.PlcMonitorHub
)
func globalPlcMonitorHub(svcCtx *svc.ServiceContext) *ws.PlcMonitorHub {
plcMonitorHubOnce.Do(func() {
plcMonitorHub = ws.NewPlcMonitorHub(svcCtx)
})
return plcMonitorHub
}
// PlcMonitorWsHandler GET /api/v1/plc/monitor/ws?token=<JWT> PLC 点位长连接推送。
// 浏览器 WebSocket 无法带 Authorization 头,token 走 query,校验复用 tokenx.Parse(签名+过期),
// 与 TodoWsHandler / AgvWsHandler 同模式。本接口只推只读点位快照,不含任何写 PLC 操作。
func PlcMonitorWsHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
tok := strings.TrimSpace(r.URL.Query().Get("token"))
if tok == "" {
httpx.Unauthorized(w, "缺少登录凭证,请重新登录")
return
}
claims, err := tokenx.Parse(svcCtx.Config.Auth.AccessSecret, tok)
if err != nil || claims == nil || claims.ExpiresAt == nil || time.Until(claims.ExpiresAt.Time) <= 0 {
httpx.Unauthorized(w, "登录凭证无效或已过期,请重新登录")
return
}
globalPlcMonitorHub(svcCtx).Handle(w, r)
}
}
@@ -12,7 +12,7 @@ import (
"github.com/xuri/excelize/v2"
)
// ---------- PLC 工序下发 ----------
// ---------- PLC 工艺下发 ----------
func PlcSendProcessHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
@@ -188,8 +188,8 @@ func TorqueDispositionHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
}
}
// ProcessStepsHandler 查询工位的工序步骤(参数采集模板),供巡检终端等按工位动态渲染。
// 按 stationNo 加载该工位启用工艺流程的工序步骤。
// ProcessStepsHandler 查询工位的工艺步骤(参数采集模板),供巡检终端等按工位动态渲染。
// 按 stationNo 加载该工位启用工艺流程的工艺步骤。
func ProcessStepsHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
stationNo := atoiDefault(r.URL.Query().Get("stationNo"), 0)
@@ -13,7 +13,7 @@ import (
// ============ 产品 BOM 总账 / 分账(2026-11-13 拍板「总分制」) ============
// 总账挂在产品下、分账挂在产品工艺下;P10:物料清单与工艺配置分离、各自独立保存。
// 硬校验:Σ分账 = 总账、分账物料是总账子集、分账工序在工艺路线内;改总账会回校已有分账。
// 硬校验:Σ分账 = 总账、分账物料是总账子集、分账工艺在工艺路线内;改总账会回校已有分账。
// ListProductBOMHandler GET /product-boms?productCode= 读取某产品的总账。
func ListProductBOMHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
@@ -225,7 +225,7 @@ func OrderQueryInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
orderNo := r.URL.Query().Get("orderNo")
keyword := r.URL.Query().Get("keyword")
status := r.URL.Query().Get("status")
// firstStation(2026-11-16 上线建档下拉专用):>0 时只返回第1道工序候选工位含该工位的工单
// firstStation(2026-11-16 上线建档下拉专用):>0 时只返回第1道工艺候选工位含该工位的工单
firstStation := 0
if n, e := strconv.Atoi(r.URL.Query().Get("stationNo")); e == nil && n > 0 {
firstStation = n
@@ -266,11 +266,11 @@ func OrderQueryInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
// ---------- 工位终端内部接口(上下线面板 / 在制品展示) ----------
// InProcessInternalHandler 在制品列表(工位终端「在制品默认展示」/上下线面板)。
// GET ?stationNo=(>0=停在该工位)/ ?scope=(pending=待流转 / end-pending=末端待取件)/ ?orderNo=(模糊),返回 {list}。
// GET ?stationNo=(>0=停在该工位)/ ?scope=(pending=待流转)/ ?status=SEMI_STORED(半成品)/ ?orderNo=(模糊),返回 {list}。
func InProcessInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
stationNo := atoiDefault(r.URL.Query().Get("stationNo"), 0)
data, err := logic.New(svcCtx).WorkpiecesInProcess(r.Context(), stationNo, r.URL.Query().Get("orderNo"), r.URL.Query().Get("scope"))
data, err := logic.New(svcCtx).WorkpiecesInProcess(r.Context(), stationNo, r.URL.Query().Get("orderNo"), r.URL.Query().Get("scope"), r.URL.Query().Get("status"))
if err != nil {
httpx.Fail(w, 2006, err.Error())
return
@@ -301,24 +301,6 @@ func OnlineWorkpieceInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc
}
}
// DoneWorkpieceInternalHandler 工件完工入库(工位终端下线面板提交)。
// POST DoneReq{sn,batchItems,serialItems};完工内部自动回流 WMS 成品库存。
func DoneWorkpieceInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req logic.DoneReq
if err := httpx.ParseJSON(r, &req); err != nil {
httpx.BadRequest(w, "请求体解析失败")
return
}
LogImpersonation(svcCtx, r, r.URL.Query().Get("operator"), "/api/internal/workpiece/done")
if err := logic.New(svcCtx).DoneWorkpiece(r.Context(), req, StationOp(r, r.URL.Query().Get("operator"))); err != nil {
httpx.Fail(w, 2008, err.Error())
return
}
httpx.OkMessage(w, "完工成功", nil)
}
}
// WorkpieceLookupInternalHandler GET /api/internal/workpiece/lookup?sn=
// 2026-11-16 拍板:建工单时已按数量预生成全部 SN(workpiece.status=NEW,带 order_no/work_order_id),
// 工位终端上线建档只需扫 SN 即可秒认工单,不再让工人手选工单。查不到 SN 明确提示,不静默放行。
@@ -44,7 +44,7 @@ func SignPendingHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
}
}
// AuditorSignHandler 审核人复核签字(工序级审核 gate,工艺配置 needAudit 决定)。
// AuditorSignHandler 审核人复核签字(工艺级审核 gate,工艺配置 needAudit 决定)。
func AuditorSignHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req logic.AuditorSignReq
@@ -535,12 +535,12 @@ func SuggestedDockCodesHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
}
// InProcessHandler GET /workpieces/in-process 跨天在制品视图(停在各工位未完工工件)
// stationNo 可选:>0=停在该工位;scope 可选:pending=待流转 / end-pending=末端待取件;皆不传返回全部。
// stationNo 可选:>0=停在该工位;scope 可选:pending=待流转;status 可选:SEMI_STORED=半成品视图;皆不传返回全部在制。
// orderNo 可选:按工单号模糊过滤(客户第12条「记录查看加一项看工单号查询」)。
func InProcessHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
stationNo, _ := strconv.Atoi(r.URL.Query().Get("stationNo"))
data, err := logic.New(svcCtx).WorkpiecesInProcess(r.Context(), stationNo, r.URL.Query().Get("orderNo"), r.URL.Query().Get("scope"))
data, err := logic.New(svcCtx).WorkpiecesInProcess(r.Context(), stationNo, r.URL.Query().Get("orderNo"), r.URL.Query().Get("scope"), r.URL.Query().Get("status"))
if err != nil {
httpx.Fail(w, 3001, err.Error())
return
@@ -32,18 +32,20 @@ func OnlineWorkpieceHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
}
}
func DoneWorkpieceHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
// ForceCompleteWorkpieceHandler POST /workpieces/force-complete 半成品强行完工(2026-11-18 定稿):
// 异常件唯一出路=先「暂存退库」半成品入库,再在「在制品追踪」页半成品处强行完工(管理员显式动作,留痕)。
func ForceCompleteWorkpieceHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req logic.DoneReq
var req logic.ForceCompleteReq
if err := httpx.ParseJSON(r, &req); err != nil {
httpx.BadRequest(w, "请求体解析失败")
return
}
if err := logic.New(svcCtx).DoneWorkpiece(r.Context(), req, operator(r, "")); err != nil {
if err := logic.New(svcCtx).ForceCompleteWorkpiece(r.Context(), req, operator(r, "")); err != nil {
httpx.Fail(w, 3303, err.Error())
return
}
httpx.OkMessage(w, "完工成功", nil)
httpx.OkMessage(w, "已强行完工", nil)
}
}