WMSlite/docs/DEVELOPMENT_PLAN.md

239 lines
7.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
- 细粒度组织、角色、菜单、按钮权限