fix(inventory): 撤回/作废单据时释放预占库存,消除库存泄漏
问题
----
系统原本已有「完结」功能(出库/借库),但它只改状态、不释放预占:
approval.status = 4 # 已完结
db.session.commit() # ← 库存没还回去
申请阶段 reserve_for_items() 扣掉的 available_quantity 就此永久泄漏 ——
货被一张永不执行的作废单锁死,谁也领不走。
核查存量 23 张 status=4 的单,所幸均为预占改造前提交(items_json 无
stock_id),尚未造成实际损失。但缺陷本身是真实的。
改动(三个模块统一)
--------------------
出库 outbound_service.close_request
借库 borrow_service.mark_completed
· 调用 release_reserved(approval.get_items()) 按 items_json 原样归还;
· 明确「仅 status==1(已通过待执行)可撤回」—— 执行成功后
create_outbound_batch / execute_dispatch 会把 status 置为 3,
故该状态判断本身即执行守卫,已执行或已撤回的单都进不来;
· 返回消息带上释放条数,便于操作者确认。
报废 scrap_approval_service.withdraw(新增能力)
· 报废原先只有 approve/reject,没有撤回入口,补齐;
· 复用同一个 release_reserved():报废当前尚未接入预占,调用它会安全
跳过(无 reserved 标记),但将来报废接入预占时该段代码自动生效;
· 新增端点 POST /api/v1/scrap/request/<id>/withdraw(权限 scrap_apply)。
未采用按流水表二次校验:request_no(APR-OUT-…) 与 outbound_no(OUT-…)
格式不同、无关联字段,按单号比对是无效的,状态判断已足够。
实测
----
决定性用例(证明释放真实生效,非账面功夫):
A单预占5 → available=1
B单要5 → 400 拒绝(被A占住)
撤回A → available=6
B单再要5 → 200 成功,available=1 ★ 释放的库存真的可被复用
三模块:
出库 撤回后 4→10 完全恢复,stock 未变(货没动)
借库 撤回后 6→10 完全恢复
报废 撤回成功,重复撤回被正确拒绝
状态码说明:报废复用出库/借库已有的 4=已完结 作为「已撤回」,
而非引入 -1,避免同一系统出现两套编号(其 2 已被「已驳回」占用)。
This commit is contained in:
@ -194,6 +194,38 @@ class ScrapApprovalService:
|
||||
logger.info(f"[ScrapApproval] {req.request_no} 审批 {action} by {operator_id}")
|
||||
return req
|
||||
|
||||
# ------------------------------------------------------------------
|
||||
# 撤回 / 作废(已通过但未执行 → 4-已撤回)
|
||||
#
|
||||
# 报废模块当前**尚未接入库存预占**(提交时不锁库存,扣减发生在执行阶段),
|
||||
# 因此这里没有可释放的预占。仍显式调用 release_reserved():
|
||||
# · 对存量单据无害(无 reserved 标记会被跳过);
|
||||
# · 若将来报废接入预占,此处无需再改,自动生效。
|
||||
# 状态守卫「仅 status==1 可撤回」同时充当执行守卫:
|
||||
# 已执行(status=3)的单无法再次撤回。
|
||||
# ------------------------------------------------------------------
|
||||
@staticmethod
|
||||
def withdraw(request_id, operator_id):
|
||||
"""撤回已通过但尚未执行的报废申请单"""
|
||||
req = db.session.get(ScrapApproval, request_id)
|
||||
if not req:
|
||||
raise ValueError("报废申请不存在")
|
||||
if req.status != 1:
|
||||
status_map = {0: '待审批', 1: '已通过(待执行)', 2: '已驳回', 3: '已执行', 4: '已撤回'}
|
||||
raise ValueError(
|
||||
f"仅「已通过(待执行)」的报废申请可撤回 "
|
||||
f"(当前状态:{status_map.get(req.status, req.status)})"
|
||||
)
|
||||
|
||||
from app.services.inventory_reservation import release_reserved
|
||||
restored = release_reserved(req.get_items())
|
||||
|
||||
req.status = 4 # 4-已撤回
|
||||
req.reject_reason = '申请人撤回'
|
||||
db.session.commit()
|
||||
logger.info(f"[ScrapApproval] {req.request_no} 已撤回 by {operator_id},释放 {restored} 项")
|
||||
return req
|
||||
|
||||
# ------------------------------------------------------------------
|
||||
# 执行(按单报废:扣减实物库存 + 写报废流水)
|
||||
# ------------------------------------------------------------------
|
||||
|
||||
Reference in New Issue
Block a user