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

Alert Center

1. Function Overview

The Alert Center belongs to the monitoring and alert module of the MES system's data middle ground. It is used to monitor the channel abnormal status of production equipment in real-time, helping production managers discover and handle equipment point issues promptly. The system organizes data by equipment category (workstation), and separately counts two types of alert data: consecutive errors (the same channel reports errors 3 times or more consecutively) and cumulative errors (the same channel reports errors 10 times or more cumulatively). It provides functions for viewing details and clearing exceptions.

Core Functions:

• Workstation Overview: Display the number of abnormal devices under each workstation by equipment category, including consecutive error device count and cumulative error device count
• Device Exception Details: View detailed data of all abnormal devices under a workstation, distinguishing between consecutive errors and cumulative errors
• Channel Exception Details: View specific error information for each abnormal channel, including error code, error description, and occurrence time
• Exception Clearance: Support device-level and single-channel clearance, with two methods: reset (reset count) and mark as processed
• Condition Filtering: Filter by time range and specific device, support exporting exception data

Function Screenshot:

2. Term Explanation

Term	Definition	Description
Alert Center	Alert Center, device point exception monitoring and alert module	Displays production equipment channel abnormal status in real-time, helping quickly locate problematic devices
Workstation	Workstation, i.e., Device Category	Grouped by device type, such as formation, capacity grading, OCV, DCIR, etc.
Consecutive Error	Consecutive Error, the same channel reports errors 3 times or more consecutively	Indicates that the channel has been continuously abnormal recently and requires focused attention
Cumulative Error	Cumulative Error, the same channel reports errors 10 times or more cumulatively	Indicates that although the channel may not be consecutive, the overall exception frequency is high
Channel	Channel, data collection point on the device	A device usually has multiple channels, and each channel independently counts exceptions
Pin NG	Pin NG, exception (defect) information reported by the device channel	Reported by the device through the MES interface, including error code and error description
Exception Clearance	Clear Error, reset exception count	Supports overall clearance and single-channel clearance, after which the counter restarts counting
Channel Exception Record	Channel Exception Record, channel exception monitoring configuration enabled in the process	After enabled for a process in the process details, the device will trigger channel exception detection

Data Model Relationship Explanation:

flowchart TB
    subgraph 筛选维度
        DC[设备类别<br/>DeviceCategory]
        DE[设备<br/>Device]
    end

    subgraph 异常统计
        CES[设备通道异常统计<br/>DeviceChannerlExceptionStatistics]
    end

    subgraph 异常详情
        PNR[点位NG记录<br/>PinNgRecord]
        NI[不良信息<br/>NgInfo]
    end

    subgraph 触发来源
        SPR[工序结果上报<br/>SetTrayProcessResult]
        PCQ[点位检查队列<br/>hf_mes_queue_pincheck]
    end

    DC -->|1:N| DE
    DE -->|1:1| CES
    CES -->|关联查询| PNR
    PNR -->|关联| NI
    SPR -->|触发验证| PCQ
    PCQ -->|异步更新| CES

Relationship Explanation:

Relationship Type	Description
Device Category → Device	1 to N: One device category contains multiple devices
Device → Channel Exception Statistics	1 to 1: Each device corresponds to one channel exception statistics record
Channel Exception Statistics → Pin NG Record	1 to N: Query exception details through device code and channel number
Pin NG Record → Defect Information	N to 1: Each NG record is associated with a defect code to get the defect description

Simplified Relationship Diagram:

flowchart LR
    A[设备类别] -->|1:N| B[设备]
    B -->|1:1| C[通道异常统计]
    C -->|关联| D[点位NG记录]
    D -->|关联| E[不良信息]

3. Alert Center Interaction Flow

3.1 Workstation Overview

3.1.1 Workstation Overview Description

The workstation overview page displays all device categories (workstations) in card form. Each card shows the workstation name and two types of abnormal device counts:

• Consecutive Error Device Count: Number of devices with at least one channel having ≥ 3 consecutive errors
• Cumulative Error Device Count: Number of devices with at least one channel having ≥ 10 cumulative errors

Users can filter by time range and specific device through filter conditions.

Function Screenshot:

3.1.2 Query Conditions

Query Conditions:

Query Condition	Description
Time Range	Select start and end time, accurate to seconds
Workstation	Select device category (workstation) from dropdown list, such as formation, capacity grading, OCV, etc.
Device	After selecting a workstation, further select a specific device for filtering (optional)

Operation Steps:

1. Go to [Data Middle Ground] → [Alert Center]
2. Set time range (required)
3. Select workstation (optional, defaults to showing all workstations)
4. If viewing a specific device, select the device after selecting the workstation
5. Click [Query] button, the system displays alert data that meets the conditions

Function Screenshot:

3.1.3 Workstation Card Information

Each workstation card contains the following information:

Display Field	Description
Workstation Name	Name of the device category, such as "Formation", "Capacity Grading"
Consecutive Error Device Count	Total number of devices with consecutive error channels (≥3 times) under this workstation, displayed as a blue badge
Cumulative Error Device Count	Total number of devices with cumulative error channels (≥10 times) under this workstation, displayed as an orange badge
View Data	When consecutive error device count or cumulative error device count > 0, click to view details

Function Screenshot:

3.2 Device Exception Details

3.2.1 Device Exception Details Description

Click the [View Data] button on the workstation card to open a full-screen dialog, divided into two columns:

• Left: Consecutive Error List — Displays devices with consecutive errors under this workstation
• Right: Cumulative Error List — Displays devices with cumulative errors under this workstation

Function Screenshot:

3.2.2 Consecutive Error List

The consecutive error list displays all devices under this workstation that have channels with consecutive error counts ≥ 3.

List Fields:

Field	Description
Device Name	Display name of the device
Device Code	Unique identification code of the device
Exception Channel Count	Total number of channels with consecutive errors (≥3 times) in this device
Last Reset Time	Time of the last consecutive error count clearance
Update Time	Last update time of the device exception statistics data
Operation	Includes [Details] and [Clear] buttons

Expand Row: Click the expand button at the beginning of the row to view the consecutive error count for each channel of the device. Each channel displays the specific value as a badge, supporting clicking on a single channel for individual reset.

3.2.3 Cumulative Error List

The cumulative error list displays all devices under this workstation that have channels with cumulative error counts ≥ 10.

List Fields:

Field	Description
Device Name	Display name of the device
Device Code	Unique identification code of the device
Exception Channel Count	Total number of channels with cumulative errors (≥10 times) in this device
Last Reset Time	Time of the last cumulative error count clearance
Update Time	Last update time of the device exception statistics data
Operation	Includes [Details] and [Clear] buttons

Expand Row: Click the expand button at the beginning of the row to view the cumulative error count for each channel of the device. Each channel displays the specific value as a badge, supporting clicking on a single channel for individual reset.

3.3 Channel Exception Details

3.3.1 Channel Exception Details Description

In the consecutive error list or cumulative error list, click the [Details] button of a device row to pop up the channel exception details dialog, showing specific error information for all abnormal channels of the device.

Function Screenshots:

3.3.2 Channel Exception Details Fields

Details List Fields:

Field	Description
Device Name	Display name of the device
Device Code	Unique identification code of the device
Channel Number	Channel number where the exception occurred
Error Code	Error code of the exception
Error Description	Specific description information of the exception
Exception Time	Specific time when the exception occurred

[Note] When viewing details, the system displays exception records of the corresponding type according to whether it's consecutive error or cumulative error. If the device has new exception records after the last reset, only exceptions generated after the reset will be displayed in the details.

3.4 Exception Clearance

3.4.1 Exception Clearance Description

The alert center supports two granularities of exception clearance, which users can choose flexibly according to actual situations.

Clearance Methods:

Clearance Method	Description	Applicable Scenario
Device-level Clearance	Clear all exception channel counts of the device	The device has fully recovered, and all channel issues have been resolved
Single-channel Clearance	Only clear the exception count of the specified channel	Only individual channel issues have been resolved, and other channels still need attention

Clearance Effects:

Clearance Type	Effect
Consecutive Error Clearance	Reset/clear all consecutive error counts of the device to zero, record the last reset time
Cumulative Error Clearance	Reset/clear all cumulative error counts of the device to zero, record the last reset time

3.4.2 Device-level Clearance

Operation Steps:

1. On the device exception details page, find the device row to clear
2. Click [Clear] button
3. The system pops up a confirmation dialog, confirm to execute the clearance operation
4. After successful clearance, the page data refreshes automatically, and the workstation overview updates synchronously

[Note] Device-level clearance will clear all channel exception counts of the device at once, please operate with caution. [Important] After clearance, the related Pin NG records will also be marked as processed for subsequent traceability.

Function Screenshot:

