2026-08-29 08:11:44 +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-03 18:13:59 +08:00
'把到货的来料记入 WMS 库存。按管理类型分两种入库方式:\n· 结构件(螺丝/机加工件) → 按【批次】入库,一批多件;\n· 精密件(芯片/器件) → 按【SN 序列号】逐件扫码,可单件追溯。\n\n管理类型由 WMS 的"物料档案"决定(精密件/结构件),入库方式随之自动给出。\n入库是整个库存链路的第一环:入库(Held) → 质量检验(合格Z02) → 之后才能被出库锁定。\n\n本页三个页签(录入在前,记录在后点击才见),参照出库管理:\n· 结构件入库:按批次入库 + Excel 批量导入;\n· 精密件 SN 入库:逐件扫码 + Excel 批量导入;\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-08-29 08:11:44 +08:00
{ name : '物料' , source : '下拉选择。数据来自 WMS"物料档案"里类型为"结构件"的物料。' , purpose : '入库的是什么物料;档案里必须存在才能选到' , fill : '选择物料编码,如 SCREW-M3;选不到=还没建该物料档案' },
{ name : '批次号' , source : '留空系统自动生成(日期+序号);也可手工填。' , purpose : '区别不同到货批次,实现先进先出(FIFO)' , fill : '默认留空自动生成;供应商自带批号时可手填' },
{ name : '数量' , source : '手工填写整数。' , purpose : '本批到货数量' , fill : '整数 ≥1' },
2026-09-02 08:21:11 +08:00
{ name : '区域' , source : '下拉选择(必填)。数据来自"区域维护"。' , 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 : '供应商名称,可空' },
{ name : '批量导入' , source : '本页签下方。' , purpose : '整表校验后一次性入库' , fill : '模板(首行忽略表头):物料编码 | 批次号(可空自动生成) | 数量 | 生产日期 | 供应商 | 区域 | 备注。任一行错误则整体回退' }
2026-08-28 17:23:44 +08:00
]
},
{
2026-09-03 18:13:59 +08:00
title : '精密件 SN 入库(页签2) ' ,
overview : '适用于芯片、器件等需要单件追溯的来料,一件一个 SN。录入与 Excel 批量导入都在本页签。' ,
2026-08-28 17:23:44 +08:00
fields : [
2026-09-01 13:49:44 +08:00
{ name : '物料' , source : '下拉选择(必填)。来自"物料档案"类型为"精密件"的物料。' , purpose : '入库的精密件物料' , fill : '选择物料编码' },
2026-09-02 08:21:11 +08:00
{ name : '区域' , source : '下拉选择(必填)。来自"区域维护"。' , purpose : '放到哪个库区' , fill : '必填;新到货一般先放"待检"区' },
2026-09-03 18:13:59 +08:00
{ name : '扫码录入' , source : '扫码枪连续扫码。来自每颗器件自带的 SN 条码。' , purpose : '逐件登记 SN,实现单件追溯' , fill : '扫入/粘贴 SN 后点【录入到列表】加入清单,可一次连续多条' },
{ name : '批量导入' , source : '本页签下方。' , purpose : '整表校验后一次性入库' , fill : '模板(首行忽略表头):物料编码 | SN | 区域 | 生产日期 | 供应商。任一行错误则整体回退' }
2026-08-28 17:23:44 +08:00
]
},
{
2026-09-03 18:13:59 +08:00
title : '入库记录(页签3) ' ,
overview : '分页展示全部入库单,结构件与精密件同表(用"类型"列区分)。支持按入库单号、物料编码、类型、关键字、入库时间筛选;可按当前条件导出 xlsx。点行「明细」在右侧抽屉查看该单的批次号/SN 行(懒加载+分页,避免精密件上万条 SN 撑爆前端)。' ,
2026-08-28 17:23:44 +08:00
fields : [
2026-09-03 18:13:59 +08:00
{ name : '查询条件' , source : '本页签顶部筛选区。' , purpose : '缩小列表范围' , fill : '可组合:入库单号(模糊)/物料编码(模糊)/类型(全部·结构件·精密件)/关键字(物料名称或单号)/入库时间区间' },
{ name : '明细' , source : '行末「明细」按钮 → 右侧抽屉。' , purpose : '查看该入库单的批次号/SN/数量明细' , fill : '抽屉内分页展示,不回列表里嵌套子表' },
{ 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-03 14:20:37 +08:00
'所有出库都落在同一张「出库主表」(OutboundOrder),用"类型"区分,装箱信息(箱号/SN清单/合同号)也直接记在主表上,不再单独建装箱表。\n两个出库页签 + 一个记录页签:\n· 工单备料出库(MES):对接 MES 工单台账领料,强约束"单物料累计出库 ≤ 工单需求总量";未启用 MES 或工单未同步时,工单下拉可能为空,可直接手输工单号(需台账已同步)。\n· 通用出库:不依赖工单的手动出库(退料/样品/报废/发货),支持结构件批次与精密件 SN,填箱号即一并记录装箱;MES 不可用或无需挂靠工单时请用本页。\n· 出库记录:统一主表的全量查询与导出(一键导出 CSV,含装箱信息)。\n选用原则:有 MES 工单要按 BOM 领料 → 工单备料出库;无工单的自由出库/装箱发货 → 通用出库。' ,
2026-08-28 17:23:44 +08:00
fields : [
2026-09-03 14:20:37 +08:00
{ name : '备料出库-工单号' , source : '手动输入。数据来自 MES 已建的工单及导入的物料台账。' , purpose : '出库挂靠的工单,决定可领料总量与需求缺口' , fill : '输入工单号回车,查询该工单的物料台账' },
{ name : '备料出库-目标工位' , source : '手动填写。' , purpose : '本次配送送达的接驳台/DOCK' , fill : '如 DOCK-A,可空' },
{ name : '备料出库-一键分配出库' , source : '系统自动按 FIFO 分配。数据来自合格区Z02的批次库存。' , purpose : '从合格区按先进先出凑够缺口并出库' , fill : '点按钮,系统自动算批次并二次确认' },
{ name : '通用出库-物料/类型' , source : '下拉选择物料;类型选"结构件(批次)"或"精密件(SN)"。' , purpose : '决定走批次扣减还是 SN 扣减' , fill : '选物料后选类型;批次填批次号+数量,SN 扫入 SN 列表' },
{ 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-03 14:20:37 +08:00
'查看当前库存:结构件按批次台账(数量/锁定/区域),精密件按 SN 序列号(状态/区域)。\n数据由入库、出库、盘点等业务实时维护,本页只读查询。\n\n三个层级概念(自下而上):\n· SN 序列号:精密件单件唯一码,可逐件追溯。\n· 批次号:同物料、同一次到货的库存聚合标识(如 B20260901xxxx),一个批次可含多件。\n· 入库单号(IBxxx):一次到货/入库动作的凭证,一个入库单可包含多个批次或多个 SN(以及它们的明细)。\n即:入库单 → 批次/SN → 库存行。库存行上的"入库单号"即它的来源凭证,点单号可跳转入库页看该单完整明细。' ,
2026-08-28 17:23:44 +08:00
fields : [
2026-08-29 08:11:44 +08:00
{ name : '物料编码' , source : '筛选条件。' , purpose : '只看某物料' , fill : '输入编码,可空=全部' },
2026-09-02 08:21:11 +08:00
{ name : '库存类型' , source : '单选(批次 / SN 序列)。' , purpose : '看批次台账还是 SN 序列,各自独立分页' , fill : '批次 / SN 序列' },
2026-09-03 14:20:37 +08:00
{ name : '关键字' , source : '筛选条件。' , purpose : '按批次号/物料名称/SN 模糊过滤' , fill : '输入关键字,可空' },
{ name : '入库单号' , source : '筛选条件 + 列表列。数据来自每次入库生成的 IBxxx 凭证。' , purpose : '追溯某批库存"来自哪次入库";与批次号不同:批次号是库存聚合标识,入库单号是入库动作凭证(一个单可含多批次/多SN)' , fill : '输入 IB 单号过滤,或点列表里的单号跳转入库明细' }
2026-08-28 17:23:44 +08:00
]
}
export const helpInspection = {
2026-08-29 08:11:44 +08:00
title : '质量检验(来料检)' ,
overview :
2026-09-03 18:13:59 +08:00
'对入库的未检物料/SN 做检验:把"未检"翻转为【合格】或【不合格】。\n检验只修改"质量状态"字段,与物料/SN 的存放区域无关。\n合格品才能参与出库与锁库(库存校验只取质量状态=合格的批次)。\n\n本页分两个页签(录入在前默认打开,记录在后点击才见),参照出库管理:\n· 质量检验录入(常操作,默认打开):单条与批量已合并为同一处——扫码枪连续扫、或从"库存"下拉直接选,都先进入下方"已选清单",点一次"提交检验"统一翻转。\n· 检验记录(点击才加载):分页查询历史检验记录,支持按 批次/SN、物料、检验类型、结论、检验员、时间 筛选与导出。\n编号是否真实存在会即时校验:找不到对应库存记录的编号会直接报错,不会"提示成功但库存仍是未检"。' ,
2026-08-28 17:23:44 +08:00
fields : [
2026-09-03 14:20:37 +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 : '列在此处的编号,点【提交检验】一次性翻转' },
{ name : '检验记录-筛选/导出' , source : '切换到"检验记录"页签后可见。' , purpose : '按条件分页查询历史记录并导出' , fill : '支持按 批次/SN、物料编码、检验类型、结论、检验员、时间范围 组合筛选;点【导出】下载 xlsx' }
2026-08-28 17:23:44 +08:00
]
}
export const helpStocktake = {
2026-08-29 08:11:44 +08:00
title : '盘点(库存核对)' ,
overview :
'核对账面与实际库存,支持扫码快速盘点,完成时按差异修正库存。\n流程:发起盘点(冻结快照) → 扫码录入实盘数(入库) → 完成并生成差异(可选:差异写回库存)。' ,
2026-08-28 17:23:44 +08:00
fields : [
2026-08-29 08:11:44 +08:00
{ name : '操作人' , source : '登录账号自动带出。' , purpose : '发起盘点人' , fill : '自动' },
{ name : '发起盘点' , source : '按钮操作。' , purpose : '冻结当前库存快照,生成盘点单' , fill : '点按钮发起' },
{ name : '差异写回库存' , source : '开关。' , purpose : '完成后是否用实盘差异修正账面库存' , fill : '开=写回;关=仅记录差异' },
2026-09-01 13:49:44 +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 = {
title : '半成品/成品(流转)' ,
2026-08-29 08:11:44 +08:00
overview :
2026-09-01 14:30:26 +08:00
'产线工位"暂存/退回"的半成品或完工成品先在此入库(记已完成工序),需要时再出库(重上线),MES 从下一工序继续。\n\n闭环逻辑(与 MES 自动打通):\n' +
'① 工位终端"暂存退库" → 调 MES 工序流转接口 → MES 自动调 WMS /api/internal/semi/inbound 入库(带 SN、工单号、已完成工序码)。\n' +
'② WMS 收到后生成"半成品库存"记录,并写入 SN 台账,状态=在库。\n' +
'③ 该件后续要接着做时,在本页"半成品出库"或 MES 重上线 → WMS /api/internal/semi/outbound 把状态置为出库。\n' +
'④ MES 据此下发下一工序,工位继续装配,直至完工。\n\n' +
'SN 是两系统唯一的追溯锚点,因此物料编码非必填:MES 调用时不传,WMS 会优先用请求里的、其次按 SN 反查序列号台账,都没有则留空,不影响闭环。' ,
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-01 14:30:26 +08:00
{ name : '物料' , source : '下拉选择。来自物料档案。' , purpose : '入库物料(MES 自动同步时通常留空,由 WMS 反查)' , fill : '选择物料编码' },
{ 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-03 18:13:59 +08:00
'实时展示每个工单下每个物料:需求总量、累计已出库、剩余缺口。\n系统强约束"累计出库 ≤ 需求总量",达到即标记"领料完结",禁止再出库。\n数据链路:MES 工单 + 物料清单(BOM) → 同步导入本台账 → 出库时自动扣减累计,形成缺口 / 完结。\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 : '输入工单号(可空=查全部工单)' },
{ name : '物料编码' , source : '筛选条件。' , purpose : '按物料编码精确过滤' , fill : '输入物料编码(可空)' },
{ name : '物料名称' , source : '筛选条件。' , purpose : '按物料名称模糊过滤' , fill : '输入物料名称关键字(可空)' },
{ name : '状态' , source : '筛选条件。可选项:进行中 / 领料完结。' , purpose : '只看某一领料状态的行' , fill : '下拉选择;全部=不过滤' },
{ name : 'ID' , source : '台账记录主键(系统生成,只读)。' , purpose : '唯一标识一行台账,便于定位与对接' , fill : '系统自动生成,无需填写' },
{ name : '需求总量 / 已出库 / 缺口' , source : '系统计算。需求总量来自 BOM;已出库随出库自动累加;缺口 = 需求总量 − 已出库。' , purpose : '一眼看清某物料还差多少未领' , fill : '自动;缺口为 0 即领料完结' },
{ name : '状态标签' , source : '系统判定。' , purpose : '进行中=仍有缺口;领料完结=已足额出库' , fill : '自动' }
2026-08-28 17:23:44 +08:00
]
}
2026-09-02 09:30:17 +08:00
export const helpZone = {
title : '区域维护' ,
2026-08-29 15:30:25 +08:00
overview :
2026-09-02 09:30:17 +08:00
'维护库区字典,供入库/半成品/出库等所有页面的"区域"下拉框选择。\n区域是货品存放的物理库区(如待检、合格 Z02、不合格…);入库时必须指明放到哪个区,质量检验合格后再转移到合格区。\n\n区域字典是库房的第一道地基:先建好区域,入库、检验、出库才能选到正确的存放位置。' ,
fields : [
{ name : '区域编码' , source : '手工填写,仓库自定义(新增后不可改)。' , purpose : '库区唯一编号,入库/出库据此定位存放位置' , fill : '如 Z02、Z05,建议字母+数字,唯一;新增后不可改' },
{ name : '区域名称' , source : '手工填写。' , purpose : '库区中文名,便于识别' , fill : '如 合格区、待检区、不合格区' },
{ name : '说明' , source : '手工填写(可空)。' , purpose : '补充描述' , fill : '可空' }
]
}
export const helpMaterial = {
title : '物料档案' ,
overview :
'定义每一种物料的字典:叫什么、什么规格、是【结构件(批次)】还是【精密件(SN)】。\n此处维护的物料会作为下拉选项出现在入库/出库/装箱等页面;其中"类型"直接决定后续入库方式——结构件走批次(一批多件)、精密件走 SN 逐件扫码(单件追溯)。\n\n物料档案是库房的另一道地基:先建好物料,入库时才能选到;类型选错会导致入库方式与追溯粒度不符。' ,
fields : [
{ 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 : '选择:1=结构件(批次管理) / 2=精密件(SN 管理)。语义由库房定:结构件按批次管理,精密件按 SN 逐件管理。' , purpose : '决定入库方式:结构件走批次、精密件走 SN 逐件扫码' , fill : '结构件(批次) / 精密件(SN)' },
{ 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-08-29 08:11:44 +08:00
overview : '只读看板:库存总量、物料种类、出入库动态等。\n数据实时读取统计接口,本页不可编辑。' ,
2026-08-28 17:23:44 +08:00
fields : []
}