Files
bj_power/bj_power_wms/frontend/src/help.js
T

413 lines
77 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// WMS库房管理 页面级操作说明:整体流程 + 各字段 数据来源/用途/怎么填
// 由 components/PageHelp.vue 在左下角 "?" 按钮弹出展示。
// 说明:这里的"数据来源"特指该字段数据由谁产生、从哪个系统/页面来,帮助跑通真实流程。
export const helpInbound = {
title: '入库(来料入账)',
overview:
'把到货的来料记入 WMS 库存。页签对应"物料档案"的「类型」:结构件入库(类型=结构件) / 电气件入库(类型=电气件) / 其他入库(类型=其他);而每个页签内实际录入方式由所选物料的「序列号」(是否有序列号,物料档案维护)决定:\n· 序列号=是(按 SN 记账) → 按【SN 序列号】逐件扫码,单件追溯;\n· 序列号=否(按批次记账) → 按【批次】入库,一批多件。\n(2026-09-30 类型与序列号(sn_mode)解耦,2026-10-06 页签口径对齐:类型只定页签归属,批次/SN 行为看「序列号」是否。)\n入库是整个库存链路的第一环:入库(Held) → 质量检验(合格Z02) → 之后才能被出库。\n\n本页五个页签(录入在前,记录在后):\n· 结构件入库 / 电气件入库 / 其他入库:选物料后按其「序列号」自动分流 批次数量 或 SN 扫码录入;\n· 批量导入:Excel 整表导入,按序列号(sn_mode)分 序列号=否(按批次记账)模板 / SN 模板(与类型页签无关);\n· 入库记录:分页列表(一单一行),点「明细」在右侧抽屉查看该单的行(懒加载+分页)。\n\n库位四级贯通:每笔入库除选「区域」外,还可录「货架/层/位置」三级货位;选物料后系统自动带入该物料最近一次入库的库位,可手动修改。',
sections: [
{
title: '结构件入库(页签1)',
overview: '页签对应物料档案「类型=结构件」。选物料后按其「序列号」分流:是→SN 扫码录入;否→数量(系统自动记账;生产日期/供应商仅序列号=否(按批次记账)显示)。',
fields: [
{ name: '物料', source: '下拉选择。数据来自 WMS"物料档案"里类型为"结构件"的物料。', purpose: '入库的是什么物料;档案里必须存在才能选到;选定后按其「序列号」决定录入方式', fill: '选择图号,如 SCREW-M3;选不到=还没建该物料档案' },
{ name: '序列号', source: '选物料后自动显示(来自物料档案「序列号」sn_mode)。', purpose: '提示本单走 批次数量 还是 SN 扫码', fill: '只读标签:序列号=是(按 SN 记账)/ 序列号=否(按批次记账)' },
{ name: '数量', source: '序列号=否(按批次记账)显示。手工填写整数。', purpose: '本批到货数量', fill: '整数 ≥1' },
{ name: '扫码录入', source: '序列号=是(按 SN 记账)显示。扫码枪连续扫码,来自每颗器件自带的 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: '必选;选"其他"可不填编号,选"合同号/科技项目号"须填归属编号(≤64 字符)' },
{ name: '产品工号', source: '手工填写(可空)。合同/项目下的二级编号,随入库进入库存,并贯通出库、来料检验、半成品各页展示与筛选。', purpose: '同一合同下区分不同产品套次的细粒度追溯编号', fill: '按合同/车间口径手填;留空则该行不带产品工号' }
]
},
{
title: '电气件入库(页签2)',
overview: '页签对应物料档案「类型=电气件」。录入方式同样由所选物料的「序列号」决定(默认电气件建档案时带"是",但可改):是→SN 扫码;否→数量。',
fields: [
{ name: '物料', source: '下拉选择(必填)。来自"物料档案"类型为"电气件"的物料。', purpose: '入库的电气件物料;选定后按其「序列号」决定录入方式', fill: '选择图号' },
{ name: '扫码录入', source: '序列号=是(按 SN 记账)显示。扫码枪连续扫码。来自每颗器件自带的 SN 条码。', purpose: '逐件登记 SN,实现单件追溯', fill: '扫入/粘贴 SN 后点【录入到列表】加入清单,可一次连续多条' },
{ name: '数量', source: '序列号=否(按批次记账)显示。', purpose: '本次入账数量(批次由系统自动记账)', fill: '数量 ≥1' },
{ name: '区域 / 库位', source: '下拉选择(必填) + 三级货位。来自"区域维护";选物料后自动带入最近入库库位。', purpose: '库位四级贯通', fill: '区域必填;货位可自动带入后手改' },
{ name: '归属 / 产品工号', source: '与结构件入库同口径:归属必选(合同号/科技项目号/其他),产品工号手填可空。', purpose: '追溯维度,随入库贯通出库/检验各页', fill: '归属必选一项;产品工号按需手填' }
]
},
{
title: '其他入库(页签3)',
overview: '适用于辅料、螺栓、工装、试验设备等既非结构件也非电气件的物料;规格型号强制(在物料档案维护,为空则拒绝入库)。录入方式由所选物料的「序列号」决定。',
fields: [
{ name: '物料', source: '下拉选择。来自"物料档案"类型为"其他"的物料。', purpose: '入库的其他类物料;选定后按其「序列号」决定录入方式', fill: '选择图号;规格型号由档案带出,缺失需先补档案' },
{ name: '规格型号', source: '选物料后自动带出(只读)。', purpose: '其他类物料强制记录规格', fill: '只读;为空时无法提交,需先到物料档案补全' },
{ name: '数量 或 扫码录入', source: '按所选物料「序列号」分流:否→填数量;是→SN 扫码。', purpose: '入账方式', fill: '数量 ≥1;SN 连续扫码' },
{ name: '区域 · 货架/层/位', source: '同结构件入库,选物料后自动带入最近库位。', purpose: '库位四级贯通', fill: '选区域,可录三级货位或自动带入' },
{ name: '归属', source: '下拉:合同号 / 科技项目号 / 其他(必选)。', purpose: '标记该批其他物料归属哪个合同或科技项目', fill: '必选一项;选"其他"可不填编号,选"合同号/科技项目号"须填归属编号' },
{ name: '产品工号', source: '手工填写(可空),随入库贯通出库/检验/半成品各页。', purpose: '同一合同下区分产品套次的二级编号', fill: '按需手填' },
{ name: '检测单号', source: '手工填写(必填)。', purpose: '检测单号是您手里的纸面单据号,用于关联后来的来料检验记录。填写后,系统会尽力带出对应的检验结论;如果检验还没录机,系统不会报错,检验录入后会自动关联。', fill: '必填;来料检验从「待检清单」送检时自动继承本单号,也可手填' }
]
},
{
title: '批量导入(页签4)',
overview: 'Excel 整表导入与「类型」页签解耦:后端按每行物料的「序列号」(sn_mode)校验,序列号=否(按批次记账)走批次模板、序列号=是(按 SN 记账)走 SN 模板。整表一次性全导入,任一行错误则整体回退(不写入任何数据)。\n批量导入提供按批次和按序列号两种模式。点击页签标题旁的 ⓘ 图标可查看字段要求、常见错误,并可下载对应 Excel 模板;建议先下载模板,按模板格式填写后导入。',
fields: [
{ name: '序列号=否导入', source: '左侧上传区。仅接受物料档案「序列号=否」的物料。', purpose: '按批次批量入账', fill: '模板(首行忽略表头):图号 | 数量 | 生产日期 | 供应商 | 区域 | 架 | 层 | 位 | 备注 | 检测单号 | 产品工号 | 归属类型 | 归属编号(批次号由系统自动生成,模板不含该列;架/层/位/检测单号必填)。序列号=是 的物料会被整表拒绝' },
{ name: 'SN 件导入', source: '右侧上传区。仅接受物料档案「序列号=是」的物料。', purpose: '按 SN 逐件批量入账', fill: '模板(首行忽略表头):图号 | SN | 区域 | 生产日期 | 供应商 | 架 | 层 | 位 | 备注 | 检测单号 | 产品工号 | 归属类型 | 归属编号。SN 文件内去重 + 在库查重;序列号=否 的物料会被整表拒绝' },
{ name: '导入结果', source: '页签下方结果卡片。', purpose: '成功行数/生成入库单号/错误行明细', fill: '成功:列出每张入库单号(点击复制);失败:按行列出错误原因,整体回退' }
]
},
{
title: '入库记录(页签5)',
overview: '分页展示全部入库单,结构件/电气件/其他同表(用"类型"列区分)。支持按入库单号、图号、类型、物料名称、归属单号、产品工号、入库时间筛选(各字段独立,无关键字混搜);列表含「区域」「库位」「检测单号」「质量状态」「归属」「产品工号」列;可按当前条件导出 xlsx。点行「明细」在右侧抽屉查看该单的行(懒加载+分页,避免序列号=是(按 SN 记账)上万条 SN 撑爆前端)。',
fields: [
{ name: '查询条件', source: '本页签顶部筛选区。', purpose: '缩小列表范围', fill: '可组合:入库单号(模糊)/图号(模糊)/类型(全部·结构件·电气件·其他)/物料名称(模糊)/归属单号(模糊·合同号/科技项目号)/产品工号(模糊)/状态(全部·有效·已作废)/入库时间区间' },
{ name: '状态 / 作废', source: '行「状态」列 + 行末「作废」按钮(权限 inbound:void)。', purpose: '作废错误入库单并回滚库存', fill: '点「作废」填写作废原因→确认;序列号=否(按批次记账)按批次回滚数量、序列号=是(按 SN 记账)按 SN 精确回滚(不影响其它单);已出库的批次或 SN 须先处理' },
{ name: '明细', source: '行末「明细」按钮 → 右侧抽屉。', purpose: '查看该入库单的明细(数量/SN,批次号为系统内部编号)', fill: '抽屉内分页展示,不回列表里嵌套子表' },
{ name: '附件', source: '入库单行内附件(AttachmentPanel)。', purpose: '为入库单上传/查看随货单据、质检报告等附件', fill: '点行内附件按钮,在抽屉中上传或查看' },
{ name: '导出', source: '按钮。后端 /inbound/export 按当前条件返回全部(不分页)。', purpose: '把筛选结果一次性导出为 xlsx', fill: '点【导出】下载"入库管理.xlsx"' }
]
}
]
}
export const helpOutbound = {
title: '出库管理(统一主表)',
overview:
'所有出库都落在同一张「出库主表」(OutboundOrder),用"类型"区分,装箱信息(箱号/SN清单/合同号)也直接记在主表上,不再单独建装箱表。\n三个页签:\n· 工单领料出库(操作):按 MES 产品工号查询 WMS 同步台账领料,强约束"单物料累计出库 ≤ 工单需求总量";产品工号下拉选择(来自 MES 实时工单,未完成优先,无输入默认展示前 20 条),支持输入模糊搜索;MES 不可达或工单未同步时下拉可能为空,可手输兜底(需台账已同步)。\n· 通用出库:不依赖工单的手动出库(退料/退货/样品/报废/发货/其他),支持序列号=否(按批次记账)(数量)与序列号=是(按 SN 记账)(SN),填箱号即一并记录装箱;MES 不可用或无需挂靠工单时请用本页。\n· 出库记录:统一主表的全量查询与导出(一键导出 CSV,含装箱信息),含产品工号与目标工位。\n选用原则:有 MES 工单要按 物料清单 领料 → 工单领料出库(操作);无工单的自由出库/装箱发货 → 通用出库。\n\n通用出库操作顺序(客户诉求 问题17/18/20):① 先选物料(下拉统一显示 编码/图号/类型/物料类别)→ ② 系统自动判定序列号(sn_mode)(序列号=是(按 SN 记账)/序列号=否(按批次记账),由物料档案 sn_mode 决定,无需手选)→ ③ 选出库类别(纯标签,不联动任何地方;选「其他」时备注必填原因)→ ④ 填归属(合同号/科技项目号/其他,非其他时编号必填)→ ⑤ 序列号=否(按批次记账)从可用批次下拉选批次(默认 FIFO 首个)并填数量 / 序列号=是(按 SN 记账)逐个扫 SN → ⑥ 选目标工位(下拉,来自 MES 工位列表,不可手输)。\n\n说明:出库单号由系统自动生成、不可修改,规则与入库一致(入库 IB+ / 出库 OB+ 同一编号规则);出库无法与入库批次/合同对应,故出库类别仅是标签记录,列表与出库单都显示。质量门禁:发货/样品/其他类出库仅允许「合格」品;退货/报废/退料类豁免(本身即处置不合格品)。',
fields: [
{ name: '备料出库-产品工号', source: '下拉选择 + 模糊搜索。数据来自 MES 实时工单(未完成优先,无输入默认前 20 条)。', purpose: '出库挂靠的工单,决定可领料总量与需求缺口', fill: '下拉选产品工号(或输入关键字模糊搜索;MES 不可达时可手输兜底),选中即查询该工单的物料台账' },
{ name: '备料出库-目标工位', source: '下拉选择 DOCK01~DOCK20(选填,可过滤搜索)。', purpose: 'AGV 配送送达的接驳台(toDock 参数)', fill: '选择如 DOCK05;不选默认运到产线入口 DOCK01' },
{ name: '备料出库-一键分配出库', source: '系统自动按 FIFO 分配。数据来自合格区Z02的批次库存。', purpose: '从合格区按先进先出凑够缺口并出库', fill: '点按钮,系统自动算批次并二次确认' },
{ name: '通用出库-物料', source: '下拉选择(全项目统一组件)。', purpose: '选定要出库的物料', fill: '下拉显示 编码/图号/类型(电气件/结构件/其他)/物料类别(原材料/成品),支持远程搜索' },
{ name: '通用出库-序列号', source: '系统自动判定(来自物料档案的「序列号=是(按 SN 记账)」设置 sn_mode)。', purpose: '决定走批次扣减还是 SN 扣减(2026-09-30 与物料类型解耦)', fill: '只读:选物料后自动显示序列号=否(按批次记账)或序列号=是(按 SN 记账),无需也不允许手选' },
{ name: '通用出库-出库类别', source: '下拉点选(纯标签记录,不联动任何地方)。', purpose: '区分退料/退货/样品/报废/发货/其他,列表与出库单均显示', fill: '必选;选「其他」时需在备注填写具体原因' },
{ name: '通用出库-归属', source: '下拉选归属类型 + 手填归属编号。', purpose: '记录出库归属(合同号/科技项目号/其他),仅追溯不联动 MES', fill: '默认「其他」;选合同号/科技项目号时归属编号必填,长度≤64' },
{ name: '通用出库-目标工位', source: '下拉选择(来自 MES 工位列表,不允许手输)。', purpose: '出库送到哪个装配工位,出库记录留痕工位号', fill: '下拉选工位(可搜索);选填' },
{ name: '通用出库-出库批次', source: '序列号=否(按批次记账):下拉选择该物料在库可用批次(显示 入库日期·可用数量·供应商,批次号不出现)。序列号=是(按 SN 记账):逐个扫 SN。', purpose: '定位从哪批扣减/扣减哪些 SN', fill: '序列号=否(按批次记账)默认带出 FIFO 首个可用批次可改;同日多批末尾标注「第N批」;序列号=是(按 SN 记账)扫入 SN 列表(必填)' },
{ name: '通用出库-区域 / 货架 / 层 / 位置(四级库位)', source: '与入库同口径的逐级联动下拉(选填)。选物料或出库批次后自动带入:① 该批次在库的实际库位 ② 该物料最近一次入库库位 ③ 都无则按所选区域推荐同区空位。', purpose: '指明从哪个货位取料,免手工挑选,出库留痕到具体货位', fill: '选物料/出库批次即自动填入四级,可逐级手动改;切换上级会自动清空下级' },
{ name: '通用出库-箱号', source: '手动填写(选填)。', purpose: '整箱发货时填写,装箱信息随出库单记录(无需再单独录入装箱)', fill: '填箱号后,本出库单即带装箱属性,可在"出库记录"按箱号追溯' },
{ name: '通用出库-合同号', source: '手动填写(选填)。', purpose: '关联合同,便于按合同追溯', fill: '可空' },
{ name: '出库记录-产品工号', source: '随库存自动带入:出库扣减某批次/SN 时,取该库存行上的产品工号写入出库单(入库时手填的二级编号)。', purpose: '出库按产品工号贯通追溯,与入库记录、来料检验、半成品口径一致', fill: '只读;出库记录「产品工号」列展示,筛选区可按其模糊过滤' },
{ name: '出库方式(备料/补料/通用)', source: '系统按来源自动写入:备料=按日排产自动出库;补料=工位叫料或数量不符补发(优先发);通用=本页手工出库。', purpose: '区分出库来源,仓库先发补料', fill: '只读,可在"出库记录"按出库方式筛选' },
{ name: '出库状态(已出库/已送达)', source: '系统维护:出库即记「已出库」;叫 AGV 配送到位后自动转「已送达」。工位接料在 MES 备料单上确认,不在本表。', purpose: '跟踪料是否已送到接驳台', fill: '只读,可按状态筛选' },
{ name: '超领原因', source: '出库数量超过工单物料清单需求时必填(损耗/报废/返修)。', purpose: '超领不硬卡但必须留痕,可统计、可预警', fill: 'WMS/MES 出库时按提示填写原因后放行' },
{ name: '出库记录-导出 CSV', source: '按钮操作。', purpose: '把统一主表当前筛选结果一次导出为 CSV(含库位/箱号/装箱SN)', fill: '点【导出 CSV】下载全部出库记录' }
]
}
export const helpInventory = {
title: '库存查询',
overview:
'查看当前库存:全物料类别统一一张库存主表——原材料(序列号=否(按批次记账)按批次/序列号=是(按 SN 记账)按SN)、半成品(MES 暂存退库)、成品(MES 完工自动回流,系统生成 SN)。半成品不计入本页三个聚合视图(物料汇总/库位明细/区域汇总),其流转在「半成品管理」单独记录,避免与库存体系重复统计。数据由入库、出库、检验、盘点及 MES 回流等业务实时维护,本页只读。\n\n本页四个视图页签(首屏默认「物料汇总」):\n· 物料汇总:一物料一行,直接回答"这个物料总共有多少"——总量 + 质量分布(合格/未检/不合格) + 分布在哪些区域;点行下钻该物料的批次/SN 明细。\n· 库位明细:按 物料 × 区域 × 货架 × 层 × 位置 聚合(质量三列与批次/SN 数为列,不进分组键),支持区域→货架→层→位置四级联动筛选 + 质量快捷筛选(全部/未检/合格/不合格);点击行下钻批次/SN 明细。\n· 区域汇总:一区域一行六列(合格/未检/不合格/结构件/电气件/其他)+最近入库时间;质量状态与类型均降为列、不再拆行。\n· 缺料补货:拉取 MES 未来5天排产需求,对比本地可用量,分两列列出「安全库存补货量」(常规补货)与「排产缺料量」(订单驱动紧急补料),在途量暂无数据源显示"—";排产窗口标注需求起止日期。\n\n层级概念:入库单 → 批次/SN → 库存行。区域/库位/质量状态/批次/最近入库时间都是某物料的一对多属性,放在下钻明细中查看,不在物料行上并排平铺。\n\n口径一致:三个聚合视图(物料汇总/库位明细/区域汇总)默认均排除半成品、仅统计「在库/锁定」状态,切换页签数字自洽;导出与对应视图同口径。',
fields: [
{ name: '图号 / 物料名称', source: '筛选条件(物料汇总、库位明细视图生效)。', purpose: '只看某个物料', fill: '输入图号或名称,可空=全部' },
{ name: '库存类型', source: '单选(全部/结构件/电气件/其他)。结构件=类型1且排除「其他」;电气件=类型2;其他=类型3(辅料/工装/试验设备)。', purpose: '纯分类筛选(2026-09-30 类型与序列号(sn_mode)解耦):类型不再决定批次/SN 行为,序列号(sn_mode)由物料档案「序列号=是(按 SN 记账)」(sn_mode)独立决定', fill: '全部 / 结构件 / 电气件 / 其他;物料汇总与库位明细视图生效' },
{ name: '归属单号', source: '筛选条件(物料汇总、库位明细视图生效)。归属编号来自入库时登记的「归属」(合同号/科技项目号/其他编号)。', purpose: '库存按归属查(问题8):物料汇总是先按归属模糊过滤库存行、再按物料聚合,总数量/批次数/SN数与质量分布均只统计归属命中的行,口径与库位明细一致', fill: '模糊输入合同号/科技项目号等归属编号(大小写不敏感),回车或点【查询】生效;清空后查询恢复全量' },
{ name: '物料类别', source: '单选(全部/原材料/半成品/成品)。', purpose: '按物料类别过滤:原材料=采购到货入库;半成品=MES 工位暂存退库;成品=MES 完工自动回流(成品 SN 系统生成,入库单号形如 MES:产品工号)。注意:选「全部」时三个聚合视图默认排除半成品(半成品在「半成品管理」单独记录),需显式选「半成品」才会纳入', fill: '全部 / 原材料 / 半成品 / 成品;物料汇总与库位明细视图生效' },
{ name: '库位明细-区域/货架/层/位置', source: '四级联动下拉(仅「库位明细」视图生效)。区域来自"区域维护";选区域后联动出货架、选货架联动出层、选层联动出位置,上级清空自动清空下级。', purpose: '精确到货位筛选库存,与入库/出库库位四级贯通', fill: '逐级选择;只选区域也可只按大区筛;切换上级自动清空下级' },
{ name: '库位明细-质量状态', source: '单选(全部/未检/合格/不合格,仅「库位明细」生效)。', purpose: '不合格品一屏定位(需求A5)', fill: '选「不合格」直接看所有隔离中的不良库存' },
{ name: '库位明细-入库时间', source: '仅「库位明细」生效的日期筛选(默认近3个月起)。', purpose: '按入库时间收窄', fill: '可与区域/质量组合' },
{ name: '区域汇总-六列', source: '系统实时聚合,一区域一行。', purpose: '质量(合格/未检/不合格)与类型(结构件/电气件/其他)都已降为列,避免同区拆多行;最近入库时间取该区最近一笔入库', fill: '只读:序列号=否(按批次记账)=批次数量、序列号=是(按 SN 记账)=SN 单件、其他=辅料工装试验设备;具体货架/层/位置四级货位见「库位明细」下钻' },
{ name: '数量等式(七大域审计)', source: '系统实时计算,本页只读。', purpose: '保证库存数量自洽', fill: '库存量(总数) = 合格 + 未检 + 不合格(质量分布守恒)' },
{ name: '库存变动计算公式(九类业务,页面显示数量与此一致)', source: '后端事务内原子计算,全链路实时维护,本页只读。', purpose: '把每次库存数量怎么变讲清楚,避免账实不符', fill: '统一记法:库存行 quantity=在库数量;可用数量(avail)=在库量 − 未检量 − 不合格量 − 锁定量(仅质量状态=合格 的行计入可用;lockedQty 为内部锁定机制,页面不显示「锁定量」字样)。\n· ① 入库:库存行 quantity += 入库数量(序列号=否 按 batchNo 累加同一批次行;序列号=是 按 snCode 每行 +1 新建);\n· ② 出库(通用/备料/补料):库存行 quantity −= 出库数量,强约束 出库数量 ≤ avail(库位可用量);SN 出库要求 SN 在当前所填库位、行 status∈{在库,锁定};\n· ③ 检查/来料检验:不改 quantity,只翻转 qualityStatus(未检→合格/不合格);不合格隔离处置(退货/换修/报废/部分入库)改 qualityStatus 与 status,不影响其它行;\n· ④ 可用数量:avail = 在库量 − 未检量 − 不合格量 − 锁定量 =(合格 行数量合计)− lockedQty(列表「可用量」列与备料/出库校验同口径;lockedQty 内部保留不向用户展示);\n· ⑤ 报废:库存行 quantity −= 报废数量,并置生命周期=报废,退出可用(avail 同步下降);\n· ⑥ 领料出库(工单备料台账):库存行 quantity −= 出库数量,台账 out_qty += 出库数量;净领用 = 已出库 − 已退回,缺口 = 需求总量 − 净领用(净领用=需求即领料完结);\n· ⑦ 工单备料台账:需求总量(同步自 MES 备料单) = 净领用 + 剩余缺口;在途/线边 = 净领用 − 已消耗;\n· ⑧ 成品入库(手工/完工回流):库存行 quantity += 1(序列号=是 单件,snCode 唯一),物料类别=成品;\n· ⑨ 退库确认:库存行 quantity += 退库数量(剩余物料置未检、问题物料置不合格),并回写台账「退回量」使缺口恢复可再叫料。' },
{ name: '物料汇总-质量分布', source: '系统按当前在库行统计。', purpose: '一个物料合格/未检/不合格各多少', fill: '合格/未检/不合格三列,自动统计' },
{ name: '物料汇总-分布区域', source: '系统统计该物料当前占用了哪些区域。', purpose: '一个物料可跨多个区域存放(批次可拆分),物料行不写死单一区域', fill: '如 Z02、Z05;点行下钻可看每个批次/SN 具体在哪个区' },
{ name: '批次/SN 明细(下钻)', source: '点击任一行弹出抽屉。', purpose: '看该物料的每个批次/SN 所在区域、质量状态与来源入库单', fill: '抽屉内分页展示;点入库单号可跳转入库页' },
{ name: '抽屉-在库处置(不合格品处置)', source: '抽屉内「在库」库存行操作列「处置」按钮。', purpose: '合格入库后的物料在使用中发现不合格,直接从库存行发起退货/换修/报废,无需绕道补录检验记录(自动生成一条不合格留痕检验记录)', fill: '退货(必填货运单号→系统自动生成退供应商出库单并真实扣减库存,一步闭环);换修(置不合格隔离,待返修);报废(不合格+报废,退出可用)。仅「在库」行可发起。在库处置支持部分数量:序列号=否(按批次记账)选退货/换修/报废时可填处置数量(默认=行数量),原行保留剩余数量继续在库;拆分行按处置方式隔离(退货→待退并随退供应商出库单出库、换修/报废→不合格),备注注明部分处置 x/y;序列号=是(按 SN 记账)不支持部分数量' },
{ name: '抽屉-复检(换修闭环)', source: '抽屉内「在库 + 不合格」库存行操作列「复检」按钮(换修/隔离后的不良品修复后走此关闭回路)。', purpose: '针对不合格在库行重新判定,闭合换修/不合格处置后续', fill: '合格(回用)→质量置合格、回可用;不合格(转处置)→选退货(必填货运单号,自动退供应商出库)或报废(置报废退出可用)。全程生成复检留痕检验记录' },
{ name: 'ID / 创建时间', source: '物料汇总行取物料主表(material),区域汇总行取区域主表(zone)。', purpose: '行标识与主档建立时间,用于追溯与对账', fill: '系统自动带出,只读;物料档案/区域缺失时显示 -' },
{ name: '缺料补货(视图四)', source: '拉取 MES /api/internal/material-demand(未来5天日排产需求)对比本地可用量实时计算。', purpose: '一眼看出需补什么、补多少:「安全库存补货量」(常规补货) 与「排产缺料量」(订单驱动紧急补料) 分两列、不合并', fill: '排产缺料量>0 标红、安全库存补货量>0 标橙;在途量暂无数据源显示"—"不臆造;排产窗口显示需求起止日期;顶部标注 MES 拉取时间' },
{ name: '导出', source: '按钮(权限 inventory:export)。后端按当前视图全量导出 xlsx。', purpose: '把结果导出存档', fill: '物料汇总→「物料汇总.xlsx」;库位明细→「库存明细.xlsx」;区域汇总→「区域汇总.xlsx」;缺料补货视图数据随 MES 排产动态变化,不提供导出' },
{ name: '生产退不良(视图五)', source: '页面签五「生产退不良」。产线使用中(已出库/已消耗)发现的不良品退回库房隔离的登记入口。', purpose: '已出库/已消耗的物料,产线用后才发现坏,在此登记退回:系统重建隔离库存行(质量=不合格,不进可用),随后到「库位明细」按质量筛选「不合格」找到该行,走「在库处置」(退货/换修/报废)完成闭环', fill: '必填:始发工位号、关联产品工号、物料编码、退回数量、质量原因;序列号=是(按 SN 记账)逐行录入 SN(数=数量),序列号=否(按批次记账)可填批次号(留空自动生成);退回隔离区四级库位可选。提交即重建隔离库存行并生成退不良单(RECEIVED),全程事件日志留痕' }
]
}
export const helpInspection = {
title: '来料检验',
overview:
'【检验分工与边界】本页仅做来料检(WMS 仓储作业)。过程检、完工检的生产质检已收口至 MES(巡检终端 + 质量检验页),不在 WMS 录入。\n· 来料检(incoming):对采购/外协到货、入库前的物料验收,按入库批次/SN 判定。合格才能入库上架,不合格隔离退货。从库存选批次仅列出未检状态;已检对象不可重复送检,不合格品重新判定走复检。\n\n【检验做什么】把库存行的“质量状态”从未检翻转为合格/不合格,与存放区域无关。库存校验只取质量状态=合格的行参与出库。\n\n【报检数守恒】报检数 = 合格数 + 不合格数;合格数不得大于报检数;判定合格时合格数应等于报检数(否则请改判不合格并选处置方式)。\n\n【不合格处置(需求23 换修闭环)】判不合格必选处置:退货(须填货运单号、库存置待退) / 换修(隔离为不合格,等返修后重新报检) / 报废 / 部分入库(仅序列号=否(按批次记账):一次只处理 1 个批次,按合格数拆行)。已判不合格的记录也可在列表里再次处置。\n\n【序列号=否(按批次记账) vs 序列号=是(按 SN 记账)/其他的不合格口径】\n· 序列号=否(按批次记账):一行数量 N,判不合格=整批隔离;“N 里坏 M 个”用「部分入库」填合格数 N−M,系统拆出 (N−M) 合格批次 + M 不合格批次。\n· 序列号=是(按 SN 记账)/其他:逐个判定(检验数固定 1),每个 SN/件一条记录、一行库存,选中判不合格即隔离该件,无需拆分。\n\n【归属口径(需求22)】归属类型 = 合同号 / 科技项目号 / 其他,默认“其他”。这里的“合同号”是独立维度标签,与 MES 产品工号不是同一东西;手动输入、不联动 MES、不校验格式(长度≤64)。\n\n【按物料统计】统计页需先选择物料再点“统计”,不做全表实时聚合。\n\n本页四个页签(录入在前、记录在后点击才加载):\n· 质量检验录入(默认打开):逐个判定——每一条待检目标(批次号/SN)独立成一行,分别选结论、填检验数/合格数,不合格数=检验数−合格数自动算出;整组点一次「提交」调 /inspection/batch-flip 原子翻转,多行同 id 自动去重。\n· 待检清单:按入库单分组展示(主行=入库单,展开看该单的批次/SN 明细与未检数量),支持整单送检、单条送检、跨行勾选送检;送检即把目标回填到「质量检验录入」并带入归属,免去手输编号。\n· 检验记录(点击才加载):历史判定记录,含「不合格数」列(=检验数−合格数,后端复核)。\n· 按物料统计:选物料后聚合其检验次数与合格率。\n\n菜单仅「来料检验」一个入口(过程检/完工检已移至 MES)。每条检验记录可上传/查看附件(检测报告/照片)。',
fields: [
{ name: '检验边界', source: 'WMS 仅来料检。', purpose: '来料检=入库验收;过程检/完工检在 MES 完成', fill: '按左侧「来料检验」菜单进入' },
{ name: '目标类型', source: '单选,决定录入框标题与可选库存范围。完工检固定为 SN,不展示切换。', purpose: '检验对象:序列号=否(按批次记账) / 序列号=是(按 SN 记账) / 其他(辅料·工装·试验设备,按 1 件判定);按序列号(sn_mode)划分,与物料类型无关', fill: '序列号=否(按批次记账) BATCH / 序列号=是(按 SN 记账) SN / 其他 OTHER(任一切换都会自动刷新“从库存选”下拉与可选库存范围)' },
{ name: '检验结论', source: '单选。', purpose: '判定结果', fill: '合格 / 不合格' },
{ name: '记录人 / 审核人', source: '手动填写(默认当前用户)。完工检显示为“审核人”。', purpose: '谁检验/审核的,追溯用', fill: '姓名' },
{ name: '从库存选待检编号', source: '下拉选择,数据来自当前库存(按目标类型过滤;完工检只列成品 category=3)。', purpose: '避免手输编号、防止输错', fill: '批次行显示 图号·入库日期·可用数量·供应商(批次号为系统内部编号,不显示),SN 行显示 SN;选中自动加入清单' },
{ name: '录入待检编号', source: '扫码枪/粘贴。条码为系统内部编号(批次)或 SN。', purpose: '单条或多条待检编号', fill: '扫入或粘贴后点【录入到列表】,多编号用逗号/分号/空格/回车分隔;每条独立成行参与逐个判定' },
{ name: '待检清单(页签二)', source: '调用 /inspection/pending 按入库单分组(主行=入库单,展开看批次/SN 明细与未检数量)。', purpose: '无需手输编号即可把待检目标送进录入页,杜绝输错', fill: '支持 整单送检(该单全部未检目标)/ 单条送检(展开行内单个目标)/ 跨行勾选送检(勾选多条后批量送);送检即回填「质量检验录入」并带入归属,可在此页按 图号/入库类型/目标类型 筛选' },
{ name: '逐个判定(录入页)', source: '录入页以「条目」为单位:每一条待检目标(批次号/SN)独立成一行,各自选结论、填检验数/合格数,不合格数=检验数−合格数自动算出。', purpose: '一条入库单往往含多批次/SN,逐个判定互不串扰', fill: '点「提交」整组一次性调 /inspection/batch-flip 翻转;同一 targetId 多行自动去重;选「合格」时合格数默认等于检验数,选「不合格」须填不合格处置' },
{ name: '检验数 / 合格数', source: '序列号=否(按批次记账)可编辑;序列号=是(按 SN 记账)/其他固定 1 件判定、不可改数。守恒:检验数 = 合格数 + 不合格数。', purpose: '量化该条目标的抽检结果', fill: '序列号=否(按批次记账):合格数≤检验数,判合格时两者相等;序列号=是(按 SN 记账)/其他:固定 1/1(合格) 或 1/0(不合格),不合格即整件隔离、无需拆分' },
{ name: '第几批 / 共几件', source: '已选清单内两个数字输入,选中物料后按其序列号(sn_mode)分流。', purpose: '序列号=否(按批次记账)来料检验记录本次是第几批、到货共几件,随检验记录留存追溯', fill: '序列号=否(按批次记账)两个必填、均≥1(不填提交会被拦截,报"序列号=否(按批次记账)来料检验需填写第几批与共几件");序列号=是(按 SN 记账)不显示不填写;检验记录列表与导出同步两列,未填(0)显示 -' },
{ name: '归属', source: '下拉选择类型 + 手动输入编号(默认其他)。', purpose: '标记检验对象归属,便于按归属查询', fill: '合同号 / 科技项目号 / 其他;编号手动输入、不校验格式、长度≤64' },
{ name: '不合格处置', source: '判定“不合格”时必选:退货 / 换修 / 报废 / 部分入库(仅序列号=否(按批次记账)可选,序列号=是(按 SN 记账)/其他不展示该选项)。', purpose: '不合格品不入库、不上产线,须明确去向(需求23 换修闭环)', fill: '退货(填货运单号→待退) / 换修(隔离不合格→待返修) / 报废 / 部分入库(单批次拆批:合格部分入库、差额隔离)' },
{ name: '附件', source: '行内附件抽屉(bizType=检验记录)。', purpose: '为该检验记录上传/查看附件(如检测报告、照片)', fill: '点行内附件按钮,在抽屉中上传或查看' },
{ name: '检验记录-筛选/导出', source: '切换到“检验记录”页签后可见。', purpose: '按条件分页查询历史记录并导出', fill: '支持按 批次/SN、图号/名称/型号(三框模糊)、归属单号、产品工号、检验类型、结论、记录人、时间范围(默认近3个月) 组合筛选;列表含「不合格数」列(=检验数−合格数,后端复核)、「产品工号」列(随入库单带出)与「第几批/共几件」两列(序列号=否(按批次记账)来料检填写,未填显示 -);点【导出】下载 xlsx(含第几批/共几件两列)' },
{ name: '按物料统计', source: '切换到“按物料统计”页签,先选物料再点统计。', purpose: '看某物料的检验次数/合格率', fill: '必选物料;按时间区间与检验类别聚合,每次检验独立计数' }
]
}
export const helpStocktake = {
title: '盘点(库存核对)',
overview:
'盘的是「库存量」(实物在库总数)。账面数=发起时快照的库存量,实盘数=实际数到的库存量,差异=实盘-账面。\n\n' +
'完整闭环(顶部步骤条引导):\n' +
'① 发起盘点:选范围(全库/按区域/按物料) → 冻结该范围库存并保存快照 → 生成盘点单号,状态「进行中」,目标数量=本次覆盖的批次/SN 总数(自动算)。\n' +
'② 扫码实盘:扫批次号(序列号=否(按批次记账))弹数量框填实盘数;扫 SN(序列号=是(按 SN 记账))自动记 1、直接提交。发起后盘点单号自动带入扫码区,无需手动粘贴。\n' +
'③ 完成盘点:先选未盘项处理方式(按账面保留/盘亏为0) → 二次确认是否写回 → 写回则生成盘点调整单修正库存 → 解冻库存。\n\n' +
'三条铁律:\n' +
'• 盘点期间库存冻结:进行中盘点单覆盖的批次/SN,禁止出库、入库追加,避免差异混入正常业务变动(完成或取消后自动解冻)。\n' +
'• 写回只改库存量:按差异修正后实时生效;盘亏数量不能超过在库数量,否则拒绝写回。\n' +
'• 写回走调整单留痕:生成调整单号,调整前/调整量/调整后全部入操作日志,可追溯谁在何时改了什么;写回不可逆,需主管以上权限。\n\n' +
'状态机:进行中(已冻结) → 已完成(仅出结论不改库存) / 已写回(差异已修正库存) / 已取消(解冻并记录原因)。',
fields: [
{ name: '盘点范围', source: '发起时选择。', purpose: '冻结库存并保存快照的范围', fill: '全库 / 按区域(多选) / 按物料(多选+类型)' },
{ name: '操作人', source: '登录账号自动带出。', purpose: '发起盘点人', fill: '自动' },
{ name: '目标数量', source: '发起时自动统计。', purpose: '本次盘点覆盖的批次/SN 总数', fill: '自动,无需填写' },
{ name: '发起盘点', source: '按钮操作(权限 stocktake:start)。', purpose: '按范围冻结库存并保存快照,生成盘点单号', fill: '点按钮选范围后发起;范围内库存若已被别的进行中盘点单冻结则拒绝' },
{ name: '批次号 / SN 序列号', source: '扫码枪。来自批次号/SN条码。', purpose: '要盘点的批次号(序列号=否(按批次记账))或 SN(序列号=是(按 SN 记账))', fill: '扫码回车提交;同一目标重复扫=覆盖实盘数;SN 自动记 1' },
{ name: '实盘数量', source: '扫码/手输。', purpose: '实际数到的库存量', fill: '仅序列号=否(按批次记账)需填非负整数;SN 由系统自动置 1,无需填' },
{ name: '未盘项处理', source: '完成盘点弹窗选择。', purpose: '盘点单覆盖但未扫到的项如何归置', fill: '按账面保留(不计差异) / 盘亏为0(实盘记0,差异=-账面)' },
{ name: '差异写回库存', source: '完成盘点弹窗勾选(默认勾选,可取消;权限 stocktake:writeback)。', purpose: '是否用实盘差异修正账面库存', fill: '勾选=生成盘点调整单写回;取消=仅出结论不改库存。已用二次确认弹窗取代旧开关,防误触' },
{ name: '取消盘点', source: '按钮操作(权限 stocktake:start)。', purpose: '发起错误或扫码错误过多时退出', fill: '点「取消盘点」填写原因→确认;解冻库存,状态置「已取消」,已扫记录作废' },
{ name: '历史列表', source: '查询结果。', purpose: '追溯历次盘点', fill: '含状态/差异项数/是否写回/写回时间/取消原因,可按单号或状态筛选' },
{ name: '导出明细', source: '历史行末按钮(权限 stocktake:view)。', purpose: '导出盘点明细为 xlsx', fill: '列:盘点单号/类型/批次或SN/物料编码/货位/账面数/实盘数/差异/是否已盘/实盘人/实盘时间/发起人/发起时间' }
]
}
export const helpSemi = {
title: '半成品管理(流转)',
overview:
'产线工位"暂存/退回"的半成品先在此入库(记"已完成至工位"快照),需要时再出库(重上线),MES 从下一工序继续;成品则由 MES 完工后自动回流入库(物料类别=成品),不经本页手工操作。\n\n闭环逻辑(与 MES 自动打通):\n' +
'① 工位终端"暂存退库" → 调 MES 工序流转接口 → MES 自动调 WMS /api/internal/semi/inbound 入库(带 SN、产品工号、completedText 展示快照)。\n' +
'② WMS 收到后写入统一库存主表(物料类别=半成品),与原材料/成品同表管理——库存查询三视图、区域汇总、导出都能看到它。\n' +
'③ 该件后续要接着做时,在本页"半成品出库"或 MES 重上线 → WMS /api/internal/semi/outbound 把状态置为出库。\n' +
'④ MES 据此下发下一工序,工位继续装配,直至完工。\n\n' +
'SN 是两系统唯一的追溯锚点。图号以请求传入为准,WMS 会同时从物料档案补齐物料名称(档案缺失不阻塞入库,只用图号兜底)。',
sections: [
{
title: '半成品/成品入库',
overview: '把产线退回的半成品或成品收进库房(手工录入或 MES 自动同步均走此接口)。',
fields: [
{ name: '物料', source: '下拉选择。来自物料档案(最近100条+模糊搜索,仅列成品物料类别 item_type=3)。', purpose: '入库物料(MES 自动同步时以请求传入为准,WMS 补齐物料名称)', fill: '选择图号' },
{ name: '已完成至工位', source: 'MES 自动带出(completedText 展示快照);手工录入填文本,如"工位5"。', purpose: '该件进展到哪个工位的人类可读快照,WMS 只原样存展示、不解析', fill: '如 工位5,可空=未报工' },
{ name: '产品工号', source: '自动带出/手工填写。来自工单。', purpose: '来源工单;填入失焦后自动调后端解析该工单的合同号', fill: '输入产品工号,工单存在合同号即自动带出归属' },
{ name: '归属', source: '继承产线工单(2026-09-29 定稿):填了产品工号即自动带出"合同号+编号"并置为只读;无产品工号或该工单无合同号时可手动选择。', purpose: '半成品来自生产,天然挂合同号,与成品同归属,按归属筛选即可闭环查询', fill: '优先填产品工号自动带出;手动兜底选 合同号/科技项目号/其他,选合同号或科技项目号须填编号' },
{ name: '产品状态', source: '下拉选择(可空):已通过 / 部分通过 / 返修。', purpose: '该件完工/暂存时的质量结论快照,随库存行展示', fill: '按实际结论选择,可空' },
{ name: '相关标准 / 试验记录单号 / 记录员·日期', source: '手工填写(可空)。', purpose: '成品/半成品入库的质量档案补充信息', fill: '检验细则或试验方案号、试验记录单号、记录员姓名与日期' },
{ name: '区域', source: '手动填写(可空)。', purpose: '存放库区', fill: '如 Z05' },
{ name: '扫码录入', source: '扫码枪连续扫码。来自工件 SN 条码。', purpose: '半成品 SN 清单', fill: '扫入 SN 回车追加' }
]
},
{
title: '半成品出库(重上线)',
overview: '把半成品重新送上线,WMS 状态置为出库,MES 从记录的下一工序继续。',
fields: [
{ name: 'SN', source: '扫码枪/手输。来自工件 SN 条码。', purpose: '要重上线的半成品 SN', fill: '扫描或输入 SN,回车出库' }
]
},
{
title: '半成品查询',
overview: '半成品/成品统一库存行的分页查询(读统一库存主表 category=2/3),支持按 图号、归属单号、产品工号、状态、SN 组合筛选。',
fields: [
{ name: '归属单号 / 产品工号', source: '筛选条件。归属=入库时继承工单带出的合同号等;产品工号=入库时随行带入的二级编号。', purpose: '按合同/产品套次追溯半成品与成品', fill: '模糊输入;列表「归属单号」「产品工号」列同步展示,空=该行未填' },
{ name: '状态', source: '筛选条件:在库 / 出库。', purpose: '只看当前在库或已出库的行', fill: '在库=可重上线;出库=已流转' },
{ name: 'SN / 图号', source: '筛选条件。SN 精确匹配,图号模糊。', purpose: '定位某一物料或单件', fill: 'SN 输完整编码;图号可模糊' }
]
}
]
}
export const helpFinishedInbound = {
title: '成品入库(手工)',
overview:
'方案A定稿(完工检合格才入成品库):成品入库与「完工自动回流」解耦为双通道——\n' +
'· 通道一(自动回流):MES 完工检合格后调 WMS 内部接口 /api/internal/finished/inbound 自动回流入库,无需人工操作;\n' +
'· 通道二(本页手工入库):库房对完工检合格的成品手工建档入库(含 MES 未回流补录、返修后再入库等场景),权限码 wms.finished:edit。\n' +
'两通道共用同一套后端创建逻辑与字段口径(成品入库九字段:SN/图号/归属/产品状态/相关标准/试验记录单号/记录员/记录日期/产品工号),\n' +
'统一落库存主表(物料类别=成品,SN 单件管理),SN 全局唯一防重(与半成品/序列号=是(按 SN 记账)不允许撞号,重复提交被 409 拒绝)。\n' +
'质量状态默认「合格」;MES 自动回流时按产品状态传入质量状态(已通过→合格 / 部分通过→合格 / 返修→不合格),后端尊重传入值不重复映射。\n' +
'提交成功后表单自动清空,页面下方「今日成品入库记录」展示当天双通道入库明细(来源列区分 手工 / MES回流),附件随 SN 归档。',
fields: [
{ name: 'SN', source: '扫码枪扫描成品 SN 条码回车即填,或手工输入。', purpose: '成品唯一追溯锚点,全局唯一(重复入库被 409 拒绝并提示「成品 SN 已存在库存」)', fill: '扫描或输入;SN 由系统/MES 发号,实物可不贴码允许手填' },
{ name: '产品序号', source: '远程搜索「物料档案」(仅成品物料类别 item_type=3),下拉显示 编码/名称。', purpose: '关联成品物料主数据,WMS 从档案自动补齐名称与类型', fill: '输入编码/名称关键字远程搜索后选择;档案缺失请先到「物料档案」建档' },
{ name: '产品名称', source: '选中产品序号后自动带出,可手动修改。', purpose: '展示名称;档案缺失时作为兜底展示', fill: '一般不改;与档案名称有出入时可手改' },
{ name: '归属类型 / 归属编号', source: '下拉选择:合同号 / 科技项目号 / 其他;编号手填。', purpose: '标记成品归属哪个合同或科技项目,与入库/半成品/检验同口径,可按归属贯通查询', fill: '可空;选合同号或科技项目号时归属编号必填,选「其他」可不填' },
{ name: '产品状态', source: '下拉选择:已通过 / 部分通过 / 返修(必填)。', purpose: '完工检质量结论快照,随库存行展示;MES 自动回流时按此映射质量状态(已通过→合格/部分通过→合格/返修→不合格)', fill: '必填,按完工检实际结论选择' },
{ name: '相关标准', source: '手工填写(可空)。', purpose: '试验方案号/检验细则,成品质量档案信息', fill: '如试验方案号,可空' },
{ name: '试验记录单号', source: '手工填写(可空)。', purpose: '关联试验记录,便于追溯原始试验数据', fill: '可空' },
{ name: '记录员', source: '默认当前登录用户姓名,可改。', purpose: '质量档案记录人', fill: '必填' },
{ name: '记录日期', source: '日期选择,默认今天。', purpose: '质量档案记录日期', fill: '默认今天,可改;留空后端按今天落库' },
{ name: '附件', source: '本地上传,仅 PDF。提交成功后自动随 SN 上传(bizType=finished,bizId=SN)。', purpose: '试验记录单等 PDF 资料随成品归档', fill: '先选文件再提交;单个失败不阻断入库,可在记录行「附件」补传/查看' },
{ name: '备注', source: '手工填写(可空)。', purpose: '补充说明;系统自动加「手工成品入库」前缀以区分 MES 自动回流', fill: '可空' },
{ name: '今日成品入库记录', source: '只读表:统一库存主表物料类别=成品、当天入库的行(双通道同表),按入库时间倒序分页。', purpose: '核对当天 MES 回流与手工入库结果,来源列区分两通道', fill: '进入页面自动加载;提交成功后自动刷新' }
]
}
export const helpLedger = {
title: '工单物料台账',
overview:
'实时展示每个工单下每个物料:需求总量、已出库、已退回、净领用、已消耗、在途/线边、剩余缺口。\n数据链路:MES 工单 + 物料清单 → 生成备料单时同步「工单级需求总量」到本台账(total_qty)→ 出库累加 out_qty → 退库累加 returned_qty → 报工反冲累加 consumed_qty。\n\n数量等式(必须成立,页顶「闭环核对」实时校验):\n· 净领用 = 已出库 − 已退回\n· 需求量 = 净领用 + 剩余缺口(强约束:净领用 ≤ 需求量,等于时「领料完结」)\n· 在途/线边 = 净领用 − 已消耗(已发出未消耗,含在途+工位余量两段,细分在 MES 侧)\n\n说明:本页只读查询,数据来自 MES 备料单同步(WMS 工单备料台账)。若列表为空,表示当前没有已同步的台账数据(请先在 MES 建工单、排产并生成备料单触发同步),不会展示任何模拟数据。',
fields: [
{ name: '产品工号', source: '筛选条件。数据来自 MES 工单。', purpose: '只看某个工单的领料台账', fill: '输入产品工号(可空=查全部工单)' },
{ name: '图号', source: '筛选条件。', purpose: '按图号精确过滤', fill: '输入图号(可空)' },
{ name: '物料名称', source: '筛选条件。', purpose: '按物料名称模糊过滤', fill: '输入物料名称(可空)' },
{ name: '备料状态', source: '筛选条件。齐套/预警/未齐套/未到货(服务端按实时可用库存+未来5天需求派生)。', purpose: '按备料充足度过滤', fill: '齐套=可用≥需求;预警=可用<未来5天需求;未齐套=0<可用<需求;未到货=可用为0且未出过库' },
{ name: '需求总量', source: 'MES 同步(工单数量 × 单台用量 × (1+损耗率),向上取整)。', purpose: '该工单该物料共需多少', fill: '系统自动,只读' },
{ name: '已出库 / 已退回 / 已消耗', source: '出库 / 退库收货 / 报工反冲各自写入(一个字段一个写者)。', purpose: '分段追踪物料去向', fill: '自动,只读' },
{ name: '净领用', source: '系统计算 = 已出库 − 已退回。', purpose: '用于超量拦截与「领料完结」判定', fill: '自动;等于需求总量即领料完结' },
{ name: '在途/线边', source: '系统计算 = 净领用 − 已消耗。', purpose: '已发出但产线尚未消耗的量(含在途+工位余量)', fill: '自动,只读' },
{ name: '缺口', source: '系统计算 = 需求总量 − 净领用(下限 0)。', purpose: '还差多少未领', fill: '自动;为 0 即领料完结' },
{ name: '闭环核对栏', source: '页顶实时汇总本页所有行。', purpose: '校验数量等式是否成立,账实不符时红色告警', fill: '自动;净领用>需求 或 已消耗>净领用 即判定账实不符' }
]
}
export const helpReturnOrder = {
title: '退库确认',
overview:
'工位退库的接收确认环节:工位终端上操作工把「没用完 / 有问题的物料」做退库发起,系统预建一张「待确认收货」的退库单;仓库保管员在本页审核并实物点收,点「确认收货」后系统按规则把物料加回库存,退库单置为「已收货」,整条退库链路闭环。\n\n数据链路:工位终端退库 → MES 落事件日志并调用 WMS 内部接口 → WMS 预建退库单(PENDING) → 本页确认收货(选退库类型、退回库位、序列号=是(按 SN 记账)逐个扫码 / 序列号=否(按批次记账)按数量)→ 库存加回 → 回写工单备料台账「退回量」,缺口恢复可再叫料。\n\n三个关键规则(客户诉求 问题14):\n1) 退库类型——「剩余物料」= 正常用剩,加回后置「未检」,由检验员判定合格/不合格;「问题物料」= 有质量疑虑,加回后直接置「不合格」隔离,绝不混入可用/合格库存。\n2) 退回库位——默认带入该物料最近一次的原库位(区域/货架/层/位置),可手动修改;目标货位即使已被其他物料占用也允许混放,系统只记数量、不校验位置冲突。\n3) 数量录入方式按物料「序列号=是(按 SN 记账)」(物料档案 sn_mode)自动区分——序列号=是(按 SN 记账)必须逐个扫码录入 SN,扫码数须与退库数完全一致(一物一码守恒,SN 复用原出库行回到在库);序列号=否(按批次记账)按退库数量整体加回,可指定批次号,留空则沿用/自动生成。\n\n说明:退库单状态只有两种——待确认收货 / 已收货。同一工单 + 同一物料 + 同一工位只会预建一条待收货退库单(防止重复提交)。本页不含「删除」,退库一经确认即形成库存流水,不可撤销。',
fields: [
{ name: '状态', source: '筛选条件,系统维护。', purpose: '只看待确认收货或已收货的退库单', fill: '选「待确认收货」优先处理' },
{ name: '退库单号', source: '系统自动生成(TH + 时间戳)。', purpose: '唯一标识一张退库单,便于对账追溯', fill: '自动生成,无需填写' },
{ name: '产品工号 / 退库工位 / 产品序列号', source: '工位终端退库时自动带入。', purpose: '定位退的是什么工单、哪件产品的物料', fill: '只读' },
{ name: '图号 / 名称 / 规格', source: '工位终端退库时带入(来自物料档案)。', purpose: '是哪一种物料退库', fill: '只读' },
{ name: '数量 / 单位', source: '工位终端填写。', purpose: '退多少(序列号=是(按 SN 记账)须逐个扫码等于此数;序列号=否(按批次记账)按此数整体加回)', fill: '只读' },
{ name: '退库原因', source: '工位终端填写。', purpose: '说明为什么退库(如剩余料 / 错料 / 不良更换)', fill: '只读' },
{ name: '退库类型', source: '库管确认收货时选择。', purpose: '区分「剩余物料」与「问题物料」,决定加回后的质量状态', fill: '剩余物料→置未检走检验;问题物料→置不合格隔离' },
{ name: '退回库位(区域/货架/层/位置)', source: '库管确认收货时选择,默认带入原库位。', purpose: '物料退回到哪个货位,贯穿库存明细/盘点/导出全链路', fill: '逐级下拉选择,可手动改;允许混放,不校验位置冲突' },
{ name: '扫码录入 SN', source: '库管确认收货时逐个扫码(仅序列号=是(按 SN 记账))。', purpose: '一物一码,保证退回的每个序列号可追溯', fill: '扫描/输入 SN 回车添加,扫码数须等于退库数量' },
{ name: '批次号', source: '库管确认收货时填写(仅序列号=否(按批次记账))。', purpose: '指定加回到哪个批次', fill: '留空则沿用同料同货位同状态在库批次,无则自动生成' },
{ name: '退库人 / 退库时间', source: '系统记录。', purpose: '追溯谁在什么时候发起的退库', fill: '只读' },
{ name: '确认收货', source: '库管在本页操作(权限码 return:confirm)。', purpose: '实物点收无误后确认,库存加回', fill: '核对实物 → 选退库类型/库位 →(序列号=是(按 SN 记账)扫码)→ 点「确认收货」' },
{ name: '收货人 / 收货时间', source: '系统在确认时记录当前登录人。', purpose: '追溯谁确认的收货', fill: '只读,确认后自动写入' }
]
}
export const helpZone = {
title: '区域维护(库位四级)',
overview:
'维护库区/库位字典,供入库/半成品/出库等所有页面的"区域"下拉框选择。\n库位按四级结构组织:区域 → 货架 → 层 → 位置号,四个页签各自独立维护、独立分页、按上级筛选。上级字段用下拉选择(不重复录入)。\n\n· 区域:物理库区(如待检、合格 Z02、不合格…),入库时必须指明放到哪个区,质量检验合格后再转移到合格区;\n· 货架:挂在某个区域下;新建货架时会自动创建一个「默认位置」,物料可不细分到层时直接挂这里;\n· 层:挂在某个货架下;\n· 位置号:挂在某个层(或货架默认位置)下。\n\n四级均可维护「名称」与「备注」(需求E);新建默认「启用」。库位不删除、只停用(避免库存/单据追溯断裂);停用后不再出现在入库/出库/盘点的可选库位下拉中,历史数据保留。\n\n列表实时库存(需求E/需求7):每次打开/查询页面实时聚合当前在库量(quantity>0 且 status∈{在库,锁定} 且非半成品),不缓存;区域=全区域合计、货架/层/位置逐级细化。区域行会额外显示「⚠ 未上架 N」徽标(该区域「未分配货架」的库存量);货架页签顶部固定一条灰色「(未分配货架)」虚拟行,汇总该区域未指定具体货架的库存(缺货位为合法状态,不计入具体货架/层/位置号),虚拟行不可编辑。\n\n「未分区」= 按设计不指定区域的库存行(如成品直落区,成品入库本就不录货位),单独汇总展示;与「未上架」口径不同:未上架=有区域无货架(脏数据,已加录入校验拦截新增),未分区=无区域(设计性归类,非缺陷),二者互不重叠。当前保持显示,待成品入库等实际业务明确后再定口径。\n\n列表页禁用关键字混搜,编码与名称各自独立筛选。\n\n位置号支持「批量生成」:选区域+货架+层号(层号用下拉选择,只能选该货架下已存在的层;层不存在请先在「层」页签创建,系统不会自动建层),填生成数量,系统从「该层已存在的最大位置号 +1」起连续生成,先预览(标出已存在)再确认写入,已存在的位置自动跳过。',
fields: [
{ name: '区域编码', source: '手工填写,仓库自定义(新增后不可改)。', purpose: '库区唯一编号', fill: '如 Z02、Z05,建议字母+数字,唯一;新增后不可改' },
{ name: '名称(四级)', source: '手工填写(可空)。区域/货架/层/位置四级均可命名。', purpose: '本级中文名称,便于识别', fill: '区域如 合格区/待检区;位置如 A架3层12位' },
{ name: '货架号', source: '新增货架时从「所属区域」下拉选,再填货架号。', purpose: '库位第二级,细化存放位置', fill: '如 A、B' },
{ name: '层号', source: '新增层时从「所属区域+货架」下拉选,再填层号。', purpose: '库位第三级', fill: '如 3' },
{ name: '位置号', source: '新增位置号时从「区域+货架+层」下拉逐级选(层必选,父级不能为空),再填位置号。', purpose: '库位第四级,最小存放单位', fill: '如 12' },
{ name: '实时库存', source: '系统实时聚合(不缓存)。口径:quantity>0 且 status∈{在库,锁定} 且非半成品。', purpose: '直观看到该区域/货架/层/位置当前在库总量;区域行另显示「⚠ 未上架 N」(未分配货架量)', fill: '只读;区域为全区域合计,逐级向下细化;货架页签顶部「(未分配货架)」虚拟行汇总未指定具体货架的库存' },
{ name: '状态', source: '启用/停用(新建默认启用)。', purpose: '不删除、只停用;停用后不再进入可选库位下拉', fill: '编辑弹窗切换启用/停用' },
{ name: '批量生成', source: '位置号页签「批量生成」按钮。', purpose: '在选定的区域+货架+层下,一次生成一批位置号', fill: '选区域+货架+层号(层号下拉选择,必须为已存在的层,不自动创建层)+ 生成数量 → 预览 → 确认生成;从「该层已存在的最大位置号 +1」起连续生成,只生成位置号、不创建父级层,已存在的自动跳过' },
{ name: '备注', source: '手工填写(可空),四级均可。', purpose: '补充描述', fill: '可空' }
]
}
export const helpAttachment = {
title: '附件中心',
overview:
'统一查看全系统上传的附件(图纸/报告/照片/Excel 等)。附件按「业务类型」挂靠具体单据,磁盘按「年/月/日/文件类型/uuid.ext」分层存储,库内只存相对路径。\n\n本页为纯查阅页:查询、在线预览(图片/PDF 内联)、下载、状态追溯。附件的删除、恢复与磁盘释放统一在「数据归档 → 磁盘空间回收」完成(需 attachment:manage 权限);业务单据附件面板中,上传人本人可「移除」自己误传的附件。\n\n状态三态:正常 / 已删除(文件仍在磁盘、彻底清除前可恢复)/ 已清除(磁盘文件已删除,索引保留可追溯)。已删除/已清除的记录悬浮可看删除人、时间、说明等前因后果;默认隐藏的已删除附件会在筛选时提示条数。\n\n删除保护:工艺流程(PROCESS_PDF)、流程卡(PROCESS_CARD) 为关键工艺文件,全程禁删;检验照片/报告(INSPECTION_*) 在质量追溯保留期(本地保留年数)内禁删;所有清理仅允许处理保护期(默认 180 天,archive.protect.days)之前的数据。',
fields: [
{ name: '文件类型', source: '筛选条件。文件类型目录(大写),决定磁盘存放目录。', purpose: '按附件类别过滤', fill: '工艺流程/检验照片/检验报告/图纸/流程卡/包装照片/Excel导入/其他' },
{ name: '业务类型', source: '筛选条件。附件挂靠的业务对象。', purpose: '只看某类业务的附件', fill: '入库/物料档案/质量检验/半成品/出库' },
{ name: '业务标识', source: '筛选条件。', purpose: '按单号/编码/ID 定位某条业务记录的附件', fill: '如入库单号、物料编码、检验记录 ID' },
{ name: '预览', source: '行末按钮。', purpose: '图片/PDF 浏览器内联打开,其他类型转下载', fill: '已删除/已清除的附件会先弹出前因后果提示,确认后仍可打开' },
{ name: '下载', source: '行末按钮。', purpose: '下载原件(带原文件名)', fill: '已清除(文件已物理删除)的附件不可下载' },
{ name: '状态', source: '列表列。', purpose: '三态:正常/已删除/已清除;悬浮查看删除人、时间、说明等前因后果', fill: '已删除=文件仍在磁盘可恢复;已清除=文件已删,找回依赖备份包(介质可读性由保管人自行核对)' },
{ name: '磁盘告警', source: '系统每天早上 7:00 自动检测附件目录剩余空间。', purpose: '提前发现空间不足,避免写入失败', fill: '剩余 <20% 告警、<10% 提示立即清理;本页顶部同步展示;清理入口在「数据归档 → 磁盘空间回收」' }
]
}
export const helpMaterial = {
title: '物料档案',
overview:
'定义每一种物料的字典:叫什么、什么规格、什么物料类别(原材料/成品)、什么类型(结构件/电气件/其他),以及是【序列号=是(按 SN 记账)】还是【序列号=否(按批次记账)】。\n此处维护的物料会作为下拉选项出现在入库/出库/装箱等页面;「类型」仅用于分类统计/筛选/页签归属;「序列号=是(按 SN 记账)」(sn_mode) 决定出入库的序列号(sn_mode)——序列号=是(按 SN 记账)走 SN 逐件扫码(单件追溯)、序列号=否(按批次记账)按数量一批多件。两者相互独立(2026-09-30 解耦定稿):选类型时自动带默认(电气件→序列号=是(按 SN 记账),结构件/其他→序列号=否(按批次记账)),可手动更改。\n\n物料类别来源:原材料=进货来的(外购);成品=自己生产的。成品还可以作为零部件,放进另一个成品的物料清单里被再次加工成新的成品。\n\n物料类别说明:1=原材料(默认) / 3=成品(「其他」类别已按 2026-10-19 用户裁决全项目取消)。半成品不是物料物料类别(2026-09-22 定稿)——半成品是工件状态,由统一库存主表物料类别 category=2 承载,物料档案不再有半成品行。编码主数据单一来源在本表:MES 的「物料档案」页面即是本表中"成品"物料类别的视图(实时拉取本表,不双录)——两系统的「物料档案」指向同一份主数据,以本表为准。库存主表 inventories 的物料类别与其呼应。列表支持按物料类别筛选,导出含物料类别列。\n\n物料档案是库房的另一道地基:先建好物料,入库时才能选到;「序列号=是(按 SN 记账)」未选择(0)的物料不能出入库。\n\n命名说明:本档案维护的物料在出库/看板等页面统一以"图号"展示(客户口径)。安全库存在本档案维护,可用量低于它时会在「库房看板」首页触发缺货预警。\n\n导入说明:导入按钮旁的 ⓘ 图标提供字段说明、常见错误和模板下载。建议先下载模板,按模板格式填写后导入。',
fields: [
{ name: '图号', source: '手工填写,仓库自定义(新增后不可改)。在出库/看板等页面显示为"图号"。', purpose: '物料唯一编号(即图号)', fill: '如 SCREW-M3;新增后不可改编码' },
{ name: '名称', source: '手工填写(必填)。', purpose: '物料名称', fill: '如 螺丝 M3' },
{ 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_mode):是(序列号=是(按 SN 记账))=逐件录 SN 单件追溯;否(序列号=否(按批次记账))=按数量一批多件;未选择(0)的物料不能出入库', fill: '是(序列号=是(按 SN 记账),逐件录SN) / 否(序列号=否(按批次记账),按数量,不录SN)' },
{ name: '安全库存', source: '必填整数(默认0)。', purpose: '该物料的最低库存警戒线;可用量低于它会在「库房看板」首页触发缺货预警', fill: '如 100;0=不预警' },
{ name: '说明', source: '手工填写(可空)。', purpose: '补充描述', fill: '可空' }
]
}
export const helpDisplay = {
title: '库房总览显示',
overview: '给库房显示器用的只读总览页,展示库存与出入库概况。\n数据实时读取库存统计,本页不可编辑。',
fields: []
}
export const helpDashboard = {
title: '库房看板',
overview: '只读看板:库存总量、物料种类、出入库动态,以及「缺货预警」。\n缺货预警:列出可用量低于安全库存的物料(安全库存在「物料档案」维护),每行显示 图号 / 安全库存 / 可用量,提示及时补料。\n数据实时读取统计接口,本页不可编辑。',
fields: [
{ name: '缺货预警', source: '系统实时统计(可用量 < 物料档案的安全库存)。', purpose: '一眼看出哪些料快没了、需要补货', fill: '只读;红色标题显示预警项数,无预警时显示"暂无缺货物料"' }
]
}
export const helpRole = {
title: '角色管理',
overview:
'角色决定账号能看哪些菜单(勾选菜单)与能用哪些功能(勾选其下按钮),勾选互不影响。\n内置角色:管理员(全部权限)、库房保管员、质检员——不可删除;管理员权限不可编辑。',
sections: [
{
title: '新增 / 编辑权限',
fields: [
{ name: '角色名称', source: '手工填写。', purpose: '角色中文名', fill: '如 库房管理员' },
{ name: '角色编码', source: '手工填写。', purpose: '角色唯一编码,创建后不可改', fill: '如 intro-manager' },
{ name: '权限树', source: '勾选。来自系统预置的权限菜单与按钮。', purpose: '决定该角色可见菜单与可用按钮', fill: '勾选菜单=可见;勾选按钮=可用(两者独立)' }
]
}
]
}
export const helpUserManage = {
title: '账号管理',
overview:
'系统登录账号的维护页:新建账号、分配角色、启用/停用、重置密码。账号登录后按其角色权限决定可见菜单与可用按钮(角色在「角色管理」维护)。\n内置 admin 为超级管理员,不可停用不可删除。',
fields: [
{ name: '用户名', source: '手工填写,唯一。', purpose: '登录账号', fill: '字母/数字组合;创建后不可改' },
{ name: '姓名', source: '手工填写。', purpose: '真实姓名,操作日志按此留痕', fill: '中文姓名' },
{ name: '角色', source: '下拉选择,数据来自「角色管理」(实时取角色表)。', purpose: '决定该账号可见菜单与可用按钮', fill: '一人一角色;角色权限变更对已登录账号实时生效' },
{ name: '状态', source: '启用/停用切换(行内按钮,二次确认)。', purpose: '停用后该账号无法登录;历史操作记录保留', fill: '离职/长期不用时停用而非删除' },
{ name: '密码 / 重置密码', source: '新建时填写;编辑弹窗内可重置。', purpose: '登录凭证', fill: '新密码不允许纯数字;重置后请通知本人及时修改' }
]
}
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、入库→入库单号' }
]
}
]
}
export const helpDefectReturn = {
title: '生产退不良',
overview:
'产线使用中发现的不良品退回库房的登记台账(独立菜单)。产线把已出库/已消耗的物料退回,系统重建「质量状态=不合格」的隔离库存行(不进可用库存),随后到「库存查询→库位明细」按质量筛选「不合格」找到该行,走「在库处置」(退货/换修/报废)完成闭环。\n\n本页职责:登记入口(右上角按钮弹窗)+ 已登记记录的查询/导出。录入为低频动作走弹窗,列表独立成页——库存查询页只负责查询,不再承载录入(统一交互规范:高频操作留页面 tab、低频操作弹窗)。',
fields: [
{ name: '退不良单号', source: '系统自动生成。', purpose: '唯一标识一次退不良登记,便于对账追溯', fill: '自动生成,无需填写' },
{ name: '产品工号 / 始发工位号', source: '登记时填写。', purpose: '定位不良发生在哪张工单、哪个工位', fill: '必填' },
{ name: '物料编码 / 物料名称', source: '登记时填写,名称按档案带出。', purpose: '退回的是哪种物料', fill: '编码必填' },
{ name: '数量', source: '登记时填写。', purpose: '退回数量;序列号=是(按 SN 记账)须逐行录入 SN 且与数量一致', fill: '必填,大于 0' },
{ name: '质量原因', source: '登记时填写。', purpose: '不良现象说明,质量追溯关键', fill: '必填' },
{ name: '退回库位(区域/货架/层/位置)', source: '登记时逐级下拉选择。', purpose: '隔离库存行落位;建议选隔离区', fill: '可空,默认按区域规划' },
{ name: '单据状态', source: '系统维护。', purpose: '待确认=已登记;已确认收货=隔离库存已重建', fill: '只读' }
]
}