feat: 重构 AGV 对接与在制品查询,新增 PLC 手动监控功能

This commit is contained in:
SunYF
2026-10-17 17:49:47 +08:00
parent f65a52d9e1
commit f743cf21fb
96 changed files with 6130 additions and 1781 deletions
+39 -11
View File
@@ -163,7 +163,7 @@ export const helpStation = {
{ name: '绑定工艺', source: '本页下拉选择「启用」的工艺即完成绑定。', purpose: '该工位执行的工艺(决定工艺步骤/考核标准/PDF/物料清单);一个工位只能绑定一个工艺', fill: '在本页下拉为该工位选择启用工艺;工单执行路线由工单工艺组合决定' },
{ name: '终端可见页签', source: '本页「页签」按钮配置(station.visibleTabs)。', purpose: '该工位终端允许显示哪些功能页签(上线建档/作业/物料/产线点位(上料/下料)/工艺文件/巡检/下线完工),按工位差异化界面', fill: '点「页签」勾选;全部不勾 = 显示全部页签,保存后终端下次拉取任务生效' },
{ name: '删除', source: '本页操作。', purpose: '删除自定义工位', fill: '仅自定义工位可删除;内置工位不允许删除' },
{ name: '虚拟工位 0 / 13', source: '系统预置虚拟工位(工位号 0、13)。', purpose: '原用作产线进线口/出料口的虚拟上下线位,现已废弃该特殊含义,降级为普通虚拟工位', fill: '只读;上线建档/下线完工不再绑定 0/13,改由工位终端「页签」配置(station.visibleTabs)决定哪些工位可显示该面板,任意授权工位均可操作' }
{ name: '虚拟工位', source: '工位维护页手动创建(类型选「线下位」)。原系统预置的 0/13 虚拟上下线位已废弃,不再预置。', purpose: '不连 PLC、仅记录上下线的辅助工位', fill: '只读;上线建档/下线完工改由工位终端「页签」配置(station.visibleTabs)决定哪些工位可显示该面板,任意授权工位均可操作' }
]
}
@@ -194,18 +194,32 @@ export const helpSettings = {
]
}
export const helpDock = {
title: '接驳台维护(只读主数据)',
export const helpLineManagement = {
title: '产线管理',
overview:
'接驳台是产线与库房之间供 AGV 取送货的物理停靠位,真源在 MES(2026-09-21 自 WMS 迁入)。共 21 个固定编码:DOCK01~DOCK20(产线,DOCKn↔工位n)+ DOCK21(库房收货)。\n\n接驳台为系统预置只读主数据,由种子初始化,本页不提供新增/修改/删除,仅供查看;工位维护、排产推荐、AGV 通讯均以本表为真源查询接驳台。\n\n「占用状态/托盘关联」反映该接驳台当前是否有托盘及托盘对应的出库/备料单,供现场调度参考。',
'产线管理页集中查看产线实时点位并维护接驳台、纠正工件位置,分四块:\n· ① 工位托盘位(G1~G12):PLC 实时读取工位是否有托盘。● 有托盘、○ 空。一次性读取、不轮询,需最新状态点「刷新」。\n· ② 主线缓存位(C1~C15):PLC 实时读取主线缓存位是否有托盘,展示口径同上。\n· ③ 接驳台维护:接驳台是产线与库房之间供 AGV 取送货的物理停靠位(真源在 MES),可新增/编辑/停用/启用/删除。「占用状态/托盘关联」由 PLC 传感器实时读取,不可人工维护。\n· ④ 工件位置纠正:核对「MES 记录的工件物理位置」与「PLC 实际托盘位」。MES 记录工件在工位 n、但 PLC 工位 n 无托盘 ⇒ 记录过期/错位,可一键纠正为「不在工位」,并写入操作日志(plc_position_correct)。\n· ④ 末端取件释放:G11/G12 下料检测位无 PLC 传感器,工件被取走后点位台账不会自动清。勾选占用记录 → 「确认已取件」→ 释放点位占用并写操作日志(point_release_manual)。列表含点位、工件SN、来源(所属工单)、占用时间。\n\n注:点位信号来自 PLC(产线布局说明 §4.1),与「PLC 手动监控」页同源;本页只做查看与维护,不做强制写。',
fields: [
{ name: '接驳台编码', source: '系统预置(种子)。', purpose: '接驳台唯一标识 DOCK01..21', fill: '只读' },
{ name: '接驳台名称', source: '系统预置。', purpose: '接驳台显示名称', fill: '只读' },
{ name: '类型', source: '系统预置。line=产线 / store=库房 / other=其他。', purpose: '区分接驳台所在位置', fill: '只读' },
{ name: '绑定工位', source: '系统预置(产线接驳台与工位 1:1)。', purpose: '该接驳台服务的产线工位号', fill: '只读;库房/其他接驳台不绑工位' },
{ name: '占用状态', source: 'PLC 托盘传感器 / AGV 到位卸货自动维护。', purpose: '当前是否有托盘', fill: '只读' },
{ name: '托盘关联', source: '有托盘时记录对应出库单号/备料单号。', purpose: '查这个托盘是哪批料、要送到哪', fill: '只读' },
{ name: '启用状态', source: '系统预置 ENABLED/DISABLED。', purpose: '停用后不在下拉出现', fill: '只读' }
{ name: '工位托盘位 G1~G12', source: 'PLC 传感器(§4.1,一次性读取)。', purpose: '工位当前是否有托盘', fill: '只读;点「刷新」更新' },
{ name: '主线缓存位 C1~C15', source: 'PLC 传感器(§4.1,一次性读取)。', purpose: '主线缓存位当前是否有托盘', fill: '只读;点「刷新」更新' },
{ name: '接驳台编码', source: '手工录入(2~16 位大写字母/数字,不可与现有编码重复)。', purpose: '接驳台唯一标识', fill: '新增/编辑时必填' },
{ name: '接驳台名称', source: '手工录入。', purpose: '接驳台显示名称', fill: '必填' },
{ name: '类型', source: '产线 / 库房 / 其他。', purpose: '区分接驳台所在位置', fill: '产线类型必须绑定工位 1~12' },
{ name: '绑定工位', source: '手工选择(1~12)。', purpose: '该接驳台服务的产线工位号', fill: '产线类型必填;库房/其他不绑工位' },
{ name: '启用状态', source: '启用 / 停用。', purpose: '停用后不出现在 AGV 派车等下拉中', fill: '行内「停用/启用」切换' },
{ name: '占用状态', source: 'PLC 托盘传感器。', purpose: '当前是否有托盘', fill: '只读,不可人工维护' },
{ name: '工件位置纠正', source: '系统按 MES 记录 vs PLC 实际自动列出。', purpose: '把记录过期/错位的工件位置清为「不在工位」', fill: '行内「纠正」,二次确认后生效并记日志' },
{ name: '末端取件释放', source: '点位台账中 G11/G12 的占用记录(SN / 来源工单 / 占用时间)。', purpose: '人工确认末端工件已取走,释放点位占用', fill: '勾选记录 →「确认已取件」二次确认;无「产线管理」权限不可操作' }
]
}
export const helpAgv = {
title: 'AGV 配送',
overview:
'AGV(海康 RCS-Lite V1.5)配送管理:库房出库后由 AGV 将物料托盘送到产线接驳台。AGV 任务与 RCS 客户端的唯一真源在 MES(2026-10-14 自 WMS 迁入),本页合并「状态查看」与「手动派车」。\n\n派车主链路:MES 叫料单 → 仓库在 WMS 完成备料(叫料单状态转「已发货」)→ MES 自动派车(系统按目标接驳台生成 AGV 任务并调海康 RCS-Lite)。「手动派车」页签仅用于补派、或对下发失败的任务重试。\n\n接驳台状态:有传感器,PLC 可反馈「是否有托盘」;AGV 到达目标口前系统可查询该口是否空闲,托盘未清走前不会再次下料到该口。\n\n说明:RCS-Lite 未对接时走模拟模式(mock)用于联调完整链路;现场配置 BaseURL(默认端口 8182)后自动切换真实调度,业务代码无需改动。',
fields: [
{ name: '接驳台状态', source: '系统维护。产线接驳台按工位绑定 + 库房接驳台。', purpose: '查看每个接驳台当前是否有托盘', fill: '绿色=空闲(无托盘);橙色=有托盘(占用中,AGV 到达前需确认空闲);已停用接驳台置灰' },
{ name: 'AGV任务', source: '系统生成。每次派车一个目标口生成一条任务。', purpose: '追踪每批料的搬运进度', fill: '状态:待下发 → 待搬运 → 搬运中 → 已到位;「刷新状态」拉取 RCS 最新状态;未终态任务可取消' },
{ name: '手动派车', source: '默认列「已发货」叫料单(仓库已完成备料)。', purpose: '补派或对失败任务重试', fill: '勾选行 → 行内可改目标接驳台 → 选源点 → 派车;按目标口分组生成任务,操作人为当前登录账号' }
]
}
@@ -563,6 +577,20 @@ export const helpProducible = {
]
}
export const helpPlcMonitor = {
title: 'PLC 手动监控',
overview:
'本页用于人工查看产线 PLC 点位状态、手动下发路径指令(写入 MW 寄存器)以及执行强制写入(危险操作)。\n\n页面分四块:\n· 点位状态:读取 §4.1 的 48 位点位信号——工位托盘位 G1~G12、主线缓存位 C1~C15、接驳台托盘位 DOCK01~DOCK20、库房接驳台。● 表示有托盘、○ 表示空。打开页面自动读一次,不轮询;需最新状态点「刷新」。\n· 动作类信号:读取 §4.4 路由表覆盖的 MW800~MW886 当前值;非 0 即在途指令,按「源×100+目标」反解为「源 → 目标」。\n· 手动下发:选「源」(工位 G1~G12 / 主线位 C1~C15)→ 目标下拉按源类型动态过滤 → 系统自动算出 MW 地址与写入值(值=源×100+目标)→ 点「下发」二次确认后即写入 PLC。\n· 可写操作(强制写入,危险):直接强制写单个 M 位或 MW 寄存器,仅在停机/调试时使用。\n\n互斥保护:手动下发前系统检查是否存在在途指令(工位组合下发尚未收到完成信号)——若有则拒绝并提示,以免打断自动线。可写操作(强制写入)不受此约束,因此必须单独勾选确认后才允许执行。\n\n所有手动下发动作记入操作日志(event_log,类型 plc_manual_write);所有强制写入动作记入操作日志(event_log,类型 plc_manual_force,含对象/写前值/写后值/操作人/确认时间),均可在「操作日志」页按类型筛选追溯。',
fields: [
{ name: '源', source: '下拉选择。工位 G1~G12 或 主线位 C1~C15。', purpose: '路径起点', fill: '选择后目标下拉按源类型动态过滤' },
{ name: '目标', source: '下拉选择(按源类型动态过滤,仅显示 §4.4 合法组合)。', purpose: '路径终点', fill: '选源后才有可选目标' },
{ name: '预览', source: '系统按 §4.4 路由表自动算出。', purpose: '展示 MW 地址与写入值(如 MW872 = 305(C3 → C5))', fill: '只读;组合非法时提示' },
{ name: '下发', source: '按钮(二次确认)。', purpose: '确认后写入 PLC MW 寄存器并记操作日志', fill: '存在在途指令时会被拒绝' },
{ name: '强制写 M 位', source: '危险操作。可选 M 字节(0~65535)与位(0~7)。', purpose: '停机/调试时直接置/清某个 M 位', fill: '未勾选「确认执行强制写」不得执行;M 位可能被 PLC 程序循环覆盖' },
{ name: '强制写 MW', source: '危险操作。白名单:MW800~886 + MW4096~4099。', purpose: '停机/调试时直接写 16 位寄存器', fill: '未勾选「确认执行强制写」不得执行;越界地址由后端拒绝' }
]
}
export const helpPlcMesMismatch = {
title: 'PLC↔MES 对账(已知局限)',
overview: