docs(deployment): 更新部署手册和业务架构说明
- 更新MES和WMS服务端口配置说明 - 详细说明产线工位设备配置(扫码枪+拧紧枪) - 明确AGV配送和接驳台的模拟模式与真实对接方案 - 更新WMS中AGV配送默认模拟模式说明 - 完善厂内物流(AGV/接驳台)的业务架构约束 - 修订临时文档为详细的项目问题和解决方案规划
This commit is contained in:
@@ -62,12 +62,17 @@ export const helpInbound = {
|
||||
export const helpOutbound = {
|
||||
title: '出库管理(统一主表)',
|
||||
overview:
|
||||
'所有出库都落在同一张「出库主表」(OutboundOrder),用"类型"区分,装箱信息(箱号/SN清单/合同号)也直接记在主表上,不再单独建装箱表。\n两个出库页签 + 一个记录页签:\n· 工单备料出库(MES):对接 MES 工单台账领料,强约束"单物料累计出库 ≤ 工单需求总量";未启用 MES 或工单未同步时,工单下拉可能为空,可直接手输工单号(需台账已同步)。\n· 通用出库:不依赖工单的手动出库(退料/样品/报废/发货),支持结构件批次与电气件 SN,填箱号即一并记录装箱;MES 不可用或无需挂靠工单时请用本页。\n· 出库记录:统一主表的全量查询与导出(一键导出 CSV,含装箱信息)。\n选用原则:有 MES 工单要按 物料清单 领料 → 工单备料出库;无工单的自由出库/装箱发货 → 通用出库。\n\n说明:出库列表统一以"图号"展示物料(客户口径统一称"图号");通用出库涵盖退料/样品/报废/发货等场景,无固定分类下拉,具体去向记在"备注"。质量门禁:质量状态为「不合格/待退」的批次禁止领料上线,须先完成不合格处置。',
|
||||
'所有出库都落在同一张「出库主表」(OutboundOrder),用"类型"区分,装箱信息(箱号/SN清单/合同号)也直接记在主表上,不再单独建装箱表。\n三个页签:\n· 工单备料出库(MES):对接 MES 工单台账领料,强约束"单物料累计出库 ≤ 工单需求总量";未启用 MES 或工单未同步时,工单下拉可能为空,可直接手输工单号(需台账已同步)。\n· 通用出库:不依赖工单的手动出库(退料/退货/样品/报废/发货/其他),支持结构件批次与电气件 SN,填箱号即一并记录装箱;MES 不可用或无需挂靠工单时请用本页。\n· 出库记录:统一主表的全量查询与导出(一键导出 CSV,含装箱信息),含工单号与目标工位。\n选用原则:有 MES 工单要按 物料清单 领料 → 工单备料出库;无工单的自由出库/装箱发货 → 通用出库。\n\n通用出库操作顺序(客户诉求 问题17/18/20):① 先选物料(下拉统一显示 编码/图号/类型/品类)→ ② 系统自动判定出库类型(电气件/结构件,无需手选)→ ③ 选出库类别(纯标签,不联动任何地方;选「其他」时备注必填原因)→ ④ 填归属(工单编号/科技项目号/其他,非其他时编号必填)→ ⑤ 结构件从可用批次下拉选批次(默认 FIFO 首个)并填数量 / 电气件逐个扫 SN → ⑥ 选目标工位(下拉,来自 MES 工位列表,不可手输)。\n\n说明:出库单号由系统自动生成、不可修改,规则与入库一致(入库 IB+ / 出库 OB+ 同一编号规则);出库无法与入库批次/合同对应,故出库类别仅是标签记录,列表与出库单都显示。质量门禁:发货/样品/其他类出库仅允许「合格」品;退货/报废/退料类豁免(本身即处置不合格品)。',
|
||||
fields: [
|
||||
{ name: '备料出库-工单号', source: '手动输入。数据来自 MES 已建的工单及导入的物料台账。', purpose: '出库挂靠的工单,决定可领料总量与需求缺口', fill: '输入工单号回车,查询该工单的物料台账' },
|
||||
{ name: '备料出库-目标工位', source: '下拉选择 DOCK01~DOCK20(选填,可过滤搜索)。', purpose: 'AGV 配送送达的接驳台(toDock 参数)', fill: '选择如 DOCK05;不选默认运到产线入口 DOCK01' },
|
||||
{ name: '备料出库-一键分配出库', source: '系统自动按 FIFO 分配。数据来自合格区Z02的批次库存。', purpose: '从合格区按先进先出凑够缺口并出库', fill: '点按钮,系统自动算批次并二次确认' },
|
||||
{ name: '通用出库-物料/类型', source: '下拉选择物料;类型选"结构件(批次)"或"电气件(SN)"。', purpose: '决定走批次扣减还是 SN 扣减', fill: '选物料后选类型;批次填批次号+数量,SN 扫入 SN 列表' },
|
||||
{ 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: '可空' },
|
||||
@@ -81,11 +86,14 @@ export const helpOutbound = {
|
||||
export const helpInventory = {
|
||||
title: '库存查询',
|
||||
overview:
|
||||
'查看当前库存:全品类统一一张库存主表——原材料(结构件按批次/电气件按SN)、半成品(MES 暂存退库)、成品(MES 完工自动回流,系统生成 SN)。数据由入库、出库、检验、盘点及 MES 回流等业务实时维护,本页只读。\n\n本页三个视图页签(首屏默认「物料汇总」):\n· 物料汇总:一物料一行,直接回答"这个物料总共有多少"——总量/锁定/可用 + 质量分布(合格/未检/不合格) + 分布在哪些区域;ID 与创建时间取自物料主表,另有最近入库单/最近入库时间;点行下钻该物料的批次/SN 明细。\n· 库存明细:按 物料 × 区域 × 质量 聚合,可组合 区域/质量状态/入库时间/品类 筛选(物料汇总不受区域/质量筛选影响)。\n· 区域汇总:按 区域 × 质量状态 × 类型(批次/电气件/半成品/成品) 看各库区的货量;ID 与创建时间取自区域主表,另有组内最近入库时间;支持全量导出。\n\n层级概念:入库单 → 批次/SN → 库存行。区域/质量状态/批次/最近入库单都是某物料的一对多属性,放在下钻明细中查看,不在物料行上并排平铺。',
|
||||
'查看当前库存:全品类统一一张库存主表——原材料(结构件按批次/电气件按SN)、半成品(MES 暂存退库)、成品(MES 完工自动回流,系统生成 SN)。数据由入库、出库、检验、盘点及 MES 回流等业务实时维护,本页只读。\n\n本页三个视图页签(首屏默认「物料汇总」):\n· 物料汇总:一物料一行,直接回答"这个物料总共有多少"——总量/锁定/可用 + 质量分布(合格/未检/不合格) + 分布在哪些区域;ID 与创建时间取自物料主表,另有最近入库单/最近入库时间;点行下钻该物料的批次/SN 明细。\n· 库存明细:按 物料 × 区域 × 质量 聚合,可组合 区域/质量状态/入库时间/品类 筛选(物料汇总不受区域/质量筛选影响)。\n· 区域汇总:按 区域 × 质量状态 × 类型(结构件/电气件/其他) 看各库区的货量(每行是一个细分组合,质量指该组内库存质量而非整个区域是否合格);ID 与创建时间取自区域主表,另有组内最近入库时间;支持全量导出。\n\n层级概念:入库单 → 批次/SN → 库存行。区域/质量状态/批次/最近入库单都是某物料的一对多属性,放在下钻明细中查看,不在物料行上并排平铺。',
|
||||
fields: [
|
||||
{ name: '图号 / 物料名称', source: '筛选条件。', purpose: '只看某个物料', fill: '输入图号或名称,可空=全部' },
|
||||
{ name: '库存类型', source: '单选(全部/结构件/电气件)。', purpose: '按管理粒度过滤', fill: '全部 / 结构件(批次) / 电气件(SN)' },
|
||||
{ name: '品类', source: '单选(全部/原材料/半成品/成品)。', purpose: '按品类过滤:原材料=采购到货入库;半成品=MES 工位暂存退库;成品=MES 完工自动回流(成品 SN 系统生成,入库单号形如 MES:工单号)', fill: '全部 / 原材料 / 半成品 / 成品;三个视图与导出均生效' },
|
||||
{ name: '库存类型', source: '单选(全部/结构件/电气件)。按管理粒度过滤。', purpose: '结构件=批次数量管理;电气件=SN 单件管理', fill: '全部 / 结构件(批次) / 电气件(SN)' },
|
||||
{ name: '品类', source: '单选(全部/原材料/半成品/成品)。', purpose: '按品类过滤:原材料=采购到货入库;半成品=MES 工位暂存退库;成品=MES 完工自动回流(成品 SN 系统生成,入库单号形如 MES:工单号)。另有「其他」品类(辅料/工装/试验设备,itemType=4)在区域汇总「类型」列单列', fill: '全部 / 原材料 / 半成品 / 成品;三个视图与导出均生效' },
|
||||
{ name: '区域汇总-类型', source: '系统按管理粒度自动判定。', purpose: '看每个大区各类型货物量', fill: '只读:结构件(批次)/电气件(SN)/其他(itemType=4 辅料工装);不再混入半成品/成品品类' },
|
||||
{ name: '区域汇总-质量状态', source: '系统按细分组统计。', purpose: '看每个大区各质量状态的货量', fill: '只读:每行是「区域×质量×类型」细分,质量指该组内库存质量,并非整个区域是否合格' },
|
||||
{ name: '数量等式(七大域审计)', source: '系统实时计算,本页只读。', purpose: '保证库存数量自洽', fill: '库存量(总数) = 可用量 + 锁定量;总数 = 合格 + 未检 + 不合格(质量分布守恒);可用量 = 总数 − 锁定量' },
|
||||
{ name: '物料汇总-质量分布', source: '系统按当前在库行统计。', purpose: '一个物料合格/未检/不合格各多少', fill: '合格/未检/不合格三列,自动统计' },
|
||||
{ name: '物料汇总-分布区域', source: '系统统计该物料当前占用了哪些区域。', purpose: '一个物料可跨多个区域存放(批次可拆分),物料行不写死单一区域', fill: '如 Z02、Z05;点行下钻可看每个批次/SN 具体在哪个区' },
|
||||
{ name: '库存明细-区域/质量/入库时间', source: '仅「库存明细」视图生效的筛选。', purpose: '在物料基础上再按存放区/质量状态/入库时间收窄', fill: '可组合筛选' },
|
||||
@@ -99,32 +107,48 @@ export const helpInventory = {
|
||||
export const helpInspection = {
|
||||
title: '检验(来料/过程/完工)',
|
||||
overview:
|
||||
'对入库的未检物料/SN 做检验:把"未检"翻转为【合格】或【不合格】。\n检验只修改"质量状态"字段,与物料/SN 的存放区域无关。\n合格品才能参与出库与锁库(库存校验只取质量状态=合格的批次)。\n\n本页分两个页签(录入在前默认打开,记录在后点击才见),参照出库管理:\n· 质量检验录入(常操作,默认打开):单条与批量已合并为同一处——扫码枪连续扫、或从"库存"下拉直接选,都先进入下方"已选清单",点一次"提交检验"统一翻转。\n· 检验记录(点击才加载):分页查询历史检验记录,支持按 批次/SN、物料、检验类型、结论、检验员、时间 筛选与导出。\n菜单按业务分为「来料检验 / 过程检验 / 完工检验」三个入口,同一张表、同一接口,仅按检验类别默认过滤(页面内不再切换类别)。记录支持「报检单号」字段,用于与生产报检流程关联;按需求已移除“不合格原因”字段。\n编号是否真实存在会即时校验:找不到对应库存记录的编号会直接报错,不会"提示成功但库存仍是未检"。\n不合格处置:判定为「不合格」时必须选择处置方式——退货(须填货运单号) / 报废 / 部分入库(一次只处理 1 个批次);不合格品不入库、不上产线。已判定不合格的记录也可在列表中再次执行处置。\n附件:每条检验记录可上传/查看附件(如检测报告、照片)。',
|
||||
'【三检分工与边界】\n· 来料检(incoming):对采购/外协到货、入库前的物料验收,按入库批次/SN 判定。合格才能入库上架,不合格隔离退货。\n· 过程检(process):对产线在制物料/半成品巡检,判定质量状态。\n· 完工检(finished):对 MES 回流的成品 SN 做最终检验(对象固定为成品 SN,无“批次”选项)。成品入库时质量状态为“未检”,完工检合格后置“合格”,成品方可发货;不合格可返修/让步接收。闭环:MES 报工→成品入库(未检)→WMS 完工检→合格→可发货。\n\n【检验做什么】把库存行的“质量状态”从未检翻转为合格/不合格,与存放区域无关。库存校验只取质量状态=合格的行参与出库/锁库。\n\n【报检数守恒】报检数 = 合格数 + 不合格数;合格数不得大于报检数;判定合格时合格数应等于报检数(否则请改判不合格并选处置方式)。\n\n【不合格处置(需求23 换修闭环)】判不合格必选处置:退货(须填货运单号、库存置待退) / 换修(隔离为不合格,等返修后重新报检) / 让步接收(审批后放行,质量状态置合格) / 报废 / 部分入库(一次只处理 1 个批次,按合格数拆行)。已判不合格的记录也可在列表里再次处置。\n\n【归属口径(需求22)】归属类型 = 工单编号 / 科技项目号 / 其他,默认“其他”。这里的“工单编号”是独立维度标签,与 MES 工单号不是同一东西;手动输入、不联动 MES、不校验格式(长度≤64)。\n\n【按物料统计】统计页需先选择物料再点“统计”,不做全表实时聚合。\n\n本页分页签:质量检验录入(默认打开)/ 检验记录(点击才加载)/ 按物料统计。菜单按业务分为来料/过程/完工三个入口,同一张表、同一接口,仅按检验类别默认过滤。每条检验记录可上传/查看附件(检测报告/照片)。',
|
||||
fields: [
|
||||
{ name: '目标类型', source: '单选,决定录入框标题与可选库存范围。', purpose: '检验对象是批次(结构件)还是 SN(电气件)', fill: '批次 BATCH / 序列号 SN;切换时会自动刷新"从库存选"下拉' },
|
||||
{ name: '三检边界', source: '菜单入口锁定检验类别。', purpose: '来料检=入库验收;过程检=在制巡检;完工检=成品 SN 终检', fill: '按左侧菜单进入对应页面,页内不再切换类别' },
|
||||
{ name: '目标类型', source: '单选,决定录入框标题与可选库存范围。完工检固定为 SN,不展示切换。', purpose: '检验对象是批次(结构件)还是 SN(电气件/成品)', fill: '批次 BATCH / 序列号 SN;切换时自动刷新“从库存选”下拉' },
|
||||
{ name: '检验结论', source: '单选。', purpose: '判定结果', fill: '合格 / 不合格' },
|
||||
{ name: '检验员', source: '手动填写(默认当前用户)。', purpose: '谁检验的,追溯用', fill: '检验员姓名' },
|
||||
{ name: '从库存选批次号/SN', source: '下拉选择,数据来自当前库存(按目标类型过滤)。', purpose: '避免手输编号、防止输错', fill: '在库存里挑待检的批次号/SN,自动加入清单' },
|
||||
{ name: '记录人 / 审核人', source: '手动填写(默认当前用户)。完工检显示为“审核人”。', purpose: '谁检验/审核的,追溯用', fill: '姓名' },
|
||||
{ name: '从库存选批次号/SN', source: '下拉选择,数据来自当前库存(按目标类型过滤;完工检只列成品 category=3)。', purpose: '避免手输编号、防止输错', fill: '在库存里挑待检的批次号/SN,自动加入清单' },
|
||||
{ name: '录入批次号/SN', source: '扫码枪/粘贴。来自批次号/SN条码。', purpose: '单条或多条待检编号', fill: '扫入或粘贴后点【录入到列表】,多编号用逗号/分号/空格/回车分隔' },
|
||||
{ name: '已选清单', source: '本页待提交列表。', purpose: '统一查看、可逐个删除', fill: '列在此处的编号,点【提交检验】一次性翻转' },
|
||||
{ name: '检测单号 / 报检单号', source: '手工填写(可空)。检测单号用于与入库单据关联传递,报检单号用于关联生产报检流程。', purpose: '把检验记录与来料入库/生产报检挂钩,便于追溯', fill: '如检测单号随入库带入;报检单号可空' },
|
||||
{ name: '不合格处置', source: '判定"不合格"时必选:退货 / 报废 / 部分入库。', purpose: '不合格品不入库、不上产线,须明确去向;退货须填货运单号,部分入库一次只处理 1 个批次', fill: '退货(填货运单号) / 报废 / 部分入库(单批次);判定不合格却不选处置会被拦截' },
|
||||
{ name: '报检数 / 合格数', source: '手动填写。守恒:报检数 = 合格数 + 不合格数。', purpose: '量化抽检结果', fill: '合格数≤报检数;判合格时两者相等' },
|
||||
{ name: '归属', source: '下拉选择类型 + 手动输入编号(默认其他)。', purpose: '标记检验对象归属,便于按归属查询', fill: '工单编号 / 科技项目号 / 其他;编号手动输入、不校验格式、长度≤64' },
|
||||
{ name: '不合格处置', source: '判定“不合格”时必选:退货 / 换修 / 让步接收 / 报废 / 部分入库。', purpose: '不合格品不入库、不上产线,须明确去向(需求23 换修闭环)', fill: '退货(填货运单号→待退) / 换修(隔离不合格→待返修) / 让步接收(放行→合格) / 报废 / 部分入库(单批次)' },
|
||||
{ name: '附件', source: '行内附件抽屉(bizType=检验记录)。', purpose: '为该检验记录上传/查看附件(如检测报告、照片)', fill: '点行内附件按钮,在抽屉中上传或查看' },
|
||||
{ name: '检验记录-筛选/导出', source: '切换到"检验记录"页签后可见。', purpose: '按条件分页查询历史记录并导出', fill: '支持按 批次/SN、图号/物料名称/型号(三框模糊:框内模糊、框间取交集)、检验类型、结论、检验员、时间范围(默认近3个月) 组合筛选;点【导出】下载 xlsx' }
|
||||
{ name: '检验记录-筛选/导出', source: '切换到“检验记录”页签后可见。', purpose: '按条件分页查询历史记录并导出', fill: '支持按 批次/SN、图号/名称/型号(三框模糊)、归属单号、检验类型、结论、记录人、时间范围(默认近3个月) 组合筛选;点【导出】下载 xlsx' },
|
||||
{ name: '按物料统计', source: '切换到“按物料统计”页签,先选物料再点统计。', purpose: '看某物料的检验次数/合格率', fill: '必选物料;按时间区间与检验类别聚合,每次检验独立计数' }
|
||||
]
|
||||
}
|
||||
|
||||
export const helpStocktake = {
|
||||
title: '盘点(库存核对)',
|
||||
overview:
|
||||
'核对账面与实际库存,支持扫码快速盘点,完成时按差异修正库存。\n页面顶部有步骤条引导流程:发起盘点 → 扫码实盘 → 确认差异并写回。\n流程:① 发起盘点(全库/按区域/按物料,生成盘点单号) → ② 扫批次号/SN 录实盘数(回车提交) → ③ 完成盘点(可选:差异写回库存),并展示差异明细。\n\n「物料分布」相关视图已并入「库存查询」页的物料汇总/库存明细,本页专注盘点流程。',
|
||||
'盘的是「库存量」(实物在库总数),不是可用量、不是锁定量。账面数=发起时快照的库存量,实盘数=实际数到的库存量,差异=实盘-账面。\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: '发起盘点人', fill: '自动' },
|
||||
{ name: '发起盘点', source: '按钮操作。', purpose: '按所选范围生成盘点单号并冻结库存快照', fill: '点按钮选择范围后发起' },
|
||||
{ name: '差异写回库存', source: '开关。', purpose: '完成后是否用实盘差异修正账面库存', fill: '开=写回;关=仅记录差异' },
|
||||
{ name: '批次号 / SN 序列号', source: '扫码枪。来自批次号/SN条码。', purpose: '要盘点的批次号(结构件)或 SN(电气件)', fill: '扫批次号/SN,回车提交;同一目标重复扫=覆盖实盘数' },
|
||||
{ name: '实盘数量', source: '扫码/手输。', purpose: '实际数到数量', fill: '非负整数;0=盘亏为零' }
|
||||
{ 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/物料编码/货位/账面数/实盘数/差异/是否已盘/实盘人/实盘时间/发起人/发起时间' }
|
||||
]
|
||||
}
|
||||
|
||||
@@ -163,31 +187,38 @@ export const helpSemi = {
|
||||
export const helpLedger = {
|
||||
title: '工单物料台账',
|
||||
overview:
|
||||
'实时展示每个工单下每个物料:需求总量、累计已出库、剩余缺口。\n系统强约束"累计出库 ≤ 需求总量",达到即标记"领料完结",禁止再出库。\n数据链路:MES 工单 + 物料清单(物料清单) → 同步导入本台账 → 出库时自动扣减累计,形成缺口 / 完结。\n\n说明:本页只读查询,数据来自 MES 同步的工单台账。若列表为空,表示当前没有已同步的台账数据(请先在 MES 建工单并同步物料清单),不会展示任何模拟数据。',
|
||||
'实时展示每个工单下每个物料:需求总量、已出库、已退回、净领用、已消耗、在途/线边、剩余缺口。\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: '筛选条件。可选项:待领料 / 部分领料 / 领料完结。', purpose: '按领料进度过滤', fill: '待领料=还没出过库;部分领料=已出库但没领完;领料完结=缺口为 0(前两种均由"进行中"按已出库数实时派生)' },
|
||||
{ name: 'ID', source: '台账记录主键(系统生成,只读)。', purpose: '唯一标识一行台账,便于定位与对接', fill: '系统自动生成,无需填写' },
|
||||
{ name: '需求总量 / 已出库 / 缺口', source: '系统计算。需求总量来自 物料清单;已出库随出库自动累加;缺口 = 需求总量 − 已出库。', purpose: '一眼看清某物料还差多少未领', fill: '自动;缺口为 0 即领料完结' },
|
||||
{ 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) → 本页确认收货 → 库存加回(批次物料按「图号 + 在库」合并到已有库存行;无在库行则新建一行,入库单号记为 RET:退库单号)。\n\n说明:退货单状态只有两种——待确认收货 / 已收货。同一工单 + 同一物料 + 同一工位只会预建一条待收货退库单(防止重复提交)。本页不含「删除」,退库一经确认即形成库存流水,不可撤销。',
|
||||
'工位退库的接收确认环节:工位终端上操作工把「没用完 / 有问题的物料」做退库发起,系统预建一张「待确认收货」的退库单;仓库保管员在本页审核并实物点收,点「确认收货」后系统按规则把物料加回库存,退库单置为「已收货」,整条退库链路闭环。\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: '退回库位(区域/货架/层/位置)', 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: '库管在本页操作(权限码 return:confirm)。', purpose: '实物点收无误后确认,库存加回', fill: '核对实物 → 选退库类型/库位 →(电气件扫码)→ 点「确认收货」' },
|
||||
{ name: '收货人 / 收货时间', source: '系统在确认时记录当前登录人。', purpose: '追溯谁确认的收货', fill: '只读,确认后自动写入' }
|
||||
]
|
||||
}
|
||||
@@ -195,7 +226,7 @@ export const helpReturnOrder = {
|
||||
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),用于联调完整链路;现场配置后自动切换真实调度。',
|
||||
'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: '状态:待下发 → 待搬运 → 搬运中 → 已到位;到位后自动回写备料单状态' },
|
||||
@@ -207,16 +238,17 @@ export const helpAgv = {
|
||||
export const helpZone = {
|
||||
title: '区域维护(库位四级)',
|
||||
overview:
|
||||
'维护库区/库位字典,供入库/半成品/出库等所有页面的"区域"下拉框选择。\n库位按四级结构组织:区域 → 货架 → 层 → 位置号,四个页签各自独立维护、独立分页、按上级筛选。上级字段用下拉选择(不重复录入)。\n\n· 区域:物理库区(如待检、合格 Z02、不合格…),入库时必须指明放到哪个区,质量检验合格后再转移到合格区;\n· 货架:挂在某个区域下;新建货架时会自动创建一个「默认位置」,物料可不细分到层时直接挂这里;\n· 层:挂在某个货架下;\n· 位置号:挂在某个层(或货架默认位置)下,可填「位置名称」(如"A架3层12位",可空)。\n\n位置号支持「批量生成」:选区域 → 货架 → 层范围 → 位置范围,先预览(标出已存在)再确认写入,已存在的位置自动跳过。\n\n区域字典是库房的第一道地基:先建好区域,入库、检验、出库才能选到正确的存放位置。',
|
||||
'维护库区/库位字典,供入库/半成品/出库等所有页面的"区域"下拉框选择。\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: '如 合格区、待检区、不合格区' },
|
||||
{ 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: '如 A架3层12位;可空' },
|
||||
{ name: '实时库存', source: '系统实时聚合(不缓存)。', purpose: '直观看到该区域/货架/层/位置当前在库总量', fill: '只读;区域为全区域合计,逐级向下细化' },
|
||||
{ name: '状态', source: '启用/停用(新建默认启用)。', purpose: '不删除、只停用;停用后不再进入可选库位下拉', fill: '编辑弹窗切换启用/停用' },
|
||||
{ name: '批量生成', source: '位置号页签「批量生成」按钮。', purpose: '一次生成一批位置号(货架 × 层范围 × 位置范围)', fill: '选区域+货架+层范围+位置范围 → 预览 → 确认生成;已存在的自动跳过' },
|
||||
{ name: '说明', source: '手工填写(可空)。', purpose: '补充描述', fill: '可空' }
|
||||
{ name: '备注', source: '手工填写(可空),四级均可。', purpose: '补充描述', fill: '可空' }
|
||||
]
|
||||
}
|
||||
|
||||
@@ -237,15 +269,16 @@ export const helpDock = {
|
||||
export const helpAttachment = {
|
||||
title: '附件中心',
|
||||
overview:
|
||||
'统一查看全系统上传的附件(图纸/报告/照片/Excel 等)。附件按「业务类型」挂靠具体单据,磁盘按「年/月/日/文件类型/uuid.ext」分层存储,库内只存相对路径。\n\n本页只读查询 + 预览/下载/删除;删除为逻辑删除(索引标记,文件由「归档清理」统一处理)。顶部会显示附件磁盘剩余空间告警:低于 20% 提醒、低于 10% 提示立即归档清理。\n\n归档策略:本地保留最近 1 年(可在配置 Attachment.LocalRetentionYears 调整),早于此的附件可「归档清理」——备份到外部目录(Attachment.ArchiveDir)并标记已归档,索引保留可追溯。',
|
||||
'统一查看全系统上传的附件(图纸/报告/照片/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: '在线预览(PDF/图片)或下载原件', fill: '查看=新窗口内联预览;下载=带原文件名下载' },
|
||||
{ name: '删除', source: '行末按钮(权限 attachment:manage)。', purpose: '逻辑删除附件索引(文件待归档任务清理)', fill: '确认后标记已删除;可勾选「含已删除」查看' },
|
||||
{ name: '归档清理', source: '按钮(权限 attachment:manage)。', purpose: '把早于本地保留年数的附件备份到外部目录并标记归档,释放本地空间', fill: '点「归档清理」确认执行;结果给出移动/标记/失败条数' },
|
||||
{ name: '磁盘告警', source: '系统每天早上 7:00 自动检测附件目录剩余空间。', purpose: '提前发现空间不足,避免写入失败', fill: '剩余 <20% 告警、<10% 提示立即归档清理;本页顶部同步展示' }
|
||||
{ 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% 提示立即清理;本页顶部同步展示' }
|
||||
]
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user