3.4.3 Single-channel Clearance

Operation Steps:

1. On the device exception details page, click the expand button of the device row to display the exception counts of each channel
2. Click the corresponding button for the channel to clear
3. The system pops up a confirmation dialog, confirm to execute the single-channel clearance operation
4. After successful clearance, the page data refreshes automatically

[Note] Single-channel clearance only sets the exception count of that channel to zero, without affecting the exception counts of other channels. [Note] Single-channel clearance does not mark Pin NG records as processed, only resets the count statistics.

Function Screenshot:

4. Alert Trigger Mechanism

4.1 Alert Trigger Flow Description

The data in the alert center comes from the process result data reported by devices during production execution. When a device calls the MES interface to report process results, the system automatically performs channel exception detection according to the process configuration.

Trigger Flow:

sequenceDiagram
    participant 设备 as Device
    participant MES接口 as MES Process Reporting Interface
    participant 验证 as Channel Exception Verification
    participant 队列 as Alert Queue
    participant 统计 as Exception Statistics Table

    设备->>MES接口: 1. Report process result data (including pin_check, NG information)
    MES接口->>MES接口: 2. Check if channel exception recording is enabled for the process
    MES接口->>验证: 3. Channel exception recording is enabled for the process, trigger verification
    验证->>验证: 4. Verify the validity of the pin_check array
    验证->>队列: 5. Exception exists (pin_check=1), write to alert queue
    队列->>统计: 6. Asynchronous task consumes the queue, update exception statistics
    统计->>统计: 7. Accumulate consecutive/cumulative exception counts for the channel

Flow Description:

Step	Executor	Operation	Description
1	Device	Report process results	The device calls the MES interface to submit process completion data, which includes pin_check (point check) and NG (defect code) information
2	MES	Check process configuration	Determine whether the "channel exception recording" switch is enabled for the process in the process details
3	MES	Trigger verification	Channel exception recording is enabled for the process, trigger point check verification logic
4	MES	Verify data	Check the validity of the pin_check array and NG array (consistent length, values are 0 or 1, NG is required when pin_check=1)
5	MES	Write to queue	When there are entries with value 1 in the pin_check array, write the exception data to the alert cache queue
6	Background Task	Consume queue	Asynchronous task reads unprocessed data from the alert queue and aggregates exception counts by device code
7	Background Task	Update statistics	Accumulate channel exception counts to the exception statistics table, distinguishing between consecutive errors and cumulative errors

4.2 Preconditions

The alert function requires the following pre-configurations:

Precondition	Description	Configuration Location
Enable Channel Exception Recording	Enable the "Enable Channel Exception Recording" switch for the process in the process details	Production Configuration → Process Model → Process Flow → Set Process
Configure Defect Codes	Maintain defect codes and their descriptions in the system	Production Configuration → Product Management → Defect Management
Device Category Configuration	Ensure devices are bound to the correct device category (workstation)	Device Model → Device Information

[Important] Only when "channel exception recording" is enabled in the process configuration of the process details will channel exception detection be triggered when the device reports process results, and the alert center will display alert data related to this process.

5. Common Issues

5.1 No data in the Alert Center?

Possible Reasons:

1. The "channel exception recording" switch is not enabled for the process. Please check the process configuration in [Process Details]
2. The device has not yet reported process result data containing pin_check information
3. No exception data was generated within the selected query time range
4. Device category (workstation) is not configured correctly

5.2 Why does the data reappear after clearing?

The clearance operation only resets the exception count and does not prevent the device from continuing to report exception data. If the device channel issue is not fundamentally resolved, the count will accumulate again and reach the alert threshold after the device continues to report exceptions. Recommendations:

• Locate and resolve the root cause of the device channel issue before performing the clearance operation
• Observe the device status after clearance to confirm that exceptions no longer recur

5.3 What's the difference between consecutive errors and cumulative errors?

• Consecutive Errors: The same channel reports errors 3 times or more consecutively, indicating that the channel has been continuously abnormal recently and is the current focus of attention
• Cumulative Errors: The same channel reports errors 10 times or more cumulatively, indicating that although the channel may not be consecutive, the overall exception frequency is high, reflecting the long-term health status of the device

5.4 What to do if data export fails?

The export function relies on asynchronous task mechanism. Please check:

1. Whether the time range and workstation have been selected
2. Whether the system download task service is running normally
3. You can view the task status and failure reasons in the [System Download Tasks] page