Skip to content

品质与生管-追溯查询SOP

文档编号: BayesMES-SOP-TRACE-001-V1.0 文档版本: V1.0 适用系统: BayesMES 制造执行系统 适用角色: 品质主管、生管、技术员 适用终端: Web端 + App端 角色类型: 班组长/主管 最后更新: 2026-04-29 下次评审: 2026-10-31 文档状态: 草稿 编制人: BayesMES团队 审核人: ysfl 批准人: ysfl


目录


🎯 5分钟快速上手

💡 不确定该查“正向、反向还是全生命周期”时,优先使用首页的“快速溯源”。

核心判断规则

手里是什么码推荐入口系统行为
工单码快速溯源系统先查工单对应批次,再进入全生命周期
成品/半成品批次码快速溯源 或 全生命周期直接按批次展示完整上下游链路
原材料标签(带批次号)快速溯源 或 正向追溯查看这批原料流向了哪些成品/半成品
非批次管理物料标签不支持系统提示无法溯源

最简操作步骤

  1. 进入 追溯管理 首页。
  2. 优先使用 快速溯源,扫码或输入工单号、批次号、物料批次号。
  3. 若系统自动跳转到 正向追溯,说明你扫到的是原材料批次。
  4. 若系统自动跳转到 全生命周期追溯,说明你扫到的是工单码或产品/半成品批次。
  5. 需要快速追查来源时,进入 反向追溯 查看原材料、供应商、工序、报工和销售关联。

快速流程

text
进入追溯管理 → 快速溯源 → 扫码/输入 → 系统判断码类型 → 自动跳转正确页面 → 查看结果 / 继续钻取

一、名词术语表

术语英文/缩写解释
正向追溯Forward Trace从原材料批次往下查看被哪些成品或半成品使用
反向追溯Backward Trace从成品或半成品批次往上查看用了哪些原材料
全生命周期追溯Lifecycle Trace从采购、收货、入库、投料、生产、质检到销售的全过程追溯
批次号Batch No.用于建立追溯链的关键编号
工单码Work Order QR工单标签上的二维码,系统可先解析工单再定位批次
原材料标签Material Label物料标签;只有带批次号的标签才能追溯
半成品Semi-finished Product内部生产出来、还能继续向下展开投料链的中间产品
炉号Heat No.冶金批次号,用于原材料追溯
采购追溯Purchase Trace查看供应商、采购订单、收货记录、库存批次
工单树Work Order Tree成品工单与下级半成品工单的层级结构
工序链Operation Chain工单在各工序上的执行顺序和报工信息
NCRNon-Conformance Report不合格品单,用于追踪质量异常处理

二、功能概述

2.1 功能说明

追溯分析模块用于查询批次上下游关系,支持以下三类真实场景:

  • 快速溯源:先识别你手里的码是什么,再自动跳转到正确追溯页面。
  • 正向追溯:回答“这批原材料后来流向了哪些产品/半成品”。
  • 反向追溯:回答“这批产品最初用了哪些原材料、来自哪些供应商、经过哪些工序”。
  • 全生命周期追溯:回答“这批产品从采购到发货全过程发生了什么”。

2.2 适用场景

场景推荐入口说明
供应商来料异常影响范围分析正向追溯从原材料批次查影响到哪些产品
客诉批次根因定位反向追溯从成品批次往上查原料、工序、设备、质检
审计或客户完整追溯报告全生命周期追溯查看时间线、工单树、工序链、客户发货
不确定码类型快速溯源让系统自动判断并跳转

2.3 功能特点

  • Web端与App端都提供 追溯管理 首页,并都包含 快速溯源
  • Web端快速溯源支持输入或粘贴工单二维码、批次二维码、物料标签 JSON。
  • App端快速溯源支持扫码和手动输入。
  • 工单码不会直接查追溯接口,而是先解析成批次,再进入全生命周期页面。
  • 非批次管理物料会直接提示不支持,不会生成伪结果。
  • 反向追溯支持从原材料行跳到正向追溯,也支持对半成品继续钻取上游。
  • 全生命周期追溯会在有数据时展示质检、设备、工装、客户信息页签。

2.4 数据依赖关系

text
工单码/批次码/物料标签

追溯管理首页(快速溯源)

工单 → 先解析批次
批次 → 生命周期/反向
物料批次 → 正向

