feat: 重构入库流程,支持序列号与类型解耦,新增通用入库组件

- 重构物料档案字段:将"序列号件"改为"序列号",描述是否有序列号,与类型独立
- 调整入库页逻辑:按物料"序列号"决定记账方式,类型仅用于页签归属
- 新增通用入库组件 InboundEntry,复用三个类型页签的表单逻辑
- 优化成品入库页面,提交后自动切换到入库列表页签
- 修正物料校验提示文案,统一表述为"是否有序列号"
This commit is contained in:
SunYF
2026-10-07 20:00:06 +08:00
parent 756d978900
commit 7c7c16ee6d
20 changed files with 621 additions and 759 deletions
+31 -23
View File
@@ -5,52 +5,60 @@
export const helpInbound = {
title: '入库(来料入账)',
overview:
'把到货的来料记入 WMS 库存。按「序列号件」(物料档案维护)分两种入库方式:\n· 批次件 → 按【批次】入库,一批多件;\n· 序列号件 → 按【SN 序列号】逐件扫码,可单件追溯。\n\n序列号件由 WMS 的"物料档案"决定(2026-09-30 与物料类型解耦,可独立设置),入库方式随之自动给出;物料档案未选择序列号件的物料不能入库。\n入库是整个库存链路的第一环:入库(Held) → 质量检验(合格Z02) → 之后才能被出库。\n\n本页四个页签(录入在前,记录在后点击才见),参照出库管理:\n· 结构件入库:按批次入库 + Excel 批量导入;\n· 电气件入库:逐件扫码 + Excel 批量导入;\n· 其他入库:辅料/螺栓/工装/试验设备等非结构件非电气件物料,规格型号强制;\n· 入库记录:分页列表(一单一行),点「明细」在右侧抽屉查看该单的行(懒加载+分页,不内嵌子表)。\n\n库位四级贯通:每笔入库除选「区域」外,还可录「货架/层/位置」三级货位;选物料后系统自动带入该物料最近一次入库的库位,可手动修改。',
'把到货的来料记入 WMS 库存。页签对应"物料档案"的「类型」:结构件入库(类型=结构件) / 电气件入库(类型=电气件) / 其他入库(类型=其他);而每个页签内实际录入方式由所选物料的「序列号」(是否有序列号,物料档案维护)决定:\n· 序列号=是(序列号件) → 按【SN 序列号】逐件扫码,单件追溯;\n· 序列号=否(批次件) → 按【批次】入库,一批多件。\n(2026-09-30 类型与记账方式解耦,2026-10-06 页签口径对齐:类型只定页签归属,批次/SN 行为看「序列号」是否。)\n入库是整个库存链路的第一环:入库(Held) → 质量检验(合格Z02) → 之后才能被出库。\n\n本页五个页签(录入在前,记录在后):\n· 结构件入库 / 电气件入库 / 其他入库:选物料后按其「序列号」自动分流 批次数量 或 SN 扫码录入;\n· 批量导入:Excel 整表导入,按记账方式分 批次件模板 / SN件模板(与类型页签无关);\n· 入库记录:分页列表(一单一行),点「明细」在右侧抽屉查看该单的行(懒加载+分页)。\n\n库位四级贯通:每笔入库除选「区域」外,还可录「货架/层/位置」三级货位;选物料后系统自动带入该物料最近一次入库的库位,可手动修改。',
sections: [
{
title: '结构件入库(页签1)',
overview: '适用于螺丝、机加工件等结构件,一次到货入一批。录入与 Excel 批量导入都在本页签。',
overview: '页签对应物料档案「类型=结构件」。选物料后按其「序列号」分流:是→SN 扫码录入;否→批次号+数量(生产日期/供应商仅批次件显示)。',
fields: [
{ name: '物料', source: '下拉选择。数据来自 WMS"物料档案"里类型为"结构件"的物料。', purpose: '入库的是什么物料;档案里必须存在才能选到', fill: '选择图号,如 SCREW-M3;选不到=还没建该物料档案' },
{ name: '批次号', source: '留空系统自动生成(图号-日期-流水号,同批多行自动递增保证唯一);也可手工填。', purpose: '区别不同到货批次,实现先进先出(FIFO)', fill: '默认留空自动生成;供应商自带批号时可手填,数据库去重' },
{ name: '数量', source: '手工填写整数。', purpose: '本批到货数量', fill: '整数 ≥1' },
{ name: '物料', source: '下拉选择。数据来自 WMS"物料档案"里类型为"结构件"的物料。', purpose: '入库的是什么物料;档案里必须存在才能选到;选定后按其「序列号」决定录入方式', fill: '选择图号,如 SCREW-M3;选不到=还没建该物料档案' },
{ name: '记账方式提示', source: '选物料后自动显示(来自物料档案「序列号」sn_mode)。', purpose: '提示本单走 批次数量 还是 SN 扫码', fill: '只读标签:序列号件(是)/ 批次件(否)' },
{ name: '批次号', source: '批次件(序列号=否)显示。留空系统自动生成(图号-日期-流水号);也可手工填。', purpose: '区别不同到货批次,实现先进先出(FIFO)', fill: '默认留空自动生成;供应商自带批号时可手填,数据库去重' },
{ name: '数量', source: '批次件(序列号=否)显示。手工填写整数。', purpose: '本批到货数量', fill: '整数 ≥1' },
{ name: '扫码录入', source: '序列号件(序列号=是)显示。扫码枪连续扫码,来自每颗器件自带的 SN 条码。', purpose: '逐件登记 SN,实现单件追溯', fill: '扫入/粘贴 SN 后点【录入到列表】加入清单,可一次连续多条' },
{ name: '区域', source: '下拉选择(必填)。数据来自"区域维护"。', purpose: '放到哪个库区(待检/合格/不合格…)', fill: '必填;新到货一般先放"待检"区,检验合格后再转"合格"区' },
{ name: '货架/层/位', source: '手工填写(选填)。库位四级贯通的三级货位。', purpose: '精确到货位,便于拣配与盘点', fill: '如 货架A / 3层 / 12位;可留空只记区域' },
{ name: '库位自动带入', source: '选物料后前端自动调 /inbound/last-location;该物料无历史库位时(新物料)再调 /zone/vacant 推荐同区空位。', purpose: '有历史→回填最近一次入库库位;无历史→按所选区域自动挑一个未被占用的空闲货位,免手输也避免撞位', fill: '选物料即自动填入;切换区域会按新区域重新推荐空位;结果均可手动改' },
{ name: '生产日期', source: '手动选择日期。', purpose: '生产时间,用于时效和批次管理', fill: '选择日期' },
{ name: '供应商', source: '手工填写。', purpose: '来料来源', fill: '供应商名称,可空' },
{ name: '生产日期 / 供应商', source: '批次件(序列号=否)显示。手动选择/填写。', purpose: '生产时间与来料来源', fill: '可空' },
{ name: '归属', source: '下拉选择:合同号 / 科技项目号 / 其他(必选)。', purpose: '标记本批物料归属哪个合同或科技项目,出入库/检验全链路贯通查询', fill: '必选;选"其他"可不填编号,选"合同号/科技项目号"须填归属编号(≤64 字符)' },
{ name: '产品工号', source: '手工填写(可空)。合同/项目下的二级编号,随入库进入库存,并贯通出库、来料检验、半成品各页展示与筛选。', purpose: '同一合同下区分不同产品套次的细粒度追溯编号', fill: '按合同/车间口径手填;留空则该行不带产品工号' },
{ name: '批量导入', source: '本页签下方。', purpose: '整表校验后一次性入库', fill: '模板(首行忽略表头):图号 | 批次号(可空自动生成) | 数量 | 生产日期 | 供应商 | 区域 | 备注。任一行错误则整体回退' }
{ name: '产品工号', source: '手工填写(可空)。合同/项目下的二级编号,随入库进入库存,并贯通出库、来料检验、半成品各页展示与筛选。', purpose: '同一合同下区分不同产品套次的细粒度追溯编号', fill: '按合同/车间口径手填;留空则该行不带产品工号' }
]
},
{
title: '电气件入库(页签2)',
overview: '适用于芯片、器件等需要单件追溯的来料,一件一个 SN。录入与 Excel 批量导入都在本页签。',
overview: '页签对应物料档案「类型=电气件」。录入方式同样由所选物料的「序列号」决定(默认电气件建档案时带"是",但可改):是→SN 扫码;否→批次号+数量。',
fields: [
{ name: '物料', source: '下拉选择(必填)。来自"物料档案"类型为"电气件"的物料。', purpose: '入库的电气件物料', fill: '选择图号' },
{ name: '区域', source: '下拉选择(必填)。来自"区域维护"。', purpose: '放到哪个库区', fill: '必填;新到货一般先放"待检"区' },
{ name: '货架/层/位', source: '同结构件入库:三级货位手填,选物料后自动带入该物料最近一次入库库位。', purpose: '精确货位', fill: '选物料即自动填入,可手动改' },
{ name: '扫码录入', source: '扫码枪连续扫码。来自每颗器件自带的 SN 条码。', purpose: '逐件登记 SN,实现单件追溯', fill: '扫入/粘贴 SN 后点【录入到列表】加入清单,可一次连续多条' },
{ name: '归属 / 产品工号', source: '与结构件入库同口径:归属必选(合同号/科技项目号/其他),产品工号手填可空。', purpose: '追溯维度,随入库贯通出库/检验各页', fill: '归属必选一项;产品工号按需手填' },
{ name: '批量导入', source: '本页签下方。', purpose: '整表校验后一次性入库', fill: '模板(首行忽略表头):图号 | SN | 区域 | 生产日期 | 供应商。任一行错误则整体回退' }
{ name: '物料', source: '下拉选择(必填)。来自"物料档案"类型为"电气件"的物料。', purpose: '入库的电气件物料;选定后按其「序列号」决定录入方式', fill: '选择图号' },
{ name: '扫码录入', source: '序列号件(序列号=是)显示。扫码枪连续扫码。来自每颗器件自带的 SN 条码。', purpose: '逐件登记 SN,实现单件追溯', fill: '扫入/粘贴 SN 后点【录入到列表】加入清单,可一次连续多条' },
{ name: '批次号 / 数量', source: '批次件(序列号=否)显示。', purpose: '按批次入账', fill: '批次留空自动生成;数量 ≥1' },
{ name: '区域 / 库位', source: '下拉选择(必填) + 三级货位。来自"区域维护";选物料后自动带入最近入库库位。', purpose: '库位四级贯通', fill: '区域必填;货位可自动带入后手改' },
{ name: '归属 / 产品工号', source: '与结构件入库同口径:归属必选(合同号/科技项目号/其他),产品工号手填可空。', purpose: '追溯维度,随入库贯通出库/检验各页', fill: '归属必选一项;产品工号按需手填' }
]
},
{
title: '其他入库(页签3)',
overview: '适用于辅料、螺栓、工装、试验设备等既非结构件也非电气件的物料;规格型号强制(在物料档案维护,为空则拒绝入库)。支持归属(合同号/科技项目号/其他,必选)与库位四级。',
overview: '适用于辅料、螺栓、工装、试验设备等既非结构件也非电气件的物料;规格型号强制(在物料档案维护,为空则拒绝入库)。录入方式由所选物料的「序列号」决定。',
fields: [
{ name: '物料', source: '下拉选择。来自"物料档案"类型为"其他"的物料。', purpose: '入库的其他类物料', fill: '选择图号;规格型号由档案带出,缺失需先补档案' },
{ name: '物料', source: '下拉选择。来自"物料档案"类型为"其他"的物料。', purpose: '入库的其他类物料;选定后按其「序列号」决定录入方式', fill: '选择图号;规格型号由档案带出,缺失需先补档案' },
{ name: '规格型号', source: '选物料后自动带出(只读)。', purpose: '其他类物料强制记录规格', fill: '只读;为空时无法提交,需先到物料档案补全' },
{ name: '批次号/数量', source: '批次留空自动生成;数量手工整数。', purpose: '入账批次与数量', fill: '数量 ≥1' },
{ name: '批次号/数量 或 扫码录入', source: '按所选物料「序列号」分流:否→批次+数量;是→SN 扫码。', purpose: '入账方式', fill: '批次留空自动生成;数量 ≥1;SN 连续扫码' },
{ name: '区域 · 货架/层/位', source: '同结构件入库,选物料后自动带入最近库位。', purpose: '库位四级贯通', fill: '选区域,可录三级货位或自动带入' },
{ name: '归属', source: '下拉:合同号 / 科技项目号 / 其他(必选,不再有"无")。', purpose: '标记该批其他物料归属哪个合同或科技项目', fill: '必选一项;选"其他"可不填编号,选"合同号/科技项目号"须填归属编号' },
{ name: '归属', source: '下拉:合同号 / 科技项目号 / 其他(必选)。', purpose: '标记该批其他物料归属哪个合同或科技项目', fill: '必选一项;选"其他"可不填编号,选"合同号/科技项目号"须填归属编号' },
{ name: '产品工号', source: '手工填写(可空),随入库贯通出库/检验/半成品各页。', purpose: '同一合同下区分产品套次的二级编号', fill: '按需手填' },
{ name: '检测单号', source: '手工填写(必填)。', purpose: '入库检报告单号,与来料检验互通', fill: '必填;来料检验从「待检清单」送检时自动继承本单号,也可手填' }
]
},
{
title: '入库记录(页签4)',
title: '批量导入(页签4)',
overview: 'Excel 整表导入与「类型」页签解耦:后端按每行物料的「序列号」(sn_mode)校验,批次件走批次模板、序列号件走 SN 模板。整表一次性全导入,任一行错误则整体回退(不写入任何数据)。',
fields: [
{ name: '批次件导入', source: '左侧上传区。仅接受物料档案「序列号=否」的物料。', purpose: '按批次批量入账', fill: '模板(首行忽略表头):图号 | 批次号(可空自动生成) | 数量 | 生产日期 | 供应商 | 区域 | 备注。序列号=是 的物料会被整表拒绝' },
{ name: 'SN 件导入', source: '右侧上传区。仅接受物料档案「序列号=是」的物料。', purpose: '按 SN 逐件批量入账', fill: '模板(首行忽略表头):图号 | SN | 区域 | 生产日期 | 供应商。SN 文件内去重 + 在库查重;序列号=否 的物料会被整表拒绝' },
{ name: '导入结果', source: '页签下方结果卡片。', purpose: '成功行数/生成入库单号/错误行明细', fill: '成功:列出每张入库单号(点击复制);失败:按行列出错误原因,整体回退' }
]
},
{
title: '入库记录(页签5)',
overview: '分页展示全部入库单,结构件/电气件/其他同表(用"类型"列区分)。支持按入库单号、图号、类型、物料名称、归属单号、产品工号、入库时间筛选(各字段独立,无关键字混搜);列表含「区域」「库位」「检测单号」「质量状态」「归属」「产品工号」列;可按当前条件导出 xlsx。点行「明细」在右侧抽屉查看该单的行(懒加载+分页,避免序列号件上万条 SN 撑爆前端)。',
fields: [
{ name: '查询条件', source: '本页签顶部筛选区。', purpose: '缩小列表范围', fill: '可组合:入库单号(模糊)/图号(模糊)/类型(全部·结构件·电气件·其他)/物料名称(模糊)/归属单号(模糊·合同号/科技项目号)/产品工号(模糊)/状态(全部·有效·已作废)/入库时间区间' },
@@ -328,8 +336,8 @@ export const helpMaterial = {
{ name: '规格', source: '手工填写(必填)。', purpose: '规格型号', fill: '如 M3×8' },
{ name: '单位', source: '手工填写(必填)。', purpose: '计量单位', fill: '如 个/套' },
{ name: '品类', source: '必填。创建时默认"原材料";成品品类也可在 MES 的「物料档案」页维护(两系统同一份主数据,以本表为准)。', purpose: '区分原材料/成品/其他,与统一库存主表品类对应;原材料为进货、成品为自产(半成品不是物料品类,由库存 category=2 承载)', fill: '查询区可选 原材料/成品/其他' },
{ name: '类型', source: '必填(与「品类」「序列号件」相互独立)。选择:结构件 / 电气件 / 其他(辅料/工装/试验设备)。', purpose: '纯分类维度(2026-09-30 解耦定稿):仅用于分类统计、筛选与入库页签归属,不再决定批次/SN 行为', fill: '结构件 / 电气件 / 其他' },
{ name: '序列号件', source: '必选(与「类型」相互独立,2026-09-30 解耦定稿)。选择类型时自动带默认:电气件→序列号件,结构件/其他→批次件;可手动更改。', purpose: '决定出入库记账方式:序列号件=逐件录 SN 单件追溯;批次件=按数量一批多件;未选择(0)的物料不能出入库', fill: '序列号件(逐件录SN) / 批次件(按数量,不录SN)' },
{ name: '类型', source: '必填(与「品类」「序列号」相互独立)。选择:结构件 / 电气件 / 其他(辅料/工装/试验设备)。', purpose: '纯分类维度(2026-09-30 解耦定稿):仅用于分类统计、筛选与入库页签归属,不再决定批次/SN 行为', fill: '结构件 / 电气件 / 其他' },
{ name: '序列号', source: '必选单选(是/否,描述「是否有序列号」,与「类型」相互独立,2026-09-30 解耦定稿)。选择类型时自动带默认:电气件→是,结构件/其他→否;可手动更改。', purpose: '决定出入库记账方式:是(序列号件)=逐件录 SN 单件追溯;否(批次件)=按数量一批多件;未选择(0)的物料不能出入库', fill: '是(序列号件,逐件录SN) / 否(批次件,按数量,不录SN)' },
{ name: '安全库存', source: '必填整数(默认0)。', purpose: '该物料的最低库存警戒线;可用量低于它会在「库房看板」首页触发缺货预警', fill: '如 100;0=不预警' },
{ name: '说明', source: '手工填写(可空)。', purpose: '补充描述', fill: '可空' }
]