Files
bj_power/bj_power_wms/internal/mesclient/client.go
T
SunYF f65a52d9e1 feat: 多系统新增扫码中间件与 AGV 对接,优化拧紧与退库流程
新增扫码中间件支持网络型扫码枪键盘注入,AGV 对接从 WMS 迁至 MES 统一管理;新增拧紧不合格人工处置与 PLC 对账机制,优化退库单关联与工位终端功能,同时清理旧 AGV 任务表,完善数据库与配置项。
2026-10-14 17:24:59 +08:00

471 lines
15 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 mesclient MES 内部接口客户端(备料单拉取/状态回写,AGV 配送用)。
package mesclient
import (
"bytes"
"context"
"encoding/json"
"errors"
"fmt"
"net/http"
"net/url"
"strconv"
"time"
)
// Client MES 内部接口客户端
type Client struct {
baseURL string
token string
hc *http.Client
}
func New(baseURL, token string) *Client {
if baseURL == "" {
baseURL = "http://127.0.0.1:8888"
}
return &Client{
baseURL: baseURL,
token: token,
hc: &http.Client{Timeout: 6 * time.Second},
}
}
// MaterialRequest MES 叫料单行(B5:不绑工单/不绑排产;七态状态机)
type MaterialRequest struct {
ID int `json:"id"`
RequestNo string `json:"requestNo"`
MaterialCode string `json:"materialCode"`
MaterialName string `json:"materialName"`
Unit string `json:"unit"`
SnMode int `json:"snMode"`
ReqQty float64 `json:"reqQty"`
SentQty float64 `json:"sentQty"`
ReturnedQty float64 `json:"returnedQty"`
Status string `json:"status"`
TargetDock string `json:"targetDock"`
StationNo int `json:"stationNo"`
Source string `json:"source"`
RefReportNo string `json:"refReportNo"`
NeedAgv bool `json:"needAgv"`
CrossDay bool `json:"crossDay"`
OutboundNo string `json:"outboundNo"`
RejectReason string `json:"rejectReason"`
Operator string `json:"operator"`
}
// ListMaterialRequests 拉取备料单(含 target_dock)
// status 空=全部;传 PENDING 可只取待发料。
func (c *Client) ListMaterialRequests(ctx context.Context, status string) ([]MaterialRequest, error) {
u := c.baseURL + "/api/internal/material-requests"
q := ""
if status != "" {
q = "?status=" + status
}
req, err := http.NewRequestWithContext(ctx, http.MethodGet, u+q, nil)
if err != nil {
return nil, err
}
req.Header.Set("X-API-TOKEN", c.token)
resp, err := c.hc.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
var env struct {
Code int `json:"code"`
Data []MaterialRequest `json:"data"`
Msg string `json:"message"`
}
dec := json.NewDecoder(resp.Body)
// MES 的 data 可能是 [object] 数组
if err := dec.Decode(&env); err != nil {
return nil, err
}
if env.Data == nil {
return []MaterialRequest{}, nil
}
return env.Data, nil
}
// MaterialDemandRow MES 排产物料需求行(按物料汇总,未来 N 天)
// WMS「缺料补货」视图拉此数据,对比本地可用库存得出排产缺料量。
type MaterialDemandRow struct {
MaterialCode string `json:"materialCode"`
MaterialName string `json:"materialName"`
Unit string `json:"unit"`
DemandQty int `json:"demandQty"` // 未来 N 天排产总需求(台数×单台用量,向上取整)
StartDate string `json:"startDate"` // 需求窗口起(YYYY-MM-DD)
EndDate string `json:"endDate"` // 需求窗口止(YYYY-MM-DD)
}
// FetchMaterialDemand 实时向 MES 拉取「排产物料需求量」(供 WMS 缺料补货视图)。
// 两系统之间不做定时/批量同步:WMS 打开页面时按需拉一次,MES 现算现返。
// days 不传默认 5(与历史未来5天口径一致);MES 内部 /api/internal/material-demand 支持 ?days 覆盖。
func (c *Client) FetchMaterialDemand(ctx context.Context, days int) ([]MaterialDemandRow, error) {
u := c.baseURL + "/api/internal/material-demand"
if days > 0 {
u += "?days=" + strconv.Itoa(days)
}
req, err := http.NewRequestWithContext(ctx, http.MethodGet, u, nil)
if err != nil {
return nil, err
}
req.Header.Set("X-API-TOKEN", c.token)
resp, err := c.hc.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
var env struct {
Code int `json:"code"`
Data []MaterialDemandRow `json:"data"`
Msg string `json:"message"`
}
if err := json.NewDecoder(resp.Body).Decode(&env); err != nil {
return nil, err
}
if env.Code != 0 {
msg := env.Msg
if msg == "" {
msg = "MES 返回失败"
}
return nil, errors.New(msg)
}
if env.Data == nil {
return []MaterialDemandRow{}, nil
}
return env.Data, nil
}
// DockRow MES 接驳台主数据行(dock 真源已迁 MES,WMS 仅只读取用)。
type DockRow struct {
ID int64 `json:"id"`
DockCode string `json:"dockCode"`
Name string `json:"name"`
DockType string `json:"dockType"`
StationNo int `json:"stationNo"`
Status string `json:"status"`
HasPallet bool `json:"hasPallet"`
PalletRef string `json:"palletRef"`
}
// ListDocks 拉取 MES 接驳台主数据(dock 真源在 MES)。
// WMS 出库目标工位下拉 / AGV 页接驳台列表均读此接口,仓库不再本地维护 dock 表。
func (c *Client) ListDocks(ctx context.Context) ([]DockRow, error) {
req, err := http.NewRequestWithContext(ctx, http.MethodGet, c.baseURL+"/api/internal/docks", nil)
if err != nil {
return nil, err
}
req.Header.Set("X-API-TOKEN", c.token)
resp, err := c.hc.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
var env struct {
Code int `json:"code"`
Data struct {
List []DockRow `json:"list"`
} `json:"data"`
Msg string `json:"message"`
}
if err := json.NewDecoder(resp.Body).Decode(&env); err != nil {
return nil, err
}
if env.Code != 0 {
msg := env.Msg
if msg == "" {
msg = "MES 返回失败"
}
return nil, errors.New(msg)
}
if env.Data.List == nil {
return []DockRow{}, nil
}
return env.Data.List, nil
}
// WorkOrderContract MES 工单归属解析结果(A2 半成品入库继承产线工单)
type WorkOrderContract struct {
WorkOrderNo string `json:"workOrderNo"`
ContractNo string `json:"contractNo"`
ProjectNo string `json:"projectNo"`
}
// GetWorkOrder 调 MES 内部接口解析工单归属(合同号/工程编号)。
// 找不到(工单不存在或 MES 不可达)返回 (nil, nil),调用方静默降级、不阻断入库。
func (c *Client) GetWorkOrder(ctx context.Context, orderNo string) (*WorkOrderContract, error) {
if orderNo == "" {
return nil, nil
}
req, err := http.NewRequestWithContext(ctx, http.MethodGet,
c.baseURL+"/api/internal/work-orders/"+url.PathEscape(orderNo), nil)
if err != nil {
return nil, err
}
req.Header.Set("X-API-TOKEN", c.token)
resp, err := c.hc.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
var env struct {
Code int `json:"code"`
Data WorkOrderContract `json:"data"`
Msg string `json:"message"`
}
if err := json.NewDecoder(resp.Body).Decode(&env); err != nil {
return nil, err
}
if env.Code != 0 {
return nil, nil
}
return &env.Data, nil
}
// MaterialUpsert WMS→MES 物料推送载荷(需求一 M4:WMS 落库后异步推送 MES 本地副本;按 code 幂等)。
// SnMode(2026-09-30 与 MES 侧契约一致):0未选择/1序列号=是/2序列号=否。
type MaterialUpsert struct {
Code string `json:"code"`
Name string `json:"name"`
Spec string `json:"spec"`
Unit string `json:"unit"`
Description string `json:"description"`
ItemType int `json:"itemType"`
ManageMode int `json:"manageMode"`
SnMode int `json:"snMode"`
TemplateCode string `json:"templateCode"`
SafetyStock int `json:"safetyStock"`
IsActive *bool `json:"isActive"`
}
// UpsertMaterial 推送物料到 MES 本地副本(POST /api/internal/materials,按 code 幂等 upsert)。
// MES 业务错误为 HTTP 200 + code≠0,此处解包判断。
func (c *Client) UpsertMaterial(ctx context.Context, m MaterialUpsert) error {
b, _ := json.Marshal(m)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, c.baseURL+"/api/internal/materials", bytes.NewReader(b))
if err != nil {
return err
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-TOKEN", c.token)
resp, err := c.hc.Do(req)
if err != nil {
return err
}
defer resp.Body.Close()
var env struct {
Code int `json:"code"`
Msg string `json:"message"`
}
if err := json.NewDecoder(resp.Body).Decode(&env); err != nil {
return err
}
if env.Code != 0 {
return fmt.Errorf("MES 返回错误: %s", env.Msg)
}
return nil
}
// CallComplete 通知 MES 仓库已完成备料(B5):实发量 + WMS 出库单号。
// MES 侧只做状态迁移(PENDING→SHIPPED)与四数账记账,不反向调 WMS 出库。
func (c *Client) CallComplete(ctx context.Context, requestNo string, sentQty float64, outboundNo, operator string) error {
b, _ := json.Marshal(map[string]any{
"requestNo": requestNo, "sentQty": sentQty, "outboundNo": outboundNo, "operator": operator,
})
return c.postInternal(ctx, "/api/internal/call/complete", b, "MES 叫料单完成备料回写失败")
}
// CallReject 通知 MES 仓库驳回叫料单(B5):带理由(异常标记:非当日等)。
func (c *Client) CallReject(ctx context.Context, requestNo, reason, operator string) error {
b, _ := json.Marshal(map[string]any{"requestNo": requestNo, "reason": reason, "operator": operator})
return c.postInternal(ctx, "/api/internal/call/reject", b, "MES 叫料单驳回回写失败")
}
// CallReturnConfirm 通知 MES 仓库已确认收回退库(B5 退库闭环终点):MES 关单并回补叫料池额度。
func (c *Client) CallReturnConfirm(ctx context.Context, requestNo, operator string) error {
b, _ := json.Marshal(map[string]any{"requestNo": requestNo, "operator": operator})
return c.postInternal(ctx, "/api/internal/call/return-confirm", b, "MES 叫料单退库确认回写失败")
}
// postInternal 通用内部 POST:带 X-API-TOKEN;解析 MES 业务错误(HTTP 200 + body{code≠0} 必须判读)
func (c *Client) postInternal(ctx context.Context, path string, body []byte, errPrefix string) error {
req, err := http.NewRequestWithContext(ctx, http.MethodPost, c.baseURL+path, bytes.NewReader(body))
if err != nil {
return err
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-TOKEN", c.token)
resp, err := c.hc.Do(req)
if err != nil {
return err
}
defer resp.Body.Close()
if resp.StatusCode >= 300 {
return &RespError{Status: resp.StatusCode}
}
var env struct {
Code int `json:"code"`
Msg string `json:"msg"`
}
if err := json.NewDecoder(resp.Body).Decode(&env); err != nil {
return err
}
if env.Code != 0 {
return fmt.Errorf("%s: %s", errPrefix, env.Msg)
}
return nil
}
type RespError struct {
Status int
}
func (e *RespError) Error() string {
return "mes call failed with status " + fmt.Sprintf("%d", e.Status)
}
// ============ AGV 调度代理(2026-10-14 AGV 唯一真源迁 MES) ============
// AgvSubmitRow MES 下发 AGV 行(字段与 MES AgvSubmitRequest 对齐)
type AgvSubmitRow struct {
RequestNo string `json:"requestNo"`
MaterialCode string `json:"materialCode"`
MaterialName string `json:"materialName"`
Unit string `json:"unit"`
Qty float64 `json:"qty"`
TargetDock string `json:"targetDock"`
}
// postInternalJSON 通用内部 POST:带 X-API-TOKEN;解析 MES 业务错误(HTTP 200 + body{code≠0} 必须判读)。
// 与 postInternal 区别:正确读取 message 字段(MES 统一返回 {code,message,data})。
func (c *Client) postInternalJSON(ctx context.Context, path string, body []byte, out any) error {
req, err := http.NewRequestWithContext(ctx, http.MethodPost, c.baseURL+path, bytes.NewReader(body))
if err != nil {
return err
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-TOKEN", c.token)
resp, err := c.hc.Do(req)
if err != nil {
return err
}
defer resp.Body.Close()
if resp.StatusCode >= 300 {
return &RespError{Status: resp.StatusCode}
}
var env struct {
Code int `json:"code"`
Message string `json:"message"`
Data json.RawMessage `json:"data"`
}
if err := json.NewDecoder(resp.Body).Decode(&env); err != nil {
return err
}
if env.Code != 0 {
msg := env.Message
if msg == "" {
msg = "MES 返回失败"
}
return fmt.Errorf("%s", msg)
}
if out != nil && len(env.Data) > 0 {
return json.Unmarshal(env.Data, out)
}
return nil
}
// getInternalJSON 通用内部 GET:带 X-API-TOKEN;解析 MES 业务错误。
func (c *Client) getInternalJSON(ctx context.Context, path string, out any) error {
req, err := http.NewRequestWithContext(ctx, http.MethodGet, c.baseURL+path, nil)
if err != nil {
return err
}
req.Header.Set("X-API-TOKEN", c.token)
resp, err := c.hc.Do(req)
if err != nil {
return err
}
defer resp.Body.Close()
if resp.StatusCode >= 300 {
return &RespError{Status: resp.StatusCode}
}
var env struct {
Code int `json:"code"`
Message string `json:"message"`
Data json.RawMessage `json:"data"`
}
if err := json.NewDecoder(resp.Body).Decode(&env); err != nil {
return err
}
if env.Code != 0 {
msg := env.Message
if msg == "" {
msg = "MES 返回失败"
}
return fmt.Errorf("%s", msg)
}
if out != nil && len(env.Data) > 0 {
return json.Unmarshal(env.Data, out)
}
return nil
}
// SubmitAgv 仓管下发 AGV:代理 MES /api/internal/agv/submit(MES 为 AGV 唯一真源,调度海康 RCS)
func (c *Client) SubmitAgv(ctx context.Context, rows []AgvSubmitRow, sourceDock, operator string) (int, []string, error) {
b, _ := json.Marshal(map[string]any{"rows": rows, "sourceDock": sourceDock, "operator": operator})
var data struct {
Created int `json:"created"`
Failed []string `json:"failed"`
}
if err := c.postInternalJSON(ctx, "/api/internal/agv/submit", b, &data); err != nil {
return 0, nil, err
}
return data.Created, data.Failed, nil
}
// ListAgvTasks 查询 AGV 任务(代理 MES,分页契约透传 {list,total,page,pageSize})
func (c *Client) ListAgvTasks(ctx context.Context, status, targetDock string, page, size int) (map[string]any, error) {
q := url.Values{}
if status != "" {
q.Set("status", status)
}
if targetDock != "" {
q.Set("targetDock", targetDock)
}
q.Set("page", strconv.Itoa(page))
q.Set("pageSize", strconv.Itoa(size))
var data map[string]any
if err := c.getInternalJSON(ctx, "/api/internal/agv/tasks?"+q.Encode(), &data); err != nil {
return nil, err
}
return data, nil
}
// RefreshAgvTasks 轮询海康 RCS 刷新未终态任务(代理 MES)
func (c *Client) RefreshAgvTasks(ctx context.Context) (int, error) {
var data struct {
Changed int `json:"changed"`
}
if err := c.postInternalJSON(ctx, "/api/internal/agv/refresh", []byte("{}"), &data); err != nil {
return 0, err
}
return data.Changed, nil
}
// CancelAgvTask 取消 AGV 任务(代理 MES)
func (c *Client) CancelAgvTask(ctx context.Context, taskNo, reason, operator string) error {
b, _ := json.Marshal(map[string]any{"taskNo": taskNo, "reason": reason, "operator": operator})
return c.postInternalJSON(ctx, "/api/internal/agv/cancel", b, nil)
}
// AgvMode 返回 AGV 对接模式(代理 MES)
func (c *Client) AgvMode(ctx context.Context) (map[string]any, error) {
var data map[string]any
if err := c.getInternalJSON(ctx, "/api/internal/agv/mode", &data); err != nil {
return nil, err
}
return data, nil
}