HF-MES-manual/data_middleground/battery_detail_report.md

电池详情报表

1. 功能概述

电池详情报表属于 MES 系统数据中台的报表分析模块，用于按工艺流程 + 批次 + 工序的维度查询电池在各工序中的详细结果参数数据。系统根据用户选择的工序，动态生成多级表头，将各工序的设定值参数和实际结果参数以表格形式展示，支持灵活筛选工序结果参数、按工序结束时间过滤，以及大批量数据导出为 CSV 文件。

核心功能：

• 工艺流程联动筛选：按工艺流程类别 → 工艺流程 → 批次 → 工序的层级联动选择，快速定位目标数据范围
• 工序参数动态选择：根据选中的工序，动态加载各工序的结果参数树，用户可自由勾选需要展示的参数列
• 多级表头展示：系统根据工序类型（常规工序 / 化成-分容多工步工序）自动生成多级嵌套表头，清晰展示工序 → 工步 → 结果参数的层级关系
• 时间范围过滤：以所选最后一个工序的完成时间作为筛选条件，精准定位时间段内的生产数据
• 数据导出：支持将查询条件下的全量数据通过异步任务导出为 CSV 文件，适用于大批量数据分析

功能对应截图 ：

2. 术语说明

术语	定义	说明
电池详情报表	Battery Detail Report，按批次和工序维度查询电池结果参数的报表	数据中台报表分析模块的核心功能之一
工艺流程	Process Flow，定义产品从原材料到成品的完整加工顺序	筛选条件的一级维度，按工艺流程类别分组展示
批次	Batch，生产计划中的最小执行单元	筛选条件的二级维度，一个批次关联一个工艺流程
工序	Process，工艺流程中的一个加工环节	筛选条件的三级维度，支持多选
工序参数	Process Result Param，工序作业完成后记录的实际结果数据	如电压、电流、容量、内阻等，用户可选择性展示
多工步工序	Multi-Step Process，一个工序内包含多个工步（如化成、分容）	结果参数会按工步拆分，如电压01、电压02
单工步结果参数	不随工步变化的工序结果参数	如进站时间、出站时间、设备编码等
工序结束时间	工序的完成时间（finish_time）	时间范围的筛选依据，以所选最后一个工序的完成时间为准
档位/档位类别	Classification，电池按容量等级划分的档位	如 K1、K2、F1 等
导出任务	Export Task，异步大数据导出的任务机制	在系统顶部"系统下载任务"中查看进度并下载

数据模型关系说明：

flowchart TB
    subgraph 筛选维度
        FC[工艺流程类别]
        TF[工艺流程]
        BA[批次]
        PR[工序]
    end

    subgraph 数据来源
        BPL[电池工序聚合日志<br/>hf_mes_bkv_batch_process_log]
        BKV[电池结果数据分表<br/>hf_mes_tmp_bkv_subbatch]
    end

    subgraph 工序相关
        WS[工序单元<br/>ProcessWorkingsubclass]
        RP[工序结果参数<br/>TechnologyProcessResultParam]
        DP[默认结果参数<br/>DefaultResultParam]
        PS[工序设定值<br/>setting字段]
    end

    FC -->|1:N| TF
    TF -->|1:N| BA
    TF -->|1:N| PR
    PR -->|关联| WS
    PR -->|拥有| RP
    WS -->|预设| DP
    PR -->|配置| PS

    BA -->|产出| BPL
    BPL -->|关联查询| BKV

关系说明：

关系类型	说明
工艺流程类别 → 工艺流程	1 对 N：一个工艺流程类别包含多个工艺流程
工艺流程 → 批次	1 对 N：一个工艺流程可被多个批次引用
工艺流程 → 工序	1 对 N：一个工艺流程包含多个工序
工序 → 工序单元	N 对 1：每个工序关联一个工序单元
工序 → 工序结果参数	1 对 N：每个工序可配置多个结果参数
工序单元 → 默认结果参数	1 对 N：每个工序单元可预设多个默认结果参数
批次 → 电池工序日志	1 对 N：一个批次下包含多条电池工序日志记录
电池工序日志 → 电池结果数据	1 对 1：每条日志关联一条电池结果数据（按 subbatch 路由分表）

简化关系图：

flowchart LR
    A[工艺流程类别] -->|1:N| B[工艺流程]
    B -->|1:N| C[批次]
    B -->|1:N| D[工序]
    D -->|关联| E[工序单元]
    E -->|预设| F[默认结果参数]
    C -->|查询| G[电池工序日志]
    G -->|关联| H[电池结果数据]

