WMSlite/docs/DEVELOPMENT_PLAN.md

7.8 KiB
Raw Permalink Blame History

WmsLite 开发路线

本文档记录 WmsLite 从当前轻量 WMS 核心闭环,演进到中小型多货主标准 WMS 核心系统的后续开发计划。

目标定位

短期目标:从“基础库存与单据系统”升级为“可支撑真实仓库基础作业的标准 WMS 核心底座”。

完成本阶段后,系统应达到约 L3 级 WMS 核心能力:

等级 标准 说明
L1 库存台账系统 有物料、库位、库存余额、流水,能手工出入库
L2 基础 WMS 有标准入库、出库、移库、盘点流程,有库存预占和状态流转
L3 标准 WMS 核心 有任务化作业、批次效期、策略分配、异常冲正、容器/LPN
L4 行业化 WMS 支持电商、医药、冷链、制造、3PL 等行业特性
L5 高级仓储执行平台 波次优化、路径优化、自动化设备、RF/PDA、计费、接口平台、BI

8 项后端核心改造

当前进展

  • 已完成第一版出库库存分配:出库明细可只表达仓库、库区、物料和数量,系统在转待拣时自动按可用库存 FIFO 分配。
  • 已完成第一版拣货任务:出库转待拣时生成 outbound_pick_task,确认出库时按任务扣减库存并标记已拣。
  • 已保留兼容能力:出库明细填写指定库位时,只从该库位分配库存。
  • 已补齐出库任务闭环第一阶段:拣货任务支持单任务确认,确认出库前要求任务已拣;取消待拣/已拣出库单会释放预占库存并取消任务。
  • 已支持入库、出库先创建 Draft 单头,再在单据详情中追加明细。
  • 已调整出库物料单位处理:前端不再要求填写单位,后端按物料主数据单位自动写入并校验不一致输入。
  • 已完成前端作业体验第一轮整理:首页作业工作台、单据状态标签、详情概要、顶部工作区标签栏和首页固定标签。

1. 入库流程标准化

当前入库流程接近“创建入库单后直接按行确认收货”。标准 WMS 需要拆分更细的作业阶段。

建议演进为:

  • 入库预约或到货登记
  • 收货确认
  • 质检,可配置启用
  • 上架任务生成
  • 上架确认
  • 入库完成

关键目标:

  • 入库确认不应总是直接进入最终库位。
  • 支持收货暂存区。
  • 支持后续扩展质检、拒收、部分收货、超收、短收。

2. 出库流程任务化

当前出库可以完成预占和确认扣减,但仍偏单据层。标准 WMS 需要引入任务层。

建议演进为:

  • 出库单创建
  • 库存分配或预占
  • 拣货任务生成
  • 拣货确认
  • 复核,可后续扩展
  • 打包,可后续扩展
  • 发运确认
  • 库存扣减

关键目标:

  • 单据负责业务意图。
  • 任务负责仓内执行。
  • 出库确认前应能追踪每个拣货任务的执行状态。

3. 库存分配策略抽象

当前库存分配逻辑不宜继续写死在出库服务中。多行业 WMS 需要可扩展策略。

建议新增库存分配服务,例如:

InventoryAllocationService

优先支持策略:

  • FIFO,先进先出
  • FEFO,近效期优先
  • 指定批次
  • 指定库区或库位
  • 可用库存优先,排除冻结、待出、不合格库存
  • 整箱优先或拆零优先

关键目标:

  • 出库单只表达需求。
  • 分配服务决定从哪些库存行、哪些库位扣减或预占。
  • 策略可配置、可替换、可测试。

4. 移库流程分层

当前移库更接近即时从 A 扣到 B 加。标准 WMS 需要支持计划移库和任务移库。

建议演进为:

  • 移库单创建
  • 移库任务生成
  • 来源库位下架确认
  • 在途库存或任务占用
  • 目标库位上架确认
  • 移库完成

关键目标:

  • 支持移库中断、取消和异常处理。
  • 支持下架完成但尚未上架的中间状态。
  • 支持按任务追踪操作人、时间、来源和目标。

5. 库存维度增强

当前库存维度主要是仓库、库区、分区、库位、物料、容器。多行业标准 WMS 需要更完整的库存属性。

