HF-MES-manual/planning_production/tray_management.md

# 托盘管理

## 1. 功能概述

托盘管理属于 MES 系统的生产监控模块，用于管理生产过程中的托盘，实现托盘的工序调整、停止、状态查询以及托盘绑定的电池查询等功能。

**核心功能：**

- 托盘状态查询：查询托盘的当前状态
- 托盘工序调整：调整托盘所在的工序
- 托盘停止操作：停止托盘的当前状态
- 托盘电池查询：查询托盘绑定的电池信息

**功能对应截图** ：

<div align="center">
    <img style="margin-top:18px;" src="/public/image/planning_and_production/tray_management/托盘管理页面截图.png" alt="托盘管理页面截图">
    <div style="font-size:12px; font-weight:bold;">图1 托盘管理页面</div>
</div>


## 2. 术语说明

| 术语 | 定义 | 说明 |
|------|------|------|
| 托盘 | Tray，承载物料的容器 | 用于物料的存储和流转 |
| 托盘状态 | Tray Status，托盘的当前状态 | 包括空闲、使用中、已停止等 |
| 托盘工序 | Tray Process，托盘所在的工序 | 托盘当前所处的生产工序 |


## 3. 数据模型关系说明

### 3.1 托盘管理与其他实体关系

```mermaid
flowchart TB
    subgraph 托盘
        T[托盘]
    end

    subgraph 批次
        B[批次]
    end

    subgraph 工序
        P[工序]
    end

    subgraph 电池
        Bat[电池]
    end

    T -->|属于| B
    T -->|位于| P
    T -->|承载| Bat
```

**关系说明：**

| 关系类型 | 说明 |
|---------|------|
| 托盘 → 批次 | **N:1**：多个托盘属于一个批次 |
| 托盘 → 工序 | **N:1**：多个托盘位于同一工序 |
| 托盘 → 电池 | **1:N**：一个托盘可承载多个电池 |


## 4. 托盘管理交互流程

#### 4.1 托盘查询

**查询条件：**

| 查询条件 | 说明 |
|---------|------|
| 托盘编号 | 按托盘编号精确查询 |

**操作步骤：**

1. 进入【生产监控】→【托盘管理】
2. 输入托盘编号
3. 点击【查询】按钮
4. 查看托盘的详细信息

**字段说明：**

| 字段 | 说明 |
|------|------|
| 托盘编号 | 托盘的唯一标识代码 |
| 托盘状态 | 当前托盘状态 |
| 批次 | 关联的批次编号 |
| LOT | 托盘流水号 |
| 投入电池 | 托盘绑定的电池数量 |
| 投入时间 | 托盘登录的时间 |
| 上一工序 | 托盘上一个工序编号 |
| 当前工序 | 托盘当前所在工序 |
| 状态 | 托盘当前状态，激活/停止 |
| 整盘NG | 托盘是否整盘NG |

**功能对应截图** ：

<div align="center">
    <img style="margin-top:18px;" src="/public/image/planning_and_production/tray_management/托盘管理页面截图.png" alt="托盘管理页面截图">
    <div style="font-size:12px; font-weight:bold;">图1 托盘管理页面</div>
</div>


### 4.2 托盘工序调整

#### 4.2.1 工序调整说明

调整托盘所在的工序，实现托盘在工序间的转移。

**操作步骤：**

1. 进入【生产监控】→【托盘管理】
2. 输入托盘编号
3. 点击【查询】按钮
4. 在左侧工序列表中选择目标工序
5. 点击【确定】完成工序调整

**【重要】** 工序调整可能影响生产流程，请在确认后执行。

**功能对应截图** ：

<div align="center">
    <img style="margin-top:18px;" src="/public/image/planning_and_production/tray_management/托盘管理调整工序截图1.png" alt="托盘管理调整工序截图1">
    <div style="font-size:12px; font-weight:bold;">图1 托盘管理调整工序1</div>
</div>

<div align="center">
    <img style="margin-top:18px;" src="/public/image/planning_and_production/tray_management/托盘管理调整工序截图2.png" alt="托盘管理调整工序截图2">
    <div style="font-size:12px; font-weight:bold;">图2 托盘管理调整工序2</div>
</div>

<div align="center">
    <img style="margin-top:18px;" src="/public/image/planning_and_production/tray_management/托盘管理调整工序截图3.png" alt="托盘管理调整工序截图3">
    <div style="font-size:12px; font-weight:bold;">图3 托盘管理调整工序3</div>
</div>



### 4.3 托盘停止

#### 4.3.1 托盘停止说明

停止托盘的当前状态，暂停托盘的进一步流转。

**操作步骤：**

1. 进入【生产监控】→【托盘管理】
2. 输入托盘编号
3. 点击【查询】按钮
4. 点击【停止托盘】按钮
5. 点击【确定】完成停止操作

**【重要】** 停止托盘会将电池和托盘的状态改为停止状态，无法继续流转。

**功能对应截图** ：

<div align="center">
    <img style="margin-top:18px;" src="/public/image/planning_and_production/tray_management/托盘管理托盘停止截图.png" alt="托盘管理托盘停止截图">
    <div style="font-size:12px; font-weight:bold;">图1 托盘管理托盘停止</div>
</div>

### 4.4 托盘电池查询

#### 4.4.1 电池查询说明

查询托盘上绑定的电池信息，了解托盘承载的具体电池。

**操作步骤：**

1. 进入【生产监控】→【托盘管理】
2. 输入托盘编号
3. 点击【查询】按钮
4. 查看托盘绑定的电池列表

**字段说明：**

| 字段 | 说明 |
|------|------|
| 电池编号 | 电池的唯一标识代码 |
| 电池位置 | 电池在托盘中的位置 |
| 电池激活状态 | 电池的激活状态，激活/停止/NG |


## 4.5 整盘NG处理

标记托盘为整盘NG，记录托盘的NG信息。

**操作步骤：**

1. 进入【生产监控】→【托盘管理】
2. 输入托盘编号
3. 点击【查询】按钮
4. 点击【标记NG盘】按钮
5. 点击【确定】完成标记操作

**【重要】** 标记NG盘后，托盘的状态会改为NG状态，物流线通过接口get_process_route 获取托盘为整盘NG信息。

**功能对应截图** ：

<div align="center">
    <img style="margin-top:18px;" src="/public/image/planning_and_production/tray_management/托盘管理托盘整盘NG截图.png" alt="托盘管理托盘整盘NG截图">
    <div style="font-size:12px; font-weight:bold;">图1 托盘管理托盘整盘NG</div>
</div>

## 4.6 清除托盘NG

清除托盘的NG标记，将托盘里电池的NG状态恢复为正常状态。

**操作步骤：**

1. 进入【生产监控】→【托盘管理】
2. 输入托盘编号
3. 点击【查询】按钮
4. 点击【清除NG盘】按钮
5. 点击【确定】完成清除操作

**【重要】** 清除NG盘后，托盘里的NG电池会恢复为正常状态，但是生产日志不会被清除。

**功能对应截图** ：

<div align="center">
    <img style="margin-top:18px;" src="/public/image/planning_and_production/tray_management/托盘管理清除托盘NG截图.png" alt="托盘管理清除托盘NG截图">
    <div style="font-size:12px; font-weight:bold;">图1 托盘管理清除托盘NG</div>
</div>