WMS 仓储管理

WMS 面向仓网、库存和入出库执行，目标是围绕仓库、库区、库位、物料、批次/序列号与库存状态，把收货、上架、库内移动、拣选、复核、发运和盘点形成可追踪的仓储闭环。

当前实施状态

WMS 已完成独立应用骨架、平台运行时、动态菜单、角色访问权限和仓储运营工作台。库存台账、入库、库内、出库与盘点执行仍在后续建设范围，当前页面展示的是实施路线，不代表已经形成真实库存。

建设范围

领域	当前状态	目标能力
应用底座	已完成	独立运行、平台装载、统一主题导航与角色访问
仓网基础	待接入	仓库、库区、库位、容器、物料和存储约束
库存台账	规划中	批次/序列号、状态、占用、冻结、可用量与不可变流水
入库执行	规划中	预约、收货、质检衔接、上架和退货入库
库内与出库	规划中	补货、移库、盘点、波次、拣选、复核、发运和退货
运营优化	规划中	库存预警、周转、库容、作业效率和策略优化

目标仓储流程

text

到货预约
  → 收货与数量交接
  → 质检衔接与上架
  → 库存形成
  → 补货 / 移库 / 盘点
  → 波次 / 拣选 / 复核
  → 发运与装车交接
  → 库存流水、批次和任务追溯

上线前准备

在 MDM 明确仓库、场所、存放位置、物料及其权威来源和身份映射。
建立仓库、库区、库位、容器和存储约束，区分可用、待检、冻结、不合格等库存状态。
定义入库、库内、出库、退货和盘点单据的状态机、数量规则与反向操作。
为收货、上架、移库、冻结、解冻、拣选、复核、发运和盘点调整分别配置权限。
用测试租户跑通一次入库、移库、出库和盘点，核对流水、余额、幂等和跨仓权限。

库存模型原则

库存余额是业务流水的汇总结果，不是可以任意编辑的主数据。

同一库存身份至少要明确租户、仓库、库位、物料、批次/序列号和库存状态。
现存量、占用量、冻结量、在途量和可用量必须定义一致的计算口径。
收货、上架、移库、领料、退料、拣选、发运和盘点差异都要形成可追溯流水。
重试和外部回调必须使用幂等键，避免重复增加或扣减库存。
负库存、跨仓移动、批次失效和状态转换由服务端约束，不能只靠前端提示。

与 MDM、MES、TMS 协作

MDM 提供仓库、场所、存放位置和物料的治理身份；WMS 维护库存状态与仓储作业事实。
MES 通过受控契约发起领料、退料、物料配送和成品入库，不能直接修改 WMS 余额。
TMS 与 WMS 在到货预约、收货交接、发运和装车节点交换明确单据与状态，不共享一套可随意修改的状态字段。
危废仓库等领域对象在身份关系明确前不能只按名称并入通用仓库或库位。

权限与安全

普通用户只能读取当前租户及授权仓库范围内的数据。
库存查询与业务写入分开授权，跨仓、冻结、盘点调整和反向操作应使用更细权限。
页面可见不代表后端授权，RLS、RPC、库存约束、事务和幂等规则是最终边界。
WMS 尚未实现的库存接口不得用前端模拟写入或直接改表替代。

常见问题

问题	检查
只能看到仓储工作台	当前版本处于实施准备阶段，业务页面尚未接入
找不到仓库、库位或物料	MDM 来源、映射、记录状态、租户和读取权限
可用量与现存量不一致	占用、冻结、待检、在途和未完成作业
作业重试后数量重复	幂等键、事务边界、回调去重和原单据状态
MES 完工后没有入库任务	MES 完工事件、物料批次、目标仓库和跨模块契约
TMS 发运状态不同步	复核、装车交接、发运事件、回调和双方状态映射