feat(mes): 添加定时同步可生产数量到WMS及BOM项相关标准字段

- 在main.go中添加定时任务每10分钟同步可生产数量到WMS系统
- 为BomItem实体添加relatedStandard字段及相关CRUD方法
- 为InspectionRecord实体添加reportNo、materialCode、materialName等字段
- 更新ent schema确保新字段的验证和默认值设置
- 添加必要的数据库迁移和字段映射逻辑
This commit is contained in:
SunYF
2026-09-17 12:49:07 +08:00
parent b4b274301d
commit 1cc93795ce
191 changed files with 24504 additions and 1250 deletions
+52 -25
View File
@@ -5,37 +5,53 @@
export const helpInbound = {
title: '入库(来料入账)',
overview:
'把到货的来料记入 WMS 库存。按管理类型分两种入库方式:\n· 结构件(螺丝/机加工件) → 按【批次】入库,一批多件;\n· 电气件(芯片/器件) → 按【SN 序列号】逐件扫码,可单件追溯。\n\n管理类型由 WMS 的"物料档案"决定(电气件/结构件),入库方式随之自动给出。\n入库是整个库存链路的第一环:入库(Held) → 质量检验(合格Z02) → 之后才能被出库锁定。\n\n本页三个页签(录入在前,记录在后点击才见),参照出库管理:\n· 结构件入库:按批次入库 + Excel 批量导入;\n· 电气件 SN 入库:逐件扫码 + Excel 批量导入;\n· 入库记录:分页列表(一单一行),点「明细」在右侧抽屉查看该单的行(懒加载+分页,不内嵌子表)。',
'把到货的来料记入 WMS 库存。按管理类型分两种入库方式:\n· 结构件(螺丝/机加工件) → 按【批次】入库,一批多件;\n· 电气件(芯片/器件) → 按【SN 序列号】逐件扫码,可单件追溯。\n\n管理类型由 WMS 的"物料档案"决定(电气件/结构件),入库方式随之自动给出。\n入库是整个库存链路的第一环:入库(Held) → 质量检验(合格Z02) → 之后才能被出库锁定。\n\n本页四个页签(录入在前,记录在后点击才见),参照出库管理:\n· 结构件入库:按批次入库 + Excel 批量导入;\n· 电气件 SN 入库:逐件扫码 + Excel 批量导入;\n· 其他入库:辅料/螺栓/工装/试验设备等非结构件非电气件物料,规格型号强制;\n· 入库记录:分页列表(一单一行),点「明细」在右侧抽屉查看该单的行(懒加载+分页,不内嵌子表)。\n\n库位四级贯通:每笔入库除选「区域」外,还可录「货架/层/位置」三级货位,或点「推荐库位」由系统给出历史常用位+同区空位一键填入。',
sections: [
{
title: '结构件入库(页签1)',
overview: '适用于螺丝、机加工件等结构件,一次到货入一批。录入与 Excel 批量导入都在本页签。',
fields: [
{ name: '物料', source: '下拉选择。数据来自 WMS"物料档案"里类型为"结构件"的物料。', purpose: '入库的是什么物料;档案里必须存在才能选到', fill: '选择物料编码,如 SCREW-M3;选不到=还没建该物料档案' },
{ name: '批次号', source: '留空系统自动生成(日期+序号);也可手工填。', purpose: '区别不同到货批次,实现先进先出(FIFO)', fill: '默认留空自动生成;供应商自带批号时可手填' },
{ name: '物料', source: '下拉选择。数据来自 WMS"物料档案"里类型为"结构件"的物料。', purpose: '入库的是什么物料;档案里必须存在才能选到', fill: '选择图号,如 SCREW-M3;选不到=还没建该物料档案' },
{ name: '批次号', source: '留空系统自动生成(图号-日期-流水号,同批多行自动递增保证唯一);也可手工填。', purpose: '区别不同到货批次,实现先进先出(FIFO)', fill: '默认留空自动生成;供应商自带批号时可手填,数据库去重' },
{ name: '数量', source: '手工填写整数。', purpose: '本批到货数量', fill: '整数 ≥1' },
{ name: '区域', source: '下拉选择(必填)。数据来自"区域维护"。', purpose: '放到哪个库区(待检/合格/不合格…)', fill: '必填;新到货一般先放"待检"区,检验合格后再转"合格"区' },
{ name: '货架/层/位', source: '手工填写(选填)。库位四级贯通的三级货位。', purpose: '精确到货位,便于拣配与盘点', fill: '如 货架A / 3层 / 12位;可留空只记区域' },
{ name: '推荐库位', source: '按钮 → 调 /zone/recommend。', purpose: '系统按该图号「历史常用位 + 同区空位」给候选,一键填入免手输', fill: '先选物料再点「推荐库位」,在弹窗点候选标签即回填区域+货架/层/位' },
{ name: '生产日期', source: '手动选择日期。', purpose: '生产时间,用于时效和批次管理', fill: '选择日期' },
{ name: '供应商', source: '手工填写。', purpose: '来料来源', fill: '供应商名称,可空' },
{ name: '批量导入', source: '本页签下方。', purpose: '整表校验后一次性入库', fill: '模板(首行忽略表头):物料编码 | 批次号(可空自动生成) | 数量 | 生产日期 | 供应商 | 区域 | 备注。任一行错误则整体回退' }
{ name: '批量导入', source: '本页签下方。', purpose: '整表校验后一次性入库', fill: '模板(首行忽略表头):图号 | 批次号(可空自动生成) | 数量 | 生产日期 | 供应商 | 区域 | 备注。任一行错误则整体回退' }
]
},
{
title: '电气件 SN 入库(页签2)',
overview: '适用于芯片、器件等需要单件追溯的来料,一件一个 SN。录入与 Excel 批量导入都在本页签。',
fields: [
{ name: '物料', source: '下拉选择(必填)。来自"物料档案"类型为"电气件"的物料。', purpose: '入库的电气件物料', fill: '选择物料编码' },
{ name: '物料', source: '下拉选择(必填)。来自"物料档案"类型为"电气件"的物料。', purpose: '入库的电气件物料', fill: '选择图号' },
{ name: '区域', source: '下拉选择(必填)。来自"区域维护"。', purpose: '放到哪个库区', fill: '必填;新到货一般先放"待检"区' },
{ name: '货架/层/位 · 推荐库位', source: '同结构件入库:三级货位手填 + 「推荐库位」一键填入。', purpose: '精确货位', fill: '选物料后点「推荐库位」取历史常用位/同区空位' },
{ name: '扫码录入', source: '扫码枪连续扫码。来自每颗器件自带的 SN 条码。', purpose: '逐件登记 SN,实现单件追溯', fill: '扫入/粘贴 SN 后点【录入到列表】加入清单,可一次连续多条' },
{ name: '批量导入', source: '本页签下方。', purpose: '整表校验后一次性入库', fill: '模板(首行忽略表头):物料编码 | SN | 区域 | 生产日期 | 供应商。任一行错误则整体回退' }
{ name: '批量导入', source: '本页签下方。', purpose: '整表校验后一次性入库', fill: '模板(首行忽略表头):图号 | SN | 区域 | 生产日期 | 供应商。任一行错误则整体回退' }
]
},
{
title: '入库记录(页签3)',
overview: '分页展示全部入库单,结构件与电气件同表(用"类型"列区分)。支持按入库单号、物料编码、类型、物料名称、入库时间筛选(各字段独立,无关键字混搜);可按当前条件导出 xlsx。点行「明细」在右侧抽屉查看该单的批次号/SN 行(懒加载+分页,避免电气件上万条 SN 撑爆前端)。',
title: '其他入库(页签3)',
overview: '适用于辅料、螺栓、工装、试验设备等既非结构件也非电气件的物料;规格型号强制(在物料档案维护,为空则拒绝入库)。支持归属(无/工单号/科技项目号)与库位四级。',
fields: [
{ name: '查询条件', source: '本页签顶部筛选区。', purpose: '缩小列表范围', fill: '可组合:入库单号(模糊)/物料编码(模糊)/类型(全部·结构件·电气件)/物料名称(模糊)/入库时间区间' },
{ name: '物料', source: '下拉选择。来自"物料档案"类型为"其他"的物料。', purpose: '入库的其他类物料', fill: '选择图号;规格型号由档案带出,缺失需先补档案' },
{ name: '规格型号', source: '选物料后自动带出(只读)。', purpose: '其他类物料强制记录规格', fill: '只读;为空时无法提交,需先到物料档案补全' },
{ name: '批次号/数量', source: '批次留空自动生成;数量手工整数。', purpose: '入账批次与数量', fill: '数量 ≥1' },
{ name: '区域 · 货架/层/位', source: '同结构件入库,含「推荐库位」。', purpose: '库位四级贯通', fill: '选区域,可录三级货位或用推荐' },
{ name: '归属', source: '下拉:无 / 工单号 / 科技项目号。', purpose: '标记该批其他物料归属哪个工单或科技项目', fill: '选"无"外的项须填归属编号' },
{ name: '检测单号', source: '手工填写(必填)。', purpose: '与入库检报告关联,检验页跳转可自动带入', fill: '必填;从检验页「去入库」跳转时自动回填' }
]
},
{
title: '入库记录(页签4)',
overview: '分页展示全部入库单,结构件/电气件/其他同表(用"类型"列区分)。支持按入库单号、图号、类型、物料名称、入库时间筛选(各字段独立,无关键字混搜);列表含「区域」「库位」「检测单号」「质量状态」「归属」列;可按当前条件导出 xlsx。点行「明细」在右侧抽屉查看该单的批次号/SN 行(懒加载+分页,避免电气件上万条 SN 撑爆前端)。',
fields: [
{ name: '查询条件', source: '本页签顶部筛选区。', purpose: '缩小列表范围', fill: '可组合:入库单号(模糊)/图号(模糊)/类型(全部·结构件·电气件·其他)/物料名称(模糊)/入库时间区间' },
{ name: '明细', source: '行末「明细」按钮 → 右侧抽屉。', purpose: '查看该入库单的批次号/SN/数量明细', fill: '抽屉内分页展示,不回列表里嵌套子表' },
{ name: '附件', source: '入库单行内附件(AttachmentPanel)。', purpose: '为入库单上传/查看随货单据、质检报告等附件', fill: '点行内附件按钮,在抽屉中上传或查看' },
{ name: '导出', source: '按钮。后端 /inbound/export 按当前条件返回全部(不分页)。', purpose: '把筛选结果一次性导出为 xlsx', fill: '点【导出】下载"入库管理.xlsx"' }
]
}
@@ -45,7 +61,7 @@ export const helpInbound = {
export const helpOutbound = {
title: '出库管理(统一主表)',
overview:
'所有出库都落在同一张「出库主表」(OutboundOrder),用"类型"区分,装箱信息(箱号/SN清单/合同号)也直接记在主表上,不再单独建装箱表。\n两个出库页签 + 一个记录页签:\n· 工单备料出库(MES):对接 MES 工单台账领料,强约束"单物料累计出库 ≤ 工单需求总量";未启用 MES 或工单未同步时,工单下拉可能为空,可直接手输工单号(需台账已同步)。\n· 通用出库:不依赖工单的手动出库(退料/样品/报废/发货),支持结构件批次与电气件 SN,填箱号即一并记录装箱;MES 不可用或无需挂靠工单时请用本页。\n· 出库记录:统一主表的全量查询与导出(一键导出 CSV,含装箱信息)。\n选用原则:有 MES 工单要按 物料清单 领料 → 工单备料出库;无工单的自由出库/装箱发货 → 通用出库。',
'所有出库都落在同一张「出库主表」(OutboundOrder),用"类型"区分,装箱信息(箱号/SN清单/合同号)也直接记在主表上,不再单独建装箱表。\n两个出库页签 + 一个记录页签:\n· 工单备料出库(MES):对接 MES 工单台账领料,强约束"单物料累计出库 ≤ 工单需求总量";未启用 MES 或工单未同步时,工单下拉可能为空,可直接手输工单号(需台账已同步)。\n· 通用出库:不依赖工单的手动出库(退料/样品/报废/发货),支持结构件批次与电气件 SN,填箱号即一并记录装箱;MES 不可用或无需挂靠工单时请用本页。\n· 出库记录:统一主表的全量查询与导出(一键导出 CSV,含装箱信息)。\n选用原则:有 MES 工单要按 物料清单 领料 → 工单备料出库;无工单的自由出库/装箱发货 → 通用出库。\n\n说明:出库列表中的"图号"即物料编码(客户口径统一称"图号");通用出库涵盖退料/样品/报废/发货等场景,无固定分类下拉,具体去向记在"备注"。质量门禁:质量状态为「不合格/待退」的批次禁止领料上线,须先完成不合格处置。',
fields: [
{ name: '备料出库-工单号', source: '手动输入。数据来自 MES 已建的工单及导入的物料台账。', purpose: '出库挂靠的工单,决定可领料总量与需求缺口', fill: '输入工单号回车,查询该工单的物料台账' },
{ name: '备料出库-目标工位', source: '下拉选择 DOCK01~DOCK20(选填,可过滤搜索)。', purpose: 'AGV 配送送达的接驳台(toDock 参数)', fill: '选择如 DOCK05;不选默认运到产线入口 DOCK01' },
@@ -62,7 +78,7 @@ export const helpInventory = {
overview:
'查看当前库存:全品类统一一张库存主表——原材料(结构件按批次/电气件按SN)、半成品(MES 暂存退库)、成品(MES 完工自动回流,系统生成 SN)。数据由入库、出库、检验、盘点及 MES 回流等业务实时维护,本页只读。\n\n本页三个视图页签(首屏默认「物料汇总」):\n· 物料汇总:一物料一行,直接回答"这个物料总共有多少"——总量/锁定/可用 + 质量分布(合格/未检/不合格) + 分布在哪些区域;ID 与创建时间取自物料主表,另有最近入库单/最近入库时间;点行下钻该物料的批次/SN 明细。\n· 库存明细:按 物料 × 区域 × 质量 聚合,可组合 区域/质量状态/入库时间/品类 筛选(物料汇总不受区域/质量筛选影响)。\n· 区域汇总:按 区域 × 质量状态 × 类型(批次/电气件/半成品/成品) 看各库区的货量;ID 与创建时间取自区域主表,另有组内最近入库时间;支持全量导出。\n\n层级概念:入库单 → 批次/SN → 库存行。区域/质量状态/批次/最近入库单都是某物料的一对多属性,放在下钻明细中查看,不在物料行上并排平铺。',
fields: [
{ name: '物料编码 / 物料名称', source: '筛选条件。', purpose: '只看某个物料', fill: '输入编码或名称,可空=全部' },
{ name: '图号 / 物料名称', source: '筛选条件。', purpose: '只看某个物料', fill: '输入图号或名称,可空=全部' },
{ name: '库存类型', source: '单选(全部/结构件/电气件)。', purpose: '按管理粒度过滤', fill: '全部 / 结构件(批次) / 电气件(SN)' },
{ name: '品类', source: '单选(全部/原材料/半成品/成品)。', purpose: '按品类过滤:原材料=采购到货入库;半成品=MES 工位暂存退库;成品=MES 完工自动回流(成品 SN 系统生成,入库单号形如 MES:工单号)', fill: '全部 / 原材料 / 半成品 / 成品;三个视图与导出均生效' },
{ name: '物料汇总-质量分布', source: '系统按当前在库行统计。', purpose: '一个物料合格/未检/不合格各多少', fill: '合格/未检/不合格三列,自动统计' },
@@ -70,6 +86,7 @@ export const helpInventory = {
{ name: '库存明细-区域/质量/入库时间', source: '仅「库存明细」视图生效的筛选。', purpose: '在物料基础上再按存放区/质量状态/入库时间收窄', fill: '可组合筛选' },
{ name: '批次/SN 明细(下钻)', source: '点击任一行弹出抽屉。', purpose: '看该物料的每个批次/SN 所在区域、质量状态、锁定与来源入库单', fill: '抽屉内分页展示;点入库单号可跳转入库页' },
{ name: 'ID / 创建时间', source: '物料汇总行取物料主表(material),区域汇总行取区域主表(zone)。', purpose: '行标识与主档建立时间,用于追溯与对账', fill: '系统自动带出,只读;物料档案/区域缺失时显示 -' },
{ name: '可生产数量(物料汇总)', source: 'MES 计算后推送快照,本页只读展示(仅「物料汇总」视图)。', purpose: '按各物料可用量 ÷ 单台用量取最小值,估算每个成品当前可装配套数,并标出短板物料', fill: '只读;显示可装配套数与限制它的短板物料,附同步时间' },
{ name: '导出', source: '按钮。后端按当前筛选全量导出 xlsx。', purpose: '把结果导出存档', fill: '物料汇总视图导出「物料汇总.xlsx」;库存明细视图导出「库存汇总.xlsx」;区域汇总视图导出「区域汇总.xlsx」' }
]
}
@@ -77,7 +94,7 @@ export const helpInventory = {
export const helpInspection = {
title: '检验(来料/过程/完工)',
overview:
'对入库的未检物料/SN 做检验:把"未检"翻转为【合格】或【不合格】。\n检验只修改"质量状态"字段,与物料/SN 的存放区域无关。\n合格品才能参与出库与锁库(库存校验只取质量状态=合格的批次)。\n\n本页分两个页签(录入在前默认打开,记录在后点击才见),参照出库管理:\n· 质量检验录入(常操作,默认打开):单条与批量已合并为同一处——扫码枪连续扫、或从"库存"下拉直接选,都先进入下方"已选清单",点一次"提交检验"统一翻转。\n· 检验记录(点击才加载):分页查询历史检验记录,支持按 批次/SN、物料、检验类型、结论、检验员、时间 筛选与导出。\n菜单按业务分为「来料检验 / 过程检验 / 完工检验」三个入口,同一张表、同一接口,仅按检验类别默认过滤(页面内不再切换类别)。记录支持「报检单号」字段,用于与生产报检流程关联;按需求已移除“不合格原因”字段。\n编号是否真实存在会即时校验:找不到对应库存记录的编号会直接报错,不会"提示成功但库存仍是未检"。',
'对入库的未检物料/SN 做检验:把"未检"翻转为【合格】或【不合格】。\n检验只修改"质量状态"字段,与物料/SN 的存放区域无关。\n合格品才能参与出库与锁库(库存校验只取质量状态=合格的批次)。\n\n本页分两个页签(录入在前默认打开,记录在后点击才见),参照出库管理:\n· 质量检验录入(常操作,默认打开):单条与批量已合并为同一处——扫码枪连续扫、或从"库存"下拉直接选,都先进入下方"已选清单",点一次"提交检验"统一翻转。\n· 检验记录(点击才加载):分页查询历史检验记录,支持按 批次/SN、物料、检验类型、结论、检验员、时间 筛选与导出。\n菜单按业务分为「来料检验 / 过程检验 / 完工检验」三个入口,同一张表、同一接口,仅按检验类别默认过滤(页面内不再切换类别)。记录支持「报检单号」字段,用于与生产报检流程关联;按需求已移除“不合格原因”字段。\n编号是否真实存在会即时校验:找不到对应库存记录的编号会直接报错,不会"提示成功但库存仍是未检"。\n不合格处置:判定为「不合格」时必须选择处置方式——退货(须填货运单号) / 报废 / 部分入库(一次只处理 1 个批次);不合格品不入库、不上产线。已判定不合格的记录也可在列表中再次执行处置。\n附件:每条检验记录可上传/查看附件(如检测报告、照片)。',
fields: [
{ name: '目标类型', source: '单选,决定录入框标题与可选库存范围。', purpose: '检验对象是批次(结构件)还是 SN(电气件)', fill: '批次 BATCH / 序列号 SN;切换时会自动刷新"从库存选"下拉' },
{ name: '检验结论', source: '单选。', purpose: '判定结果', fill: '合格 / 不合格' },
@@ -85,7 +102,10 @@ export const helpInspection = {
{ name: '从库存选批次号/SN', source: '下拉选择,数据来自当前库存(按目标类型过滤)。', purpose: '避免手输编号、防止输错', fill: '在库存里挑待检的批次号/SN,自动加入清单' },
{ name: '录入批次号/SN', source: '扫码枪/粘贴。来自批次号/SN条码。', purpose: '单条或多条待检编号', fill: '扫入或粘贴后点【录入到列表】,多编号用逗号/分号/空格/回车分隔' },
{ name: '已选清单', source: '本页待提交列表。', purpose: '统一查看、可逐个删除', fill: '列在此处的编号,点【提交检验】一次性翻转' },
{ name: '检验记录-筛选/导出', source: '切换到"检验记录"页签后可见。', purpose: '按条件分页查询历史记录并导出', fill: '支持按 批次/SN、物料编码、检验类型、结论、检验员、时间范围 组合筛选;点【导出】下载 xlsx' }
{ name: '检测单号 / 报检单号', source: '手工填写(可空)。检测单号用于与入库单据关联传递,报检单号用于关联生产报检流程。', purpose: '把检验记录与来料入库/生产报检挂钩,便于追溯', fill: '如检测单号随入库带入;报检单号可空' },
{ name: '不合格处置', source: '判定"不合格"时必选:退货 / 报废 / 部分入库。', purpose: '不合格品不入库、不上产线,须明确去向;退货须填货运单号,部分入库一次只处理 1 个批次', fill: '退货(填货运单号) / 报废 / 部分入库(单批次);判定不合格却不选处置会被拦截' },
{ name: '附件', source: '行内附件抽屉(bizType=检验记录)。', purpose: '为该检验记录上传/查看附件(如检测报告、照片)', fill: '点行内附件按钮,在抽屉中上传或查看' },
{ name: '检验记录-筛选/导出', source: '切换到"检验记录"页签后可见。', purpose: '按条件分页查询历史记录并导出', fill: '支持按 批次/SN、图号/物料名称/型号(三框模糊:框内模糊、框间取交集)、检验类型、结论、检验员、时间范围(默认近3个月) 组合筛选;点【导出】下载 xlsx' }
]
}
@@ -111,13 +131,13 @@ export const helpSemi = {
'② WMS 收到后写入统一库存主表(品类=半成品),与原材料/成品同表管理——库存查询三视图、区域汇总、导出都能看到它。\n' +
'③ 该件后续要接着做时,在本页"半成品出库"或 MES 重上线 → WMS /api/internal/semi/outbound 把状态置为出库。\n' +
'④ MES 据此下发下一工序,工位继续装配,直至完工。\n\n' +
'SN 是两系统唯一的追溯锚点。物料编码以请求传入为准,WMS 会同时从物料档案补齐物料名称(档案缺失不阻塞入库,只用编码兜底)。',
'SN 是两系统唯一的追溯锚点。图号以请求传入为准,WMS 会同时从物料档案补齐物料名称(档案缺失不阻塞入库,只用图号兜底)。',
sections: [
{
title: '半成品/成品入库',
overview: '把产线退回的半成品或成品收进库房(手工录入或 MES 自动同步均走此接口)。',
fields: [
{ name: '物料', source: '下拉选择。来自物料档案(最近100条+模糊搜索)。', purpose: '入库物料(MES 自动同步时以请求传入为准,WMS 补齐物料名称)', fill: '选择物料编码' },
{ name: '物料', source: '下拉选择。来自物料档案(最近100条+模糊搜索)。', purpose: '入库物料(MES 自动同步时以请求传入为准,WMS 补齐物料名称)', fill: '选择图号' },
{ name: '已完成工序', source: 'MES 自动带出(doneProcessCodes,如 [1,3,5]);手工录入填逗号分隔,如 1,3,5。', purpose: '该件已做到哪些工序,重上线时 MES 从下一工序继续', fill: '如 1,3,5,可空' },
{ name: '工单号', source: '自动带出/手工填写。来自工单。', purpose: '来源工单', fill: '输入工单号' },
{ name: '区域', source: '手动填写(可空)。', purpose: '存放库区', fill: '如 Z05' },
@@ -140,7 +160,7 @@ export const helpLedger = {
'实时展示每个工单下每个物料:需求总量、累计已出库、剩余缺口。\n系统强约束"累计出库 ≤ 需求总量",达到即标记"领料完结",禁止再出库。\n数据链路:MES 工单 + 物料清单(物料清单) → 同步导入本台账 → 出库时自动扣减累计,形成缺口 / 完结。\n\n说明:本页只读查询,数据来自 MES 同步的工单台账。若列表为空,表示当前没有已同步的台账数据(请先在 MES 建工单并同步物料清单),不会展示任何模拟数据。',
fields: [
{ name: '工单号', source: '筛选条件。数据来自 MES 工单。', purpose: '只看某个工单的领料台账', fill: '输入工单号(可空=查全部工单)' },
{ name: '物料编码', source: '筛选条件。', purpose: '按物料编码精确过滤', fill: '输入物料编码(可空)' },
{ name: '图号', source: '筛选条件。', purpose: '按图号精确过滤', fill: '输入图号(可空)' },
{ name: '物料名称', source: '筛选条件。', purpose: '按物料名称模糊过滤', fill: '输入物料名称(可空)' },
{ name: '状态', source: '筛选条件。可选项:待领料 / 部分领料 / 领料完结。', purpose: '按领料进度过滤', fill: '待领料=还没出过库;部分领料=已出库但没领完;领料完结=缺口为 0(前两种均由"进行中"按已出库数实时派生)' },
{ name: 'ID', source: '台账记录主键(系统生成,只读)。', purpose: '唯一标识一行台账,便于定位与对接', fill: '系统自动生成,无需填写' },
@@ -152,12 +172,12 @@ export const helpLedger = {
export const helpReturnOrder = {
title: '退库确认',
overview:
'工位退库的接收确认环节:工位终端上操作工把「没用完 / 用错的物料」做退库发起,系统预建一张「待确认收货」的退库单;仓库保管员在本页审核并实物点收,点「确认收货」后系统把该数量加回库存,退库单置为「已收货」,整条退库链路闭环。\n\n数据链路:工位终端退库 → MES 落事件日志并调用 WMS 内部接口 → WMS 预建退库单(PENDING) → 本页确认收货 → 库存加回(批次物料按「物料编码 + 在库」合并到已有库存行;无在库行则新建一行,入库单号记为 RET:退库单号)。\n\n说明:退货单状态只有两种——待确认收货 / 已收货。同一工单 + 同一物料 + 同一工位只会预建一条待收货退库单(防止重复提交)。本页不含「删除」,退库一经确认即形成库存流水,不可撤销。',
'工位退库的接收确认环节:工位终端上操作工把「没用完 / 用错的物料」做退库发起,系统预建一张「待确认收货」的退库单;仓库保管员在本页审核并实物点收,点「确认收货」后系统把该数量加回库存,退库单置为「已收货」,整条退库链路闭环。\n\n数据链路:工位终端退库 → MES 落事件日志并调用 WMS 内部接口 → WMS 预建退库单(PENDING) → 本页确认收货 → 库存加回(批次物料按「图号 + 在库」合并到已有库存行;无在库行则新建一行,入库单号记为 RET:退库单号)。\n\n说明:退货单状态只有两种——待确认收货 / 已收货。同一工单 + 同一物料 + 同一工位只会预建一条待收货退库单(防止重复提交)。本页不含「删除」,退库一经确认即形成库存流水,不可撤销。',
fields: [
{ name: '状态', source: '筛选条件,系统维护。', purpose: '只看待确认收货或已收货的退库单', fill: '选「待确认收货」优先处理' },
{ name: '退库单号', source: '系统自动生成(TH + 时间戳)。', purpose: '唯一标识一张退库单,便于对账追溯', fill: '自动生成,无需填写' },
{ name: '工单号 / 退库工位 / 产品序列号', source: '工位终端退库时自动带入。', purpose: '定位退的是什么工单、哪件产品的物料', fill: '只读' },
{ name: '物料编码 / 名称 / 规格', source: '工位终端退库时带入(来自物料档案)。', purpose: '是哪一种物料退库', fill: '只读' },
{ name: '图号 / 名称 / 规格', source: '工位终端退库时带入(来自物料档案)。', purpose: '是哪一种物料退库', fill: '只读' },
{ name: '数量 / 单位', source: '工位终端填写。', purpose: '退多少(确认收货后按此数加回库存)', fill: '只读' },
{ name: '退库原因', source: '工位终端填写。', purpose: '说明为什么退库(如剩余料 / 错料 / 不良更换)', fill: '只读' },
{ name: '退库人 / 退库时间', source: '系统记录。', purpose: '追溯谁在什么时候发起的退库', fill: '只读' },
@@ -179,12 +199,16 @@ export const helpAgv = {
}
export const helpZone = {
title: '区域维护',
title: '区域维护(库位四级)',
overview:
'维护库区字典,供入库/半成品/出库等所有页面的"区域"下拉框选择。\n区域是货品存放的物理库区(如待检、合格 Z02、不合格…);入库时必须指明放到哪个区,质量检验合格后再转移到合格区。\n\n区域字典是库房的第一道地基:先建好区域,入库、检验、出库才能选到正确的存放位置。',
'维护库区/库位字典,供入库/半成品/出库等所有页面的"区域"下拉框选择。\n库位按四级定位:区域编码 → 货架号 → 层 → 位置号(后三级手工填写,可空);区域编码是货品存放的物理库区(如待检、合格 Z02、不合格…),入库时必须指明放到哪个区,质量检验合格后再转移到合格区。\n\n库位推荐(拒绝全自动识别,人工一键确认或手改):入库选物料后可查该物料的推荐库位——系统给出「历史常用位」(该物料最近使用过的库位,按最近使用排序,最多 5 个)与「空闲库位」(启用且当前无在库/锁定库存引用的库位,最多 10 个;若该物料有历史常用区域,则同区域空位排在前面),由库房人员一键采用或手动改写。\n\n区域字典是库房的第一道地基:先建好区域,入库、检验、出库才能选到正确的存放位置。',
fields: [
{ name: '区域编码', source: '手工填写,仓库自定义(新增后不可改)。', purpose: '库区唯一编号,入库/出库据此定位存放位置', fill: '如 Z02、Z05,建议字母+数字,唯一;新增后不可改' },
{ name: '区域编码', source: '手工填写,仓库自定义(新增后不可改)。', purpose: '库区/库位唯一编号,入库/出库据此定位存放位置', fill: '如 Z02、Z05,建议字母+数字,唯一;新增后不可改' },
{ name: '区域名称', source: '手工填写。', purpose: '库区中文名,便于识别', fill: '如 合格区、待检区、不合格区' },
{ name: '货架号', source: '手工填写(可空)。库位四级第二级。', purpose: '库位所在货架编号,细化存放位置', fill: '如 A、B;可空' },
{ name: '层', source: '手工填写(可空)。库位四级第三级。', purpose: '货架第几层', fill: '如 3;可空' },
{ name: '位置号', source: '手工填写(可空)。库位四级第四级。', purpose: '该层的具体位置', fill: '如 12;可空' },
{ name: '库位推荐', source: '入库选物料后系统计算(历史常用位 + 同区空位优先)。', purpose: '辅助库房快速定位应放库位,避免全自动误判', fill: '从推荐的历史位/空位中一键采用,或手动改写区域' },
{ name: '说明', source: '手工填写(可空)。', purpose: '补充描述', fill: '可空' }
]
}
@@ -192,15 +216,16 @@ export const helpZone = {
export const helpMaterial = {
title: '物料档案',
overview:
'定义每一种物料的字典:叫什么、什么规格、什么品类(原材料/半成品/成品)、是【结构件(批次)】还是【电气件(SN)】。\n此处维护的物料会作为下拉选项出现在入库/出库/装箱等页面;其中"类型"直接决定后续入库方式——结构件走批次(一批多件)、电气件走 SN 逐件扫码(单件追溯)。\n\n品类说明:1=原材料(默认) / 2=半成品 / 3=成品。编码主数据单一来源在本表:产品型号档案即本表中"成品"品类的行(MES 实时拉取,不双录);库存主表 inventories 的品类与其呼应。列表支持按品类筛选,导出含品类列。\n\n物料档案是库房的另一道地基:先建好物料,入库时才能选到;类型选错会导致入库方式与追溯粒度不符。',
'定义每一种物料的字典:叫什么、什么规格、什么品类(原材料/半成品/成品)、是【结构件(批次)】还是【电气件(SN)】。\n此处维护的物料会作为下拉选项出现在入库/出库/装箱等页面;其中"类型"直接决定后续入库方式——结构件走批次(一批多件)、电气件走 SN 逐件扫码(单件追溯)。\n\n品类说明:1=原材料(默认) / 2=半成品 / 3=成品。编码主数据单一来源在本表:产品型号档案即本表中"成品"品类的行(MES 实时拉取,不双录);库存主表 inventories 的品类与其呼应。列表支持按品类筛选,导出含品类列。\n\n物料档案是库房的另一道地基:先建好物料,入库时才能选到;类型选错会导致入库方式与追溯粒度不符。\n\n命名说明:物料编码在出库/看板等页面统一显示为"图号"(客户口径)。安全库存在本档案维护,可用量低于它时会在「库房看板」首页触发缺货预警。',
fields: [
{ name: '物料编码', source: '手工填写,仓库自定义(新增后不可改)。', purpose: '物料唯一编号', fill: '如 SCREW-M3;新增后不可改编码' },
{ name: '物料编码', source: '手工填写,仓库自定义(新增后不可改)。在出库/看板等页面显示为"图号"。', purpose: '物料唯一编号(即图号)', fill: '如 SCREW-M3;新增后不可改编码' },
{ name: '名称', source: '手工填写。', purpose: '物料名称', fill: '如 螺丝 M3' },
{ name: '简称', source: '手工填写(可空)。', purpose: '简写', fill: '可空' },
{ name: '规格', source: '手工填写(可空)。', purpose: '规格型号', fill: '可空' },
{ name: '单位', source: '手工填写。', purpose: '计量单位', fill: '如 个/套' },
{ name: '品类', source: '创建时默认"原材料";成品品类由「产品型号」页维护(自动生成),本页查询/导出覆盖全部品类。', purpose: '区分原材料/半成品/成品,与统一库存主表品类对应', fill: '查询区可选 原材料/半成品/成品' },
{ name: '类型', source: '选择:1=结构件(批次管理) / 2=电气件(SN 管理)。语义由库房定:结构件按批次管理,电气件按 SN 逐件管理。', purpose: '决定入库方式:结构件走批次、电气件走 SN 逐件扫码', fill: '结构件(批次) / 电气件(SN)' },
{ name: '安全库存', source: '手工填写整数(默认0)。', purpose: '该物料的最低库存警戒线;可用量低于它会在「库房看板」首页触发缺货预警', fill: '如 100;0=不预警' },
{ name: '说明', source: '手工填写(可空)。', purpose: '补充描述', fill: '可空' }
]
}
@@ -213,8 +238,10 @@ export const helpDisplay = {
export const helpDashboard = {
title: '库房看板',
overview: '只读看板:库存总量、物料种类、出入库动态等。\n数据实时读取统计接口,本页不可编辑。',
fields: []
overview: '只读看板:库存总量、物料种类、出入库动态,以及「缺货预警」。\n缺货预警:列出可用量低于安全库存的物料(安全库存在「物料档案」维护),每行显示 图号 / 安全库存 / 可用量,提示及时补料。\n数据实时读取统计接口,本页不可编辑。',
fields: [
{ name: '缺货预警', source: '系统实时统计(可用量 < 物料档案的安全库存)。', purpose: '一眼看出哪些料快没了、需要补货', fill: '只读;红色标题显示预警项数,无预警时显示"暂无缺货物料"' }
]
}
export const helpRole = {
title: '角色管理',