采购订单 / 收货 / 库存批次 / 投料 / 报工 / 容器更换 / 返工 / 质检 / 设备 / 工装 / 销售订单

三、操作前准备

3.1 权限要求

操作说明
查看追溯首页能进入 追溯管理 模块
正向追溯能查看原材料去向
反向追溯能查看产品来源
全生命周期追溯能查看完整全过程数据

如无法进入页面或查询结果始终报权限问题,请联系系统管理员配置追溯相关权限。

3.2 前置条件

条件说明
标签内容可识别工单码、批次码或物料标签内容完整
物料为批次管理非批次管理物料无法建立追溯链
工单已关联批次工单码要能解析到批次,才能进入全生命周期
业务数据已落库采购、收货、投料、报工、质检等环节至少已有部分真实记录

3.3 基础数据准备

数据作用常见来源
原材料库存批次支撑采购来源与炉号追溯仓库收货入库
物料消耗记录支撑原材料与批次的上下游关系生产投料
生产批次支撑成品/半成品批次查询报工产出
工单与工序支撑工单树、工序链计划/生产执行
质量、设备、工装数据支撑全过程附加信息质检、设备、工装模块
销售订单支撑客户与发货去向销售管理

四、操作流程详解

4.1 流程总览

📊 流程图示(Obsidian查看):

工单码成品/半成品批次码原材料标签且有批次号已明确知道查询方向工单码/批次码原材料批次非批次管理物料进入追溯管理手里是什么码?快速溯源直接进入对应页面系统识别结果进入全生命周期追溯进入正向追溯提示不支持反向追溯查看关联成品批次查看原材料/采购/报工/销售点击半成品继续钻取查看时间线/工单树/工序链/质检/设备/工装/客户

📋 流程表格(Word/PDF导出):

步骤操作说明输出
1️⃣进入追溯管理Web或App打开追溯首页快速溯源入口
2️⃣扫码或输入支持工单码、批次码、物料批次系统识别码类型
3️⃣自动或手动进入页面正向 / 反向 / 全生命周期对应追溯结果
4️⃣查看结果查看上游来源、下游去向、过程数据追溯结论
5️⃣继续钻取点击批次或半成品批次继续追踪更深层级链路

4.2 步骤一:进入追溯管理首页

Web端入口

菜单进入 溯源系统,打开首页后页面标题为 追溯管理

App端入口

首页模块菜单 → 追溯管理

页面上可见的真实入口

终端页面结构
Web端正向追溯反向追溯全生命周期 三个入口 + 快速溯源卡片
App端快速溯源卡片 + 三张入口卡片(正向追溯、反向追溯、全生命周期)

📷 【截图01-追溯首页总入口】

  • 快速溯源 区域
  • 正向追溯
  • 反向追溯
  • 全生命周期
Web端追溯首页总入口

图4-1 Web端追溯首页总入口

App端追溯管理首页

图4-2 App端追溯管理首页

4.3 步骤二:优先使用快速溯源

适用场景

  • 不确定该进哪个追溯页面
  • 手里是工单码,需要系统自动定位批次
  • 扫到的是二维码原文或物料标签 JSON

Web端操作

  1. 快速溯源 输入框粘贴或扫码录入内容。
  2. 点击 立即溯源
  3. 系统按内容判断跳转目标:
    • 工单码:进入 全生命周期追溯
    • 原材料批次:进入 正向追溯
    • 成品/半成品批次:进入 全生命周期追溯

App端操作

  1. 在首页 快速溯源 点击 扫码,或直接手动输入。
  2. 点击 立即溯源
  3. 系统按内容判断跳转目标,规则与 Web 端一致。

真实识别规则

识别内容系统处理
type = WORK_ORDER 或文本以 WO- / MO- 开头先查工单对应批次,再跳全生命周期
type = MATERIAL 且有 batchNo跳正向追溯
type = BATCH / INVENTORY / INVENTORY_BATCH跳全生命周期
type = MATERIAL_NON_BATCH直接提示不支持
内容为空提示输入工单号、批次号或物料批次号

业务限制

  • ⚠️ 工单码若未生成批次,系统会提示“这张工单还没有生成批次,暂时不能溯源”。
  • ⚠️ 非批次管理物料会提示“这类物料没有批次号,当前不支持溯源”。

