HF-MES-manual/en/production_configuration/process_model.md

# Process Flow Model

## 1. Function Overview

The Process Flow Model belongs to the basic module of the MES system. It is used to build core process data such as product process flow classification, process flows, process units, process set values, and process result parameters, providing process basic data support for production execution, quality management, and other business modules.

**Core Functions:**

- Process Flow Category: Maintain the classification system of process flows, classify by production section
- Process Unit: Maintain a standardized library of process units, which can be reused by multiple process flows to achieve process standardization
- Process Flow Management: Maintain complete process flows for specific products, define process sequence, process set values, process result parameters, etc.


**Function Screenshot**:
![Process Model Function Screenshot](/public/image_en/process_model/图片：工艺模型功能截图.png)

## 2. Term Explanation

| Term | Definition | Description |
|------|------------|-------------|
| Process Flow Category | Process Category, unit for classifying process flows by section | Used to distinguish process flows of different production sections |
| Process Flow | Process Flow, defines the complete processing sequence from raw materials to finished products | Also known as process route or production flow |
| Process Unit | Process Unit, standardized small process module | Can be reused by multiple process flows |
| Process Set Value | Process Set Value, standard parameters for process operations | Such as temperature, pressure, time, etc., belongs to process unit attributes |
| Process Result Parameter | Process Result Parameter, actual result records of process operations | Used for process monitoring and quality traceability, belongs to process unit attributes |
| Device Category | Device Category, unit for classifying device categories | Used to distinguish different types of devices, belongs to process unit attributes |
| Calculation Script | Process Calculation Script, additional code logic executed by process interfaces | Used for complex calculations in production execution, belongs to process attributes |
| Channel Exception Record | Channel Exception Record, records detailed information of process channel exceptions | Used for device point early warning, belongs to process attributes |

**Data Model Relationship Description:**

```mermaid
flowchart TB
    subgraph Process Flow Category
        CA[Process Flow Category A]
        CB[Process Flow Category B]
    end

    subgraph Process Flow
        PA1[Process Flow A1]
        PA2[Process Flow A2]
        PB1[Process Flow B1]
    end

    subgraph Process Unit
        U1[Process Unit 1]
        U2[Process Unit 2]
        U3[Process Unit 3]
    end

    CA -->|1:N| PA1
    CA -->|1:N| PA2
    CB -->|1:N| PB1

    PA1 --- U1
    PA1 --- U2
    PA2 --- U2
    PB1 --- U2
    PB1 --- U3

    U1 -->|Attribute| PSV1[Process Set Value]
    U1 -->|Attribute| PRP1[Process Result Parameter]
    U1 -->|Attribute| DC1[Device Category]

    U2 -->|Attribute| PSV2[Process Set Value]
    U2 -->|Attribute| PRP2[Process Result Parameter]
    U2 -->|Attribute| DC2[Device Category]
```

**Relationship Description:**

| Relationship Type | Description |
|------------------|-------------|
| Process Flow Category → Process Flow | **1 to N**: A process flow category can contain multiple process flows |
| Process Flow ↔ Process Unit | **N to M**: A process flow can reference multiple process units, a process unit can be reused by multiple process flows |
| Process Unit → Process Set Value | **Attribute**: Process set value is one of the attributes of process unit |
| Process Unit → Process Result Parameter | **Attribute**: Process result parameter is one of the attributes of process unit |
| Process Unit → Device Category | **Attribute**: Device category is one of the attributes of process unit |

**Simplified Relationship Diagram:**

```mermaid
flowchart LR
    A[Process Flow Category] -->|1:N| B[Process Flow]
    B -.->|N:M| C[Process Unit]

    C -->|Contains| D[Process Set Value]
    C -->|Contains| E[Process Result Parameter]
    C -->|Contains| F[Device Category]
```


## 3. Process Flow Model Interaction Flow

### 3.1 Process Flow Category Management

#### 3.1.1 Process Flow Category Description

Process flow category is a unit for classifying process flows by production section, used to distinguish process flows of different production sections.

**Function Screenshot**:
![Process Flow Category List Screenshot](/public/image_en/process_model/图片：工艺流程类别列表截图.png)

#### 3.1.2 Add Process Flow Category
**Operation Steps:**

1. Go to [Production Configuration] → [Process Model] → [Process Flow Category]
2. Click [Add] button
3. Fill in basic information
4. Click [Save] to complete category creation

**Field Description:**

| Field | Description | Required |
|-------|-------------|----------|
| Process Flow Category Code | Unique identification code of the category | Yes |
| Process Flow Category Name | Name of the category, e.g., "** Section" | Yes |
| Remarks | Other supplementary information | No |

**[Important]** Once the category code is enabled, it cannot be modified or deleted. Please confirm carefully when creating.

**Function Screenshot**:
![Process Flow Category Settings Screenshot](/public/image_en/process_model/图片：工艺流程类别设置截图.png)

#### 3.1.3 Process Flow Category Query

**Query Conditions:**

| Query Condition | Description |
|----------------|-------------|
| Category Code | Exact query by category code |
| Category Name | Fuzzy query by category name |

### 3.2 Process Unit Management

#### 3.2.1 Process Unit Description

A process unit is a standardized small process module, which is the basic unit constituting a process flow. Process units are universal and can be referenced by multiple process flows to achieve standardized reuse of processes.

**Process Unit Characteristics:**

- Standardization: Define unified process names, process codes, and operation specifications
- Reusability: Can be referenced by multiple process flows without repeated creation
- Configurability: Supports configuring preset process parameters and preset result parameters for processes

**Function Screenshot**:

![Process Unit List Screenshot](/public/image_en/process_model/图片：工序单元列表截图.png)

#### 3.2.2 Add Process Unit

**Operation Steps:**

1. Go to [Production Configuration] → [Process Model] → [Process Unit]
2. Click [Add] button
3. Fill in basic process unit information
4. Click [OK] to complete process unit creation

**Field Description:**

| Field | Description | Required |
|-------|-------------|----------|
| Process Unit Code | Unique identification code of the process unit | Yes |
| Process Unit Name | Name of the process unit, e.g., "SMT Mounting" | Yes |
| Device Category | Device category for completing this process, e.g., "SMT" | Yes |
| Remarks | Other supplementary information | No |

**[Note]** Once a process unit is created, the code cannot be modified. Please confirm carefully when creating.
**[Important]** Once a process unit is referenced by a process flow, it cannot be deleted. Please confirm carefully when creating.

**Function Screenshot**:

![Add Process Unit Screenshot](/public/image_en/process_model/图片：新增工序单元截图.png)
 
#### 3.2.3 Preset Set Values

Preset set values are preset standard parameters for the process, such as temperature, pressure, time, etc. When adding a process to a process flow, the preset set values will be configured by default.

**Function Screenshot**:

![Preset Set Value Dialog Screenshot](/public/image_en/process_model/图片：预设设定值对话框截图.png)

**Operation Steps:**

1. On the [Process Unit] page, click the process unit that needs to configure set values
2. Click [Preset Set Values] button to open the preset set values dialog
3. Fill in the set value parameters
4. Click [OK] to complete set value configuration

**[Important]** The preset set value dialog varies according to the category of the process unit.

The following are the preset set value dialog types in the MES system:

- Charging/Discharging Related: ![Capacity Preset Set Value Dialog Screenshot](/public/image_en/process_model/图片：分容预设设定值对话框截图.png)
- Sorting Related: ![Sorting Preset Set Value Dialog Screenshot](/public/image_en/process_model/图片：分选预设设定值对话框截图.png)
- OCV Related: ![OCV Preset Set Value Dialog Screenshot](/public/image_en/process_model/图片：预设设定值对话框截图.png)
- Rest Related: ![Rest Preset Set Value Dialog Screenshot](/public/image_en/process_model/图片：静置预设设定值对话框截图.png)
- DCIR Related: ![DCIR Preset Set Value Dialog Screenshot](/public/image_en/process_model/图片：DCIR预设设定值对话框截图.png)

In addition to the above, MES also provides a table-form preset set value dialog for configuring complex set values.
Others: ![General Preset Set Value Dialog Screenshot](/public/image_en/process_model/图片：常规预设设定值对话框截图.png)

**[Important]** If the site has special requirements and needs to customize the preset set value dialog content, please contact the MES system administrator for development.

#### 3.2.4 Preset Result Parameters

Preset result parameters are preset actual result records for the process, such as voltage, current, time, etc. When adding a process to a process flow, the preset result parameters will be configured by default.

**Function Screenshot**:

![Preset Result Parameter Dialog Screenshot](/public/image_en/process_model/图片：预设结果参数对话框截图.png)

##### 3.2.4.1 Add Result Parameter

**Operation Steps:**

1. On the [Process Unit] page, click the process unit that needs to configure result parameters
2. Click [Preset Result Parameters] button to open the preset result parameters dialog
3. Click [Add Row] button to open the add result parameter dialog
4. Fill in the result parameter information
5. Click [OK] to complete result parameter configuration

**[Important]** After adding, the system will automatically add three result parameters: START_TIME, FINISH_TIME, and DEVICE_CODE.

**Field Description:**

| Field | Description | Required |
|-------|-------------|----------|
| Parameter | Unique identification code of the result parameter | Yes |
| Name | Name of the result parameter, e.g., "Voltage" | Yes |
| Type | FLOAT/INT/VARCHAR/TEXT/TIMESTAMP | Yes |
| Is Unique | Whether the result parameter changes according to the number of steps. For example, the result parameters of capacity grading and formation change according to the number of steps. 10 steps have 10 result parameters; while processes such as second sealing or electrolyte injection have no steps and are unique | Yes |
| Upload | When uploading result parameters, it is judged according to whether to upload. If yes, it is uploaded to the MES system; otherwise, it is not uploaded | Yes |
| Remarks | Other supplementary information | No |

**Function Screenshot**:

![Add Preset Result Parameter Dialog Screenshot](/public/image_en/process_model/图片：新增预设结果参数对话框截图.png)

##### 3.2.4.2 Import Preset Result Parameters
Importing preset result parameters is to batch import the result parameters of the process, such as voltage, current, time, etc.

**Operation Steps:**

1. On the [Process Unit] page, click the process unit that needs to configure result parameters
2. Click [Preset Result Parameters] button to open the preset result parameters dialog
3. Click [Import] button to open the import result parameters dialog
4. Click [Select File] to upload the xlsx file containing result parameters

**[Note]** If the imported result parameters have duplicate codes or names with existing result parameters, an error will be reported.
**[Note]** The xlsx file for import will be provided by MES for download. Users can modify it according to the downloaded file and re-import.

**Function Screenshot**:

![Import Result Parameter Button and File Dialog Screenshot](/public/image_en/process_model/图片：导入结果参数的按钮和文件对话框截图.png)
![Import Result Parameter File Screenshot](/public/image_en/process_model/图片：导入结果参数文件截图.png)

#### 3.2.5 Process Unit Query

**Query Conditions:**

| Query Condition | Description |
|----------------|-------------|
| Process Unit Code | Exact query by process unit code |
| Process Unit Name | Fuzzy query by process unit name |
| Device Category | Filter by device category |

**Function Screenshot**:
![Process Unit Query List Screenshot](/public/image_en/process_model/图片：工序单元查询列表截图.png)

### 3.3 Process Flow Management

#### 3.3.1 Process Flow Description

Process flow is core data defining the complete processing sequence of a product from raw materials to finished products, including process arrangement, process name, process code, process set values, process result parameters, etc.

**Function Screenshot**:
![Process Flow List Screenshot](/public/image_en/process_model/图片：工艺流程列表截图.png)

#### 3.3.2 Add Process Flow

**Operation Steps:**

1. Go to [Production Configuration] → [Process Model] → [Process Flow]
2. Click [Add] button
3. Fill in basic process flow information
4. Click [Save] to complete process flow creation

**Field Description:**

| Field | Description | Required |
|-------|-------------|----------|
| Process Flow Code | Unique identification code of the process flow | Yes |
| Process Flow Name | Name of the process flow | Yes |
| Process Flow Category | Associated process flow category | Yes |
| Product Code | Associated product model | Yes |
| Remarks | Other supplementary information | No |

