库存商品

库存项目代表特定地点的资源实物库存余额。每个库存项目都追踪特定地点存在多少特定资源。

库存商品结构

库存商品清单 库存商品页面，显示不同站点当前库存余额

核心字段：- 资源 - 资源定义的引用（例如"Cat6网线"）- 位置 - 存储地点（仓库、车辆、人员）- 数量 - 当前存量/数量- 计量单位 - 计量单位（必须与资源支持的计量单位匹配）

元数据：- 批次/批号 - 可选的收货批次追踪- 有效期 - 适用于具有保质期的物料- 属性 - 用于自定义追踪的灵活JSON字段（损坏备注、供应商信息等）

你永远不要手动编辑卷——请创建事务操作。

资源："Cat6网线"（米）库存项目A：中央仓库500米库存项目B：现场12处12米库存项目C：约翰车辆内10米（个人场所）库存项目D：简车辆内25米（个人场所）

这使得：- 实现特定地点的库存可见性- 支持员工之间的点对点转移- 提供按地点设置的最低库存警报

**手动创建：**1. 导航至库存 → 库存商品2. 点击"添加库存商品"3. 选择资源和站点4. 通过收货交易（非直接入库）初始化库存量

**通过收据自动创建：**1. 在目标站点创建交易类型收据2. 若该资源与站点的组合不存在库存项目： - 自动创建库存项目 - 数量设置为收据金额3. 若库存项目已存在： - 数量增加收据金额

通过转移自动创建： 当扫描二维码提货时：- 源头库存减少（现有库存商品）- 在接收方个人站点创建新库存商品（若不存在）- 或增加接收方现有库存商品数量

实时库存：- 库存量随交易即时更新- 无缓存或延迟更新- 对二维码取货验证至关重要（必须掌握当前库存情况）

按站点筛选：- 查看中央仓库所有库存- 查看员工个人库存- 查看车辆库存- 跨站点搜索资源可用性

库存不足警报：- 在资源定义中设置最低库存水平- 当任何库存项目低于阈值时触发警报- 助力补货管理

**典型生命周期：**1. 入库 - 库存抵达仓库（入库交易）2. 暂存 - 计划分配（暂无交易，仅规划阶段）3. 提取 - 工人扫描二维码（将交易转移至个人站点） 4. 消耗 - 工人完成任务，提交报告（消耗交易）5. 归还 - 未用材料退回（交易转回仓库）

**零库存：**库存量为0的商品仍存在于数据库中：- 保留交易记录- 显示该资源曾由哪些站点持有- 可通过新收货进行补货

若资源设置了requiresProtection: true：- 不可直接转移库存物品- 必须创建带取货二维码的分配单- 扫描二维码验证授权- 交易记录扫描器身份及GPS位置

支持部分取货：- 任务请求10个单位- 仅剩5个可用→工人取走5个- 任务pickupRemaining更新- 补货后同一二维码可再次扫描

查看影响库存商品的所有交易：- 导航至库存商品详情视图- "交易记录"标签页显示： - 所有收货、转移、消耗、调整操作 - 操作执行者 - 时间与地点（转移操作包含GPS定位） - 数量变动（从→至）

这为合规性与对账提供了完整的审计追踪。

按站点类型分类：- 中央仓库 = 主要补给点- 现场中转站 = 工作区域附近的临时存储点- 个人站点（工人/车辆）= 可即时调用的移动库存

定期盘点：- 创建调整交易以修正差异- 包含原因字段（例如："2026-02-10 实物盘点"）- 对比交易记录以识别损失模式

减少人工调整：- 尽可能使用收据/转账/消耗记录- 调整应属例外情况，而非常规操作- 频繁调整表明流程存在问题（盗窃、报表错误）

计划而非预留：- 任务显示plannedStock（需求预测值）- 非硬性预留（其他员工仍可领取）- 优先级变更时可灵活调整- 实际分配在二维码扫描时完成