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:
yueli
2026-09-10 15:08:32 +08:00
parent 8c18586a94
commit 9925bf2b99
4 changed files with 110 additions and 15 deletions

View File

@ -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
# ------------------------------------------------------------------
# 执行(按单报废:扣减实物库存 + 写报废流水)
# ------------------------------------------------------------------