📷 【截图02-快速溯源卡片】

  • ① 输入框
  • 扫码
  • 立即溯源
  • ④ 支持码类型说明
Web端快速溯源卡片

图4-3 Web端快速溯源卡片

4.4 步骤三:执行正向追溯

适用问题

这批原材料后来去了哪些产品或半成品?

Web端路径

追溯管理正向追溯

App端路径

追溯管理正向追溯

操作步骤

  1. 扫描原材料标签,或手动输入原材料批次号。
  2. 点击 查询(Web)或执行扫码/查询(App)。
  3. 系统返回该原材料关联的成品/半成品批次列表。
  4. 若需要继续查某个产品来源,点击结果中的批次号进入 反向追溯

结果页面会展示

区域真实内容
汇总信息原材料批次号、炉号、总批次数、总数量、工单数、消耗总量
采购来源供应商、采购订单、收货记录、库存批次
成品批次列表批次号、工单号、物料编码、物料名称、计划数量、当前数量、消耗数量、状态、投料时间

状态与结果说明

  • 找到记录时,页面展示采购来源和成品批次列表。
  • 未找到记录时,页面提示“没有找到这批原材料的流向记录,请确认批次号是否正确”。

业务限制

  • ⚠️ 只能查询带批次号的原材料标签。
  • ⚠️ Web 端点击成品批次号会跳到 反向追溯 页面。
  • ⚠️ App 端点击成品批次卡片会进入对应批次的 反向追溯

📷 【截图03-正向追溯查询页】

  • ① 原材料批次输入区
  • ② 汇总信息
  • ③ 原材料采购来源
  • ④ 成品批次列表
Web端正向追溯查询页

图4-4 Web端正向追溯查询页

App端正向追溯页面

图4-5 App端正向追溯页面

4.5 步骤四:执行反向追溯

适用问题

这批产品最初用了哪些原材料?来自哪里?经过哪些工序?

Web端路径

追溯管理反向追溯

App端路径

追溯管理反向追溯

操作步骤

  1. 扫描成品批次码或半成品批次码,或手动输入批次号。
  2. 点击 查询
  3. 系统展示该批次的汇总信息、原材料、采购信息、工单、生产订单、报工、容器更换、返工和销售订单。
  4. 需要查某条原材料的下游影响时,点击该原材料批次进入 正向追溯
  5. 若某条投料是 半成品,可继续点击其批次号,向上钻取它的上游投料链。

结果页面会展示

区域真实内容
汇总信息批次号、炉号汇总、原材料数、报工数、容器更换次数、是否有返工/工单/生产订单/销售订单
批次信息批次号、工单号、物料、计划数量、当前数量、状态、容器编码、创建时间
原材料投料原材料/半成品标识、批次号、炉号、消耗量、工序、投料时间
原材料展开详情原材料显示采购链;半成品显示来源工单和下级投料
报工记录工序、操作员、设备、刀具、检具、完成/合格/不合格数量、报工时间
容器更换更换序号、原因、旧容器、新容器、操作员、时间
返工记录返工单号、原因、类型、数量、状态
销售订单订单号、客户名称、日期、状态

状态变化

本页面为查询类页面,不修改业务单据状态;但会根据现有真实数据展示批次、工单、销售订单是否已关联。

业务限制

  • ⚠️ 反向追溯未找到批次时,后端返回未找到结果,页面提示“没有找到这批产品的追溯记录,请确认批次号是否正确”。
  • ⚠️ 反向追溯展示的数据深度受实际业务记录影响;没有销售订单、返工、容器更换时会显示为空。
  • ⚠️ 多级 BOM 情况下,顶层投料可能先看到半成品,需要继续展开或钻取,才能看到最底层原材料。

📷 【截图04-反向追溯汇总页】

  • ① 批次号与炉号汇总
  • ② 汇总统计
  • ③ 页签区
  • ④ 原材料/半成品投料列表
Web端反向追溯汇总页

图4-6 Web端反向追溯汇总页

Web端反向追溯原材料展开详情

图4-7 Web端反向追溯原材料展开详情

App端反向追溯页面

图4-8 App端反向追溯页面

4.6 步骤五:查看全生命周期追溯

适用问题

这批产品从采购到发货全过程发生了什么?

Web端路径

