HF-MES-manual/en/data_middleground/battery_detail_report.md

# Battery Detail Report

## 1. Function Overview

The Battery Detail Report belongs to the Report Analysis module of the MES system's Data Middle Platform. It is used to query detailed result parameter data of batteries in each process based on **Process Flow + Batch + Process** dimensions. The system dynamically generates multi-level headers based on user-selected processes, displaying the set values and actual result parameters of each process in tabular form. It supports flexible filtering of process result parameters, filtering by process completion time, and exporting large volumes of data as CSV files.

**Core Functions:**

- Process Flow Linked Filtering: Hierarchical linked selection by process flow category → process flow → batch → process to quickly locate target data range
- Process Parameter Dynamic Selection: Dynamically loads the result parameter tree for each process based on selected processes, allowing users to freely select parameter columns to display
- Multi-level Header Display: Automatically generates nested multi-level headers based on process type (regular process / formation-capacity multi-step process), clearly showing the hierarchical relationship of process → step → result parameter
- Time Range Filtering: Uses the completion time of the last selected process as the filtering condition to accurately locate production data within the time period
- Data Export: Supports exporting full data under query conditions as CSV files through asynchronous tasks, suitable for large-scale data analysis

**Screenshots:**

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/data_middleground/battery_detail_report/电池详情报表页面截图.png" alt="Battery Detail Report Page">
    <div style="font-size:12px; font-weight:bold;">Figure 1 Battery Detail Report Page</div>
</div>

## 2. Term Definitions

| Term | Definition | Description |
|------|------------|-------------|
| Battery Detail Report | Report for querying battery result parameters by batch and process dimensions | Core function of the Report Analysis module in Data Middle Platform |
| Process Flow | Defines the complete processing sequence from raw materials to finished products | Primary dimension of filtering conditions, grouped by process flow category |
| Batch | Minimum execution unit in production planning | Secondary dimension of filtering conditions, one batch relates to one process flow |
| Process | A processing step in the process flow | Tertiary dimension of filtering conditions, supports multiple selection |
| Process Parameter | Actual result data recorded after process completion | Such as voltage, current, capacity, internal resistance, etc., users can selectively display |
| Multi-step Process | A process containing multiple steps (e.g., formation, capacity grading) | Result parameters are split by step, e.g., voltage01, voltage02 |
| Single-step Result Parameter | Process result parameters that do not change with steps | Such as start time, end time, equipment ID, etc. |
| Process End Time | Completion time of a process (finish_time) | Filtering basis for time range, based on the completion time of the last selected process |
| Grade/Grade Category | Capacity grade classification of batteries | Such as K1, K2, F1, etc. |
| Export Task | Asynchronous large data export task mechanism | View progress and download in "System Download Tasks" at the top of the system |

**Data Model Relationship Diagram:**

```mermaid
flowchart TB
    subgraph Filter Dimensions
        FC[Process Flow Category]
        TF[Process Flow]
        BA[Batch]
        PR[Process]
    end

    subgraph Data Sources
        BPL[Battery Process Aggregation Log<br/>hf_mes_bkv_batch_process_log]
        BKV[Battery Result Data Shard Table<br/>hf_mes_tmp_bkv_subbatch]
    end

    subgraph Process Related
        WS[Process Working Unit<br/>ProcessWorkingsubclass]
        RP[Process Result Parameter<br/>TechnologyProcessResultParam]
        DP[Default Result Parameter<br/>DefaultResultParam]
        PS[Process Set Values<br/>setting field]
    end

    FC -->|1:N| TF
    TF -->|1:N| BA
    TF -->|1:N| PR
    PR -->|Relate| WS
    PR -->|Has| RP
    WS -->|Preset| DP
    PR -->|Configure| PS

    BA -->|Produce| BPL
    BPL -->|Relate Query| BKV
```

**Relationship Descriptions:**

