# 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 需要可扩展策略。 建议新增库存分配服务,例如: ```text 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 - 细粒度组织、角色、菜单、按钮权限