feat: 全端体验与稳定性整改(帮助文档清理/收集式报错/操作列统一/托盘与WS通知/物料同步重推)

- 移除 bj_power_dashboard 旧 React 大屏源码(迁移至 2D SVG 方案)
- MES/WMS/工位终端前端:清理 help.js 与 PageHelp 帮助文档,统一操作列与布局,接入请求拦截器
- 新增收集式校验错误弹窗(ErrorListDialog 统一拦截 3015,逐条列现象+建议)
- 新增托盘程序(tray)与 WebSocket(ws) 实时通知模块(三端共用)
- MES/WMS 物料档案新增同步状态字段,补齐双向失败重推与默认角色 seed
- 工单/产能/产品工艺/日排产逻辑调整;拧紧枪按工位配置
- 新增迁移 SQL:扭矩按工位、sysconfig 序列修复
- 更新 技术约束/案例/部署手册/项目说明 等文档
This commit is contained in:
SunYF
2026-11-10 23:42:50 +08:00
parent af554cea75
commit 619fc8983d
219 changed files with 8565 additions and 10739 deletions
+220 -661
View File
@@ -1,693 +1,252 @@
// MES 管理后台 页面级操作说明:整体流程 + 各字段 数据来源/用途/怎么填
// 由 components/PageHelp.vue 在左下角 "?" 按钮弹出展示。
// 说明:这里的"数据来源"特指该字段的数据由谁产生、从哪个系统/页面来,帮助跑通真实流程。
// MES 页面说明。
// 写法原则:只写这一页真正会让人卡住的东西——状态看不懂、几个概念容易混、
// 改了会牵连别的模块、点下去收不回来。不逐字段解释表单列,不复述界面上已经写清楚的字。
// 每页篇幅和格式按页面本身的需要来:有的页只有一句话,有的页分几块说明。
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 导入」选择文件上传 → 查看成功/失败行数与失败原因(如编码重复、必填缺失),失败行修正后可重新上传' }
]
}
const P = (title, intro, blocks) => ({ title, intro, blocks })
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 helpProductType = P('物料档案', '这里是成品型号的源头,编码一旦被工单引用就不要改。', [
{ k: 'states', t: '停用不是删除', text: '停用后新建工单的下拉里选不到它,但已经建好的工单、库存、追溯记录都还在,也还能查。这是唯一的下架方式,系统不物理删型号。' },
{ k: 'confuse', t: '三个编号别混', text: '产品工号是工单号(一批一个);图号是型号(多个工单可以是同一个图号);产品序号(SN) 是每台工件自己的号。改图号会让已建工单找不到原来的型号,追溯也跟着断。' },
{ k: 'confuse', t: '「序列号=是」决定什么', text: '它决定这台工件是按批次数量记账,还是一台一个号逐件扫。选「是」时,上线建档必须扫已在 WMS 入库登记过的来料 SN,不能让系统发号。产品分类(结构件/电气件)只是个默认值,跟这件事没有绑定关系。' },
{ k: 'complex', t: '同步失败时两种表现不一样', text: '单条建档或编辑即使 WMS 暂时不通,本系统也会先保存下来、标上待同步,之后点「重推」补上;Excel 批量导入则是整批一起成功或一起失败,不会出现半张表进去了的情况。' }
])
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 helpWorkOrder = P('工单管理', '一张工单从建单到收尾,能不能改、改了会牵动什么,全看它当前处在哪个状态。', [
{ k: 'states', t: '工单状态', items: [
'CREATED 已创建:还能删,也还能改工艺组合。',
'IN_PROGRESS 进行中 / RELEASED 已下发 / PAUSED 已暂停:工艺组合锁住不能改。',
'DONE 已完成 / CANCELLED 已取消:终态,之后只能看不能再改。'
] },
{ k: 'confuse', t: '为什么保存按钮是灰的', text: '只要有还没完成的工单,工艺组合和来源产品工艺就不让改——现场正在按这套路线干活,中途改会让在制工件找不到下一道工序。确实要改线的,先暂停工单走转产流程,由系统把在制工件和备料一起重排。' },
{ k: 'confuse', t: '「序号」列是什么', text: '是这一批工件按生成顺序排的位次(1、2、3…),不是从 SN 里截出来的数字。SN 本身可以带自定义前缀,重复的前缀在整个项目里都不允许。' },
{ k: 'irreversible', t: '删除', text: '只有「已创建」且没有产生排产、备料、生产数据的工单能删,删掉找不回来。一旦开始排产就得用取消,不能用删除。' },
{ k: 'irreversible', t: '强制完工', text: '会把没完成的排产自动取消、待备料的叫料单自动取消,并把工单直接推到已完成。这是给「现场确实做完了但有几个工件没走完流程」的收口用的,点了不能撤销,历史报工实绩不会被抹掉。' },
{ k: 'complex', t: '工艺组合为什么必须递增', text: '工位号从小到大就是产线的单向走法,系统要求每道工序的工位整体排在上一道之后、同一道工序内不重复工位。多工位同工艺是「哪个空闲去哪个」的并行候选,不是要每个工件挨个走一遍。' }
])
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 helpDailyPlan = P('日排产', '排产是算料和叫料的开关,不是一张待办清单。', [
{ k: 'states', t: '排产状态与「已启用」', items: [
'PENDING 未确认 → CONFIRMED 已确认 → PROCESSING 执行中 → DONE 已完成;CANCELLED 是已取消。',
'「已启用」是算料开关:只有已确认/执行中的排产会参与备料清单和叫料需求计算。未启用不等于已取消,只是暂时不算料。'
] },
{ k: 'irreversible', t: '停用 vs 删除', text: '停用只是让这一天不参与算料;删除会把这一天从计划里拿掉,已生成的备料与叫料需求会跟着变。调整前先看这一天的备料单是否已经发出。' },
{ k: 'confuse', t: '数量为什么加不上去', text: '同一张工单各天的计划数量加起来不能超过工单总台数,系统会按累计量卡住。要加量得先改工单数量或补料审批,不是在排产里硬填。' },
{ k: 'tip', t: '看历史', text: '默认只看今天起 30 天。想看过去,勾「显示历史」并把日期范围清空;状态选「全部」才不会被「未完成」过滤掉——这两个筛选是各管各的。' }
])
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 helpProductProcess = P('产品工艺', '这是产品怎么做的模板,工单选它时把当时的工序和候选工位拍成快照。', [
{ k: 'states', t: '停用 vs 删除', text: '停用后新建工单选不到它,但历史工单仍能反查到当时的定义,所以生产过的产品建议停用而不是删。' },
{ k: 'confuse', t: '为什么改不了', text: '只要有未完成的工单引用了这套工艺,定义和工序明细都会锁住。这是为了保护在制工件:现场正按这套顺序报工,中途改顺序会让流程卡和考核标准对不上。' },
{ k: 'complex', t: '改顺序会牵动什么', text: '工序顺序决定候选工位的区间、备料算料和流程卡上的步骤排列。已经在做的一批货要走两步转产(先按工单归集退料,再暂停工单改路线),不要直接改模板。' },
{ k: 'tip', t: '生成工位模板', text: '勾选若干产品工艺可以生成工位绑定模板。模板按产品图号区分:给 A 产品生成的模板,套到 B 产品上会被拒绝。生成时可以勾选要哪些工位、拖动排序、换绑工艺,保存时会检查工序整体是否递增。' }
])
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 helpProcessFlow = P('工艺流程', '一道工艺下面配的步骤,直接决定工位终端要采集什么。', [
{ k: 'confuse', t: '为什么保存不了', text: '有未完成的工单在引用这套工艺时,定义和步骤都禁改。先看是哪张工单还开着,不要临时删步骤绕过去。' },
{ k: 'complex', t: '改物料清单的连锁反应', text: '清单改了,备料算料的需求量、工位终端的「应绑数量」会立刻跟着变;已经发出的备料单不会自动重算,需要人工核对差额。' },
{ k: 'irreversible', t: '删步骤', text: '删掉的步骤不会再出现在这套工艺的流程卡和报工考核里。已经产生的历史实绩不会被删,但新旧卡的口径会不一样,追溯时容易看不懂。' }
])
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 helpStation = P('工位管理', '工位号是产线物理位置,绑定工艺决定这个工位干什么活。', [
{ k: 'confuse', t: '为什么工位号不能改', text: '内置工位号对应 PLC 点位、接驳台左右手和 AGV 路线,改了整套位置台账都会对不上。只有自建工位能删,内置工位只能停用。' },
{ k: 'confuse', t: '改绑定工艺被硬拒', text: '这个工位正在被进行中的工单当作生产路线的一环,或者还有没执行完的下发指令、托盘上还有工件。先让工单走完或取消、指令收口、工件移走,再来改。' },
{ k: 'complex', t: '停用的连带影响', text: '停用工位后,叫料和派车都会被直接拒绝,不只是「建议不要用」。已经发出去的叫料单不会自动撤,需要人工处理。' },
{ k: 'tip', t: '套用模板', text: '模板带产品图号时只能套到同一个产品上。点「预检并应用」会先列出哪些工位会被跳过以及原因,确认后才真正写入,不会一股脑改掉。' }
])
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 helpMaterial = P('叫料单', '本页只读。叫料由工位终端发起,改数要去对应的处置流程。', [
{ k: 'states', t: '单据 7 态', items: [
'PENDING 待备料 → SHIPPED 已发货 → DONE 已完成。',
'CANCELLED 已取消、REJECTED 已驳回、RETURNING 退料中、RETURNED 已退料。'
] },
{ k: 'confuse', t: '叫料池四个数', text: '需求是按排产算出来的理论量,调整是人工加减和审批补料,已发是库房已经发出来的累计,占用是还在路上或还没确认的量。可用量不等于「已发减已耗」,要看占用有没有释放。' },
{ k: 'confuse', t: '借料来源', text: '本工位一点余量都没有时,工人才会从兄弟工位借。列里显示的是借出方,份额从借出方的池子里划走,总量不增加,属于零和转移,不是多叫了一份料。' },
{ k: 'complex', t: '损耗去哪确认', text: 'MES 侧不再确认损耗。差异在 WMS 退库单「确认收货」时填原因才落台账,绩效里才看得到;本页改不了任何数量。' }
])
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 helpQtyReport = P('数量不符处理', '三种处置方式会把差额带去完全不同的地方。', [
{ k: 'confuse', t: '「已关闭」不等于同一条路走到头', text: '界面只显示四个中文状态,但后端有好几种终态都归到「已关闭」:调整关闭、退料关闭、处理完毕。想知道这一单是怎么收的,要看「处理方式」列,别只看状态名。' },
{ k: 'complex', t: '三种处置的下游后果', items: [
'补发:会新生成叫料单,重新占一次叫料池额度,库房要再发一次货。',
'退料:要等 WMS 确认收货,库存和叫料池的已发量才会回补。',
'调整关闭:只把差异记账关掉,不动库存也不动实物。'
] },
{ k: 'tip', t: '别拖着不处理', text: '差异一直挂着,工位账就一直对不平,后续叫料的可用量也会一直被占着。' }
])
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 helpShortage = P('补料审批', '三个「加料」是三回事', [
{ k: 'confuse', t: '补料 / 借料 / 数量不符补发', text: '补料是工位物料真的不够,主管审批后调增这个工位的叫料池额度(总量增加);借料是从兄弟工位划额度过来(总量不变);数量不符补发是差异单驱动的纠错发货。别把它们当成同一个按钮的三种说法。' },
{ k: 'states', t: 'PENDING → APPROVED / REJECTED', text: '通过之后额度立刻加到工位叫料池,工人那边就能叫了;驳回只是不批,不会扣掉已有额度。' }
])
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 helpLossLedger = P('损耗台账', '损耗是「理论上应该剩多少」减「实际退回来多少」算出来的。', [
{ k: 'confuse', t: '为什么工单和绩效里看不到损耗', text: '损耗不记在工单上。它要等 WMS 退库单确认收货、填了损耗原因,才落到这张台账;没填原因的单子不会进账,绩效里也就没有这一笔。' },
{ k: 'confuse', t: '批注只是回复', text: 'PENDING 待批注 → COMMENTED 已批注,批注是对差异的说明,不改数量、不改库存,也不会重新算损耗。' }
])
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 helpTransferReturn = P('转产退料', '改线是两步,顺序反了物料账会乱。', [
{ k: 'complex', t: '两步怎么走', items: [
'第一步:在本页按工单归集旧工位的剩余物料,逐张生成退库单,库管分别收货。',
'第二步:到工单管理把工单暂停、改工艺路线;系统会转移在制工件并按新工位重排备料。'
] },
{ k: 'irreversible', t: '强行退料', text: 'PLC 离线时仍然允许提交,但物料可能还在工人手里、还没实物退回库房。这一步会造成账实不符,只在确实确认过现场之后用。' },
{ k: 'tip', t: '参考值为负数', text: '理论应剩算出来是负数时只是展示出来提醒你核对,不会拦着不让提交。' }
])
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 helpWip = P('在制品', '本页只读,看的是工件卡在哪儿、为什么没往下走。', [
{ k: 'confuse', t: '工件为什么一直停着', text: '常见三种:这一步没报工、上一步没点移料确认、拧紧数据 NG 还没处置。这里不能替工人点完工,要回工位终端处理。' },
{ k: 'tip', t: '跨天停留', text: '跨天还挂在同一个工位的工件要重点看,多半是交接时漏了报工或收口。' }
])
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版' },
export const helpTrace = P('工件追溯', '这里是只读聚合,异常在这里暴露、但不在这里修。', [
{ k: 'irreversible', t: '报废 / 取走登记', text: '登记后工件永久退出产线、清掉所在点位,之后不再计入在制。工单要由计划员用强制完工收尾。若只是暂时下线、以后还要再上线,应该用「暂存退库」,别用报废。' },
{ k: 'confuse', t: '「显示原因」不是判缺料', text: '绑定工序显示的是当时为什么没采到(比如没扫到、没配置),不等于系统认定物料短缺。' },
{ k: 'tip', t: '查到异常去哪改', text: '装机绑定缺失回工位终端「物料」页补绑;扭矩 NG 回终端处置;检验记录去检验页复检。本页不提供任何修正入口。' }
])
{ 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 helpProcessCard = P('生产流程卡', '流程卡是报工实绩的投影,不是一张要单独填的表。', [
{ k: 'confuse', t: '卡上缺项', text: '多半是那道工序漏了报工或漏了签字,不是卡生成错了。回工位终端补报工,卡会跟着变。' },
{ k: 'tip', t: '导出', text: '一次最多导 100 张,范围为空时不能确认导出。' }
])
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 helpPerformance = P('绩效统计', '按报工时间归集,没报工就不会出现在这里。', [
{ k: 'confuse', t: '为什么没有损耗', text: '损耗只有在 WMS 退库单确认收货时填了原因才落账;没填、或者退库单还没收货,这里就看不到。' },
{ k: 'confuse', t: '合格数与上机时长', text: '都来自报工记录,未完工的工件不计入。想核对到人到天,应该先确认报工有没有漏。' }
])
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 helpInspect = P('巡检与检验', '记录只能新增,不能事后改写。', [
{ k: 'irreversible', t: '巡检记录不可改', text: '写进去的结论就定下来了,复检是以一条新记录覆盖判定,原记录仍留着。' },
{ k: 'confuse', t: '退料按钮为什么不生效', text: '传感器检到这个工位上还有托盘(工件没完工)时会硬拒退料,防止把还在做的工件当余料退掉。先让工件完工或移走。' },
{ k: 'complex', t: '一键生成检验记录', text: '会把当前查询范围内的巡检结果汇总写成一条记录,范围先筛准再点。' }
])
export const helpQualityInspection = P('质量检验', '结论一旦判下去就改不了。', [
{ k: 'irreversible', t: '复检不是改原记录', text: '复检新增一条记录覆盖判定,历史判定保留可查。' },
{ k: 'complex', t: '完工检不合格', text: '会阻断成品回流 WMS 入库,货先卡在质量这边,处置完才能继续。' }
])
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 helpAuditPending = P('待审核签字', '审核通过是「放行」,不是「完工」。', [
{ k: 'states', t: '未审核 → 通过 / 驳回', text: '未审核的签字会卡住报工流转;驳回后现场要重做那一步再提交,不是改一下签字就行。' },
{ k: 'irreversible', t: '审核记录', text: '签字留名留时间,事后不能改。' }
])
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 helpProducibleSupport = P('排产支撑', '只读测算,库存不够也只提示、不会拦着排产。', [
{ k: 'confuse', t: '几个数怎么读', text: '「可生产套数」是按当前可用库存取最短板的那件物料算出来的整套数;「库存可支撑到」是把日排产逐日消耗模拟完、再按近几天平均用量外推出来的日期;「充足」表示算不到告罄,不等于库存真的无限。' },
{ k: 'complex', t: '数据从哪来', text: '需求跟着工单工艺组合走,库存实时问 WMS。WMS 延迟或刚入库还没同步时,这里的数会偏保守,别拿它当出入库依据。' }
])
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 时禁编辑/删除,只能停用' }
]
}
// ── PLC 与 AGV ────────────────────────────────────────────────
export const helpPlc = P('工位下发', 'SENT 不是失败,是在等 PLC 回完成信号。', [
{ k: 'states', t: '下发状态', items: [
'SENT 已下发·等待完成信号 / DONE 已完成 / CANCELLED 已撤回 / TIMEOUT 超时 / REPLY_NG 回复异常。'
] },
{ k: 'confuse', t: '等太久怎么办', text: '先确认现场实物到底走没走。确实没走就「撤回」,确实走了但信号没回来就「人工完成」收口。两个动作都会留痕,别互相代替。' },
{ k: 'irreversible', t: '撤回不回滚报工', text: '撤回只撤这条下发指令,已经报工产生的实绩不会被抹掉。' }
])
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 helpPlcMonitor = P('PLC管理', '本页手动写点位,按钮按下去就真下发给 PLC 了。', [
{ k: 'states', t: '在途与模拟数据', text: '在途=MW 寄存器非 0,同一工位有在途指令时新的手动下发会被互斥挡掉。页面标了「模拟数据」时,看到的是 mock 点位状态,别拿它判断现场实物。本页不自动刷新,要看最新状态得手动刷新。' },
{ k: 'irreversible', t: '强制清零', text: '二次确认 + 勾选现场安全后才执行,只清 PLC 的在途标记,不回滚 MES 台账、不撤销已经报过的工。清零之前务必在实物上确认工件位置。' },
{ k: 'complex', t: '被拦下来时先分清是谁拦的', text: '「已有在途指令」和「多工单缓存策略=严格隔离」是两道不同的检查。前一种无论哪种策略都会先拦,看起来像策略问题其实不是。' },
{ k: 'complex', t: '多工单缓存策略在这页会看到什么', text: '这个设置只影响本页的手动下发:目标必须是 C 类主线位置、而且是可缓存位(C2/C3/C5/C6/C8/C9/C11/C12/C14),MES 台账显示被别的工单占着时,严格隔离会拒绝这次下发并报出占用的 SN 和工单号。切回物理优先就能下发,改完立刻生效。详细口径见「基础设置」页的帮助。' }
])
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 helpLineManagement = P('产线点位与接驳台', '这里改的是台账,不是工件本身。', [
{ k: 'confuse', t: '释放点位 ≠ 工件完工', text: '「释放点位」只是把台账置回空闲并写一条日志;「纠正位置」只是把工件标成「不在工位」。两者都不推进工序、不改工件状态、不回滚库存。' },
{ k: 'complex', t: '停用接驳台的连带影响', text: '停用后叫料和派车会被直接硬拒,AGV 的空台校验也读这里。左右手接驳台按工位奇偶区分,送错台时货会落到另一侧的实物接驳点上。' }
])
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 helpAgv = P('AGV配送', '状态里的数字码是 RCS 的原始值,别当成进度百分比。', [
{ k: 'states', t: '任务状态', items: [
'PENDING 待下发、FAILED 失败可重试、1/2/5 执行中、ARRIVED 到位待令、9 已完成。',
'到位待令(ARRIVED)不是已完成:到位之后还要人工确认装车、送货、卸货,才会变成已送达。'
] },
{ k: 'confuse', t: '回调没来时卡在哪', text: 'AGV 到位后如果回调没到,WMS 的出库单/配送单会一直停在待送达。先在本页刷新任务,再决定取消还是重试。' },
{ k: 'irreversible', t: '解锁 / 清除强提标记 / 重试', text: '「解锁点位」清掉点位锁,「清除强提标记」清掉风险标记,「重试」重新向 RCS 下发一次任务。三个都只改调度侧状态,不动物料账、不动库存。' },
{ k: 'tip', t: '改载货状态要谨慎', text: '载货状态直接参与防撞判定,改错会让系统误以为车是空的。' }
])
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 helpSettings = P('基础设置', '这里的开关保存后立刻对全站生效,不用重启服务。改之前先想清楚会影响哪些人。', [
{ k: 'complex', t: '多工单缓存策略:physical / strict', text: '默认「物理优先」时,MES 不做额外限制,目标点位能不能放由 PLC 和现场决定。「严格隔离」时,多工单的物料不允许共占同一个缓存位,MES 会按台账占用拦下这次下发。' },
{ k: 'complex', t: '这个策略到底管到哪', items: [
'只管「PLC管理」页的手动路径下发,而且目标必须是 C 类主线位置、必须是可缓存位 C2/C3/C5/C6/C8/C9/C11/C12/C14。',
'停靠位 C1/C4/C7/C10/C13/C15、G 类工位/接驳台、C15 进料位,都不进这套判定。',
'不影响 AGV 派车与卸货、不影响叫料借料、不影响报工、不影响 WMS 和工位终端的任何页面。',
'判断依据是 MES 台账里的「占用」标记,不是 PLC 传感器上的「有没有托盘」。'
] },
{ k: 'confuse', t: '一个具体例子', text: '严格隔离下,C2 已经被工单 WO-A 的工件 SN001 占着,这时手动下发 G1→C2 会被拒,报错里会写明 C2、SN001、WO-A,并给两条出路:切回物理优先,或者先把工件清走。同样条件下把目标改成 C1(停靠位)、G5 或 C15,都会放行。切回物理优先后刚才被拒的下发立刻就能发(热生效,不用重启)。' },
{ k: 'confuse', t: '别误以为是策略拦的', text: '如果同一个工位还有在途指令(SENT),无论哪种策略都会先在更前面一步被互斥拒绝。先把在途收口,再判断是不是策略问题。' },
{ k: 'confuse', t: '页面提示与代码口径不完全一致', text: '表单下面的提示写的是「目标接驳台/缓存位实际无托盘即可卸货」,容易让人以为管的是 AGV 卸货;实际生效范围是上面说的「PLC管理页手动下发 + 可缓存 C 位 + MES 台账占用」。以这个实际范围为准。' },
{ k: 'complex', t: '其他全站级开关', text: '借料开关关掉后超额叫料会被直接拒绝;拧紧手填开关会影响工位终端能不能人工录扭矩;AGV 卸货超时阈值决定预警扫描多久算超时;WMS 地址改完下一次调用就用新地址。这些都是全站级,改之前通知到现场。' }
])
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 helpTorqueGunConfig = P('拧紧枪配置', '改完即时保存,本页没有「保存配置」按钮。', [
{ k: 'confuse', t: '控制器地址到底是什么用', text: '填的是拧紧枪控制器的 IP:端口,供工位终端启动时找到设备、上报数据用。系统本身不会主动去连这台控制器,填了地址不等于设备已经接通。本页也不能新增控制器行,只能改已有行的地址。' },
{ k: 'confuse', t: '允许手填的约束', text: '只有填了控制器地址,才能把该工位设成「禁止手填」——否则现场既没有设备又没有人工录入的口子。禁止手填后扭矩必须由拧紧枪打入,符合质量追溯要求。' },
{ k: 'tip', t: '即时生效', text: '行内改完就写进去了,不用再点保存;工位终端下一次拉取配置就会用新值。' }
])
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 helpAccount = P('账号管理', '改角色会立刻影响别人能不能进菜单。', [
{ k: 'confuse', t: '停用与删除', text: '停用只是不让登录,历史操作日志还在;删除不可恢复,但同样抹不掉已经产生的日志。别指望删账号来清痕迹。' },
{ k: 'complex', t: '改角色的即时影响', text: '保存后对方下一次点菜单就可能消失或收到 403,正在做的操作也会被挡。改之前跟人打个招呼。' },
{ k: 'tip', t: '初始密码', text: '重置后的初始密码由管理员告知本人,首次登录应自行修改。' }
])
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),本轮不纳入对账范围(无终端处置),后续可选。' }
]
}
]
}
export const helpRoleManage = P('角色管理', '权限码是即时生效的,admin 是例外。', [
{ k: 'complex', t: '缩减权限码会发生什么', text: '保存后属于这个角色的人菜单当场少一块、接口开始返回 403。admin 在初始化时被强制给全权限,不受这里的裁剪影响。' },
{ k: 'tip', t: '自建角色与初始化', text: '系统初始化只会给内置角色补权限,新建的自定义角色不会被自动补授,加了新菜单后要自己勾上。' }
])
export const helpAlertCenter = P('预警中心', '「已读」不等于「已处置」。', [
{ k: 'confuse', t: '点完已读为什么问题还在', text: '标记已读只是不再提醒,预警不会替你修任何业务数据。该退的料、该收口的下发、该重试的同步,都要回对应业务页去做。' },
{ k: 'tip', t: '开机会自动对账', text: '服务启动约 15 秒后会自动做一次 PLC↔MES 对账,命中差异会新增一类开机对账预警,属于正常巡检结果。' }
])
export const helpAlertRule = P('预警规则', '规则负责提醒,不负责拦人。', [
{ k: 'confuse', t: '规则与硬拒的边界', text: '停用一条规则只是不再产生这类预警,业务里的硬拒绝(比如停用工位不让叫料)照样生效,那是业务守卫在做。' },
{ k: 'complex', t: '阈值改小', text: '预警量会明显变多,历史预警不会因为停用规则或改阈值而消失。' }
])
export const helpEventLog = P('操作日志', '只读、只追加,谁在什么时候做了什么都留在这里。', [
{ k: 'tip', t: '本页不改数据', text: '要修正业务结果,回对应业务页操作;日志只是留痕,不会因为你在这里改了什么而变化。' },
{ k: 'confuse', t: '日志不等于台账', text: '它记录动作,不记录库存/数量的完整账目。对数量要去库存、出入库、盘点页查。' }
])
export const helpAttachment = P('附件中心', '本页只供查阅,不提供删除。', [
{ k: 'states', t: '三种状态', text: '正常、已删除(还能查到记录、打开时会先告知)、可清除(过了安全期且没有引用)。' },
{ k: 'confuse', t: '删除 ≠ 清除', text: '删除只是标记,文件还在服务器上、还能追溯;清除才是真正把磁盘文件删掉,不可恢复,而且只对保护期外、且没有被任何业务单据引用的附件开放,操作要实名留痕。' }
])
export const helpDataArchive = P('数据归档', '这一页有不可恢复的操作,点之前先确认备份。', [
{ k: 'irreversible', t: '两种清理不是一回事', text: '按时间窗清理只动保护期外、且已确认备份过的数据;「强制清理」在备份不完整时也能执行,两次确认加实名留痕,提示里写明未备份数据会被永久删除。除非明确知道在做什么,不要用强制清理。' },
{ k: 'confuse', t: '附件的删除/恢复', text: '删除是标记,恢复能把它拉回来;一旦物理清除就拉不回来了。' }
])
export const helpSyncFailure = P('同步失败台账', '系统不会自动重试,也不补传。', [
{ k: 'states', t: 'PENDING / SUCCESS / DEAD', text: '待处理、重试成功、彻底失败。' },
{ k: 'confuse', t: '重试到底重放什么', text: '只重放那一条通知,绝不重跑本地业务。所以重试不会重复扣库存、不会重复建单。' },
{ k: 'irreversible', t: '标记已处理', text: '标记之后这一行不再重试,等于人工确认「对端已经有了、不用再发」。点之前先到对端查一下,不然会永久漏掉这条通知。' }
])
export const helpChangePassword = P('修改密码', '改密只影响本账号登录,不影响任何业务数据。', [])
export const helpLogin = P('登录', '连续失败时先确认账号是否被停用,再找管理员重置。', [])
// 兼容既有页面的 import 名(页面引用的是短名)
export const helpRole = helpRoleManage
export const helpQuality = helpQualityInspection
export const helpAudit = helpAuditPending
export const helpProducible = helpProducibleSupport
// 保留导出:PLC↔MES 对账的已知局限,供排查时查阅
export const helpPlcMesMismatch = P('PLC↔MES 对账说明', '对账比对的是 MES 工位台账与 PLC 上报点位,两边口径不完全等价。', [
{ k: 'confuse', t: '差异不一定是错账', text: 'PLC 断连、点位刚被人工纠正、工件正在流转途中,都会短暂不一致。先按「断电恢复三步法」核实物位置,再决定是撤回下发还是人工完成收口。' }
])