| Relationship Type | Description |
|-------------------|-------------|
| Process Flow Category → Process Flow | **1 to N**: One process flow category contains multiple process flows |
| Process Flow → Batch | **1 to N**: One process flow can be referenced by multiple batches |
| Process Flow → Process | **1 to N**: One process flow contains multiple processes |
| Process → Process Unit | **N to 1**: Each process relates to one process unit |
| Process → Process Result Parameter | **1 to N**: Each process can configure multiple result parameters |
| Process Unit → Default Result Parameter | **1 to N**: Each process unit can preset multiple default result parameters |
| Batch → Battery Process Log | **1 to N**: One batch contains multiple battery process log records |
| Battery Process Log → Battery Result Data | **1 to 1**: Each log relates to one battery result data record (routed by subbatch) |

**Simplified Relationship Diagram:**

```mermaid
flowchart LR
    A[Process Flow Category] -->|1:N| B[Process Flow]
    B -->|1:N| C[Batch]
    B -->|1:N| D[Process]
    D -->|Relate| E[Process Unit]
    E -->|Preset| F[Default Result Parameter]
    C -->|Query| G[Battery Process Log]
    G -->|Relate| H[Battery Result Data]
```

## 3. Battery Detail Report Interaction Flow

### 3.1 Filter Condition Setting

#### 3.1.1 Filter Condition Description

The left panel provides hierarchical linked filter conditions. Users need to select in the order of "Process Flow → Batch → Process", and the system dynamically loads options for the next level based on the previous selection.

**Screenshots:**

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/data_middleground/battery_detail_report/筛选条件面板截图.png" alt="Filter Condition Panel">
    <div style="font-size:12px; font-weight:bold;">Figure 1 Filter Condition Panel</div>
</div>

#### 3.1.2 Process Flow Selection

Process flows are displayed grouped by **Process Flow Category** for quick location.

**Operation Steps:**

1. Go to [Data Middle Platform] → [Report Analysis] → [Battery Detail Report]
2. In the left [Filter Conditions] panel, browse the [Process Flow] dropdown grouped by process flow category
3. Select the target process flow

**Field Description:**

| Field | Description | Required |
|-------|-------------|----------|
| Process Flow | List of process flows grouped by process flow category, loads batches and processes upon selection | Yes |

**[Note]** After switching process flows, the selected batches and processes will be cleared and need to be reselected.

#### 3.1.3 Batch Selection

**Operation Steps:**

1. After selecting a process flow, the [Batch] dropdown automatically loads all batches under that process flow
2. Select the target batch from the dropdown list, supports keyword filtering

**Field Description:**

| Field | Description | Required |
|-------|-------------|----------|
| Batch | List of production batches under the selected process flow | Yes |

#### 3.1.4 Process Selection

**Operation Steps:**

1. After selecting a process flow, the [Process] dropdown automatically loads all processes under that process flow
2. Supports multiple selection (can check multiple processes), and the process parameter tree on the right will update dynamically

**Field Description:**

| Field | Description | Required |
|-------|-------------|----------|
| Process | List of processes under the selected process flow, supports multiple selection | Yes (required for query) |

**[Note]** NG judgment processes (NG01~NG05) and sorting processes (SELECTION) are not displayed in the filter list.

### 3.2 Process Parameter Selection

#### 3.2.1 Process Parameter Description

Process parameters are actual result data recorded during each process operation. The system dynamically loads result parameters for the selected processes and displays them in a tree structure. Users can freely check parameter columns to display in the report.

**Screenshots:**

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/data_middleground/battery_detail_report/工序选择筛选面板截图.png" alt="Process Selection Panel">
    <div style="font-size:12px; font-weight:bold;">Figure 1 Process Selection Panel</div>
</div>

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/data_middleground/battery_detail_report/工序数据筛选面板截图.png" alt="Process Data Filter Panel">
    <div style="font-size:12px; font-weight:bold;">Figure 2 Process Data Filter Panel</div>
