Files
bj_power/bj_power_workstation/internal/handler/line.go
T
SunYF 1d1dc1bdd8 按模块说明
一、MES — 叫料单扩展(schema + 逻辑)​

material_request 新增字段:packageNo(叫料包号,一次提交=一包)、callDate(叫料日,默认当天)、planBreakdown(jsonb,工单×排产日明细 []CallPlanBreakdown);targetDock 语义降级为"期望接驳台(可空,配送时 WMS 确定实际台)"。
新增 internal/logic/call_plan.go:实时计算「叫料需求明细(工单×排产日×物料)」,派生两类提示(当日剩余未叫 / 跨日量明细),不落库、不拦提交;接驳台空台校验 EnsureStationDocksEmpty、托盘回库 DispatchPalletReturnManual、人工清台 ClearDockLedger、配送单派车 DispatchDeliveryAgv、工位物料明细 StationMaterialDetail。
新增 internal/handler/production/call_pkg.go:8 个 MES 内部端点(X-API-TOKEN 网关),供 WMS 调用——叫料需求明细、按包查单、接驳台状态、托盘回库、人工清台、配送单派车、叫料池原始行、工位物料明细、WMS 代叫料。
internal/handler/production/call.go、internal/logic/call.go、agv.go、qty_report.go、routes_production.go、wmsclient/client.go、db.go 同步接入上述逻辑。
二、WMS — 配送单(新功能,叫料与送料彻底拆开)​

新增 schema/delivery_order.go + delivery_order_item.go 及 ent 生成代码:delivery_order(PENDING→DISPATCHED→DONE / CANCELLED,一单=一次托盘配送)、delivery_order_item(配送物料明细快照:工单/工艺/排产日)。
新增 internal/handler/delivery.go + 路由 + DeliveryOrders.vue 页面(仓储作业 → 配送单)。
mesclient/client.go 扩展:MES 叫料单结构补 packageNo/callDate/workOrderNo/planBreakdown,新增 PoolRow/DockPalletState/DeliveryAgvItem/getJSON 等。
CallQueue.vue:按叫料包展示,新增「代叫料」「建配送单」按钮与对话框;出库单回写所属配送单号(outbound_order 加字段);AGV 派送改由配送单驱动。
三、工位终端 — 叫料体验升级

MaterialPanel.vue:新增「本工位物料明细」卡(工艺物料全集×工位账四数,量为 0 也显示);叫料改为「叫料包」模式(默认当天、可勾选分批、可选其他排产日、期望接驳台可空),新增叫料日选择器、两条提示横幅(当日剩余未叫 / 跨日量明细)、托盘回库按钮。
InspectPanel.vue/Main.vue/OnlinePanel.vue/OfflinePanel.vue/WorkPanel.vue/SyncQueueDialog.vue/api/index.js/internal/handler/line.go/routes.go 同步接入接驳台状态、托盘回库、下班双台空台校验等。
web/static/index.html 构建刷新。
四、文档

案例.md:重写第 5/6/8/9 节与新「配送单」流程,补「模拟模式跳过接驳台校验」说明,库管员菜单加「配送单」;并修正"本单箱体"等措辞歧义。
客户问题.md:同步本轮拍板口径。
五、构建产物 / 同步

多个 MES 前端页面(.vue)随本次改动统一重新构建刷新;ent 生成代码(MES material_request、WMS delivery_order/outbound_order 相关)随 schema 更新重新生成。
2026-11-05 19:18:18 +08:00