3. 电池详情报表交互流程

3.1 筛选条件设置

3.1.1 筛选条件说明

左侧面板提供层级联动的筛选条件，用户需按"流程 → 批次 → 工序"的顺序逐级选择，系统会根据上一级选择动态加载下一级的选项。

筛选面板截图 ：

3.1.2 工艺流程选择

工艺流程按工艺流程类别分组展示，便于用户快速定位。

操作步骤：

1. 进入【数据中台】→【报表分析】→【电池详情报表】
2. 在左侧【筛选条件】面板的【流程】下拉框中，按工艺流程类别分组浏览
3. 选择目标工艺流程

字段说明：

字段	说明	必填
流程	按工艺流程类别分组的工艺流程列表，选中后联动加载批次和工序	是

【注意】 切换工艺流程后，已选的批次和工序将被清空，需重新选择。

3.1.3 批次选择

操作步骤：

1. 完成工艺流程选择后，【批次】下拉框自动加载该工艺流程下的所有批次
2. 从下拉列表中选择目标批次，支持输入关键字过滤

字段说明：

字段	说明	必填
批次	所选工艺流程下的生产批次列表	是

3.1.4 工序选择

操作步骤：

1. 完成工艺流程选择后，【工序】下拉框自动加载该工艺流程下的所有工序
2. 支持多选（可勾选多个工序），选中后右侧工序参数树将动态更新

字段说明：

字段	说明	必填
工序	所选工艺流程下的工序列表，支持多选	是（查询时必选）

【注意】 NG 判定工序（NG01~NG05）和分选工序（SELECTION）不在筛选列表中显示。

3.2 工序参数选择

3.2.1 工序参数说明

工序参数是各工序在作业过程中记录的实际结果数据。系统根据用户在筛选条件中选择的工序，动态加载对应工序的结果参数，以树形结构展示。用户可以自由勾选需要在报表中展示的参数列。

功能对应截图 ：

3.2.2 工序参数树操作

操作步骤：

1. 在筛选条件中勾选目标工序
2. 左侧【工序参数】区域自动加载所选工序的结果参数树
3. 勾选需要展示的参数项，支持父子级联勾选
4. 使用搜索框可按关键字快速定位参数

字段说明：

字段	说明
工序名称（父节点）	工序的名称，如"OCV1"、"分容"
结果参数（子节点）	该工序下的结果参数，如电压、电流、内阻等

【重要】 如果未勾选任何工序参数，查询时将不显示该工序的结果参数列。

3.3 查询结果展示

3.3.1 查询操作步骤

1. 完成筛选条件设置（流程、批次、工序）和工序参数勾选
2. 在右上方面板设置查询条件：
   • 工序结束时间：选择时间范围，系统以所选最后一个工序的完成时间作为过滤条件
   • 托盘：可选，按托盘号精确过滤
3. 点击【查询】按钮
4. 系统生成多级表头并加载数据

查询条件说明：

查询条件	说明	必填
工序结束时间	以所选最后一个工序的完成时间（finish_time）作为时间范围条件	是
托盘	输入托盘号进行精确过滤	否

工序结束时间规则：

• 如果选择了工序，则以所选工序中最后一个的完成时间作为过滤条件
• 如果未选择工序（使用全部工序），则以工艺流程中最后一个工序的完成时间作为过滤条件

功能对应截图 ：

3.3.2 表格表头结构

表格采用多级嵌套表头结构，分为三层：

第一层 — 工序层： 以每个工序名称为一级列头，如"OCV1"、"分容"、"DCIR"等。

第二层 — 工步层（仅化成/分容类工序）： 对于化成（FORMATION/HC）、分容（FR）、预化成（FORMATION_SS）等多工步工序，在工序下按工步展开二级列头，如"第1工步：搁置"、"第2工步：恒流恒压充电"。

第三层 — 参数层： 每个工序（或工步）下的具体结果参数，如电压、电流、容量、内阻等。

基础信息列（固定显示）：

列名	说明
电池编码	电池在系统中的唯一标识
批次号	电池所属的生产批次
电池型号	产品的型号代码
工艺流程	该批次关联的工艺流程名称
托盘号	电池所在托盘的编号
流水号	托盘在批次内的流水编号
激活状态	电池当前状态：激活 / 未激活
档位类别	电池的容量档位分类
档位	电池的具体档位等级（如 K1、K2、F1 等）