</div>

#### 3.2.2 Process Parameter Tree Operations

**Operation Steps:**

1. Check target processes in the filter conditions
2. The [Process Parameters] area on the left automatically loads the result parameter tree for selected processes
3. Check parameter items to display, supports parent-child cascade checking
4. Use the search box to quickly locate parameters by keyword

**Field Description:**

| Field | Description |
|-------|-------------|
| Process Name (Parent Node) | Name of the process, e.g., "OCV1", "Capacity Grading" |
| Result Parameter (Child Node) | Result parameters under this process, e.g., voltage, current, internal resistance |

**[Important]** If no process parameters are checked, the result parameter columns for that process will not be displayed during query.

### 3.3 Query Result Display

#### 3.3.1 Query Operation Steps

1. Complete filter condition settings (process flow, batch, process) and process parameter selection
2. Set query conditions in the upper right panel:
   - **Process End Time**: Select time range, system uses completion time of the last selected process as filter condition
   - **Tray**: Optional, filter by tray number exactly
3. Click [Query] button
4. System generates multi-level headers and loads data

**Query Condition Description:**

| Condition | Description | Required |
|-----------|-------------|----------|
| Process End Time | Uses completion time (finish_time) of the last selected process as time range condition | Yes |
| Tray | Enter tray number for exact filtering | No |

> **Process End Time Rules:**
> - If processes are selected, uses completion time of the **last** selected process as filter condition
> - If no process is selected (using all processes), uses completion time of the **last process** in the process flow as filter condition

**Screenshots:**

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/data_middleground/battery_detail_report/查询条件与结果截图.png" alt="Query Conditions and Results">
    <div style="font-size:12px; font-weight:bold;">Figure 1 Query Conditions and Results</div>
</div>

#### 3.3.2 Table Header Structure

The table uses a **multi-level nested header** structure with three layers:

**Layer 1 - Process Layer:**
Uses each process name as the primary column header, e.g., "OCV1", "Capacity Grading", "DCIR".

**Layer 2 - Step Layer (Formation/Capacity Processes Only):**
For multi-step processes like formation (FORMATION/HC), capacity grading (FR), and pre-formation (FORMATION_SS), expands secondary column headers by step under the process, e.g., "Step 1: Rest", "Step 2: CC/CV Charge".

**Layer 3 - Parameter Layer:**
Specific result parameters under each process (or step), e.g., voltage, current, capacity, internal resistance.

**Basic Information Columns (Fixed Display):**

| Column Name | Description |
|-------------|-------------|
| Battery ID | Unique identifier for battery in system |
| Batch No. | Production batch of battery |
| Battery Model | Product model code |
| Process Flow | Process flow name associated with batch |
| Tray No. | Tray number of battery |
| Serial No. | Serial number of tray within batch |
| Activation Status | Current status: Activated / Not Activated |
| Grade Category | Capacity grade category of battery |
| Grade | Specific grade level (e.g., K1, K2, F1) |

**Special Note for Formation/Capacity Processes:**

Formation and capacity grading processes contain multiple steps (rest, CC/CV charge, CC/CV discharge, CC discharge, CC charge, cycle), with result parameters recorded independently for each step. The system dynamically generates corresponding columns based on step configurations in process set values (setting).

For example, a capacity grading process with 5 steps, each recording voltage (VOL), current (CUR), and capacity (CAP), dynamically generates:

| Step 1: Rest | | | Step 2: CC/CV Charge | | | ... |
|:---:|:---:|:---:|:---:|:---:|:---:|
| VOL01 | CUR01 | CAP01 | VOL02 | CUR02 | CAP02 | ... |

**Single-step Result Parameters:**

Some result parameters do not change with steps (is_only = 1), such as start time (START_TIME), end time (FINISH_TIME), and equipment ID (DEVICE_CODE). These parameters are displayed directly at the process level, not under specific steps.