追溯管理全生命周期

App端路径

追溯管理全生命周期

操作步骤

  1. 输入批次号,或通过 快速溯源 自动带入批次。
  2. 点击 追溯
  3. 系统按该批次生成全生命周期结果。
  4. 依次查看 时间线阶段汇总工单树工序链,以及有数据时显示的 质检设备工装客户

结果页面会展示

区域真实内容
阶段汇总原材料种类、供应商数、工序数量、报工次数、合格率、已发货数量
时间线采购、收货、入库、投料、生产、返工、质检、设备、工装、销售事件
工单树主工单及下级半成品工单层级
工序链各工序顺序、所属工单、完成/合格/不合格数据
质检页签检验任务、检验结果、NCR不合格品单
设备页签设备点检记录、设备上下机记录
工装页签刀具使用记录、模具使用记录
客户页签客户信息、发货地址、发货方式、发货进度

差异说明

页面适合场景
反向追溯快速定位原材料来源与生产责任
全生命周期追溯完整查看全过程、出报告、审计留档

业务限制

  • ⚠️ 该页面要求输入的是批次号;如果手里是工单码,应先回首页使用 快速溯源
  • ⚠️ 如果查询的是原材料批次,业务上应改用 正向追溯 查看下游去向。
  • ⚠️ 只有存在相关业务数据时,质检、设备、工装、客户页签才会显示内容。

📷 【截图05-全生命周期追溯页】

  • ① 批次号输入与 追溯
  • ② 阶段汇总卡片
  • ③ 时间线
  • ④ 工单树 / 工序链页签
Web端全生命周期追溯页

图4-9 Web端全生命周期追溯页

App端全生命周期追溯页面

图4-10 App端全生命周期追溯页面

4.7 步骤六:继续钻取与联动查询

可继续钻取的真实入口

当前页面可点击内容跳转结果
正向追溯成品批次号进入反向追溯
反向追溯原材料批次号进入正向追溯
反向追溯半成品批次号重新发起该半成品的反向追溯
快速溯源工单码自动转到全生命周期

使用建议

  • 追查供应商异常影响范围:先 正向追溯,再点进具体成品批次查 反向追溯
  • 追查客诉根因:先 反向追溯,需要完整报告时再切 全生命周期
  • 看到半成品投料时不要停在顶层,应继续钻到原材料层。

五、关键业务关联关系

5.1 真实追溯链

text
原材料采购订单
→ 采购收货
→ 库存批次
→ 生产投料
→ 生产批次
→ 报工记录
→ 容器更换 / 返工 / 质检 / 设备 / 工装
→ 销售订单 / 客户信息

5.2 不同入口之间的关系

入口主要用途与其他入口关系
快速溯源自动判断码类型实际上是其他页面的统一入口
正向追溯看原料流向查询结果可跳反向追溯
反向追溯看产品来源查询结果可跳正向追溯,也可钻取半成品
全生命周期看全过程适合输出完整追溯结论

5.3 管理动作建议

情况建议动作
供应商批次异常先做正向追溯,锁定影响批次,再通知质量和计划
客诉批次异常先做反向追溯,锁定原料、工序、责任环节
需要对外汇报使用全生命周期整理完整证据链
出现半成品投料继续向下钻取,直到看到原材料层

六、异常处理与应急措施

6.1 常见异常情况

异常1:扫码后提示不支持溯源

项目内容
现象页面提示“这类物料没有批次号,当前不支持溯源”
可能原因扫到的是非批次管理物料标签
解决方法1. 改扫成品批次码、半成品批次码或原材料批次标签
2. 如必须追查,请先找仓库或管理员确认是否启用了批次管理
预防措施打印和使用标签时区分批次管理物料与非批次管理物料

异常2:工单码无法进入追溯

项目内容
现象系统提示“这张工单还没有生成批次,暂时不能溯源”
可能原因工单尚未生成批次,或工单与批次未关联
解决方法1. 先确认该工单是否已有产出批次
2. 联系生产/计划确认报工与批次生成情况
预防措施对外使用工单码前,先确认已完成批次生成

异常3:查询后显示未找到记录

项目内容
现象页面显示未找到追溯记录
可能原因批次号输入错误、标签内容错误、业务数据尚未形成追溯链
解决方法1. 核对批次号是否完整
2. 换用快速溯源重新识别
3. 核对采购、投料、报工是否已落数
预防措施优先扫码而不是手输,减少批次号录入错误