化成/分容类工序特殊说明：

化成和分容工序包含多个工步（搁置、恒流恒压充电、恒流恒压放电、恒流放电、恒流充电、循环），每个工步独立记录结果参数。系统会根据工序设定值（setting）中的工步配置自动生成对应的列。

例如，分容工序有 5 个工步，每个工步记录电压（VOL）、电流（CUR）、容量（CAP），则动态生成：

| 第1工步：搁置 | | | 第2工步：恒流恒压充电 | | | ... | |:---:|:---:|:---:|:---:|:---:|:---:| | VOL01 | CUR01 | CAP01 | VOL02 | CUR02 | CAP02 | ... |

单工步结果参数：

部分结果参数不随工步变化（is_only = 1），如进站时间（START_TIME）、出站时间（FINISH_TIME）、设备编码（DEVICE_CODE），这些参数在工序层级直接展示，不归属到具体工步下。

3.3.3 数据来源说明

查询结果的数据来自以下数据表：

数据表	说明
电池工序聚合日志表	记录每个电池在每道工序的完成状态、完成时间、档位等信息
电池结果数据分表	按 subbatch 分表存储电池的详细结果参数值（如电压、电流等）
生产批次表	提供批次的工艺流程和产品型号关联信息

系统先查询聚合日志表获取电池列表，再根据每条电池的 subbatch 路由到对应的结果数据分表获取各工序参数值。

3.4 数据导出

3.4.1 导出说明

系统采用异步任务导出机制，先将导出请求创建为后台任务，用户可在系统顶部的"系统下载任务"中查看任务进度并下载生成的文件。导出格式为 CSV。

功能对应截图 ：

3.4.2 导出操作步骤

1. 设置好筛选条件（流程、批次、工序、时间范围和工序参数）
2. 点击【导出】按钮
3. 系统弹出确认提示："数据导出需要先创建下载任务，是否继续？"
4. 点击【确定】，系统创建后台导出任务
5. 在系统顶部菜单进入【系统下载任务】，查看任务进度
6. 任务完成后，点击下载获取 CSV 文件

【注意】 导出前必须选择批次，否则无法导出。

3.4.3 导出文件格式

导出 CSV 文件的表头同样采用多级结构：

层级	说明	示例
第 1 行（一级标题）	工序名称	OCV1, , , 分容, , , , , ,
第 2 行（二级标题）	工步名称（仅多工步工序）	, , , 第1工步：搁置, , , 第2工步：恒流恒压充电
第 3 行（三级标题）	具体结果参数名称	电池编码, 批次号, ..., 电压, 电流, 电压, 电流

【重要】 数据量较大的批次，系统会自动将数据拆分为多个 CSV 文件分别生成，最后合并为一个完整的 CSV 文件供下载。

3.5 分页浏览

查询结果支持分页浏览，系统默认每页显示 10 条记录。用户可以在表格底部切换页码和每页条数。

分页操作：

• 点击页码切换页面
• 修改每页显示条数
• 系统自动重新加载对应页的数据

【注意】 切换分页时无需重新点击查询按钮，系统会自动根据当前筛选条件加载对应页码的数据。

---

4. 常见问题

4.1 为什么选择工艺流程后没有批次可选？

请确认该工艺流程下是否已创建了生产批次。批次需要在【生产批次管理】中创建并与工艺流程关联。

4.2 为什么工序参数树为空？

请先在筛选条件中勾选目标工序，工序参数树会根据选中的工序动态加载对应的结果参数。如果已勾选工序但参数树仍为空，请确认该工序是否已在【工艺模型】中配置了结果参数。

4.3 为什么化成/分容工序查询报错"设定值为空"？

化成和分容工序需要在【工艺模型】→【工艺详情】中配置工序设定值（工步信息），否则系统无法确定工步数量和类型，报表无法生成。请联系系统管理员配置。

4.4 为什么导出的 CSV 文件与页面展示的列不同？

导出时会导出所选工序的全部结果参数（不再受页面工序参数树的勾选影响），而页面展示仅显示勾选的参数列。导出以完整数据为准。

4.5 导出任务创建后在哪里下载？

在系统顶部菜单栏找到【系统下载任务】，进入后可查看所有导出任务的状态和进度，任务完成后即可下载。