feat: 解耦管理类型与SN管理方式,新增sn_mode字段实现全链路SN管理标准化

本次重构将原manage_mode字段拆分为独立的分类维度(manage_mode)和SN管理维度(sn_mode),实现全链路(MES/WMS/工位终端)的SN管理行为统一依据:
1. 新增sn_mode字段,定义1=序列号件、2=批次件、0=未选择,替代原manage_mode的SN判断逻辑
2. 移除冗余的manage_mode字段在多个实体中的使用,统一使用sn_mode决定业务行为
3. 新增工位接驳台配置,服务端固定接驳台,前端不可修改,确保AGV送达准确性
4. 优化检验记录导出,新增装配物料绑定明细,满足客户追溯需求
5. 修正前端提示文本,统一使用序列号件/批次件表述,与后端逻辑对齐
This commit is contained in:
SunYF
2026-09-30 17:33:11 +08:00
parent 58f67240d7
commit c33acab9c8
136 changed files with 3730 additions and 1174 deletions
+34 -15
View File
@@ -12,11 +12,12 @@ export const helpProductType = {
name: '编码',
source: '系统自动生成 + 可手动修改。新建时会自动带出(格式 PROD-YYYYMMDD-序号),你可直接使用或改为自定义编码;编辑时保留已存值。一个产品编号可对应多个工单(同一型号今天做一批、明天做一批,工单号不同,产品编号相同)。',
purpose: '产品唯一编码。它是 MES 内部识别该产品的标识,决定该产品的物料清单内容,也是工单、备料、拧紧、追溯的挂靠键。',
fill: '建议用有意义的编码,如 METER-01。要点:①两库对等(2026-09-29):本页读写 MES 本地物料副本并自动同步 WMS,WMS 宕机时新建/查询照常可用,推送失败自动重推;②成品完工后系统自动生成 SN 并回流 WMS 入库,无需人工对账;③如产品编号就是成品编码,则直接沿用该编码即可;④建好后不要随意改,否则下游工单/追溯的关联会断。'
fill: '建议用有意义的编码,如 METER-01。要点:①两库对等(2026-09-29):本页读写 MES 本地物料副本并自动同步 WMS,WMS 宕机时新建/查询照常可用,推送失败自动重推;②建档必选「类型」(结构件/电气件/其他)与「序列号件」(序列号件=录SN / 批次件=不录SN,选类型自动带默认可改);③成品完工回流 WMS 入库:序列号件以扫入的来料SN入账、批次件由系统发号,无需人工对账;④如产品编号就是成品编码,则直接沿用该编码即可;⑤建好后不要随意改,否则下游工单/追溯的关联会断。'
},
{ name: '规格', source: '手工填写(必填)。与 WMS 物料档案必填口径一致。', purpose: '成品的规格型号,用于识别与打印', fill: '如:500×300×200' },
{ name: '单位', source: '手工填写(必填)。与 WMS 物料档案必填口径一致。', purpose: '计量单位', fill: '如:台 / 套' },
{ name: '类别', source: '手工填写。可选,无上游来源。', purpose: '产品所属大类,便于分类统计', fill: '如:计量表 / 开关柜;可空' },
{ name: '类型', source: '下拉必选(结构件/电气件/其他)。', purpose: '产品的分类口径,仅作分类,不决定是否逐件SN管理', fill: '选择类型后自动带默认「序列号件」:电气件→序列号件,结构件/其他→批次件(可改)' },
{ name: '序列号件', source: '下拉必选(序列号件=录SN / 批次件=不录SN)。', purpose: '决定全链路 SN 行为:上线建档(序列号件须扫已在WMS入库登记的来料SN,批次件系统自动发号)、装机绑定(序列号件绑SN、批次件绑批次号)、备料出库与质量检验定位', fill: '未选择(请选择)不可保存;默认随「类型」联动带出,可手动改' },
{ name: '启用', source: '开关选择。默认开启。', purpose: '启用后才允许在新建工单/备料的下拉里被选到', fill: '默认开启;暂时停产的可关闭(不删除,保留档案)' },
{ name: '停用', source: '行内「停用」按钮(原「删除」,两库均不物理删除)。', purpose: '停用后该型号退出新建下拉,并自动同步 WMS 同步停用;历史工单/库存/追溯不受影响', fill: '点「停用」二次确认即可;已停用的行按钮显示「已停用」' }
]
@@ -25,19 +26,18 @@ export const helpProductType = {
export const helpWorkOrder = {
title: '工单管理(新建 / 编辑 / 删除工单)',
overview:
'工单 = 一个"合同/生产批次"的唯一载体,是生产执行和仓库出库挂靠的核心对象。\n\n全流程:先有产品型号(在「物料档案」里建档) → 建工单(选产品型号、选定物料清单、定数量、勾选工艺组合) → 进"工艺"给工艺维护工艺步骤与物料清单 → 到"日排产"排哪天产多少 → 仓库按排产备料出库 → 产线装配/拧紧/报工 → 完工(成品 SN 系统自动生成,并自动回流 WMS 入库为"成品"品类)。\n工单号会贯穿 备料单、拧紧查询、工件追溯、操作日志 全链路。\n\n工程编号:一个合同对应一个工程编号,一个工程编号下对应各个产品的产品序号——即「合同号 → 工程编号 → 产品序号」三级归属,用于按合同/工程项目归集与追溯。\n\n查询:支持按 工单号 / 产品编号 / 产品名称(模糊) / 合同号 / 工程编号 / 状态 组合筛选;删除:仅「已创建 / 待排产 / 已发布」且无排产、备料、生产数据的工单可删除(操作列「删除」),生产中或已完成的工单不可删除。',
'工单 = 一个"生产批次"的唯一载体,是生产执行和仓库出库挂靠的核心对象。\n\n全流程:先有产品型号(在「物料档案」里建档) → 建工单(选产品型号、定数量、勾选工艺组合) → 进"工艺"给工艺维护工艺步骤与物料清单 → 到"日排产"排哪天产多少 → 仓库按排产备料出库 → 产线装配/拧紧/报工 → 完工(成品 SN 系统自动生成,并自动回流 WMS 入库为"成品"品类)。\n产品工号会贯穿 备料单、拧紧查询、工件追溯、操作日志 全链路。\n\n客户编号体系(三级归属):一级=合同号/科技项目号(二选一,即「归属类型+归属编号」)→ 二级=产品工号(原工单号,一个产品工号对应一个新建工单/一批)→ 三级=产品序号(工单内每台)。产品编码=图号(与产品型号编码同值,随型号自动带出)。原「工程编号」已被合同号顶替,页面不再展示/录入/查询。\n\n查询:支持按 产品工号 / 图号 / 产品名称(模糊) / 归属类型 / 归属编号 / 状态 组合筛选;操作列「详情」可查看工单字段汇总与该工单的工件SN列表(产品序号/SN/类型/状态/当前工位);删除:仅「已创建」且无排产、备料、生产数据的工单可删除,生产中或已完成的工单不可删除。',
sections: [
{
title: '工单基本信息',
fields: [
{ name: '工单号', source: '系统自动生成(WO+时间戳),可手工改。新建时自动带出。', purpose: '唯一标识一个工单,备料/出库/报工/追溯都挂在此号下', fill: '一般不用改;如改动须保证唯一' },
{ name: '产品工号', source: '系统自动生成(WO+时间戳),可手工改。新建时自动带出。', purpose: '唯一标识一批生产(原"工单号"),备料/出库/报工/追溯都挂在此号下', fill: '一般不用改;如改动须保证唯一' },
{ name: '产品型号', source: '下拉选择。数据来自「物料档案」页面已启用的记录。', purpose: '说明这批生产的是什么产品,并决定物料清单内容', fill: '先到「物料档案」页面建好记录再选择' },
{ name: '合同号', source: '手工填写。', purpose: '标记本工单所属的合同(一个合同对应一个工程编号)', fill: '如 HT-2026-001(可空)' },
{ name: '工程编号', source: '手工填写。', purpose: '标记本工单所属的工程编号(一个工程编号下挂多个产品序号)', fill: '如 GC-2026-001(可空)' },
{ name: '产品序号', source: '手工填写。', purpose: '本产品在该工程编号下的序号,用于区分同工程下的不同产品', fill: '如 01、02(可空)' },
{ name: '产品编号', source: '手工填写。通常与所选产品型号的编码一致。', purpose: '产品唯一编码,用于展示与追溯', fill: '如 METER-01,与产品型号编码对齐' },
{ name: '产品名称', source: '手工填写。通常与产品型号名称一致。', purpose: '产品中文名,用于展示', fill: '如 智能电表' },
{ name: '图号', source: '随产品型号自动带出(产品编码=图号,同值)。', purpose: '产品的图样编号,用于展示与追溯', fill: '随型号带出无需手填;未选型号时可手工填写' },
{ name: '产品名称', source: '随产品型号自动带出。', purpose: '产品中文名,用于展示', fill: '随型号带出,无需手填' },
{ name: '归属类型', source: '下拉必选:合同号 / 科技项目号 / 其他。', purpose: '一级归属的类型标记(合同号/科技项目号二选一)', fill: '按订单来源选择;归属会随半成品流转自动继承到 WMS' },
{ name: '归属编号', source: '手工填写。随归属类型填合同号或科技项目号。', purpose: '一级归属编号(合同号/科技项目号二选一)', fill: '如 HT-2026-001 或 KJ-2026-001;选「其他」可不填' },
{ name: '产品序号', source: '手工填写。', purpose: '三级归属:本工单内每台产品的序号,用于区分同批不同台', fill: '如 01、02(可空)' },
{ name: '数量', source: '手工填写整数。', purpose: '本工单生产总数量(合同台数),决定需求量与排产上限', fill: '整数 ≥1,如 100' },
{ name: '工艺组合', source: '按工艺分组勾选工位(数据来自「工位绑定」页的工位↔工艺绑定)。保存为 [{flowId,stationNo}]。', purpose: '本工单的执行路线;自动排产/备料拆分/产线下发均按此组合派生', fill: '默认每个已绑定工艺的工位全选;至少选一道工艺;全不选某工艺则该工艺不进入组合;执行顺序=工位号升序,可跳过未选工位' },
{ name: '状态', source: '新建时选"已创建",后续由流程推进。', purpose: '工单生命周期:创建→发布→生产→完成', fill: '新建时选"已创建";也可在列表操作列点「状态」快捷流转(发布/开工/完工)' },
@@ -45,6 +45,13 @@ export const helpWorkOrder = {
{ name: '创建人', source: '系统自动记录(当前登录账号)。', purpose: '追溯工单由谁创建', fill: '只读,自动带入' }
]
},
{
title: '工单详情',
overview: '列表操作列「详情」打开只读抽屉:上半部分为工单字段汇总(产品工号/图号/名称/归属/数量/状态/日期),下半部分为该工单的工件SN列表。\n工件SN列表数据来源=工件进线登记记录:产品序号为工单内顺序号,SN 为工件唯一序列号,类型(序列号件/批次件)取自图号对应物料档案的「序列号件」设置,状态与当前工位为实时生产进度。',
fields: [
{ name: '工件SN列表', source: '既有工件查询接口按工单号过滤,实时读取。', purpose: '核对该批每台产品的 SN、类型、状态与当前工位', fill: '只读,无需操作' }
]
},
{
title: '工艺组合(路线)',
overview: '新建/编辑工单时勾选「工艺组合」:按工艺分组,每组勾选该工艺要执行的工位。\n组合结果按工位号升序只读展示为路线条(如 2→5→6→8)——执行顺序=工位号升序,可跳过未选工位。\n「自动排产」要求工单已配置工艺组合:组合为空时按钮置灰,提示"请先选择工艺组合"。\n半成品再上线:编辑工单,只勾剩余要走的工位即可。',
@@ -96,7 +103,7 @@ export const helpMaterial = {
},
{
title: '自动出库',
overview: '生成备料单时自动执行;也可在库存补齐后按排产日/工单一键补出。规则:结构件按批次号升序(FIFO)逐批出库,电气件按可用 SN 逐件出库,仅取 WMS「合格」在库库存;超出物料清单需求的领用必须填写超领原因(损耗/报废/返修),自动出库不擅自超领,超领部分会留在「未出齐」清单里等人工处理。',
overview: '生成备料单时自动执行;也可在库存补齐后按排产日/工单一键补出。规则:批次件按批次号升序(FIFO)逐批出库,序列号件按可用 SN 逐件出库(口径=物料档案「序列号件」),仅取 WMS「合格」在库库存;超出物料清单需求的领用必须填写超领原因(损耗/报废/返修),自动出库不擅自超领,超领部分会留在「未出齐」清单里等人工处理。',
fields: [
{ name: '一键自动出库', source: '人工在本页操作(生成时已自动执行一次)。', purpose: '把当前排产日/工单下未出齐的备料单补齐', fill: '选好日期或工单号后点「一键自动出库」,结果会列出仍未出齐的明细' }
]
@@ -218,7 +225,7 @@ export const helpVirtualStation = {
{ name: '工单', source: '今日已启用日排产且工单已下发/在制(与终端口径一致)。', purpose: '本工位今天该干哪些工单', fill: '选择当前作业的工单' },
{ name: '工件SN', source: '上线建档时系统生成的工件唯一码(标签/二维码)。', purpose: '定位工件与所属工单,报工/绑定都挂在 SN 下', fill: '扫码或手输后回车载入' },
{ name: '工艺步骤', source: '工位绑定工艺的步骤模板(工艺页维护)。', purpose: '本工位要做什么、考核标准是什么', fill: '手填步骤逐项录入数值/结果;「检测确认」步骤需勾选;拧紧步骤由物理工位采集,本页只读' },
{ name: '配料', source: '工艺物料清单(flow_material)中该工艺要求装配的物料 + 已绑记录(bind-panel 接口)。', purpose: '装机绑定强校验:电气件需绑满单台用量 SN、结构件至少绑一个批次号,缺料不允许报工', fill: '在录入框填批次号/SN(多个用逗号分隔),随报工一次性提交' },
{ name: '配料', source: '工艺物料清单(flow_material)中该工艺要求装配的物料 + 已绑记录(bind-panel 接口)。', purpose: '装机绑定强校验:序列号件需绑满单台用量 SN、批次件至少绑一个批次号,缺料不允许报工', fill: '在录入框填批次号/SN(多个用逗号分隔),随报工一次性提交' },
{ name: '完成报工', source: 'POST /station/report(与终端同一接口)。', purpose: '写实绩 + 步骤考核 + 装机绑定,原子提交', fill: '全部录入后点「完成报工」;报错按提示补齐' }
]
}
@@ -254,7 +261,7 @@ export const helpDock = {
export const helpTrace = {
title: '工件追溯',
overview:
'输入工件 SN,查它的完整履历:进线/完工时间、各工位时间线、步骤考核数据(扭矩/角度)、拧紧记录、以及它用了哪些批次/电气件。\n\n数据来源:全部由前端各环节自动写入(扫码报工、拧紧采集、产线设备下发、工位完成),本页只读查询。',
'输入工件 SN,查它的完整履历:进线/完工时间、各工位时间线、步骤考核数据(扭矩/角度)、拧紧记录、以及它用了哪些批次号/序列号件。\n\n数据来源:全部由前端各环节自动写入(扫码报工、拧紧采集、产线设备下发、工位完成),本页只读查询。',
fields: [
{ name: '工件SN', source: '扫码枪/手输。来自工件条码。', purpose: '要追溯的工件唯一序列号', fill: '扫 SN 或手动输入后点查询' },
{ name: '工单号', source: '手动输入。筛选条件。', purpose: '按工单号列出该工单下全部工件,再点行内「追溯」查看单个工件履历', fill: '可空;支持模糊匹配,回车即查' }
@@ -322,7 +329,7 @@ export const helpEventLog = {
export const helpProcessFlow = {
title: '工艺(作业指导,含工艺步骤与物料清单)',
overview:
'页面分「工艺列表」「工艺配置」两个页签:列表查看全部工艺并做启用/停用/删除;配置页维护工艺基本信息、工艺步骤与物料清单(新增与编辑共用,不再弹窗套弹窗)。\n\n工艺 = 一份「菜谱」:只描述某个产品该怎么装配(工艺步骤名、采集方式、考核标准、所需物料),可被多个工位绑定,不隶属某个工位。\n\n概念统一说明:\n· 工位:产线上的物理工位(工位数以数据库为准),工位号即顺序号,相当于「灶台」。\n· 工艺:一份作业指导(PDF + 工艺步骤 + 物料清单);其启用状态决定是否参与生产。\n· 工艺步骤:工艺内包含多个步骤(如:装配完成、拧紧扭矩、测试)。\n· 物料清单:该工艺装配所需物料(物料编号/名称/规格/单位/管控方式/单台用量/损耗率),整表覆盖保存。\n\n绑定关系在「工位绑定」页维护:为某工位选择启用的工艺即绑定;一个工位只能绑定一个工艺。工单在「工单管理」勾选「工艺组合」确定执行路线(工位号升序)。\n\n数据链路:本页维护工艺+工艺步骤+物料清单+考核标准 → 工位绑定页绑定 → 工单勾选工艺组合 → 工位终端按工艺步骤采集 → 报工按考核标准自动判 合格/不合格 → 工件追溯/绩效报表可见。',
'页面分「工艺列表」「工艺配置」两个页签:列表查看全部工艺并做启用/停用/删除;配置页维护工艺基本信息、工艺步骤与物料清单(新增与编辑共用,不再弹窗套弹窗)。\n\n工艺 = 一份「菜谱」:只描述某个产品该怎么装配(工艺步骤名、采集方式、考核标准、所需物料),可被多个工位绑定,不隶属某个工位。\n\n概念统一说明:\n· 工位:产线上的物理工位(工位数以数据库为准),工位号即顺序号,相当于「灶台」。\n· 工艺:一份作业指导(PDF + 工艺步骤 + 物料清单);其启用状态决定是否参与生产。\n· 工艺步骤:工艺内包含多个步骤(如:装配完成、拧紧扭矩、测试)。\n· 物料清单:该工艺装配所需物料(物料编号/名称/规格/单位/管理方式/单台用量/损耗率),整表覆盖保存。\n\n绑定关系在「工位绑定」页维护:为某工位选择启用的工艺即绑定;一个工位只能绑定一个工艺。工单在「工单管理」勾选「工艺组合」确定执行路线(工位号升序)。\n\n数据链路:本页维护工艺+工艺步骤+物料清单+考核标准 → 工位绑定页绑定 → 工单勾选工艺组合 → 工位终端按工艺步骤采集 → 报工按考核标准自动判 合格/不合格 → 工件追溯/绩效报表可见。',
sections: [
{
title: '工艺基本信息',
@@ -333,7 +340,7 @@ export const helpProcessFlow = {
{ name: '作业指导PDF', source: '本页上传。文件由 MES 服务器保存。', purpose: '该工艺的作业指导图,工位终端打开预览', fill: '选择 PDF 上传,成功后显示文件名可预览' },
{ name: '工艺步骤', source: '本页维护(步骤名/采集方式/是否拧紧/考核标准)。', purpose: '工位终端报工时按此动态渲染参数输入', fill: '一个工艺可含多个工艺步骤,按序号顺序执行' },
{ name: '步骤附件/图纸', source: '每个工艺步骤单独上传(绑定式)。文件由 MES 服务器保存。', purpose: '把图纸精确绑定到具体步骤,工位终端按当前步骤自动展示对应图纸', fill: '在步骤行上传该步骤图纸/附件(可多个);随步骤自动分发到工位终端' },
{ name: '物料清单', source: '本页维护:物料编号(下拉选择,取自物料档案)/名称/规格/单位/管控方式/单台用量/损耗率%,整表覆盖保存。', purpose: '该工艺装配所需物料;备料需求 = 各工位分产量 × 单台用量 × (1+损耗率%)', fill: '物料编号取自物料档案编码(结构件通常即图号),选中后名称/规格/单位/管控方式自动带出、不可改;管控方式:批次=1、序列号=2' }
{ name: '物料清单', source: '本页维护:物料编号(下拉选择,取自物料档案)/名称/规格/单位/管理方式/单台用量/损耗率%,整表覆盖保存。', purpose: '该工艺装配所需物料;备料需求 = 各工位分产量 × 单台用量 × (1+损耗率%)', fill: '物料编号取自物料档案编码(结构件通常即图号),选中后名称/规格/单位/管理方式自动带出、不可改;管理方式(序列号件)来自物料档案:1=序列号件(录SN)、2=批次件(不录SN)' }
]
},
{
@@ -440,6 +447,18 @@ export const helpInspect = {
{ name: '文字描述', source: '手动填写。', purpose: '异常详细说明', fill: '描述异常情况' }
]
},
{
title: '待签任务(拧紧审核签字)',
overview:
'集中展示拧紧数据中未审核的任务(按 工单号+SN+工位 聚合,按最近采集时间倒序)。此处签字 = 检验员第二签:操作人已由采集自动带入,检验员逐行点「审核签字」(可填审核意见),确认后该任务全部未审核记录的审核人标记为当前登录账号,并逐条写入拧紧审核留痕——可到 MES 后台【拧紧查询】页打开留痕查看。应拧为「未配置」表示该工位未绑定含扭矩步骤的工艺流程。',
fields: [
{ name: '工单号/SN/工位', source: '来自拧紧采集记录(未审核),按 工单号+SN+工位 聚合。', purpose: '定位待签任务', fill: '只读' },
{ name: '应拧', source: '该工位绑定工艺流程中 isTorque 步骤数。', purpose: '工艺基准数量', fill: '只读;工位未绑定流程时显示「未配置」' },
{ name: '实拧(未审核)/合格/不合格', source: '该组未审核记录统计。', purpose: '核对待签数量与质量', fill: '只读' },
{ name: '最近采集时间/操作人', source: '该组最近一条拧紧记录。', purpose: '判断任务新旧与操作人', fill: '只读' },
{ name: '审核签字', source: '弹窗确认后调 POST /torque/audit-group。', purpose: '检验员第二签,整组批量签字', fill: '可填审核意见,成功提示「已签字 N 条」' }
]
},
{
title: '记录查看',
fields: [