Jungle 仓储业务流程
Jungle 是一个仓库管理系统，这里单独整理它的核心业务流程和库存模型，方便独立查阅与复用。
单据状态
出库单状态
- PENDING（待处理）- 创建后的初始状态，待拣货出库
- PROCESSING（处理中）- 可选中间状态，目前暂未在业务流程中使用
- COMPLETED（已完成）- 拣货出库确认完成，已扣减真实库存
- CANCELLED（已取消）- 出库单被取消，不再执行出库
采购单状态
- CONFIRMED（已确认）- 创建后的初始状态
- PARTIALLY_RECEIVED（部分收货）- 部分货物已收货
- COMPLETED（已完成）- 全部收货完成
- CANCELLED（已取消）- 采购单被取消
销售订单状态（OrderStatus）
- CREATED（待支付）- 已创建，待支付
- CONFIRMED（待发货）- 已支付，已生成出库单，处于拣货、打包、待发货阶段
- SHIPPED（已发货）- 已在 Bush 填写运单号，已发货
- COMPLETED（已完成）- 运单已签收，订单完成
- CANCELLED（已取消）- 已取消
流程总结
采购流程【毛料/成品】
- 创建采购单
- 供应商送货
- 收货质检入库
上架流程【毛料】
- 成品加工完成
- 成品入库上架并自动扣减毛料库存
- 商品库存更新
销售流程【成品】
- 订单
- 拣货出库
- 发货
采购流程 SOP
毛料采购：
- 毛料准备（Bush）
- 仓储中心 → 毛料列表 → 新建毛料
- 仓库准备（Bush）
- 仓储中心 → 仓库管理 → 新建仓库
- 采购单（Bush）
- 仓储中心 → 采购单 → 新建采购单
- 毛料收货质检入库（Vine）
- 首页 → 采购入库任务 → 去收货（或扫描采购单二维码直达收货界面）→ 质检 → 确认收货
上架流程 SOP
- 商品准备（Bush）
- 运营中心 → 分类管理 → 新建分类并启用
- 运营中心 → 商品管理 → 新建商品 → 编辑商品 → 创建配方
- 库位准备（Bush）
- 仓储中心 → 库位管理 → 新建库位
- 成品完工入库（Vine）
- 首页 → 成品完工入库 → 入库上架
销售流程 SOP
- 订单生成（Florist）
- Category → 下单 → 支付
- 出库单拣货出库（Vine）
- 首页 → 拣货出库 → 确认出库
- 订单发货（Bush）
- 运营中心 → 订单列表 → 订单详情 → 发货
- 订单完成（Bush 模拟）
- 运营中心 → 订单列表 → 订单详情 → 签收
库存模型
库存概念
真实库存（On‑hand/Physical）（quantity）
- 仓里实际有多少件在库位里
- 只在入库确认、出库确认、退货入库这些真实物理移动时变化
预留库存（Reserved）（reservedQuantity）
- 理解为一个 Promise，已经承诺给某些订单的量
- 扮演角色：把已经卖掉但还没拣货的那部分量，从真实库存中逻辑隔离出来，解耦客服购买和真实拣货出库这两种量的逻辑关联
- 有了这一中间层概念，就可以很清晰地回答：
- 当前仓库有多少库存
- 已经卖掉了多少货，还能卖多少货
- 无需再到处聚合计算库存（订单、出库单等）
- 变化时机：
- 订单确认（支付）→ 增加（可售库存到预留库存）
- 出库单确认（拣货出库）→ 减少（预留库存到真实库存）
- 订单取消 → 减少（预留库存到可售库存）
可售库存（Available）（availableStock）
- 对外库存口径，用于对外展示可下单数量
在途库存（In‑transit）
- 暂未实现
冻结库存（On‑hold）
- 暂未实现
库存扣减
- 可售库存扣减：订单确认（支付完成）
- 真实库存扣减：出库确认（拣货出库）
库存单位
所有库存按基础单位计算，结合单位换算使用。
库存容量
允许容量不精确，原因包括：
- 形状、体积不规则：花苞状态、叶片状态、枝条状态不同
- 保质期短，周转速度快
- 允许混放混养（仅做供应商/批次限制）