完善出库闭环和前端作业体验

This commit is contained in:
zhougf committed 2026-06-03 23:25:41 +08:00
1 parent 3c6dfda5e5
commit ce0fd7ec52
21 files changed
+1495 -261

No files matched your search

+27 -25
View File
@@ -23,6 +23,10 @@
- 已完成第一版出库库存分配:出库明细可只表达仓库、库区、物料和数量,系统在转待拣时自动按可用库存 FIFO 分配。
- 已完成第一版拣货任务:出库转待拣时生成 `outbound_pick_task`,确认出库时按任务扣减库存并标记已拣。
- 已保留兼容能力:出库明细填写指定库位时,只从该库位分配库存。
- 已补齐出库任务闭环第一阶段:拣货任务支持单任务确认,确认出库前要求任务已拣;取消待拣/已拣出库单会释放预占库存并取消任务。
- 已支持入库、出库先创建 Draft 单头,再在单据详情中追加明细。
- 已调整出库物料单位处理:前端不再要求填写单位,后端按物料主数据单位自动写入并校验不一致输入。
- 已完成前端作业体验第一轮整理:首页作业工作台、单据状态标签、详情概要、顶部工作区标签栏和首页固定标签。
### 1. 入库流程标准化
@@ -174,38 +178,36 @@ InventoryAllocationService
- 错误库存变动通过冲正流水修复。
- 单据状态流转必须具备幂等和并发保护。
### 8. 后端测试体系补强
### 8. 构建检查与人工验收
已新增库存移动服务单元测试,下一步应覆盖订单服务和关键业务闭环。
按当前项目约定,本轮后续开发不新增自动化测试建设任务。每阶段完成后使用构建检查和人工业务场景验收兜底。
优先测试范围:
固定检查:
- 入库确认生成库存和库存流水
- 出库 pending 预占库存
- 出库 confirm 扣减库存
- 出库库存不足失败
- 移库 pending 后来源库存占用
- 移库 confirm 后来源扣减、目标增加
- 单据状态非法流转失败
- 重复请求或重复确认不会重复扣减库存
- 租户和货主隔离
- 后端运行 `dotnet build`。
- 前端运行 `pnpm run typecheck`、`pnpm run build`、`pnpm run lint`。
- 核心业务通过人工场景验收,重点覆盖库存数量、单据状态、任务状态和库存流水是否一致。
关键目标:
优先人工验收范围:
- 业务服务层必须有单元测试。
- 关键 API 应增加集成测试。
- 库存数量、状态、流水三者必须一起断言。
- 入库单可先建 Draft 单头,再追加明细并确认入库。
- 出库单可先建 Draft 单头,再追加明细并转待拣。
- 出库转待拣后生成拣货任务,任务确认后才能确认出库。
- 库存不足时出库转待拣失败,库存不被部分污染。
- 取消待拣出库单后释放预占库存。
- 重复点击待拣、确认拣货、确认出库不会重复扣减库存。
- 左上角图标进入首页时不会新增“页面”标签。
## 建议实施顺序
1. 补订单服务测试,确保现有逻辑可安全演进。
2. 抽象库存分配服务,为出库任务化做准备。
3. 改造出库流程,引入拣货任务。
4. 改造入库流程,引入收货暂存和上架任务。
5. 改造移库流程,引入移库任务和在途状态。
6. 扩展库存维度,加入批次、效期、质量状态。
7. 增强容器/LPN 能力。
8. 补撤销、冲正、异常恢复和并发保护。
1. 稳固当前出库任务化闭环,继续补齐幂等、异常原因和状态限制。
2. 改造入库流程,引入收货暂存和上架任务。
3. 改造移库流程,引入移库任务和在途状态。
4. 扩展库存维度,加入批次、效期、质量状态。
5. 增强容器/LPN 能力。
6. 补撤销、冲正、异常恢复和并发保护。
7. 整理前端作业体验,继续统一单据详情、任务视图和流水视图。
8. 完善部署说明、业务流程文档和阶段人工验收清单。
## 阶段完成标准
@@ -219,7 +221,7 @@ InventoryAllocationService
- 基础库存分配策略:FIFO、FEFO、库区优先级
- 初级容器/LPN 管理
- 可追溯库存流水
- 核心业务服务测试覆盖
- 每阶段构建检查与人工验收记录
## 尚未覆盖的高级能力