HF-MES-manual/en/planning_production/batch_tray.md

# Batch Tray

## 1. Function Overview

Batch Tray belongs to the core module of the MES system, used to manage the association relationship between production batches and trays, realizing logistics tracking and management of batches during production. Trays are production containers that carry materials, and batch tray management runs through the entire production logistics process.

**Core Functions:**

- Batch Tray Query: Query the association information between batches and trays
- Batch Tray Details: View detailed information of batch trays
- Batch Tracking: Track the flow status of batches on trays
- Unbind Operation: Unbind the association between batches and trays
- Stop Operation: Stop the current status of batch trays

**Function Screenshot**:

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/planning_and_production/batch_tray/批次托盘页面截图.png" alt="Batch Tray Page Screenshot">
    <div style="font-size:12px; font-weight:bold;">Figure 1: Batch Tray Page</div>
</div>


## 2. Term Explanation

| Term | Definition | Description |
|------|------------|-------------|
| Batch Tray | Batch Tray, association record between batch and tray | Records the tray information where batch goods are located |
| Tray | Tray, container for carrying materials | Used for material storage and flow |
| Tray Activation Status | Tray Activation Status, whether the tray is activated | Records the activation status of the tray |
| Tray Number | Tray Number, unique identifier of the tray | Each tray has a unique number |
| Batch Number | Batch, unique identifier of the batch | Used to trace product production information |
| Unbind | Unbind, release the association between batch and tray | Executed when materials leave the tray |
| Stop | Stop, stop the current status of the batch tray | Pause further flow of the batch |


## 3. Data Model Relationship Explanation

### 3.1 Batch Tray Battery Hierarchy Relationship

Batch serves as the top-level entity, processes represent production stages. Some processes require trays to carry batteries, while in some processes, batteries exist independently after unbinding.

```mermaid
flowchart TB
    subgraph Batch
        subgraph Process1["Process 1 (Tray Carrying)"]
            subgraph Tray1
                Bat1[Battery 1]
                Bat2[Battery 2]
            end
        end
        subgraph Process2["Process 2 (No Tray Needed)"]
            Bat3[Battery 3]
            Bat4[Battery 4]
        end
    end
```

**Relationship Explanation:**

| Relationship Type | Description |
|------------------|-------------|
| Batch → Process | **1:N**: A batch can contain multiple processes |
| Process → Tray | **1:N**: A process can contain multiple trays (Process 1 has trays) |
| Tray → Battery | **1:N**: A tray can contain multiple batteries |
| Process → Battery | **1:N**: A process can directly contain multiple batteries (Process 2 has no tray) |


### 3.2 Battery Tray Binding Methods

There are two ways to bind batteries and trays, both can bind batteries and trays and log them to the batch:

| Binding Method | Interface | Battery Status Requirement | Description |
|----------------|-----------|---------------------------|-------------|
| Binding Interface | `set_tray_binding` | Battery must be activated | Battery needs to be in activated state and belong to the same batch as the tray |
| Login Interface | `set_tray_login` | Battery does not need to be activated | Battery does not need to be in activated state, can be bound and logged to the batch |


## 4. Batch Tray Interaction Flow

### 4.1 Batch Tray List

#### 4.1.1 Batch Tray List Description

The batch tray list displays all association information between batches and trays, supporting query and filtering by multiple conditions.

**Function Screenshot**:

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/planning_and_production/batch_tray/批次托盘页面截图.png" alt="Batch Tray Page Screenshot">
    <div style="font-size:12px; font-weight:bold;">Figure 1: Batch Tray Page</div>
</div>


**Field Description:**

| Field | Description |
|-------|-------------|
| Tray Number | Unique identification code of the tray |
| Serial Number | Serial number of the batch tray, used to uniquely identify each binding |
| Tray Status | Current tray status |
| Batch Number | Associated batch number |
| Process Flow Name | Associated process flow name |
| Current Process | Current process where the tray is located |
| Loaded Battery Quantity | Current quantity of batteries loaded on the tray |
| Login Time | Batch tray login time |


#### 4.1.2 Batch Tray Query

**Query Conditions:**

| Query Condition | Description |
|----------------|-------------|
| Tray Number | Query by tray number exactly |
| Batch Number | Query by batch number exactly |
| Tray Activation Status | Filter by status (Activated, Stopped) |
| Login Time | Filter by creation time range |

**Function Screenshot**:

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/planning_and_production/batch_tray/批次托盘查询条件截图.png" alt="Batch Tray Query Conditions Screenshot">
    <div style="font-size:12px; font-weight:bold;">Figure 1: Batch Tray Query Conditions</div>
</div>


### 4.2 Batch Tray Details

#### 4.2.1 Details View Description

View detailed information of the batch tray, including basic tray information, process flow time information, process flow equipment, loaded battery quantity, battery number, battery position, battery status, etc.

**Operation Steps:**

1. Go to [Production Configuration] → [Batch Management] → [Batch Tray]
2. Find the batch tray record to view details in the list
3. Click [Details] button
4. View complete batch tray information

**Field Description:**

| Field | Description |
|-------|-------------|
| Tray Number | Unique identification code of the tray |
| Process Start Time | Process start time, used to record the start time of the process |
| Process End Time | Process end time, used to record the end time of the process |
| Current Process | Current process where the tray is located |
| Serial Number | Position of the battery barcode in the tray |
| Battery Barcode | Unique identification code of the battery |
| Battery Activation Status | Current status of the battery, such as activated, deactivated, etc. |

**Function Screenshot**:

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/planning_and_production/batch_tray/托盘批次详情信息截图.png" alt="Batch Tray Details Screenshot">
    <div style="font-size:12px; font-weight:bold;">Figure 1: Batch Tray Details</div>
</div>


### 4.3 Unbind Operation

#### 4.3.1 Unbind Description

Release the association between batch and tray. After unbinding, the tray status will become stopped, but the battery status will not change.

**Operation Steps:**

1. Go to [Production Configuration] → [Batch Management] → [Batch Tray]
2. Find the batch tray record to unbind in the list
3. Click [Unbind] button
4. Click [OK] to complete the unbind operation

**[Important]** The unbind operation is irreversible. Please confirm before executing.

**Function Screenshot**:

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/planning_and_production/batch_tray/批次托盘托盘解绑截图.png" alt="Batch Tray Unbind Screenshot">
    <div style="font-size:12px; font-weight:bold;">Figure 1: Batch Tray Unbind</div>
</div>

### 4.4 Stop Operation

#### 4.4.1 Stop Description

Stop the activation status of the tray and battery, pause further flow of the tray, used to handle abnormal situations.

**Operation Steps:**

1. Go to [Production Configuration] → [Batch Management] → [Batch Tray]
2. Find the batch tray record to stop in the list
3. Click [Stop] button
4. Click [OK] to complete the stop operation

**[Important]** The stop operation is irreversible. Please confirm before executing.

**Function Screenshot**:

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/planning_and_production/batch_tray/批次托盘托盘停止截图.png" alt="Batch Tray Stop Screenshot">
    <div style="font-size:12px; font-weight:bold;">Figure 1: Batch Tray Stop</div>
</div>