# 正向追溯

## 1. 功能概述

正向追溯属于 MES 系统数据中台的基础追溯模块，用于根据**物料编码 + 物料批次**或**半成品码**为入口，追踪物料在哪些电池上被使用，以及经过哪些工序和设备，实现从物料到电池的正向追溯链路。

**核心功能：**

- 正向追溯查询：支持按物料编码+物料批次、半成品码查询追溯数据
- 反向追溯跳转：支持从追溯结果中的电池条码直接跳转到反向追溯页面
- 数据导出：支持将追溯结果导出为 CSV 文件

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

## 2. 术语说明

| 术语 | 定义 | 说明 |
|------|------|------|
| 正向追溯 | Positive Direction Traceability，从物料出发追踪其被使用的电池范围 | 与反向追溯（从电池出发追踪物料）互为逆向关系 |
| 物料编码 | Item Code，物料的唯一标识编码 | 系统中的物料主数据编码 |
| 物料批次 | Item Batch，物料的生产批次号 | 同一物料编码 + 批次号唯一确定一批物料 |
| 半成品码 | Semi-finished Product ID，半成品的唯一标识 | 可替代物料编码+物料批次作为追溯入口 |
| 电池条码 | Battery ID，单个电池的唯一标识 | 追溯结果的粒度，表示该物料被用于哪个电池 |

## 3. 正向追溯查询

### 3.1 查询条件说明

正向追溯支持两种查询入口：

- **物料编码 + 物料批次**：通过物料编码和物料批次号精确匹配
- **半成品码**：通过半成品的唯一标识进行匹配

**【注意】** 如果填写了物料编码，则物料批次为必填项，两者需组合使用。

**查询条件：**

| 查询条件 | 说明 | 必填 |
|---------|------|------|
| 物料编码 | 按物料编码精确查询 | 否 |
| 物料批次 | 按物料批次号精确查询 | 当物料编码不为空时必填 |
| 半成品码 | 按半成品码精确查询 | 否 |

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

### 3.2 查询结果字段说明

查询结果以电池为粒度展示，每条记录表示该物料在某个电池上的使用情况。

| 字段 | 说明 |
|------|------|
| 电池条码 | 使用该物料的电池唯一标识 |
| 生产批次 | 电池所属的生产批次号 |
| 物料名称 | 物料的名称 |
| 物料编码 | 物料的编码 |
| 物料批次 | 物料的批次号 |
| 设备编码 | 加工该电池所用设备的编码 |
| 工序单元 | 加工该电池的工序单元名称 |
| 工序编码 | 工序的编码 |
| 完成时间 | 该工序的完成时间 |

**功能对应截图** ：
![图片：正向追溯结果列表截图](/public/image/data_middleground/positive_direction_traceability/图片：正向追溯结果列表截图.png)

### 3.3 查询操作步骤

1. 进入【数据中台】→【基础追溯】→【正向追溯】
2. 在查询区域输入查询条件：
   - **方式一**：输入【物料编码】和【物料批次】
   - **方式二**：输入【半成品码】
3. 点击【查询】按钮，系统展示正向追溯结果列表

## 4. 反向追溯跳转

在正向追溯结果列表中，每条电池数据都支持跳转到该电池的反向追溯页面，查看电池从原材料到成品的完整生产过程。

**操作步骤：**

1. 在正向追溯结果列表中，找到目标电池行
2. 点击操作列的【反向追溯】按钮
3. 系统携带电池条码信息，跳转到反向追溯页面

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

## 5. 数据导出

### 5.1 导出说明

正向追溯支持将查询结果导出为 CSV 文件。导出采用异步任务机制，用户创建导出任务后，可在系统顶部的【系统下载任务】中查看进度并下载文件。

**导出字段：**

| 序号 | 导出字段 | 说明 |
|------|---------|------|
| 1 | 电池条码 | 电池唯一标识 |
| 2 | 生产批次 | 电池所属的生产批次号 |
| 3 | 物料名称 | 物料名称 |
| 4 | 物料编码 | 物料编码 |
| 5 | 物料批次 | 物料批次号 |
| 6 | 设备编码 | 设备编码 |
| 7 | 工序单元 | 工序单元名称 |
| 8 | 工序编码 | 工序编码 |
| 9 | 完成时间 | 工序完成时间 |

### 5.2 导出操作步骤

1. 在正向追溯页面，先通过查询条件筛选出需要导出的数据
2. 点击表格上方的【导出】按钮
3. 系统弹出确认对话框，提示"数据导出需要先创建下载任务"
4. 点击【确定】确认创建下载任务
5. 系统提示"创建下载任务成功"，并自动跳转到【系统下载任务】页面
6. 在下载任务页面等待任务完成，点击下载即可获取 CSV 文件

**【注意】** 如果当前没有查询到任何数据，导出时会提示"没有下载数据，无法创建下载任务"。

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

## 6. 相关功能

| 功能 | 关系 | 说明 |
|------|------|------|
| 反向追溯 | 互为逆向 | 从电池条码出发追踪使用的物料，与正向追溯形成完整的双向追溯链路 |
| 系统下载任务 | 导出依赖 | 正向追溯的导出结果通过系统下载任务统一管理和下载 |