# 托盘追溯

## 1. 功能概述

托盘追溯属于 MES 系统数据中台的基础追溯模块，用于以**托盘编码**为入口，查询托盘在各生产批次中的流转记录，以及托盘内所有电池的明细信息和工序流转时间线，实现从托盘到电池的完整追溯链路。

**核心功能：**

- 托盘追溯查询：按托盘编码查询该托盘关联的所有生产批次记录
- 电池明细查看：在托盘详情中以抽屉面板展示托盘内全部电池的明细数据
- 工序时间线：以时间线形式展示托盘在各工序间的流转记录
- 取消激活电池：支持在托盘详情中批量取消电池的激活状态
- 追溯跳转：支持从托盘详情中的电池条码直接跳转到电池追溯页面

**功能对应截图** ：
![图片：托盘追溯功能截图](/public/image/data_middleground/tray_traceability/图片：托盘追溯功能截图.png)

## 2. 术语说明

| 术语 | 定义 | 说明 |
|------|------|------|
| 托盘追溯 | Tray Traceability，以托盘为入口追踪其批次流转和电池明细 | 属于数据中台的基础追溯模块 |
| 托盘编码 | Tray ID，托盘在系统中的唯一标识 | 作为追溯查询的入口条件 |
| 登录批次 | 生产批次号，托盘当前关联的生产批次 | 一个托盘可在多个批次中被使用 |
| 流水号 | Lot Number，托盘在批次内的流水号 | 与批次配合使用，区分同批次内不同托盘 |
| 激活状态 | Active Status，标识托盘/电池是否处于激活中 | 激活表示当前可继续生产操作，取消激活后不可操作 |
| 载入电池 | Input Battery Count，该托盘实际装载的电池数量 | 区别于计划载入数量 |
| 工序时间线 | Process Timeline，托盘在各工序间的流转时间记录 | 记录每道工序的开始时间、结束时间和处理设备 |
| 类别/档位 | 电池经过分选工序后确定的等级分类 | 如 A 品、B 品等 |
| 电池条码 | Battery ID，单个电池在系统中的唯一标识 | 可点击跳转到电池追溯页面查看该电池的完整追溯信息 |

## 3. 托盘追溯查询

### 3.1 查询条件说明

托盘追溯以托盘编码作为唯一查询条件，支持精确匹配查询。

**查询条件：**

| 查询条件 | 说明 | 必填 |
|---------|------|------|
| 托盘编码 | 输入需要追溯的托盘编码 | 是 |

**【注意】** 可通过其他页面（如托盘管理页面）携带托盘编码参数跳转至本页面，系统会自动填充编码并执行查询。

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

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

查询结果以托盘为粒度展示，每条记录表示该托盘在某个生产批次中的流转情况。

| 字段 | 说明 |
|------|------|
| ID | 托盘流转记录的唯一标识 |
| 托盘 | 托盘编码 |
| 登录批次 | 托盘关联的生产批次号 |
| 流水号 | 托盘在该批次内的流水号 |
| 是否激活 | 托盘当前的激活状态（"激活" 或 "停止"） |
| 载入电池 | 该托盘实际载入的电池数量 |
| 登录时间 | 托盘登录至该批次的时间 |
| 取消激活时间 | 托盘被取消激活的时间（若已取消） |

**功能对应截图** ：
![图片：托盘追溯功能截图](/public/image/data_middleground/tray_traceability/图片：托盘追溯功能截图.png)

### 3.3 查询操作步骤

1. 进入【数据中台】→【基础追溯】→【托盘追溯】
2. 在搜索框中输入托盘编码
3. 点击【查询】按钮，系统展示该托盘关联的所有批次记录
4. 如需清空查询结果，点击【重置】按钮

## 4. 电池明细查看

### 4.1 功能说明

通过托盘追溯查询到目标托盘后，可查看该托盘内所有电池的详细信息。系统以全宽抽屉面板打开，左侧展示工序时间线，右侧展示电池明细表格。