建议补充:

  • 批次号
  • 生产日期
  • 失效日期
  • 质量状态:合格、待检、不合格、冻结
  • 序列号,适用于 3C、设备、高价值品
  • 包装单位换算:箱、包、件、托
  • 供应商批次
  • 客户批次
  • 货主 SKU 与平台 SKU 映射

关键目标:

  • 库存唯一键需要重新设计,不能只依赖物料和库位。
  • 库存流水必须保留完整库存属性快照。
  • 出库分配策略要能读取批次、效期、质量状态。

6. 容器/LPN 体系增强

当前系统已有 Container,但还不是完整 LPN 或托盘管理体系。

建议增强为:

  • LPN 编码管理
  • LPN 与物料、批次、数量绑定
  • 整托移动
  • 托盘拆分
  • 托盘合并
  • 容器状态管理
  • 容器当前位置
  • 单 SKU 容器和混 SKU 容器规则

关键目标:

  • 支持按容器移动库存。
  • 支持整托入库、整托出库、整托移库。
  • 容器变更必须写库存流水或容器流水。

7. 异常、撤销与冲正机制

标准 WMS 必须支持业务纠错,不能只做正向流程。

建议补充:

  • 入库确认后撤销
  • 出库预占释放
  • 出库确认冲正
  • 拣货短拣
  • 移库任务取消
  • 移库中断恢复
  • 库存调整审批,可后续扩展
  • 库存流水冲正
  • 单据取消释放占用
  • 并发确认防重复扣减

关键目标:

  • 历史流水不可物理删除。
  • 错误库存变动通过冲正流水修复。
  • 单据状态流转必须具备幂等和并发保护。

8. 构建检查与人工验收

按当前项目约定,本轮后续开发不新增自动化测试建设任务。每阶段完成后使用构建检查和人工业务场景验收兜底。

固定检查:

  • 后端运行 dotnet build。
  • 前端运行 pnpm run typecheck、pnpm run build、pnpm run lint。
  • 核心业务通过人工场景验收,重点覆盖库存数量、单据状态、任务状态和库存流水是否一致。

优先人工验收范围:

  • 入库单可先建 Draft 单头,再追加明细并确认入库。
  • 出库单可先建 Draft 单头,再追加明细并转待拣。
  • 出库转待拣后生成拣货任务,任务确认后才能确认出库。
  • 库存不足时出库转待拣失败,库存不被部分污染。
  • 取消待拣出库单后释放预占库存。
  • 重复点击待拣、确认拣货、确认出库不会重复扣减库存。
  • 左上角图标进入首页时不会新增“页面”标签。

建议实施顺序

  1. 稳固当前出库任务化闭环,继续补齐幂等、异常原因和状态限制。
  2. 改造入库流程,引入收货暂存和上架任务。
  3. 改造移库流程,引入移库任务和在途状态。
  4. 扩展库存维度,加入批次、效期、质量状态。
  5. 增强容器/LPN 能力。
  6. 补撤销、冲正、异常恢复和并发保护。
  7. 整理前端作业体验,继续统一单据详情、任务视图和流水视图。
  8. 完善部署说明、业务流程文档和阶段人工验收清单。

阶段完成标准

本阶段完成后,系统应具备:

  • 多货主、多仓、多库区、多库位基础能力
  • 入库、出库、移库、盘点标准闭环
  • 库存预占、释放、扣减、调整、冻结、冲正
  • 基础批次、效期、质量状态管理
  • 基础任务化作业:上架、拣货、移库
  • 基础库存分配策略:FIFO、FEFO、库区优先级
  • 初级容器/LPN 管理
  • 可追溯库存流水
  • 每阶段构建检查与人工验收记录

尚未覆盖的高级能力

以下能力属于后续 L4/L5 阶段,不纳入本阶段必做范围:

  • RF/PDA 作业端
  • 波次策略和拣货路径优化
  • 深度复核、打包、称重、发运交接
  • 自动化设备接口
  • 3PL 计费
  • OMS、ERP、TMS 对接
  • 医药 GSP、冷链温控、危化品等行业合规模块
  • 高级报表、BI、运营 KPI
  • 细粒度组织、角色、菜单、按钮权限