Files
bj_power/bj_power_wms/internal/handler/reinspect.go
T
SunYF 8be6e03a15 docs: 统一修正全项目“SN管理”相关术语为“序列号”
本次 commit 统一修正了全项目范围内关于 SN 管理的术语表述,将原“SN管理”、“序列号件”、“批次件”等表述调整为“序列号”、“序列号=是”、“序列号=否”,同时同步更新了相关文档、代码注释、前端提示文本、数据库 schema 注释、API 文档等,确保全链路术语统一,消除理解歧义。
2026-10-10 15:58:59 +08:00

230 lines
7.9 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 handler
import (
"fmt"
"net/http"
"bj_power_wms/ent"
"bj_power_wms/internal/svc"
)
// createSupplierReturnOutbound 为「在库处置·退货 / 复检不合格转退货」自动生成退供应商出库单并真实扣减库存,
// 使退货一步闭环:质量置待退 + 实物出库 + 库存减少 + 留痕,全部落在同一事务内。
// 调用方须已在 tx 中;inv 为待退货的库存行(整行退)。
func createSupplierReturnOutbound(ctx *svc.ServiceContext, tx *ent.Tx, inv *ent.Inventory, remark, operator string) (string, error) {
outboundNo, err := nextDailyNo(ctx, "OB")
if err != nil {
return "", fmt.Errorf("生成出库单号失败: %w", err)
}
if err = validateUniqueNo(ctx, "OB", outboundNo); err != nil {
return "", err
}
if _, err = tx.OutboundOrder.Create().
SetOutboundNo(outboundNo).
SetOutboundType("general").
SetStatus("已出库").
SetNillableOutboundCategory(strPtr("supplier_return")).
SetMaterialCode(inv.MaterialCode).
SetManageMode(inv.ManageMode).
SetSnMode(inv.SnMode).
SetNillableBatchNo(strPtr(inv.BatchNo)).
SetNillableZoneCode(strPtr(inv.ZoneCode)).
SetQuantity(inv.Quantity).
SetNillableOperator(strPtr(operator)).
SetNillableRemark(strPtr(remark)).
Save(ctx0()); err != nil {
return "", fmt.Errorf("创建退供应商出库单失败: %w", err)
}
if inv.SnMode == snModeSN {
// 序列号=是 SN:库存行置「出库」,出库明细记 SN
if _, err = tx.Inventory.UpdateOneID(inv.ID).SetStatus("出库").Save(ctx0()); err != nil {
return "", err
}
if _, err = tx.OutboundDetail.Create().
SetOutboundNo(outboundNo).SetSnCode(inv.SnCode).
SetMaterialCode(inv.MaterialCode).SetQuantity(1).Save(ctx0()); err != nil {
return "", err
}
} else {
// 序列号=否:扣减数量(含已锁定量),出库明细记批次
if _, err = tx.Inventory.UpdateOneID(inv.ID).
AddQuantity(-inv.Quantity).AddLockedQty(-min(inv.LockedQty, inv.Quantity)).Save(ctx0()); err != nil {
return "", err
}
if _, err = tx.OutboundDetail.Create().
SetOutboundNo(outboundNo).SetNillableBatchNo(strPtr(inv.BatchNo)).
SetMaterialCode(inv.MaterialCode).SetQuantity(inv.Quantity).Save(ctx0()); err != nil {
return "", err
}
}
return outboundNo, nil
}
// reinspectHandler 复检(换修闭环):针对「在库 + 不合格」的库存行重新判定,闭合换修 / 不合格处置的后续。
// POST /api/inspection/reinspect
// body: { inventoryId, result(pass/fail), disposalType(RETURN|SCRAP,仅 fail 时生效), returnTrackingNo, remark, operator }
//
// pass → 质量置「合格」,回可用(换修 / 隔离品修复后重新上线)
// fail + RETURN → 质量置「待退」+ 自动退供应商出库(与 inventoryDisposeHandler 退货同闭环)
// fail + SCRAP → 质量「不合格」+ 生命周期「报废」,退出可用
//
// 全程生成复检留痕检验记录(status 与结果一致),并写事件日志。
func reinspectHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req struct {
InventoryID int `json:"inventoryId"`
Result string `json:"result"`
DisposalType string `json:"disposalType"`
ReturnTrackingNo string `json:"returnTrackingNo"`
Remark string `json:"remark"`
Operator string `json:"operator"`
}
if err := parseJSON(r, &req); err != nil || req.InventoryID <= 0 {
fail(w, http.StatusBadRequest, "参数错误:inventoryId 必填")
return
}
if req.Result != "pass" && req.Result != "fail" {
fail(w, http.StatusBadRequest, "复检结果必填(pass/fail)")
return
}
inv, err := ctx.EntClient.Inventory.Get(ctx0(), req.InventoryID)
if err != nil {
fail(w, http.StatusNotFound, "库存行不存在")
return
}
if inv.Status != "在库" {
fail(w, http.StatusBadRequest, "仅「在库」库存行可复检,当前状态:"+inv.Status)
return
}
if inv.QualityStatus != "不合格" {
fail(w, http.StatusBadRequest, "仅「不合格」库存行可复检(合格/待退/未检无需复检),当前质量状态:"+inv.QualityStatus)
return
}
if req.Result == "fail" {
dt := disposalTypeOrNone(req.DisposalType)
if dt != "RETURN" && dt != "SCRAP" {
fail(w, http.StatusBadRequest, "复检不合格时必须选择处置方式(退货/报废)")
return
}
if dt == "RETURN" && req.ReturnTrackingNo == "" {
fail(w, http.StatusBadRequest, "退货处置必须填写退货运单号")
return
}
}
operator := r.Header.Get("X-Username")
if operator == "" {
operator = req.Operator
}
tx, err := ctx.EntClient.Tx(ctx0())
if err != nil {
fail(w, http.StatusInternalServerError, "开启事务失败: "+err.Error())
return
}
committed := false
defer func() {
if !committed {
_ = tx.Rollback()
}
}()
var recStatus, recDisposal, targetQuality string
switch req.Result {
case "pass":
recStatus = "合格"
recDisposal = ""
targetQuality = "合格"
case "fail":
dt := disposalTypeOrNone(req.DisposalType)
recStatus = "不合格"
recDisposal = dt
if dt == "RETURN" {
targetQuality = "待退"
} else {
targetQuality = "不合格"
}
}
if err = createReinspectTraceRecord(tx, inv, recStatus, recDisposal, req.Remark, operator); err != nil {
fail(w, http.StatusInternalServerError, "创建复检留痕记录失败: "+err.Error())
return
}
upd := tx.Inventory.UpdateOneID(inv.ID)
switch targetQuality {
case "合格":
upd = upd.SetQualityStatus("合格")
case "待退":
upd = upd.SetQualityStatus("待退")
default:
upd = upd.SetQualityStatus("不合格")
}
if req.Result == "fail" && disposalTypeOrNone(req.DisposalType) == "SCRAP" {
upd = upd.SetStatus("报废")
}
if _, err = upd.Save(ctx0()); err != nil {
fail(w, http.StatusInternalServerError, "更新库存状态失败: "+err.Error())
return
}
// 复检不合格转退货:自动退供应商出库(闭环)
var outboundNo string
if req.Result == "fail" && disposalTypeOrNone(req.DisposalType) == "RETURN" {
outboundNo, err = createSupplierReturnOutbound(ctx, tx, inv, req.Remark, operator)
if err != nil {
fail(w, http.StatusInternalServerError, "自动退供应商出库失败: "+err.Error())
return
}
}
if err = tx.Commit(); err != nil {
fail(w, http.StatusInternalServerError, "提交事务失败: "+err.Error())
return
}
committed = true
targetId := inv.BatchNo
if inv.SnMode == snModeSN {
targetId = inv.SnCode
}
ctx.EventLog.Write(ctx0(), "inspection.reinspect", operator, "inventory", targetId,
"复检 "+targetId+" → "+req.Result, map[string]any{"inventoryId": inv.ID, "result": req.Result, "outboundNo": outboundNo})
ok(w, map[string]any{"inventoryId": inv.ID, "result": req.Result, "outboundNo": outboundNo})
}
}
// createReinspectTraceRecord 复检留痕:生成一条与复检结果一致的检验记录
// (合格→合格记录;不合格→不合格记录并带处置方式),便于与来料检 / 在库处置记录区分。
func createReinspectTraceRecord(tx *ent.Tx, inv *ent.Inventory, status, disposal, remark, operator string) error {
targetType := "BATCH"
targetId := inv.BatchNo
qty := inv.Quantity
if inv.SnMode == snModeSN {
targetType = "SN"
targetId = inv.SnCode
qty = 1
}
if qty <= 0 {
qty = 1
}
passQty := 0
rejectQty := qty
if status == "合格" {
passQty = qty
rejectQty = 0
}
b := tx.InspectionRecord.Create().
SetTargetType(targetType).
SetTargetID(targetId).
SetMaterialCode(inv.MaterialCode).
SetNillableMaterialName(strPtr(inv.MaterialName)).
SetStatus(status).
SetInspectQty(qty).
SetPassQty(passQty).
SetRejectQty(rejectQty).
SetNillableInspector(strPtr(operator)).
SetNillableRemark(strPtr("复检留痕 " + remark))
if disposal != "" {
b = b.SetNillableDisposalType(strPtr(disposal))
}
_, err := b.Save(ctx0())
return err
}