一、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 更新重新生成。
250 lines
9.2 KiB
Go
250 lines
9.2 KiB
Go
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)
|
||
}
|
||
}
|