@@ -0,0 +1,257 @@
package handler
import (
"net/http"
"strings"
"bj_power_wms/ent"
"bj_power_wms/ent/inventory"
"bj_power_wms/ent/inventorylock"
"bj_power_wms/ent/outbounddetail"
"bj_power_wms/ent/outboundorder"
"bj_power_wms/internal/svc"
)
// voidOutboundHandler 出库单作废(2026-11-03 断头路补全,对齐入库作废 inbound_void):
// 人工手工出库(通用出库/科技项目出库)填错物料、批次、数量时的纠错闭环——
// 填写作废原因 → 按本单明细把库存原样回滚 → 单据标记作废(记录保留供追溯)。
//
// 适用范围:仅 outbound_type ∈ {general 通用出库, project 科技项目出库}。
// 备料出库(workorder)/补料出库(refill)/叫料出库(call) 与 MES 备料台账联动,
// 不提供作废——错发统一走「退库确认」逆向闭环(台账 returned_qty 回冲、叫料池额度回补),
// 两套纠错口径不混用,避免台账与叫料池账目失真。
//
// 回滚口径(与出库动作精确互逆):
// - 序列号=是(按 SN):按本单明细的 SN 把库存行「出库」恢复为「在库」(出库前是锁定的恢复为锁定);
// SN 全局唯一一码一物,只恢复本单的 SN。若该 SN 已不在「出库」状态(已被退库回冲等)拒绝,防止双重回冲。
// - 序列号=否(按批次):按本单明细数量加回批次库存行;批次行不存在(已被消耗清零删除)时拒绝并提示走退库。
//
// 安全门禁:已作废单拒绝重复操作;盘点冻结中的批次/SN 拒绝(盘点期间账实冻结)。
func voidOutboundHandler ( ctx * svc . ServiceContext ) http . HandlerFunc {
return func ( w http . ResponseWriter , r * http . Request ) {
var req struct {
OutboundNo string ` json:"outboundNo" `
Reason string ` json:"reason" `
}
if err := parseJSON ( r , & req ) ; err != nil {
fail ( w , http . StatusBadRequest , "参数错误" )
return
}
req . OutboundNo = strings . TrimSpace ( req . OutboundNo )
req . Reason = strings . TrimSpace ( req . Reason )
if req . OutboundNo == "" {
fail ( w , http . StatusBadRequest , "出库单号必填" )
return
}
if req . Reason == "" {
fail ( w , http . StatusBadRequest , "作废原因必填" )
return
}
ob , err := ctx . EntClient . OutboundOrder . Query ( ) .
Where ( outboundorder . OutboundNoEQ ( req . OutboundNo ) ) . Only ( ctx0 ( ) )
if err != nil {
fail ( w , http . StatusNotFound , "出库单不存在:" + req . OutboundNo )
return
}
if ob . Voided {
fail ( w , http . StatusConflict , "该出库单已作废,请勿重复操作" )
return
}
if ob . OutboundType != "general" && ob . OutboundType != "project" {
fail ( w , http . StatusConflict , "仅「通用出库」「科技项目出库」支持作废;备料/补料/叫料出库请走「退库确认」逆向冲正" )
return
}
details , err := ctx . EntClient . OutboundDetail . Query ( ) .
Where ( outbounddetail . OutboundNoEQ ( req . OutboundNo ) ) . All ( ctx0 ( ) )
if err != nil {
fail ( w , http . StatusInternalServerError , err . Error ( ) )
return
}
if len ( details ) == 0 {
fail ( w , http . StatusConflict , "该出库单无明细,无法回滚库存" )
return
}
// 盘点冻结守卫:作废要把库存加回/恢复,盘点冻结目标一律拦截
snList := make ( [ ] string , 0 , len ( details ) )
batchNo := ""
for _ , d := range details {
if d . SnCode != "" {
snList = append ( snList , d . SnCode )
} else if d . BatchNo != "" {
batchNo = d . BatchNo
}
}
if ! assertNotFrozenTargets ( ctx , w , batchNo , snList ) {
return
}
tx , err := ctx . EntClient . Tx ( ctx0 ( ) )
if err != nil {
fail ( w , http . StatusInternalServerError , "开启事务失败: " + err . Error ( ) )
return
}
committed := false
defer func ( ) {
if ! committed {
_ = tx . Rollback ( )
}
} ( )
restoredSN := 0
restoredQty := 0
if ob . SnMode == snModeSN {
// 序列号=是:逐个 SN 恢复(只恢复本单 SN 的库存行)
for _ , d := range details {
if d . SnCode == "" {
continue
}
inv , e := tx . Inventory . Query ( ) . Where ( inventory . SnCodeEQ ( d . SnCode ) ) . Only ( ctx0 ( ) )
if e != nil {
fail ( w , http . StatusConflict , "SN 库存行不存在,无法作废:" + d . SnCode )
return
}
if inv . Status != "出库" {
fail ( w , http . StatusConflict , "SN " + d . SnCode + " 当前状态为「" + inv . Status + "」(已被退库或后续处理),无法作废,请核对走退库流程" )
return
}
// 出库前若是锁定状态(lockedQty>0),恢复为「锁定」;否则恢复「在库」
upd := tx . Inventory . UpdateOneID ( inv . ID ) . SetStatus ( "在库" )
if inv . LockedQty > 0 {
upd = tx . Inventory . UpdateOneID ( inv . ID ) . SetStatus ( "锁定" )
}
if err := upd . Exec ( ctx0 ( ) ) ; err != nil {
fail ( w , http . StatusInternalServerError , "恢复 SN 库存失败: " + err . Error ( ) )
return
}
restoredSN ++
}
} else {
// 序列号=否:按本单明细数量加回批次库存行
for _ , d := range details {
if d . BatchNo == "" || d . Quantity <= 0 {
continue
}
inv , e := tx . Inventory . Query ( ) .
Where ( inventory . SnModeEQ ( snModeBatch ) , inventory . BatchNoEQ ( d . BatchNo ) ) . Only ( ctx0 ( ) )
if e != nil {
fail ( w , http . StatusConflict , "批次库存行不存在(该批次已被消耗清零),无法作废:" + d . BatchNo + ",请走「生产退不良」/「退库确认」冲正" )
return
}
if _ , err := tx . Inventory . UpdateOneID ( inv . ID ) . AddQuantity ( d . Quantity ) . Save ( ctx0 ( ) ) ; err != nil {
fail ( w , http . StatusInternalServerError , "回加批次库存失败: " + err . Error ( ) )
return
}
restoredQty += d . Quantity
}
}
if _ , err := tx . OutboundOrder . UpdateOneID ( ob . ID ) .
SetVoided ( true ) . SetVoidReason ( req . Reason ) .
SetNillableVoidedBy ( strPtr ( r . Header . Get ( "X-Username" ) ) ) .
SetVoidedAt ( timeNow ( ) . Unix ( ) ) .
Save ( ctx0 ( ) ) ; err != nil {
fail ( w , http . StatusInternalServerError , "标记作废失败: " + err . Error ( ) )
return
}
if err := tx . Commit ( ) ; err != nil {
fail ( w , http . StatusInternalServerError , "提交事务失败: " + err . Error ( ) )
return
}
committed = true
typeLabel := outboundTypeLabel ( ob . OutboundType )
ctx . EventLog . Write ( ctx0 ( ) , "outbound.void" , r . Header . Get ( "X-Username" ) , "outbound" , req . OutboundNo ,
"作废" + typeLabel + "单 " + req . OutboundNo + "( " + ob . MaterialCode + " × " + itoa ( ob . Quantity ) + "),原因:" + req . Reason , map [ string ] any {
"restoredSN" : restoredSN , "restoredQty" : restoredQty } )
ok ( w , map [ string ] any {
"outboundNo" : req . OutboundNo ,
"restoredSN" : restoredSN ,
"restoredQty" : restoredQty ,
} )
}
}
// markOutboundDeliveredHandler AGV 到位回写(2026-11-03 断头路补全):
// 出库单状态机定义「已出库 → 已送达(AGV 配送到位)」,但此前全库无写者(帮助文档与筛选下拉均引用该状态)。
// MES AGV 回调(任务结束=工件/料已到目标接驳台)凭出库单号调本内部接口置「已送达」。
// 幂等:已是「已送达」或已作废的单直接跳过,重复回调无害;best-effort,失败不阻断 MES 回调。
func markOutboundDeliveredHandler ( ctx * svc . ServiceContext ) http . HandlerFunc {
return func ( w http . ResponseWriter , r * http . Request ) {
var req struct {
OutboundNos [ ] string ` json:"outboundNos" `
}
if err := parseJSON ( r , & req ) ; err != nil {
fail ( w , http . StatusBadRequest , "参数错误" )
return
}
delivered := 0
for _ , no := range req . OutboundNos {
no = strings . TrimSpace ( no )
if no == "" {
continue
}
aff , err := ctx . EntClient . OutboundOrder . Update ( ) .
Where ( outboundorder . OutboundNoEQ ( no ) , outboundorder . StatusEQ ( "已出库" ) , outboundorder . VoidedEQ ( false ) ) .
SetStatus ( "已送达" ) . Save ( ctx0 ( ) )
if err == nil {
delivered += aff
}
}
if delivered > 0 {
ctx . EventLog . Write ( ctx0 ( ) , "outbound.delivered" , "AGV" , "outbound" , strings . Join ( req . OutboundNos , "," ) ,
"AGV 到位回写出库单已送达,共 " + itoa ( delivered ) + " 张" , nil )
}
ok ( w , map [ string ] any { "delivered" : delivered } )
}
}
// consumeLocksForBatch 出库核销批次锁记录(2026-11-03 断头路补全):
// 出库扣减 locked_qty 的同时,把该批次对应 ACTIVE 锁记录按 FIFO 递减,扣到 0 置 CONSUMED。
// 消除"锁创建后永不核销"的残留:此前 CONSUMED 状态全库 0 处使用,MES 锁库后货物出库,
// ACTIVE 锁记录永久残留(仅能靠 MES 显式 unlock 收口)。
func consumeLocksForBatch ( tx * ent . Tx , batchNo , materialCode string , qty int ) {
if qty <= 0 {
return
}
locks , err := tx . InventoryLock . Query ( ) .
Where ( inventorylock . TargetTypeEQ ( "BATCH" ) , inventorylock . TargetIDEQ ( batchNo ) ,
inventorylock . MaterialCodeEQ ( materialCode ) , inventorylock . StatusEQ ( "ACTIVE" ) ) .
Order ( ent . Asc ( inventorylock . FieldID ) ) . All ( ctx0 ( ) )
if err != nil {
return
}
remain := qty
for _ , l := range locks {
if remain <= 0 {
break
}
take := l . LockedQty
if take > remain {
take = remain
}
left := l . LockedQty - take
upd := tx . InventoryLock . UpdateOneID ( l . ID )
if left <= 0 {
upd = upd . SetLockedQty ( 0 ) . SetStatus ( "CONSUMED" )
} else {
upd = upd . SetLockedQty ( left )
}
_ , _ = upd . Save ( ctx0 ( ) )
remain -= take
}
}
// consumeLocksForSN 出库核销 SN 锁记录:SN 锁一码一量,出库即整条 CONSUMED。
func consumeLocksForSN ( tx * ent . Tx , sns [ ] string ) {
if len ( sns ) == 0 {
return
}
_ , _ = tx . InventoryLock . Update ( ) .
Where ( inventorylock . TargetTypeEQ ( "SN" ) , inventorylock . TargetIDIn ( sns ... ) ,
inventorylock . StatusEQ ( "ACTIVE" ) ) .
SetLockedQty ( 0 ) . SetStatus ( "CONSUMED" ) . Save ( ctx0 ( ) )
}