#### 3.3.3 Data Source Description

Query results come from the following data tables:

| Table | Description |
|-------|-------------|
| Battery Process Aggregation Log Table | Records completion status, completion time, grade, etc. for each battery in each process |
| Battery Result Data Shard Table | Stores detailed result parameter values (e.g., voltage, current) partitioned by subbatch |
| Production Batch Table | Provides process flow and product model association information for batches |

The system first queries the aggregation log table to obtain the battery list, then routes to the corresponding result data shard table based on each battery's subbatch to retrieve parameter values for each process.

### 3.4 Data Export

#### 3.4.1 Export Description

The system uses an **asynchronous task export** mechanism. Export requests are first created as background tasks, and users can view task progress and download generated files in "System Download Tasks" at the top of the system. Export format is CSV.

#### 3.4.2 Export Steps

1. Set filter conditions (process flow, batch, process, time range, and process parameters)
2. Click [Export] button
3. System pops up confirmation prompt: "Data export requires creating a download task first, continue?"
4. Click [OK], system creates background export task
5. Go to [System Download Tasks] in the top menu to view task progress
6. After task completion, click download to get CSV file

**[Note]** A batch must be selected before exporting, otherwise export will fail.

#### 3.4.3 Export File Format

The exported CSV file also uses a multi-level header structure:

| Level | Description | Example |
|-------|-------------|---------|
| Row 1 (Level 1 Header) | Process names | OCV1, , , Capacity Grading, , , , , , |
| Row 2 (Level 2 Header) | Step names (multi-step processes only) | , , , Step 1: Rest, , , Step 2: CC/CV Charge |
| Row 3 (Level 3 Header) | Specific result parameter names | Battery ID, Batch No., ..., Voltage, Current, Voltage, Current |

**[Important]** For batches with large data volume, the system automatically splits data into multiple CSV files and merges them into a complete CSV file for download.

**Screenshots:**

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/data_middleground/battery_detail_report/导出数据截图.png" alt="Export Data">
    <div style="font-size:12px; font-weight:bold;">Figure 1 Export Data</div>
</div>

<div align="center">
    <img style="margin-top:18px;" src="/public/image_en/data_middleground/battery_detail_report/获取导出文件截图.png" alt="Get Export File">
    <div style="font-size:12px; font-weight:bold;">Figure 2 Get Export File</div>
</div>

### 3.5 Pagination

Query results support pagination, with the system defaulting to 10 records per page. Users can switch pages and adjust page size at the bottom of the table.

**Pagination Operations:**

- Click page numbers to switch pages
- Modify records per page
- System automatically reloads data for the corresponding page

**[Note]** No need to click query again when switching pages; the system automatically loads data for the current filter conditions.

---

## 4. Common Issues

### 4.1 Why are there no batches available after selecting a process flow?

Please confirm whether production batches have been created under this process flow. Batches need to be created and associated with process flows in [Production Batch Management].

### 4.2 Why is the process parameter tree empty?

Please first check target processes in the filter conditions. The process parameter tree dynamically loads corresponding result parameters based on selected processes. If the parameter tree is still empty after checking processes, please confirm whether result parameters have been configured for those processes in [Process Model].

### 4.3 Why does querying formation/capacity processes report "set values empty"?

Formation and capacity processes require configuring process set values (step information) in [Process Model] → [Process Details], otherwise the system cannot determine the number and types of steps, and the report cannot be generated. Please contact the system administrator for configuration.

### 4.4 Why do exported CSV files have different columns than what's displayed on the page?

Export will export **all result parameters** of selected processes (no longer affected by the page's process parameter tree selection), while page display only shows checked parameter columns. Export is based on complete data.

### 4.5 Where can I download after creating an export task?

Find [System Download Tasks] in the top menu bar. After entering, you can view the status and progress of all export tasks, and download when the task is complete.