新增扫码中间件支持网络型扫码枪键盘注入,AGV 对接从 WMS 迁至 MES 统一管理;新增拧紧不合格人工处置与 PLC 对账机制,优化退库单关联与工位终端功能,同时清理旧 AGV 任务表,完善数据库与配置项。
267 lines
8.9 KiB
Go
267 lines
8.9 KiB
Go
package handler
|
||
|
||
import (
|
||
"bytes"
|
||
"encoding/json"
|
||
"errors"
|
||
"net/http"
|
||
"net/http/httptest"
|
||
"strconv"
|
||
"strings"
|
||
|
||
"bj_power_wms/ent"
|
||
"bj_power_wms/ent/inventory"
|
||
"bj_power_wms/internal/mesclient"
|
||
"bj_power_wms/internal/svc"
|
||
|
||
"github.com/zeromicro/go-zero/core/logx"
|
||
)
|
||
|
||
// ============ B5 叫料队列(仓库端,2026-10-13 定稿) ============
|
||
// 入口:WMS「叫料队列」页(JWT + call:view/call:manage)。
|
||
// 完成备料 = WMS 本地 FIFO 选库存 → 通用出库(类别「叫料配送」)→ 通知 MES /call/complete;
|
||
// MES 不反向调 WMS 出库(主控裁定:库存动作归 WMS,减少环、降低失败面)。
|
||
|
||
// callPendingHandler GET /api/call/pending 叫料队列:待备料叫料单(代理 MES 内部列表)。
|
||
// 支持 stationNo / materialCode / requestNo 过滤(不区分大小写由 MES 侧处理)。
|
||
func callPendingHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||
return func(w http.ResponseWriter, r *http.Request) {
|
||
if ctx.Mes == nil {
|
||
fail(w, http.StatusInternalServerError, "MES 未配置,无法拉取叫料队列")
|
||
return
|
||
}
|
||
list, err := ctx.Mes.ListMaterialRequests(r.Context(), "PENDING")
|
||
if err != nil {
|
||
fail(w, http.StatusBadGateway, "拉取 MES 叫料队列失败: "+err.Error())
|
||
return
|
||
}
|
||
stationNo := strings.TrimSpace(r.URL.Query().Get("stationNo"))
|
||
materialCode := strings.TrimSpace(r.URL.Query().Get("materialCode"))
|
||
requestNo := strings.TrimSpace(r.URL.Query().Get("requestNo"))
|
||
out := make([]mesclient.MaterialRequest, 0, len(list))
|
||
for _, m := range list {
|
||
if stationNo != "" && strconv.Itoa(m.StationNo) != stationNo {
|
||
continue
|
||
}
|
||
if materialCode != "" && !strings.Contains(strings.ToLower(m.MaterialCode), strings.ToLower(materialCode)) {
|
||
continue
|
||
}
|
||
if requestNo != "" && !strings.Contains(strings.ToLower(m.RequestNo), strings.ToLower(requestNo)) {
|
||
continue
|
||
}
|
||
out = append(out, m)
|
||
}
|
||
ok(w, map[string]any{"total": len(out), "list": out})
|
||
}
|
||
}
|
||
|
||
// callCompleteHandler POST /api/call/complete 仓库完成备料(点「完成」一键:选库存→出库→通知 MES→派车)。
|
||
// body: {requestNo}。实发量由 WMS 库存实况确定(缺多少发多少,差额 MES 自动释放)。
|
||
func callCompleteHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||
return func(w http.ResponseWriter, r *http.Request) {
|
||
if ctx.Mes == nil {
|
||
fail(w, http.StatusInternalServerError, "MES 未配置,无法完成备料")
|
||
return
|
||
}
|
||
var req struct {
|
||
RequestNo string `json:"requestNo"`
|
||
}
|
||
if err := parseJSON(r, &req); err != nil || strings.TrimSpace(req.RequestNo) == "" {
|
||
fail(w, http.StatusBadRequest, "缺少叫料单号")
|
||
return
|
||
}
|
||
operator := r.Header.Get("X-Username")
|
||
if operator == "" {
|
||
operator = "warehouse"
|
||
}
|
||
// 1. 取 MES 叫料单并校验状态
|
||
list, err := ctx.Mes.ListMaterialRequests(r.Context(), "PENDING")
|
||
if err != nil {
|
||
fail(w, http.StatusBadGateway, "拉取 MES 叫料单失败: "+err.Error())
|
||
return
|
||
}
|
||
var call *mesclient.MaterialRequest
|
||
for i := range list {
|
||
if list[i].RequestNo == req.RequestNo {
|
||
call = &list[i]
|
||
break
|
||
}
|
||
}
|
||
if call == nil {
|
||
fail(w, http.StatusNotFound, "叫料单不存在或已不是待备料状态(可能已被其他仓库处理)")
|
||
return
|
||
}
|
||
if call.TargetDock == "" {
|
||
fail(w, http.StatusBadRequest, "该叫料单未指定目标接驳台,不能配送")
|
||
return
|
||
}
|
||
need := int(call.ReqQty + 0.5)
|
||
if need <= 0 {
|
||
fail(w, http.StatusBadRequest, "叫料单请求量异常")
|
||
return
|
||
}
|
||
|
||
// 2. FIFO 选库存(口径同 /api/internal/stock/batches:在库 + 合格 + 未锁定部分)
|
||
rows, err := ctx.EntClient.Inventory.Query().
|
||
Where(
|
||
inventory.MaterialCodeEQ(call.MaterialCode),
|
||
inventory.QuantityGT(0),
|
||
inventory.QualityStatusIn(QStatusPass),
|
||
inventory.StatusEQ("在库"),
|
||
).
|
||
Order(ent.Asc("batch_no"), ent.Asc("created_at")).
|
||
All(ctx0())
|
||
if err != nil {
|
||
fail(w, http.StatusInternalServerError, "查询库存失败: "+err.Error())
|
||
return
|
||
}
|
||
type pick struct {
|
||
batchNo string
|
||
sn string
|
||
take int
|
||
}
|
||
picks := make([]pick, 0, 4)
|
||
remain := need
|
||
for _, inv := range rows {
|
||
if remain <= 0 {
|
||
break
|
||
}
|
||
avail := inv.Quantity - inv.LockedQty
|
||
if avail <= 0 {
|
||
continue
|
||
}
|
||
take := avail
|
||
if take > remain {
|
||
take = remain
|
||
}
|
||
if call.SnMode == 1 {
|
||
// 序列号=是:逐件(每行 quantity=1)
|
||
if inv.SnCode == "" {
|
||
continue
|
||
}
|
||
picks = append(picks, pick{sn: inv.SnCode, take: 1})
|
||
remain--
|
||
continue
|
||
}
|
||
if inv.SnMode == snModeBatch {
|
||
picks = append(picks, pick{batchNo: inv.BatchNo, take: take})
|
||
remain -= take
|
||
}
|
||
}
|
||
if len(picks) == 0 {
|
||
fail(w, http.StatusConflict, "WMS 无可用合格库存(在库/合格),无法完成备料")
|
||
return
|
||
}
|
||
|
||
// 3. 逐批通用出库(类别=叫料配送;目标接驳台=叫料单目标;进程内复用通用出库全链路)
|
||
outboundNos := make([]string, 0, len(picks))
|
||
sentTotal := 0
|
||
for _, p := range picks {
|
||
payload := generalOutboundRequest{
|
||
MaterialCode: call.MaterialCode,
|
||
Qty: p.take,
|
||
Operator: operator,
|
||
OutboundCategory: "call",
|
||
Remark: "叫料单 " + call.RequestNo,
|
||
TargetDock: call.TargetDock,
|
||
TargetStation: strconv.Itoa(call.StationNo),
|
||
NeedAgv: call.NeedAgv,
|
||
}
|
||
if p.sn != "" {
|
||
payload.SnList = []string{p.sn}
|
||
} else {
|
||
payload.BatchNo = p.batchNo
|
||
}
|
||
obNo, obQty, gerr := doGeneralOutbound(ctx, payload)
|
||
if gerr != nil {
|
||
fail(w, http.StatusInternalServerError, "出库失败(物料 "+call.MaterialCode+"):"+gerr.Error())
|
||
return
|
||
}
|
||
outboundNos = append(outboundNos, obNo)
|
||
sentTotal += obQty
|
||
}
|
||
if sentTotal <= 0 {
|
||
fail(w, http.StatusInternalServerError, "出库结果异常:实发量为 0")
|
||
return
|
||
}
|
||
|
||
// 4. 通知 MES 完成备料(状态迁移 + 四数账;失败不阻断出库事实,返回出库单号供重试)
|
||
joined := strings.Join(outboundNos, ",")
|
||
if cerr := ctx.Mes.CallComplete(r.Context(), call.RequestNo, float64(sentTotal), joined, operator); cerr != nil {
|
||
logx.Errorf("call complete notify MES failed: requestNo=%s err=%v", call.RequestNo, cerr)
|
||
fail(w, http.StatusBadGateway, "已出库(单号 "+joined+"),但通知 MES 失败,请重试「完成备料」: "+cerr.Error())
|
||
return
|
||
}
|
||
|
||
// 5. AGV 自动派车已交由 MES 在「完成备料」内统一触发(best-effort),WMS 不再本地下发海康 RCS
|
||
agvNote := "(AGV 由 MES 自动派车)"
|
||
ok(w, map[string]any{
|
||
"requestNo": call.RequestNo, "sentQty": sentTotal, "reqQty": need,
|
||
"outboundNos": joined, "short": need - sentTotal, "agvNote": agvNote,
|
||
})
|
||
}
|
||
}
|
||
|
||
// callRejectHandler POST /api/call/reject 仓库驳回叫料单(仅待备料;理由必填,异常标记:非当日等)。
|
||
func callRejectHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||
return func(w http.ResponseWriter, r *http.Request) {
|
||
if ctx.Mes == nil {
|
||
fail(w, http.StatusInternalServerError, "MES 未配置")
|
||
return
|
||
}
|
||
var req struct {
|
||
RequestNo string `json:"requestNo"`
|
||
Reason string `json:"reason"`
|
||
}
|
||
if err := parseJSON(r, &req); err != nil || strings.TrimSpace(req.RequestNo) == "" {
|
||
fail(w, http.StatusBadRequest, "缺少叫料单号")
|
||
return
|
||
}
|
||
if strings.TrimSpace(req.Reason) == "" {
|
||
fail(w, http.StatusBadRequest, "驳回必须填写理由")
|
||
return
|
||
}
|
||
operator := r.Header.Get("X-Username")
|
||
if operator == "" {
|
||
operator = "warehouse"
|
||
}
|
||
if err := ctx.Mes.CallReject(r.Context(), req.RequestNo, strings.TrimSpace(req.Reason), operator); err != nil {
|
||
fail(w, http.StatusBadGateway, "驳回失败: "+err.Error())
|
||
return
|
||
}
|
||
ok(w, map[string]any{"requestNo": req.RequestNo})
|
||
}
|
||
}
|
||
|
||
// doGeneralOutbound 进程内复用通用出库全链路(事务/扣减/单号/冻结守卫零重复实现)。
|
||
// 返回出库单号与实发量;HTTP 层错误以 error 返回(message 透出)。
|
||
func doGeneralOutbound(ctx *svc.ServiceContext, req generalOutboundRequest) (string, int, error) {
|
||
body, merr := json.Marshal(req)
|
||
if merr != nil {
|
||
return "", 0, merr
|
||
}
|
||
rec := httptest.NewRecorder()
|
||
httpReq := httptest.NewRequest(http.MethodPost, "/api/outbound/general", bytes.NewReader(body))
|
||
httpReq.Header.Set("Content-Type", "application/json")
|
||
generalOutboundHandler(ctx)(rec, httpReq)
|
||
var env struct {
|
||
Code int `json:"code"`
|
||
Message string `json:"message"`
|
||
Data struct {
|
||
OutboundNo string `json:"outboundNo"`
|
||
Qty int `json:"qty"`
|
||
} `json:"data"`
|
||
}
|
||
if derr := json.Unmarshal(rec.Body.Bytes(), &env); derr != nil {
|
||
return "", 0, derr
|
||
}
|
||
if env.Code != 0 {
|
||
return "", 0, errors.New(env.Message)
|
||
}
|
||
return env.Data.OutboundNo, env.Data.Qty, nil
|
||
}
|
||
|
||
// dispatchAgv 已移除(2026-10-14 AGV 唯一真源迁 MES):WMS 完成备料后由 MES 在 /api/internal/call/complete
|
||
// 内部统一触发海康 RCS 派车,WMS 不再本地持有 RCS 客户端,避免双真源/双派车。
|
||
|