Files
bj_power/bj_power_mes/internal/logic/qty_report.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

276 lines
9.8 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 logic
import (
"context"
"errors"
"fmt"
"strconv"
"time"
"bj_power_mes/ent"
entdock "bj_power_mes/ent/dock"
"bj_power_mes/ent/alert"
dockent "bj_power_mes/ent/dock"
"bj_power_mes/ent/materialqtyreport"
)
// ============ 数量不符(工位上报 → 处理闭环) ============
//
// 归属(2026-09-19 定稿):**MES 为唯一真源与处理侧**。
// 上报链(工位终端 → MES /material_qty_report)、表、预警全在 MES,
// 因此处理动作也放 MES,形成"上报 → 处理 → 生成对应单据"的完整闭环;
// 不在 WMS 另存一份明细(WMS 只经内部接口被动建单)。
//
// 处理动作与生成单据:
// 补发 REPLENISH → 少发(diffQty>0)时生成 source=REFILL 的补料单,走既有自动出库 + AGV
// 退库 RETURN → 多发(diffQty<0)时调 WMS 建退库单(工位退料回库房同一条链路)
// 调整 ADJUST → 少量差异双方确认后直接关闭(不补不退)
// QtyReportQuery 数量不符记录查询条件(全部可选,多条件取交集)
type QtyReportQuery struct {
Status string
StationNo string
MaterialCode string
OrderNo string
Page int
PageSize int
}
// QtyReportRow 数量不符记录读模型
type QtyReportRow struct {
ID int `json:"id"`
ReportNo string `json:"reportNo"` // 业务单号 QR{id}(对外展示与追溯用)
StationNo int `json:"stationNo"`
OrderNo string `json:"orderNo"`
Sn string `json:"sn"`
MaterialCode string `json:"materialCode"`
MaterialName string `json:"materialName"`
PlanQty int `json:"planQty"`
ActualQty int `json:"actualQty"`
DiffQty int `json:"diffQty"`
Cause string `json:"cause"`
Status string `json:"status"`
HandleType string `json:"handleType"`
HandleDocNo string `json:"handleDocNo"`
HandleNote string `json:"handleNote"`
HandledBy string `json:"handledBy"`
HandledAt int64 `json:"handledAt"`
Operator string `json:"operator"`
CreatedAt int64 `json:"createdAt"`
}
// qtyReportNo 差异单对外业务单号(与预警 refId 保持一致,便于从预警一键定位)
func qtyReportNo(id int) string { return fmt.Sprintf("QR%d", id) }
// ListQtyReports 数量不符记录查询(真分页:count + 分页查询均在 SQL 层)。
func (s *Service) ListQtyReports(ctx context.Context, q QtyReportQuery) (map[string]any, error) {
if q.Page < 1 {
q.Page = 1
}
if q.PageSize < 1 || q.PageSize > 200 {
q.PageSize = 20
}
b := s.ctx.EntClient.MaterialQtyReport.Query()
if q.Status != "" {
// RESOLVED 为历史值,读时归并为 CLOSED
if q.Status == "CLOSED" {
b = b.Where(materialqtyreport.StatusIn("CLOSED", "RESOLVED"))
} else {
b = b.Where(materialqtyreport.Status(q.Status))
}
}
if q.StationNo != "" {
if n, e := strconv.Atoi(q.StationNo); e == nil {
b = b.Where(materialqtyreport.StationNo(n))
}
}
if q.MaterialCode != "" {
b = b.Where(materialqtyreport.MaterialCodeContainsFold(q.MaterialCode))
}
if q.OrderNo != "" {
b = b.Where(materialqtyreport.OrderNoEqualFold(q.OrderNo))
}
total, err := b.Count(ctx)
if err != nil {
return nil, err
}
list, err := b.Order(ent.Desc(materialqtyreport.FieldCreatedAt), ent.Desc(materialqtyreport.FieldID)).
Offset((q.Page - 1) * q.PageSize).Limit(q.PageSize).All(ctx)
if err != nil {
return nil, err
}
rows := make([]QtyReportRow, 0, len(list))
for _, r := range list {
rows = append(rows, QtyReportRow{
ID: r.ID,
ReportNo: qtyReportNo(r.ID),
StationNo: r.StationNo,
OrderNo: r.OrderNo,
Sn: r.Sn,
MaterialCode: r.MaterialCode,
MaterialName: r.MaterialName,
PlanQty: r.PlanQty,
ActualQty: r.ActualQty,
DiffQty: r.DiffQty,
Cause: r.Cause,
Status: r.Status,
HandleType: r.HandleType,
HandleDocNo: r.HandleDocNo,
HandleNote: r.HandleNote,
HandledBy: r.HandledBy,
HandledAt: r.HandledAt,
Operator: r.Operator,
CreatedAt: r.CreatedAt.Unix(),
})
}
return map[string]any{"total": total, "list": rows, "page": q.Page, "pageSize": q.PageSize}, nil
}
// QtyReportStats 数量不符统计(顶部概览:待处理 / 已补发 / 已退库 / 已关闭)
func (s *Service) QtyReportStats(ctx context.Context) (map[string]any, error) {
pending, err := s.ctx.EntClient.MaterialQtyReport.Query().
Where(materialqtyreport.StatusIn("PENDING", "PROCESSING")).Count(ctx)
if err != nil {
return nil, err
}
replenished, _ := s.ctx.EntClient.MaterialQtyReport.Query().
Where(materialqtyreport.Status("REPLENISHED")).Count(ctx)
returned, _ := s.ctx.EntClient.MaterialQtyReport.Query().
Where(materialqtyreport.Status("RETURNED")).Count(ctx)
closed, _ := s.ctx.EntClient.MaterialQtyReport.Query().
Where(materialqtyreport.StatusIn("CLOSED", "ADJUSTED", "RESOLVED")).Count(ctx)
return map[string]any{
"pending": pending, "replenished": replenished,
"returned": returned, "closed": closed,
}, nil
}
// HandleQtyReport 处理数量不符(唯一处理入口)。
//
// handleType:
//
// REPLENISH 补发(仅少发可用):生成 source=REFILL 的补料单,needAgv=true,
// 关联差异单号;后续走既有「自动出库 → AGV → 接料」链路,本单即闭环。
// RETURN 退库(仅多发可用):调 WMS 建退库单(与工位退料同链路),WMS 确认收货后库存加回。
// ADJUST 调整关闭(任意方向):少量差异双方确认,不补不退,必须填说明。
//
// 幂等:仅 PENDING/PROCESSING 可处理,已处理单据拒绝重复处理。
func (s *Service) HandleQtyReport(ctx context.Context, id int, handleType, note, operator string) (map[string]any, error) {
if id <= 0 {
return nil, errors.New("缺少差异单ID")
}
rep, err := s.ctx.EntClient.MaterialQtyReport.Get(ctx, id)
if err != nil {
return nil, errors.New("数量不符记录不存在")
}
if rep.Status != "PENDING" && rep.Status != "PROCESSING" {
return nil, errors.New("该差异已处理(" + qtyReportStatusLabel(rep.Status) + "),不能重复处理")
}
docNo := ""
switch handleType {
case "REPLENISH":
if rep.DiffQty <= 0 {
return nil, errors.New("本单为「多发」,不能走补发;请选择退库或调整")
}
// 目标接驳台:取该工位关联的接驳台(一个工位可绑多个接驳台,取第一个)
dock := ""
if dk, e := s.ctx.EntClient.Dock.Query().
Where(dockent.StationNo(rep.StationNo)).First(ctx); e == nil {
dock = dk.DockCode
}
// 补发=叫料池另一入口(B5:多种入口消耗同一池子,耗尽即止):
// 生成 source=REFILL 的叫料单(PENDING,占用池子可用量),后续走仓库完成备料→签收链路。
n, e := s.CreateCallOrders(ctx, rep.StationNo,
[]CallItem{{MaterialCode: rep.MaterialCode, Qty: int(rep.DiffQty), Dock: dock}},
"REFILL", qtyReportNo(rep.ID), operator, "", false)
if e != nil {
return nil, fmt.Errorf("生成补发叫料单失败:%w", e)
}
if n == 0 {
return nil, errors.New("生成补发叫料单失败:无有效明细")
}
docNo = qtyReportNo(rep.ID) + "-REFILL"
case "RETURN":
if rep.DiffQty >= 0 {
return nil, errors.New("本单为「少发」,不能走退库;请选择补发或调整")
}
sendQty := -rep.DiffQty // 多发量
if s.ctx.Wms == nil {
return nil, errors.New("WMS 未配置,无法生成退库单")
}
// 退料接驳台(2026-11-03 拍板必填):数量不符退回沿用补发口径——取该工位第一个接驳台
retDock := ""
if docks, derr := s.ctx.EntClient.Dock.Query().
Where(entdock.StationNo(rep.StationNo), entdock.DockTypeEQ("line")).All(ctx); derr == nil && len(docks) > 0 {
retDock = docks[0].DockCode
}
if e := s.ctx.Wms.CreateReturnOrder(ctx, rep.OrderNo, rep.Sn, rep.MaterialCode, rep.MaterialName,
"", "数量不符多发退回", operator, rep.StationNo, sendQty, "", "", retDock, rep.Cause, "manual"); e != nil {
return nil, fmt.Errorf("生成退库单失败:%w", e)
}
docNo = fmt.Sprintf("RO-%s", qtyReportNo(rep.ID))
case "ADJUST":
if note == "" {
return nil, errors.New("调整关闭必须填写处理说明")
}
default:
return nil, errors.New("非法处理方式(仅支持 补发/退库/调整)")
}
newStatus := map[string]string{
"REPLENISH": "REPLENISHED",
"RETURN": "RETURNED",
"ADJUST": "CLOSED",
}[handleType]
if _, err := s.ctx.EntClient.MaterialQtyReport.UpdateOneID(rep.ID).
SetStatus(newStatus).
SetHandleType(handleType).
SetHandleDocNo(docNo).
SetHandleNote(note).
SetHandledBy(operator).
SetHandledAt(time.Now().Unix()).
Save(ctx); err != nil {
return nil, err
}
// 闭环预警:把本差异单对应的未读「数量不符」预警标记为已处理,
// 避免已处理完的差异仍在预警中心反复提醒。
_, _ = s.ctx.EntClient.Alert.Update().
Where(alert.Type("qty_diff"), alert.RefId(qtyReportNo(rep.ID)), alert.Status("UNREAD")).
SetStatus("READ").Save(ctx)
s.ctx.EventLog.Write(ctx, "qty_report.handle", rep.OrderNo, operator, "material_qty_report",
qtyReportNo(rep.ID), "数量不符处理:"+qtyReportStatusLabel(newStatus)+
fmt.Sprintf(" 物料 %s 差异 %d", rep.MaterialCode, rep.DiffQty),
map[string]any{"handleType": handleType, "handleDocNo": docNo, "note": note,
"stationNo": rep.StationNo, "materialCode": rep.MaterialCode, "diffQty": rep.DiffQty})
s.notifyDashboard()
return map[string]any{
"id": rep.ID, "status": newStatus,
"handleType": handleType, "handleDocNo": docNo,
}, nil
}
// qtyReportStatusLabel 状态中文标签(界面禁英文,统一在此转换)
func qtyReportStatusLabel(s string) string {
switch s {
case "PENDING":
return "待处理"
case "PROCESSING":
return "处理中"
case "REPLENISHED":
return "已补发"
case "RETURNED":
return "已退库"
case "ADJUSTED", "CLOSED", "RESOLVED":
return "已关闭"
}
return s
}