Files
bj_power/bj_power_mes/frontend/src/help.js
T
SunYF af554cea75 feat: 同步失败台账双向可重试 + 拧紧枪按工位配置 + 虚拟工位体系 + 去Redis与文档口径对齐
- 同步失败台账:MES/WMS 双端新增台账与页面,跨系统通知失败落台账、人工重试或标记已处理,不自动重传;重试前先判对端终态;叫料、配送、出库回写失败提示指向台账;补幂等建表脚本与菜单权限。
- 拧紧枪:新增按工位配置页,展示控制器地址与三把枪通道号(仅供查看,不参与采集校验);「允许手填」由全局开关改为每工位开关,关闭时校验该工位已配控制器;终端启动/登录上报配置并按本工位拉取,扭矩手填框按本工位置灰;补全局值迁移到各工位的脚本。
- 工位体系:终端未配置工位号时登录页可选(含虚拟工位),固定工位模式保留;虚拟/线下位不叫料、不退料、不作转产目标,未采集绑定放行并说明原因;叫料期望接驳台改为选填。
- AGV与出库:补「出库单已送达」回写;空车回充、接驳台传感器失联、配送状态更新失败均落预警或留痕并提示人工核对;人工出库不引入送达状态;出库单支持目标工位/接驳台并扩展导出列。
- 基础设施:看板缓存由Redis改为MES进程内实现,文档与启动脚本同步去Redis;扫码监听支持多地址、端口被占自动降级;PLC对账与工位报警在MES不可达时降级放行并留日志。
- 文档与帮助:案例与部署手册按实测订正(工位绑定、菜单名称、补料由班组长代提、菜单覆盖对照、虚拟工位);迁移脚本改为本地即时执行并登记7个已执行脚本;三端页面帮助改为「业务/操作/影响范围/后果」四要素。
- 测试:新增独立Go模块,按三个业务场景做真实HTTP与真实写库的流水测试,含运行报告。
2026-11-09 18:58:47 +08:00

