ERP 开发进度
更新时间：2026-06-20
本文按当前可追踪的 dev-notes 和待处理清单整理，用于查看已处理项、待测试项和待处理项。状态只代表当前代码与文档记录，不等同于业务正式验收。
状态说明
| 状态 | 含义 |
|---|---|
| 已处理 | 已有前后端实现记录，并有 focused 测试、类型检查或构建验证。 |
| 待测试 | 功能已实现或部分实现，但还需要业务流程验收、回归测试或提交前复核。 |
| 待处理 | 仍在需求清单中，当前未看到完整实现记录。 |
已处理项
| 事项 | 当前处理结果 | 验证记录 |
|---|---|---|
| BOM 多级版本联动 | 新增子级 BOM 版本后，可查询仍引用旧版本的上级 BOM，并按选择级联生成上级版本；跨层级会自动补齐必要中间层。 | 后端 bom-cascade-version focused tests 通过；前端 pnpm run type-check 通过。 |
| BOM 明细跨版本同步 | 修改或删除直接物料时，可选择同步到同一根物料下的草稿/停用版本；启用版本仍禁止写入。 | 后端 bom-material-sync focused tests 通过；前端 pnpm run type-check 通过。 |
| BOM 成本展示 | 生产排单和 MRP 请购弹窗展示 BOM childrenPrice；多版本成本用颜色区分最低价、较高价和未计算价。 | 前端 pnpm run type-check 通过。 |
| 返工工单编码区分 | 返工工单使用 FG 前缀；前后端统一以 helper 判断 GD、FG、WG 是否属于工单。 | 后端 work-code 测试和构建通过；前端 order-code-utils 测试和 type-check 通过。 |
| 库存占用明细 | 占用明细过滤零数量记录；页面刷新和导出按 materialId + warehouseId 范围查询。 | 后端库存占用 focused tests 通过；前端 type-check 通过。 |
| 盘点导入、导出和状态保护 | 盘点单审核、出入库、完成、终止后禁止继续新增、导入、保存或更新；导出保留，便于追溯。 | 后端 inventory-check-import-export 测试通过；前端 type-check 通过。 |
| 替换物料进入生产排单 | 生产排单可选择替换物料；请购已选择的替换物料会作为生产默认值，并在领料和生产完成扣库存时使用替换物料。 | 后端 manufacture-substitution-flow 等测试通过；前端 type-check 通过。 |
| 其他出库可见仓库库存 | 手工其他出库选择物料后，显示所选出库仓库下的库存总量和可用量。 | 前端 type-check 通过，相关文件 git diff --check 通过。 |
待测试项
| 事项 | 建议测试范围 | 备注 |
|---|---|---|
| BOM 版本级联 | 从低层 BOM 新增版本，选择不同上级版本组合，确认生成版本、物料行、默认版本和启用状态正确。 | 后端 focused tests 已过，仍需真实业务数据验收。 |
| BOM 明细同步 | 分别测试修改用量、损耗、备注和删除直接物料；确认只影响被选中的草稿/停用版本。 | 不同步替换物料和子级 BOM 版本替换，这是当前规则。 |
| 替换物料闭环 | 从 MRP 请购选择替换物料，到生产排单、待领料资源池、领料出库、生产完成自动出库全流程复核。 | 重点确认库存扣减不再落到原 BOM 物料。 |
| 盘点状态保护 | 盘点单处于审核中、已出入库、已完成、已终止时，逐一验证新增、导入、保存、更新按钮和后端拦截。 | 导出应继续可用。 |
| 返工工单编码 | 新建返工单、库存检验不合格转返工、销售退货检验转返工，确认显示 FG 且后续流程仍按工单处理。 | 后续新增页面不要再硬编码比较 GD。 |
| 库存占用导出 | 分别测试当前查询条件导出、勾选行导出、切换仓库后导出。 | 需确认导出结果与弹窗明细一致。 |
| 构建和回归 | 前端 type-check、后端 build、相关 focused tests 已有通过记录；提交前建议再跑一次完整冒烟。 | 后端完整 Jest 仍记录有 unrelated review-flow 噪声，需要单独判断。 |
待处理项
| 业务域 | 待处理事项 | 建议优先级 |
|---|---|---|
| 单据结单 | 所有单据增加年单功能，页面区分“已结单”和“未结单”；工单增加手动结单。 | 高 |
| 客户料号 | 一式多料号，报价区区分客户料号；销售明细、生产链路继续明确客户料号来源。 | 高 |
| 库存成本 | 库存价值按批次先进先出计算领用成本和库存价值。 | 高 |
| 质量数量 | 报废、不合格、合格数量分开展示。 | 中 |
| 非统一物料 | 颜色区分，并展示最近一次采购供应商和单价。 | 中 |
| 半成品生产 | 半成品按米数计算，排单燃熔率和损耗。 | 中 |
| 打印导出 | 工单打印、移库单据打印、盘点单打印仍需排期；PDF 模板选择规则需统一落地。 | 中 |
| 物流 | 物流公司绑定及关联。 | 中 |
| 出库批次 | 出库数量匹配多个批次。 | 中 |
| 待生产资源池 | 待生产资源池未带出编码成品料号。 | 中 |
| 在库返工 | 增加在库产品返工流程。 | 中 |
提交前复核
- 复核前后端生成文件，例如
build/cool/eps.d.ts、build/cool/eps.json、src/index.ts，确认哪些需要随功能提交。 - 将库存、BOM/MRP、返工工单三类变更分开 review，避免把 unrelated worktree 改动混入同一提交。
- 若要更新“已处理”状态，应同时补充对应前端、后端、测试和业务验收记录。