库存快照（Canonical 实体）

定义

某个 SKU 在某个仓储位置、在某个时间点上的一组数量；它是快照而不是流水。

说明

本实体没有状态机（CM-D3），只有数量与采样时刻。四个数量字段刻意分开：可售、已占用、实物在库、在途，各自回答不同的问题。

关联：指向 canonical.sku。仓位只存标识不建实体——canonical.warehouse 在 v0.1 不做。

snapshot_at 是本实体的语义前提，没有时间点的数量无意义。available_qty 与 on_hand_qty 的口径差异是 WMS 集成最常见的误解来源（CM §7 R-11），映射时必须明确对应哪一个。