694 lines
107 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// MES 管理后台 页面级操作说明:整体流程 + 各字段 数据来源/用途/怎么填
// 由 components/PageHelp.vue 在左下角 "?" 按钮弹出展示。
// 说明:这里的"数据来源"特指该字段的数据由谁产生、从哪个系统/页面来,帮助跑通真实流程。
export const helpProductType = {
title: '物料档案(档案维护)',
scope: "写入 MES 物料副本并同步 WMS 物料档案;工单选型号、工艺物料清单、备料算料、完工回流都引用此处的编码与序列号口径。",
consequence: "编码/图号改动会断开已建工单与追溯关联;停用后新建工单下拉不可选但不影响历史单据;WMS 不可达时单条建档置 sync_pending 待重推,Excel 批量导入则整批拒绝。",
overview:
'物料档案 = 本页是 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-序号),你可直接使用或改为自定义编码;编辑时保留已存值。一个图号可对应多个工单(同一型号今天做一批、明天做一批,产品工号不同,图号相同)。',
purpose: '产品唯一编码。它是 MES 内部识别该产品的标识,决定该产品的物料清单内容,也是工单、备料、拧紧、追溯的挂靠键。',
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: '如:台 / 套' },
{ name: '类型', source: '下拉必选(结构件/电气件/其他)。', purpose: '产品的分类口径,仅作分类,不决定是否逐件SN管理', fill: '选择类型后自动带默认「序列号」:电气件→序列号=是,结构件/其他→序列号=否(可改)' },
{ name: '序列号', source: '下拉必选(序列号=是(逐件录SN)/ 序列号=否(按批次数量))。', purpose: '决定全链路 SN 行为:上线建档(序列号=是须扫已在WMS入库登记的来料SN,序列号=否系统自动发号)、装机绑定(序列号=是绑SN、序列号=否绑批次号)、备料出库与质量检验定位', fill: '未选择(请选择)不可保存;默认随「类型」联动带出,可手动改' },
{ name: '启用', source: '开关选择。默认开启。', purpose: '启用后才允许在新建工单/备料的下拉里被选到', fill: '默认开启;暂时停产的可关闭(不删除,保留档案)' },
{ name: '停用', source: '行内「停用」按钮(原「删除」,两库均不物理删除)。', purpose: '停用后该型号退出新建下拉,并自动同步 WMS 同步停用;历史工单/库存/追溯不受影响', fill: '点「停用」二次确认即可;已停用的行按钮显示「已停用」' },
{ name: '模板下载', source: '列表工具栏按钮。', purpose: '下载 Excel 批量建档模板(列:图号/名称/规格/单位/说明/类型/序列号/启用)', fill: '点「模板下载」保存到本机,按行填写后用「Excel 导入」上传' },
{ name: 'Excel 导入', source: '列表工具栏按钮(需物料档案新增权限)。', purpose: '把填好的模板批量导入为物料档案,逐行校验、逐行导入', fill: '点「Excel 导入」选择文件上传 → 查看成功/失败行数与失败原因(如编码重复、必填缺失),失败行修正后可重新上传' }
]
}
export const helpWorkOrder = {
title: '工单管理(新建 / 编辑 / 删除工单)',
// B9 四要素:业务=overview,操作=sections 逐字段(保留),影响范围/后果如下
scope: '工单是生产执行与仓库出库的挂靠载体:工艺组合决定报工路线,日排产/备料单、工件 SN、追溯与流程卡都挂在本页工单号下。',
consequence: '未选产品型号或工艺组合校验不通过会被拒绝保存;工单未完成(非 DONE/CANCELLED)时工艺组合与来源产品工艺禁改,仅 PAUSED 走转产改线两步;删除仅「已创建」且无排产/备料/生产数据的工单可执行,删除不可恢复;组合改动会改变下游报工候选工位与备料算料结果。',
overview:
'工单 = 一个"生产批次"的唯一载体,是生产执行和仓库出库挂靠的核心对象。\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: '按订单来源选择;归属会随半成品流转自动继承到 WMS' },
{ name: '归属编号', source: '手工填写。随归属类型填合同号或科技项目号。', purpose: '一级归属编号(合同号/科技项目号二选一)', fill: '如 HT-2026-001 或 KJ-2026-001;选「其他」可不填' },
{ name: '数量', source: '手工填写整数。', purpose: '本工单生产总数量(合同台数),决定需求量与排产上限', fill: '整数 ≥1,如 100' },
{ name: '工序工位', source: '按产品工艺的工序顺序,每道工序从下拉选一个工位(候选=工位管理里绑定该工序的启用工位)。保存为 [{flowId,stationNo}]。', purpose: '本工单的执行路线;自动排产/备料拆分/产线下发均按此组合派生', fill: '系统按工艺顺序自动推荐工位(第1道取候选最小工位,第N道取大于上一道已选且候选最小的工位);可逐道修改,下拉只列合法候选(第N道候选=绑定该工序且工位号>第N-1道已选);工位号须按工序顺序严格递增' },
{ name: '状态', source: '新建时选"已创建",后续由流程推进。', purpose: '工单生命周期:创建→发布→生产→完成', fill: '新建时选"已创建";也可在列表操作列点「状态」快捷流转(发布/开工/完工)' },
{ name: '计划开始 / 计划完成', source: '建单/编辑时选填(计划开始可空)。', purpose: '记录工单计划交付窗口;系统不再单独维护「要求完成日期」字段(已移除)', fill: '建单时选择日期' },
{ name: '时间字段口径', source: '建单填写 + 系统自动记录。', purpose: '计划开始/计划完成=建单填写的计划区间;实际开始=首次"下发并开工"的时间(系统落库);实际完成=本工单全部工件报工完成、置"已完成"的时间(系统落库)。("完成日期"是要求/承诺完成日期,属上一条独立字段)', fill: '建单填计划开始/计划完成(选填);实际开始/实际完成由系统自动写,无需手填' },
{ name: '创建人', source: '系统自动记录(当前登录账号)。', purpose: '追溯工单由谁创建', fill: '只读,自动带入' }
]
},
{
title: '工单详情',
overview: '列表操作列「详情」打开只读抽屉:上半部分为工单字段汇总(产品工号/图号/名称/归属/数量/状态/日期),下半部分为该工单的工件SN列表。\n工件SN列表数据来源=工件进线登记记录:支持按状态筛选与分页(默认每页 100 条,后端分页),按SN升序(小号在前);「SN末段」列取 SN 末段序号,SN 为工件唯一序列号(产品序号=SN,每台工件的序号、不是工单级字段),类型(序列号=是/序列号=否)取自图号对应物料档案的「序列号」设置,状态与当前工位为实时生产进度。',
fields: [
{ name: '工件SN列表', source: '工件查询接口按产品工号过滤,后端 SQL 分页(默认 100/页,可切 100/200/500)+ 状态筛选,按 SN 升序(小号在前),实时读取。', purpose: '核对该批每台工件的 SN、SN末段、类型、状态与当前工位', fill: '只读;可用状态下拉筛选,翻页查看' }
]
},
{
title: '工序工位(路线)',
overview: '新建/编辑工单时按产品工艺的工序顺序,每道工序从下拉选一个工位(工序顺序固定显示)。\n系统按工艺顺序自动推荐:第1道选候选最小工位,第N道选大于上一道已选且候选最小的工位;可逐道修改,下拉只列合法候选(第N道候选=绑定该工序且工位号>第N-1道已选),选不到非法组合。\n组合结果按工位号升序只读展示为路线条(如 2→5→6→8)——执行顺序=工位号升序,工位号须严格递增。\n「自动排产」要求工单已配置工艺组合:组合为空时按钮置灰,提示"请先选择工艺组合"。\n半成品再上线:编辑工单,只选剩余要走的工序对应工位即可。',
fields: [
{ name: '工序工位', source: '按工序顺序逐道选一个工位(候选=绑定该工序的启用工位)。', purpose: '本工单经过的工位与其工艺,产线设备按组合下发', fill: '逐道选择,下拉只列合法候选;至少选一道工序;工位号须按工序顺序严格递增' }
]
},
{
title: '自动排产(引导式)',
overview: '列表页「自动排产」按钮:选工单 + 日期区间 + 排产方式,一键把工单未开工数量分摊到多天日排产。',
fields: [
{ name: '日期区间', source: '日历选择起止日期。', purpose: '在哪段时间内排产', fill: '选开始/结束日期' },
{ name: '排产方式', source: '二选一:平均分摊 / 固定日产。', purpose: '决定每天排多少', fill: '平均分摊=总量÷天数自动均分;固定日产=每天排指定数量,排满为止' },
{ name: '每日数量', source: '固定日产方式下手工填写。', purpose: '固定每天的生产量', fill: '选固定日产时填写,如每天 20' },
{ name: '生成', source: '一键生成日排产记录。', purpose: '批量创建该工单的日排产,合计不超过工单未开工数量', fill: '确认后生成,可到「日排产」页查看/调整' }
]
}
]
}
export const helpDailyPlan = {
title: '日排产(生产计划)',
scope: "写入 daily_plan;备料清单实时算料、叫料池需求、送达接驳台与绩效完成数都按此处的日期×工单×数量派生。",
consequence: "各日数量合计不得超过工单总数;停用的排产不参与备料;删除排产会影响已生成的备料与叫料需求,历史日期默认隐藏。",
overview:
'日排产 = 安排"哪个工单、在哪天、生产多少",是备料和出库的触发依据。\n\n数据链路:工单(总数) → 日排产(按天拆分量,合计不得超过工单总数) → 仓库按日排产备料出库 → 产线按日生产。\n\n页面提供三种视图(顶部 Tab 切换,共用同一份数据、同一套查询条件、同一套操作):\n· Tab1 平铺(默认):一行 = 一个(工单×日期),是启用/编辑/删除排产的操作入口。\n· Tab2 按工单折叠:按工单分组,主行是工单汇总(计划总量/完成总量/状态)、子行是该工单逐日明细,可折叠;只显示未完成(非"已完成/已取消")工单,便于专注看在制任务。\n· Tab3 按日期透视:行=排产日期、列=每个工单各占一列(列头带产品型号)、单元格填"计划/完成/状态",多工单左右并排、互不重叠;点单元格弹详情+操作;透视表最多 12 个工单列(超出用筛选收窄),同样只看未完成工单。\n\n顶部「未排产工单」横幅:统计"状态∈{已创建/已下发/执行中}但日排产表无任何记录"的工单,点「查看」弹出清单并可直接「去排产」。\n\n查询条件区(三 Tab 共用):产品工号(多选)、排产日期范围(默认 今天~今天+30天)、执行状态(默认排除已完成/已取消)、产品、操作人、送达接驳台(多选)、计划数量范围、显示历史(开关,默认关)、排序(升序=从前到后 / 降序=最新在前)。为防止数据量过大,后端分页(默认按日期升序,单次最多 200 行),历史日期默认隐藏。',
fields: [
{ name: '产品工号', source: '下拉选择(多选)。来自"工单管理"已建的工单。', purpose: '该排产对应哪个生产工单', fill: '多选筛选;Tab3 未选时默认显示前 12 个工单' },
{ name: '排产日期', source: '日历选择(范围)。', purpose: '计划在哪一天生产', fill: '默认今天~今天+30天;可改范围' },
{ name: '计划数量', source: '手工填写整数。', purpose: '这一天计划生产多少件', fill: '整数≥1;注意:该工单所有日排产的数量合计不能超过工单总数量' },
{ name: '送达接驳台', source: '由工单「工艺组合」派生(工位号→接驳台编码去重),此处无需手填。', purpose: '该工单物料经 AGV 送到哪些接驳台(DOCK n↔工位n),备料单据此填 target_dock', fill: '随工艺组合自动展示;如需调整路线,到「工单管理」编辑工单的工艺组合' },
{ name: '各工位分产量', source: '启用后点「编辑」,按工单工艺组合的工位逐个填写。', purpose: '各工位分产量决定备料拆分;未配置则同工艺工位平均分;备料需求 = 分产量 × 单台用量 × (1+损耗率%)', fill: '留空或 0 的工位不分担产量;建议合计=计划数量' },
{ name: '停单/恢复', source: '工人在工位终端自主停单/恢复,管理端同步展示当日停单状态。', purpose: '现场异常(缺料/设备故障)时暂停该工位当日出产', fill: '管理端只读展示;恢复由工人或授权人员在工位终端操作' },
{ name: '已完成', source: '系统自动累计。只读。', purpose: '该排产已实际完成多少件', fill: '无需填写' },
{ name: '状态', source: '系统维护。只读。', purpose: '排产执行状态(待排产/已确认)', fill: '无需填写' },
{ name: '启用/停用', source: '行内开关。', purpose: '停用后该条排产不参与备料/生产,可临时挂起某天计划', fill: '拨动开关切换;停用的排产不计入备料' },
{ name: '显示历史', source: '顶部开关(默认关)。', purpose: '是否把今天之前的排产也拉出来', fill: '打开后历史日期数据随查询返回;默认只看未来 30 天' }
]
}
export const helpMaterial = {
title: '叫料单(只读)',
scope: "只读展示 material_request 池行与单据状态;实际发起/签收/退库在工位终端,完成备料/驳回在 WMS 叫料队列。",
consequence: "本页无写操作;需求/已发/占用中/可用四数由单据状态机回写,误叫只能走取消/驳回/退库,不能直接改数。",
overview:
'叫料单 = 工位从「叫料池」发起、仓库据此备料配送的单据。本页只读查看全部叫料单;发起/签收/退库/取消在工位终端操作,完成备料/驳回/确认收回到 WMS「叫料队列」操作。\n\n叫料池是什么:启用状态的日排产(「日排产」页人工启用)自动算出每个工位要用的物料和数量(工位排产量 × 单台用量 × (1+损耗率)),按 工位+物料 汇总成池子行,四数记账:需求 / 已发 / 占用中 / 可用(可用 = 需求 − 已发 − 占用中)。工位只能叫自己工位的料;无工艺或无排产 → 池子无行 → 不能叫。\n\n单据规则:一次叫料按物料行拆成多张单,每张单 = 一个物料 + 一个量 + 一个目标接驳台(一单一个托盘一次配送);叫料单不绑工单、不绑排产,同一物料可多次叫;禁止单内分批,要分就再叫一次。\n\n状态机七态:待备料 → 已发货 → 已完成(工位签收,签收=确认收到、系统不再对差异);分支终态:已取消(待备料时工位撤销)、已驳回(仓库拒发,带理由);退库:已发货 → 退库中 → 已退库(仓库确认收回,仅签收前可整单退,退回后重新叫)。\n\n数量账规则:发起时占用 +请求量;仓库完成备料时已发 +实发量、占用 −请求量(差额自动释放);取消/驳回时占用 −请求量;退库收回时已发 −退库量(额度回补)。\n\n跨日叫料:默认允许叫非今日排产的料(「基础设置」可关);叫到非当日的料,工位端会预警提示,仓库可正常发、也可按「非当日」驳回。要管控就叫「日排产」页把排产置为停用(非启用即不可叫)。\n\n数据链路:日排产(启用) → 叫料池(四数账) → 工位终端发起叫料(占用) → WMS 叫料队列完成备料(WMS 扣库存+AGV 配送) → 工位签收;退库:工位申请 → WMS 退库单 → 仓库确认收回(额度回补)。',
sections: [
{
title: '查询字段',
fields: [
{ name: '叫料单号 / 图号 / 物料名称 / 接驳台 / 工位', source: '手动输入。筛选条件,不区分大小写。', purpose: '定位叫料单', fill: '可空=全部' },
{ name: '来源', source: '系统标记。工位叫料=终端发起;数量不符补发=「数量不符处理」选补发生成。', purpose: '区分正常叫料与差异补发(同样消耗叫料池)', fill: '可空=全部' },
{ name: '状态', source: '下拉。待备料/已发货/已完成/已取消/已驳回/退库中/已退库。', purpose: '按单据进度筛选', fill: '可空=全部' }
]
},
{
title: '列表字段',
fields: [
{ name: '请求量 / 实发量 / 退库量', source: '请求量=发起时确定;实发量=仓库完成备料时确定;退库量=整单退时确定。', purpose: '看一单要多少、实发多少、退了多少', fill: '系统维护' },
{ name: '跨日', source: '系统标记(叫料池行含非今日排产时为「非当日」)。', purpose: '识别跨日叫料', fill: '系统维护' },
{ name: 'WMS出库单号', source: '仓库完成备料时由 WMS 回写(多个逗号分隔)。', purpose: '到 WMS「出库管理」查出库明细', fill: '系统维护' }
]
}
]
}
export const helpQtyReport = {
title: '数量不符处理(差异闭环)',
scope: "写入数量不符报告并生成补发叫料或退料单,回写叫料池已发与占用。",
consequence: "选补发会新增叫料单并再占池额度;选退料须 WMS 确认收货才回补库存;未处理差异会一直挂在工位账上。",
overview:
'工位接料时发现「实收 ≠ 应发」,操作工在工位终端上报后,差异记录进入本页等待处理——这是差异闭环的唯一处理入口。\n\n处理方式三选一:\n· 补发:系统生成一张「数量不符补发」叫料单(来源=数量不符补发,占用叫料池可用量),走仓库叫料队列完成备料后配送到工位,补发量计入工位用料;\n· 退库:系统生成 WMS 退库单(多发/错发的料退回仓库),仓库确认收货后库存加回;\n· 调整:双方确认差异、填写说明后直接关闭(不补不退)。\n\n处理完成后差异置为已处理并记录处理单据号,关联预警可在「预警中心」看到同一件事的提醒。补发/退库的单据流转状态请到「叫料单」或 WMS「退库单」页查看。',
sections: [
{
title: '查询字段',
fields: [
{ name: '状态', source: '系统维护。待处理/已处理。', purpose: '只看待处理的差异', fill: '默认待处理' },
{ name: '工位 / 产品工号 / 图号', source: '工位终端上报时写入。', purpose: '定位差异来源', fill: '可空=全部,不区分大小写' }
]
},
{
title: '处理操作',
fields: [
{ name: '补发', source: '人工在本页操作。', purpose: '少发时补齐差额(生成工位补料单)', fill: '点「补发」→ 确认' },
{ name: '退库', source: '人工在本页操作。', purpose: '多发/错发时退回仓库(生成退库单)', fill: '点「退库」→ 确认' },
{ name: '调整', source: '人工在本页操作(需填处理说明)。', purpose: '少量差异双方确认后关闭', fill: '点「调整」→ 填说明 → 确认。注意:调整即终局——差异关闭后不再补发也不退库,且不可撤销;拿不准走补发/退库' }
]
}
]
}
export const helpPlc = {
title: '工位下发(下发录入 / 下发记录)',
scope: "写 plc_send 下发记录与工位组合状态,供 PLC 写入与产线对账。",
consequence: "已下发未撤回的在途记录占用工位;下发失败可撤回(原因必填)或人工完成收口;撤回不回滚已报工实绩。",
overview:
'这个菜单做什么用:一台电表箱从工位 A 做完要去工位 B,靠什么"告诉"产线?就靠本页——把该工件要经过的「工位组合」(工位顺序清单)写入产线控制器(PLC),产线传送带据此只把工件送到组合内的工位,其余工位不停靠、不加工。\n\n页面分两个页签:「下发录入」(默认打开)、「下发记录」(点击才加载,可按产品工号/状态筛选)。\n\n日常操作流程:选产品工号 → 下拉选出该工单已上线未完工的工件 SN(也可扫码/手输)→ 系统按工件实际进度自动带出「当前工位」(只读)→ 工位组合由工单「工艺组合」按工位号升序自动派生 → 点「下发工位码」。做完一步、完成信号回来,再下发下一条——现场无需人记住顺序。\n\n发错了怎么办(两条收口路,都在「下发记录」页签):\n· 撤回:选错工件/工位,点「撤回」填原因,该条作废,可立即重发正确的。\n· 人工完成:工件实际已经流转到位、但 PLC 完成信号没回来(信号丢失/产线未接入),点「人工完成」现场收口,放行下一条。\n\n核心约束:系统遵循「上一条未收到完成信号,不下发下一条」,确保产线不串序;有在途未收口的下发时,看板会持续报警提醒收口。\n\n数据链路:工单(含工艺组合) → 本页下发到产线设备 → 产线设备驱动传送带/工位 → 收到完成信号(或人工完成)再下发下一条;每一步均留痕「操作日志」。',
fields: [
{ name: '产品工号', source: '下拉选择/输入。来自工单。', purpose: '当前生产的工单,选中后带出该工单可下发的工件 SN', fill: '选择或输入产品工号' },
{ name: '工件SN', source: '下拉选择(该工单已上线未完工的 SN,可搜索),也可扫码枪扫入手输。', purpose: '当前流经的工件唯一序列号', fill: '优先下拉选已上线 SN;扫码手输时须是已上线的工件才能带出当前工位' },
{ name: '当前工位', source: '自动带出(只读)。按所选工件的实际生产进度识别。', purpose: '从哪一站开始继续下发', fill: '无需填写;未带出说明工件未上线或 SN 有误' },
{ name: '工位组合', source: '由工单「工艺组合」按工位号升序自动派生,无需手选。', purpose: '该工件要经过的工位,产线设备控制停靠', fill: '如需调整路线,到「工单管理」编辑工单的工艺组合' },
{ name: '状态', source: '下发记录页签:已下发(在途)/已完成/已撤回。', purpose: '区分指令是否已收口', fill: '「已下发」长期挂着=产线有指令未收口,需撤回或人工完成' },
{ name: '撤回', source: '下发记录行内按钮,仅「已下发」可撤,原因必填。', purpose: '误下发(选错工件/工位)的纠错入口', fill: '点「撤回」→ 填原因 → 确认;撤回后可立即重新下发正确工位码' },
{ name: '人工完成', source: '下发记录行内按钮,仅「已下发」可用。', purpose: 'PLC 完成信号丢失/产线未接入时,现场确认工件已到位后人工收口,放行下一条', fill: '仅限现场确认实际已到位时使用,二次确认后状态置「已完成」' }
]
}
export const helpStation = {
title: '工位管理(工位总览)',
scope: "维护 station 主数据:启用状态、绑定工艺、可见页签;影响工单可选候选工位与 PLC 点位映射。",
consequence: "存在在制工单时改绑定工艺被硬拒;停用工位不能叫料/派车;工位号为内置主数据,不可删改号。",
overview:
'工位数以数据库为准。本页可新增工位与改名;每个工位在下方下拉选择启用的工艺即完成绑定;一个工位只能绑定一个工艺;内置工位不允许删除。\n\n工位分「内置」与「自定义」两类:内置工位由种子/初始化数据产生(数据库 is_builtin=true),对应实体产线位置,需与 PLC 通讯并按工位号顺序流转,不允许修改工位类型、不允许删除;自定义工位是在本页点击「新增工位」创建的,可修改类型、可删除。\n\n绑定关系即本页下拉:选择「启用」的工艺即完成绑定(工位号即顺序号);工单的执行路线由工单的「工艺组合」决定,本页只维护工位↔工艺绑定,不再有按日派工。\n\n停单/恢复:工人在工位终端自主停单/恢复,管理端在本页/日排产侧同步展示当日停单状态(只读)。\n\n数据链路:本页绑定工艺 → 工单勾选工艺组合 → 工位终端按绑定工艺的工艺步骤采集 → 报工按考核标准自动判 合格/不合格。',
fields: [
{ name: '工位号', source: '内置工位由系统预置;自定义工位由本页「新增工位」填写。', purpose: '产线物理工位编号,工位号即顺序号', fill: '新增时自定义,可与现有工位不连续(如 14、15…)' },
{ name: '工位名称', source: '可编辑。默认如 装配工位1。', purpose: '工位的显示名称', fill: '如 一号装配工位' },
{ name: '类型', source: '内置工位由系统给定且不可修改;自定义工位可改。', purpose: '线上位(连 PLC)/线下位(虚拟,不连 PLC)', fill: '内置工位只读;自定义工位可在编辑弹窗切换' },
{ name: '来源', source: '系统标识(数据库 is_builtin)。', purpose: '区分内置工位与自定义工位', fill: '只读' },
{ name: '接驳台', source: '内置数据给定(对应实体位置),不可手动更改。', purpose: '该工位位置是否有接驳台', fill: '只读' },
{ name: '接驳台编码', source: '系统预置(种子初始化),与工位 1:1。', purpose: '该工位绑定的接驳台唯一标识', fill: '只读;由种子初始化,页面不可更改' },
{ name: '绑定工艺', source: '本页下拉选择「启用」的工艺即完成绑定。', purpose: '该工位执行的工艺(决定工艺步骤/考核标准/PDF/物料清单);一个工位只能绑定一个工艺', fill: '在本页下拉为该工位选择启用工艺;工单执行路线由工单工艺组合决定' },
{ name: '终端可见页签', source: '本页「页签」按钮配置(station.visibleTabs)。', purpose: '该工位终端允许显示哪些功能页签(上线建档/作业/物料/产线点位(上料/下料)/工艺文件/巡检/下线完工),按工位差异化界面', fill: '点「页签」勾选;全部不勾 = 显示全部页签,保存后终端下次拉取任务生效' },
{ name: '删除', source: '本页操作。', purpose: '删除自定义工位', fill: '仅自定义工位可删除;内置工位不允许删除。注意:删除即退出工单工艺组合候选与终端工位下拉,历史报工记录保留但该工位不再可选;删除前确认无工单工艺组合引用' },
{ name: '虚拟工位', source: '工位维护页手动创建(类型选「线下位」)。原系统预置的 0/13 虚拟上下线位已废弃,不再预置。', purpose: '不连 PLC、仅记录上下线的辅助工位', fill: '只读;上线建档/下线完工改由工位终端「页签」配置(station.visibleTabs)决定哪些工位可显示该面板,任意授权工位均可操作' }
]
}
export const helpVirtualStation = {
title: '虚拟工位作业(MES 后台人工报工)',
scope: "在 MES 后台按工位号代录工序实绩 workpiece_process 与步骤考核,供无终端的线下/末端工位使用。",
consequence: "无接驳台工位不采集装配绑定、不校验齐套;代录实绩与终端报工等价,写错需按追溯人工对账,不可撤销。",
overview:
'虚拟工位 = 没有终端硬件(无屏、无 PLC、无拧紧枪)的工位(如包装等辅助工序,线下位类型)。这类工位无法用工位终端,由操作人用自己的手机/电脑登录 MES 后台,在本页完成作业:选择自己的虚拟工位 → 选工单、扫/输工件SN → 查看当前工艺步骤与应绑配料 → 逐项录入 → 点「完成报工」。\n\n与工位终端走同一套接口与校验(/station/task、/station/report):齐套校验、检测确认校验、不可倒序报工等规则完全一致;拧紧步骤因无硬件不在本页采集(由物理工位拧紧枪采集)。\n\n权限:菜单「虚拟工位作业」按账号开通(角色管理勾选 produce.virtualstation),不给普通账号开「工位管理」等管理菜单即可。',
fields: [
{ name: '选择虚拟工位', source: '下拉来自「工位管理」页维护的工位(建议给虚拟工序建线下位类型工位)。', purpose: '报工落在哪个工位(报工校验工位必须在工单工艺组合中)', fill: '选择自己负责的虚拟工位' },
{ name: '工单', source: '今日已启用日排产且工单已下发/在制(与终端口径一致)。', purpose: '本工位今天该干哪些工单', fill: '选择当前作业的工单' },
{ name: '工件SN', source: '上线建档时系统生成的工件唯一码(标签/二维码)。', purpose: '定位工件与所属工单,报工/绑定都挂在 SN 下', fill: '扫码或手输后回车载入' },
{ name: '工艺步骤', source: '工位绑定工艺的步骤模板(工艺页维护)。', purpose: '本工位要做什么、考核标准是什么', fill: '手填步骤逐项录入数值/结果;「检测确认」步骤需勾选;拧紧步骤由物理工位采集,本页只读' },
{ name: '配料', source: '工艺物料清单(flow_material)中该工艺要求装配的物料 + 已绑记录(bind-panel 接口)。', purpose: '装机绑定强校验:序列号=是需绑满单台用量 SN、序列号=否至少绑一个批次号,缺料不允许报工', fill: '在录入框填批次号/SN(多个用逗号分隔),随报工一次性提交' },
{ name: '完成报工', source: 'POST /station/report(与终端同一接口)。', purpose: '写实绩 + 步骤考核 + 装机绑定,原子提交', fill: '全部录入后点「完成报工」;报错按提示补齐' }
],
sections: [
{
title: '检测确认与操作工签字(业务说明)',
overview: '这两项是工艺步骤上的开关(在「工艺」页按步骤配置),决定操作员报工前必须完成什么。',
fields: [
{
name: '检测确认',
source: '工艺步骤上配置的开关(工艺页「工艺步骤」行开启),本工位该步骤需要操作员自检确认。',
purpose: '步骤的「自检关」:该步做完后,操作员须先点「检测确认」声明已按考核标准自检合格,才能继续报工、流转到下一工位。确认后系统记录确认人与时间,作为本步合格的前置证据;未确认则报工被拦截。',
fill: '在该步骤的「检测确认」按钮上点一下即可,不用填数值,只声明"我已自检"。'
},
{
name: '操作工签字',
source: '工艺步骤上配置的开关(工艺页开启),要求操作员在本步骤签字。',
purpose: '由本步骤的实际操作人(当前登录账号)签字,证明"这步是我做的、我确认合格"。签字按"操作工"身份留痕(谁签、何时签)。不签字则报工被拦截,工件不能流转到下一工位。',
fill: '报工前系统弹签字确认,默认当前登录人,点确认即可;签字是报工的前置条件,可与检测确认同时要求。'
}
]
}
]
}
export const helpSettings = {
title: '基础设置(系统管理员)',
scope: "写 sys_config 全局开关:借料、AGV 卸货超时、多工单缓存策略、拧紧手填等,保存即热生效。",
consequence: "关闭借料后超额叫料直接被拒;拧紧手填=禁止时终端输入框禁用;超时阈值影响预警扫描结果,改动对全站生效。",
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;先用「测试连通」验证再保存。注意:地址填错并保存后,库存查询/备料/完工回流会立即失败(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 天' },
{ name: '事件日志保留天数', source: '数字(sys_config: eventlog.retention.days,默认 0=不清理)。', purpose: '操作日志超期自动清理(每小时检查一次)', fill: '如 180 = 保留半年;0 = 永不清理' }
]
}
export const helpLineManagement = {
title: '产线管理',
scope: "维护 dock 接驳台与点位台账:启停、左右、托盘占用;AGV 派车与叫料空台校验都读这里。",
consequence: "停用接驳台硬拒叫料与派车;左右名称按工位奇偶口径,改错会送错台;工位无启用 line 台即视为虚拟位,不再采集绑定。",
overview:
'产线管理页集中查看产线实时点位并维护接驳台、纠正工件位置,分四块:\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: '工位托盘位 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: '产线类型(DOCKnn)自动派生所属工位,库房/其他不绑工位' },
{ 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: '行内「纠正」,二次确认后生效并记日志。注意:纠正动作不可在本页撤销——误纠正(PLC 其实没读到)会把在制工件标成「不在工位」,需重新上线建档或人工核对后处理;纠正前先到「PLC管理」确认传感器读数正常' },
{ name: '末端取件释放', source: '点位台账中 G11/G12 的占用记录(SN / 来源工单 / 占用时间)。', purpose: '人工确认末端工件已取走,释放点位占用', fill: '勾选记录 →「确认已取件」二次确认;无「产线管理」权限不可操作' }
]
}
export const helpAgv = {
title: 'AGV 配送',
scope: "写 agv_task 任务与回调状态,联动 WMS 配送单/出库单「已送达」与接驳台托盘台账。",
consequence: "到位不回调会让出库单停在待送达;取消/重试只改任务不改物料账;派车前点位或传感器不符按人工确认放行并留预警。",
overview:
'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: '点位管理(派车锁)', source: '派车成功系统自动锁目标点位(锁定原因=任务号),任务终态自动释放;JBT21 仅人工解锁。', purpose: '防止对同一接驳台重复派车撞车;强提标记点位派车需二次确认', fill: '列表「派车锁」列显示 锁定中/空闲 与锁定原因;行内「锁定/解锁」填原因留痕;「清强提」清除强提风险标记(现场确认安全后操作)' },
{ name: 'AGV任务', source: '系统生成。每次派车一个目标口生成一条任务。', purpose: '追踪每批料的搬运进度', fill: '状态:待下发 → 待搬运 → 搬运中 → 已到位/到位待令;「刷新状态」拉取 RCS 最新状态并驱动传感器自动放行(见上③);未终态任务可取消' },
{ name: '手动派车', source: '默认列「已发货」叫料单(仓库已完成备料)。', purpose: '补派或对失败任务重试', fill: '勾选行 → 行内可改目标接驳台 → 选源点 → 派车;目标点位被派车锁占用或带强提标记时会被拦截,按提示确认后放行;按目标口分组生成任务,操作人为当前登录账号' },
{ name: '多段链(下一个节点/结束任务)', source: '手动连送场景:第一段派车不指定车,之后每加一个节点锁定同一台车。', purpose: '一台车按人工指定的顺序连送多个点位', fill: '任务详情里点「下一个节点」选目标(可无限加段);全部送完点「结束任务」——结束前系统查 RCS 车辆状态,查询失败默认拒绝,可勾选「人工确认无托盘」强制结束(留痕)' }
]
}
export const helpTrace = {
title: '工件追溯',
scope: "只读聚合 workpiece 生命周期、工序时间线、步骤考核、装机绑定、拧紧、检验与关联追溯。",
consequence: "本页不修复数据;绑定缺失/扭矩 NG/报废状态在此暴露,须回对应业务页处置;未采集绑定工序显示原因而非判为缺料。",
overview:
'输入工件 SN,查它的完整履历:进线/完工时间、各工位时间线、步骤考核数据(扭矩/角度)、拧紧记录、以及它用了哪些批次号/序列号=是。\n\n「检验记录」页签只读展示该工件的过程检/完工检结论(合格/部分通过/不合格)、处置方式、相关标准/试验记录单号、记录人及附件(点文件名打开),无记录显示"无检验记录"。\n\n数据来源:全部由前端各环节自动写入(扫码报工、拧紧采集、产线设备下发、工位完成),本页只读查询。\n\n与「生产流程卡」分工:本页以 **SN(工件成品序列号)** 为入口做全链路追溯——装配物料绑定明细、装机绑定关系、暂存退库/重上线、检验记录等单件履历,适合查"某一台"的来龙去脉;生产流程卡以工单为主卡看工艺实绩/用料/签字,适合看"一整单"的进度。两页数据同源(均读工件实绩),按查询维度互补,不重复录入。\n\n入口说明:本页查询入口 SN 为**成品/工件序列号**(成品实例 SN);物料 SN 只在「装机绑定」页签里作为绑定值展示,不能作本页查询入口。',
fields: [
{ name: '工件SN', source: '扫码枪/手输。来自工件条码。', purpose: '要追溯的工件唯一序列号', fill: '扫 SN 或手动输入后点查询' },
{ name: '产品工号', source: '手动输入。筛选条件。', purpose: '按产品工号列出该工单下全部工件,再点行内「追溯」查看单个工件履历', fill: '可空;支持模糊匹配,回车即查' },
{ name: '报废/取走登记', source: '按钮操作(权限「工件-报废/取走登记」),原因必填。', purpose: '工件被人工从产线取走(报废/丢失/磕碰损伤/人工处理)时的收口入口:状态置「已报废」、永久退出产线、不计入在制,工单须以强制完工收尾;全程留痕生命周期流水与操作日志', fill: '先查询出该 SN → 点「报废/取走登记」→ 填原因 → 确认。注意与「暂存退库」互斥:退库=合法暂停(SEMI_STORED)可重上线,报废=永久退出不可恢复;已退库半成品请走 WMS 在库处置' }
]
}
export const helpAccount = {
title: '账号管理',
scope: "写 MES 用户与角色绑定,决定登录、菜单与按钮权限。",
consequence: "改角色即时影响该账号可见菜单与接口 403;禁用/删除账号不影响其历史操作日志;初始密码须督促首次修改。",
overview:
'管理可登录 MES 的账号:新建、编辑、停用,并为其分配角色(角色决定菜单与按钮权限)。\n建议只给操作员分配其工位所需菜单权限。系统内置 admin 账号不可修改/删除。',
sections: [
{
title: '列表',
fields: [
{ name: '状态', source: '行内开关。', purpose: '停用后该账号无法登录', fill: '直接拨动开关;内置账号(admin)已锁定' },
{ name: '工位终端/允许工位', source: '账号设置。', purpose: '是否允许登录工位终端及各终端允许的工位号', fill: '未开通=不能登录工位终端;允许工位留空=全部' }
]
},
{
title: '新建 / 编辑',
fields: [
{ name: '用户名', source: '手工填写。', purpose: '登录账号,唯一;创建后不可改', fill: '如 operator1' },
{ name: '密码', source: '手工填写,保存时加密存储。', purpose: '登录密码', fill: '≥6位且不能纯数字;编辑时留空=不修改' },
{ name: '姓名', source: '手工填写。', purpose: '真实姓名,操作日志追溯用', fill: '如 张三' },
{ name: '角色', source: '下拉选择。来自"角色管理"页。', purpose: '决定该账号的菜单与功能权限', fill: '选择已建角色' },
{ name: '状态', source: '下拉选择。', purpose: '停用后无法登录', fill: '启用 / 停用' }
]
}
]
}
export const helpRole = {
title: '角色管理',
scope: "写角色 permissionCodes,RBAC 菜单与接口按码鉴权。",
consequence: "缩减权限码会立即使对应菜单/按钮消失或接口 403;admin 在 seed 时强制拥有全部权限;自建角色不被种子并集补授覆盖。",
overview:
'角色决定账号能看哪些菜单(勾选菜单)与能用哪些功能(勾选其下按钮),勾选互不影响。\n内置角色:超级管理员(全部权限)、生产操作员、质检员——不可删除;超级管理员权限不可编辑。',
sections: [
{
title: '新增 / 编辑权限',
fields: [
{ name: '角色名称', source: '手工填写。', purpose: '角色中文名', fill: '如 库房管理员' },
{ name: '角色编码', source: '手工填写。', purpose: '角色唯一编码,创建后不可改', fill: '如 intro-manager' },
{ name: '权限树', source: '勾选。来自系统预置的权限菜单与按钮。', purpose: '决定该角色可见菜单与可用按钮', fill: '勾选菜单=可见;勾选按钮=可用(两者独立)' }
]
}
]
}
export const helpEventLog = {
title: '操作日志',
scope: "只读审计 event_log,记录登录、建档、报工、下发、拧紧、报废等动作与操作人。",
consequence: "日志只追加不可编辑;冒名留痕被 security.impersonation 记录;日志缺失时无法回溯责任,排查须配合业务表。",
overview:
'审计查看关键业务操作(工单/日排产/物料清单/备料/下发/拧紧/扫码报工/完工等),由系统自动写入,本页只读。\n支持按业务域类型、产品工号、操作人、时间范围筛选,分页查看。',
sections: [
{
title: '查询区',
fields: [
{ name: '事件类型', source: '下拉。', purpose: '按业务域过滤(工单/日排产/报工…)', fill: '选一族或留空=全部' },
{ name: '产品工号', source: '输入。', purpose: '只看某工单的全部操作', fill: '可空=全部' },
{ name: '操作人', source: '输入。', purpose: '只看某人的操作', fill: '可空=全部' },
{ name: '时间范围', source: '日历选择。', purpose: '限定发生时间区间', fill: '不选=全部时间' }
]
}
]
}
export const helpProcessFlow = {
title: '工艺(作业指导,含工艺步骤与物料清单)',
scope: "维护工艺定义、步骤与工艺物料清单 flow_material,是工单路线、步骤考核与装机应绑清单的源头。",
consequence: "有未完成工单引用时工艺定义与明细禁改;改物料清单会即时改变备料算料与应绑数量;删步骤会影响流程卡与报工考核。",
overview:
'页面分「工艺列表」「工艺配置」两个页签:列表查看全部工艺并做启用/停用/删除;配置页维护工艺基本信息、工艺步骤与物料清单(新增与编辑共用,不再弹窗套弹窗)。\n\n工艺 = 一份「菜谱」:只描述某个产品该怎么装配(工艺步骤名、采集方式、考核标准、所需物料),可被多个工位绑定,不隶属某个工位。\n\n概念统一说明:\n· 工位:产线上的物理工位(工位数以数据库为准),工位号即顺序号,相当于「灶台」。\n· 工艺:一份作业指导(PDF + 工艺步骤 + 物料清单);其启用状态决定是否参与生产。\n· 工艺步骤:工艺内包含多个步骤(如:装配完成、拧紧扭矩、测试)。\n· 物料清单:该工艺装配所需物料(物料编码/名称/规格/单位/序列号/单台用量/损耗率),整表覆盖保存。\n\n绑定关系在「工位绑定」页维护:为某工位选择启用的工艺即绑定;一个工位只能绑定一个工艺。工单在「工单管理」勾选「工艺组合」确定执行路线(工位号升序)。\n\n数据链路:本页维护工艺+工艺步骤+物料清单+考核标准 → 工位绑定页绑定 → 工单勾选工艺组合 → 工位终端按工艺步骤采集 → 报工按考核标准自动判 合格/不合格 → 工件追溯/绩效报表可见。',
sections: [
{
title: '工艺基本信息',
fields: [
{ name: '工艺名称', source: '手工填写。人为定义。', purpose: '工艺名,用于区分与绑定展示', fill: '如 总装工艺 / 总装工艺_2026版' },
{ name: '状态', source: '下拉选择 启用/停用。也可在列表操作列点「启用/停用」快捷切换。', purpose: '启用=该工艺可被「工位绑定」页绑定到工位并参与生产;停用=不可绑定、不参与生产', fill: '启用后可在「工位绑定」页绑定到工位;停用后不可绑定' },
{ name: '作业指导PDF', source: '本页上传。文件由 MES 服务器保存。', purpose: '该工艺的作业指导图,工位终端打开预览', fill: '选择 PDF 上传,成功后显示文件名可预览' },
{ name: '工艺步骤', source: '本页维护(步骤名/采集方式/考核标准/签字)。', purpose: '工位终端报工时按此动态渲染参数输入', fill: '一个工艺可含多个工艺步骤,按序号顺序执行' },
{ name: '操作工签字确认', source: '每个工艺步骤开关。开启后该步骤要求「操作工签字」。', purpose: '签字机制第一签:操作工报工前须在本步骤签字确认,否则报工被拦截', fill: '在步骤行打开开关;报工时工位终端弹「签字确认」采集签字人,签字记录按「操作工」身份留痕' },
{ name: '检验员签字确认', source: '每个工艺步骤开关。开启后该步骤要求「检验员签字」。', purpose: '签字机制第二签:该步骤须由检验员在巡检终端「待签任务」页签签字确认,流程方可放行', fill: '在步骤行打开开关;操作工签字后,检验员到【巡检终端-待签任务】逐行「签字确认」,签字记录按「检验员」身份留痕,需开通「巡检-签字确认」权限' },
{ name: '步骤附件/图纸', source: '每个工艺步骤单独上传(绑定式)。文件由 MES 服务器保存。', purpose: '把图纸精确绑定到具体步骤,工位终端按当前步骤自动展示对应图纸', fill: '在步骤行上传该步骤图纸/附件(可多个);随步骤自动分发到工位终端' },
{ name: '物料清单', source: '本页维护:物料编码(下拉选择,取自物料档案)/名称/规格/单位/序列号/单台用量/损耗率%,整表覆盖保存。', purpose: '该工艺装配所需物料;备料需求 = 各工位分产量 × 单台用量 × (1+损耗率%)', fill: '物料编码取自物料档案编码(结构件通常即图号),选中后名称/规格/单位/序列号自动带出、不可改;序列号来自物料档案:序列号=是(录SN)/序列号=否(不录SN)。注意:保存=整表覆盖,被删行不保留且不可恢复;已据旧清单备料/出库的工单不受追溯影响,但下次备料按新清单算' }
]
},
{
title: '采集方式(每个工艺步骤四选一)',
overview: '决定该步骤的数值从哪里来。',
fields: [
{ name: '拧紧枪自动', source: '拧紧枪设备自动回传。', purpose: '扭矩/角度等由拧紧枪采集,工人无需手输', fill: '选「拧紧枪自动」即可,无需再开其他开关(2026-10-19 起「是否拧紧」开关已删除,采集方式即唯一口径)' },
{ name: '手填', source: '工人在工位终端手动输入数值。', purpose: '无法自动采集的参数(如尺寸、电压)由人工录入', fill: '选「手填」' },
{ name: '扫码', source: '工人用工位终端扫码枪/扫码框采集一串字符串。', purpose: '与「手填」等价(不区分二维码/条形码),只是录入方式改为扫码,采到的是一串字符串', fill: '选「扫码」,报工时扫入即可' },
{ name: '仅记录', source: '无数据,只做操作步骤确认(如"装配完成")。', purpose: '记录该步骤已执行,不采集数值、不判定', fill: '选「仅记录」' }
]
},
{
title: '考核标准(每个步骤可设多条)',
overview: '用于报工时自动判定该步骤「合格/不合格」。在哪用:工位终端提交该步骤数值时,系统按此标准判 合格/不合格,结果进入工件追溯与流程卡。如何收集:数值来自上面的采集方式(拧紧枪自动或手填)。',
fields: [
{ name: '指标名', source: '人为定义。', purpose: '标准叫什么(如 扭矩/角度/尺寸)', fill: '如 扭矩' },
{ name: '单位', source: '人为填写。', purpose: '数值单位', fill: '如 N·m、°、mm' },
{ name: '逻辑', source: '下拉选择 ≥/≤/>/</区间/=。', purpose: '判定关系', fill: '区间需填上下限;其余填目标值' },
{ name: '目标值/下限/上限', source: '人为填写。', purpose: '合格范围', fill: '如 扭矩区间 [35,45] N·m' }
]
}
]
}
export const helpPerformance = {
title: '绩效报表(工人工作量统计)',
scope: "按报工实绩与拧紧/质检结果汇总合格数、上机时长、损耗,只读。",
consequence: "损耗只有在 WMS 退库确认填写原因才落账并在本页体现;未报工/未完工的数据不进入统计;日期口径按报工时间。",
overview:
'按 操作人 × 日期 × 工位 × 产品工号 汇总报工实绩,用于工作量与绩效统计。\n\n页面提供「按人 / 按工位 / 明细 / 上机记录」四个页签:按人看每人汇总,按工位看每工位汇总,明细按 操作人×日期×工位×工艺×产品工号 展示(含工序名、产品工号);上机记录展示每次开工签到对应的 上机时间/下机时间/在机时长/加工件数/效率。各视图均受上方筛选条件约束(上机记录页签不支持产品工号筛选)。\n\n筛选与导出:支持 操作人 / 工位 / 产品工号 / 日期范围 组合筛选(默认近 90 天);顶部汇总卡随查询刷新;「导出 xlsx」一次导出四个 sheet(按人/按工位/明细/上机记录),导出遵循统一时间硬规则(时间范围为空默认近 3 个月、只传一端报错、跨度超 1 年报错)。\n\n数据来源:全部由工位终端的「工位完成上报」自动写入报工实绩(workpiece_process),本页只读统计,不手工录入;上机记录由 开工签到(inspection_record CHECKIN) + 报工实绩 推导,未签到的作业不会出现在上机记录中。',
fields: [
{ name: '操作人', source: '筛选条件。来自报工实绩的 operator 字段(工位终端登录人)。', purpose: '只看某个工人的工作量', fill: '输入姓名/账号,可空=全部' },
{ name: '工位', source: '下拉选择(工位数以数据库为准)。', purpose: '只看某个工位的报工情况', fill: '可空=全部工位' },
{ name: '产品工号', source: '手动输入。筛选条件,取自报工实绩所属工单。', purpose: '只看某个工单的作业量与效率', fill: '可空=全部工单;支持模糊匹配,导出同样生效' },
{ name: '日期范围', source: '筛选条件。来自报工实绩的产生时间,默认近 90 天。', purpose: '按时间段统计', fill: '选择起止日期;导出时同一范围' },
{ name: '完成数', source: '自动汇总。该 操作人×日期×工位 的报工次数。', purpose: '工作量核心指标', fill: '只读' },
{ name: '合格数/不合格数', source: '自动汇总。按报工实绩 result 字段(合格/不合格)分类计数。', purpose: '质量指标,合格+不合格=完成数', fill: '只读' },
{ name: '合格率', source: '自动计算 = 合格数/完成数。', purpose: '质量表现', fill: '只读' },
{ name: '平均作业时长', source: '自动计算 = 累计作业时长 ÷ 完成数(取自报工实绩 duration_sec)。', purpose: '衡量单件平均耗时', fill: '只读' },
{ name: '效率(件/小时)', source: '自动计算 = 完成数 ÷ (累计作业时长/3600)。', purpose: '衡量单位时间产出', fill: '只读' },
{ name: '上机时间(签到)', source: '上机记录页签。取开工签到(CHECKIN)记录时刻,来自巡检终端/工位终端提交。', purpose: '本次上机起点', fill: '只读' },
{ name: '下机时间(最后活动)', source: '上机记录页签。签到后该人该工位最后一条活动(报工完成/巡检提交)的时间;以同工位同人下一次签到为界。', purpose: '本次上机终点(最后活动推断,非关机时刻)', fill: '只读' },
{ name: '在机时长', source: '上机记录页签。自动计算 = 下机时间 - 上机时间。', purpose: '单次上机持续时长', fill: '只读' },
{ name: '加工件数', source: '上机记录页签。窗口内的报工实绩计数。', purpose: '本次上机的产出', fill: '只读' }
]
}
export const helpInspect = {
title: '巡检终端(PAD / PC 通用)',
scope: "写巡检记录与巡检退料单,退料须 WMS 确认收货后回补库存。",
consequence: "损耗原因必填;传感器检到托盘(工件未完工)时退料被硬拒;巡检记录不可事后改写,只能新增。",
overview:
'检验员/线长用手持平板(PAD)或电脑浏览器做巡检与检验确认,PC 与 PAD 访问同一地址、前端自适应。\n\n数据来源:全部记录提交后写入 MES 巡检记录表(inspection_record),用于追溯和流程卡输出,也可在看板触发报警。\n\n「待签任务」页签:集中展示「操作工已签字、待检验员签字确认」的工艺步骤(签字机制),检验员在此做第二签(签字确认),无需到工位终端。\n\n「完工检」页签:质检员从此处录入完工检——展示「待完工检成品」清单(完工确认后未录完工检的成品 SN),选 SN 后填试验记录单号/相关标准并判定合格/部分通过/不合格,保存后合格自动回流入 WMS 库;操作工只需在「完工确认」页签声明生产完成,不录完工检。\n\n权限:菜单「巡检终端」+ 各功能独立按钮权限码(sys.inspect:checkin/point/process/done/alarm/view/sign),由【角色权限管理】统一分配。操作工通常无此菜单。',
sections: [
{
title: '打开方式(PAD / 手机独立访问)',
overview:
'电脑端:左侧菜单「巡检终端」打开。\n\nPAD / 手机独立打开:在浏览器地址栏输入\n' +
window.location.origin + '/inspect\n' +
'(如上所示即本机当前访问地址,例如 http://192.168.1.100:8888/inspect)。\n\n' +
'首次打开会跳转登录页,登录一次后(浏览器记住登录态)再次打开将直接进入巡检页;PAD 与电脑需在同一局域网。\n\n' +
'功能按权限显示:无「巡检终端」菜单或按钮权限的账号无法使用。',
fields: []
},
{
title: '开工签到',
fields: [
{ name: '班次', source: '手动选择(早/中/晚)。', purpose: '记录开工班次', fill: '选早/中/晚' },
{ name: '拍照', source: '调用浏览器相册/摄像头(input file capture)。照片上传到 MES 服务器。', purpose: '留证现场开工状态', fill: '点击拍照并上传' },
{ name: '提交', source: '提交时自动记录:时间、拍照人(登录账号)、工位号。', purpose: '形成签到记录,供追溯', fill: '选班次+拍照后提交' }
]
},
{
title: '工位点检',
fields: [
{ name: '工位号', source: '手动选择(工位数以数据库为准)。', purpose: '点检哪个工位', fill: '选 1~12' },
{ name: '点检项', source: '手动多选(设备运行正常/安全防护到位/工具齐全/工位清洁)。', purpose: '点检的项目清单', fill: '勾选已完成的项目' },
{ name: '拍照', source: '浏览器相册/摄像头上传。', purpose: '留证', fill: '拍照上传' }
]
},
{
title: '过程巡检(按步骤逐条提交)',
overview:
'选择工单后,系统自动拉出该工单「工艺组合」里每个工位对应工艺的工艺步骤,逐步骤填报巡检结果——与工位终端的执行顺序一致,确保每一步都有检验留痕。\n\n全部步骤提交完成后,点「一键生成《工序间检验记录》」,系统把该工单的 PROCESS 类巡检按步骤汇总成一张可核对/打印的记录表。',
fields: [
{ name: '产品工号', source: '手动选择/搜索。来自【工单管理】已建工单。', purpose: '对哪个工单巡检', fill: '搜索选择产品工号' },
{ name: '步骤列表', source: '自动带出:该工单工艺组合 → 各工位绑定工艺的工艺步骤。', purpose: '逐步骤填报,避免漏检', fill: '只读,系统自动展开' },
{ name: '实测值', source: '手动填写该步骤的实测数据。', purpose: '留存检验实测量', fill: '按步骤要求填写' },
{ name: '合格/不合格', source: '手动选择。', purpose: '该步骤的巡检结论', fill: '选择合格或不合格' },
{ name: '签字', source: '输入检验人姓名。', purpose: '检验人签字留证', fill: '输入签字内容' },
{ name: '生成《工序间检验记录》', source: '一键汇总。', purpose: '输出该工单的工序间检验汇总记录', fill: '全部步骤提交后点击' }
]
},
{
title: '完工确认',
overview: '完工确认=生产完成;完工检合格后成品自动入 WMS 库(已通过→合格,部分通过→合格,不合格→不入库待返修)。此处确认仅声明生产完成,不再直接触发入库。',
fields: [
{ name: '产品工号', source: '手动选择/搜索。来自【工单管理】。', purpose: '确认哪个工单全部工位完成', fill: '搜索选择产品工号' },
{ name: '确认全部工位完成', source: '手动勾选。', purpose: '声明该工单全部工位已完成', fill: '勾选确认' },
{ name: '签字', source: '手写/输入。', purpose: '确认人签字留证', fill: '输入签字内容' }
]
},
{
title: '异常上报',
fields: [
{ name: '工位号', source: '手动选择(工位数以数据库为准)。', purpose: '异常发生在哪个工位', fill: '选 1~12' },
{ name: '异常类型', source: '手动多选(设备故障/物料异常/工艺偏差/安全隐患/其他)。', purpose: '异常分类', fill: '勾选异常类型' },
{ name: '拍照', source: '浏览器相册/摄像头上传。', purpose: '留证异常现场', fill: '拍照上传' },
{ name: '文字描述', source: '手动填写。', purpose: '异常详细说明', fill: '描述异常情况' }
]
},
{
title: '待签任务(签字确认)',
overview:
'集中展示「操作工已签字、待检验员签字确认」的工艺步骤(按 产品工号+SN+工位+步骤 聚合)。此处签字 = 检验员第二签:操作工报工前已在工位终端/虚拟工位签字确认,检验员逐行点「签字确认」(可填意见),确认后该步骤的检验员签字落库,流程方可放行。需开通「巡检-签字确认」按钮权限(sys.inspect:sign)。',
fields: [
{ name: '产品工号/SN/工位', source: '来自步骤签字记录,按 产品工号+SN+工位+步骤 聚合。', purpose: '定位待签任务', fill: '只读' },
{ name: '步骤', source: '工艺步骤名称(该步骤配置了「需检验员签字」)。', purpose: '待检验员签字的步骤', fill: '只读' },
{ name: '操作工签字', source: '操作工报工前的签字留痕(签字人与签字时间)。', purpose: '第一签留证', fill: '只读' },
{ name: '签字确认', source: '弹窗确认后提交,系统记录检验员签字与签字时间。', purpose: '检验员第二签,流程放行', fill: '可填意见,成功提示「已签字」' }
]
},
{
title: '记录查看',
fields: [
{ name: '类型/操作人/日期', source: '筛选条件。来自巡检记录表各字段。', purpose: '过滤历史巡检记录', fill: '可空=全部' },
{ name: '图片', source: '提交时上传的照片,MES 服务器存储。', purpose: '点击缩略图放大查看留证照片', fill: '只读' }
]
}
]
}
export const helpProcessCard = {
title: '生产流程卡(工单维度主卡)',
scope: "按工单生成/导出流程卡(工序实绩、用料、成品明细、签字区),支持 PDF / Excel / 打印版。",
consequence: "导出单次 ≤100 张;范围为空不能确认;流程卡是报工实绩的投影,报工漏录会直接反映为缺项。",
overview:
'本页以**工单**为唯一主键,展示该工单的「生产实绩 / 追溯卡」:工序实绩、用料清单(序列号=是/序列号=否两组,物料类型取自 WMS 物料档案)、成品明细与签字确认;并保留成品 SN 维度的追溯子视图。\n\n页面为**单页布局**(原"流程卡列表 / 流程卡详情"两个页签已合并):主视图是流程卡列表(支持产品工号 / 产品型号 / 成品SN 关键字筛选),点行内「详情」在右侧抽屉打开完整卡片;工具栏的「SN追溯卡」输入框用于按成品 SN 直接查追溯卡。\n\n备份/导出(客户习惯叫"备份",即导出文件保存到本机,与「数据归档」的数据库备份是两回事):\n· 格式三选一:PDF(新窗口打开排版好的 A4 版式,浏览器里另存为 PDF)、Excel(CSV,双击即用 Excel 打开)、打印版(新窗口打开并直接弹出打印对话框);\n· 单张:详情抽屉右上角「导出」;\n· **批量**:在列表中勾选多张卡,点工具栏「备份导出」→ 范围可选"已勾选 N 张"或"当前筛选结果全部" → 确认。PDF/打印版会把多张卡合并到一个新窗口(每张卡独占一页);Excel 合并为一个 CSV 文件。单次最多 100 张。\n\n概念统一:物料「序列号」(序列号=是逐件录 SN / 序列号=否按批)两维严格分离,用料清单按两组分别展示;数据来自装配实绩(工位终端装机绑定 workpiece_bind)。\n\n签字区:操作工 / 检验员 / 审核人 按实际签字人展示(含签字次数与最近时间),单据级「批准人」留手签空位,系统不代填、不加字段。\n\n分工:本页是**工单维度主卡**(看一整单的工艺实绩/用料/签字);单件 SN 全链路履历(含装机绑定、装配物料绑定明细、暂存退库、检验记录)由「工件追溯」页按 SN 入口提供。两者数据同源,按"查整单进度"还是"查单件履历"互补选择。',
fields: [
{ name: '产品型号', source: '筛选输入框。', purpose: '按型号过滤流程卡列表(可配合工号/SN 关键字)', fill: '回车或点查询' },
{ name: '产品工号', source: '筛选输入框。', purpose: '过滤某工号;点行内「详情」看完整主卡', fill: '回车或点查询' },
{ name: '成品SN/关键字', source: '筛选输入框。', purpose: '按成品 SN 或关键字过滤列表', fill: '回车或点查询' },
{ name: 'SN追溯卡', source: '工具栏输入框。', purpose: '按成品 SN 直接打开追溯卡(逐件追溯工序/用料/拧紧/签字)', fill: '输入 SN 回车,抽屉展示' },
{ name: '备份导出', source: '列表工具栏按钮 + 详情抽屉「导出」按钮。', purpose: '单张/批量把流程卡备份为 PDF / Excel / 打印版文件', fill: '勾选多张 → 点「备份导出」→ 选格式与范围 → 确认;范围可选"已勾选 N 张"或"当前筛选结果全部"' },
{ name: '工序实绩-审核人', source: '自动带出该工序的审核签字人及审核时间。', purpose: '工序级审核放行留痕', fill: '无则显示“-”' }
]
}
export const helpAudit = {
title: '待审核签字(工序级审核)',
scope: "工序级签字审核,审核通过/驳回写入审核记录并影响报工放行。",
consequence: "未审核签字的步骤不允许报工流转;驳回需重做步骤再提交;审核记录留操作人与时间。",
overview:
'本页是审核人的「待审任务」工作台:列出已满足前置签字条件的工艺步骤(操作工已签字;若该步骤配置了「需检验员签字」则检验员须 OK),由具审核角色(如班组长/工艺员)的人员复核。\n\n审核定位在**工序级、由工艺配置决定**:工艺步骤是否需审核及其审核角色在「工艺」页配置。\n\n两种操作:\n· 审核通过 → 该步骤放行;\n· 退回重做 → 撤销该步骤已有的操作工/检验员签字,退回操作工重做(进入新一轮签字)。\n\n审核只记录「审核人 + 审核时间」,不引入签名图片;签字区在「生产流程卡」页照实展示。',
fields: [
{ name: '产品工号 / 工件SN', source: '筛选条件。', purpose: '缩小待审范围', fill: '可空=全部' },
{ name: '操作工 / 操作工签字时间', source: '自动带出该步骤操作工签字人及时间。', purpose: '审核前确认是谁做的', fill: '只读' },
{ name: '审核通过', source: '按钮。提交「通过」结论。', purpose: '审核放行', fill: '点击即生效并刷新列表' },
{ name: '退回重做', source: '按钮。需填退回原因,提交「退回」结论。', purpose: '审核不通过,退回操作工重做', fill: '撤销该步骤已有签字,进入新一轮' }
]
}
export const helpProductProcess = {
title: '产品工艺(产品级工艺定义)',
scope: "维护产品级工艺定义与工序顺序,工单建单时选一份并锁定。",
consequence: "有未完成工单引用时定义与明细一并禁改;改工序顺序会改变下游候选工位与流程卡步骤;已开工工单需走转产流程。",
overview:
'本页定义"某个产品该按什么顺序经过哪些工艺":一条产品工艺 = 某产品 + 有序的工艺清单(选择顺序即执行顺序)。\n\n与「工艺」页的关系:工艺(工位级流程图+工艺步骤)描述"一个工位怎么干",是本页的组成单元;产品工艺把它们按产品组织起来,只选工艺和顺序、**不绑工位**。\n\n与工单的关系:新建工单选完产品后自动带出默认产品工艺,并把每道工艺当前绑定的全部启用工位自动填入工单「工艺组合」——组合是快照、可手动增删;与产品工艺的个数/顺序不符时保存会有**警告提示(不阻断)**。工单保存后与产品工艺互不影响。\n\n约束:同一工艺不能在同一产品工艺内重复;每个产品可建多条(如常规/高配);被工单引用过的产品工艺**只读**(禁编辑禁删),只能停用+新建,历史工单可反查当时定义。列表"可执行"列实时反映工位绑定情况:某道工艺暂无启用的绑定工位、或工位顺序冲突时显示"待就绪"及原因。',
fields: [
{ name: '产品', source: '下拉选择,来自「物料档案」(WMS 物料主数据)。', purpose: '这条产品工艺属于哪个产品', fill: '必选' },
{ name: '工艺名称', source: '手工填写。', purpose: '区分同产品的多条产品工艺(如 常规/高配)', fill: '必填' },
{ name: '工艺顺序', source: '先勾选「加入」,再用上移/下移按钮排顺序(列表从上到下=执行顺序)。', purpose: '该产品依次经过哪些工艺', fill: '至少一道;同一工艺不可重复加入' },
{ name: '路线卡', source: '按钮。服务端渲染可打印 HTML(新窗口打开,可另存为 PDF)。', purpose: '产品级定义层卡:工艺路线+各工艺步骤配置(含审核开关)+物料清单+检验卡项', fill: '只读展示当前定义;工单实绩看「生产流程卡」' },
{ name: '可执行', source: '实时反查「工位绑定」:每道工艺是否有启用的绑定工位、顺序是否可满足。', purpose: '保存前预检,建工单时不会推导出残缺组合', fill: '只读;待就绪时悬停看原因' },
{ name: '被工单引用', source: '统计 product_process_id 指向本条的工单数。', purpose: '只读守卫提示', fill: '>0 时禁编辑/删除,只能停用' }
]
}
export const helpQuality = {
title: '质量检验(过程检 / 完工检)',
scope: "写 inspection_record 过程检/完工检(FINAL)结论,关联工件 SN 与工单。",
consequence: "完工检不合格会阻断成品回流 WMS;检验记录不可删除,复检以新记录覆盖判定;无终端的末端工位检测结论在此登记。",
overview:
'质量检验 = 对物料/产品做检验判定并留痕,分「过程检」与「完工检」两个 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: '一般无需手填' },
{ name: '报检单号', source: '系统自动生成(RQ+时间戳),可改。', purpose: '本次报检的唯一编号,也是附件挂靠键', fill: '一般无需改,须唯一' },
{ name: '生产厂家', source: '手工填写。', purpose: '该物料的生产/供货厂家', fill: '如 XX电气有限公司' },
{ name: '检验单号', source: '手工填写。', purpose: '对应的检验单据编号', fill: '如 INS-2026-001' },
{ name: '成品SN', source: '手工填写/扫码(仅完工检必填)。来自完工检页签「待完工检成品」列表。', purpose: '完工检合格后按该 SN 自动回流入 WMS 库,并从待完工检清单排除', fill: '从「待完工检成品」列表取 SN 扫码或手输' },
{ name: '相关标准(试验方案号)', source: '手工填写(仅完工检)。', purpose: '产成品入库时随回流 WMS 的相关标准/试验方案号', fill: '选填,可空' },
{ name: '试验记录单号', source: '手工填写(仅完工检)。', purpose: '产成品入库时随回流 WMS 的试验记录单号', fill: '选填,可空' },
{ name: '附件', source: '上传登记(bizType=quality,bizId=报检单号)。', purpose: '检验报告/照片等佐证材料', fill: '选择文件上传,可多个' },
{ name: '检验结论', source: '人工判定。', purpose: '合格(OK)/部分通过(PARTIAL,仅完工检)/不合格(NG);完工检合格后成品自动入 WMS 库(已通过→合格,部分通过→合格,不合格→不入库待返修)', fill: '单选' },
{ name: '待完工检成品', source: '系统自动汇总:完工确认(DONE)且尚无完工检记录的成品 SN(只读分页,完工时间倒序)。', purpose: '完工检的工作队列:待检的成品一览,录入完工检后自动移出', fill: '只读;完工检页签展示' },
{ name: '处置方式', source: '不合格时选择。', purpose: '退货/返修/退换/报废', fill: '仅不合格需填' },
{ name: '处置说明', source: '手工填写。', purpose: '补充处置细节', fill: '可空' }
]
}
export const helpWip = {
title: '在制品(跨天在制视图)',
scope: "只读跨天在制视图,按工位/工单展示未完工工件与当前工序。",
consequence: "本页不推进状态;工件长期停留通常由未报工/未移料/扭矩 NG 未处置造成,须回终端处理。",
overview:
'在制品 = 已进线但尚未完工的工件,跨天继续停留在此列表中。\n\n数据来源:MES 工件实时状态(GET /workpieces/in-process)。\n\n工件六态生命周期(单字段 workpiece.status 直接流转):新建 NEW → 已上线 ONLINE(唯一触发=上线建档)→ 在制 PROCESSING(报工)→ 下线完工按成品工艺是否走完分流:走完=完工 DONE、未走完=半成品入库 SEMI_STORED(入库一次解锁一次、可再次上线循环);报废 SCRAPPED 仅由质检处置触发。\n\n工位说明:工位 1~12 为实体物理工位(工位数以数据库为准);原虚拟位 0/13(上线位/下线位)已废弃,降级为普通虚拟工位;上线建档与下线完工由工位终端「页签」配置(station.visibleTabs)驱动,可在任意授权工位执行,不再绑定特定工位号。\n\n与日排产的关系:已进线未完工的工件跨天继续,日排产仅排「未开工数量」,不会重复排产。停留时长自进线起算,便于发现滞留件。',
fields: [
{ name: '产品工号', source: '手动输入。筛选条件。', purpose: '只看某个工单的在制品', fill: '可空=全部;支持模糊匹配,回车即查' },
{ name: '当前工位', source: '按工件状态与工位组合推算。', purpose: '工件此刻停在哪一工位', fill: '只读,可筛选' },
{ name: '状态', source: '系统维护(六态单字段)。', purpose: '新建/已上线/在制/半成品入库/完工/报废', fill: '只读,可筛选' },
{ name: '进度', source: '已完成步骤数 / 工艺组合总步骤数。', purpose: '看该件走到第几步', fill: '只读' },
{ name: '停留时长', source: '自上线时间起算。', purpose: '发现长时间滞留的在制品', fill: '只读' }
]
}
export const helpAlertCenter = {
title: '预警中心(系统自动触发)',
scope: "聚合 PLC 对账、AGV 卸货超时、设备失联、传感器不符等自动预警,支持已读/处置留痕。",
consequence: "预警只提示不自动补偿业务数据;未处置预警会持续累积;断电恢复开机 15 秒后自动对账会新增 boot 来源预警。",
overview:
'预警中心汇集全系统自动产生的异常/提醒消息,人工无需配置规则——全部由内置触发源自动落库并推送。顶部铃铛角标显示未读数,点击进入本页处理。\n\n八类内置触发源:\n· 扭紧不合格(torque_ng):拧紧扭矩/角度超考核标准时自动告警。触发点=拧紧枪完成拧紧后由工位终端自动上报拧紧结果时(拧紧采集落库后约15秒内自动上报;终端离线时缓存在终端、恢复后补报),不依赖操作工点「保存/完成报工」;\n· 检验不合格(inspection_ng):质量检验判定 NG 时告警;\n· 备料未齐套(material_shortage):工单装机绑定物料未齐套时告警;\n· 库存偏低(inventory_low):可用量低于安全库存时告警;\n· 工单超时(task_overdue):工单超过完成日期未完工时告警;\n· 缓存位满(cache_full):产线缓存/接驳台占满时告警;\n· 数量不符(qty_diff):工位收料实收≠应发时告警(MES 仅预警,明细由 WMS 处理);\n· 应急呼叫(emergency_call):工位终端现场发起的紧急呼叫。\n\n应急呼叫闭环:操作工在工位终端点「应急呼叫」(设备故障/质量异常/缺料/安全等紧急情形)→ 系统即时落一条 type=emergency_call 的未读预警并通过 SSE 推到大屏/看板 → 线长、维修、仓库等相关人员在本页看到未读告警并到场处置 → 处置完点「标记已读」闭环。\n\n处理流程:按 状态(全部/未读/已读)、预警类型、开始时间(默认当天)、结束时间(默认不限)筛选并分页浏览,核实后点行末「标记已读」;已读记录留存备查。\n\n拧紧不合格处置闭环(type=torque_ng):该预警出现即代表对应 SN 工件被标记「待人工处置」,此间该件后续报工与下线完工均被系统拦截(须先处置)。质检/班组长在工件追溯页或本页(torque_ng 项行末「确认放行」)填处置原因确认放行 → 清工件标记(恢复可报工/完工)、写操作日志(记录谁/何时/原因)、并将该 torque_ng 预警置为已读闭环。返修线下处理,系统不建返修工单。注意:重拧合格不会自动清标记,必须经「确认放行」人工处置。',
fields: [
{ name: '状态', source: '系统维护(未读/已读)。', purpose: '区分待处理与已处理预警', fill: '筛选项单选:全部/未读/已读' },
{ name: '预警类型', source: '内置触发源自动写入。', purpose: '只关注某一类异常', fill: '下拉选择八类之一,留空=全部' },
{ name: '产品工号', source: '触发预警时自动关联(如拧紧不合格按其 SN 反查所属工单)。', purpose: '按产品工号排查该工单相关的所有预警', fill: '可空=全部;支持模糊匹配' },
{ name: '开始时间 / 结束时间', source: '系统记录触发时刻。', purpose: '按时间范围缩小排查范围', fill: '开始时间默认当天;结束时间留空=不限' },
{ name: '类型', source: '内置触发源自动写入。', purpose: '区分八类预警(含应急呼叫)', fill: '只读' },
{ name: '标题 / 内容', source: '触发时系统自动生成。', purpose: '说明预警的具体对象与原因', fill: '只读' },
{ name: '关联ID', source: '系统写入(产品工号/SN/工位等业务键)。', purpose: '定位预警来源的具体业务对象', fill: '只读' },
{ name: '时间', source: '系统记录触发时刻。', purpose: '追溯预警发生时间', fill: '只读' },
{ name: '标记已读', source: '人工在本页操作。', purpose: '处置完成后闭环该预警', fill: '核对处置后点「标记已读」' },
{ name: '确认放行', source: '仅 torque_ng 项显示,人工质检/班组长操作。', purpose: '拧紧不合格人工处置:清工件标记+写日志+置预警已读', fill: '填处置原因点「确认放行」' }
]
}
export const helpAlertRule = {
title: '预警规则配置',
scope: "写预警触发规则与阈值、通知对象,影响预警中心生成条件。",
consequence: "阈值改小会显著增加预警量;停用规则后历史预警保留;规则不等于业务拦截,硬拒仍由业务守卫执行。",
overview:
'预警规则配置用于设置各类预警的「是否启用」与「触发阈值」,修改后实时生效(下次扫描周期即用新值),无需重启服务。\n\n可配置项:\n· 启用/停用:关闭后该类型不再产生预警;\n· 阈值:不同类型含义不同——库存偏低=低于该「件」数报警;任务超期=超过该「小时」数未完工报警;拧紧不合格/检验不合格为事件触发型,出现即报警,阈值暂不使用(填 0);\n· 通知方式(notify_channels):预留字段,逗号分隔(如 site,sms),当前空=仅落预警中心收件箱,暂不实现短信/邮件外发。\n\n阈值单位:库存偏低=件,任务超期=小时,事件型=不使用(填 0 表示未配置、不触发)。保存时若阈值留空按 0 处理(即该规则不触发,直到填写具体值)。\n\n注意:本页只配置规则,预警消息的查看与处置在「预警中心」。',
fields: [
{ name: '规则名称', source: '系统内置(按类型固定)。', purpose: '标识该规则', fill: '只读' },
{ name: '类型', source: '系统内置触发源类型。', purpose: '区分八类预警', fill: '只读' },
{ name: '阈值', source: '本页配置(存于 alert_rule 表,下次扫描读取)。', purpose: '设定触发临界值', fill: '数字输入;按类型带单位(件/小时);0=未配置不触发' },
{ name: '启用', source: '本页开关。', purpose: '开启/关闭该规则', fill: '开关;关闭后不触发' },
{ name: '通知方式', source: '本页填写(预留)。', purpose: '预留通知渠道,暂未实现发送', fill: '逗号分隔,空=仅预警中心收件箱' },
{ name: '阈值说明', source: '系统按类型给出。', purpose: '解释该类型阈值的含义与单位', fill: '只读' },
{ name: '编辑', source: '人工在本页操作。', purpose: '修改阈值/启用/通知方式并保存', fill: '点「编辑」打开弹窗' }
]
}
export const helpAttachment = {
title: '附件中心(统一存储与查阅)',
scope: "统一查阅附件与状态追溯(上传/删除/清除),业务单据按 biz_type+biz_id 引用。",
consequence: "本页不提供删除;被引用的附件禁止删除;清除需过 6 个月安全期且实名留痕,物理清除仅限服务器附件根目录。",
overview:
'附件中心集中登记并查阅全系统附件(图纸、检验照片、检验报告、工艺、流程卡、包装照片、Excel 导入等),新增在各业务页面内完成,本页为纯查阅页:查询、在线预览、下载、状态追溯。\n\n统一存储规则:所有附件按「附件根目录/年/月/日/文件类型/文件」分层存放,文件类型目录全部大写(PROCESS_PDF、INSPECTION_PHOTO、INSPECTION_PDF、DRAWING、PROCESS_CARD、PACKAGE_PHOTO、EXCEL_IMPORT、OTHER);文件名统一用 UUID,扩展名小写,不含中文与特殊字符;数据库只存相对路径(如 2026/09/19/INSPECTION_PHOTO/xxx.jpg),不存绝对路径。附件根目录由配置文件 Upload.Dir 指定,不硬编码。\n\n上传为流式写入(边写边算 MD5),同业务对象同 MD5 自动秒传不重复占空间;单文件大小按文件类型配置上限(默认 20MB)。\n\n状态三态:正常 / 已删除(文件仍在磁盘,彻底清除前可恢复)/ 已清除(磁盘文件已删除,索引保留可追溯)。已删除/已清除的记录悬浮可看删除人、时间、说明等前因后果;预览前会先提示。\n\n附件的删除、恢复与磁盘释放统一在「数据归档 → 磁盘空间回收」完成(需 sys.attachment:manage 权限);业务单据附件面板中,上传人本人可「移除」自己误传的附件。所有清理仅允许处理保护期(默认 180 天)之前的数据。\n\n磁盘空间监控:系统每天早上 7 点自动检测磁盘剩余空间,剩余低于 20% 告警、低于 10% 提示及时清理(本页顶部同步横幅提示;请到「数据归档 → 磁盘空间回收」处理)。',
fields: [
{ name: '文件类型', source: '上传时由业务场景指定或按扩展名推断(大写枚举)。', purpose: '决定存储目录分层,也是查阅时的主要筛选维度', fill: '下拉单选八类之一,留空=全部' },
{ name: '业务类型', source: '上传时随附件记录写入(工单/物料/工艺/检验/入库 等)。', purpose: '区分附件挂在哪种业务单据上', fill: '下拉单选,留空=全部' },
{ name: '业务标识', source: '上传时写入的业务键(产品工号/图号/SN)。', purpose: '定位某个具体单据的全部附件', fill: '支持模糊匹配,如输入产品工号' },
{ name: '文件名', source: '上传时的原始文件名。', purpose: '按名称模糊查找', fill: '支持模糊匹配' },
{ name: '上传时间', source: '系统记录上传时刻。', purpose: '按时间区间缩小范围', fill: '可选起止日期,留空=不限' },
{ name: '含已删除', source: '勾选后包含逻辑删除的记录。', purpose: '追溯已删除附件', fill: '默认不勾选' },
{ name: '大小', source: '系统统计上传达字节数。', purpose: '评估占用空间', fill: '只读' },
{ name: '预览 / 下载', source: '预览走免鉴权直链(PDF/图片浏览器内联打开);下载走鉴权路由并带回中文文件名。', purpose: '查看或另存附件', fill: '已删除/已清除的附件预览前会先弹前因后果提示;已清除的附件不可下载' },
{ name: '状态', source: '列表列,悬浮显示详情。', purpose: '三态:正常/已删除/已清除', fill: '删除与磁盘释放统一在「数据归档 → 磁盘空间回收」' }
]
}
export const helpProducible = {
title: '排产支撑',
scope: "只读计算可用库存与产能,辅助判断能否排产。",
consequence: "不写任何台账;库存不足仅提示不拦截建单;数据源为 WMS 实时库存,延迟会造成判断偏差。",
overview:
'把「库存还能撑多久」算清楚,给计划员排产/叫料决策用。数据来源:日排产(按排产日期窗口、剔除已取消排产)× 工单 × 工单工艺组合 × 工艺物料清单得到需求量,库存可用量实时来自 WMS。注意:物料需求跟着工单走(同成品不同工单可用不同工艺),且一律按日排产口径计算,工单起止日期仅作参考。\n\n本页两块:\n· 各成品可生产套数:只统计有未取消日排产的工单;按该工单工艺组合的物料单台含损耗用量 ÷ 对应物料 WMS 可用量取最小值,即当前库存最多还能装出多少台;短板说明列出限制它的物料(可用量 ÷ 单台用量 = 套数)。\n· 整体支撑:用 WMS 可用量对日排产做逐日消耗模拟,直到某物料不足,得出「还能满产多少天」「库存可支撑到哪天」「最先告罄的短板物料」;排产只排到 N 天时,第 N+1 天起用近3天平均日需求外推(封顶365天防死循环)。\n\n无排产计划时短板物料栏显示「无排产计划」;排产日全部满足且外推无有效需求时显示「充足」。本页只读,不落库。',
fields: [
{ name: '还能满产(天)', source: '逐日消耗模拟算得(/api/v1/production/producible-support)。', purpose: '一眼看出按当前排产节奏库存能撑几天', fill: '=0 表示今天/近期排产即缺料,需立即补料' },
{ name: '库存可支撑到', source: '支撑天数 + 今日日期推算。', purpose: '给出最晚需要到货的日期', fill: '只读;格式 YYYY-MM-DD' },
{ name: '最先告罄短板物料', source: '模拟中第一个被耗尽的物料(名称+编码)。', purpose: '指出最该优先补货的物料', fill: '「无排产计划」/「充足」表示暂无瓶颈' },
{ name: '可生产套数', source: '逐工单计算(只算有未取消日排产的工单):min(各物料可用量 ÷ 单台含损耗用量)。', purpose: '该工单当前库存能装出的最多台数', fill: '=0 表示关键物料已缺,无法开线' },
{ name: '短板说明', source: '限制该成品可生产套数的物料明细(可用量÷单台用量=套数)。', purpose: '定位缺哪料、缺多少', fill: '只读;多短板时最多列前3个' }
]
}
export const helpPlcMonitor = {
title: 'PLC管理',
scope: "读取/写入 PLC 点位监控与在途标记,手动核对产线控制器状态。",
consequence: "本页不轮询自动刷新;清在途标记不会回滚 MES 台账;PLC 不可达时读不到值须人工核对并留痕。",
overview:
'这个菜单做什么用:产线设备(PLC)的"仪表盘+方向盘"。产线工人不用懂 PLC,本页把设备状态翻译成人话,并在设备不干活时给人工干预的入口。\n\n页面从上到下分六块:\n· 顶部:刷新按钮 + 最后刷新时间(打开页面自动读一次,不轮询;需最新状态点「刷新」)。\n· 工位托盘位(只读)、主线缓存位(只读)、接驳台托盘位(只读):三块均为只读,展示各点位「●有件 / ○空」(PLC 实时读取,中文名如 工位1、缓存位5、接驳台1)。无任何按钮、无输入框;传感器位由 PLC 覆盖,无需也不可人工改动。\n· 在途指令:仅列出 PLC 中仍记录为「在途」(MW 非 0)的路径指令,显示为「源 → 目标」。若该指令已实际卡住、PLC 未自动清零,可点「强制清零」——二次确认并勾选「已确认现场安全且指令已实际卡住」后写 MW=0。正常自动线不应出现长期在途。\n· 手动下发:选「源」(工位1~12 / 缓存位1~15)→ 目标下拉按源类型动态过滤 → 系统自动预览「源 → 目标」→ 点「下发」二次确认后写入 PLC。\n\n与「工位下发」的分工:工位下发=按工单路线正常驱动产线(业务动作);本页=设备排障工具(PLC 卡住/漂移时的人工干预),只在异常时用。手动下发受互斥保护——存在在途指令(工位下发尚未收到完成信号)时拒绝,以免打断自动线;可先到「工位下发」页撤回或人工完成后再来。\n\n所有手动下发动作记入操作日志(event_log,类型 plc_manual_write);所有强制清零动作记入操作日志(event_log,类型 plc_in_transit_clear),均可在「操作日志」页按类型筛选追溯。',
fields: [
{ name: '源', source: '下拉选择。工位1~12 或 缓存位1~15。', purpose: '路径起点', fill: '选择后目标下拉按源类型动态过滤' },
{ name: '目标', source: '下拉选择(按源类型动态过滤,仅显示 §4.4 合法组合)。', purpose: '路径终点', fill: '选源后才有可选目标' },
{ name: '预览', source: '系统按 §4.4 路由表自动算出。', purpose: '展示「源 → 目标」中文路径', fill: '只读;组合非法时提示' },
{ name: '下发', source: '按钮(二次确认)。', purpose: '确认后写入 PLC 路径指令并记操作日志', fill: '存在在途指令时会被拒绝' },
{ name: '在途指令 / 强制清零', source: '系统列出 PLC 当前 MW 非 0 的在途指令,每行一个「强制清零」按钮。', purpose: '清除卡住的在途指令(PLC 未自动清零时使用)', fill: '需二次确认并勾选「已确认现场安全且指令已实际卡住」;仅允许 §4.4 路由区地址,越界拒绝;传感器位无需人工改动' }
]
}
export const helpPlcMesMismatch = {
title: 'PLC↔MES 对账(已知局限)',
scope: "展示 PLC 位置与 MES 台账不一致清单(断电恢复 / 手动 / 开机自动对账三源)。",
consequence: "对账只暴露差异不自动修复;须按现场实物核对后走下发撤回/人工完成/AGV 刷新;忽略差异会让在制工件与点位长期错账。",
overview:
'PLC↔MES 对账用于发现「PLC 托盘位说有件、但 MES 没有对应在制工件」的不一致(plc_mes_mismatch)。\n\n对账范围:G1~G10(M895.0~M896.1)+ C15(M898.2),共 11 个工位托盘位。不含主线缓存位、不含接驳台。\n\n对账规则:工位 PLC 托盘位=1 且 MES 中该工位无 status∈{ONLINE, PROCESSING} 的工件 且 工位非停用 且 不在「工序码下发后 15 秒」宽限窗口 → 判为不一致。\n\n触发:终端开始作业/扫SN/建档提交(弹终端两项选择:新件建档 / 绑定已知件)、报工提交(命中则阻断报工)、PLC 通讯恢复/管理员手动核对(落预警中心,全量 11 位)。均为事件驱动,无定时轮询。',
sections: [
{
title: '已知局限(重要)',
fields: [
{ name: '流转途中会误报', source: 'MES 不知工件在工位间的流转过程。', purpose: '说明为何会出现"假不一致"', fill: '例如工件从 G5 发往 G7 途中,G7 的 PLC 托盘位尚未被 MES 感知,此时会误报 G7 不一致。属已知误报,待 PLC 路径指令下发能力做完(MES 能跟踪工件在途)后该误报消失。' },
{ name: 'PLC 真读已落地', source: '按 产线布局说明.md §4.1 点位表实现 S7 真读(G1~G10→M895.0~M896.1、C15→M898.2)。', purpose: '说明数据来源现状', fill: '真读已实现,mock 置位仅用于联调;不再依赖"点位表阻塞"。反向对账(MES 有记录 PLC 无托盘)暂不强制。' },
{ name: 'C15 工位号映射', source: 'PLC 地址 C15(M898.2,末端下料检测位)已按点位表映射为 MES 工位号 15。', purpose: '标注已确认项', fill: '工位 11/12(G11/G12)已有独立托盘位信号(M896.2/M896.3),本轮不纳入对账范围(无终端处置),后续可选。' }
]
}
]
}