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

# Semi-finished Product Management

## 1. Function Overview

Semi-finished Product Management is used to record and query semi-finished product information produced in each process during production, supporting semi-finished product entry and traceability.

**Main Functions:**

- Semi-finished Product Data Entry: Register semi-finished product information produced in each process into the system
- Semi-finished Product List Query: Retrieve semi-finished product records by batch number, semi-finished product ID, process unit, unloading time, etc.
- Material Status Viewing: View whether the semi-finished product is currently "Completed" or "Unused"

**Function Screenshot**:

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/planning_and_production/material_monitoring/半成品管理页面截图.png" alt="Semi-finished Product Management Page Screenshot">
    <div style="font-size:12px; font-weight:bold;">Figure 1: Semi-finished Product Management Page</div>
</div>

## 2. Term Explanation

| Term | Definition |
|------|------------|
| Semi-finished Product | Intermediate materials produced in each process during production |
| Semi-finished Product ID | Unique number automatically generated by the system for each semi-finished product |
| Semi-finished Product Code | Code identifying the semi-finished product material type |
| Batch Number | Production batch number to which the semi-finished product belongs |
| Process Unit | Specific process that produced the semi-finished product |
| Material Status | Current usage status of the semi-finished product: Completed / Unused |

## 3. Semi-finished Product Management Interaction Flow

### 3.1 Semi-finished Product List

#### 3.1.1 List Description

The semi-finished product list displays all entered semi-finished product records, sorted by unloading time from newest to oldest by default, supporting pagination.

**Table Field Description:**

| Field | Description |
|-------|-------------|
| Batch Number | Production batch number to which the semi-finished product belongs |
| Semi-finished Product ID | Unique number automatically generated by the system, format is "process attribute-material category-material code-timestamp" |
| Semi-finished Product Code | Code representing the semi-finished product material type |
| Output Quantity | Quantity of semi-finished products produced in this process |
| Process Unit | Process name that produced the semi-finished product |
| Production Equipment | Equipment number used to produce the semi-finished product |
| Material Status | Red label indicates "Completed", green label indicates "Unused" |
| Unloading Time | Time when the semi-finished product was produced |

#### 3.1.2 List Query

Semi-finished product records can be filtered by the following conditions:

| Query Condition | Description |
|----------------|-------------|
| Batch Number | Fuzzy search by batch number |
| Semi-finished Product ID | Exact search by semi-finished product ID |
| Process Unit | Filter by selecting from the dropdown list of process units |
| Unloading Time | Select a time range to query semi-finished products produced within that period |

**Function Screenshot**:

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/planning_and_production/material_monitoring/半成品管理页面查询条件截图.png" alt="Semi-finished Product Management Query Conditions Screenshot">
    <div style="font-size:12px; font-weight:bold;">Figure 1: Semi-finished Product Management Query Conditions</div>
</div>

### 3.2 Enter Semi-finished Product Data

#### 3.2.1 Entry Process Description

**Operation Steps:**

1. Go to [Production Planning] → [Semi-finished Product Management]
2. Click the **[Enter Semi-finished Product Data]** button above the table
3. Fill in the following information in the pop-up dialog:

| Field | Required | Description |
|-------|----------|-------------|
| Production Batch | Yes | Select the associated production batch from the dropdown list |
| Process Unit | Yes | Select the process unit that produced the semi-finished product from the dropdown list (options automatically linked based on selected batch) |
| Equipment Code | Yes | Select the production equipment number from the dropdown list |
| Output Quantity | Yes | Enter the output quantity of this process, minimum is 1 |
| Output Date | No | Select the output date of the semi-finished product |

4. Click **OK** to submit after filling

**Function Screenshot**:

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/planning_and_production/material_monitoring/半成品管理页面录入数据截图.png" alt="Semi-finished Product Management Data Entry Screenshot">
    <div style="font-size:12px; font-weight:bold;">Figure 1: Semi-finished Product Management Data Entry</div>
</div>


#### 3.2.2 Entry Validation Description

| Validation Item | Rule |
|-----------------|------|
| Production Batch | Required, must be selected from the list |
| Process Unit | Required, must be selected from the list |
| Output Quantity | Required, must be a number greater than 0 |

#### 3.2.3 Entry Processing

After submitting the entry, the system will automatically perform the following processing:

1. **Validate Associated Data**: Confirm that the batch number exists, the process unit is valid, and the material output configuration for this process has been set
2. **Generate Semi-finished Product ID**: The system automatically generates a unique semi-finished product number based on process attributes, material category, material code, and current time
3. **Calculate Subsequent Processes**: Automatically determine the next flow process for this semi-finished product based on the process flow
4. **Save Data**: Write the semi-finished product information to the system. If any step fails, it will automatically roll back to ensure data consistency

## 4. Material Status Description

| Status | Label Color | Description |
|--------|------------|-------------|
| Completed | Red | The semi-finished product has been used by subsequent processes |
| Unused | Green | The semi-finished product has not been used by subsequent processes yet |