feat: 多系统新增扫码中间件与 AGV 对接,优化拧紧与退库流程

新增扫码中间件支持网络型扫码枪键盘注入,AGV 对接从 WMS 迁至 MES 统一管理;新增拧紧不合格人工处置与 PLC 对账机制,优化退库单关联与工位终端功能,同时清理旧 AGV 任务表,完善数据库与配置项。
This commit is contained in:
SunYF
2026-10-14 17:24:59 +08:00
parent 8e6048c64b
commit f65a52d9e1
170 changed files with 15415 additions and 10572 deletions
+20 -33
View File
@@ -91,38 +91,24 @@ export const helpDailyPlan = {
}
export const helpMaterial = {
title: '备料单(按日排产自动算料)',
title: '叫料单(只读)',
overview:
'备料单 = 仓库备料的依据:某天要生产的所有工单,各需要哪些物料、各要多少。\n\n操作方式:① 先到「日排产」排好某天的计划数量;② 回到本页选该「日期」;③ 点「按日排产生成备料」,系统按各产品物料清单自动计算(计划数量 × 单台用量 × (1+损耗率))并生成备料单明细;④ 生成的同时系统按 FIFO 从 WMS 合格库存自动出库(平时无需人工领料),出库达标的备料单转为「已备料」,由 AGV 配送到各工位。\n\n库存不足怎么办:已出的部分照常记账,差额保持「待备料」并触发「备料未齐套」预警;补货后点「一键自动出库」即可补出(不会超领,重复执行安全)。\n\n超领规则:实际用量超出物料清单需求(损耗/报废/返修)时,系统不硬卡——WMS 出库时填写超领原因即放行并留痕,可统计、可预警;不填原因仍会被拦截。\n\n来源说明:「排产备料」= 按日排产自动生成;「工位补料」= 工位叫料/数量不符补发生成,仓库应优先发补料单。\n\n数据链路:日排产 → 本页按日期自动算料生成备料单 → 自动出库(WMS 扣账)→ AGV 配送 → 工位接料。',
'叫料单 = 工位从「叫料池」发起、仓库据此备料配送的单据。本页只读查看全部叫料单;发起/签收/退库/取消在工位终端操作,完成备料/驳回/确认收回到 WMS「叫料队列」操作。\n\n叫料池是什么:启用状态的日排产(「日排产」页人工启用)自动算出每个工位要用的物料和数量(工位排产量 × 单台用量 × (1+损耗率)),按 工位+物料 汇总成池子行,四数记账:需求 / 已发 / 占用中 / 可用(可用 = 需求 − 已发 − 占用中)。工位只能叫自己工位的料;无工艺或无排产 → 池子无行 → 不能叫。\n\n单据规则:一次叫料按物料行拆成多张单,每张单 = 一个物料 + 一个量 + 一个目标接驳台(一单一个托盘一次配送);叫料单不绑工单、不绑排产,同一物料可多次叫;禁止单内分批,要分就再叫一次。\n\n状态机七态:待备料 → 已发货 → 已完成(工位签收,签收=确认收到、系统不再对差异);分支终态:已取消(待备料时工位撤销)、已驳回(仓库拒发,带理由);退库:已发货 → 退库中 → 已退库(仓库确认收回,仅签收前可整单退,退回后重新叫)。\n\n数量账规则:发起时占用 +请求量;仓库完成备料时已发 +实发量、占用 −请求量(差额自动释放);取消/驳回时占用 −请求量;退库收回时已发 −退库量(额度回补)。\n\n跨日叫料:默认允许叫非今日排产的料(「基础设置」可关);叫到非当日的料,工位端会预警提示,仓库可正常发、也可按「非当日」驳回。要管控就叫「日排产」页把排产置为停用(非启用即不可叫)。\n\n数据链路:日排产(启用) → 叫料池(四数账) → 工位终端发起叫料(占用) → WMS 叫料队列完成备料(WMS 扣库存+AGV 配送) → 工位签收;退库:工位申请 → WMS 退库单 → 仓库确认收回(额度回补)。',
sections: [
{
title: '生成备料',
overview: '按所选日期,取当天所有排产工单,依据各自产品的物料清单自动汇总所需物料。',
fields: [
{ name: '日期', source: '手动选择。', purpose: '按哪个排产日期生成备料', fill: '先选择排产日期,再点「按日排产生成备料」' }
]
},
{
title: '自动出库',
overview: '生成备料单时自动执行;也可在库存补齐后按排产日/工单一键补出。规则:序列号=否按批次号升序(FIFO)逐批出库,序列号=是按可用 SN 逐件出库(口径=物料档案「序列号」),仅取 WMS「合格」在库库存;超出物料清单需求的领用必须填写超领原因(损耗/报废/返修),自动出库不擅自超领,超领部分会留在「未出齐」清单里等人工处理。',
fields: [
{ name: '一键自动出库', source: '人工在本页操作(生成时已自动执行一次)。', purpose: '把当前排产日/工单下未出齐的备料单补齐', fill: '选好日期或工单号后点「一键自动出库」,结果会列出仍未出齐的明细' }
]
},
{
title: '物料去向对账',
overview:
'点「物料去向对账」查看工单物料的完整去向(只读汇总,不新增账本):需求总量、已发出(仓库已出库)、已退回、已消耗(报工核销)、在途(已发出−已接料)、工位余(已接料−已消耗−已退回)、待发缺口。可展开行看接料明细(每张备料单的实收与确认人),并可导出 CSV。\n\n对账状态只标三类硬异常,其余一律「正常」:① 超领 = 净领用(已发出−已退回)超过需求,超领原因在 WMS「出库管理」留痕可查;② 完结剩料 = 台账已领料完结但工位仍压料(没耗也没退),请催报工或发起退料;③ 在途等待 = 已发出未接料(含已送达未扫码),请看 WMS 出库单是否已送达或催工位扫码。生产中的待发缺口属正常状态,不标色。\n\n消耗明细与出库明细不跨系统重复展示:消耗按工位合计的留痕在 WMS 操作日志按工单号查询;出库明细与超领原因在 WMS「出库管理」按工单号查询。',
fields: [
{ name: '物料去向对账', source: 'WMS 台账 + 本系统已接料量实时合成,前端现算异常。', purpose: '一眼看清料到哪一步了、账对不对', fill: '按当前筛选条件查询,弹窗展示;行可展开看接料明细,右下角可导出 CSV' }
]
},
{
title: '查询字段',
fields: [
{ name: '工单号', source: '手动输入。筛选条件。', purpose: '只查看指定工单的备料', fill: '可空,空=看全部工单' },
{ name: '来源', source: '系统标记。排产备料=日排产自动生成;工位补料=工位叫料/差异补发。', purpose: '区分正常备料与补料,补料优先发', fill: '可空=全部' },
{ name: '状态', source: '下拉。待备料 / 已备料(已出库) / 配送中 / 已接料完结。', purpose: '按备料进度筛选', fill: '可空' }
{ name: '叫料单号 / 图号 / 物料名称 / 接驳台 / 工位', source: '手动输入。筛选条件,不区分大小写。', purpose: '定位叫料单', fill: '可空=全部' },
{ name: '来源', source: '系统标记。工位叫料=终端发起;数量不符补发=「数量不符处理」选补发生成。', purpose: '区分正常叫料与差异补发(同样消耗叫料池)', fill: '可空=全部' },
{ name: '状态', source: '下拉。待备料/已发货/已完成/已取消/已驳回/退库中/已退库。', purpose: '按单据进度筛选', fill: '可空=全部' }
]
},
{
title: '列表字段',
fields: [
{ name: '请求量 / 实发量 / 退库量', source: '请求量=发起时确定;实发量=仓库完成备料时确定;退库量=整单退时确定。', purpose: '看一单要多少、实发多少、退了多少', fill: '系统维护' },
{ name: '跨日', source: '系统标记(叫料池行含非今日排产时为「非当日」)。', purpose: '识别跨日叫料', fill: '系统维护' },
{ name: 'WMS出库单号', source: '仓库完成备料时由 WMS 回写(多个逗号分隔)。', purpose: '到 WMS「出库管理」查出库明细', fill: '系统维护' }
]
}
]
@@ -131,7 +117,7 @@ export const helpMaterial = {
export const helpQtyReport = {
title: '数量不符处理(差异闭环)',
overview:
'工位接料时发现「实收 ≠ 应发」,操作工在工位终端上报后,差异记录进入本页等待处理——这是差异闭环的唯一处理入口。\n\n处理方式三选一:\n· 补发:系统生成一张「工位补料」备料单(来源=工位补料),走既有自动出库链路补齐差额,补发量计入工单消耗;\n· 退库:系统生成 WMS 退库单(多发/错发的料退回仓库),仓库确认收货后库存加回、台账缺口自动回补;\n· 调整:双方确认差异、填写说明后直接关闭(不补不退)。\n\n处理完成后差异置为已处理并记录处理单据号,关联预警可在「预警中心」看到同一件事的提醒。补发/退库的单据流转状态请到「备料单」或 WMS「退库单」页查看。',
'工位接料时发现「实收 ≠ 应发」,操作工在工位终端上报后,差异记录进入本页等待处理——这是差异闭环的唯一处理入口。\n\n处理方式三选一:\n· 补发:系统生成一张「数量不符补发」叫料单(来源=数量不符补发,占用叫料池可用量),走仓库叫料队列完成备料后配送到工位,补发量计入工位用料;\n· 退库:系统生成 WMS 退库单(多发/错发的料退回仓库),仓库确认收货后库存加回;\n· 调整:双方确认差异、填写说明后直接关闭(不补不退)。\n\n处理完成后差异置为已处理并记录处理单据号,关联预警可在「预警中心」看到同一件事的提醒。补发/退库的单据流转状态请到「叫料单」或 WMS「退库单」页查看。',
sections: [
{
title: '查询字段',
@@ -514,7 +500,7 @@ export const helpWip = {
export const helpAlertCenter = {
title: '预警中心(系统自动触发)',
overview:
'预警中心汇集全系统自动产生的异常/提醒消息,人工无需配置规则——全部由内置触发源自动落库并推送。顶部铃铛角标显示未读数,点击进入本页处理。\n\n八类内置触发源:\n· 扭紧不合格(torque_ng):拧紧扭矩/角度超考核标准时自动告警。触发点=拧紧枪完成拧紧后由工位终端自动上报拧紧结果时(拧紧采集落库后约15秒内自动上报;终端离线时缓存在终端、恢复后补报),不依赖操作工点「保存/完成报工」;\n· 检验不合格(inspection_ng):质量检验判定 NG 时告警;\n· 备料未齐套(material_shortage):工单装机绑定物料未齐套时告警;\n· 库存偏低(inventory_low):可用量低于安全库存时告警;\n· 工单超时(task_overdue):工单超过完成日期未完工时告警;\n· 缓存位满(cache_full):产线缓存/接驳台占满时告警;\n· 数量不符(qty_diff):工位收料实收≠应发时告警(MES 仅预警,明细由 WMS 处理);\n· 应急呼叫(emergency_call):工位终端现场发起的紧急呼叫。\n\n应急呼叫闭环:操作工在工位终端点「应急呼叫」(设备故障/质量异常/缺料/安全等紧急情形)→ 系统即时落一条 type=emergency_call 的未读预警并通过 SSE 推到大屏/看板 → 线长、维修、仓库等相关人员在本页看到未读告警并到场处置 → 处置完点「标记已读」闭环。\n\n处理流程:按 状态(全部/未读/已读)、预警类型、开始时间(默认当天)、结束时间(默认不限)筛选并分页浏览,核实后点行末「标记已读」;已读记录留存备查。',
'预警中心汇集全系统自动产生的异常/提醒消息,人工无需配置规则——全部由内置触发源自动落库并推送。顶部铃铛角标显示未读数,点击进入本页处理。\n\n八类内置触发源:\n· 扭紧不合格(torque_ng):拧紧扭矩/角度超考核标准时自动告警。触发点=拧紧枪完成拧紧后由工位终端自动上报拧紧结果时(拧紧采集落库后约15秒内自动上报;终端离线时缓存在终端、恢复后补报),不依赖操作工点「保存/完成报工」;\n· 检验不合格(inspection_ng):质量检验判定 NG 时告警;\n· 备料未齐套(material_shortage):工单装机绑定物料未齐套时告警;\n· 库存偏低(inventory_low):可用量低于安全库存时告警;\n· 工单超时(task_overdue):工单超过完成日期未完工时告警;\n· 缓存位满(cache_full):产线缓存/接驳台占满时告警;\n· 数量不符(qty_diff):工位收料实收≠应发时告警(MES 仅预警,明细由 WMS 处理);\n· 应急呼叫(emergency_call):工位终端现场发起的紧急呼叫。\n\n应急呼叫闭环:操作工在工位终端点「应急呼叫」(设备故障/质量异常/缺料/安全等紧急情形)→ 系统即时落一条 type=emergency_call 的未读预警并通过 SSE 推到大屏/看板 → 线长、维修、仓库等相关人员在本页看到未读告警并到场处置 → 处置完点「标记已读」闭环。\n\n处理流程:按 状态(全部/未读/已读)、预警类型、开始时间(默认当天)、结束时间(默认不限)筛选并分页浏览,核实后点行末「标记已读」;已读记录留存备查。\n\n拧紧不合格处置闭环(type=torque_ng):该预警出现即代表对应 SN 工件被标记「待人工处置」,此间该件后续报工与下线完工均被系统拦截(须先处置)。质检/班组长在工件追溯页或本页(torque_ng 项行末「确认放行」)填处置原因确认放行 → 清工件标记(恢复可报工/完工)、写操作日志(记录谁/何时/原因)、并将该 torque_ng 预警置为已读闭环。返修线下处理,系统不建返修工单。注意:重拧合格不会自动清标记,必须经「确认放行」人工处置。',
fields: [
{ name: '状态', source: '系统维护(未读/已读)。', purpose: '区分待处理与已处理预警', fill: '筛选项单选:全部/未读/已读' },
{ name: '预警类型', source: '内置触发源自动写入。', purpose: '只关注某一类异常', fill: '下拉选择八类之一,留空=全部' },
@@ -524,7 +510,8 @@ export const helpAlertCenter = {
{ name: '标题 / 内容', source: '触发时系统自动生成。', purpose: '说明预警的具体对象与原因', fill: '只读' },
{ name: '关联ID', source: '系统写入(工单号/SN/工位等业务键)。', purpose: '定位预警来源的具体业务对象', fill: '只读' },
{ name: '时间', source: '系统记录触发时刻。', purpose: '追溯预警发生时间', fill: '只读' },
{ name: '标记已读', source: '人工在本页操作。', purpose: '处置完成后闭环该预警', fill: '核对处置后点「标记已读」' }
{ name: '标记已读', source: '人工在本页操作。', purpose: '处置完成后闭环该预警', fill: '核对处置后点「标记已读」' },
{ name: '确认放行', source: '仅 torque_ng 项显示,人工质检/班组长操作。', purpose: '拧紧不合格人工处置:清工件标记+写日志+置预警已读', fill: '填处置原因点「确认放行」' }
]
}
@@ -579,14 +566,14 @@ export const helpProducible = {
export const helpPlcMesMismatch = {
title: 'PLC↔MES 对账(已知局限)',
overview:
'PLC↔MES 对账用于发现「PLC 托盘位说有件、但 MES 没有对应在制工件」的不一致(plc_mes_mismatch)。\n\n对账范围:G1~G10(M895.0~M896.1)+ C15(M898.0),共 11 个工位托盘位。不含主线缓存位、不含接驳台。\n\n对账规则:工位 PLC 托盘位=1 且 MES 中该工位无 status∈{ONLINE, PROCESSING} 的工件 且 工位非停用 且 不在「工序码下发后 15 秒」宽限窗口 → 判为不一致。\n\n触发:终端开始作业/扫SN/建档提交(弹终端两项选择:新件建档 / 绑定已知件)、报工提交(命中则阻断报工)、PLC 通讯恢复/管理员手动核对(落预警中心,全量 11 位)。均为事件驱动,无定时轮询。',
'PLC↔MES 对账用于发现「PLC 托盘位说有件、但 MES 没有对应在制工件」的不一致(plc_mes_mismatch)。\n\n对账范围:G1~G10(M895.0~M896.1)+ C15(M898.2),共 11 个工位托盘位。不含主线缓存位、不含接驳台。\n\n对账规则:工位 PLC 托盘位=1 且 MES 中该工位无 status∈{ONLINE, PROCESSING} 的工件 且 工位非停用 且 不在「工序码下发后 15 秒」宽限窗口 → 判为不一致。\n\n触发:终端开始作业/扫SN/建档提交(弹终端两项选择:新件建档 / 绑定已知件)、报工提交(命中则阻断报工)、PLC 通讯恢复/管理员手动核对(落预警中心,全量 11 位)。均为事件驱动,无定时轮询。',
sections: [
{
title: '已知局限(重要)',
fields: [
{ name: '流转途中会误报', source: 'MES 不知工件在工位间的流转过程。', purpose: '说明为何会出现"假不一致"', fill: '例如工件从 G5 发往 G7 途中,G7 的 PLC 托盘位尚未被 MES 感知,此时会误报 G7 不一致。属已知误报,待 PLC 路径指令下发能力做完(MES 能跟踪工件在途)后该误报消失。' },
{ name: 'PLC 真读已落地', source: '按 产线布局说明.md §4.1 点位表实现 S7 真读(G1~G10→M895.0~M896.1、C15→M898.0)。', purpose: '说明数据来源现状', fill: '真读已实现,mock 置位仅用于联调;不再依赖"点位表阻塞"。反向对账(MES 有记录 PLC 无托盘)暂不强制。' },
{ name: 'C15 工位号映射', source: 'PLC 地址 C15(M898.0,末端下料检测位)已按点位表映射为 MES 工位号 15。', purpose: '标注已确认项', fill: '工位 11/12(G11/G12)无独立托盘位信号,不纳入对账范围。' }
{ name: 'PLC 真读已落地', source: '按 产线布局说明.md §4.1 点位表实现 S7 真读(G1~G10→M895.0~M896.1、C15→M898.2)。', purpose: '说明数据来源现状', fill: '真读已实现,mock 置位仅用于联调;不再依赖"点位表阻塞"。反向对账(MES 有记录 PLC 无托盘)暂不强制。' },
{ name: 'C15 工位号映射', source: 'PLC 地址 C15(M898.2,末端下料检测位)已按点位表映射为 MES 工位号 15。', purpose: '标注已确认项', fill: '工位 11/12(G11/G12)已有独立托盘位信号(M896.2/M896.3),本轮不纳入对账范围(无终端处置),后续可选。' }
]
}
]