KCGL/inventory-backend at a8a3c823315253209744c3a1129296aea8d10ac7 - KCGL

Files

yueli a8a3c82331 fix(stock): 补行级防穿仓与入库改量下限，杜绝可用数变负

available_quantity 一旦为负，预占/释放/盘点的全部算术都会失真。此前有两处
缺口，本次一并堵上，使 available_quantity >= 0 成为不变量。

1) 执行阶段逐行扣减无下限校验（inventory_reservation.restore_then_deduct）

   物料级校验只保证「Σ实扫 ≤ Σ可用」这一总量关系，拦不住「总量守恒但单行
   穿仓」：同物料下 A 批可用 2、B 批可用 8，工人把 5 件全压在 A 批上，总量
   5 ≤ 10 通过，A 批却被扣成 -3。借库走 deduct_stock=False，连实物数校验都
   跳过，是裸扣。

   已实测复现：借库与出库路径均可把单行扣成 -3。

   校验放在 release_reserved() 之后，故不会误拒合法的换批次（物理覆盖）：
   释放后每行 available 已含本单预占，扫自己预占过的批次时 raw >= 0 保证
   必然放行；改扫其它批次时，该批次实时可用量就是它自己的上限。

2) 下调入库数量可把可用数压成负（buy/product/semi 三处 update_inbound）

   按 diff 同步增减 stock/available，但无任何下限检查。该批次若已有部分被
   预占/出库/借出，向下调整即产生负可用数。现在下调前校验可用数是否够扣。
   正常数据下 stock >= available 恒成立，故守住 available 同时守住 stock。

配套：三个 update_* 端点此前只捕获 Exception → 500，没有 ValueError 分支
（同文件的 delete_* 早就有）。补上 400 分支，使业务校验失败不再被记成
服务端故障。

验证（事务内执行并回滚，未落库）：跨批次穿仓被拦、合法换批次放行、全额执行
本单预占批次放行、下调击穿被拦（API 返回 400，三个端点一致）、上调不受影响、
真实借库单 52 行全额执行正常、全库无负可用数。

2026-09-11 10:34:15 +08:00