feat(mes): AGV挂起动作引擎 + 智能跟车流转 + PLC快照缓存(2026-11-19 主控拍板)

一、AGV 挂起动作引擎(弃显式任务队列、弃并发硬拒)
- 新增 internal/logic/agv_pending.go:待发动作直接挂任务(pending_action + pending_since),
  CONTINUE_LIFT(举升完成→continueTask#1)/ WAIT_DROP_CONFIRM(人工确认放下→continueTask#2)
  / FREE_ROBOT(末组完成→freeRobot);系统动作超 60s 未触发转预警人工重试,绝不自动重发
- Client 新增 ContinueTask(RCS 2.1.2) / FreeRobot(3.1.2),仅点名释放指定车,禁止释放全部
- agv_task 增 pending_action/pending_since 字段,ent 重生成 + db.go 幂等迁移补丁 + migrateonce
- 回调按 B01/B02/C01 模板编排:业务流转到位即自动放行放下、回调自动放车;
  仅人工派车(MANUAL)挂 WAIT_DROP_CONFIRM;新增 /agv/confirm-drop、/agv/pending/retry
- 前端 AgvManual/Agv 确认放下、挂起重试按钮与等待提示联动

二、智能跟车 + 动态目标截断流转引擎
- 新增 internal/logic/flow_engine.go:事件驱动(报工/扫码),读 48 位物理快照,从下游往上游算,
  前方占用则动态截断到最近空闲缓存位;IN_TRANSIT 在途闭锁防重复下发,MW=0 才确认到位落台账;
  主线占用=台账 OR 传感器,工位 G 位只认台账;在途超 5s 落预警
- workpiece 增 flow_transit_mw/target/at 字段,ent 重生成 + 迁移补丁

三、PLC 读取优化与诊断
- 新增 internal/plc/snapshot_cache.go:2s TTL + singleflight + 写失效,合并 SSE/PLC监控/流转引擎
  的重复点位读取;tcp.go 读块重构、localip.go 多网卡、plcdiag 诊断工具、plc_monitor/logging 配套

四、文档与前端
- help.js 重写「工位下发」帮助:明确报工自动驱动流转 vs 下发路线码的定位、缺料/握手/撤回边界
- 案例.md 补充定稿说明;public/index.html 构建指纹更新
This commit is contained in:
SunYF
2026-11-19 23:08:46 +08:00
parent 4c4cda1d41
commit 9aaa768e6c
40 changed files with 3037 additions and 364 deletions
+8 -4
View File
@@ -321,19 +321,23 @@ export const helpProducibleSupport = P('齐套测算', '只读测算,库存不
export const helpPlc = P('工位下发', '把某张工单要经过的工位组合写进产线设备;SENT 不是失败,是在等 PLC 回完成信号。', [
{ k: 'role', t: '这页解决什么', text: '工单定了路线之后,把这套组合码下发给 PLC,让设备和 MES 对同一条路线达成共识。下发记录留痕,便于对账。' },
{ k: 'why', t: '和日常报工是什么关系、为什么单独有这页', text: '要先分清两种指令:工件在产线上一段段往前走,靠的是工位终端每道报工后,系统自动算出下一站并把托盘流转过去——推动托盘的是报工后的自动流转,上线建档和本页下发都不会自己搬动托盘。本页下发的是另一种东西:把工单的工艺路线(这台件该经过哪几个工位)写成工位码写给设备,让设备和系统对同一条路线达成一致,并留一条记录用于对账。它做的是报工之外的两件事:① 把路线正式告知设备并留痕;② 下错了能撤回、设备完成信号丢了能人工收口。它不是「开线开关」,日常工作不需要每件都来这里点一遍。' },
{ k: 'complex', t: '它对正常业务的影响:只动设备路线和这条记录', text: '本页下发只做两件事——向设备写这套工位码、留一条下发记录。它不改工件状态、不扣库存、不生成报工实绩。让工单完工数加一、扣料、记质量账的,是工位终端的报工,不是这里。所以在本页下发不会让工单算完工,也不会产生库存或质量数据。' },
{ k: 'exception', t: '缺料(比如没胶料)还能下发吗,会怎样', text: '能。本页下发不检查物料齐不齐全——系统只认工单的工艺路线,不查装配物料。所以这台工件就算还缺料也能下发成功、也会走到工位。但到了工位终端报工那一步,齐套校验会拦下来:报工要求这台件在该工艺该装的料都绑齐(电气件按单台用量逐颗扫码,结构件至少一个批次号),缺料直接拒绝报工并列出缺哪些料。结果就是件停在工位上报不了工、下不去,还占着工位挡住后面的件。缺料时正确做法是先把料叫齐、在工位终端绑上,再报工;不要指望先下发「占位」。' },
{ k: 'exception', t: '工位终端没完工,在这里强行下发会怎样', text: '分两种情况。① 从本页正常下发:有握手保护——上一条下发还没收到设备完成信号(记录显示「已下发·等待完成信号」)时,会拒绝下发下一条,防止两件工件在产线上串序;只要前一件没真正走完,本页一般不会让你连发。② 从「PLC管理」页手动下发路径指令或强制清零在途指令:那是在设备层面直接写搬运指令或清标志,绕过了上面的握手保护。后果是设备物理位置和系统台账可能对不上——工件实际还在动、或被人工搬走,系统却以为那趟已完成。报工时会做设备与台账对账,一旦对不上就直接拒绝报工,要求先到「产线管理」处理托盘异常(新件建档或绑定已知件)。所以手动下发和清零只用于设备联调、确认卡死的处置,不是催单手段;真要放行前一件,用本页的「撤回」或「人工完成」,别去清零。' },
{ k: 'states', t: '下发状态', items: [
'SENT 已下发·等待完成信号 / DONE 已完成 / CANCELLED 已撤回 / TIMEOUT 超时 / REPLY_NG 回复异常。'
] },
{ k: 'flow', t: '第一次开线:让滚筒线转起来的顺序', items: [
{ k: 'flow', t: '从建产品到出第一件:各环节先后顺序', items: [
'① 产品与工艺 → 产品档案建档 → 产品工艺把总账物料分到各道工艺。',
'② 产品与工艺 → 工位管理 →「快捷绑定工艺」,确认清线五项后应用,工位才知道每道干什么。',
'③ 计划与排产 → 工单管理建工单 →「下发并开工」(工单变执行中,排产才能启用)。',
'④ 计划与排产 → 日排产排到具体日期并启用,工位终端才看得到这一天的活。',
'⑤ 本页「下发录入」选工单和产品序号(SN) →「下发工位码」,滚筒线据此只停靠对应工位——到这一步线才真正开始动。',
'⑥ 工位终端扫 SN 上线建档、各工位逐道报工,报完最后一道自动完工、工件流向下线位。'
'⑤ (可选)本页「下发录入」选工单和工件序号(SN) →「下发工位码」,把这台件的工位路线告知设备;不要求每件都下发,只有需要设备按指定路线停靠或做对账时才用。',
'⑥ 工位终端扫 SN 上线建档、各工位逐道报工——托盘的正向流转在这里由报工自动驱动,报完最后一道自动完工、流向下线位。'
] },
{ k: 'rule', t: '工单号怎么选', text: '工单号(工单号)是下拉选择,输入关键字就实时向后台模糊搜索(工单号 / 产品编码 / 产品名称 / 合同号任一命中),下拉往下滑到底自动加载下一页;不允许凭记忆手敲一个不存在的工单号。下拉不会一次性把全厂工单拉回来。' },
{ k: 'confuse', t: '等太久怎么办', text: '先确认现场实物到底走没走。确实没走就「撤回」,确实走了但信号没回来就「人工完成」收口。两个动作都会留痕,别互相代替。' },
{ k: 'correct', t: '能不能用它纠正正常业务的异常、人工干预让线继续走', text: '能,这是本页的主要用途之一,但要先看清它改的是什么。它纠正的是「下发给设备的路线码」这一层:① 下错了(选错工单/SN/工位)→ 用「撤回」把这条已下发指令作废,握手位释放后可以重新下发正确的;② 工件其实已经到位、但设备的完成信号没回来,卡在「已下发·等待完成信号」挡住下一条 → 现场确认实物确已到位后用「人工完成」收口,放行下一条下发。两个动作都只改本页的下发台账、留痕,不碰工件状态、不扣料、不产生报工实绩——工件该走哪道、走到哪,最终仍以工位终端报工和系统自动流转为准。它纠不了的是工件本身的问题:托盘物理卡住、位置错、缺料、漏报工,这些要到「PLC管理」处置在途指令、到工位终端补报工或「产线管理」纠正位置,反复在这里下发不会让卡住的工件自己走起来。' },
{ k: 'irreversible', t: '撤回不回滚报工', text: '撤回只撤这条下发指令,已经报工产生的实绩不会被抹掉。' }
], [
{ name: '工单管理', path: '/work-order' },
+33 -4
View File
@@ -103,6 +103,12 @@ const statusText = (s) => (statusOptions.find((x) => x.v === s) || {}).l || '—
const statusTag = (s) =>
s === '9' ? 'success' : s === 'ARRIVED' ? 'danger' : s === 'FAILED' || s === '5' ? 'info' : s === '2' ? 'warning' : s === '1' ? 'primary' : ''
const kindText = (k) => ({ GO_LOAD: '空车去程', TRANSPORT: '重载运输', EMPTY_RETURN: '空车回充', FREE: '自由调度', MANUAL: '手动节点' }[k] || '—')
// 挂起动作中文(2026-11-19 挂起动作引擎):任务上等待触发的待办动作
const pendingCn = (a) => ({
CONTINUE_LIFT: '等待举升完成',
WAIT_DROP_CONFIRM: '待确认放下',
FREE_ROBOT: '等待放车'
}[a] || '')
/* ===================== 到位待令确认 ===================== */
// 2026-11-17 用户裁决:车来工位与车离开是两步,工位 GO_LOAD 到位后必须人点「确认装车回库」
@@ -126,10 +132,11 @@ async function confirmLoadGo(row) {
async function confirmAgv(row, action, nextDock, confirmForcePick) {
if (!canAgv.value) { ElMessage.error('没有 AGV管理的操作权限'); return }
const tips = {
load_go: '确认已装车并送货?AGV 将背着托盘前往目标接驳台。',
load_go: '确认已装车并送货?AGV 将举起托盘前往目标接驳台。',
line_load_confirm: '确认工位已装车?AGV 将背着托盘离开工位返回库房 JBT21。请确认工件已放稳。',
unload_release: '确认卸货完成并放行?托盘将落位当前接驳台,海康任务结束,车辆由 RCS 自行处置。',
finish_return: '确认结束本任务?海康任务将被取消,车辆由 RCS 自行处置。'
// 2026-11-19 B01 段语义:确认=放行放下动作组(放下完成后车辆自动释放、托盘自动落位台账)
unload_release: '确认放行放下?AGV 将把托盘放下落位当前接驳台,放下完成后车辆自动释放。',
finish_return: '确认结束本任务?任务将完结,车辆释放。'
}
const isFree = action !== 'load_go' && action !== 'line_load_confirm' && action !== 'unload_release'
try {
@@ -158,6 +165,18 @@ async function loadTasks() {
loadingTasks.value = false
}
// 2026-11-19 挂起动作人工重试:/agv/pending/retry(后端按任务当前挂起重放 continueTask/freeRobot 一次)
async function retryPending(row) {
if (!canAgv.value) { ElMessage.error('没有 AGV管理的操作权限'); return }
try {
await request.post('/agv/pending/retry', { taskNo: row.taskNo })
ElMessage.success('已重试挂起动作,结果见任务状态')
loadTasks()
} catch (e) {
ElMessage.error('重试失败:' + (e?.message || e))
}
}
// AGV 状态实时推送(2026-11-16 主控包项10):删原「刷新状态」手动按钮,改 WebSocket 自动推送。
// 后端 AgvHub 每 3s 拉 RCS 写回本地库,任务/链快照变化即推整帧;本页消费 tasks 刷新任务列表与接驳台。
// (与人工派车页 AgvManual.vue 共用 /api/v1/agv/ws,token 走 query,后端 tokenx.Parse 自校验。)
@@ -539,9 +558,11 @@ function onTabChange(name) {
<el-table-column label="目标" width="80" align="center">
<template #default="{ row }">{{ pointLabel(row.targetDock) }}</template>
</el-table-column>
<el-table-column label="状态" width="100" align="center">
<el-table-column label="状态" width="120" align="center">
<template #default="{ row }">
<el-tag :type="statusTag(row.status)">{{ statusText(row.status) }}</el-tag>
<!-- 2026-11-19 挂起动作提示:等待举升/等待放下确认/等待放车 -->
<div v-if="pendingCn(row.pendingAction)" style="font-size:11px;color:#b8860b;line-height:1.4;margin-top:2px">{{ pendingCn(row.pendingAction) }}</div>
</template>
</el-table-column>
<el-table-column label="物料" min-width="220">
@@ -594,6 +615,14 @@ function onTabChange(name) {
<el-button size="small" type="danger" link>取消</el-button>
</template>
</el-popconfirm>
<!-- 2026-11-19 挂起动作人工重试(受控):挂起动作超时/RCS 报错清除后,人工核实现场再重放一次;
绝不自动重发——重发 continueTask 会重复触发动作组、重发 freeRobot 可能误放作业中的车 -->
<el-popconfirm v-if="canAgv && (row.pendingAction === 'CONTINUE_LIFT' || row.pendingAction === 'FREE_ROBOT')"
title="请先核实现场(举升/放下是否已完成),确认后重放该动作?" @confirm="retryPending(row)">
<template #reference>
<el-button size="small" type="warning" link>重试挂起动作</el-button>
</template>
</el-popconfirm>
<!-- 2026-11-17:删除「重试」按钮(历史遗留安全隐患);失败/挂起任务统一走取消清理本地,再到人工派车页重新派车 -->
<!-- 异常处置:仅 MANUAL 人工派车任务显示(后端 force-end 只支持 MANUAL 链);受控入口,不诱导 -->
<el-button v-if="canForceEnd(row)" size="small" type="danger" link @click="notArrivedDiagnosis(row)">异常处理</el-button>
+121 -29
View File
@@ -19,7 +19,7 @@ const points = ref([])
const chains = ref([])
const busy = ref(false)
const selected = ref('')
const activeChain = reactive({ chainNo: '', agvCode: '', current: '', segments: [], status: '', realtime: null })
const activeChain = reactive({ chainNo: '', agvCode: '', current: '', segments: [], status: '', pendingAction: '', templateType: '', realtime: null })
// 人工派车白名单(2026-11-14 用户终版):只允许库房接驳台 JBT21 与 7 个虚拟点位。
// 所有 GW* 工位接驳台、DOCK* 历史业务点位、AGV-WAIT*/AGV-CHARGE* 待命充电位一律不显示。
@@ -41,6 +41,10 @@ const carLabel = computed(() => {
const statusText = computed(() => {
if (!activeChain.chainNo) return '未开始'
const s = activeChain.status
// 2026-11-19 挂起动作提示:等待举升/等待放下确认/等待放下完成(主控定稿,页面看得清清楚楚)
if (activeChain.pendingAction === 'CONTINUE_LIFT') return '等待举升完成 · 车辆正在举起货物'
if (activeChain.pendingAction === 'WAIT_DROP_CONFIRM') return '已到位 · 货物待放下(请点「确认放下」)'
if (activeChain.pendingAction === 'FREE_ROBOT') return '放下执行中 · 等待放下完成后自动释放车辆'
if (s === 'ARRIVED') return '已到位 · 可前往下一站'
// RCS 的 taskStatus=2 只代表「任务已被海康受理/激活」,不代表有车在跑——
// 必须结合 agvCode 判断:车号为空=海康尚未派车,车辆不会移动(2026-11-17 现场实测:C01 长时间 status=2 且 agvCode 全空)。
@@ -162,7 +166,7 @@ function connectAgvWs() {
ws.onmessage = (ev) => {
try {
const msg = JSON.parse(ev.data)
if (msg && Array.isArray(msg.chains)) applyChains(msg.chains)
if (msg && Array.isArray(msg.chains)) { applyChains(msg.chains); loadPalletState() }
if (msg && (msg.vehicles || msg.vehicleStatus)) loadVehicles()
} catch { /* 忽略单条异常推送 */ }
}
@@ -199,10 +203,30 @@ function applyChains(list) {
current: last?.targetDock || '',
segments: c?.segments || [],
status: last?.status || '',
pendingAction: last?.pendingAction || '',
templateType: last?.templateType || '',
realtime: c?.realtime || null
})
}
// ===== 载货台账(2026-11-19 取/送互锁依据):当前车有没有托盘,看得清清楚楚 =====
const palletState = ref(null) // { agvCode, hasPallet, source, updatedAt }
async function loadPalletState() {
try {
const d = await request.get('/agv/vehicle-states')
const list = d?.list || d || []
const code = activeChain.agvCode
palletState.value = code ? (list.find((x) => x.agvCode === code) || null) : null
} catch { palletState.value = null }
}
// 车辆载货判定:台账缺失行视为空车(首段未建立台账)
const carLoaded = computed(() => !!(palletState.value && palletState.value.hasPallet))
const carLoadedText = computed(() => {
if (vehicleUnavailable.value) return '载货状态未知(RCS 不可用)'
if (carLoaded.value) return '有托盘(载货)'
return '无托盘(空车)'
})
// RCS 实时对比行文案(2026-11-17 用户要求:本地判定必须有 API 事实可对比)。
const realtimeText = computed(() => {
const r = activeChain.realtime
@@ -240,8 +264,14 @@ function pick(code) {
selected.value = code
}
/** 开始用车(系统自动分车)/ 前往下一站(固定延续同一辆车) */
async function dispatch() {
/**
* 三个生命周期动作(2026-11-19 主控定稿,按钮点名道姓突出取/送):
* - 到【A】取货(purpose=pickup,空车可点)→ B02 移动模板
* - 送货到【A】(purpose=deliver,载货可点)→ B01 举升模板
* - 开始用车(首段空车 C01,无 purpose)
* 后端 AgvChainNextNode 按台账做同口径硬校验,前端灰化只是第一道提示。
*/
async function dispatch(purpose) {
if (!canManual.value) { ElMessage.error('没有人工派车的操作权限'); return }
const target = selected.value
if (!target) { ElMessage.warning('请先点选一个目标点位'); return }
@@ -252,6 +282,7 @@ async function dispatch() {
selected.value = ''
return
}
const verb = purpose === 'pickup' ? '取货' : purpose === 'deliver' ? '送货' : '前往'
if (!(await askPathClear())) return
busy.value = true
try {
@@ -272,9 +303,10 @@ async function dispatch() {
chainNo: activeChain.chainNo,
source: activeChain.current || '',
target,
purpose: purpose || '',
confirmForcePick: ''
})
ElMessage.success(`已前往下一站 ${target}(继续用车 ${carLabel.value})`)
ElMessage.success(`已${verb}前往 ${target}(继续用车 ${carLabel.value})`)
} else {
// 开始用车:不传车号,由海康 RCS 自行分配
try {
@@ -293,20 +325,33 @@ async function dispatch() {
}
}
selected.value = ''
await loadChains()
await Promise.all([loadChains(), loadPalletState()])
} finally {
busy.value = false
}
}
/** 结束用车:海康任务取消、车辆释放(RCS 自行处置);本地记录的车号一并清空 */
/** 确认放下(B01 到位举着货 → 放行组3 放下,放下完成自动释放车辆) */
async function confirmDrop() {
if (!canManual.value) { ElMessage.error('没有人工派车的操作权限'); return }
const last = activeChain.segments?.length ? activeChain.segments[activeChain.segments.length - 1] : null
if (!last?.taskNo) { ElMessage.warning('未找到当前任务'); return }
busy.value = true
try {
await request.post('/agv/confirm-drop', { taskNo: last.taskNo })
ElMessage.success('已放行放下动作,放下完成后车辆自动释放')
await loadChains()
} finally { busy.value = false }
}
/** 结束任务:continueTask 完结海康任务 + freeRobot 释放车辆(2026-11-19 主控定稿);本地记录的车号一并清空 */
async function endUse() {
if (!canManual.value) { ElMessage.error('没有人工派车的操作权限'); return }
if (!activeChain.chainNo) return
try {
await ElMessageBox.confirm(
`请确保 ${carLabel.value || '当前车辆'} 上没有托盘。结束后本次用车完成,海康任务取消,车辆由 RCS 自行处置。`,
'结束用车', { confirmButtonText: '确认无托盘,结束用车', cancelButtonText: '取消', type: 'warning' }
`请确保 ${carLabel.value || '当前车辆'} 上没有托盘。结束后本次用车完成,海康任务完结,车辆释放。`,
'结束任务', { confirmButtonText: '确认无托盘,结束任务', cancelButtonText: '取消', type: 'warning' }
)
} catch { return }
busy.value = true
@@ -314,7 +359,7 @@ async function endUse() {
await request.post('/agv/chain/end', { chainNo: activeChain.chainNo, force: false })
ElMessage.success('本次用车已结束,车辆已释放')
selected.value = ''
Object.assign(activeChain, { chainNo: '', agvCode: '', current: '', segments: [], status: '' })
Object.assign(activeChain, { chainNo: '', agvCode: '', current: '', segments: [], status: '', pendingAction: '', templateType: '' })
await loadChains()
} catch (e) {
const msg = e?.message || e?.response?.data?.message || String(e)
@@ -367,7 +412,7 @@ async function submitForceEnd() {
ElMessage.success('系统任务状态已解除。请继续到现场核实实物状态。')
forceDialog.value = false
selected.value = ''
Object.assign(activeChain, { chainNo: '', agvCode: '', current: '', segments: [], status: '' })
Object.assign(activeChain, { chainNo: '', agvCode: '', current: '', segments: [], status: '', pendingAction: '', templateType: '' })
// 2026-11-17 补:强制结束会释放点位锁,必须同步刷新点位卡,否则锁标记残留误导
await Promise.all([loadPoints(), loadChains()])
} catch { /* 请求层已提示 */ }
@@ -375,7 +420,7 @@ async function submitForceEnd() {
}
onMounted(async () => {
await Promise.all([loadPoints(), loadChains(), loadVehicles()])
await Promise.all([loadPoints(), loadChains(), loadVehicles(), loadPalletState()])
connectAgvWs()
})
@@ -404,12 +449,17 @@ onBeforeUnmount(() => {
车辆卡死?异常处理
</button>
</div>
<span class="veh-dots" :title="vehDotsTitle">
<span class="veh-dots-label">车辆</span>
<span class="veh-list" :title="vehDotsTitle">
<template v-if="vehicles.length">
<i v-for="v in vehicles" :key="v.robotCode" class="veh-dot" :class="vehDotClass(v.status)"></i>
<span v-for="v in vehicles" :key="v.robotCode" class="veh-cell" :class="vehDotClass(v.status)">
<span class="veh-code">AGV {{ v.robotCode }}</span>
<span class="veh-bar"></span>
</span>
</template>
<i v-else class="veh-dot gray"></i>
<span v-else class="veh-cell gray">
<span class="veh-code">暂无车辆</span>
<span class="veh-bar"></span>
</span>
</span>
<span class="live-tag">状态自动更新</span>
</div>
@@ -436,17 +486,43 @@ onBeforeUnmount(() => {
</div>
<el-empty v-if="!selectablePoints.length" description="暂无可用点位,请先在「AGV管理 → 点位管理」或种子数据初始化点位" :image-size="70" />
<!-- 目的地与三个生命周期动作 -->
<!-- 目的地与生命周期动作(2026-11-19 主控定稿:取/送点名道姓+托盘互锁,看得清清楚楚) -->
<div class="action-panel" :class="{ ready: !!selected }">
<div class="dest-label">目的地</div>
<div class="dest-value">{{ selected ? selected : '请点选上方点位' }}</div>
<div class="dest-sub" v-if="selectedPoint">
{{ selectedPoint.name || '' }} · {{ selectedTemplate }} · {{ activeChain.chainNo ? `继续用车 ${carLabel || '待识别'}` : '由系统自动分配车辆' }}
</div>
<button type="button" class="big-action" :disabled="!canManual || !selected || busy" @click="dispatch">
{{ activeChain.chainNo ? '▶ 前往下一站' : '▶ 开始用车' }}
</button>
<button v-if="canManual && activeChain.chainNo" type="button" class="big-end" :disabled="busy" @click="endUse">■ 结束用车(确认车上无托盘并释放车辆)</button>
<!-- 当前车载货状态:醒目徽标,取/送互锁的判定依据 -->
<div v-if="activeChain.chainNo" class="pallet-badge" :class="carLoaded ? 'loaded' : 'empty'">
{{ carLabel || '当前车' }}:{{ carLoadedText }}
</div>
<!-- B01 到位举着货:唯一动作=确认放下(放下前取/送/结束全部锁死) -->
<template v-if="activeChain.pendingAction === 'WAIT_DROP_CONFIRM'">
<button type="button" class="big-action drop" :disabled="!canManual || busy" @click="confirmDrop">
✓ 确认放下(放下货物并自动释放车辆)
</button>
<div class="lock-tip">货物尚未放下:取货 / 送货 / 结束任务均不可操作,请先确认放下</div>
</template>
<template v-else>
<button v-if="!activeChain.chainNo" type="button" class="big-action" :disabled="!canManual || !selected || busy" @click="dispatch('')">
▶ 开始用车(空车前往 {{ selected || '所选点位' }})
</button>
<template v-else>
<button type="button" class="big-action pickup" :disabled="!canManual || !selected || busy || carLoaded" @click="dispatch('pickup')">
到【{{ selected || '…' }}】取货
</button>
<div v-if="carLoaded" class="lock-tip">当前车已有托盘,不能再取货——请先「送货到」目标点位卸货</div>
<button type="button" class="big-action deliver" :disabled="!canManual || !selected || busy || !carLoaded" @click="dispatch('deliver')">
送货到【{{ selected || '…' }}】
</button>
<div v-if="!carLoaded" class="lock-tip">当前车无托盘,无货可送——请先「到目标点位取货」</div>
</template>
<button v-if="canManual && activeChain.chainNo" type="button" class="big-end" :disabled="busy || carLoaded" @click="endUse">■ 结束任务(确认车上无托盘并释放车辆)</button>
<div v-if="activeChain.chainNo && carLoaded" class="lock-tip">当前车有托盘,结束前请先送货卸货</div>
</template>
</div>
<!-- 已走节点:清清楚楚看到走到哪一步了 -->
@@ -461,7 +537,7 @@ onBeforeUnmount(() => {
<el-alert type="info" :closable="false" style="margin-top:20px"
title="说明"
description="开始用车:选一个点位点「开始用车」,系统自动分配一辆车。前往下一站:再选点位,全程固定用这一辆。结束用车:点「结束用车」释放车辆。全程不需要你选车号,工位接驳台不可选。车辆到位/失败会自动更新,无需手动刷新。举升/放下动作由 RCS 模板内置,MES 不控制;工位接驳台由业务配送单自动下发,人工派车不可选。车辆状态小圆点:灰=不在线/不可用,绿=空闲可用,红=执行占用。" />
description="开始用车:选一个点位点「开始用车」,系统自动分配一辆空车前往。之后按车载货状态点按钮:空车时点「到【目标】取货」,载货时点「送货到【目标】」,按钮会根据当前车有没有托盘自动灰化并提示原因。B01 举升送货到位后车举着货停稳,需点「确认放下」,放下完成后车辆自动释放。结束任务前请确认车上无托盘。全程不需要你选车号,工位接驳台不可选。状态(到位/等待举升/等待放下)自动更新,无需手动刷新。右侧每台车上下显示车号与颜色条:灰=不在线/不可用,绿=空闲可用,红=执行占用。" />
<!-- 异常处置受控对话框:必须读危险说明 + 选原因 + 勾选现场已确认,才允许二次确认 -->
<el-dialog v-model="forceDialog" title="异常处置 · 解除系统死锁" width="560px" :close-on-click-modal="false">
@@ -506,13 +582,16 @@ onBeforeUnmount(() => {
.status-value.unknown { color: #e6a23c; }
.status-value.running { color: #67c23a; }
.live-tag { margin-left: auto; font-size: 14px; color: #67c23a; }
/* 车辆状态小圆点:极小、低调,只标识闲忙,不抢视觉 */
.veh-dots { display: inline-flex; align-items: center; gap: 5px; align-self: center; }
.veh-dots-label { font-size: 12px; color: #909399; margin-right: 2px; }
.veh-dot { display: inline-block; width: 8px; height: 8px; border-radius: 50%; }
.veh-dot.green { background: #67c23a; }
.veh-dot.red { background: #f56c6c; }
.veh-dot.gray { background: #c0c4cc; }
/* 车辆状态:上下结构,车号小字 + 颜色条区分闲忙(不显示"车辆"二字) */
.veh-list { display: inline-flex; align-items: center; flex-wrap: wrap; gap: 8px; align-self: center; }
.veh-cell { display: inline-flex; flex-direction: column; align-items: center; gap: 3px; }
.veh-code { font-size: 11px; line-height: 1; white-space: nowrap; color: #909399; }
.veh-bar { display: inline-block; width: 30px; height: 4px; border-radius: 2px; background: #c0c4cc; }
.veh-cell.green .veh-bar { background: #67c23a; }
.veh-cell.green .veh-code { color: #67c23a; }
.veh-cell.red .veh-bar { background: #f56c6c; }
.veh-cell.red .veh-code { color: #f56c6c; }
.veh-cell.gray .veh-bar { background: #c0c4cc; }
/* RCS 实时对比条:正常=灰字事实陈述;取不到 RCS=橙色警示(本地状态未经证实) */
.realtime-bar {
padding: 6px 14px; font-size: 13px; color: #909399;
@@ -563,6 +642,19 @@ onBeforeUnmount(() => {
font-size: 27px; font-weight: 800; cursor: pointer; font-family: inherit;
}
.big-action:disabled { background: #c0c4cc; cursor: not-allowed; }
/* 取/送按钮色彩区分(2026-11-19):取货=绿(去装货)、送货=橙(载货运输)、确认放下=绿深 */
.big-action.pickup { background: #67c23a; }
.big-action.deliver { background: #e6a23c; }
.big-action.drop { background: #529b2e; }
/* 当前车载货徽标:绿=空车可取货 / 橙=载货待送货,互锁判定一目了然 */
.pallet-badge {
display: inline-block; margin: 4px auto 12px; padding: 6px 22px; border-radius: 20px;
font-size: 18px; font-weight: 700;
}
.pallet-badge.empty { color: #529b2e; background: #f0f9eb; border: 2px solid #67c23a; }
.pallet-badge.loaded { color: #b88230; background: #fdf6ec; border: 2px solid #e6a23c; }
/* 互锁原因提示:置灰按钮下方一句话说清为什么不能点 */
.lock-tip { font-size: 15px; color: #b8860b; margin: 8px 0 4px; }
.big-end {
display: block; width: 100%; max-width: 520px; margin: 12px auto 0;
min-height: 60px; border: 2px solid #f56c6c; border-radius: 14px; background: #fff; color: #f56c6c;
+36 -17
View File
@@ -195,20 +195,21 @@
<el-form-item :label="dialog.mode === 'FIXED' ? '每日产量' : '总数量'">
<el-input-number v-model="dialog.planQty" :min="1" :max="dialog.woRemain || undefined" style="width:100%" />
<div v-if="dialog.woRemain != null" style="color:#909399;font-size:12px;width:100%">
工单数量 {{ dialog.woQty }},剩余可排 {{ dialog.woRemain }} 台;总数量不能超过剩余可排。
工单数量 {{ dialog.woQty }},剩余可排 {{ dialog.woRemain }} 台;{{ dialog.mode === 'FIXED' ? `本次共 ${planTotalQty} 台(每日 ${dialog.planQty} × ${previewDates.length} 天),不能超过剩余可排` : '总数量不能超过剩余可排' }}。
</div>
</el-form-item>
<!-- 逐日数量:系统按模式铺出建议值后,允许逐日手工调节;Σ 必须等于总数量(客户问题.md 原答复:预览可自行调节、总数据要对上) -->
<!-- 逐日数量:平均分摊允许逐日手调(Σ=总数量);固定日产每天恒定,逐日只读、由后端按 mode 分摊,避免手调后合计对不上 -->
<el-form-item v-if="dailyItems.length" label="逐日数量">
<div style="width:100%;max-height:160px;overflow:auto">
<div v-for="d in dailyItems" :key="d.date" style="display:flex;justify-content:space-between;align-items:center;font-size:12px;color:#606266;margin-bottom:4px">
<span>{{ d.date }}</span>
<el-input-number v-model="d.qty" :min="0" size="small" controls-position="right" style="width:120px" />
<el-input-number v-model="d.qty" :min="0" size="small" controls-position="right" style="width:120px" :disabled="dialog.mode === 'FIXED'" />
</div>
</div>
<div style="font-size:12px;width:100%;margin-top:4px"
:style="{ color: dailyItems.reduce((s, d) => s + (Number(d.qty) || 0), 0) === Number(dialog.planQty) ? '#67c23a' : '#f56c6c' }">
各日合计 {{ dailyItems.reduce((s, d) => s + (Number(d.qty) || 0), 0) }} / 总数量 {{ dialog.planQty }}(要相等才能保存;可把前面排少、中后期排多)
:style="{ color: dailyItems.reduce((s, d) => s + (Number(d.qty) || 0), 0) === planTotalQty ? '#67c23a' : '#f56c6c' }">
各日合计 {{ dailyItems.reduce((s, d) => s + (Number(d.qty) || 0), 0) }} / 总数量 {{ planTotalQty }}
({{ dialog.mode === 'FIXED' ? `固定日产,每天 ${dialog.planQty} 台,共 ${planTotalQty} 台` : '要相等才能保存;可把前面排少、中后期排多' }})
</div>
</el-form-item>
<el-alert type="info" :closable="false" style="margin-bottom:12px"
@@ -420,6 +421,13 @@ const previewDates = computed(() => {
return out
})
// 本次排产「应排总件数」:固定日产 = 每日产量 × 天数,平均分摊 = 填写的总数量。
// 逐日合计要跟它对齐,不能跟「每日产量」比——否则固定日产下越点越对不上(bug 根因)。
const planTotalQty = computed(() => {
const q = Number(dialog.planQty) || 0
return dialog.mode === 'FIXED' ? q * previewDates.value.length : q
})
// 逐日数量预览:与后端 distributeQty 同算法(AVG 余数排前 / FIXED 按每日产量末日取余)
const dailyPreview = computed(() => {
const dates = previewDates.value
@@ -428,7 +436,9 @@ const dailyPreview = computed(() => {
const days = dates.length
const out = []
if (dialog.mode === 'FIXED') {
let left = total
// 固定日产:总件数 = 每日产量 × 天数(与后端 distributeQty(PlanQty*days,...) 同口径),
// 逐日每天先铺「每日产量」,末日不足取余;Σ = 每日产量 × 天数。
let left = total * days
const daily = Math.max(1, Number(dialog.planQty) || 1)
dates.forEach((date) => { const q = Math.min(daily, left); out.push({ date, qty: q }); left -= q })
} else {
@@ -717,24 +727,33 @@ async function save() {
if (!dialog.planRange || dialog.planRange.length !== 2 || !dialog.planRange[0] || !dialog.planRange[1])
return ElMessage.warning('请选择排产日期范围')
if (!dialog.planQty || dialog.planQty < 1) return ElMessage.warning('请填写数量')
// 总量不得超过工单剩余可排(实际以服务端为准,这里提前提示避免让用户白填一遍)
if (dialog.woRemain != null && dialog.planQty > dialog.woRemain)
return ElMessage.warning(`总数量 ${dialog.planQty} 超过工单剩余可排 ${dialog.woRemain} 台,请调小或到工单管理追加数量`)
// 总量不得超过工单剩余可排(固定日产=每日产量×天数,与后端 quota 校验同口径)
if (dialog.woRemain != null && planTotalQty.value > dialog.woRemain) {
const hint = dialog.mode === 'FIXED'
? `每日 ${dialog.planQty} × ${previewDates.value.length} 天 = ${planTotalQty.value} 台`
: `总数量 ${planTotalQty.value}`
return ElMessage.warning(`${hint} 超过工单剩余可排 ${dialog.woRemain} 台,请调小或到工单管理追加数量`)
}
if (dialog.woStatus && ['DONE', 'CANCELLED'].includes(dialog.woStatus))
return ElMessage.warning(`工单 ${dialog.orderNo} 已完成或已取消,不能排产`)
// 逐日可手改:各日合计必须等于总数量(与工单自动排产同一口径),带 items 交后端按指定量落库。
if (dailyItems.value.length) {
// 平均分摊:逐日可手改,各日合计必须等于总数量,带 items 交后端按指定量落库。
// 固定日产:每天恒定,逐日只读,不传 items——让后端按 mode 自己分摊(planQty 传每日产量,
// 与后端 distributeQty(PlanQty*days) 及 quota 校验同口径),彻底避开逐日合计对不上的问题。
const payload = {
orderNo: dialog.orderNo, planRange: dialog.planRange, mode: dialog.mode, planQty: dialog.planQty
}
if (dialog.mode === 'FIXED') {
payload.items = []
} else if (dailyItems.value.length) {
if (dailyItems.value.some((d) => !(Number(d.qty) >= 0)))
return ElMessage.warning('逐日数量不能为负')
const daySum = dailyItems.value.reduce((s, d) => s + (Number(d.qty) || 0), 0)
if (daySum !== Number(dialog.planQty))
return ElMessage.warning(`各日合计 ${daySum} 与总数量 ${dialog.planQty} 不一致,请把逐日数量调到相等`)
if (daySum !== planTotalQty.value)
return ElMessage.warning(`各日合计 ${daySum} 与总数量 ${planTotalQty.value} 不一致,请把逐日数量调到相等`)
payload.items = dailyItems.value.map((d) => ({ date: d.date, qty: Number(d.qty) || 0 }))
}
warnOutOfWindow([dialog.planRange[0], dialog.planRange[1]])
await request.post('/daily-plans', {
orderNo: dialog.orderNo, planRange: dialog.planRange, mode: dialog.mode, planQty: dialog.planQty,
items: dailyItems.value.map((d) => ({ date: d.date, qty: Number(d.qty) || 0 }))
})
await request.post('/daily-plans', payload)
}
ElMessage.success('保存成功')
dialog.show = false
+56 -1
View File
@@ -74,7 +74,49 @@
<!-- 6. 手动下发指令 -->
<el-card class="block">
<template #header><span>手动下发路径指令</span></template>
<template #header>
<span>手动下发路径指令</span>
<el-popover placement="right" :width="440" trigger="hover" popper-class="manual-send-help">
<template #reference>
<el-icon class="help-dot"><WarningFilled /></el-icon>
</template>
<div class="mh-body">
<svg class="mh-svg" viewBox="0 0 430 234" xmlns="http://www.w3.org/2000/svg">
<rect x="4" y="4" width="206" height="142" rx="6" fill="#eef4ff" stroke="#5b8ff9" stroke-width="1.5"/>
<text x="107" y="24" text-anchor="middle" font-size="13" font-weight="700" fill="#2b5fa8">工位下发</text>
<text x="107" y="40" text-anchor="middle" font-size="10" fill="#5b8ff9">(给工件定路线 · 单独菜单页)</text>
<line x1="14" y1="49" x2="200" y2="49" stroke="#c6d9f7" stroke-width="1"/>
<text x="16" y="66" font-size="11" fill="#303133">选 工单 + 工件序号</text>
<text x="107" y="84" text-anchor="middle" font-size="13" fill="#5b8ff9">▼</text>
<text x="16" y="100" font-size="11" fill="#303133">系统算出经过哪些工位</text>
<text x="107" y="118" text-anchor="middle" font-size="13" fill="#5b8ff9">▼</text>
<text x="16" y="136" font-size="11" fill="#303133">写设备路线码 + 留下发记录</text>
<rect x="220" y="4" width="206" height="142" rx="6" fill="#fdf3e7" stroke="#e6a23c" stroke-width="1.5"/>
<text x="323" y="24" text-anchor="middle" font-size="13" font-weight="700" fill="#a96a12">手动下发路径指令</text>
<text x="323" y="40" text-anchor="middle" font-size="10" fill="#c8871f">(给设备下一次搬运 · 本区块)</text>
<line x1="230" y1="49" x2="416" y2="49" stroke="#f0d9ad" stroke-width="1"/>
<text x="232" y="66" font-size="11" fill="#303133">选 源点位 → 目标点位</text>
<text x="323" y="84" text-anchor="middle" font-size="13" fill="#e6a23c">▼</text>
<text x="232" y="100" font-size="11" fill="#303133">只写一个搬运指令</text>
<text x="323" y="118" text-anchor="middle" font-size="13" fill="#e6a23c">▼</text>
<text x="232" y="136" font-size="11" fill="#303133">不留记录 · 不改工件状态</text>
<rect x="4" y="156" width="422" height="74" rx="6" fill="#fff1f0" stroke="#f5a3a3" stroke-width="1.2"/>
<text x="215" y="177" text-anchor="middle" font-size="12" font-weight="700" fill="#c0392b">两者靠「在途指令」互相挡</text>
<text x="215" y="197" text-anchor="middle" font-size="11" fill="#c0392b">工件下发还没收到完成信号 → 手动下发被拒绝</text>
<text x="215" y="216" text-anchor="middle" font-size="10" fill="#909399">先回「工位下发」页撤回或人工完成,才能手动下发</text>
</svg>
<div class="mh-title">这两种「下发」不是一回事</div>
<p class="mh-row"><b>工位下发</b>:给工件定路线。选工单号和工件序号,系统自动算出这台工件要经过哪些工位,把这条路线码写给设备,并留下正式下发记录。托盘在工位之间的流转由报工自动驱动,不靠这里搬动;只有需要设备按指定路线停靠或做对账时才来这里下发,不是每件必做。</p>
<p class="mh-row"><b>手动下发路径指令</b>(本区块):给设备下一次搬运。直接指定从哪里搬到哪里,只向产线设备写一个指令,不建生产记录、不改工件状态。只有设备联调、指令卡住的异常处置时才用。</p>
<p class="mh-row mh-warn">两者会互相挡:只要有工件下发还没收到完成信号,手动下发就会被拒绝——先回「工位下发」页撤回或人工完成。</p>
<div class="mh-title">什么时候用哪个</div>
<div class="mh-row">· 正常生产、工件上线 → 到「工位下发」页</div>
<div class="mh-row">· 设备联调、托盘卡住、现场确认要手动搬一次 → 这里的手动下发路径指令</div>
</div>
</el-popover>
</template>
<el-alert type="warning" :closable="false" class="tip">
手动下发会向产线设备写入路径指令。下发前系统自动检查是否存在在途指令(尚未收到完成信号)——若有则拒绝并提示,以免打断自动线。
</el-alert>
@@ -129,6 +171,7 @@ import request from '../utils/request'
import PageHelp from '../components/PageHelp.vue'
import { helpPlcMonitor } from '../help'
import { dockCn } from '../utils/dockLabel'
import { WarningFilled } from '@element-plus/icons-vue'
const bits = reactive({ station: [], main: [], dock: [], jbt: null, mock: false })
const mws = ref([])
@@ -371,4 +414,16 @@ onUnmounted(closePlcWs)
.preview { margin: 10px 0; font-size: 14px; }
.muted { color: #909399; }
.clear-body { margin: 10px 0; font-size: 14px; }
.help-dot { margin-left: 6px; cursor: help; color: #5b8ff9; font-size: 15px; vertical-align: middle; }
</style>
<!-- el-popover 内容挂到 body 下,scoped 样式不生效,这里单独给帮助弹层写样式 -->
<style>
.manual-send-help { max-width: 460px; }
.manual-send-help .mh-body { font-size: 13px; line-height: 1.7; color: #303133; }
.manual-send-help .mh-svg { display: block; width: 100%; height: auto; margin: 2px 0 10px; font-family: inherit; }
.manual-send-help .mh-title { font-weight: 600; font-size: 14px; color: #1f2d3d; margin: 2px 0 8px; }
.manual-send-help .mh-title:not(:first-child) { margin-top: 14px; }
.manual-send-help .mh-row { margin: 0 0 8px; }
.manual-send-help .mh-warn { color: #c0702e; }
</style>