feat: 移除工位模板、AGV 链路增强与产品BOM/混产模板完善

- 移除工位模板体系(handler/logic 全删),同步路由与 seed
- AGV 链路增强:点位锁、车辆状态、退料派车调整,新增海康 RCS Postman 调试集合
- MES 产品BOM/混产模板完善:新增 ProductBOMDialog 组件,调整 handler/logic;日排产达成对比调整
- WMS 业务完善:出入库、检验、备料、退料、成品入库、缺料代报等 handler 与前端页面调整
- 前端通用:双端新增 RemotePageSelect 组件,统一 nextStep 规则/帮助文档/布局/请求拦截
- 文档:更新产线API/案例/部署手册/问题记录等
This commit is contained in:
SunYF
2026-11-18 09:53:42 +08:00
parent 5c9a7e32d2
commit f8482b18f6
122 changed files with 3381 additions and 2004 deletions
+246
View File
@@ -0,0 +1,246 @@
{
"info": {
"name": "海康 AGV RCS-Lite 原接口(直连 192.168.22.13:8182)",
"description": "海康 RCS-Lite v1.5 原始 API 直连,不经过 MES。\n\n== 点位编号全部取自 MES 数据库种子数据(【AGV管理】接驳台状态/点位管理页同源) ==\n产线接驳台:DOCK01(工位1左)/ DOCK02(工位1右)/ DOCK03(工位2右)/ DOCK04(工位2左)/ DOCK05~DOCK20(工位3~10 左右)\n工位接驳台(GW 系列):GW1Z 工位1左 / GW1Y 工位1右 / GW2Z / GW2Y / … / GW10Z / GW10Y\n库房收货接驳台:JBT21\n虚拟点位:XW 线尾 / XT 线头 / KF1 库房 / A1~A4\n车辆位:AGV-CHARGE01 充电位 / AGV-WAIT01、AGV-WAIT02 待命位\n\n实测状态:JBT21、XW、XT 已在 MES 日志中下发成功(RCS 认);GW 系列、DOCK 系列以 RCS 后台实际配置为准,报「位置编号不存在」= RCS 后台还没配该点。\n\n== 三条硬规则(都踩过) ==\n1. 任务接口路径是小写 rcms:/rcms/services/rest/hikRpcService/...,大写 rCMS 会 404。\n2. reqCode 长度 ≤32 且每次唯一({{$guid}} 是 36 位会被拒:「reqCode输入的值长度不符合规范」),本集合统一用 PM{{$timestamp}}。\n3. 车辆状态走另一服务 /rcms-dps/rest/queryAgvStatus,mapShortName 必填 2 位地图简称:传空回「mapShortName必填项不能为空」,传错回「地图编号不存在」。已确认真实简称=AA(RCS 后台截图地码类型 + MES 日志实测 AA 通过地图校验)。缺 robotCount 会回「robots robotCount同时为空」,请求里已带 robotCount=-1。",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"variable": [
{ "key": "host", "value": "http://192.168.22.13:8182", "type": "string" },
{ "key": "mapShortName", "value": "AA", "type": "string" },
{ "key": "taskCode", "value": "", "type": "string" },
{ "key": "agvCode", "value": "9001", "type": "string" }
],
"item": [
{
"name": "1 派车 genAgvSchedulingTask",
"item": [
{
"name": "1-1 C01 空车接货 → JBT21(单到达点,不举升)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMC01{{$timestamp}}\",\n \"reqTime\": \"\",\n \"taskTyp\": \"C01\",\n \"taskCode\": \"PMC01{{$timestamp}}\",\n \"priority\": \"1\",\n \"positionCodePath\": [\n { \"positionCode\": \"JBT21\", \"type\": \"00\" }\n ]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/genAgvSchedulingTask",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "genAgvSchedulingTask"]
},
"description": "C01 空车接货:只给到达点 JBT21(库房收货接驳台),不举升、不指定车,车到位停住等人选下一站。MES 日志实测下发成功过。"
}
},
{
"name": "1-2 B01 举升 JBT21 → GW1Z(两点)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMB01{{$timestamp}}\",\n \"reqTime\": \"\",\n \"taskTyp\": \"B01\",\n \"taskCode\": \"PMB01{{$timestamp}}\",\n \"priority\": \"1\",\n \"podCode\": \"\",\n \"positionCodePath\": [\n { \"positionCode\": \"JBT21\", \"type\": \"00\" },\n { \"positionCode\": \"GW1Z\", \"type\": \"00\" }\n ]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/genAgvSchedulingTask",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "genAgvSchedulingTask"]
},
"description": "B01 举升:起点 JBT21 + 终点 GW1Z(工位1左接驳台)。终点可换种子数据里任意点位:GW1Y~GW10Y/GW10Z、DOCK01~DOCK20。\n报「位置编号不存在」= RCS 后台没配该点,换 RCS 后台确认过的位置编号。\npodCode 填托盘/货架号,留空=RCS 自己找。真举升,先确认车上没货。"
}
},
{
"name": "1-3 B01 举升 + 指定车(agvCode 锁车)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMB01L{{$timestamp}}\",\n \"reqTime\": \"\",\n \"taskTyp\": \"B01\",\n \"taskCode\": \"PMB01L{{$timestamp}}\",\n \"priority\": \"1\",\n \"agvCode\": \"{{agvCode}}\",\n \"positionCodePath\": [\n { \"positionCode\": \"GW1Z\", \"type\": \"00\" },\n { \"positionCode\": \"GW2Z\", \"type\": \"00\" }\n ]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/genAgvSchedulingTask",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "genAgvSchedulingTask"]
},
"description": "带 agvCode 即指定车执行(人工派车链二段锁车就是这个字段)。车号从 queryAgvStatus 的 robotCode 拿。"
}
},
{
"name": "1-4 B02 移动 XW → XT(两点,不举升)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMB02{{$timestamp}}\",\n \"reqTime\": \"\",\n \"taskTyp\": \"B02\",\n \"taskCode\": \"PMB02{{$timestamp}}\",\n \"priority\": \"1\",\n \"positionCodePath\": [\n { \"positionCode\": \"XW\", \"type\": \"00\" },\n { \"positionCode\": \"XT\", \"type\": \"00\" }\n ]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/genAgvSchedulingTask",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "genAgvSchedulingTask"]
},
"description": "B02 移动:XW 线尾 → XT 线头(种子数据虚拟点位,实测下发成功过)。报 1006「站点集合传的数量不对」= B02 模板期望点位数与传的不一致。"
}
}
]
},
{
"name": "2 查询",
"item": [
{
"name": "2-1 查任务状态(按 taskCode)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMQ{{$timestamp}}\",\n \"reqTime\": \"\",\n \"agvCode\": \"\",\n \"taskCodes\": [\"{{taskCode}}\"]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/queryTaskStatus",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "queryTaskStatus"]
},
"description": "taskCodes 填派车时的 taskCode。taskStatus:1 已创建 / 2 正在执行 / 5 取消完成 / 9 已结束。\nagvCode 空不代表没派车(RCS-Lite 经常不回车号),车号看 queryAgvStatus。"
}
},
{
"name": "2-2 查任务状态(按 agvCode)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMQA{{$timestamp}}\",\n \"reqTime\": \"\",\n \"agvCode\": \"{{agvCode}}\"\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/queryTaskStatus",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "queryTaskStatus"]
},
"description": "agvCode 非空时按车查历史任务。"
}
},
{
"name": "2-3 查车辆状态 queryAgvStatus(rcms-dps,mapShortName 必填)",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMV{{$timestamp}}\",\n \"reqTime\": \"\",\n \"mapShortName\": \"{{mapShortName}}\",\n \"robotCount\": \"-1\"\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms-dps/rest/queryAgvStatus",
"host": ["{{host}}"],
"path": ["rcms-dps", "rest", "queryAgvStatus"]
},
"description": "路径 rcms-dps/rest。mapShortName 已确认=AA(2026-11-17 RCS 后台截图地码类型 + MES 日志实测:AA 通过地图校验、其余候选全回「地图编号不存在」)。缺 robotCount 回「robots robotCount同时为空」,已补 robotCount=-1 查全部。返回 code:0 且 data 有车即成功。"
}
}
]
},
{
"name": "3 任务控制",
"item": [
{
"name": "3-1 取消任务 cancelTask",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMX{{$timestamp}}\",\n \"reqTime\": \"\",\n \"taskCode\": \"{{taskCode}}\",\n \"forceCancel\": \"0\"\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/cancelTask",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "cancelTask"]
},
"description": "taskCode 与 agvCode 二选一,都传优先 agvCode。forceCancel:0=货架放地上;1=背着货架回库(仅潜伏车)。"
}
},
{
"name": "3-2 继续任务 continueTask",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMCT{{$timestamp}}\",\n \"reqTime\": \"\",\n \"taskCode\": \"{{taskCode}}\"\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/continueTask",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "continueTask"]
},
"description": "让暂停/停在半路的任务继续执行。"
}
},
{
"name": "3-3 释放 AGV freeRobot",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMF{{$timestamp}}\",\n \"reqTime\": \"\",\n \"robotCount\": \"1\",\n \"mapShortName\": \"{{mapShortName}}\",\n \"robots\": [\"{{agvCode}}\"]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/freeRobot",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "freeRobot"]
},
"description": "释放指定车。robotCount=-1 表示全部(此时 mapShortName 必填)。"
}
},
{
"name": "3-4 停止 AGV stopRobot",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMST{{$timestamp}}\",\n \"reqTime\": \"\",\n \"robotCount\": \"1\",\n \"mapCode\": \"{{mapShortName}}\",\n \"robots\": [\"{{agvCode}}\"]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/stopRobot",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "stopRobot"]
},
"description": "停止指定车或全部(robotCount=-1)。注意字段名是 mapCode。"
}
},
{
"name": "3-5 恢复 AGV resumeRobot",
"request": {
"method": "POST",
"header": [{ "key": "Content-Type", "value": "application/json;charset=UTF-8" }],
"body": {
"mode": "raw",
"raw": "{\n \"reqCode\": \"PMRS{{$timestamp}}\",\n \"reqTime\": \"\",\n \"robotCount\": \"1\",\n \"mapCode\": \"{{mapShortName}}\",\n \"robots\": [\"{{agvCode}}\"]\n}",
"options": { "raw": { "language": "json" } }
},
"url": {
"raw": "{{host}}/rcms/services/rest/hikRpcService/resumeRobot",
"host": ["{{host}}"],
"path": ["rcms", "services", "rest", "hikRpcService", "resumeRobot"]
},
"description": "恢复后继续执行未完成任务。"
}
}
]
}
]
}