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