异常4:全生命周期页面没有质检/设备/工装数据

项目内容
现象页面结果不完整,部分页签为空
可能原因对应模块没有实际业务记录,或该批次未经过该环节
解决方法1. 先确认该批次是否真的经过这些环节
2. 如业务上应有记录,请联系对应模块管理员排查
预防措施执行业务流程时确保关键环节都在系统中留痕

异常5:网络或服务异常

项目内容
现象页面提示“网络连接异常,请稍后重试”
可能原因网络波动、后端服务短时不可用
解决方法1. 重新连接网络后重试
2. 稍后再次查询
3. 联系IT确认接口服务状态
预防措施关键追溯查询时优先使用稳定网络环境

6.2 应急联系人

问题类型联系人联系方式响应时间
追溯页面无法进入系统管理员企业微信 / 内部工单30分钟内
标签内容识别异常业务部门管理员企业微信30分钟内
追溯链数据缺失生产/仓库/质量对应负责人企业微信1小时内
系统接口报错IT技术支持企业微信 / 内部工单15分钟内

七、常见问题解答(FAQ)

Q1:我不知道该用正向还是反向,怎么办?

先用 快速溯源。系统会根据你输入或扫描的内容自动决定进入 正向追溯 还是 全生命周期追溯

Q2:为什么我扫原材料标签,系统没有进入反向追溯?

原材料批次对应的真实业务问题是“它流向了哪些产品”,所以系统会进入 正向追溯,不是 反向追溯

Q3:为什么有些原材料行标成“半成品”?

这说明顶层投料先消耗的是内部生产的半成品,而不是最底层采购原料。此时要继续展开或钻取半成品批次,直到看到原材料层。

Q4:全生命周期和反向追溯有什么区别?

反向追溯 适合快速追来源;全生命周期追溯 适合看全过程、做审计或客户报告。

Q5:为什么我看不到销售订单?

该批次可能还没关联销售订单,或者还未形成销售出货数据。系统会按真实现有数据展示,不会补猜。

Q6:为什么我扫工单码后跳到全生命周期,而不是反向追溯?

因为系统会先用工单码解析批次,再默认进入信息最完整的 全生命周期追溯 页面。


八、操作注意事项

8.1 重要提醒

  • 优先使用扫码,减少手工输入错误。
  • 不确定查询方向时,优先使用首页 快速溯源
  • 工单码不能直接替代批次号做所有查询,系统会先解析批次。

8.2 最佳实践

  • 查供应商问题时:正向追溯 → 反向追溯 组合使用。
  • 查客诉问题时:先 反向追溯,再补 全生命周期追溯
  • 多级 BOM 产品必须确认是否已经钻取到原材料层,不能只停留在半成品层。

8.3 禁止操作

  • 不要把非批次管理物料当成可追溯标签使用。
  • 不要把培训手册中的示意路径当作实际操作路径,必须以当前系统页面为准。
  • 不要在未确认批次号的情况下直接下结论。

九、源码与依据清单

