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:

Figure 1 Battery Detail Report Page

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:

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:

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:

Figure 1 Filter Condition Panel

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:

Figure 1 Process Selection Panel

Figure 2 Process Data Filter Panel

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:

Figure 1 Query Conditions and Results

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:

Figure 1 Export Data

Figure 2 Get Export File

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.