**[Important]** Once a process flow is bound to a production batch, it cannot be deleted.


**Function Screenshot**:
![Add Process Flow Screenshot](/public/image_en/process_model/图片：新增工艺流程截图.png)

#### 3.3.3 Relationship Between Process Flow, Process Unit, and Process

```mermaid
flowchart TB
    A[Process Flow Category] -->|1:N| B[Process Flow A]
    A -->|1:N| C[Process Flow B]

    B --> D[Process 1]
    B --> E[Process 2]
    B --> F[Process 3]
    C --> G[Process 2]
    C --> H[Process 4]
    C --> F

    D --> I[Process Unit: Mounting]
    E --> J[Process Unit: Welding]
    F --> K[Process Unit: Testing]
    G --> I
    H --> L[Process Unit: Assembly]
```
**[Note]** The process code and process name are automatically assigned by the system. The assignment rule is the unique ID of the process flow concatenated with the process unit code. Users do not need to input manually. Users can modify the name as needed, but the code cannot be modified.


### 3.4 Set Process (Process Details)

The process details page is used to configure detailed information of the process flow, including adding processes, deleting processes, editing set values, editing result parameters, setting calculation scripts, etc.

**Function Screenshot**:

![Process Details Page Screenshot](/public/image_en/process_model/图片：工艺详情页面截图.png)

#### 3.4.1 Set Process (Process Details) Description

**Operation Steps:**
1. Go to [Production Configuration] → [Process Model] → [Process Flow]
2. Click [Set Process] button
3. Enter the [Process Details] page

**Function Description:**
- Add Process: Configure process sequence, process unit, whether to enable channel exception recording, etc.
- Delete Process: Configure process sequence, process unit, whether to enable channel exception recording, etc.
- Edit Set Values: Configure standard operation parameters for each process, such as temperature, pressure, time, etc.
- Edit Result Parameters: Configure actual result records for each process, such as voltage, current, time, etc.
- Set Calculation Script: Configure actual result records for each process, such as voltage, current, time, etc.


#### 3.4.2 Add Process
**Operation Steps:**

1. On the [Process Flow] page, click the [Set Process] button for the process flow to configure, enter the [Process Details] page
2. Click the add button to open the add process dialog
3. Select the process unit, the system will automatically generate the process code and process name
4. Select whether to enable channel exception recording
5. Click [OK] to complete process configuration

**Process Configuration Field Description:**

| Field | Description | Required |
|-------|-------------|----------|
| Process Unit | Process selected from the process unit library | Yes |
| Process Code | Automatically generated process code, format is process flow unique id + process unit code | Yes |
| Process Name | Automatically generated process name, format is process flow unique id + process unit name | Yes |
| Enable Channel Exception Recording | Whether to enable channel exception recording for this process | No |
| Remarks | Other supplementary information | No |

**[Note]** When a process is deleted, the related set values and result parameters will also be deleted. Please proceed with caution.
**[Important]** Once a process flow is bound to a production batch, processes cannot be deleted.

**Function Screenshot**:
![Add Process Dialog Screenshot](/public/image_en/process_model/图片：新增工序对话框截图.png)

#### 3.4.3 Process Set Values
Process set values are standard parameters for process operations, such as temperature, pressure, time, etc.

**Operation Steps:**

1. On the [Process Details] page, click the process that needs to configure set values
2. Click [Add Set Value] button to open the add set value dialog
3. Fill in the set value parameter, unit, minimum value, maximum value, normal value, warning value, alarm value
4. Click [OK] to complete set value configuration

**[Note]** If the process unit of this process has set preset set values, the system will automatically fill in the preset set values, and users do not need to configure them manually.
**[Important]** Process set values are obtained by the equipment through MES interfaces [get_battery_process_setting]() and [get_tray_process_setting]().

**Function Screenshot**:
![Process Set Value Dialog Screenshot](/public/image_en/process_model/图片：工序设定值对话框截图.png)