250 lines
9.2 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"
"io"
"net/http"
"net/url"
"strings"
"bj_power_workstation/internal/svc"
)
// ============ 产线点位 / 叫料(代理 MES 内部 API) ============
// MES 侧对应接口均以 X-API-TOKEN 保护(/api/internal/line/*),本服务用配置 token 转发,
// 前端只与本服务交互(JWT 登录)。MES 响应体原样透传({code,message,data})。
// mesJSON 透传 MES 响应体;网络不可达时返回 502 中文提示。
func mesJSON(w http.ResponseWriter, body []byte, err error) bool {
if err != nil {
fail(w, http.StatusBadGateway, "MES 服务不可达:"+errString(err))
return false
}
w.Header().Set("Content-Type", "application/json; charset=utf-8")
w.WriteHeader(http.StatusOK)
_, _ = w.Write(body)
return true
}
// linePointsHandler GET /api/line/points(产线点位台账:当前每个点位上的工件)
func linePointsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
body, _, err := ctx.Mes.Get("/api/internal/line/points", nil)
mesJSON(w, body, err)
}
}
// lineOccupyHandler POST /api/line/occupy(点位人工记账:IN 上料 / OUT 下料)
// 请求体:{pointNo, sn, orderNo, action} —— operator 由本服务补当前登录人。
func lineOccupyHandler(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 map[string]any
if err := json.Unmarshal(payload, &req); err != nil {
fail(w, http.StatusBadRequest, "请求体解析失败")
return
}
if req["operator"] == nil || req["operator"] == "" {
if u := currentUsername(r); u != "" {
req["operator"] = u
}
}
body, _ := json.Marshal(req)
resp, _, err := ctx.Mes.Post("/api/internal/line/occupy", json.RawMessage(body))
mesJSON(w, resp, err)
}
}
// ============ B5 叫料(代理 MES 内部 API,2026-10-13 定稿) ============
// 接驳台:每行可选(本工位 左L/右R 两个接驳台),未选时用 yaml Station.Dock 配置兜底(本工位固定接驳台)。
// callPoolHandler GET /api/call/pool 叫料池(本工位物料行四数:需求/调整/已发/占用/可用)
func callPoolHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
q := url.Values{}
if v := strings.TrimSpace(r.URL.Query().Get("stationNo")); v != "" {
q.Set("stationNo", v)
}
body, _, err := ctx.Mes.Get("/api/internal/call/pool", q)
mesJSON(w, body, err)
}
}
// callCreateHandler POST /api/call/create 发起叫料(按物料行拆 N 张单,占用池子可用量)
// 请求体:{stationNo, items:[{materialCode, qty, dock?}]};每行缺省接驳台用 yaml Station.Dock 兜底。
func callCreateHandler(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 map[string]any
if err := json.Unmarshal(payload, &req); err != nil {
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
}
}
body, _ := json.Marshal(req)
resp, _, err := ctx.Mes.Post("/api/internal/call/create", json.RawMessage(body))
mesJSON(w, resp, err)
}
}
// callListHandler GET /api/call/list 叫料单列表(本工位;status 可空=全部)
func callListHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
q := url.Values{}
for _, k := range []string{"stationNo", "status", "materialCode", "targetDock", "source", "requestNo"} {
if v := strings.TrimSpace(r.URL.Query().Get(k)); v != "" {
q.Set(k, v)
}
}
body, _, err := ctx.Mes.Get("/api/internal/material-requests", q)
mesJSON(w, body, err)
}
}
// 2026-11-05 叫料包拍板:需求明细(两类提示)/ 左右接驳台实时传感器 / 托盘回库 / 工位物料明细
// callPlanDetailHandler GET /api/call/plan-detail?stationNo=
// 叫料需求明细(工单×排产日)+「当日剩余没叫/跨日量明细」两类提示(实时计算不落库不拦提交)。
func callPlanDetailHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
q := url.Values{}
if v := strings.TrimSpace(r.URL.Query().Get("stationNo")); v != "" {
q.Set("stationNo", v)
}
body, _, err := ctx.Mes.Get("/api/internal/call/plan-detail", q)
mesJSON(w, body, err)
}
}
// stationDockPalletsHandler GET /api/dock/station-pallets?stationNo=
// 左右接驳台实时传感器状态(叫料空台校验/下班校验共用;PLC 不可达回退台账并标 plcOk=false)。
func stationDockPalletsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
q := url.Values{}
if v := strings.TrimSpace(r.URL.Query().Get("stationNo")); v != "" {
q.Set("stationNo", v)
}
body, _, err := ctx.Mes.Get("/api/internal/dock/station-pallets", q)
mesJSON(w, body, err)
}
}
// palletReturnHandler POST /api/dock/pallet-return 托盘回库(物理拉回仓库,非退料;
// 物料账与库存不变;传感器为准、台账软校验,不一致由操作人确认留痕)。
func palletReturnHandler(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 map[string]any
if err := json.Unmarshal(payload, &req); err != nil {
fail(w, http.StatusBadRequest, "请求体解析失败")
return
}
if req["operator"] == nil || req["operator"] == "" {
if u := currentUsername(r); u != "" {
req["operator"] = u
}
}
body, _ := json.Marshal(req)
resp, _, perr := ctx.Mes.Post("/api/internal/dock/pallet-return", json.RawMessage(body))
mesJSON(w, resp, perr)
}
}
// materialDetailHandler GET /api/call/material-detail?stationNo=
// 工位物料明细(工艺物料全集 左连接 工位账四数,量为0也显示、不分左右托盘)。
func materialDetailHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
q := url.Values{}
if v := strings.TrimSpace(r.URL.Query().Get("stationNo")); v != "" {
q.Set("stationNo", v)
}
body, _, err := ctx.Mes.Get("/api/internal/call/material-detail", q)
mesJSON(w, body, err)
}
}
// callSignHandler POST /api/call/sign 签收(仅已发货;签收=确认收到,系统不再对差异)
func callSignHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return callStateHandler(ctx, "/api/internal/call/sign", "签收")
}
// callCancelHandler POST /api/call/cancel 取消(仅待备料,工位本人)
func callCancelHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return callStateHandler(ctx, "/api/internal/call/cancel", "取消")
}
// callReturnHandler POST /api/call/return 申请退库(仅已发货/签收前;整单退,仓库确认收回后关单)
func callReturnHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return callStateHandler(ctx, "/api/internal/call/return", "退库申请")
}
// callStateHandler 叫料单状态动作通用代理:补 operator(当前登录人)后转发 MES 内部端点。
func callStateHandler(ctx *svc.ServiceContext, mesPath, action string) 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 map[string]any
if err := json.Unmarshal(payload, &req); err != nil {
fail(w, http.StatusBadRequest, "请求体解析失败")
return
}
if req["requestNo"] == nil || req["requestNo"] == "" {
fail(w, http.StatusBadRequest, "缺少叫料单号")
return
}
if req["operator"] == nil || req["operator"] == "" {
if u := currentUsername(r); u != "" {
req["operator"] = u
}
}
body, _ := json.Marshal(req)
resp, _, err := ctx.Mes.Post(mesPath, json.RawMessage(body))
if err != nil {
fail(w, http.StatusBadGateway, action+"失败:MES 不可达")
return
}
mesJSON(w, resp, err)
}
}
// docksHandler GET /api/docks 接驳台列表(代理 MES /api/internal/docks;终端按工位过滤 左L/右R)
func docksHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
body, _, err := ctx.Mes.Get("/api/internal/docks", url.Values{})
mesJSON(w, body, err)
}
}