Files
bj_power/bj_power_wms/frontend/src/help.js
T
SunYF 932700ca65 refactor: 清理MES端本地product_type冗余代码,对齐WMS主数据架构
1.  移除MES端本地product_type实体、schema及相关CRUD代码,改为通过WMS内部API代理获取物料主数据
2.  更新物料管理粒度逻辑,新增"其他"类型(3)支持,同步更新入库校验规则
3.  修复前端物料选择、库存筛选等页面的类型判断逻辑,统一使用manage_mode区分管理类型
4.  清理静态资源文件冗余的样式代码,调整前端页面展示逻辑
5.  更新帮助文档,修正物料类型的说明描述
2026-09-22 07:41:40 +08:00

342 lines
57 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· 结构件(螺丝/机加工件) → 按【批次】入库,一批多件;\n· 电气件(芯片/器件) → 按【SN 序列号】逐件扫码,可单件追溯。\n\n管理类型由 WMS 的"物料档案"决定(电气件/结构件),入库方式随之自动给出。\n入库是整个库存链路的第一环:入库(Held) → 质量检验(合格Z02) → 之后才能被出库锁定。\n\n本页四个页签(录入在前,记录在后点击才见),参照出库管理:\n· 结构件入库:按批次入库 + Excel 批量导入;\n· 电气件入库:逐件扫码 + 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: '手工填写整数。', purpose: '本批到货数量', fill: '整数 ≥1' },
{ 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: '模板(首行忽略表头):图号 | 批次号(可空自动生成) | 数量 | 生产日期 | 供应商 | 区域 | 备注。任一行错误则整体回退' }
]
},
{
title: '电气件入库(页签2)',
overview: '适用于芯片、器件等需要单件追溯的来料,一件一个 SN。录入与 Excel 批量导入都在本页签。',
fields: [
{ name: '物料', source: '下拉选择(必填)。来自"物料档案"类型为"电气件"的物料。', purpose: '入库的电气件物料', fill: '选择图号' },
{ name: '区域', source: '下拉选择(必填)。来自"区域维护"。', purpose: '放到哪个库区', fill: '必填;新到货一般先放"待检"区' },
{ name: '货架/层/位', source: '同结构件入库:三级货位手填,选物料后自动带入该物料最近一次入库库位。', purpose: '精确货位', fill: '选物料即自动填入,可手动改' },
{ name: '扫码录入', source: '扫码枪连续扫码。来自每颗器件自带的 SN 条码。', purpose: '逐件登记 SN,实现单件追溯', fill: '扫入/粘贴 SN 后点【录入到列表】加入清单,可一次连续多条' },
{ name: '批量导入', source: '本页签下方。', purpose: '整表校验后一次性入库', fill: '模板(首行忽略表头):图号 | SN | 区域 | 生产日期 | 供应商。任一行错误则整体回退' }
]
},
{
title: '其他入库(页签3)',
overview: '适用于辅料、螺栓、工装、试验设备等既非结构件也非电气件的物料;规格型号强制(在物料档案维护,为空则拒绝入库)。支持归属(工单号/科技项目号/其他,必选)与库位四级。',
fields: [
{ 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: '行「状态」列 + 行末「作废」按钮(权限 inbound:void)。', purpose: '作废错误入库单并回滚库存', fill: '点「作废」填写作废原因→确认;结构件按批次回滚数量、电气件按 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):对接 MES 工单台账领料,强约束"单物料累计出库 ≤ 工单需求总量";工单号下拉选择(来自 MES 实时工单,未完成优先,无输入默认展示前 20 条),支持输入模糊搜索;MES 不可达或工单未同步时下拉可能为空,可手输兜底(需台账已同步)。\n· 通用出库:不依赖工单的手动出库(退料/退货/样品/报废/发货/其他),支持结构件批次与电气件 SN,填箱号即一并记录装箱;MES 不可用或无需挂靠工单时请用本页。\n· 出库记录:统一主表的全量查询与导出(一键导出 CSV,含装箱信息),含工单号与目标工位。\n选用原则:有 MES 工单要按 物料清单 领料 → 工单备料出库;无工单的自由出库/装箱发货 → 通用出库。\n\n通用出库操作顺序(客户诉求 问题17/18/20):① 先选物料(下拉统一显示 编码/图号/类型/品类)→ ② 系统自动判定出库类型(电气件/结构件,无需手选)→ ③ 选出库类别(纯标签,不联动任何地方;选「其他」时备注必填原因)→ ④ 填归属(工单编号/科技项目号/其他,非其他时编号必填)→ ⑤ 结构件从可用批次下拉选批次(默认 FIFO 首个)并填数量 / 电气件逐个扫 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: '系统自动判定(来自物料档案的管理粒度)。', purpose: '决定走批次扣减还是 SN 扣减', fill: '只读:选物料后自动显示结构件(批次)或电气件(SN),无需也不允许手选' },
{ name: '通用出库-出库类别', source: '下拉点选(纯标签记录,不联动任何地方)。', purpose: '区分退料/退货/样品/报废/发货/其他,列表与出库单均显示', fill: '必选;选「其他」时需在备注填写具体原因' },
{ name: '通用出库-归属', source: '下拉选归属类型 + 手填归属编号。', purpose: '记录出库归属(工单编号/科技项目号/其他),仅追溯不联动 MES', fill: '默认「其他」;选工单编号/科技项目号时归属编号必填,长度≤64' },
{ name: '通用出库-目标工位', source: '下拉选择(来自 MES 工位列表,不允许手输)。', purpose: '出库送到哪个装配工位,出库记录留痕工位号', fill: '下拉选工位(可搜索);选填' },
{ name: '通用出库-批次号', source: '结构件:下拉选择该物料在库可用批次(不手输)。电气件:逐个扫 SN。', purpose: '定位扣减哪个批次/哪些 SN', fill: '结构件默认带出 FIFO 首个可用批次(显示可用量/质量状态/区域)可改;电气件扫入 SN 列表(必填)' },
{ name: '通用出库-区域 / 货架 / 层 / 位置(四级库位)', source: '与入库同口径的逐级联动下拉(选填)。选物料或批次后自动带入:① 该批次在库的实际库位 ② 该物料最近一次入库库位 ③ 都无则按所选区域推荐同区空位。', purpose: '指明从哪个货位取料,免手工挑选,出库留痕到具体货位', fill: '选物料/批次即自动填入四级,可逐级手动改;切换上级会自动清空下级' },
{ name: '通用出库-箱号', source: '手动填写(选填)。', purpose: '整箱发货时填写,装箱信息随出库单记录(无需再单独录入装箱)', fill: '填箱号后,本出库单即带装箱属性,可在"出库记录"按箱号追溯' },
{ name: '通用出库-合同号', source: '手动填写(选填)。', 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)、半成品(MES 暂存退库)、成品(MES 完工自动回流,系统生成 SN)。数据由入库、出库、检验、盘点及 MES 回流等业务实时维护,本页只读。\n\n本页四个视图页签(首屏默认「物料汇总」):\n· 物料汇总:一物料一行,直接回答"这个物料总共有多少"——总量/锁定/可用 + 质量分布(合格/未检/不合格) + 分布在哪些区域;点行下钻该物料的批次/SN 明细。\n· 库位明细:按 物料 × 区域 × 货架 × 层 × 位置 聚合(质量三列与批次/SN 数为列,不进分组键),支持区域→货架→层→位置四级联动筛选 + 质量快捷筛选(全部/未检/合格/不合格);点击行下钻批次/SN 明细。\n· 区域汇总:一区域一行六列(合格/未检/不合格/结构件/电气件/其他)+最近入库时间;质量状态与类型均降为列、不再拆行。\n· 缺料补货:拉取 MES 未来5天排产需求,对比本地可用量,分两列列出「安全库存补货量」(常规补货)与「排产缺料量」(订单驱动紧急补料),在途量暂无数据源显示"—";排产窗口标注需求起止日期。\n\n层级概念:入库单 → 批次/SN → 库存行。区域/库位/质量状态/批次/最近入库时间都是某物料的一对多属性,放在下钻明细中查看,不在物料行上并排平铺。',
fields: [
{ name: '图号 / 物料名称', source: '筛选条件(物料汇总、库位明细视图生效)。', purpose: '只看某个物料', fill: '输入图号或名称,可空=全部' },
{ name: '库存类型', source: '单选(全部/结构件/电气件/其他)。结构件=类型1且排除「其他」;电气件=类型2;其他=类型3(辅料/工装/试验设备)。', purpose: '类型三分互斥:结构件=批次数量管理;电气件=SN 单件管理;其他=辅料/工装/试验设备(按批次管理)', fill: '全部 / 结构件 / 电气件 / 其他;物料汇总与库位明细视图生效' },
{ name: '品类', source: '单选(全部/原材料/半成品/成品/其他)。', purpose: '按品类过滤:原材料=采购到货入库;半成品=MES 工位暂存退库;成品=MES 完工自动回流(成品 SN 系统生成,入库单号形如 MES:工单号);其他=辅料/工装/试验设备(ITEM_TYPE=4)', fill: '全部 / 原材料 / 半成品 / 成品 / 其他;物料汇总与库位明细视图生效' },
{ name: '库位明细-区域/货架/层/位置', source: '四级联动下拉(仅「库位明细」视图生效)。区域来自"区域维护";选区域后联动出货架、选货架联动出层、选层联动出位置,上级清空自动清空下级。', purpose: '精确到货位筛选库存,与入库/出库库位四级贯通', fill: '逐级选择;只选区域也可只按大区筛;切换上级自动清空下级' },
{ name: '库位明细-质量状态', source: '单选(全部/未检/合格/不合格,仅「库位明细」生效)。', purpose: '不合格品一屏定位(需求A5)', fill: '选「不合格」直接看所有隔离中的不良库存' },
{ name: '库位明细-入库时间', source: '仅「库位明细」生效的日期筛选(默认近3个月起)。', purpose: '按入库时间收窄', fill: '可与区域/质量组合' },
{ name: '区域汇总-六列', source: '系统实时聚合,一区域一行。', purpose: '质量(合格/未检/不合格)与类型(结构件/电气件/其他)都已降为列,避免同区拆多行;最近入库时间取该区最近一笔入库', fill: '只读:结构件=批次数量、电气件=SN 单件、其他=辅料工装试验设备;具体货架/层/位置四级货位见「库位明细」下钻' },
{ name: '数量等式(七大域审计)', source: '系统实时计算,本页只读。', purpose: '保证库存数量自洽', fill: '库存量(总数) = 可用量 + 锁定量;总数 = 合格 + 未检 + 不合格(质量分布守恒);可用量 = 总数 − 锁定量' },
{ name: '物料汇总-质量分布', source: '系统按当前在库行统计。', purpose: '一个物料合格/未检/不合格各多少', fill: '合格/未检/不合格三列,自动统计' },
{ name: '物料汇总-分布区域', source: '系统统计该物料当前占用了哪些区域。', purpose: '一个物料可跨多个区域存放(批次可拆分),物料行不写死单一区域', fill: '如 Z02、Z05;点行下钻可看每个批次/SN 具体在哪个区' },
{ name: '批次/SN 明细(下钻)', source: '点击任一行弹出抽屉。', purpose: '看该物料的每个批次/SN 所在区域、质量状态、锁定与来源入库单', 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 排产动态变化,不提供导出' }
]
}
export const helpInspection = {
title: '检验(来料/过程/完工)',
overview:
'【三检分工与边界】\n· 来料检(incoming):对采购/外协到货、入库前的物料验收,按入库批次/SN 判定。合格才能入库上架,不合格隔离退货。\n· 过程检(process):对产线在制物料/半成品巡检,判定质量状态。\n· 完工检(finished):对 MES 回流的成品 SN 做最终检验(对象固定为成品 SN,无“批次”选项)。成品入库时质量状态为“未检”,完工检合格后置“合格”,成品方可发货;不合格可返修/让步接收。闭环:MES 报工→成品入库(未检)→WMS 完工检→合格→可发货。\n\n【检验做什么】把库存行的“质量状态”从未检翻转为合格/不合格,与存放区域无关。库存校验只取质量状态=合格的行参与出库/锁库。\n\n【报检数守恒】报检数 = 合格数 + 不合格数;合格数不得大于报检数;判定合格时合格数应等于报检数(否则请改判不合格并选处置方式)。\n\n【不合格处置(需求23 换修闭环)】判不合格必选处置:退货(须填货运单号、库存置待退) / 换修(隔离为不合格,等返修后重新报检) / 让步接收(审批后放行,质量状态置合格) / 报废 / 部分入库(仅结构件批次:一次只处理 1 个批次,按合格数拆行)。已判不合格的记录也可在列表里再次处置。\n\n【结构件 vs 电气件/其他的不合格口径】\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菜单按业务分为来料/过程/完工三个入口,同一张表、同一接口,仅按检验类别默认过滤。每条检验记录可上传/查看附件(检测报告/照片)。',
fields: [
{ name: '三检边界', source: '菜单入口锁定检验类别。', purpose: '来料检=入库验收;过程检=在制巡检;完工检=成品 SN 终检', fill: '按左侧菜单进入对应页面,页内不再切换类别' },
{ name: '目标类型', source: '单选,决定录入框标题与可选库存范围。完工检固定为 SN,不展示切换。', purpose: '检验对象:批次(结构件) / SN(电气件) / 其他(辅料·工装·试验设备,按 1 件判定)', fill: '批次 BATCH / 序列号 SN / 其他 OTHER(任一切换都会自动刷新“从库存选”下拉与可选库存范围)' },
{ name: '检验结论', source: '单选。', purpose: '判定结果', fill: '合格 / 不合格' },
{ name: '记录人 / 审核人', source: '手动填写(默认当前用户)。完工检显示为“审核人”。', purpose: '谁检验/审核的,追溯用', fill: '姓名' },
{ name: '从库存选批次号/SN', source: '下拉选择,数据来自当前库存(按目标类型过滤;完工检只列成品 category=3)。', purpose: '避免手输编号、防止输错', fill: '在库存里挑待检的批次号/SN,自动加入清单' },
{ name: '录入批次号/SN', 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: '下拉选择类型 + 手动输入编号(默认其他)。', 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(电气件)自动记 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(电气件)', 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、工单号、已完成工序码)。\n' +
'② WMS 收到后写入统一库存主表(品类=半成品),与原材料/成品同表管理——库存查询三视图、区域汇总、导出都能看到它。\n' +
'③ 该件后续要接着做时,在本页"半成品出库"或 MES 重上线 → WMS /api/internal/semi/outbound 把状态置为出库。\n' +
'④ MES 据此下发下一工序,工位继续装配,直至完工。\n\n' +
'SN 是两系统唯一的追溯锚点。图号以请求传入为准,WMS 会同时从物料档案补齐物料名称(档案缺失不阻塞入库,只用图号兜底)。',
sections: [
{
title: '半成品/成品入库',
overview: '把产线退回的半成品或成品收进库房(手工录入或 MES 自动同步均走此接口)。',
fields: [
{ 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: '必选一项;选"其他"可不填编号,选"工单号/科技项目号"须填归属编号' },
{ 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,回车出库' }
]
}
]
}
export const helpLedger = {
title: '工单物料台账',
overview:
'实时展示每个工单下每个物料:需求总量、已出库、已退回、净领用、已消耗、在途/线边、剩余缺口。\n数据链路:MES 工单 + 物料清单 → 生成备料单时同步「工单级需求总量」到本台账(total_qty)→ 出库累加 out_qty → 退库累加 returned_qty → 报工反冲累加 consumed_qty。\n\n数量等式(必须成立,页顶「闭环核对」实时校验):\n· 净领用 = 已出库 − 已退回\n· 需求量 = 净领用 + 剩余缺口(强约束:净领用 ≤ 需求量,等于时「领料完结」)\n· 在途/线边 = 净领用 − 已消耗(已发出未消耗,含在途+工位余量两段,细分在 MES 侧)\n\n说明:本页只读查询,数据来自 MES 同步的工单台账。若列表为空,表示当前没有已同步的台账数据(请先在 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) → 本页确认收货(选退库类型、退回库位、电气件逐个扫码 / 结构件按数量)→ 库存加回 → 回写工单备料台账「退回量」,缺口恢复可再叫料。\n\n三个关键规则(客户诉求 问题14):\n1) 退库类型——「剩余物料」= 正常用剩,加回后置「未检」,由检验员判定合格/不合格;「问题物料」= 有质量疑虑,加回后直接置「不合格」隔离,绝不混入可用/合格库存。\n2) 退回库位——默认带入该物料最近一次的原库位(区域/货架/层/位置),可手动修改;目标货位即使已被其他物料占用也允许混放,系统只记数量、不校验位置冲突。\n3) 数量录入方式按物料管理粒度自动区分——电气件(序列号管理)必须逐个扫码录入 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: '退多少(电气件须逐个扫码等于此数;结构件按此数整体加回)', fill: '只读' },
{ name: '退库原因', source: '工位终端填写。', purpose: '说明为什么退库(如剩余料 / 错料 / 不良更换)', fill: '只读' },
{ name: '退库类型', source: '库管确认收货时选择。', purpose: '区分「剩余物料」与「问题物料」,决定加回后的质量状态', fill: '剩余物料→置未检走检验;问题物料→置不合格隔离' },
{ name: '退回库位(区域/货架/层/位置)', source: '库管确认收货时选择,默认带入原库位。', purpose: '物料退回到哪个货位,贯穿库存明细/盘点/导出全链路', fill: '逐级下拉选择,可手动改;允许混放,不校验位置冲突' },
{ name: '扫码录入 SN', source: '库管确认收货时逐个扫码(仅电气件)。', purpose: '一物一码,保证退回的每个序列号可追溯', fill: '扫描/输入 SN 回车添加,扫码数须等于退库数量' },
{ name: '批次号', source: '库管确认收货时填写(仅结构件)。', purpose: '指定加回到哪个批次', fill: '留空则沿用同料同货位同状态在库批次,无则自动生成' },
{ name: '退库人 / 退库时间', source: '系统记录。', purpose: '追溯谁在什么时候发起的退库', fill: '只读' },
{ name: '确认收货', source: '库管在本页操作(权限码 return:confirm)。', purpose: '实物点收无误后确认,库存加回', fill: '核对实物 → 选退库类型/库位 →(电气件扫码)→ 点「确认收货」' },
{ name: '收货人 / 收货时间', source: '系统在确认时记录当前登录人。', purpose: '追溯谁确认的收货', fill: '只读,确认后自动写入' }
]
}
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),用于联调完整链路;现场配置后自动切换真实调度。\n\n【当前状态:待现场对接】AGV 默认运行于模拟模式(EnableMock=true),下发/到位/取消均为本地模拟、不驱动真实小车;顶部黄色横幅即此提示。对接真实海康 RCS 时,在服务配置中关闭 EnableMock 并填写 BaseURL / AppKey / AppSecret 即可,业务代码无需改动。',
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: '下拉选择,默认库房口' }
]
}
export const helpZone = {
title: '区域维护(库位四级)',
overview:
'维护库区/库位字典,供入库/半成品/出库等所有页面的"区域"下拉框选择。\n库位按四级结构组织:区域 → 货架 → 层 → 位置号,四个页签各自独立维护、独立分页、按上级筛选。上级字段用下拉选择(不重复录入)。\n\n· 区域:物理库区(如待检、合格 Z02、不合格…),入库时必须指明放到哪个区,质量检验合格后再转移到合格区;\n· 货架:挂在某个区域下;新建货架时会自动创建一个「默认位置」,物料可不细分到层时直接挂这里;\n· 层:挂在某个货架下;\n· 位置号:挂在某个层(或货架默认位置)下。\n\n四级均可维护「名称」与「备注」(需求E);新建默认「启用」。库位不删除、只停用(避免库存/单据追溯断裂);停用后不再出现在入库/出库/盘点的可选库位下拉中,历史数据保留。\n\n列表实时库存(需求E/需求7):每次打开/查询页面实时聚合当前在库量(quantity>0 且非出库/报废),不缓存;区域=全区域合计、货架/层/位置逐级细化。列表页禁用关键字混搜,编码与名称各自独立筛选。\n\n位置号支持「批量生成」:选区域 → 货架 → 层范围 → 位置范围,先预览(标出已存在)再确认写入,已存在的位置自动跳过。',
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: '系统实时聚合(不缓存)。', purpose: '直观看到该区域/货架/层/位置当前在库总量', fill: '只读;区域为全区域合计,逐级向下细化' },
{ name: '状态', source: '启用/停用(新建默认启用)。', purpose: '不删除、只停用;停用后不再进入可选库位下拉', fill: '编辑弹窗切换启用/停用' },
{ name: '批量生成', source: '位置号页签「批量生成」按钮。', purpose: '在选定的某个已存在层下,一次生成一批位置号(位置范围)', fill: '选区域+货架+具体层+位置范围 → 预览 → 确认生成;只生成位置号、不创建父级层,已存在的自动跳过' },
{ name: '备注', source: '手工填写(可空),四级均可。', purpose: '补充描述', fill: '可空' }
]
}
export const helpAttachment = {
title: '附件中心',
overview:
'统一查看全系统上传的附件(图纸/报告/照片/Excel 等)。附件按「业务类型」挂靠具体单据,磁盘按「年/月/日/文件类型/uuid.ext」分层存储,库内只存相对路径。\n\n本页只读查询 + 下载/删除(不提供在线预览“查看”,统一走下载)。删除为逻辑删除(索引标记),真正的磁盘文件由「空间清理」统一处理。顶部会显示附件磁盘剩余空间告警:低于 20% 提醒、低于 10% 提示立即清理。\n\n删除保护:工艺流程(PROCESS_PDF)、流程卡(PROCESS_CARD) 为关键工艺文件,全程禁删;检验照片/报告(INSPECTION_*) 在质量追溯保留期(本地保留年数)内禁删。\n\n空间清理(页面右上「空间清理」按钮,需 attachment:manage 权限)归拢三项,每项先「预检」看影响范围、确认后再执行:① 归档清理(早于本地保留年数的附件备份到外部目录并标记);② 物理清理已删附件(删除已标记删除的磁盘文件,索引保留);③ 日志清理(仅系统管理员,清理日志目录下早于 N 天的 *.log,默认保留 30 天,系统亦每日自动滚动清理)。',
fields: [
{ name: '文件类型', source: '筛选条件。文件类型目录(大写),决定磁盘存放目录。', purpose: '按附件类别过滤', fill: '工艺流程/检验照片/检验报告/图纸/流程卡/包装照片/Excel导入/其他' },
{ name: '业务类型', source: '筛选条件。附件挂靠的业务对象。', purpose: '只看某类业务的附件', fill: '入库/物料档案/质量检验/半成品/出库' },
{ name: '业务标识', source: '筛选条件。', purpose: '按单号/编码/ID 定位某条业务记录的附件', fill: '如入库单号、物料编码、检验记录 ID' },
{ name: '下载', source: '行末按钮。', purpose: '下载原件(带原文件名)', fill: '本页不提供在线“查看”预览,统一下载后本地打开' },
{ name: '删除', source: '行末按钮(权限 attachment:manage)。', purpose: '逻辑删除附件索引(文件待「空间清理-物理清理」统一清除)', fill: '确认后标记已删除;工艺流程/流程卡及保留期内检验记录受保护不可删' },
{ name: '空间清理', source: '页面右上按钮(权限 attachment:manage),抽屉式归拢归档/物理清理/日志清理。', purpose: '释放磁盘空间:归档旧附件、物理删除已删文件、清理旧日志', fill: '每项先「预检」(dryRun)看影响数量与释放空间,再「执行」前二次确认' },
{ name: '日志清理', source: '空间清理抽屉第③项(仅系统管理员 admin)。', purpose: '清理日志目录下早于 N 天的 *.log(默认 30 天)', fill: '不开放普通仓管;系统每日自动滚动清理,此为手动“立即清理”补充入口' },
{ name: '磁盘告警', source: '系统每天早上 7:00 自动检测附件目录剩余空间。', purpose: '提前发现空间不足,避免写入失败', fill: '剩余 <20% 告警、<10% 提示立即清理;本页顶部同步展示' }
]
}
export const helpMaterial = {
title: '物料档案',
overview:
'定义每一种物料的字典:叫什么、什么规格、什么品类(原材料/半成品/成品/其他)、是【结构件(批次)】还是【电气件(SN)】。\n此处维护的物料会作为下拉选项出现在入库/出库/装箱等页面;其中"类型"直接决定后续入库方式——结构件走批次(一批多件)、电气件走 SN 逐件扫码(单件追溯)。\n\n品类来源:原材料=进货来的(外购);半成品、成品=自己生产的;其他=辅料/工装/试验设备等。成品还可以作为零部件,放进另一个成品的物料清单(BOM)里被再次加工成新的成品。\n\n品类说明:1=原材料(默认) / 2=半成品 / 3=成品 / 4=其他(辅料/工装/试验设备)。编码主数据单一来源在本表:MES 的「物料档案」页面即是本表中"成品"品类的视图(实时拉取本表,不双录)——两系统的「物料档案」指向同一份主数据,以本表为准。库存主表 inventories 的品类与其呼应。列表支持按品类筛选,导出含品类列。\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: '区分原材料/半成品/成品/其他,与统一库存主表品类对应;原材料为进货、半成品/成品为自产', fill: '查询区可选 原材料/半成品/成品/其他' },
{ name: '类型', source: '必填(与「品类」相互独立)。选择:1=结构件(批次管理) / 2=电气件(SN 管理) / 3=其他(辅料/工装/试验设备,按批次数量管理)。', purpose: '决定入库方式:结构件/其他走批次、电气件走 SN 逐件扫码', fill: '结构件(批次) / 电气件(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 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、入库→入库单号' }
]
}
]
}