feat(outbound): 备选库位可见性,让「物理覆盖」不再盲扫

问题
----
预占会把货锁定在某个库位,但工人到现场可能进不去/找不到该库位,
需要改扫同物料的其它批次。后端执行端已支持按 base_id 校验、允许换批次,
但系统从不告诉他「还有哪些库位有货」—— 工人只能凭记忆或挨个翻。

后端:新增 GET /api/v1/outbound/alternatives
--------------------------------------------
  入参 base_id(必填)、source_table/stock_id(可选,用于标注推荐行)
  返回该物料全部可用库存行 + 合计可用量,推荐行置顶、其余按可用量降序。

为什么不复用 stock/list 或 bom-match-stock 的查询模式:
那两处按 stock_quantity > 0 过滤,会把「有货但已被别单全部预占」的库位
也列出来,工人跑过去才发现拿不到。实测库中有 14 行处于该状态。
本接口按 available_quantity > 0 过滤,只给真正能拿的库位。

前端:计划清单库位列加图标 + popover
------------------------------------
  [推荐] Y1/2/1  可用 5      ← 本单锁定行(来自 items_json 的 stock_id)
  [备选] Y2/3/4  可用 10
  [备选] Z1/1/1  可用 2

三处取舍:
  · trigger="click" 而非 hover —— 车间用扫码枪/触摸屏,hover 在触屏不可用
  · @show 时才发请求 —— 计划清单可能几十行,渲染即请求会打出一片并发
  · 附提示文案「现场取不到推荐库位时可直接扫备选库位条码出库」

注:历史单据的 items_json 无 stock_id,此时所有库位显示为「备选」
(不影响可用性,仅少了推荐标记);预占改造后新提交的单可正确标注。

实测:造 3 批次 Y1/2/1(5) Y2/3/4(10) Z1/1/1(2),预占首个后其 available=0,
接口正确排除该库位,返回两个备选、合计可用 12。
This commit is contained in:
yueli
2026-09-10 14:59:17 +08:00
parent b57c21a4cd
commit 209b29c10f
3 changed files with 231 additions and 4 deletions

View File

@ -170,4 +170,28 @@ export function bomMatchStock(payload: BomRequirement[] | { requirements: BomReq
method: 'post',
data
})
}
}
/**
* 备选库位查询 —— 为「物理覆盖」提供可见性
*
* 申请单把货预占在某个库位后,工人现场可能进不去该库位,需要改扫同物料的
* 其它批次。本接口按 available_quantity > 0 返回**真正能拿**的库位,
* 并标注哪一条是本单锁定的推荐行。
*
* @param baseId 物料 ID(申请明细里的 base_id)
* @param locked 本单锁定的批次(用于标注「推荐」),可选
*/
export function getStockAlternatives(
baseId: number,
locked?: { stock_id?: number; source_table?: string }
) {
return request({
url: '/v1/outbound/alternatives',
method: 'get',
params: {
base_id: baseId,
stock_id: locked?.stock_id,
source_table: locked?.source_table
}
})
}