feat: AGV状态实时推送与受控异常处置 + rcs-dps状态接口独立配置与日志落盘修复

This commit is contained in:
SunYF
2026-11-16 19:42:22 +08:00
parent d92ca803d5
commit a998a0d0f7
18 changed files with 861 additions and 119 deletions
+204 -15
View File
@@ -6,7 +6,7 @@
// 界面不出现任何让用户选车号的下拉框/输入框;车号只作状态展示。
// 人工派车白名单硬拦:只允许库房接驳台 JBT21 与 7 个虚拟点位,GW* 工位接驳台一律不可选。
defineOptions({ name: 'AgvManual' })
import { computed, onMounted, reactive, ref } from 'vue'
import { computed, onMounted, onBeforeUnmount, reactive, ref } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import request from '../utils/request'
import { agvManualAllowed, agvTemplateOf } from '../utils/agvPoints'
@@ -18,7 +18,6 @@ const canManual = computed(() => can('produce.agv.manual'))
const points = ref([])
const chains = ref([])
const busy = ref(false)
const loading = ref(false)
const selected = ref('')
const activeChain = reactive({ chainNo: '', agvCode: '', current: '', segments: [], status: '' })
@@ -45,10 +44,47 @@ const statusText = computed(() => {
if (s === 'ARRIVED') return '已到位 · 可前往下一站'
if (s === '2') return '行驶中 · 请等待到位'
if (s === '1' || s === 'PENDING') return '已派车 · 等待系统分车'
if (s === 'FAILED') return '任务下发失败 · 需处置'
if (s === '9') return '本段已完成'
return '用车中'
})
// 未到位原因诊断:按当前段的真实状态给出准确原因 + 正确处置,绝不直接给强制结束按钮。
// 只有当用户判断现场实物已处理、系统状态卡死时,才引导到「用车状态」区的受控入口。
function notArrivedReason(s) {
if (s === '2') return {
why: '车辆正在前往目标点的途中(行驶中),尚未到达。',
what: '这是正常过程,请等待状态变为「已到位 · 可前往下一站」后再结束用车。状态自动更新,无需手动刷新。'
}
if (s === '1' || s === 'PENDING') return {
why: '任务已创建,海康调度系统尚未分配到具体车辆。',
what: '请稍等,状态变为「已到位」后再结束用车;如长时间(超过 1 分钟)无变化,检查与海康 RCS 的网络连接。'
}
if (s === 'FAILED') return {
why: '本段任务下发失败(断网期间下发或海康返回错误),车辆不会前往目标点。',
what: '请到「AGV任务」列表找到该车重试下发;若现场货物已由人工处理、不打算再派车,再使用「用车状态」区的异常处理入口。'
}
if (!s) return {
why: '系统与海康调度系统通讯中断,当前无法确认车辆真实状态。',
what: '请先确认本机网络已连通内网、海康 RCS 服务正常;状态恢复后再结束用车。'
}
return {
why: `当前段状态为 ${s},系统判定车辆未到位。`,
what: '请到现场确认车辆与货物实际位置;确认实物已处理但系统卡死时,再使用「用车状态」区的异常处理入口。'
}
}
async function showNotArrivedDiagnosis() {
const d = notArrivedReason(activeChain.status)
try {
await ElMessageBox.alert(
`无法结束用车。\n\n【原因】${d.why}\n\n【怎么处理】${d.what}\n\n只有当你已在现场确认实物处理完毕、但系统状态仍卡住时,才需要到上方「用车状态」处点「异常处理」,且必须说明原因并二次确认。`,
'车辆尚未到位',
{ confirmButtonText: '我知道了', type: 'warning' }
)
} catch { /* ignore */ }
}
function pointLabel(code) {
if (!code) return '—'
const p = (points.value || []).find((x) => x.positionCode === code)
@@ -65,8 +101,65 @@ async function loadPoints() {
async function loadChains() {
try {
const d = await request.get('/agv/chain/list')
chains.value = d?.list || []
} catch { chains.value = [] }
applyChains(d?.list || [])
} catch { applyChains([]) }
}
// AGV 状态实时推送:WebSocket 长连接,后端拉到 RCS 状态变化即推;无需手动刷新。
// (沿用全局待办 WS 同一鉴权方式:token 走 query,后端 tokenx.Parse 自校验。)
let agvWs = null
let agvWsReconnectTimer = null
let agvWsRetry = 0
let agvWsAlive = true
function agvWsUrl() {
const token = localStorage.getItem('token') || ''
const proto = window.location.protocol === 'https:' ? 'wss' : 'ws'
return `${proto}://${window.location.host}/api/v1/agv/ws?token=${encodeURIComponent(token)}`
}
function connectAgvWs() {
if (!agvWsAlive || !localStorage.getItem('token')) return
let ws
try {
ws = new WebSocket(agvWsUrl())
} catch {
scheduleAgvWsReconnect()
return
}
agvWs = ws
ws.onopen = () => { agvWsRetry = 0 }
ws.onmessage = (ev) => {
try {
const msg = JSON.parse(ev.data)
if (msg && Array.isArray(msg.chains)) applyChains(msg.chains)
} catch { /* 忽略单条异常推送 */ }
}
ws.onclose = () => {
if (agvWs === ws) agvWs = null
if (agvWsAlive) scheduleAgvWsReconnect()
}
}
function scheduleAgvWsReconnect() {
if (agvWsReconnectTimer || !agvWsAlive) return
const delay = Math.min(30000, 2000 * Math.pow(2, agvWsRetry))
agvWsRetry = Math.min(agvWsRetry + 1, 5)
agvWsReconnectTimer = setTimeout(() => {
agvWsReconnectTimer = null
connectAgvWs()
}, delay)
}
function closeAgvWs() {
agvWsAlive = false
if (agvWsReconnectTimer) { clearTimeout(agvWsReconnectTimer); agvWsReconnectTimer = null }
if (agvWs) { try { agvWs.close() } catch { /* ignore */ } agvWs = null }
}
// 把链快照写进界面状态(WS 推送与 loadChains 共用)。
function applyChains(list) {
chains.value = list || []
const c = (chains.value || []).find((x) => x.active) || null
const last = c?.segments?.length ? c.segments[c.segments.length - 1] : null
Object.assign(activeChain, {
@@ -78,14 +171,8 @@ async function loadChains() {
})
}
async function refresh() {
loading.value = true
try { await request.post('/agv/refresh', {}) } catch { /* 请求层已提示 */ }
await Promise.all([loadChains(), loadPoints()])
loading.value = false
}
// 刷新 RCS 状态并回写车号:开始用车后、每次前往下一站前由系统自动做,用户无需手动刷新
// 下发后立即主动拉一次 RCS 拿车号(程序触发,非界面手动刷新按钮):
// 车号由 RCS 分配、需一次 queryTaskStatus 回写;后续到位/失败由 WS 自动推送,无需用户点刷新。
async function syncCar() {
try { await request.post('/agv/refresh', {}) } catch { /* 请求层已提示 */ }
await loadChains()
@@ -156,13 +243,70 @@ async function endUse() {
selected.value = ''
Object.assign(activeChain, { chainNo: '', agvCode: '', current: '', segments: [], status: '' })
await loadChains()
} catch (e) {
const msg = e?.message || e?.response?.data?.message || String(e)
// 未到位:只诊断说清原因与正确处置,绝不在这里直接诱导强制结束。
// 强制结束是受控入口(见用车状态区),需主动进入+选原因+二次确认。
if (msg.includes('尚未到位')) {
await showNotArrivedDiagnosis()
}
} finally {
busy.value = false
}
}
// ===== 异常处置(受控入口,故意不顺手)=====
// 只在「用车状态」区显示一个小链接,需主动点进;进入后必须①读危险说明②选原因③勾选现场已确认,
// 三步齐全才允许二次确认。目的:杜绝"报错→顺手点强制结束"的诱导操作。
const forceDialog = ref(false)
const forceReason = ref('')
const forceAck = ref(false)
const forceReasons = [
{ value: 'unloaded', label: '货物已人工卸下,车辆已停稳在安全位置' },
{ value: 'dispatch_failed', label: '任务下发失败,车辆未载货、停在原地' },
{ value: 'network_lost', label: '断网期间实物已由现场人员处理完毕' },
{ value: 'other', label: '其它(已在备注/工单中说明现场处置情况)' }
]
function openForceDialog() {
if (!canManual.value) { ElMessage.error('没有人工派车的操作权限'); return }
if (!activeChain.chainNo) { ElMessage.warning('当前没有进行中的用车任务'); return }
forceReason.value = ''
forceAck.value = false
forceDialog.value = true
}
async function submitForceEnd() {
if (!forceReason.value) { ElMessage.warning('请先选择现场处置情况'); return }
if (!forceAck.value) { ElMessage.warning('请先确认现场实物已处理'); return }
// 二次确认:把所选原因回填,让人再核实一次自己刚才的判断。
const chosen = forceReasons.find((r) => r.value === forceReason.value)?.label || forceReason.value
try {
await ElMessageBox.confirm(
`即将解除系统死锁。你选择的处置情况是:\n「${chosen}」\n\n此操作只清除系统内的任务状态、释放点位锁;不会通知海康、不会让车辆移动。请再次确认现场货物已卸、车辆已停稳,否则后续派车可能撞车或压货。`,
'第二次确认 · 异常处置',
{ confirmButtonText: '确认,解除系统状态', cancelButtonText: '再想想', type: 'error' }
)
} catch { return }
busy.value = true
try {
await request.post('/agv/chain/force-end', { chainNo: activeChain.chainNo, reason: chosen })
ElMessage.success('系统任务状态已解除。请继续到现场核实实物状态。')
forceDialog.value = false
selected.value = ''
Object.assign(activeChain, { chainNo: '', agvCode: '', current: '', segments: [], status: '' })
await loadChains()
} catch { /* 请求层已提示 */ }
finally { busy.value = false }
}
onMounted(async () => {
await Promise.all([loadPoints(), loadChains()])
connectAgvWs()
})
onBeforeUnmount(() => {
closeAgvWs()
})
</script>
@@ -181,12 +325,16 @@ onMounted(async () => {
<div class="status-item">
<span class="status-label">用车状态</span>
<b class="status-value" :class="activeChain.chainNo ? 'running' : ''">{{ statusText }}</b>
<!-- 异常处置:受控入口,故意做成低调小链接,只有主动点进来才能走强制结束 -->
<button v-if="canManual && activeChain.chainNo" type="button" class="force-entry" @click="openForceDialog">
车辆卡死?异常处理
</button>
</div>
<el-button class="refresh-btn" size="large" :loading="loading" @click="refresh">刷新状态</el-button>
<span class="live-tag">状态自动更新</span>
</div>
<el-alert type="info" :closable="false" class="hint-bar"
title="开始用车:选一个点位点「开始用车」,系统自动分配一辆车。前往下一站:再选点位,全程固定用这一辆。结束用车:点「结束用车」释放车辆。全程不需要你选车号,工位接驳台不可选。" />
title="开始用车:选一个点位点「开始用车」,系统自动分配一辆车。前往下一站:再选点位,全程固定用这一辆。结束用车:点「结束用车」释放车辆。全程不需要你选车号,工位接驳台不可选。车辆到位/失败会自动更新,无需手动刷新。" />
<!-- 点位地图:大图标、大字体,触摸友好;工位接驳台不出现 -->
<div class="section-title">选择目的地</div>
@@ -228,6 +376,35 @@ onMounted(async () => {
<el-alert type="warning" :closable="false" style="margin-top:20px"
title="说明:开始用车时不指定车号,由系统分配;中间每一站都固定沿用这一辆,直到点「结束用车」才释放。举升/放下动作由 RCS 模板 B01 内置,MES 不控制动作。工位接驳台由业务配送单自动下发,人工派车不可选。" />
<!-- 异常处置受控对话框:必须读危险说明 + 选原因 + 勾选现场已确认,才允许二次确认 -->
<el-dialog v-model="forceDialog" title="异常处置 · 解除系统死锁" width="560px" :close-on-click-modal="false">
<el-alert type="error" :closable="false" class="force-warn"
title="危险操作,请逐条确认后再继续" />
<div class="force-body">
<p class="force-impact">
此操作<strong>只清除系统内的任务状态、释放点位锁</strong>,让界面恢复可用;它<strong>不会通知海康 RCS、不会让车辆移动或回充</strong>,
车辆在物理上仍停在当前位置。若货物实际未卸下,后续派车可能撞车、压货或掉货,后果由现场处置决定。
</p>
<p class="force-impact">仅在<strong>现场实物已由人员处理完毕、但系统状态卡死</strong>时使用。正常未到位请点「返回」,等待车辆到位。</p>
<div class="force-step">① 请选择现场实际处置情况(必选)</div>
<el-radio-group v-model="forceReason" class="force-reasons">
<el-radio v-for="r in forceReasons" :key="r.value" :value="r.value" :label="r.value">{{ r.label }}</el-radio>
</el-radio-group>
<div class="force-step">② 现场实物确认(必勾)</div>
<el-checkbox v-model="forceAck">
我已到现场确认:货物已卸下、车辆已停稳,或车辆未载货停在原地,解除系统状态不会造成碰撞或货损。
</el-checkbox>
</div>
<template #footer>
<el-button @click="forceDialog = false">返回</el-button>
<el-button type="danger" :disabled="!forceReason || !forceAck" :loading="busy" @click="submitForceEnd">
下一步 · 二次确认
</el-button>
</template>
</el-dialog>
</div>
</template>
@@ -242,7 +419,19 @@ onMounted(async () => {
.status-value { font-size: 22px; line-height: 1.35; color: #303133; }
.status-value.unknown { color: #e6a23c; }
.status-value.running { color: #67c23a; }
.refresh-btn { margin-left: auto; font-size: 17px; }
.live-tag { margin-left: auto; font-size: 14px; color: #67c23a; }
/* 异常处置入口:低调,不诱导点击 */
.force-entry {
align-self: flex-start; margin-top: 4px; padding: 2px 0; border: none; background: none;
color: #909399; font-size: 13px; text-decoration: underline; cursor: pointer; font-family: inherit;
}
.force-entry:hover { color: #f56c6c; }
.force-warn { font-size: 15px; }
.force-body { padding: 6px 2px; }
.force-impact { font-size: 15px; line-height: 1.7; color: #606266; margin: 10px 0; }
.force-impact strong { color: #f56c6c; }
.force-step { font-size: 16px; font-weight: 700; color: #303133; margin: 18px 0 8px; }
.force-reasons { display: flex; flex-direction: column; gap: 6px; }
.hint-bar { font-size: 15px; margin-bottom: 16px; }
.section-title { font-size: 19px; font-weight: 700; margin: 16px 0 10px; }
.point-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(150px, 1fr)); gap: 14px; }