库存管理精度与唯一粒度¶
状态：关键业务键已取得用户确认；其余精度模式与实现待核验。旧版规划书的粒度设计不得直接覆盖当前定义。 本页覆盖 P3（库存/余额选择） 与 P8（管理精度/采集） 的共享语义。写法见页面数据字典规范。
被引用锚点： 余额业务键 · 选择库存余额须写清什么 · 现场采集与精度 · 详情联查注意
本页解决什么问题¶
「什么算同一笔库存」决定余额是否合并、扫码采什么、盘点对不对得上、追溯会不会串行。本页给出 当前已确认的余额业务键，以及业务页写库存选择器 / 现场采集时必须说清的内容。
读完应能判断：查余额或写选择器时要带齐哪些维度；缺采集会导致什么风险；联查事务时为何不能只按物料过滤。挂接时序见库存数据挂接模型。
如何使用本页¶
| 你的目的 | 建议做法 |
|---|---|
| 理解「同一笔库存」由什么组成 | 读「当前已确认的余额业务键」 |
| 写业务页时引用 | P3 选择器按第 3 节写清粒度与可用量；P8 采集按第 4 节；通例可链选择器惯例 |
| 排障时对照 | 「有数却对不上」先核业务键是否带齐；详情联查注意 GAP-022 |
| 验收精度 | 禁止只写「弹窗选库存」；旧规划书多模式不得覆盖本页已确认键 |
1. 设计目的¶
库存管理精度决定「什么被视为同一笔库存」，进而影响库存余额唯一性、事务汇总、扫码、包装、盘点和追溯。
2. 当前已确认的余额业务键¶
当前确认的库存余额业务键由以下维度组成：
| 维度（业务名） | 在唯一粒度中的角色 |
|---|---|
| 物料 | 区分不同物料 |
| 批次 | 区分批属性 |
| 托盘号 | 区分托盘 |
| 包装号 | 区分包装 |
| 库存状态 | 区分可用/质检/冻结等状态口径 |
| 库位 | 区分存放地点 |
flowchart TB
KEY["库存余额业务键"]
KEY --> D1["物料"]
KEY --> D2["批次"]
KEY --> D3["托盘号"]
KEY --> D4["包装号"]
KEY --> D5["库存状态"]
KEY --> D6["库位"]
KEY -.->|DDL 等价唯一约束：GAP-005 待核验| DB["数据库约束"]
差距标记：该业务键已确认，但数据库是否存在等价的组合唯一约束仍待技术核验（
GAP-005）。
3. 选择库存余额时必须写清什么（P3）¶
业务页的选择器可选范围至少回答：
| 必须说明 | 示例问法 |
|---|---|
| 过滤粒度 | 按物料？是否还按批次/托盘/包装/库位/库存状态？ |
| 可用量口径 | 可用 = 余额 − 预留/预期？是否含在途？❓ 各业务可能不同 |
| 选中后锁定 | 是否锁定库位、批次、包装、数量上限？ |
| 选不到原因 | 无余额、状态不符、库位不在范围、权限外、粒度维度未采集 |
禁止只写「弹窗选择库存」。通例见通用选择器过滤惯例。
4. 现场采集与精度（P8）¶
| 维度 | 何时必须采集 | 缺失时的业务风险 |
|---|---|---|
| 包装 / 批次 / 托盘 / 库位 / 库存状态 | 物料管理精度或任务配置要求时 | 无法完成收发、或入账粒度不足导致追溯混淆 |
| 数量 | 始终 | 无法形成库存事务与余额更新 |
采集入口可能是 Web 或 PDA；具体开关以任务/业务类型配置为准（见采购收货等业务页）。
5. 详情联查注意¶
余额详情联查库存事务时，若过滤条件未覆盖完整业务键，可能混入其它托盘/状态/库位的事务（GAP-022）。培训与排查应以完整粒度条件为准。
6. 当前边界¶
旧版规划书曾按数量、批次、包装和唯一码区分不同管理精度。当前系统是否支持这些模式、各模式是否切换，以及其与上述余额业务键的关系，均须依据 dev 基线核验。
自检或验证点¶
- 业务页库存选择器是否写清过滤粒度与可用量口径？
- 现场必采维度是否与任务/业务类型配置对应，并说明缺失风险？
- 联查/培训是否强调完整业务键，避免只按物料混查（
GAP-022）？ - 是否误用旧规划书精度模式覆盖本页已确认业务键？
7. 待确认事项¶
| 编号 | 待确认内容 |
|---|---|
| INV-GRAN-01 | 库存余额、库存事务、移动日志、预计入/出之间的主键和关联键。 |
| INV-GRAN-02 | 批次、包装、托盘、器具、库位和库存状态的必填及唯一规则。 |
| INV-GRAN-03 | 同一库存的并发更新、负库存、冻结和状态转换规则。 |
| INV-GRAN-04 | 盘点、调整、拆并包、回收件等特殊动作对库存粒度的影响。 |
| INV-GRAN-05 | 各业务「可用量」是否扣减预计出/预留的统一口径。 |