Files
bj_power/bj_power_mes/frontend/src/help.js
T
SunYF f65a52d9e1 feat: 多系统新增扫码中间件与 AGV 对接,优化拧紧与退库流程
新增扫码中间件支持网络型扫码枪键盘注入,AGV 对接从 WMS 迁至 MES 统一管理;新增拧紧不合格人工处置与 PLC 对账机制,优化退库单关联与工位终端功能,同时清理旧 AGV 任务表,完善数据库与配置项。
2026-10-14 17:24:59 +08:00

581 lines
81 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: '物料档案(档案维护)',
overview:
'物料档案 = 本页是 WMS「基础数据(物料主数据)」中"成品"物料类别在本系统的视图,与 WMS 指向同一份主数据(以 WMS 为准,实时拉取、不双录)。本页承载的是"要生产哪些成品",是整条产线的源头基础数据。\n\n物料类别来源(与 WMS 一致):原材料=进货来的(外购);半成品、成品=自己生产的;其他=辅料/工装/试验设备等。成品还可以作为零部件,放进另一个成品的物料清单里被再次加工成新的成品。\n\n主数据链条:物料档案(成品) → 工单(选成品+物料清单) → 物料清单(给该产品编码配料) → 日排产 → 备料单 → 库房出库 → 产线生产 → 完工成品自动回流 WMS 入库。\n\n关系说明(几对几):\n· 成品 ↔ 工单:1 对 N。一个成品可以建多个工单(同一型号今天做一批、明天做一批,工单号不同、产品编码相同)。\n· 成品 ↔ 物料清单:1 对多(选用制)。同一成品可并存多份物料清单(不同厂家供货/含半成品结构),用「物料清单名称」区分,工单建单时选定一份,备料/装机都按工单锁定的那份算。\n· 成品 ↔ 备料单:间接。备料单由「日排产 × 工单锁定的物料清单」算出,与成品无直接约束。\n· 强约束:工单/物料清单都挂在产品编码下,成品编码变了,下游关联会断,建议建好后不要改。\n· 与 WMS 的关系:两套系统解耦。物料/图号主数据以 WMS 为单一来源,MES 实时拉取(WMS 不可达时降级为本地只读缓存);成品完工后由系统自动生成 SN 回流 WMS 入库,无需人工对账。',
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: '点「停用」二次确认即可;已停用的行按钮显示「已停用」' }
]
}
export const helpWorkOrder = {
title: '工单管理(新建 / 编辑 / 删除工单)',
overview:
'工单 = 一个"生产批次"的唯一载体,是生产执行和仓库出库挂靠的核心对象。\n\n全流程:先有产品型号(在「物料档案」里建档) → 建工单(选产品型号、定数量、勾选工艺组合) → 进"工艺"给工艺维护工艺步骤与物料清单 → 到"日排产"排哪天产多少 → 仓库按排产备料出库 → 产线装配/拧紧/报工 → 完工(成品 SN 系统自动生成,并自动回流 WMS 入库为"成品"物料类别)。\n产品工号会贯穿 备料单、工件追溯、操作日志 全链路。\n\n客户编号体系(三级归属):一级=合同号/科技项目号(二选一,即「归属类型+归属编号」)→ 二级=产品工号(原工单号,一个产品工号对应一个新建工单/一批)→ 三级=产品序号(工单内每台)。产品编码=图号(与产品型号编码同值,随型号自动带出)。原「工程编号」已被合同号顶替,页面不再展示/录入/查询。\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: '如 01、02(可空)' },
{ name: '数量', source: '手工填写整数。', purpose: '本工单生产总数量(合同台数),决定需求量与排产上限', fill: '整数 ≥1,如 100' },
{ name: '工艺组合', source: '按工艺分组勾选工位(数据来自「工位绑定」页的工位↔工艺绑定)。保存为 [{flowId,stationNo}]。', purpose: '本工单的执行路线;自动排产/备料拆分/产线下发均按此组合派生', fill: '默认每个已绑定工艺的工位全选;至少选一道工艺;全不选某工艺则该工艺不进入组合;执行顺序=工位号升序,可跳过未选工位' },
{ name: '状态', source: '新建时选"已创建",后续由流程推进。', purpose: '工单生命周期:创建→发布→生产→完成', fill: '新建时选"已创建";也可在列表操作列点「状态」快捷流转(发布/开工/完工)' },
{ name: '完成日期', source: '手工填写,完工时必填。', purpose: '记录工单实际完成日期,用于交付与绩效统计', fill: '完工流转时选择日期,必填' },
{ name: '创建人', source: '系统自动记录(当前登录账号)。', purpose: '追溯工单由谁创建', fill: '只读,自动带入' }
]
},
{
title: '工单详情',
overview: '列表操作列「详情」打开只读抽屉:上半部分为工单字段汇总(产品工号/图号/名称/归属/数量/状态/日期),下半部分为该工单的工件SN列表。\n工件SN列表数据来源=工件进线登记记录:产品序号为工单内顺序号,SN 为工件唯一序列号,类型(序列号=是/序列号=否)取自图号对应物料档案的「序列号」设置,状态与当前工位为实时生产进度。',
fields: [
{ name: '工件SN列表', source: '既有工件查询接口按工单号过滤,实时读取。', purpose: '核对该批每台产品的 SN、类型、状态与当前工位', fill: '只读,无需操作' }
]
},
{
title: '工艺组合(路线)',
overview: '新建/编辑工单时勾选「工艺组合」:按工艺分组,每组勾选该工艺要执行的工位。\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: '日排产(生产计划)',
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: '叫料单(只读)',
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: '数量不符处理(差异闭环)',
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: '工位组合下发(下发录入 / 下发记录)',
overview:
'这个菜单做什么用:把某工单/工件的「工位组合」写入产线设备(如 PLC 控制器),产线传送带据此只停靠勾选的工位,其余工位不加工。\n\n页面分两个页签:「下发录入」(默认打开)、「下发记录」(点击才加载,可按工单号/状态筛选)。\n\n操作流程:选工单号 → 下拉选出该工单已上线未完工的工件 SN(也可扫码/手输) → 系统按工件实际进度自动带出「当前工位」(只读) → 工位组合由工单「工艺组合」按工位号升序自动派生 → 下发。\n\n为什么单独一个菜单:产线偶尔需要人工干预——比如本该走 3 号工位却做成了半成品,可到「工单管理」编辑工单的工艺组合(只勾剩余工位)后重上线,完成闭环。\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: '如需调整路线,到「工单管理」编辑工单的工艺组合' }
]
}
export const helpStation = {
title: '工位管理(工位总览)',
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: '虚拟工位 0 / 13', source: '系统预置虚拟工位(工位号 0、13)。', purpose: '原用作产线进线口/出料口的虚拟上下线位,现已废弃该特殊含义,降级为普通虚拟工位', fill: '只读;上线建档/下线完工不再绑定 0/13,改由工位终端「页签」配置(station.visibleTabs)决定哪些工位可显示该面板,任意授权工位均可操作' }
]
}
export const helpVirtualStation = {
title: '虚拟工位作业(MES 后台人工报工)',
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: '全部录入后点「完成报工」;报错按提示补齐' }
]
}
export const helpSettings = {
title: '基础设置(系统管理员)',
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;先用「测试连通」验证再保存' },
{ 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 helpDock = {
title: '接驳台维护(只读主数据)',
overview:
'接驳台是产线与库房之间供 AGV 取送货的物理停靠位,真源在 MES(2026-09-21 自 WMS 迁入)。共 21 个固定编码:DOCK01~DOCK20(产线,DOCKn↔工位n)+ DOCK21(库房收货)。\n\n接驳台为系统预置只读主数据,由种子初始化,本页不提供新增/修改/删除,仅供查看;工位维护、排产推荐、AGV 通讯均以本表为真源查询接驳台。\n\n「占用状态/托盘关联」反映该接驳台当前是否有托盘及托盘对应的出库/备料单,供现场调度参考。',
fields: [
{ name: '接驳台编码', source: '系统预置(种子)。', purpose: '接驳台唯一标识 DOCK01..21', fill: '只读' },
{ name: '接驳台名称', source: '系统预置。', purpose: '接驳台显示名称', fill: '只读' },
{ name: '类型', source: '系统预置。line=产线 / store=库房 / other=其他。', purpose: '区分接驳台所在位置', fill: '只读' },
{ name: '绑定工位', source: '系统预置(产线接驳台与工位 1:1)。', purpose: '该接驳台服务的产线工位号', fill: '只读;库房/其他接驳台不绑工位' },
{ name: '占用状态', source: 'PLC 托盘传感器 / AGV 到位卸货自动维护。', purpose: '当前是否有托盘', fill: '只读' },
{ name: '托盘关联', source: '有托盘时记录对应出库单号/备料单号。', purpose: '查这个托盘是哪批料、要送到哪', fill: '只读' },
{ name: '启用状态', source: '系统预置 ENABLED/DISABLED。', purpose: '停用后不在下拉出现', fill: '只读' }
]
}
export const helpTrace = {
title: '工件追溯',
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: '可空;支持模糊匹配,回车即查' }
]
}
export const helpAccount = {
title: '账号管理',
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: '角色管理',
overview:
'角色决定账号能看哪些菜单(勾选菜单)与能用哪些功能(勾选其下按钮),勾选互不影响。\n内置角色:超级管理员(全部权限)、生产操作员、质检员——不可删除;超级管理员权限不可编辑。',
sections: [
{
title: '新增 / 编辑权限',
fields: [
{ name: '角色名称', source: '手工填写。', purpose: '角色中文名', fill: '如 库房管理员' },
{ name: '角色编码', source: '手工填写。', purpose: '角色唯一编码,创建后不可改', fill: '如 intro-manager' },
{ name: '权限树', source: '勾选。来自系统预置的权限菜单与按钮。', purpose: '决定该角色可见菜单与可用按钮', fill: '勾选菜单=可见;勾选按钮=可用(两者独立)' }
]
}
]
}
export const helpEventLog = {
title: '操作日志',
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: '工艺(作业指导,含工艺步骤与物料清单)',
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: '每个工艺步骤开关。开启后写入 process_step.need_operator_sign=是。', purpose: '签字机制第一签:操作工报工前须在本步骤签字确认,否则报工被拦截', fill: '在步骤行打开开关;报工时工位终端弹「签字确认」采集签字人,落库到 step_sign_record(sign_role=OPERATOR)' },
{ name: '检验员签字确认', source: '每个工艺步骤开关。开启后写入 process_step.need_inspector_sign=是。', purpose: '签字机制第二签:该步骤须由检验员在巡检终端「待签任务」页签签字确认,流程方可放行', fill: '在步骤行打开开关;操作工签字后,检验员到【巡检终端-待签任务】逐行「签字确认」,落库 step_sign_record(sign_role=INSPECTOR),需开通 sys.inspect:sign 权限' },
{ name: '步骤附件/图纸', source: '每个工艺步骤单独上传(绑定式)。文件由 MES 服务器保存。', purpose: '把图纸精确绑定到具体步骤,工位终端按当前步骤自动展示对应图纸', fill: '在步骤行上传该步骤图纸/附件(可多个);随步骤自动分发到工位终端' },
{ name: '物料清单', source: '本页维护:物料编码(下拉选择,取自物料档案)/名称/规格/单位/管理方式/单台用量/损耗率%,整表覆盖保存。', purpose: '该工艺装配所需物料;备料需求 = 各工位分产量 × 单台用量 × (1+损耗率%)', fill: '物料编码取自物料档案编码(结构件通常即图号),选中后名称/规格/单位/管理方式自动带出、不可改;管理方式(序列号)来自物料档案:1=序列号=是(录SN)、2=序列号=否(不录SN)' }
]
},
{
title: '采集方式(每个工艺步骤三选一)',
overview: '决定该步骤的数值从哪里来。',
fields: [
{ 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: '绩效报表(工人工作量统计)',
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 通用)',
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: '来自步骤签字记录(step_sign_record),按 工单号+SN+工位+步骤 聚合。', purpose: '定位待签任务', fill: '只读' },
{ name: '步骤', source: '工艺步骤名称(该步骤配置了 needInspectorSign=是)。', purpose: '待检验员签字的步骤', fill: '只读' },
{ name: '操作工签字', source: '操作工报工前签字记录(signedBy/signedAt)。', purpose: '第一签留证', fill: '只读' },
{ name: '签字确认', source: '弹窗确认后调 POST /signs/inspector。', purpose: '检验员第二签,流程放行', fill: '可填意见,成功提示「已签字」' }
]
},
{
title: '记录查看',
fields: [
{ name: '类型/操作人/日期', source: '筛选条件。来自巡检记录表各字段。', purpose: '过滤历史巡检记录', fill: '可空=全部' },
{ name: '图片', source: '提交时上传的照片,MES 服务器存储。', purpose: '点击缩略图放大查看留证照片', fill: '只读' }
]
}
]
}
export const helpProcessCard = {
title: '生产流程卡(工单维度主卡)',
overview:
'本页以**工单**为唯一主键,展示该工单的「生产实绩 / 追溯卡」:工序实绩、用料清单、成品明细与签字确认;并保留成品 SN 维度的追溯子视图。\n\n三个查询入口(数据源同一套):\n· 工单号 → 工单主卡(首选);\n· 成品SN → 成品追溯卡(SN 维度,逐件追溯工序/用料/拧紧/签字);\n· 产品型号 → 该型号下的工单列表(仅筛选入口,点行内「查看主卡」回到工单维度)。\n\n概念统一:物料「类型」(结构件/电气件/其他)取自 WMS 物料档案 manage_mode;物料「序列号」(序列号=是逐件录 SN / 序列号=否按批)两维严格分离。用料清单按 序列号=是 / 序列号=否 两组分别展示。\n\n用料清单数据来自装配实绩(工位终端装机绑定 workpiece_bind):序列号=是列出每件实际 SN,序列号=否列出批次号。\n\n签字区:操作工 / 检验员 / 审核人 按实际签字人展示(含签字次数与最近时间),单据级「批准人」留手签空位,系统不代填、不加字段。\n\n打印/导出:点「打印 / 导出 PDF」,系统在新窗口打开排版好的 A4 卡片版式,浏览器打印选「另存为 PDF」即导出电子档。\n\n分工:本页是**工单维度主卡**(看一整单的工艺实绩/用料/签字);单件 SN 全链路履历(含装机绑定、物料清单递归组成、暂存退库、检验记录)由「工件追溯」页按 SN 入口提供。两者数据同源,按"查整单进度"还是"查单件履历"互补选择。',
fields: [
{ name: '产品型号', source: '下拉选择,来自「物料档案」页(WMS 物料主数据)。', purpose: '按型号筛选其下工单列表', fill: '选定后清空工单号/SN,进入型号筛选模式' },
{ name: '工单号', source: '手工填写。', purpose: '直接查某工单的生产流程卡主卡', fill: '回车或点查询' },
{ name: '成品SN', source: '手工填写。', purpose: '查某成品的 SN 追溯卡', fill: '回车或点查询' },
{ name: '时间范围', source: '日历选择(月范围)。', purpose: '仅在型号筛选模式下过滤工单列表', fill: '默认上月;不选=全部时间' },
{ name: '工序实绩-审核人', source: '自动带出该工序的审核签字人(AUDITOR)及审核时间。', purpose: '工序级审核放行留痕', fill: '无则显示“-”' }
]
}
export const helpAudit = {
title: '待审核签字(工序级审核)',
overview:
'本页是审核人的「待审任务」工作台:列出已满足前置签字条件的工艺步骤(操作工已签字;若该步骤配置了「需检验员签字」则检验员须 OK),由具审核角色(如班组长/工艺员)的人员复核。\n\n审核定位在**工序级、由工艺配置决定**:工艺步骤是否需审核(process_step.need_audit)及其审核角色(audit_role)在「工艺」页配置。\n\n两种操作:\n· 审核通过(result=OK)→ 该步骤放行;\n· 退回重做(result=NG)→ 撤销该步骤已有的操作工/检验员签字,退回操作工重做(进入新一轮签字)。\n\n审核只记录「审核人 + 审核时间」,不引入签名图片;签字区在「生产流程卡」页照实展示。',
fields: [
{ name: '工单号 / 工件SN', source: '筛选条件。', purpose: '缩小待审范围', fill: '可空=全部' },
{ name: '操作工 / 操作工签字时间', source: '自动带出该步骤操作工签字人及时间。', purpose: '审核前确认是谁做的', fill: '只读' },
{ name: '审核通过', source: '按钮。POST /signs/auditor(result=OK)。', purpose: '审核放行', fill: '点击即生效并刷新列表' },
{ name: '退回重做', source: '按钮。需填退回原因,POST /signs/auditor(result=NG)。', purpose: '审核不通过,退回操作工重做', fill: '撤销该步骤已有签字,进入新一轮' }
]
}
export const helpProductProcess = {
title: '产品工艺(产品级工艺定义)',
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: '质量检验(过程检 / 完工检)',
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: '在制品(跨天在制视图)',
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: '预警中心(系统自动触发)',
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: '预警规则配置',
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: '附件中心(统一存储与查阅)',
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归档清理:本地只保留最近「配置的年数」(默认 1 年),更早的附件可一键归档到外部备份目录并标记「已归档」,释放本地磁盘。\n\n磁盘空间监控:系统每天早上 7 点自动检测磁盘剩余空间,剩余低于 20% 告警、低于 10% 提示执行备份归档清理(本页顶部同步横幅提示,critical 时可直接点「立即归档清理」)。',
fields: [
{ name: '文件类型', source: '上传时由业务场景指定或按扩展名推断(大写枚举)。', purpose: '决定存储目录分层,也是查阅时的主要筛选维度', fill: '下拉单选八类之一,留空=全部' },
{ name: '业务类型', source: '上传时随附件记录写入(工单/物料/工艺/检验/入库 等)。', purpose: '区分附件挂在哪种业务单据上', fill: '下拉单选,留空=全部' },
{ name: '业务ID', source: '上传时写入的业务键(工单号/图号/SN)。', purpose: '定位某个具体单据的全部附件', fill: '支持模糊匹配,如输入工单号' },
{ name: '文件名', source: '上传时的原始文件名。', purpose: '按名称模糊查找', fill: '支持模糊匹配' },
{ name: '上传时间', source: '系统记录上传时刻。', purpose: '按时间区间缩小范围', fill: '可选起止日期,留空=不限' },
{ name: '含已删除', source: '勾选后包含逻辑删除的记录。', purpose: '追溯已删除附件', fill: '默认不勾选' },
{ name: '相对路径', source: '系统按统一规则生成(年/月/日/类型/UUID.ext)。', purpose: '直观看到物理存放位置;点击即在线预览', fill: '只读' },
{ name: '大小', source: '系统统计上传达字节数。', purpose: '评估占用空间', fill: '只读' },
{ name: '状态', source: '系统维护(有效/已归档/已删除)。', purpose: '区分当前可用的与已归档/已删除的附件', fill: '只读' },
{ name: '预览 / 下载', source: '预览走免鉴权直链(PDF/图片浏览器内联打开);下载走鉴权路由并带回中文文件名。', purpose: '查看或另存附件', fill: '点击对应按钮' },
{ name: '删除', source: '行末按钮(权限 sys.attachment:manage,需二次确认)。', purpose: '逻辑删除无效附件(保留可追溯索引)', fill: '点「删除」并确认;无权限时该按钮不显示' },
{ name: '归档清理', source: '按钮(权限 sys.attachment:manage;先预览数量再确认执行)。', purpose: '把早于本地保留年数的附件移到外部备份目录并标记已归档,释放磁盘', fill: '点「归档清理」→确认;无权限时该按钮不显示' }
]
}
export const helpProducible = {
title: '排产支撑',
overview:
'把「库存还能撑多久」算清楚,给计划员排产/叫料决策用。数据来源:日排产(daily_plan,按排产日期窗口、剔除已取消排产)× 工单(work_order)× 工单工艺组合 × 工艺物料清单(flow_material)得到需求量,库存可用量实时来自 WMS(/api/internal/stock/check)。注意:物料需求跟着工单走(同成品不同工单可用不同工艺),且一律按日排产口径计算,工单起止日期仅作参考。\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 helpPlcMesMismatch = {
title: 'PLC↔MES 对账(已知局限)',
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),本轮不纳入对账范围(无终端处置),后续可选。' }
]
}
]
}