feat: 完成产线与仓储系统多模块迭代升级

本次迭代覆盖MES与WMS核心业务:
1. 新增接驳台托盘传感器读取与AGV对接能力
2. 完善工单排产、备料流程与权限体系拆分
3. 优化看板接口与前端路由、样式
4. 新增操作日志、库存盘点与角色保护逻辑
5. 修复代理地址、BOM保存等已知问题
This commit is contained in:
SunYF
2026-09-04 14:18:53 +08:00
parent c1fc6d32b2
commit b6799c9de4
138 changed files with 20613 additions and 2220 deletions
+52 -13
View File
@@ -48,7 +48,7 @@ export const helpOutbound = {
'所有出库都落在同一张「出库主表」(OutboundOrder),用"类型"区分,装箱信息(箱号/SN清单/合同号)也直接记在主表上,不再单独建装箱表。\n两个出库页签 + 一个记录页签:\n· 工单备料出库(MES):对接 MES 工单台账领料,强约束"单物料累计出库 ≤ 工单需求总量";未启用 MES 或工单未同步时,工单下拉可能为空,可直接手输工单号(需台账已同步)。\n· 通用出库:不依赖工单的手动出库(退料/样品/报废/发货),支持结构件批次与精密件 SN,填箱号即一并记录装箱;MES 不可用或无需挂靠工单时请用本页。\n· 出库记录:统一主表的全量查询与导出(一键导出 CSV,含装箱信息)。\n选用原则:有 MES 工单要按 BOM 领料 → 工单备料出库;无工单的自由出库/装箱发货 → 通用出库。',
fields: [
{ name: '备料出库-工单号', source: '手动输入。数据来自 MES 已建的工单及导入的物料台账。', purpose: '出库挂靠的工单,决定可领料总量与需求缺口', fill: '输入工单号回车,查询该工单的物料台账' },
{ name: '备料出库-目标工位', source: '手动填写。', purpose: '本次配送送达的接驳台/DOCK', fill: '如 DOCK-A,可空' },
{ name: '备料出库-目标工位', source: '下拉选择 DOCK01~DOCK20(选填,可过滤搜索)。', purpose: 'AGV 配送送达的接驳台(toDock 参数)', fill: '选择如 DOCK05;不选默认运到产线入口 DOCK01' },
{ name: '备料出库-一键分配出库', source: '系统自动按 FIFO 分配。数据来自合格区Z02的批次库存。', purpose: '从合格区按先进先出凑够缺口并出库', fill: '点按钮,系统自动算批次并二次确认' },
{ name: '通用出库-物料/类型', source: '下拉选择物料;类型选"结构件(批次)"或"精密件(SN)"。', purpose: '决定走批次扣减还是 SN 扣减', fill: '选物料后选类型;批次填批次号+数量,SN 扫入 SN 列表' },
{ name: '通用出库-箱号', source: '手动填写(选填)。', purpose: '整箱发货时填写,装箱信息随出库单记录(无需再单独录入装箱)', fill: '填箱号后,本出库单即带装箱属性,可在"出库记录"按箱号追溯' },
@@ -60,12 +60,15 @@ export const helpOutbound = {
export const helpInventory = {
title: '库存查询',
overview:
'查看当前库存:结构件按批次台账(数量/锁定/区域),精密件按 SN 序列号(状态/区域)。\n数据由入库、出库、盘点等业务实时维护,本页只读查询。\n\n三个层级概念(自下而上):\n· SN 序列号:精密件单件唯一码,可逐件追溯。\n· 批次号:同物料、同一次到货的库存聚合标识(如 B20260901xxxx),一个批次可含多件。\n· 入库单号(IBxxx):一次到货/入库动作的凭证,一个入库单可包含多个批次或多个 SN(以及它们的明细)。\n即:入库单 → 批次/SN → 库存行。库存行上的"入库单号"即它的来源凭证,点单号可跳转入库页看该单完整明细。',
'查看当前库存:结构件按批次(数量/锁定/区域),精密件按 SN(状态/区域)。数据由入库、出库、检验、盘点等业务实时维护,本页只读。\n\n本页三个视图页签(首屏默认「物料汇总」):\n· 物料汇总:一物料一行,直接回答"这个物料总共有多少"——总量/锁定/可用 + 质量分布(合格/未检/不合格) + 分布在哪些区域;点行下钻该物料的批次/SN 明细。\n· 库存明细:按 物料 × 区域 × 质量 聚合,可组合 区域/质量状态/入库时间 筛选(物料汇总不受区域/质量筛选影响)。\n· 区域汇总:按 区域 × 质量状态 × 类型 看各库区的货量。\n\n层级概念:入库单 → 批次/SN → 库存行。区域/质量状态/批次/最近入库单都是某物料的一对多属性,放在下钻明细中查看,不在物料行上并排平铺。',
fields: [
{ name: '物料编码', source: '筛选条件。', purpose: '只看某物料', fill: '输入编码,可空=全部' },
{ name: '库存类型', source: '单选(批次 / SN 序列)。', purpose: '看批次台账还是 SN 序列,各自独立分页', fill: '批次 / SN 序列' },
{ name: '关键字', source: '筛选条件。', purpose: '按批次号/物料名称/SN 模糊过滤', fill: '输入关键字,可空' },
{ name: '入库单号', source: '筛选条件 + 列表列。数据来自每次入库生成的 IBxxx 凭证。', purpose: '追溯某批库存"来自哪次入库";与批次号不同:批次号是库存聚合标识,入库单号是入库动作凭证(一个单可含多批次/多SN)', fill: '输入 IB 单号过滤,或点列表里的单号跳转入库明细' }
{ name: '物料编码 / 物料名称', source: '筛选条件。', purpose: '只看某个物料', fill: '输入编码或名称,可空=全部' },
{ name: '库存类型', source: '单选(全部/结构件/精密件)。', purpose: '按管理粒度过滤', fill: '全部 / 结构件(批次) / 精密件(SN)' },
{ name: '物料汇总-质量分布', source: '系统按当前在库行统计。', purpose: '一个物料合格/未检/不合格各多少', fill: '合格/未检/不合格三列,自动统计' },
{ name: '物料汇总-分布区域', source: '系统统计该物料当前占用了哪些区域。', purpose: '一个物料可跨多个区域存放(批次可拆分),物料行不写死单一区域', fill: '如 Z02、Z05;点行下钻可看每个批次/SN 具体在哪个区' },
{ name: '库存明细-区域/质量/入库时间', source: '仅「库存明细」视图生效的筛选。', purpose: '在物料基础上再按存放区/质量状态/入库时间收窄', fill: '可组合筛选' },
{ name: '批次/SN 明细(下钻)', source: '点击任一行弹出抽屉。', purpose: '看该物料的每个批次/SN 所在区域、质量状态、锁定与来源入库单', fill: '抽屉内分页展示;点入库单号可跳转入库页' },
{ name: '导出', source: '按钮。后端按当前筛选全量导出 xlsx。', purpose: '把结果导出存档', fill: '物料汇总视图导出「物料汇总.xlsx」;库存明细视图导出「库存汇总.xlsx」' }
]
}
@@ -87,18 +90,19 @@ export const helpInspection = {
export const helpStocktake = {
title: '盘点(库存核对)',
overview:
'核对账面与实际库存,支持扫码快速盘点,完成时按差异修正库存。\n流程:发起盘点(冻结快照) → 扫码录入实盘数(入库) → 完成并生成差异(可选:差异写回库存)。',
'核对账面与实际库存,支持扫码快速盘点,完成时按差异修正库存。\n页面顶部有步骤条引导流程:发起盘点 → 扫码实盘 → 确认差异并写回。\n流程:① 发起盘点(全库/按区域/按物料,生成盘点单号) → ② 扫批次号/SN 录实盘数(回车提交) → ③ 完成盘点(可选:差异写回库存),并展示差异明细。\n\n「物料分布」相关视图已并入「库存查询」页的物料汇总/库存明细,本页专注盘点流程。',
fields: [
{ name: '盘点范围', source: '发起时选择。', purpose: '冻结快照的范围', fill: '全库 / 按区域(多选) / 按物料(多选+类型)' },
{ name: '操作人', source: '登录账号自动带出。', purpose: '发起盘点人', fill: '自动' },
{ name: '发起盘点', source: '按钮操作。', purpose: '冻结当前库存快照,生成盘点单', fill: '点按钮发起' },
{ name: '发起盘点', source: '按钮操作。', purpose: '按所选范围生成盘点单号并冻结库存快照', fill: '点按钮选择范围后发起' },
{ name: '差异写回库存', source: '开关。', purpose: '完成后是否用实盘差异修正账面库存', fill: '开=写回;关=仅记录差异' },
{ name: '批次号 / SN 序列号', source: '扫码枪。来自批次号/SN条码。', purpose: '要盘点的批次号(结构件)或 SN(精密件)', fill: '扫批次号/SN,回车提交' },
{ name: '批次号 / SN 序列号', source: '扫码枪。来自批次号/SN条码。', purpose: '要盘点的批次号(结构件)或 SN(精密件)', fill: '扫批次号/SN,回车提交;同一目标重复扫=覆盖实盘数' },
{ name: '实盘数量', source: '扫码/手输。', purpose: '实际数到数量', fill: '非负整数;0=盘亏为零' }
]
}
export const helpSemi = {
title: '半成品/成品(流转)',
title: '半成品管理(流转)',
overview:
'产线工位"暂存/退回"的半成品或完工成品先在此入库(记已完成工序),需要时再出库(重上线),MES 从下一工序继续。\n\n闭环逻辑(与 MES 自动打通):\n' +
'① 工位终端"暂存退库" → 调 MES 工序流转接口 → MES 自动调 WMS /api/internal/semi/inbound 入库(带 SN、工单号、已完成工序码)。\n' +
@@ -136,10 +140,22 @@ export const helpLedger = {
{ name: '工单号', source: '筛选条件。数据来自 MES 工单。', purpose: '只看某个工单的领料台账', fill: '输入工单号(可空=查全部工单)' },
{ name: '物料编码', source: '筛选条件。', purpose: '按物料编码精确过滤', fill: '输入物料编码(可空)' },
{ name: '物料名称', source: '筛选条件。', purpose: '按物料名称模糊过滤', fill: '输入物料名称关键字(可空)' },
{ name: '状态', source: '筛选条件。可选项:进行中 / 领料完结。', purpose: '只看某一领料状态的行', fill: '下拉选择;全部=不过滤' },
{ name: '状态', source: '筛选条件。可选项:待领料 / 部分领料 / 领料完结。', purpose: '按领料进度过滤', fill: '待领料=还没出过库;部分领料=已出库但没领完;领料完结=缺口为 0(前两种均由"进行中"按已出库数实时派生)' },
{ name: 'ID', source: '台账记录主键(系统生成,只读)。', purpose: '唯一标识一行台账,便于定位与对接', fill: '系统自动生成,无需填写' },
{ name: '需求总量 / 已出库 / 缺口', source: '系统计算。需求总量来自 BOM;已出库随出库自动累加;缺口 = 需求总量 − 已出库。', purpose: '一眼看清某物料还差多少未领', fill: '自动;缺口为 0 即领料完结' },
{ name: '状态标签', source: '系统判定。', purpose: '进行中=仍有缺口;领料完结=已足额出库', fill: '自动' }
{ name: '状态标签', source: '系统实时派生。', purpose: '待领料(未出过库) / 部分领料(出过但仍有缺口) / 领料完结(已足额出库)', fill: '自动' }
]
}
export const helpAgv = {
title: 'AGV 配送',
overview:
'AGV(海康 RCS)配送管理:库房出库后由 AGV 将物料托盘送到产线接驳台。\n\n触发链路:MES 排产时确认送达接驳台(DOCK01~20 产线 / DOCK21 库房)→ 备料单自动带上 target_dock → 本页「下发AGV」由仓库人员勾选待发料行、确认目标接驳台后点击下发 → 系统按目标口分组生成 AGV 任务并调海康 RCS。\n\n接驳台状态:有传感器,PLC 可反馈「是否有托盘」;AGV 到达目标口前系统可查询该口是否空闲,托盘未清走前不会再次下料到该口。\n\n说明:RCS 未配置 appKey/appSecret 时走模拟模式(mock),用于联调完整链路;现场配置后自动切换真实调度。',
fields: [
{ name: '接驳台状态', source: '系统维护。DOCK01~20 产线(对应工位 1~20)+ DOCK21 库房。', purpose: '查看每个接驳台当前是否有托盘', fill: '绿色=空闲(无托盘);橙色=有托盘(占用中,AGV 到达前需确认空闲)' },
{ name: 'AGV任务', source: '系统生成。每次下发一个目标口生成一条任务。', purpose: '追踪每批料的搬运进度', fill: '状态:待下发 → 待搬运 → 搬运中 → 已到位;到位后自动回写备料单状态' },
{ name: '下发AGV', source: '勾选 MES 备料单待发料行(含排产时确认的 target_dock)。', purpose: '仓库人员将放好货的托盘交付 AGV 搬运', fill: '行内可改目标接驳台、可批量设同值;确认后按目标口分组生成任务。操作人是当前登录账号' },
{ name: '源点', source: '默认 DOCK21(库房),可改。', purpose: 'AGV 从哪里取货', fill: '下拉选择,默认库房口' }
]
}
@@ -179,4 +195,27 @@ export const helpDashboard = {
title: '库房看板',
overview: '只读看板:库存总量、物料种类、出入库动态等。\n数据实时读取统计接口,本页不可编辑。',
fields: []
}
}
export const helpEventLog = {
title: '操作日志',
overview:
'审计查看关键业务操作记录,数据来自操作日志(event_log)表,只读。\n哪些动作会被记录:账号/角色/权限初始化、物料档案与区域维护的增改与导入、入库、出库、质量检验、库存盘点、半成品出入库。\n页面为查询列表,支持按事件类型、操作人、时间范围筛选,分页查看。',
sections: [
{
title: '查询区',
overview: '组合筛选后点【查询】生效,【重置】清空条件。',
fields: [
{ name: '事件类型', source: '下拉。', purpose: '按业务域过滤(账号/角色/入库/出库…)', fill: '选一族或留空=全部' },
{ name: '操作人', source: '输入用户名。', purpose: '只看某人的操作', fill: '模糊无需,精确输入用户名' },
{ name: '时间范围', source: '日历选择。', purpose: '限定发生时间区间', fill: '选起止日期;不选=全部时间' }
]
},
{
title: '列表',
overview: '一行为一次操作。事件类型列以中文标签按业务域归类,原始类型码显示在后。',
fields: [
{ name: '对象 / 对象标识', source: '来自操作时的业务对象。', purpose: '说明这次操作作用在什么业务上', fill: '如 账号→用户名ID、入库→入库单号' }
]
}
]
}