类型文件/路径已核对内容结论
后端路由bayes-mes-base-core-php/backend/app/Modules/Traceability/Routes/api.php追溯接口入口、限流、URL路径与SOP一致
后端控制器bayes-mes-base-core-php/backend/app/Modules/Traceability/Controllers/TraceController.php正向/反向/全链路/生命周期/快速查询逻辑、未找到提示与SOP一致
后端服务bayes-mes-base-core-php/backend/app/Modules/Traceability/Services/TraceService.php采购追溯、半成品递归、多级 BOM、工单树、工序链、质检/设备/工装/销售关联与SOP一致
后端资源bayes-mes-base-core-php/backend/app/Modules/Traceability/Resources/TraceResultResource.php返回结构保持 camelCase与SOP一致
后端测试bayes-mes-base-core-php/backend/tests/Api/Traceability/TraceabilityTest.php正向、反向、全链路的真实返回结构验证与SOP一致
模块文档bayes-mes-base-core-php/docs/功能模块/追溯管理/README.md模块边界、接口说明、设计背景已核对,部分旧示例未直接写入正文
Shared APIbayes-mes-shared/api/traceability/routes.ts前后端统一API路径与SOP一致
Shared 工厂bayes-mes-shared/api/traceability/factory.tsWeb/App 实际调用接口列表与SOP一致
Shared 类型bayes-mes-shared/types/traceability/responses.ts正向、反向、生命周期返回字段与SOP一致
Web 首页bayes-mes-base-web/apps/mes/src/modules/mes/traceability/views/TraceabilityIndex.vue快速溯源、自动跳转规则、三类入口与SOP一致
Web 正向bayes-mes-base-web/apps/mes/src/modules/mes/traceability/views/ForwardTrace.vue输入、查询、采购来源、点击批次跳反向与SOP一致
Web 反向bayes-mes-base-web/apps/mes/src/modules/mes/traceability/views/BackwardTrace.vue汇总、页签、原材料展开、半成品钻取、查看时间线与SOP一致
Web 生命周期bayes-mes-base-web/apps/mes/src/modules/mes/traceability/views/LifecycleTrace.vue阶段汇总、时间线、工单树、工序链、质检/设备/工装/客户页签与SOP一致
Web 交互文案bayes-mes-base-web/apps/mes/src/locales/langs/zh-CN/traceability.json页面提示、异常提示、说明文案与SOP一致
App 首页bayes-mes-app-vue/src/mes/pages/traceability/index.vue扫码快速溯源、三类入口卡片、使用说明与SOP一致
App 正向bayes-mes-app-vue/src/mes/pages/traceability/forward.vue扫码、手输、结果卡片、跳反向与SOP一致
App 反向bayes-mes-app-vue/src/mes/pages/traceability/backward.vueTab切换、半成品钻取、采购详情展开与SOP一致
App 生命周期bayes-mes-app-vue/src/mes/pages/traceability/lifecycle.vue批次输入、时间线、工单树、工序链、质检/设备/工装/客户页签与SOP一致
App 错误文案bayes-mes-app-vue/src/mes/pages/traceability/error-message.ts空输入、未找到、网络异常、不支持情况与SOP一致
App 路由bayes-mes-app-vue/src/pages.json追溯管理正向追溯反向追溯全生命周期追溯 页面标题与SOP一致
实际截图培训文档/模块/10-追溯分析/SOP/images/当前模块目录已建立,但尚未补入最新页面截图待页面启动后补拍

十、关联文档

文档路径用途
TM-10 追溯分析培训手册培训文档/模块/10-追溯分析/培训手册/TM-10_追溯分析培训手册.md模块业务背景与学习材料
SOP编制标准培训文档/管理文档/SOP编制标准.mdSOP编制统一标准
追溯管理模块READMEbayes-mes-base-core-php/docs/功能模块/追溯管理/README.md追溯模块后端说明

十一、截图清单

当前已完成源码核对,截图需在运行环境启动后按以下清单补拍并标注。

编号截图内容标注要点文件名
01追溯首页总入口①快速溯源 ②正向追溯 ③反向追溯 ④全生命周期traceability-01-index-entry.png
02快速溯源卡片①输入框 ②扫码 ③立即溯源 ④支持码类型提示traceability-02-quick-trace.png
03正向追溯页①输入区 ②汇总 ③采购来源 ④成品批次列表traceability-03-forward-page.png
04反向追溯页①批次号汇总 ②统计区 ③页签 ④原材料/半成品区traceability-04-backward-page.png
05反向追溯原材料展开①采购追溯 ②半成品钻取 ③供应商/采购单traceability-05-backward-material-detail.png
06全生命周期页①追溯按钮 ②阶段汇总 ③时间线 ④工单树/工序链traceability-06-lifecycle-page.png
07App首页追溯管理①快速溯源 ②三张入口卡片 ③使用说明traceability-07-app-index.png
08App正向追溯①扫码入口 ②输入区 ③结果卡片traceability-08-app-forward.png
09App反向追溯①Tab区 ②原材料卡片 ③半成品钻取traceability-09-app-backward.png
10App全生命周期①时间线 ②工单树 ③质检/设备/工装/客户页签traceability-10-app-lifecycle.png

十二、版本记录

版本日期修改内容修改原因修改人审核人
V1.02026-04-29新建追溯模块双端SOP草稿,完成源码核对与流程编制依据真实代码补齐模块SOPBayesMES团队ysfl