#### 3.4.4 Process Result Parameters
Process result parameters are actual result records of process operations, such as voltage, current, time, etc.

**[Note]** If the process unit of this process has set preset result parameters, the system will automatically fill in the preset result parameters, and users do not need to configure them manually.
**[Important]** If the result parameters of this process are non-unique, the system will dynamically generate result parameters according to the number of steps in the set values after the set values are determined.

> For example, the result parameters of the capacity grading process are voltage, current, voltage, etc. According to the number of steps, the voltage, current, voltage of the first step, the voltage, current, voltage of the second step, etc., are generated until the last step.

**Function Screenshot**:
![Process Result Parameter Dialog Screenshot](/public/image_en/process_model/图片：工序结果参数对话框截图.png)

#### 3.4.5 Calculation Script

Calculation scripts are scripts that trigger complex calculations during equipment interface calls based on the set script trigger position, such as before or after interface execution. Calculation scripts are written in PHP code and used to add specific complex logic to the project based on the interface.

**Function Screenshot**:
![Calculation Script Dialog Screenshot](/public/image_en/process_model/图片：计算脚本对话框截图.png)

##### 3.4.5.1 Add Calculation Script

**Operation Steps:**
1. On the [Process Details] page, click the process that needs to configure the calculation script
2. Click [Calculation Script] button to open the add calculation script list dialog
3. Click [Add] button to open the add calculation script dialog
4. Fill in the basic information of the calculation script, including script name, trigger position, script content
5. Click [Calculation Script Editor] button to open the calculation script editor dialog
6. Write PHP code in the calculation script editor
7. Click [Save] button to save the calculation script
8. Click [OK] to complete calculation script configuration

**Function Screenshot**:
![Add Calculation Script Dialog Screenshot](/public/image_en/process_model/图片：新增计算脚本对话框截图.png)
![Calculation Script Editor Dialog Screenshot](/public/image_en/process_model/图片：计算脚本编辑器对话框截图.png)

**[Note]** The script editor has syntax highlighting, code hints, formatting, and other functions
**[Note]** The script editor has a preset function library that users can directly drag and drop to use
**[Important]** The script editor saves calculation data for a certain result parameter, which requires a corresponding parameter in the result parameters, otherwise an error will occur.

##### 3.4.5.2 Calculation Script Usage Case
**Case 1:**
For example, to add K value calculation for OCV2, the process from backend setting to execution and export display:

```mermaid
sequenceDiagram
    participant 用户 as User
    participant MES as MES System
    participant 设备 as Device

    用户->>MES: 1. Edit calculation script (Set trigger position: End Position)
    MES->>MES: 2. Save calculation script configuration

    设备->>MES: 3. Device uploads data (OCV2 data)
    MES->>MES: 4. Determine if trigger position is "End Position"
    MES->>MES: 5. Load corresponding calculation script
    MES->>MES: 6. Execute script logic (Calculate K value)
    MES->>MES: 7. Save calculation result to result parameter
    MES->>用户: 8. Return calculation completed result
```

**Process Description:**

| Step | Executor | Operation | Description |
|------|----------|-----------|-------------|
| 1 | User | Edit calculation script | Set trigger position to "End Position" |
| 2 | MES | Save script configuration | Save script content and trigger position |
| 3 | Device | Upload data | Device calls interface to upload OCV2 data |
| 4 | MES | Determine trigger position | Check if trigger position is "End Position" |
| 5 | MES | Load script | Load corresponding script according to trigger position |
| 6 | MES | Execute calculation | Run script logic to calculate K value |
| 7 | MES | Save result | Save calculation result to result parameter |
| 8 | MES | Return result | Show calculation completed status to user |


#### 3.4.6 View Logs
Logs record the operation logs of the process details page, including operations such as adding, deleting, editing processes, configuring set values, configuring result parameters, configuring calculation scripts, etc.

**Operation Steps:**
1. On the [Process Details] page, click [View Logs] button
2. The log dialog pops up, showing all operation logs

**Function Screenshot**:
![View Logs Dialog Screenshot](/public/image_en/process_model/图片：查看日志对话框截图.png)