**功能对应截图** ：
![图片：电池明细抽屉面板截图](/public/image/data_middleground/tray_traceability/图片：电池明细抽屉面板截图.png)

### 4.2 电池明细表格字段

| 字段 | 说明 |
|------|------|
| 序号 | 电池在该托盘内的排列序号 |
| 电池条码 | 电池的唯一标识，点击可跳转到电池追溯页面 |
| 生产批次 | 电池所属的生产批次号 |
| 型号 | 电池的产品型号 |
| 工艺流程名称 | 该批次关联的工艺流程名称 |
| 托盘号 | 托盘编码 |
| 流水号 | 托盘在批次内的流水号 |
| 激活状态 | 电池当前的激活状态（"激活" 或 "未激活"） |
| 类别 | 电池的分选类别 |
| 档位 | 电池的分选档位等级 |

**功能对应截图** ：
![图片：电池明细表格截图](/public/image/data_middleground/tray_traceability/图片：电池明细表格截图.png)

### 4.3 工序时间线

在电池明细抽屉的左侧，以时间线形式展示该托盘在各工序间的流转记录，直观反映托盘的生产进度。

**时间线字段：**

| 字段 | 说明 |
|------|------|
| 工序名称 | 该流转记录的工序名称 |
| 开始时间 | 进入该工序的时间 |
| 结束时间 | 离开该工序的时间 |
| 设备编码 | 处理该工序的设备编码 |

**功能对应截图** ：
![图片：工序时间线截图](/public/image/data_middleground/tray_traceability/图片：工序时间线截图.png)

### 4.4 电池条码搜索

在电池明细面板中，支持通过电池条码进行前端过滤，快速定位到目标电池。

**操作步骤：**

1. 打开电池明细抽屉
2. 在电池明细表格上方的搜索框中输入电池条码
3. 系统自动过滤并展示匹配的电池记录

### 4.5 操作步骤

1. 在托盘追溯结果列表中，找到目标托盘行
2. 点击操作列的【电池详情】按钮
3. 系统打开全宽抽屉面板，左侧展示工序时间线，右侧展示电池明细表格

## 5. 取消激活电池

### 5.1 功能说明

在托盘详情中，支持批量选择电池并取消其激活状态。取消激活后，电池将不可再进行生产操作。当托盘内所有电池都被取消激活后，托盘本身也会被级联取消激活。

### 5.2 操作步骤

1. 在电池明细抽屉中，勾选需要取消激活的电池（支持多选）
2. 点击表格上方的【取消激活电池】按钮
3. 系统批量将选中电池的激活状态更新为"未激活"
4. 若该托盘下所有电池均已取消激活，托盘激活状态自动变更为"停止"

**【注意】** 取消激活操作不可撤销，请谨慎操作。

**功能对应截图** ：
![图片：取消激活电池截图](/public/image/data_middleground/tray_traceability/图片：取消激活电池截图.png)

## 6. 追溯跳转

在电池明细面板中，点击任意电池条码可跳转至该电池的电池追溯页面，查看该电池从原材料到成品的完整生产过程。

**操作步骤：**

1. 在电池明细表格中，点击目标电池的电池条码
2. 系统携带电池条码信息，跳转到电池追溯页面

## 7. 相关功能

| 功能 | 关系 | 说明 |
|------|------|------|
| 电池追溯 | 下游追溯 | 从托盘追溯中的电池条码可跳转到电池追溯，查看单个电池的完整生产追溯信息 |
| 正向追溯 | 互补 | 从物料出发追踪被哪些电池使用，与托盘追溯形成"物料→电池→托盘"的追溯链路 |
| 反向追溯 | 互补 | 从电池条码出发追溯物料组成，可与托盘追溯配合定位问题批次 |
| 电池曲线 | 数据关联 | 通过电池追溯查询到电池后，可进一步查看该电池的充放电曲线数据 |
| 托盘管理 | 上游数据 | 托盘的登录、激活等操作在托盘管理模块中完成 |