feat: AGV点位锁与缓存迁移 + 工位终端去离线队列 + WMS出入库增强

【MES】
- AGV点位/线路点位/AGV任务/工单 ent schema 重构(全量重生成 ent 代码)
- 新增派车锁 agv_point_lock.go:目标点位占用即拒车,JBT21 库房接驳台卸货后保持锁定待库管手动解锁
- 新增进程内 TTL 缓存 cache.go,由 Redis 看板缓存迁移至内存(singleflight 防击穿,去除外部依赖)
- AGV 三段链安全机制、车辆状态/接驳台左右互换、补料损耗闭环完善
- 来料检/工序卡/工单/质检/日排产/AGV 前端与帮助文档更新
- 新增 migrations/、sql/ 目录

【WMS】
- 出库、Excel 导出、物料、路由处理增强
- 配置与 DB 初始化调整;基础数据/成品入库/入库前端调整

【工位终端】
- 移除离线同步队列(syncer 包、sync.go、SyncQueueDialog.vue),改为实时直连上报 MES(断网即失败报错),以本人身份操作
- 本地 SQLite 仅保留操作日志 + 内置账号 + 登录态;保留空闲自动登出

【文档】
- 删除 AGV海康litev1.5.md;案例.md 更新
This commit is contained in:
SunYF
2026-11-07 15:06:00 +08:00
parent 1d1dc1bdd8
commit 5e2640c13a
118 changed files with 4040 additions and 3594 deletions
+18 -17
View File
@@ -5,14 +5,14 @@
export const helpProductType = {
title: '物料档案(档案维护)',
overview:
'物料档案 = 本页是 WMS「基础数据(物料主数据)」中"成品"物料类别在本系统的视图,与 WMS 指向同一份主数据(以 WMS 为准,实时拉取、不双录)。本页承载的是"要生产哪些成品",是整条产线的源头基础数据。\n\n物料类别来源(与 WMS 一致):原材料=进货来的(外购);半成品、成品=自己生产的;其他=辅料/工装/试验设备等。成品还可以作为零部件,放进另一个成品的物料清单里被再次加工成新的成品。\n\n主数据链条:物料档案(成品) → 工单(选成品+物料清单) → 物料清单(给该产品序号配料) → 日排产 → 备料单 → 库房出库 → 产线生产 → 完工成品自动回流 WMS 入库。\n\n关系说明(几对几):\n· 成品 ↔ 工单:1 对 N。一个成品可以建多个工单(同一型号今天做一批、明天做一批,产品工号不同、产品序号相同)。\n· 成品 ↔ 物料清单:1 对多(选用制)。同一成品可并存多份物料清单(不同厂家供货/含半成品结构),用「物料清单名称」区分,工单建单时选定一份,备料/装机都按工单锁定的那份算。\n· 成品 ↔ 备料单:间接。备料单由「日排产 × 工单锁定的物料清单」算出,与成品无直接约束。\n· 强约束:工单/物料清单都挂在产品序号下,成品编码变了,下游关联会断,建议建好后不要改。\n· 与 WMS 的关系:两套系统解耦。物料/图号主数据以 WMS 为单一来源,MES 实时拉取(WMS 不可达时降级为本地只读缓存);成品完工后由系统自动生成 SN 回流 WMS 入库,无需人工对账。\n\n批量建档(Excel 导入):列表工具栏提供「模板下载」与「Excel 导入」——先下载模板(列:图号/名称/规格/单位/说明/类型/序列号/启用),按行填好后上传;系统逐行校验、逐行导入,完成后提示成功与失败行数,并列出失败原因(如编码重复、必填缺失),修正后可重新上传。',
'物料档案 = 本页是 WMS「基础数据(物料主数据)」中"成品"物料类别在本系统的视图,与 WMS 两库对等双向同步(按物料编码幂等互推,任一侧修改自动互推;库存真源在 WMS,备料校验直查 WMS)。本页承载的是"要生产哪些成品",是整条产线的源头基础数据。\n\n物料类别来源(与 WMS 一致):原材料=进货来的(外购);半成品、成品=自己生产的;其他=辅料/工装/试验设备等。成品还可以作为零部件,放进另一个成品的物料清单里被再次加工成新的成品。\n\n主数据链条:物料档案(成品) → 工单(选成品+物料清单) → 物料清单(给该图号配料) → 日排产 → 备料单 → 库房出库 → 产线生产 → 完工成品自动回流 WMS 入库。\n\n关系说明(几对几):\n· 成品 ↔ 工单:1 对 N。一个成品可以建多个工单(同一型号今天做一批、明天做一批,产品工号不同、图号相同)。\n· 成品 ↔ 物料清单:1 对多(选用制)。同一成品可并存多份物料清单(不同厂家供货/含半成品结构),用「物料清单名称」区分,工单建单时选定一份,备料/装机都按工单锁定的那份算。\n· 成品 ↔ 备料单:间接。备料单由「日排产 × 工单锁定的物料清单」算出,与成品无直接约束。\n· 强约束:工单/物料清单都挂在图号下,成品编码变了,下游关联会断,建议建好后不要改。\n· 与 WMS 的关系:两库对等双向同步(按物料编码幂等互推,任一侧新增/修改自动互推,失败置同步标记可手动重推);MES 持本地副本,冷启动全量拉取兜底;库存真源在 WMS,备料校验直查 WMS。成品完工后由系统自动生成 SN 回流 WMS 入库,无需人工对账。\n\n批量建档(Excel 导入):列表工具栏提供「模板下载」与「Excel 导入」——先下载模板(列:图号/名称/规格/单位/说明/类型/序列号/启用),按行填好后上传;系统逐行校验、逐行导入,完成后提示成功与失败行数,并列出失败原因(如编码重复、必填缺失),修正后可重新上传。',
fields: [
{ name: '名称', source: '手工填写(必填)。用户自定义,无上游来源。', purpose: '成品的中文名,用于识别与下拉展示', fill: '如:智能电表、断路器、配电柜' },
{
name: '编码',
source: '系统自动生成 + 可手动修改。新建时会自动带出(格式 PROD-YYYYMMDD-序号),你可直接使用或改为自定义编码;编辑时保留已存值。一个产品序号可对应多个工单(同一型号今天做一批、明天做一批,产品工号不同,产品序号相同)。',
source: '系统自动生成 + 可手动修改。新建时会自动带出(格式 PROD-YYYYMMDD-序号),你可直接使用或改为自定义编码;编辑时保留已存值。一个图号可对应多个工单(同一型号今天做一批、明天做一批,产品工号不同,图号相同)。',
purpose: '产品唯一编码。它是 MES 内部识别该产品的标识,决定该产品的物料清单内容,也是工单、备料、拧紧、追溯的挂靠键。',
fill: '建议用有意义的编码,如 METER-01。要点:①两库对等(2026-09-29):本页读写 MES 本地物料副本并自动同步 WMS,WMS 宕机时新建/查询照常可用,推送失败自动重推;②建档必选「类型」(结构件/电气件/其他)与「序列号」(序列号=是(逐件录SN)/ 序列号=否(按批次数量),选类型自动带默认可改);③成品完工回流 WMS 入库:序列号=是以扫入的来料SN入账、序列号=否由系统发号,无需人工对账;④如产品序号就是成品编码,则直接沿用该编码即可;⑤建好后不要随意改,否则下游工单/追溯的关联会断。'
fill: '建议用有意义的编码,如 METER-01。要点:①两库对等(2026-09-29):本页读写 MES 本地物料副本并自动同步 WMS,WMS 宕机时新建/查询照常可用,推送失败自动重推;②建档必选「类型」(结构件/电气件/其他)与「序列号」(序列号=是(逐件录SN)/ 序列号=否(按批次数量),选类型自动带默认可改);③成品完工回流 WMS 入库:序列号=是以扫入的来料SN入账、序列号=否由系统发号,无需人工对账;④如图号就是成品编码,则直接沿用该编码即可;⑤建好后不要随意改,否则下游工单/追溯的关联会断。'
},
{ name: '规格', source: '手工填写(必填)。与 WMS 物料档案必填口径一致。', purpose: '成品的规格型号,用于识别与打印', fill: '如:500×300×200' },
{ name: '单位', source: '手工填写(必填)。与 WMS 物料档案必填口径一致。', purpose: '计量单位', fill: '如:台 / 套' },
@@ -28,18 +28,17 @@ export const helpProductType = {
export const helpWorkOrder = {
title: '工单管理(新建 / 编辑 / 删除工单)',
overview:
'工单 = 一个"生产批次"的唯一载体,是生产执行和仓库出库挂靠的核心对象。\n\n全流程:先有产品型号(在「物料档案」里建档) → 建工单(选产品型号、定数量、勾选工艺组合) → 进"工艺"给工艺维护工艺步骤与物料清单 → 到"日排产"排哪天产多少 → 仓库按排产备料出库 → 产线装配/拧紧/报工 → 完工(成品 SN 系统自动生成,并自动回流 WMS 入库为"成品"物料类别)。\n产品工号会贯穿 备料单、工件追溯、操作日志 全链路。\n\n客户编号体系(三级归属):一级=合同号/科技项目号(二选一,即「归属类型+归属编号」)→ 二级=产品工号(原工单号,一个产品工号对应一个新建工单/一批)→ 三级=产品序号(工单内每台)。产品编码=图号(与产品型号编码同值,随型号自动带出)。原「工程编号」已被合同号顶替,页面不再展示/录入/查询。\n\n查询:支持按 产品工号 / 图号 / 产品名称(模糊) / 归属类型 / 归属编号 / 状态 组合筛选;操作列「详情」可查看工单字段汇总、工艺路线(按工位号升序去重展示各道工艺与步骤)与该工单的工件SN列表(产品序号/SN/类型/状态/当前工位);删除:仅「已创建」且无排产、备料、生产数据的工单可删除,生产中或已完成的工单不可删除。',
'工单 = 一个"生产批次"的唯一载体,是生产执行和仓库出库挂靠的核心对象。\n\n全流程:先有产品型号(在「物料档案」里建档) → 建工单(选产品型号、定数量、勾选工艺组合) → 进"工艺"给工艺维护工艺步骤与物料清单 → 到"日排产"排哪天产多少 → 仓库按排产备料出库 → 产线装配/拧紧/报工 → 完工(成品 SN 系统自动生成,并自动回流 WMS 入库为"成品"物料类别)。\n产品工号会贯穿 备料单、工件追溯、操作日志 全链路。\n\n客户编号体系(三级归属):一级=合同号/科技项目号(二选一,即「归属类型+归属编号」)→ 二级=产品工号(原工单号,一个产品工号对应一个新建工单/一批)→ 三级=SN(每台工件的序列号,工件建档时生成、落在工件上,不是工单级字段——工单级「产品序号」字段已于 2026-11-06 删除)。产品编码=图号(与产品型号编码同值,随型号自动带出)。原「工程编号」已被合同号顶替,页面不再展示/录入/查询。\n\n查询:支持按 产品工号 / 图号 / 产品名称(模糊) / 归属类型 / 归属编号 / 状态 组合筛选;操作列「详情」可查看工单字段汇总、工艺路线(按工位号升序去重展示各道工艺与步骤)与该工单的工件SN列表(产品序号/SN/类型/状态/当前工位);删除:仅「已创建」且无排产、备料、生产数据的工单可删除,生产中或已完成的工单不可删除;删除不可恢复。',
sections: [
{
title: '工单基本信息',
fields: [
{ name: '产品工号', source: '系统自动生成(WO+时间戳),可手工改。新建时自动带出。', purpose: '唯一标识一批生产(原"工单号"),备料/出库/报工/追溯都挂在此号下', fill: '一般不用改;如改动须保证唯一' },
{ name: '产品型号', source: '下拉选择。数据来自「物料档案」页面已启用的记录。', purpose: '说明这批生产的是什么产品,并决定物料清单内容', fill: '先到「物料档案」页面建好记录再选择' },
{ 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: '系统按工艺顺序自动推荐工位(第1道取候选最小工位,第N道取大于上一道已选且候选最小的工位);可逐道修改,下拉只列合法候选(第N道候选=绑定该工序且工位号>第N-1道已选);工位号须按工序顺序严格递增' },
{ name: '状态', source: '新建时选"已创建",后续由流程推进。', purpose: '工单生命周期:创建→发布→生产→完成', fill: '新建时选"已创建";也可在列表操作列点「状态」快捷流转(发布/开工/完工)' },
@@ -50,9 +49,9 @@ export const helpWorkOrder = {
},
{
title: '工单详情',
overview: '列表操作列「详情」打开只读抽屉:上半部分为工单字段汇总(产品工号/图号/名称/归属/数量/状态/日期),下半部分为该工单的工件SN列表。\n工件SN列表数据来源=工件进线登记记录:支持按状态筛选与分页(默认每页 100 条,后端分页),按产品序号升序(小号在前);产品序号取 SN 末段序号,SN 为工件唯一序列号,类型(序列号=是/序列号=否)取自图号对应物料档案的「序列号」设置,状态与当前工位为实时生产进度。',
overview: '列表操作列「详情」打开只读抽屉:上半部分为工单字段汇总(产品工号/图号/名称/归属/数量/状态/日期),下半部分为该工单的工件SN列表。\n工件SN列表数据来源=工件进线登记记录:支持按状态筛选与分页(默认每页 100 条,后端分页),按SN升序(小号在前);「SN末段」列取 SN 末段序号,SN 为工件唯一序列号(产品序号=SN,每台工件的序号、不是工单级字段),类型(序列号=是/序列号=否)取自图号对应物料档案的「序列号」设置,状态与当前工位为实时生产进度。',
fields: [
{ name: '工件SN列表', source: '工件查询接口按产品工号过滤,后端 SQL 分页(默认 100/页,可切 100/200/500)+ 状态筛选,按 SN 升序(产品序号小号在前),实时读取。', purpose: '核对该批每台产品的 序号、SN、类型、状态与当前工位', fill: '只读;可用状态下拉筛选,翻页查看' }
{ name: '工件SN列表', source: '工件查询接口按产品工号过滤,后端 SQL 分页(默认 100/页,可切 100/200/500)+ 状态筛选,按 SN 升序(小号在前),实时读取。', purpose: '核对该批每台工件的 SN、SN末段、类型、状态与当前工位', fill: '只读;可用状态下拉筛选,翻页查看' }
]
},
{
@@ -134,7 +133,7 @@ export const helpQtyReport = {
fields: [
{ name: '补发', source: '人工在本页操作。', purpose: '少发时补齐差额(生成工位补料单)', fill: '点「补发」→ 确认' },
{ name: '退库', source: '人工在本页操作。', purpose: '多发/错发时退回仓库(生成退库单)', fill: '点「退库」→ 确认' },
{ name: '调整', source: '人工在本页操作(需填处理说明)。', purpose: '少量差异双方确认后关闭', fill: '点「调整」→ 填说明 → 确认' }
{ name: '调整', source: '人工在本页操作(需填处理说明)。', purpose: '少量差异双方确认后关闭', fill: '点「调整」→ 填说明 → 确认。注意:调整即终局——差异关闭后不再补发也不退库,且不可撤销;拿不准走补发/退库' }
]
}
]
@@ -168,7 +167,7 @@ export const helpStation = {
{ name: '接驳台编码', source: '系统预置(种子初始化),与工位 1:1。', purpose: '该工位绑定的接驳台唯一标识', fill: '只读;由种子初始化,页面不可更改' },
{ name: '绑定工艺', source: '本页下拉选择「启用」的工艺即完成绑定。', purpose: '该工位执行的工艺(决定工艺步骤/考核标准/PDF/物料清单);一个工位只能绑定一个工艺', fill: '在本页下拉为该工位选择启用工艺;工单执行路线由工单工艺组合决定' },
{ name: '终端可见页签', source: '本页「页签」按钮配置(station.visibleTabs)。', purpose: '该工位终端允许显示哪些功能页签(上线建档/作业/物料/产线点位(上料/下料)/工艺文件/巡检/下线完工),按工位差异化界面', fill: '点「页签」勾选;全部不勾 = 显示全部页签,保存后终端下次拉取任务生效' },
{ name: '删除', source: '本页操作。', purpose: '删除自定义工位', fill: '仅自定义工位可删除;内置工位不允许删除' },
{ name: '删除', source: '本页操作。', purpose: '删除自定义工位', fill: '仅自定义工位可删除;内置工位不允许删除。注意:删除即退出工单工艺组合候选与终端工位下拉,历史报工记录保留但该工位不再可选;删除前确认无工单工艺组合引用' },
{ name: '虚拟工位', source: '工位维护页手动创建(类型选「线下位」)。原系统预置的 0/13 虚拟上下线位已废弃,不再预置。', purpose: '不连 PLC、仅记录上下线的辅助工位', fill: '只读;上线建档/下线完工改由工位终端「页签」配置(station.visibleTabs)决定哪些工位可显示该面板,任意授权工位均可操作' }
]
}
@@ -212,7 +211,7 @@ export const helpSettings = {
overview:
'运行参数集中配置页,保存即生效(无需重启服务)。库存查询、缺料补货、可生产套数、排产支撑均为实时计算:库存实时来自 WMS,需求按「日排产 × 工单工艺组合」现场汇总,MES 不落库存/需求表,所以改配置立刻影响下一次计算。\n\n可配置项:\n· WMS 地址(IP:端口):保存后热切换,所有库存查询/扣账/台账同步即刻走新地址;「测试连通」只试测不保存,失败不影响当前配置。\n· 需求窗口天数:缺料补货/未来需求按日排产取未来 N 天(默认 5),WMS 备料四态「预警」数据源。\n· 外推均值窗口 / 外推封顶:排产支撑在排产日耗尽仍有余量时,按近 N 天平均日需求外推,封顶防死循环。\n· 事件日志保留天数:超过保留期的操作日志每小时自动清理,0=不清理。\n\n本机基础信息(只读):主机名/内网 IP、服务监听地址、数据库、当前生效 WMS 地址、Go 版本、启动时间。\n\n安全边界:JWT 密钥、WMS Token、数据库密码等敏感信息一律留在 etc/bj_power_mes-api.yaml,不进本页(不在库里明文存密)。',
fields: [
{ name: 'WMS 地址', source: '手工填写(sys_config: wms.base_url),留空=用 YAML 配置/默认 127.0.0.1:9091。', purpose: '库存查询/扣账/半成品流转/台账同步的 WMS 服务地址,保存即热切换', fill: '如 http://192.168.1.100:9091;先用「测试连通」验证再保存' },
{ name: 'WMS 地址', source: '手工填写(sys_config: wms.base_url),留空=用 YAML 配置/默认 127.0.0.1:9091。', purpose: '库存查询/扣账/半成品流转/台账同步的 WMS 服务地址,保存即热切换', fill: '如 http://192.168.1.100:9091;先用「测试连通」验证再保存。注意:地址填错并保存后,库存查询/备料/完工回流会立即失败(WMS 不可达时物料档案降级本地只读),把地址改回即可恢复,不丢数据' },
{ name: '需求窗口天数', source: '数字(sys_config: demand.days,默认 5)。', purpose: '缺料补货/未来需求 = 未来 N 天日排产 × 工单单台含损耗用量', fill: '1~60 天;改大可提前看到更远期备料需求' },
{ name: '外推均值窗口', source: '数字(sys_config: producible.extrap.window,默认 3)。', purpose: '排产支撑外推取最近 N 天平均日需求', fill: '1~30 天' },
{ name: '外推封顶', source: '数字(sys_config: producible.extrap.cap,默认 365)。', purpose: '排产支撑外推最多算 N 天,防死循环', fill: '30~3650 天' },
@@ -233,7 +232,7 @@ export const helpLineManagement = {
{ name: '绑定工位', source: '由接驳台编码派生(DOCKnn → 工位 (nn+1)/2),硬件级对应关系,不可编辑。', purpose: '该接驳台服务的产线工位号', fill: '产线类型自动展示;库房/其他不绑工位' },
{ name: '启用状态', source: '启用 / 停用。', purpose: '停用后不出现在 AGV 派车等下拉中', fill: '行内「停用/启用」切换' },
{ name: '占用状态', source: 'PLC 托盘传感器。', purpose: '当前是否有托盘', fill: '只读,不可人工维护' },
{ name: '工件位置纠正', source: '系统按 MES 记录 vs PLC 实际自动列出。', purpose: '把记录过期/错位的工件位置清为「不在工位」', fill: '行内「纠正」,二次确认后生效并记日志' },
{ name: '工件位置纠正', source: '系统按 MES 记录 vs PLC 实际自动列出。', purpose: '把记录过期/错位的工件位置清为「不在工位」', fill: '行内「纠正」,二次确认后生效并记日志。注意:纠正动作不可在本页撤销——误纠正(PLC 其实没读到)会把在制工件标成「不在工位」,需重新上线建档或人工核对后处理;纠正前先到「PLC管理」确认传感器读数正常' },
{ name: '末端取件释放', source: '点位台账中 G11/G12 的占用记录(SN / 来源工单 / 占用时间)。', purpose: '人工确认末端工件已取走,释放点位占用', fill: '勾选记录 →「确认已取件」二次确认;无「产线管理」权限不可操作' }
]
}
@@ -241,11 +240,13 @@ export const helpLineManagement = {
export const helpAgv = {
title: 'AGV 配送',
overview:
'AGV(海康 RCS-Lite V1.5)配送管理:库房出库后由 AGV 将物料托盘送到产线接驳台。AGV 任务与 RCS 客户端的唯一真源在 MES(2026-10-14 自 WMS 迁入),本页合并「接驳台状态」「车辆状态(只读)」「AGV任务」与「手动派车 / 自由调度」。\n\n【三层安全机制(2026-11-03 拍板)】\n· ① 业务自动触发(免弹窗):仓库完成备料→系统自动派空车去装货点;卸货放行后自动派空车回充电位——这两段无需人工点确认。\n· ② 装卸强制确认(到位待令):AGV 到达目标接驳台后状态变「到位待令」,必须人工在「AGV任务」页或 WMS「叫料队列」点「确认装车并送货 / 卸货完成并放行」才走下一段。\n· ③ 传感器自动放行 + 人工兜底:接驳台有 PLC 托盘传感器,AGV 送达后系统按「传感器检测到托盘」自动放行(货已卸到位即放行,无需点按钮);传感器故障时由人工点「卸货完成并放行 / 人工强制放行」兜底。\n· ④ 自由调度(单点步进):每次点「开始搬运」必须弹「请确保路径畅通无杂物」才出发;到位停住待令,再选下一段或回充电位。\n\n【车辆状态页签】纯只读展示车辆闲忙/充电/电量/位置(海康 3.1.7);调度完全交给 RCS,本系统不干预(AGV 自己判定优先级与闲忙)。\n\n接驳台状态:有传感器,PLC 可反馈「是否有托盘」;AGV 到达目标口前系统可查询该口是否空闲,托盘未清走前不会再次下料到该口。\n\n说明:RCS-Lite 未对接时走模拟模式(mock)用于联调完整链路;现场配置 BaseURL(默认端口 8182)后自动切换真实调度,业务代码无需改动。',
'AGV(海康 RCS-Lite V1.5)配送管理:库房出库后由 AGV 将物料托盘送到产线接驳台。AGV 任务与 RCS 客户端的唯一真源在 MES(2026-10-14 自 WMS 迁入),本页合并「接驳台状态」「车辆状态(只读)」「点位管理」「AGV任务」与「手动派车 / 自由调度 / 手动多段链」。\n\n【能做什么】查接驳台占用、查车辆闲忙/电量(只读)、刷新任务状态、手动派车补派、自由调度单点步进、把一台车连送多个节点(多段链:第一段不指定车由 RCS 自由派,之后锁同一台车连送,节点数不限,点「结束任务」收口)。\n\n【任务状态机】待下发 → 待搬运 → 搬运中 → 到位待令(ARRIVED) → 完成;到位待令是人工闸口:必须「确认装车并送货 / 卸货完成并放行」才走下一段(自由回充段 auto_end 除外)。\n\n【安全机制(按层)】\n· ① 业务自动触发(免弹窗):仓库完成备料→系统自动派空车去装货点;卸货放行后自动派空车回充电位——这两段无需人工点确认。\n· ② 装卸强制确认(到位待令):AGV 到达目标接驳台后必须人工确认才走下一段——接驳台上的托盘不一定属于本趟任务,可能属于其他工单、其他工位或上一趟遗留,传感器判断不了归属,人工确认是为了防错取。\n· ③ 传感器自动放行(双重确认,2026-11-06 加固):落点为产线接驳台的到位任务,刷新/回调时若该接驳台 PLC 传感器检测到托盘(货已卸到位)→ 自动卸货放行;但**送料(配送单驱动)任务还须关联配送单状态为「已送达」,两者都满足才放行;配送单未送达或 WMS 查询失败则不自动放行、转人工确认**(落预警 agv.auto_release_blocked 留痕)。托盘回收/自由调度无单据联动,仍按传感器判定;传感器故障时人工点「卸货完成并放行」兜底。\n· ④ 派车锁(点位占用锁):派车成功系统自动锁目标点位(锁定原因=任务号),任务终态自动释放;被锁点位再派车被拒「目标点位被占用,请稍后或联系库管」;库房接驳台 JBT21 的锁永不自动释放,只能库管在「点位管理」人工解锁。点位管理可人工锁定/解锁(留痕)。\n· ⑤ 强提标记:PLC/传感器离线时强提叫料,目标点位打「强提」风险标记并推预警;此后该点位派车必须勾选「强提风险已人工确认」二次确认才放行,派车成功自动清标。\n· ⑥ 防撞硬拒:AGV 载货且目标接驳台有托盘 → 硬拒;落点接驳台传感器检测到托盘 → 硬拒「存在碰撞风险」。\n· ⑦ RCS 幂等:派车以任务号作 RCS 请求号(reqCode),网络重试不会重复生成任务。\n\n【车辆状态页签】纯只读展示车辆闲忙/充电/电量/位置(海康 3.1.7);调度完全交给 RCS,本系统不干预。载货台账与 RCS 不一致时(RCS 上报载货而台账空载)以 RCS 为准回写并拒绝本次派车,需人工核实卸货。\n\n说明:RCS-Lite 未对接时走模拟模式(mock)用于联调完整链路;现场配置 BaseURL(默认端口 8182)后自动切换真实调度,业务代码无需改动。',
fields: [
{ name: '接驳台状态', source: '系统维护。产线接驳台按工位绑定 + 库房接驳台。', purpose: '查看每个接驳台当前是否有托盘', fill: '绿色=空闲(无托盘);橙色=有托盘(占用中,AGV 到达前需确认空闲);已停用接驳台置灰' },
{ name: 'AGV任务', source: '系统生成。每次派车一个目标口生成一条任务。', purpose: '追踪每批料的搬运进度', fill: '状态:待下发 → 待搬运 → 搬运中 → 已到位;「刷新状态」拉取 RCS 最新状态;未终态任务可取消' },
{ name: '手动派车', source: '默认列「已发货」叫料单(仓库已完成备料)。', purpose: '补派或对失败任务重试', fill: '勾选行 → 行内可改目标接驳台 → 选源点 → 派车;按目标口分组生成任务,操作人为当前登录账号' }
{ name: '点位管理(派车锁)', source: '派车成功系统自动锁目标点位(锁定原因=任务号),任务终态自动释放;JBT21 仅人工解锁。', purpose: '防止对同一接驳台重复派车撞车;强提标记点位派车需二次确认', fill: '列表「派车锁」列显示 锁定中/空闲 与锁定原因;行内「锁定/解锁」填原因留痕;「清强提」清除强提风险标记(现场确认安全后操作)' },
{ name: 'AGV任务', source: '系统生成。每次派车一个目标口生成一条任务。', purpose: '追踪每批料的搬运进度', fill: '状态:待下发 → 待搬运 → 搬运中 → 已到位/到位待令;「刷新状态」拉取 RCS 最新状态并驱动传感器自动放行(见上③);未终态任务可取消' },
{ name: '手动派车', source: '默认列「已发货」叫料单(仓库已完成备料)。', purpose: '补派或对失败任务重试', fill: '勾选行 → 行内可改目标接驳台 → 选源点 → 派车;目标点位被派车锁占用或带强提标记时会被拦截,按提示确认后放行;按目标口分组生成任务,操作人为当前登录账号' },
{ name: '多段链(下一个节点/结束任务)', source: '手动连送场景:第一段派车不指定车,之后每加一个节点锁定同一台车。', purpose: '一台车按人工指定的顺序连送多个点位', fill: '任务详情里点「下一个节点」选目标(可无限加段);全部送完点「结束任务」——结束前系统查 RCS 车辆状态,查询失败默认拒绝,可勾选「人工确认无托盘」强制结束(留痕)' }
]
}
@@ -334,7 +335,7 @@ export const helpProcessFlow = {
{ name: '操作工签字确认', source: '每个工艺步骤开关。开启后该步骤要求「操作工签字」。', purpose: '签字机制第一签:操作工报工前须在本步骤签字确认,否则报工被拦截', fill: '在步骤行打开开关;报工时工位终端弹「签字确认」采集签字人,签字记录按「操作工」身份留痕' },
{ name: '检验员签字确认', source: '每个工艺步骤开关。开启后该步骤要求「检验员签字」。', purpose: '签字机制第二签:该步骤须由检验员在巡检终端「待签任务」页签签字确认,流程方可放行', fill: '在步骤行打开开关;操作工签字后,检验员到【巡检终端-待签任务】逐行「签字确认」,签字记录按「检验员」身份留痕,需开通「巡检-签字确认」权限' },
{ name: '步骤附件/图纸', source: '每个工艺步骤单独上传(绑定式)。文件由 MES 服务器保存。', purpose: '把图纸精确绑定到具体步骤,工位终端按当前步骤自动展示对应图纸', fill: '在步骤行上传该步骤图纸/附件(可多个);随步骤自动分发到工位终端' },
{ name: '物料清单', source: '本页维护:物料编码(下拉选择,取自物料档案)/名称/规格/单位/序列号/单台用量/损耗率%,整表覆盖保存。', purpose: '该工艺装配所需物料;备料需求 = 各工位分产量 × 单台用量 × (1+损耗率%)', fill: '物料编码取自物料档案编码(结构件通常即图号),选中后名称/规格/单位/序列号自动带出、不可改;序列号来自物料档案:序列号=是(录SN)/序列号=否(不录SN)' }
{ name: '物料清单', source: '本页维护:物料编码(下拉选择,取自物料档案)/名称/规格/单位/序列号/单台用量/损耗率%,整表覆盖保存。', purpose: '该工艺装配所需物料;备料需求 = 各工位分产量 × 单台用量 × (1+损耗率%)', fill: '物料编码取自物料档案编码(结构件通常即图号),选中后名称/规格/单位/序列号自动带出、不可改;序列号来自物料档案:序列号=是(录SN)/序列号=否(不录SN)。注意:保存=整表覆盖,被删行不保留且不可恢复;已据旧清单备料/出库的工单不受追溯影响,但下次备料按新清单算' }
]
},
{
@@ -509,7 +510,7 @@ export const helpProductProcess = {
export const helpQuality = {
title: '质量检验(过程检 / 完工检)',
overview:
'质量检验 = 对物料/产品做检验判定并留痕,分「过程检」与「完工检」两个 Tab(本页仅只读查看,录入已收口至 PAD 巡检终端)。来料检在 WMS 库房侧完成,本页不重复。\n\n核心口径:完工确认=生产完成;完工检合格后成品自动入 WMS 库(已通过→合格,部分通过→合格,不合格→不入库待返修)。完工检页签顶部「待完工检成品」列出完工确认后尚未录完工检的成品 SN(产品工号/产品序号/SN/完工时间,只读分页),检验员逐台录入完工检即可。\n\n录入(已收口至 PAD 巡检终端):过程检/完工检的录入统一在 PAD 巡检终端完成——质检员在「巡检终端-完工检」页签从「待完工检成品」清单选 SN,填试验记录单号/相关标准并判定结论后保存,合格自动回流入 WMS 库(若该成品已在库 WMS 会防重拦截并提示「已入库勿重复」)。本页(质量检验)为只读追溯:仅可查询、查看已录记录、对不合格记录做处置、下载不合格单,不提供新增录入。\n\n不合格闭环:结论为「不合格」时可当场选择处置方式(退货/返修/退换)并写处置说明;也可在列表操作列「处置」补录,或点「不合格单」一键导出《不合格单.xlsx》(预填本次检验数据)。\n\n查询:图号 / 物料名称 / 报检单号 / 记录日期范围组合筛选,每个框内模糊匹配、多框取交集;记录按时间倒序,后端真分页。',
'质量检验 = 对物料/产品做检验判定并留痕,分「过程检」与「完工检」两个 Tab(本页仅只读查看,录入已收口至 PAD 巡检终端)。来料检在 WMS 库房侧完成,本页不重复。\n\n核心口径:完工确认=生产完成;完工检合格后成品自动入 WMS 库(已通过→合格,部分通过→合格,不合格→不入库待返修)。完工检页签顶部「待完工检成品」列出完工确认后尚未录完工检的成品 SN(产品工号/图号/SN/完工时间,只读分页),检验员逐台录入完工检即可。\n\n录入(已收口至 PAD 巡检终端):过程检/完工检的录入统一在 PAD 巡检终端完成——质检员在「巡检终端-完工检」页签从「待完工检成品」清单选 SN,填试验记录单号/相关标准并判定结论后保存,合格自动回流入 WMS 库(若该成品已在库 WMS 会防重拦截并提示「已入库勿重复」)。本页(质量检验)为只读追溯:仅可查询、查看已录记录、对不合格记录做处置、下载不合格单,不提供新增录入。\n\n不合格闭环:结论为「不合格」时可当场选择处置方式(退货/返修/退换)并写处置说明;也可在列表操作列「处置」补录,或点「不合格单」一键导出《不合格单.xlsx》(预填本次检验数据)。\n\n查询:图号 / 物料名称 / 报检单号 / 记录日期范围组合筛选,每个框内模糊匹配、多框取交集;记录按时间倒序,后端真分页。',
fields: [
{ name: '图号', source: '远程检索 WMS 物料档案(/materials 代理接口,WMS 是物料主数据源),也可手填。', purpose: '被检物料的图号(即 WMS 物料档案的图号)', fill: '输入图号或名称关键字选择' },
{ name: '物料名称', source: '选图号后自动带出,可手改。', purpose: '被检物料名称', fill: '一般无需手填' },