# 反向追溯

## 1. 功能概述

反向追溯属于 MES 系统数据中台的基础追溯模块，用于从**电池条码**或**半成品条码**出发，反向追溯该电池所使用的全部原材料信息，以树形关系图谱的形式直观展示从制成品到原材料的完整物料组成链路。

**核心功能：**

- 反向追溯查询：输入电池条码或半成品条码，反向追溯其物料组成
- 关系图谱展示：以横向/纵向树形图谱展示物料之间的层级关系
- 节点定位：支持按物料编码、物料批次、工序单元快速定位图谱中的节点
- 数据导出：支持将追溯树结构导出为 Excel 文件

**功能对应截图** ：
![图片：反向追溯功能截图](/public/image/data_middleground/reverse_traceability/图片：反向追溯功能截图.png)

## 2. 术语说明

| 术语 | 定义 | 说明 |
|------|------|------|
| 反向追溯 | Reverse Direction Traceability，从成品/半成品出发逆向追溯原材料的过程 | 与正向追溯（从原材料追溯成品去向）相对 |
| 关系图谱 | Relation Graph，以节点和连线展示物料父子关系的可视化图形 | 支持横向和纵向两种展示形态 |
| 电池条码 | Battery ID，电池在系统中的唯一标识 | 查询的入口条件 |
| 制成品 | 经过加工后产生的中间品或成品 | 图谱中以绿色节点标识 |
| 原材料 | 用于制造制成品的原始物料 | 图谱中以青色节点标识 |
| 工序单元 | Process Unit，标准化工序模块 | 每个物料节点在加工时关联的工序单元 |

## 3. 反向追溯查询

### 3.1 查询说明

反向追溯通过输入电池条码或半成品条码，系统自动回溯该电池在生产过程中各个工序的投料记录，构建从成品到原材料的完整物料树形关系图。

**查询条件：**

| 查询条件 | 说明 | 必填 |
|---------|------|------|
| 电池条码/半成品条码 | 输入需要追溯的电池或半成品条码 | 是 |

**【注意】** 也可从正向追溯页面点击操作列的【反向追溯】按钮跳转过来，系统会自动带入电池条码并执行查询。

### 3.2 查询操作步骤

1. 进入【数据中台】→【基础追溯】→【反向追溯】
2. 在搜索框中输入电池条码或半成品条码
3. 点击【查询】按钮
4. 系统展示物料关系图谱

**功能对应截图** ：
![图片：反向追溯查询条件截图](/public/image/data_middleground/reverse_traceability/图片：反向追溯查询条件截图.png)

## 4. 关系图谱展示

### 4.1 图谱说明

关系图谱以树形结构展示从制成品到原材料的完整层级关系。每个节点代表一个物料（制成品或原材料），连线代表物料之间的投料组成关系。

**图谱节点信息：**

| 节点信息 | 说明 |
|---------|------|
| 节点标识 | 电池条码/半成品条码 |
| 物料名称 | 原材料的名称 |
| 物料编码 | 物料的唯一标识代码 |
| 物料批次 | 物料的批次号 |
| 工序单元 | 物料所经历工序单元的编码 |
| 工序单元名称 | 工序单元的中文名称 |
| 工序编码 | 物料所经历的具体工序编码 |
| 卸料人 | 该工序的卸料操作人员 |
| 投料时间 | 物料投入的开始时间 |
| 完成时间 | 物料加工完成的时间 |
| 类型标签 | 制成品（绿色标签）或 原材料（青色标签） |

**功能对应截图** ：
![图片：反向追溯图谱节点截图](/public/image/data_middleground/reverse_traceability/图片：反向追溯图谱节点截图.png)

### 4.2 图谱形态切换

图谱支持两种展示形态，可通过页面上方的切换按钮进行切换：

| 图谱形态 | 说明 |
|---------|------|
| 横向图谱 | 节点从左至右展开，适合层级较深的树结构 |
| 纵向图谱 | 节点从上至下展开，适合层级较宽的树结构 |

**操作步骤：**

1. 在关系图谱上部找到图谱形态切换区域
2. 点击【横向图谱】或【纵向图谱】切换按钮
3. 图谱自动按选中形态重新渲染

**功能对应截图** ：
![图片：反向追溯图谱形态切换截图](/public/image/data_middleground/reverse_traceability/图片：反向追溯图谱形态切换截图.png)

### 4.3 节点定位

当图谱中节点较多时，可通过节点定位功能快速定位到目标节点。

**定位方式：**

| 定位方式 | 说明 |
|---------|------|
| 物料编码定位 | 输入物料编码，在图谱中定位并居中显示对应节点 |
| 物料批次定位 | 输入物料批次，在图谱中定位并居中显示对应节点 |
| 工序单元定位 | 输入工序单元编码，定位对应节点 |

**操作步骤：**

1. 在关系图谱左侧操作面板中找到"定位"区域
2. 在对应的定位输入框中输入物料编码 / 物料批次 / 工序单元
3. 点击对应的【定位确认】按钮
4. 图谱自动放大并将对应节点居中显示

**功能对应截图** ：
![图片：反向追溯节点定位截图](/public/image/data_middleground/reverse_traceability/图片：反向追溯节点定位截图.png)

## 5. 数据导出

### 5.1 导出说明

反向追溯支持将当前查询的物料树结构导出为 Excel 文件（.xlsx 格式），便于离线分析和归档。

**导出字段：**

| 序号 | 导出字段 | 说明 |
|------|---------|------|
| 1 | 层级 | 物料在树结构中的层级深度 |
| 2 | 电池条码 | 电池/半成品条码，带缩进表示层级关系 |
| 3 | 物料名称 | 原材料的名称 |
| 4 | 物料编码 | 物料的唯一标识代码 |
| 5 | 物料批次 | 物料的批次号 |
| 6 | 工序单元 | 工序单元编码 |
| 7 | 工序单元名称 | 工序单元的中文名称 |
| 8 | 工序编码 | 工序编码 |
| 9 | 投料时间 | 投料开始时间 |
| 10 | 完成时间 | 投料完成时间 |
| 11 | 类别 | 制成品 或 原材料 |

### 5.2 导出操作步骤

1. 在反向追溯页面，先输入电池条码执行查询
2. 确认图谱数据已加载完成
3. 点击【导出】按钮
4. 系统生成 Excel 文件并自动下载到本地

**【注意】** 导出前必须先执行查询，否则会提示"请输入电池条码"。

**功能对应截图** ：
![图片：反向追溯导出截图](/public/image/data_middleground/reverse_traceability/图片：反向追溯导出截图.png)

## 6. 相关功能

| 功能 | 关系 | 说明 |
|------|------|------|
| 正向追溯 | 互为逆向 | 从物料编码+物料批次出发追踪物料被哪些电池使用，可跳转到反向追溯 |
| 产线管理 | 数据来源 | 工序数据来源于产线的生产投料记录 |