Files
bj_power/bj_power_wms/internal/handler/outbound.go
T

711 lines
26 KiB
Go
Raw Normal View History

2026-08-28 15:06:01 +08:00
package handler
import (
"encoding/json"
2026-08-28 15:06:01 +08:00
"net/http"
"strings"
"time"
2026-08-28 15:06:01 +08:00
"bj_power_wms/ent"
"bj_power_wms/ent/inventory"
"bj_power_wms/ent/material"
2026-08-28 15:06:01 +08:00
"bj_power_wms/ent/outbounddetail"
"bj_power_wms/ent/outboundorder"
"bj_power_wms/internal/svc"
"github.com/zeromicro/go-zero/core/logx"
)
// queryOutboundHandler 出库单查询
// 客户诉求 L96-108:按 归属单号 / 名称图号 / 日期范围 / 目标工位 查询,多条件取交集;
// 修复此前"前端传了 outboundType/日期但后端忽略"的缺陷。
2026-08-28 15:06:01 +08:00
func queryOutboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
page := atoi(r.URL.Query().Get("page"), 1)
pageSize := atoi(r.URL.Query().Get("pageSize"), 20)
orderNo := r.URL.Query().Get("orderNo")
materialCode := r.URL.Query().Get("materialCode")
outboundNo := r.URL.Query().Get("outboundNo")
boxNo := r.URL.Query().Get("boxNo")
outboundType := r.URL.Query().Get("outboundType")
outboundCategory := r.URL.Query().Get("outboundCategory")
ownershipNo := r.URL.Query().Get("ownershipNo")
materialName := r.URL.Query().Get("materialName")
targetStation := r.URL.Query().Get("targetStation")
status := r.URL.Query().Get("status")
inspectionNo := r.URL.Query().Get("inspectionNo")
2026-08-28 15:06:01 +08:00
q := ctx.EntClient.OutboundOrder.Query()
if status != "" {
q = q.Where(outboundorder.StatusEQ(status))
}
2026-08-28 15:06:01 +08:00
if orderNo != "" {
q = q.Where(outboundorder.OrderNoEqualFold(orderNo))
2026-08-28 15:06:01 +08:00
}
if materialCode != "" {
q = q.Where(outboundorder.MaterialCodeEqualFold(materialCode))
2026-08-28 15:06:01 +08:00
}
if outboundNo != "" {
q = q.Where(outboundorder.OutboundNoEqualFold(outboundNo))
2026-08-28 15:06:01 +08:00
}
if boxNo != "" {
q = q.Where(outboundorder.BoxNoContainsFold(boxNo))
}
if ownershipNo != "" {
q = q.Where(outboundorder.OwnershipNoContainsFold(ownershipNo))
}
if outboundType != "" {
q = q.Where(outboundorder.OutboundTypeEQ(outboundType))
}
if outboundCategory != "" {
q = q.Where(outboundorder.OutboundCategoryEQ(outboundCategory))
}
if materialName != "" {
q = q.Where(outboundorder.MaterialNameContainsFold(materialName))
}
if targetStation != "" {
q = q.Where(outboundorder.TargetStationEQ(targetStation))
}
if inspectionNo != "" {
q = q.Where(outboundorder.InspectionNoContainsFold(inspectionNo))
}
if v := r.URL.Query().Get("productWorkNo"); v != "" {
q = q.Where(outboundorder.ProductWorkNoContainsFold(v))
}
if v := r.URL.Query().Get("startDate"); v != "" {
if t, err := time.ParseInLocation("2006-01-02", v, time.Local); err == nil {
q = q.Where(outboundorder.CreatedAtGTE(t.Unix()))
}
}
if v := r.URL.Query().Get("endDate"); v != "" {
if t, err := time.ParseInLocation("2006-01-02", v, time.Local); err == nil {
q = q.Where(outboundorder.CreatedAtLTE(t.Add(24 * time.Hour).Unix()))
}
}
2026-08-28 15:06:01 +08:00
total, err := q.Count(ctx0())
if err != nil {
fail(w, http.StatusInternalServerError, err.Error())
return
}
2026-09-03 18:13:59 +08:00
list, err := q.Order(ent.Desc("created_at"), ent.Desc("id")).
2026-08-28 15:06:01 +08:00
Offset((page - 1) * pageSize).Limit(pageSize).All(ctx0())
if err != nil {
fail(w, http.StatusInternalServerError, err.Error())
return
}
// 附带明细
type row struct {
*ent.OutboundOrder
Details []*ent.OutboundDetail `json:"details"`
}
rows := make([]row, 0, len(list))
for _, ob := range list {
details, _ := ctx.EntClient.OutboundDetail.Query().
Where(outbounddetail.OutboundNoEQ(ob.OutboundNo)).
All(ctx0())
rows = append(rows, row{ob, details})
}
ok(w, map[string]any{
"total": total,
"list": rows,
"page": page,
"pageSize": pageSize,
})
}
}
// generalOutboundRequest 通用出库请求(不依赖 MES 工单)
// 客户诉求 问题记录 L96-108:通用出库先点选类别(退料/样品/报废/发货/其他手输),
// 并记录归属(工单号/科技项目号/其他)与目标工位。
type generalOutboundRequest struct {
MaterialCode string `json:"materialCode"`
BatchNo string `json:"batchNo"`
SnList []string `json:"snList"`
Qty int `json:"qty"`
Operator string `json:"operator"`
ZoneCode string `json:"zoneCode"`
ShelfNo string `json:"shelfNo"`
LayerNo string `json:"layerNo"`
PositionNo string `json:"positionNo"`
BoxNo string `json:"boxNo"`
ContractNo string `json:"contractNo"`
Remark string `json:"remark"`
OutboundNo string `json:"outboundNo"` // 可选:留空自动生成;填了必须唯一(如 OB20260921-001)
OutboundCategory string `json:"outboundCategory"` // return(退料)/supplier_return(退货退供应商)/sample(样品)/scrap(报废)/deliver(发货)/other(其他)
InspectionNo string `json:"inspectionNo"` // 可选:检测单号,退货/报废等需溯源检验单据
OwnershipType string `json:"ownershipType"` // workorder/project/other
OwnershipNo string `json:"ownershipNo"`
TargetStation string `json:"targetStation"`
TargetDock string `json:"targetDock"` // 目标接驳台(叫AGV时必填)
NeedAgv bool `json:"needAgv"` // 是否叫AGV配送到接驳台(可选)
BorrowFrom map[string]int `json:"borrowFrom"` // 跨工位借料来源(call 备料出库专用):stationNo→借用量(已排除本工位自取)
}
// makeOutboundHandler 通用出库 / 科技项目出库 共用工厂(B1/B2 逻辑拆分)。
// 两者底层完全一致(出库单 + 库存扣减 + 出库明细 原子提交;库存用条件原子更新避免负库存),
// 仅 outboundType(单据类型)与归属(ownership) 不同:
// - outboundType="general" → 通用出库(归属可选 合同号/其他,拒绝科技项目号)
// - outboundType="project" → 科技项目出库(强锁归属=科技项目号)
// 支持序列号=否(数量)与序列号=是(SN),序列号方式按物料档案 sn_mode 分叉(2026-09-30 解耦);
// 填箱号时一并把装箱信息(箱号/SN清单/合同号)落到统一的出库主表,不再另建装箱表。
func makeOutboundHandler(ctx *svc.ServiceContext, outboundType string) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req generalOutboundRequest
if err := parseJSON(r, &req); err != nil {
fail(w, http.StatusBadRequest, "参数错误: "+err.Error())
return
}
// B1/B2 逻辑拆分:科技项目出库(project) 与 通用出库(general) 共用本流程,仅单据类型与归属不同。
if outboundType == "project" {
req.OwnershipType = "project" // 科技项目出库强锁归属=科技项目号
} else if req.OwnershipType == "project" {
fail(w, http.StatusBadRequest, "通用出库不支持「科技项目号」归属,请使用「科技项目出库」入口")
return
}
if req.MaterialCode == "" {
fail(w, http.StatusBadRequest, "materialCode 必填")
return
}
if req.BatchNo == "" && len(req.SnList) == 0 {
fail(w, http.StatusBadRequest, "batchNo 或 snList 至少提供一个")
return
}
// 物料档案:sn_mode 守卫 + 出库单冗余类型
m, merr := ctx.EntClient.Material.Query().
Where(material.CodeEQ(req.MaterialCode)).
Only(ctx0())
if merr != nil {
fail(w, http.StatusBadRequest, "物料不存在: "+req.MaterialCode)
return
}
// sn_mode 守卫(2026-09-30 解耦定稿):物料档案未设置序列号(是/否),禁止出库
if m.SnMode == snModeUnset {
fail(w, http.StatusBadRequest, "请先在物料档案设置序列号(是/否)")
return
}
// 客户诉求 L96-108:出库类别必选;选「其他」时备注必填(承载手输原因)
if req.OutboundCategory == "" {
fail(w, http.StatusBadRequest, "出库类别必选(退料/样品/报废/发货/其他)")
return
}
if req.OutboundCategory == "other" && strings.TrimSpace(req.Remark) == "" {
fail(w, http.StatusBadRequest, "出库类别为「其他」时必须填写原因")
return
}
// 序列号方式(2026-09-30 解耦):按提交内容推导——带 SN 清单=序列号=是,否则=序列号=否(数量)
snMode := snModeBatch
if len(req.SnList) > 0 {
snMode = snModeSN
}
// SN 出库数量以列表长度计
actualQty := req.Qty
if snMode == snModeSN {
actualQty = len(req.SnList)
}
if actualQty <= 0 {
fail(w, http.StatusBadRequest, "数量必须大于 0")
return
}
// 盘点冻结守卫(问题2):盘点期间该批库存禁止出库。
if !assertNotFrozenTargets(ctx, w, req.BatchNo, req.SnList) {
return
}
// 四级库位:条9 强校验——显式填了任一层级即校验 SN/批次所在货位与所填一致;
// 全部未填才走兜底(不强制)
specZone, specShelf, specLayer, specPos := req.ZoneCode, req.ShelfNo, req.LayerNo, req.PositionNo
locSpecified := specZone != "" || specShelf != "" || specLayer != "" || specPos != ""
// 库位兜底(与工单出库同口径):未填的层级按「批次在库 → 首个 SN 在库」补全
req.ZoneCode, req.ShelfNo, req.LayerNo, req.PositionNo =
outboundLocationFallback(ctx, req.BatchNo, req.SnList, req.ZoneCode, req.ShelfNo, req.LayerNo, req.PositionNo)
outboundNo := strings.TrimSpace(req.OutboundNo)
if outboundNo != "" {
if err := validateUniqueNo(ctx, "OB", outboundNo); err != nil {
fail(w, http.StatusBadRequest, err.Error())
return
}
} else {
no, err := nextDailyNo(ctx, "OB")
if err != nil {
fail(w, http.StatusInternalServerError, "生成出库单号失败: "+err.Error())
return
}
outboundNo = no
}
tx, err := ctx.EntClient.Tx(ctx0())
if err != nil {
fail(w, http.StatusInternalServerError, "开启事务失败: "+err.Error())
return
}
committed := false
defer func() {
if !committed {
_ = tx.Rollback()
}
}()
pw := "" // 工单号:从源库存取,出库单创建后回填(五页带出)
obCreate := tx.OutboundOrder.Create().
SetOutboundNo(outboundNo).
SetOutboundType(outboundType).
SetStatus("已出库").
SetNeedAgv(req.NeedAgv).
SetNillableTargetDock(strPtr(req.TargetDock)).
SetNillableOutboundCategory(strPtr(req.OutboundCategory)).
SetNillableOwnershipType(strPtr(req.OwnershipType)).
SetNillableOwnershipNo(strPtr(req.OwnershipNo)).
SetNillableInspectionNo(strPtr(req.InspectionNo)).
SetNillableTargetStation(strPtr(req.TargetStation)).
SetMaterialCode(req.MaterialCode).
SetManageMode(m.ManageMode).
SetSnMode(snMode).
SetNillableBatchNo(strPtr(req.BatchNo)).
SetNillableZoneCode(strPtr(req.ZoneCode)).
SetNillableShelfNo(strPtr(req.ShelfNo)).
SetNillableLayerNo(strPtr(req.LayerNo)).
SetNillablePositionNo(strPtr(req.PositionNo)).
SetQuantity(0).
SetNillableOperator(strPtr(req.Operator)).
SetNillableRemark(strPtr(req.Remark)).
SetNillableBoxNo(strPtr(req.BoxNo)).
SetNillableContractNo(strPtr(req.ContractNo))
if len(req.BorrowFrom) > 0 {
obCreate.SetBorrowFrom(req.BorrowFrom)
}
ob, err := obCreate.Save(ctx0())
if err != nil {
fail(w, http.StatusInternalServerError, "创建出库单失败: "+err.Error())
return
}
// 批次扣减(序列号=否,按数量)
if req.BatchNo != "" {
bq := tx.Inventory.Query().
Where(inventory.SnModeEQ(snModeBatch), inventory.BatchNoEQ(req.BatchNo), inventory.MaterialCodeEQ(req.MaterialCode),
inventory.StatusIn("在库", "锁定")) // 条9 前置:仅允许对在库/锁定库存行出库(必须有有效库存行)
// 条9:指定了库位时按该库位的批次行校验可用量
if locSpecified {
if specZone != "" {
bq = bq.Where(inventory.ZoneCodeEQ(specZone))
}
if specShelf != "" {
bq = bq.Where(inventory.ShelfNoEQ(specShelf))
}
if specLayer != "" {
bq = bq.Where(inventory.LayerNoEQ(specLayer))
}
if specPos != "" {
bq = bq.Where(inventory.PositionNoEQ(specPos))
}
}
b, err := bq.Only(ctx0())
if err != nil {
// 区分「批次不存在」「批次不属于所选物料」「不在指定库位」三种情况给出明确中文错误
if locSpecified {
if exist, e2 := tx.Inventory.Query().
Where(inventory.SnModeEQ(snModeBatch), inventory.BatchNoEQ(req.BatchNo), inventory.MaterialCodeEQ(req.MaterialCode)).
Exist(ctx0()); e2 == nil && exist {
fail(w, http.StatusBadRequest, "SN/批次不在指定库位: "+req.BatchNo)
return
}
}
if exist, e2 := tx.Inventory.Query().
Where(inventory.SnModeEQ(snModeBatch), inventory.BatchNoEQ(req.BatchNo)).
Exist(ctx0()); e2 == nil && exist {
fail(w, http.StatusBadRequest, "批次不属于所选物料: "+req.BatchNo+" / "+req.MaterialCode)
return
}
fail(w, http.StatusBadRequest, "批次不存在: "+req.BatchNo)
return
}
pw = b.ProductWorkNo // 取源库存工单号,回填出库单
// 质量门禁(U5,客户口径):发货/样品/其他类出库仅允许「合格」品流向下游;
// 退货/报废/退料类豁免(本身即处置不合格品)。
if outboundBlocksUnqualified(req.OutboundCategory) && !qualityShippable(b.QualityStatus) {
fail(w, http.StatusConflict, "批次 "+req.BatchNo+" 质量状态为「"+qualityLabel(b.QualityStatus)+"」,"+outboundCategoryLabel(req.OutboundCategory)+"出库仅允许合格品(请先完成质量检验/处置)")
return
}
avail := b.Quantity - b.LockedQty
if avail < actualQty {
2026-11-05 19:18:18 +08:00
fail(w, http.StatusConflict, "批次库存不足: 物料「"+m.Name+"("+req.MaterialCode+")」批次 "+req.BatchNo+" 需要 "+itoa(actualQty)+",可用 "+itoa(avail))
return
}
aff, err := tx.Inventory.Update().
Where(inventory.ID(b.ID), inventory.QuantityGTE(actualQty)).
AddQuantity(-actualQty).
AddLockedQty(-min(actualQty, b.LockedQty)).
Save(ctx0())
if err != nil || aff == 0 {
fail(w, http.StatusConflict, "批次扣减失败(库存不足或并发冲突): "+req.BatchNo)
return
}
// 同步核销本批次的 ACTIVE 锁记录(FIFO 递减,扣到 0 置 CONSUMED),消除残留锁
consumeLocksForBatch(tx, req.BatchNo, req.MaterialCode, min(actualQty, b.LockedQty))
if _, err = tx.OutboundDetail.Create().
SetOutboundNo(outboundNo).
SetBatchNo(req.BatchNo).
SetMaterialCode(req.MaterialCode).
SetQuantity(actualQty).
Save(ctx0()); err != nil {
fail(w, http.StatusInternalServerError, "创建出库明细失败: "+err.Error())
return
}
}
// SN 扣减(序列号=是):仅在库/锁定的 SN 可出库
if len(req.SnList) > 0 {
// 质量门禁(U5,客户口径):发货/样品/其他类出库仅允许「合格」SN;退货/报废/退料类豁免。
if outboundBlocksUnqualified(req.OutboundCategory) {
passCnt, _ := tx.Inventory.Query().
Where(inventory.SnModeEQ(snModeSN), inventory.SnCodeIn(req.SnList...),
inventory.MaterialCodeEQ(req.MaterialCode), inventory.QualityStatusIn(QStatusPass)).
Count(ctx0())
if passCnt < len(req.SnList) {
fail(w, http.StatusConflict, "所选 SN 含非合格品(未检/不合格/待退),"+outboundCategoryLabel(req.OutboundCategory)+"出库仅允许合格品(请先完成质量检验/处置)")
return
}
}
for _, sn := range req.SnList {
// 条9 强校验:SN 须属于所选物料,且(填了任一库位层级时)所在货位须与所填一致
invRow, e := tx.Inventory.Query().
Where(inventory.SnModeEQ(snModeSN), inventory.SnCodeEQ(sn), inventory.MaterialCodeEQ(req.MaterialCode)).
Only(ctx0())
if e != nil {
fail(w, http.StatusBadRequest, "SN 不存在或不属于该物料: "+sn)
return
}
if locSpecified && !locationMatches(invRow, specZone, specShelf, specLayer, specPos) {
fail(w, http.StatusBadRequest, "SN/批次不在指定库位")
return
}
if pw == "" {
pw = invRow.ProductWorkNo
}
aff, err := tx.Inventory.Update().
Where(inventory.SnModeEQ(snModeSN), inventory.SnCodeEQ(sn),
inventory.MaterialCodeEQ(req.MaterialCode), inventory.StatusIn("在库", "锁定")).
SetStatus("出库").
SetNillableZoneCode(strPtr(req.ZoneCode)).
Save(ctx0())
if err != nil {
fail(w, http.StatusInternalServerError, "SN 出库失败: "+sn+" "+err.Error())
return
}
if aff == 0 {
fail(w, http.StatusBadRequest, "SN 不可出库(非在库/锁定): "+sn)
return
}
// 同步核销该 SN 的 ACTIVE 锁记录,消除残留锁
consumeLocksForSN(tx, []string{sn})
if _, err = tx.OutboundDetail.Create().
SetOutboundNo(outboundNo).
SetSnCode(sn).
SetMaterialCode(req.MaterialCode).
SetQuantity(1).
Save(ctx0()); err != nil {
fail(w, http.StatusInternalServerError, "创建出库明细失败: "+err.Error())
return
}
}
}
// 回写实际数量 + 装箱 SN 清单(JSON)
upd := tx.OutboundOrder.UpdateOneID(ob.ID).SetQuantity(actualQty)
if len(req.SnList) > 0 && req.BoxNo != "" {
upd.SetBoxSnList(snListJSON(req.SnList))
}
if _, err = upd.Save(ctx0()); err != nil {
fail(w, http.StatusInternalServerError, "更新出库单失败: "+err.Error())
return
}
// 回填工单号(从源库存取,五页带出展示/筛选)
if pw != "" {
if _, e := tx.OutboundOrder.UpdateOneID(ob.ID).SetNillableProductWorkNo(strPtr(pw)).Save(ctx0()); e != nil {
fail(w, http.StatusInternalServerError, "回填工单号失败: "+e.Error())
return
}
}
if err = tx.Commit(); err != nil {
fail(w, http.StatusInternalServerError, "提交事务失败: "+err.Error())
return
}
committed = true
typeLabel := "通用出库"
if outboundType == "project" {
typeLabel = "科技项目出库"
}
ctx.EventLog.Write(ctx0(), "outbound."+outboundType, r.Header.Get("X-Username"), "outbound", outboundNo,
typeLabel+" "+req.MaterialCode+" ×"+itoa(actualQty),
map[string]any{"qty": actualQty, "boxNo": req.BoxNo, "snCount": len(req.SnList)})
logx.Infof("%s outbound: material=%s qty=%d box=%s", outboundType, req.MaterialCode, actualQty, req.BoxNo)
ok(w, map[string]any{
"outboundNo": outboundNo,
"qty": actualQty,
"boxNo": req.BoxNo,
"type": outboundType,
})
}
}
// snListJSON 把 SN 列表序列化为 JSON 数组字符串
func snListJSON(sn []string) string {
b, err := json.Marshal(sn)
if err != nil {
return "[]"
}
return string(b)
}
// exportOutboundHandler 统一主表全部出库记录导出
// 不依赖前端分页,一次返回全部(可按类型/工单/物料/箱号/归属单号过滤),便于整表导出。
func exportOutboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
outboundType := r.URL.Query().Get("outboundType")
status := r.URL.Query().Get("status")
orderNo := r.URL.Query().Get("orderNo")
materialCode := r.URL.Query().Get("materialCode")
boxNo := r.URL.Query().Get("boxNo")
ownershipNo := r.URL.Query().Get("ownershipNo")
targetStation := r.URL.Query().Get("targetStation")
startDate, endDate, rerr := normalizeExportRange(r.URL.Query().Get("startDate"), r.URL.Query().Get("endDate"))
if rerr != nil {
fail(w, http.StatusBadRequest, rerr.Error())
return
}
startUnix, endUnix := exportRangeUnix(startDate, endDate)
q := ctx.EntClient.OutboundOrder.Query()
q = q.Where(outboundorder.CreatedAtGTE(startUnix), outboundorder.CreatedAtLTE(endUnix))
if outboundType != "" {
q = q.Where(outboundorder.OutboundTypeEQ(outboundType))
}
if status != "" {
q = q.Where(outboundorder.StatusEQ(status))
}
if orderNo != "" {
q = q.Where(outboundorder.OrderNoEqualFold(orderNo))
}
if materialCode != "" {
q = q.Where(outboundorder.MaterialCodeEqualFold(materialCode))
}
if boxNo != "" {
q = q.Where(outboundorder.BoxNoContainsFold(boxNo))
}
if ownershipNo != "" {
q = q.Where(outboundorder.OwnershipNoContainsFold(ownershipNo))
}
if targetStation != "" {
q = q.Where(outboundorder.TargetStationEQ(targetStation))
}
2026-09-03 18:13:59 +08:00
list, err := q.Order(ent.Desc("created_at"), ent.Desc("id")).All(ctx0())
if err != nil {
fail(w, http.StatusInternalServerError, err.Error())
return
}
type exportRow struct {
*ent.OutboundOrder
SnCodes string `json:"snCodes"`
Details []*ent.OutboundDetail `json:"details"`
}
rows := make([]exportRow, 0, len(list))
for _, ob := range list {
details, _ := ctx.EntClient.OutboundDetail.Query().
Where(outbounddetail.OutboundNoEQ(ob.OutboundNo)).
All(ctx0())
er := exportRow{OutboundOrder: ob, SnCodes: "", Details: details}
sns := make([]string, 0, len(details))
for _, d := range details {
if d.SnCode != "" {
sns = append(sns, d.SnCode)
}
}
if len(sns) > 0 {
er.SnCodes = strings.Join(sns, ",")
}
rows = append(rows, er)
}
// xlsx 导出
if r.URL.Query().Get("format") == "xlsx" {
headers := []string{"出库单号", "类型", "状态", "类别", "工单号", "归属单号", "图号", "物料名称", "库位", "数量", "目标工位", "目标接驳台", "备注", "装箱号", "合同号", "SN清单", "创建时间"}
matrix := make([][]any, 0, len(rows))
for _, row := range rows {
ob := row.OutboundOrder
matrix = append(matrix, []any{
ob.OutboundNo, outboundTypeLabel(ob.OutboundType), ob.Status, outboundCategoryLabel(ob.OutboundCategory), ob.OrderNo,
ob.OwnershipNo, ob.MaterialCode, ob.MaterialName,
locationText(ob.ZoneCode, ob.ShelfNo, ob.LayerNo, ob.PositionNo),
ob.Quantity, ob.TargetStation, ob.TargetDock, ob.Remark, ob.BoxNo, ob.ContractNo, row.SnCodes,
unixFmt(ob.CreatedAt),
})
}
sendExcel(w, xlsxFilename("出库管理"), headers, matrix)
return
}
ok(w, map[string]any{"total": len(rows), "list": rows})
}
}
2026-08-28 15:06:01 +08:00
func min(a, b int) int {
if a < b {
return a
}
return b
}
// isDuplicateOutboundNo 判定 DB 错误是否唯一约束冲突(出库单号 ux_outbound_orders_outbound_no)。
// 用于幂等键并发落库时把 500 转为幂等复用,避免重复扣减。
func isDuplicateOutboundNo(err error) bool {
if err == nil {
return false
}
msg := strings.ToLower(err.Error())
return strings.Contains(msg, "ux_outbound_orders_outbound_no") ||
strings.Contains(msg, "duplicate key") ||
strings.Contains(msg, "violates unique constraint")
}
// locationMatches 条9 库位强校验:按「用户显式填了的层级」逐级比对库存行货位,
// 未填的层级不参与比较(任一层级不一致即判定不在指定库位)。
func locationMatches(row *ent.Inventory, zone, shelf, layer, pos string) bool {
if zone != "" && row.ZoneCode != zone {
return false
}
if shelf != "" && row.ShelfNo != shelf {
return false
}
if layer != "" && row.LayerNo != layer {
return false
}
if pos != "" && row.PositionNo != pos {
return false
}
return true
}
// locationText 库位展示串。入库/出库/库存统一口径:`Z02 A架/3层/12位`,无内容返回空串。
// outboundLocationFallback 出库四级库位兜底(客户诉求 一.9「出库相同」)。
//
// 调用方(MES 备料自动出库、前端手工出库)可能只传了区域甚至什么都没传;
// 这里按「指定批次在库的实际货位 → 首个出库 SN 在库的实际货位」顺序,
// 把**缺失的层级**补全,使出库单、列表、导出都能留痕到具体货位(货架/层/位置号)。
// 只补空值、不覆盖调用方显式指定的值。
func outboundLocationFallback(ctx *svc.ServiceContext, batchNo string, snList []string,
zoneCode, shelfNo, layerNo, positionNo string) (string, string, string, string) {
if zoneCode != "" && shelfNo != "" && layerNo != "" && positionNo != "" {
return zoneCode, shelfNo, layerNo, positionNo
}
var src *ent.Inventory
if batchNo != "" {
src, _ = ctx.EntClient.Inventory.Query().
Where(inventory.SnModeEQ(snModeBatch), inventory.BatchNoEQ(batchNo)).Only(ctx0())
}
if src == nil && len(snList) > 0 {
src, _ = ctx.EntClient.Inventory.Query().
Where(inventory.SnModeEQ(snModeSN), inventory.SnCodeEQ(snList[0])).Only(ctx0())
}
if src == nil {
return zoneCode, shelfNo, layerNo, positionNo
}
if zoneCode == "" {
zoneCode = src.ZoneCode
}
if shelfNo == "" {
shelfNo = src.ShelfNo
}
if layerNo == "" {
layerNo = src.LayerNo
}
if positionNo == "" {
positionNo = src.PositionNo
}
return zoneCode, shelfNo, layerNo, positionNo
}
// locationText 库位显示文案(区域/货架/层/位置号)——列表与导出共用。
func locationText(zoneCode, shelfNo, layerNo, positionNo string) string {
parts := make([]string, 0, 3)
if shelfNo != "" {
parts = append(parts, shelfNo+"架")
}
if layerNo != "" {
parts = append(parts, layerNo+"层")
}
if positionNo != "" {
parts = append(parts, positionNo+"位")
}
loc := strings.Join(parts, "/")
if zoneCode == "" {
return loc
}
if loc == "" {
return zoneCode
}
return zoneCode + " " + loc
}
// outboundCategoryLabel 出库类别显示中文(客户诉求 L96-108:退料/样品/报废/发货/其他)
// outboundTypeLabel 出库类型中文(界面禁英文)
func outboundTypeLabel(v string) string {
switch v {
case "workorder":
return "备料出库"
case "refill":
return "补料出库"
case "general":
return "通用出库"
case "project":
return "科技项目出库"
default:
return "通用出库"
}
}
func outboundCategoryLabel(v string) string {
switch v {
case "return":
return "退料"
case "sample":
return "样品"
case "scrap":
return "报废"
case "deliver":
return "发货"
case "supplier_return":
return "退货"
case "call":
return "叫料配送"
case "other":
return "其他"
default:
return ""
}
}
// outboundBlocksUnqualified 出库质量门禁判定(U5,客户口径):
// 发货(deliver)/样品(sample)/其他(other) 及任何未知类别 → 拦截不合格/待退品(默认拦截,避免漏洞);
// 退货(supplier_return,退回供应商)/报废(scrap)/退料(return,工位退料) → 豁免(本身即在处置不合格品)。
func outboundBlocksUnqualified(category string) bool {
switch category {
case "supplier_return", "scrap", "return":
return false
default:
return true
}
}