feat: 新增工序签字功能,移除移料指令模块

新增操作工/检验员工序签字功能,支持工艺步骤配置签字要求;删除移料指令相关代码,将移料页签重命名为产线点位(上料/下料);新增成品入库功能及相关权限;优化备料单状态、质量状态逻辑,新增批次序号字段;修复AGV取消后备料单回退状态问题。
This commit is contained in:
SunYF
2026-10-05 20:15:38 +08:00
parent c33acab9c8
commit f1cf57e9b2
181 changed files with 9785 additions and 9699 deletions
+50 -22
View File
@@ -5,7 +5,7 @@
export const helpInbound = {
title: '入库(来料入账)',
overview:
'把到货的来料记入 WMS 库存。按「序列号件」(物料档案维护)分两种入库方式:\n· 批次件 → 按【批次】入库,一批多件;\n· 序列号件 → 按【SN 序列号】逐件扫码,可单件追溯。\n\n序列号件由 WMS 的"物料档案"决定(2026-09-30 与物料类型解耦,可独立设置),入库方式随之自动给出;物料档案未选择序列号件的物料不能入库。\n入库是整个库存链路的第一环:入库(Held) → 质量检验(合格Z02) → 之后才能被出库锁定。\n\n本页四个页签(录入在前,记录在后点击才见),参照出库管理:\n· 结构件入库:按批次入库 + Excel 批量导入;\n· 电气件入库:逐件扫码 + Excel 批量导入;\n· 其他入库:辅料/螺栓/工装/试验设备等非结构件非电气件物料,规格型号强制;\n· 入库记录:分页列表(一单一行),点「明细」在右侧抽屉查看该单的行(懒加载+分页,不内嵌子表)。\n\n库位四级贯通:每笔入库除选「区域」外,还可录「货架/层/位置」三级货位;选物料后系统自动带入该物料最近一次入库的库位,可手动修改。',
'把到货的来料记入 WMS 库存。按「序列号件」(物料档案维护)分两种入库方式:\n· 批次件 → 按【批次】入库,一批多件;\n· 序列号件 → 按【SN 序列号】逐件扫码,可单件追溯。\n\n序列号件由 WMS 的"物料档案"决定(2026-09-30 与物料类型解耦,可独立设置),入库方式随之自动给出;物料档案未选择序列号件的物料不能入库。\n入库是整个库存链路的第一环:入库(Held) → 质量检验(合格Z02) → 之后才能被出库。\n\n本页四个页签(录入在前,记录在后点击才见),参照出库管理:\n· 结构件入库:按批次入库 + Excel 批量导入;\n· 电气件入库:逐件扫码 + Excel 批量导入;\n· 其他入库:辅料/螺栓/工装/试验设备等非结构件非电气件物料,规格型号强制;\n· 入库记录:分页列表(一单一行),点「明细」在右侧抽屉查看该单的行(懒加载+分页,不内嵌子表)。\n\n库位四级贯通:每笔入库除选「区域」外,还可录「货架/层/位置」三级货位;选物料后系统自动带入该物料最近一次入库的库位,可手动修改。',
sections: [
{
title: '结构件入库(页签1)',
@@ -54,7 +54,7 @@ export const helpInbound = {
overview: '分页展示全部入库单,结构件/电气件/其他同表(用"类型"列区分)。支持按入库单号、图号、类型、物料名称、归属单号、产品工号、入库时间筛选(各字段独立,无关键字混搜);列表含「区域」「库位」「检测单号」「质量状态」「归属」「产品工号」列;可按当前条件导出 xlsx。点行「明细」在右侧抽屉查看该单的行(懒加载+分页,避免序列号件上万条 SN 撑爆前端)。',
fields: [
{ name: '查询条件', source: '本页签顶部筛选区。', purpose: '缩小列表范围', fill: '可组合:入库单号(模糊)/图号(模糊)/类型(全部·结构件·电气件·其他)/物料名称(模糊)/归属单号(模糊·合同号/科技项目号)/产品工号(模糊)/状态(全部·有效·已作废)/入库时间区间' },
{ name: '状态 / 作废', source: '行「状态」列 + 行末「作废」按钮(权限 inbound:void)。', purpose: '作废错误入库单并回滚库存', fill: '点「作废」填写作废原因→确认;批次件按批次回滚数量、序列号件按 SN 精确回滚(不影响其它单);已锁定/已出库的批次或 SN 须先处理' },
{ 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"' }
@@ -91,34 +91,35 @@ export const helpOutbound = {
export const helpInventory = {
title: '库存查询',
overview:
'查看当前库存:全品类统一一张库存主表——原材料(批次件按批次/序列号件按SN)、半成品(MES 暂存退库)、成品(MES 完工自动回流,系统生成 SN)。数据由入库、出库、检验、盘点及 MES 回流等业务实时维护,本页只读。\n\n本页四个视图页签(首屏默认「物料汇总」):\n· 物料汇总:一物料一行,直接回答"这个物料总共有多少"——总量/锁定/可用 + 质量分布(合格/未检/不合格) + 分布在哪些区域;点行下钻该物料的批次/SN 明细。\n· 库位明细:按 物料 × 区域 × 货架 × 层 × 位置 聚合(质量三列与批次/SN 数为列,不进分组键),支持区域→货架→层→位置四级联动筛选 + 质量快捷筛选(全部/未检/合格/不合格);点击行下钻批次/SN 明细。\n· 区域汇总:一区域一行六列(合格/未检/不合格/结构件/电气件/其他)+最近入库时间;质量状态与类型均降为列、不再拆行。\n· 缺料补货:拉取 MES 未来5天排产需求,对比本地可用量,分两列列出「安全库存补货量」(常规补货)与「排产缺料量」(订单驱动紧急补料),在途量暂无数据源显示"—";排产窗口标注需求起止日期。\n\n层级概念:入库单 → 批次/SN → 库存行。区域/库位/质量状态/批次/最近入库时间都是某物料的一对多属性,放在下钻明细中查看,不在物料行上并排平铺。',
'查看当前库存:全品类统一一张库存主表——原材料(批次件按批次/序列号件按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: '纯分类筛选(2026-09-30 类型与记账方式解耦):类型不再决定批次/SN 行为,记账方式由物料档案「序列号件」(sn_mode)独立决定', fill: '全部 / 结构件 / 电气件 / 其他;物料汇总与库位明细视图生效' },
{ name: '归属单号', source: '筛选条件(物料汇总、库位明细视图生效)。归属编号来自入库时登记的「归属」(合同号/科技项目号/其他编号)。', purpose: '库存按归属查(问题8):物料汇总是先按归属模糊过滤库存行、再按物料聚合,总数量/批次数/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: '合格/未检/不合格三列,自动统计' },
{ name: '物料汇总-分布区域', source: '系统统计该物料当前占用了哪些区域。', purpose: '一个物料可跨多个区域存放(批次可拆分),物料行不写死单一区域', fill: '如 Z02、Z05;点行下钻可看每个批次/SN 具体在哪个区' },
{ name: '批次/SN 明细(下钻)', source: '点击任一行弹出抽屉。', purpose: '看该物料的每个批次/SN 所在区域、质量状态、锁定与来源入库单', fill: '抽屉内分页展示;点入库单号可跳转入库页' },
{ name: '抽屉-在库处置(不合格品处置)', source: '抽屉内「在库」库存行操作列「处置」按钮。', purpose: '合格入库后的物料在使用中发现不合格,直接从库存行发起退货/换修/报废/让步接收,无需绕道补录检验记录(自动生成一条不合格留痕检验记录)', fill: '退货(必填货运单号→系统自动生成退供应商出库单并真实扣减库存,一步闭环);换修(置不合格隔离,待返修);报废(不合格+报废,退出可用);让步接收(放行→合格)。仅「在库」行可发起' },
{ name: '批次/SN 明细(下钻)', source: '点击任一行弹出抽屉。', purpose: '看该物料的每个批次/SN 所在区域、质量状态与来源入库单', fill: '抽屉内分页展示;点入库单号可跳转入库页' },
{ name: '抽屉-在库处置(不合格品处置)', source: '抽屉内「在库」库存行操作列「处置」按钮。', purpose: '合格入库后的物料在使用中发现不合格,直接从库存行发起退货/换修/报废,无需绕道补录检验记录(自动生成一条不合格留痕检验记录)', fill: '退货(必填货运单号→系统自动生成退供应商出库单并真实扣减库存,一步闭环);换修(置不合格隔离,待返修);报废(不合格+报废,退出可用)。仅「在库」行可发起。在库处置支持部分数量:批次件选退货/换修/报废时可填处置数量(默认=行数量),原行保留剩余数量继续在库;拆分行按处置方式隔离(退货→待退并随退供应商出库单出库、换修/报废→不合格),备注注明部分处置 x/y;序列号件不支持部分数量' },
{ 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(数=数量),批次件可填批次号(留空自动生成);退回隔离区四级库位可选。提交即重建隔离库存行并生成退不良单(RECEIVED),全程事件日志留痕' }
{ name: '生产退不良(视图五)', source: '页面签五「生产退不良」。产线使用中(已出库/已消耗)发现的不良品退回库房隔离的登记入口。', purpose: '已出库/已消耗的物料,产线用后才发现坏,在此登记退回:系统重建隔离库存行(质量=不合格,不进可用),随后到「库位明细」按质量筛选「不合格」找到该行,走「在库处置」(退货/换修/报废)完成闭环', fill: '必填:始发工位号、关联工单号、物料编码、退回数量、质量原因;序列号件逐行录入 SN(数=数量),批次件可填批次号(留空自动生成);退回隔离区四级库位可选。提交即重建隔离库存行并生成退不良单(RECEIVED),全程事件日志留痕' }
]
}
export const helpInspection = {
title: '检验(来料/过程/完工)',
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· 序列号件/其他:逐个判定(检验数固定 1),每个 SN/件一条记录、一行库存,选中判不合格即隔离该件,无需拆分。\n\n【归属口径(需求22)】归属类型 = 合同号 / 科技项目号 / 其他,默认“其他”。这里的“合同号”是独立维度标签,与 MES 工单号不是同一东西;手动输入、不联动 MES、不校验格式(长度≤64)。\n\n【按物料统计】统计页需先选择物料再点“统计”,不做全表实时聚合。\n\n本页四个页签(录入在前、记录在后点击才加载):\n· 质量检验录入(默认打开):逐个判定——每一条待检目标(批次号/SN)独立成一行,分别选结论、填检验数/合格数,不合格数=检验数−合格数自动算出;整组点一次「提交」调 /inspection/batch-flip 原子翻转,多行同 id 自动去重。\n· 待检清单:按入库单分组展示(主行=入库单,展开看该单的批次/SN 明细与未检数量),支持整单送检、单条送检、跨行勾选送检;送检即把目标回填到「质量检验录入」并带入归属,免去手输编号。\n· 检验记录(点击才加载):历史判定记录,含「不合格数」列(=检验数−合格数,后端复核)。\n· 按物料统计:选物料后聚合其检验次数与合格率。\n\n菜单按业务分为来料/过程/完工三个入口,同一张表、同一接口,仅按检验类别默认过滤。每条检验记录可上传/查看附件(检测报告/照片)。',
'【检验分工与边界】本页仅做来料检(WMS 仓储作业)。过程检、完工检的生产质检已收口至 MES(巡检终端 + 质量检验页),不在 WMS 录入。\n· 来料检(incoming):对采购/外协到货、入库前的物料验收,按入库批次/SN 判定。合格才能入库上架,不合格隔离退货。从库存选批次仅列出未检状态;已检对象不可重复送检,不合格品重新判定走复检。\n\n【检验做什么】把库存行的“质量状态”从未检翻转为合格/不合格,与存放区域无关。库存校验只取质量状态=合格的行参与出库。\n\n【报检数守恒】报检数 = 合格数 + 不合格数;合格数不得大于报检数;判定合格时合格数应等于报检数(否则请改判不合格并选处置方式)。\n\n【不合格处置(需求23 换修闭环)】判不合格必选处置:退货(须填货运单号、库存置待退) / 换修(隔离为不合格,等返修后重新报检) / 报废 / 部分入库(仅批次件:一次只处理 1 个批次,按合格数拆行)。已判不合格的记录也可在列表里再次处置。\n\n【批次件 vs 序列号件/其他的不合格口径】\n· 批次件:一行数量 N,判不合格=整批隔离;“N 里坏 M 个”用「部分入库」填合格数 N−M,系统拆出 (N−M) 合格批次 + M 不合格批次。\n· 序列号件/其他:逐个判定(检验数固定 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: '菜单入口锁定检验类别。', purpose: '来料检=入库验收;过程检=在制巡检;完工检=成品 SN 终检', fill: '按左侧菜单进入对应页面,页内不再切换类别' },
{ name: '检验边界', source: 'WMS 仅来料检。', purpose: '来料检=入库验收;过程检/完工检在 MES 完成', fill: '按左侧「来料检验」菜单进入' },
{ name: '目标类型', source: '单选,决定录入框标题与可选库存范围。完工检固定为 SN,不展示切换。', purpose: '检验对象:批次件 / 序列号件 / 其他(辅料·工装·试验设备,按 1 件判定);按记账方式(物料档案 sn_mode)划分,与物料类型无关', fill: '批次件 BATCH / 序列号件 SN / 其他 OTHER(任一切换都会自动刷新“从库存选”下拉与可选库存范围)' },
{ name: '检验结论', source: '单选。', purpose: '判定结果', fill: '合格 / 不合格' },
{ name: '记录人 / 审核人', source: '手动填写(默认当前用户)。完工检显示为“审核人”。', purpose: '谁检验/审核的,追溯用', fill: '姓名' },
@@ -127,10 +128,11 @@ export const helpInspection = {
{ name: '待检清单(页签二)', source: '调用 /inspection/pending 按入库单分组(主行=入库单,展开看批次/SN 明细与未检数量)。', purpose: '无需手输编号即可把待检目标送进录入页,杜绝输错', fill: '支持 整单送检(该单全部未检目标)/ 单条送检(展开行内单个目标)/ 跨行勾选送检(勾选多条后批量送);送检即回填「质量检验录入」并带入归属,可在此页按 图号/入库类型/目标类型 筛选' },
{ name: '逐个判定(录入页)', source: '录入页以「条目」为单位:每一条待检目标(批次号/SN)独立成一行,各自选结论、填检验数/合格数,不合格数=检验数−合格数自动算出。', purpose: '一条入库单往往含多批次/SN,逐个判定互不串扰', fill: '点「提交」整组一次性调 /inspection/batch-flip 翻转;同一 targetId 多行自动去重;选「合格」时合格数默认等于检验数,选「不合格」须填不合格处置' },
{ name: '检验数 / 合格数', source: '批次件可编辑;序列号件/其他固定 1 件判定、不可改数。守恒:检验数 = 合格数 + 不合格数。', purpose: '量化该条目标的抽检结果', fill: '批次件:合格数≤检验数,判合格时两者相等;序列号件/其他:固定 1/1(合格) 或 1/0(不合格),不合格即整件隔离、无需拆分' },
{ name: '第几批 / 共几件', source: '已选清单内两个数字输入,选中物料后按其记账方式(库存行 sn_mode)分流。', purpose: '批次件来料检验记录本次是第几批、到货共几件,随检验记录留存追溯', fill: '批次件两个必填、均≥1(不填提交会被拦截,报"批次件来料检验需填写第几批与共几件");序列号件不显示不填写;检验记录列表与导出同步两列,未填(0)显示 -' },
{ name: '归属', source: '下拉选择类型 + 手动输入编号(默认其他)。', purpose: '标记检验对象归属,便于按归属查询', fill: '合同号 / 科技项目号 / 其他;编号手动输入、不校验格式、长度≤64' },
{ name: '不合格处置', source: '判定“不合格”时必选:退货 / 换修 / 让步接收 / 报废 / 部分入库(仅批次件可选,序列号件/其他不展示该选项)。', purpose: '不合格品不入库、不上产线,须明确去向(需求23 换修闭环)', fill: '退货(填货运单号→待退) / 换修(隔离不合格→待返修) / 让步接收(放行→合格) / 报废 / 部分入库(单批次拆批:合格部分入库、差额隔离)' },
{ 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: '必选物料;按时间区间与检验类别聚合,每次检验独立计数' }
]
}
@@ -138,26 +140,26 @@ export const helpInspection = {
export const helpStocktake = {
title: '盘点(库存核对)',
overview:
'盘的是「库存量」(实物在库总数),不是可用量、不是锁定量。账面数=发起时快照的库存量,实盘数=实际数到的库存量,差异=实盘-账面。\n\n' +
'盘的是「库存量」(实物在库总数)。账面数=发起时快照的库存量,实盘数=实际数到的库存量,差异=实盘-账面。\n\n' +
'完整闭环(顶部步骤条引导):\n' +
'① 发起盘点:选范围(全库/按区域/按物料) → 冻结库存快照 + 锁定该范围库存 → 生成盘点单号,状态「进行中」,目标数量=本次覆盖的批次/SN 总数(自动算)。\n' +
'① 发起盘点:选范围(全库/按区域/按物料) → 冻结该范围库存并保存快照 → 生成盘点单号,状态「进行中」,目标数量=本次覆盖的批次/SN 总数(自动算)。\n' +
'② 扫码实盘:扫批次号(批次件)弹数量框填实盘数;扫 SN(序列号件)自动记 1、直接提交。发起后盘点单号自动带入扫码区,无需手动粘贴。\n' +
'③ 完成盘点:先选未盘项处理方式(按账面保留/盘亏为0) → 二次确认是否写回 → 写回则生成盘点调整单修正库存 → 解锁库存。\n\n' +
'③ 完成盘点:先选未盘项处理方式(按账面保留/盘亏为0) → 二次确认是否写回 → 写回则生成盘点调整单修正库存 → 解冻库存。\n\n' +
'三条铁律:\n' +
'• 盘点期间库存冻结:进行中盘点单锁定的批次/SN,禁止出库、入库追加、锁定,避免差异混入正常业务变动(完成或取消后自动解锁)。\n' +
'• 写回只改库存量:锁定量不动,可用量自动重算;写回后强制满足「库存量 = 可用量 + 锁定量」,若盘亏后库存量将小于锁定量则拒绝写回,须先解锁。\n' +
'• 盘点期间库存冻结:进行中盘点单覆盖的批次/SN,禁止出库、入库追加,避免差异混入正常业务变动(完成或取消后自动解冻)。\n' +
'• 写回只改库存量:按差异修正后实时生效;盘亏数量不能超过在库数量,否则拒绝写回。\n' +
'• 写回走调整单留痕:生成调整单号,调整前/调整量/调整后全部入操作日志,可追溯谁在何时改了什么;写回不可逆,需主管以上权限。\n\n' +
'状态机:进行中(已锁定) → 已完成(仅出结论不改库存) / 已写回(差异已修正库存) / 已取消(解锁并记录原因)。',
'状态机:进行中(已冻结) → 已完成(仅出结论不改库存) / 已写回(差异已修正库存) / 已取消(解冻并记录原因)。',
fields: [
{ name: '盘点范围', source: '发起时选择。', purpose: '冻结快照 + 锁定库存的范围', fill: '全库 / 按区域(多选) / 按物料(多选+类型)' },
{ name: '盘点范围', source: '发起时选择。', purpose: '冻结库存并保存快照的范围', fill: '全库 / 按区域(多选) / 按物料(多选+类型)' },
{ name: '操作人', source: '登录账号自动带出。', purpose: '发起盘点人', fill: '自动' },
{ name: '目标数量', source: '发起时自动统计。', purpose: '本次盘点覆盖的批次/SN 总数', fill: '自动,无需填写' },
{ name: '发起盘点', source: '按钮操作(权限 stocktake:start)。', purpose: '按范围冻结快照并锁定库存,生成盘点单号', 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: '按钮操作(权限 stocktake:start)。', purpose: '发起错误或扫码错误过多时退出', fill: '点「取消盘点」填写原因→确认;解冻库存,状态置「已取消」,已扫记录作废' },
{ name: '历史列表', source: '查询结果。', purpose: '追溯历次盘点', fill: '含状态/差异项数/是否写回/写回时间/取消原因,可按单号或状态筛选' },
{ name: '导出明细', source: '历史行末按钮(权限 stocktake:view)。', purpose: '导出盘点明细为 xlsx', fill: '列:盘点单号/类型/批次或SN/物料编码/货位/账面数/实盘数/差异/是否已盘/实盘人/实盘时间/发起人/发起时间' }
]
@@ -180,7 +182,7 @@ export const helpSemi = {
{ 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: '继承产线工单(2026-09-29 定稿):填了工单号即自动带出"合同号+编号"并置为只读;无工单号或该工单无合同号时可手动选择。', purpose: '半成品来自生产,天然挂合同号,与成品同归属,按归属筛选即可闭环查询', fill: '优先填工单号自动带出;手动兜底选 合同号/科技项目号/其他,选合同号或科技项目号须填编号' },
{ name: '产品状态', source: '下拉选择(可空):已通过 / 部分通过 / 返修。', purpose: '该件完工/暂存时的质量结论快照,随库存行展示', fill: '按实际结论选择,可空' },
{ name: '相关标准 / 试验记录单号 / 记录员·日期', source: '手工填写(可空)。', purpose: '成品/半成品入库的质量档案补充信息', fill: '检验细则或试验方案号、试验记录单号、记录员姓名与日期' },
{ name: '区域', source: '手动填写(可空)。', purpose: '存放库区', fill: '如 Z05' },
@@ -206,6 +208,32 @@ export const helpSemi = {
]
}
export const helpFinishedInbound = {
title: '成品入库(手工)',
overview:
'方案A定稿(完工检合格才入成品库):成品入库与「完工自动回流」解耦为双通道——\n' +
'· 通道一(自动回流):MES 完工检合格后调 WMS 内部接口 /api/internal/finished/inbound 自动回流入库,无需人工操作;\n' +
'· 通道二(本页手工入库):库房对完工检合格的成品手工建档入库(含 MES 未回流补录、返修后再入库等场景),权限码 wms.finished:edit。\n' +
'两通道共用同一套后端创建逻辑与字段口径(成品入库九字段:SN/图号/归属/产品状态/相关标准/试验记录单号/记录员/记录日期/工单号),\n' +
'统一落库存主表(品类=成品,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: