# 风机数据管理平台 — 健康评估系统操作说明

| 项目 | 说明 |
|------|------|
| 文档版本 | V1.2 |
| 适用系统 | 健康评估子系统 |
| 适用对象 | 运维人员、业务用户、测试人员 |
| 文档用途 | 项目交付、软件著作权申报、功能测试报告 |

---

## 1. 系统概述

健康评估子系统用于对风电场及单台风机的运行健康状态进行量化评估与可视化展示。系统以 **风场**、**分析日期** 为查询维度，从风场级汇总下钻至单机组分项诊断，帮助用户快速掌握全场健康态势、识别风险机组并查看历史趋势。

**主要功能模块：**

| 序号 | 模块名称 | 功能说明 |
|------|----------|----------|
| 1 | 首页驾驶舱 | 风场筛选、日期选择、健康 Tab 汇总展示与快捷跳转 |
| 2 | 健康评估 | 风场健康全景分析、排行榜、风机列表筛选排序及机组详情 |
| 3 | 尾流分析 | 风资源分布与尾流影响评估（平台共用功能模块） |

**健康等级划分标准：**

| 等级 | 评分区间 | 含义 |
|------|----------|------|
| 优 | [90, 100] | 运行状态优秀 |
| 良 | [70, 90) | 运行状态良好 |
| 中 | [50, 70) | 运行状态一般，需关注 |
| 差 | (0, 50) | 运行状态较差，建议重点排查 |

---

## 2. 登录与进入系统

### 2.1 系统登录

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 在浏览器中打开系统登录地址 | 建议使用 Chrome、Edge 等现代浏览器 |
| 2 | 输入账号、密码 | 由系统管理员分配 |
| 3 | 点击「登录」 | 验证通过后进入系统主界面 |

### 2.2 进入健康评估模块

健康评估模块有以下两种常用入口：

| 入口方式 | 操作路径 |
|----------|----------|
| 方式一（菜单进入） | 登录后，在 **左侧菜单** 中点击 **「健康评估」** |
| 方式二（驾驶舱跳转） | 在首页驾驶舱右侧 **健康 Tab** 的表格中，点击目标 **风场名称** |

**说明：** 从驾驶舱跳转时，系统自动携带当前所选风场及分析日期，进入健康评估页后无需重复选择查询条件。

---

## 3. 首页驾驶舱操作说明

> 本节仅说明左侧统计面板（组织/风场选择、日期、接入统计、面板显示开关）及右侧 **健康 Tab** 相关操作，不涉及数据入库、数据接入等功能面板。

### 3.1 界面布局

首页采用 **地图 + 浮层面板** 布局，主要区域如下：

| 区域 | 位置 | 功能 |
|------|------|------|
| 左侧统计面板 | 页面左侧 | 组织/风场选择、日期选择、接入统计、显示开关 |
| 中央地图区 | 页面中部 | 展示风场地理分布及标记点 |
| 右侧面板 | 页面右侧 | 健康 / 异常 Tab 切换及业务数据展示 |

### 3.2 选择组织或风场

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 在左侧面板点击 **「请选择所属公司」** 下拉框 | 展开组织树形列表 |
| 2 | 在组织树中选择目标 **公司** 或 **风场** | 可在搜索框输入关键字快速过滤 |
| 3 | 单击目标节点完成选择 | 选择后自动生效，无需额外确认 |

**预期结果：**

- 中央地图刷新并展示所选范围内风场的地理标记点；
- 若选择 **公司** 层级，地图展示该公司下属全部风场；
- 若选择 **风场** 层级，地图聚焦展示该风场位置；
- 右侧 **健康 Tab** 数据按所选范围同步刷新。

### 3.3 选择分析日期

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 点击左侧面板中的 **日期选择器** | 弹出日历面板 |
| 2 | 在日历中点选目标日期 | 显示格式为 yyyy/MM/dd |
| 3 | 确认选择 | 右侧健康 Tab 按新日期重新加载 |

**补充说明：**

- 系统默认选中 **昨日** 作为分析日期；
- 支持点击清除按钮清空日期后重新选择；
- 日期变更后，健康 Tab 的饼图与表格数据将同步更新。

### 3.4 查看接入统计

左侧面板中以下两项为 **只读统计信息**，随平台数据自动更新，用户无需操作：

| 统计项 | 单位 | 说明 |
|--------|------|------|
| 已接入风场数 | 座 | 平台当前已接入的风场总数量 |
| 已接入风机数 | 台 | 平台当前已接入的风机总数量 |

### 3.5 显示 / 隐藏侧面板

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 找到左侧面板底部的 **显示 / 隐藏** 开关 | 默认处于「显示」状态 |
| 2 | 将开关拨至「隐藏」 | 收起右侧业务面板及中间留白，仅保留左侧统计面板与地图，便于查看地图全貌 |
| 3 | 将开关拨回「显示」 | 恢复右侧健康 / 异常业务面板 |

### 3.6 健康 Tab 操作

在右侧面板顶部，点击 **「健康」** Tab（与「异常」Tab 并列），进入健康概览视图。

#### 3.6.1 综合健康评分饼图

| 元素 | 说明 |
|------|------|
| 图例 | 优（绿色）、良（蓝色）、中（黄色）、差（红色） |
| 饼图扇区 | 展示当前查询范围内各健康等级的风机台数及占比 |
| 标签文字 | 非零扇区显示「等级名称 + 台数」 |

**交互操作：** 将鼠标悬停在饼图某一扇区上，弹出提示框显示该等级的 **名称、台数、占比百分比**。

#### 3.6.2 健康数据信息表

表格位于饼图下方，标题为 **「健康数据信息」**，支持自动滚动浏览（当风场数量较多时）。

| 列名 | 说明 |
|------|------|
| 风场名称 | 风场名称，蓝色可点击链接样式 |
| 优 | 该风场健康等级为「优」的风机台数 |
| 良 | 该风场健康等级为「良」的风机台数 |
| 中 | 该风场健康等级为「中」的风机台数 |
| 差 | 该风场健康等级为「差」的风机台数 |

**操作步骤 — 跳转至健康评估详情页：**

| 步骤 | 操作 |
|------|------|
| 1 | 确认左侧已选择正确的组织/风场，且日期符合分析需求 |
| 2 | 在健康 Tab 表格中找到目标风场所在行 |
| 3 | 点击该行的 **风场名称** |
| 4 | 页面自动跳转至 **健康评估** 模块，风场与日期自动回填 |

---

## 4. 健康评估模块操作说明

**入口路径：** 左侧菜单 → **健康评估**；或首页驾驶舱健康 Tab → 点击风场名称。

### 4.1 页面整体布局

进入健康评估模块后，页面自上而下分为三个区域：

| 区域 | 内容 |
|------|------|
| 顶部查询栏 | 风场选择、分析日期（固定显示在页面顶部工具区） |
| 上部概览区 | 全场健康度、子系统健康度、健康/预警排行榜（三列布局，窄屏下自动折行） |
| 下部列表区 | 风机列表标题、筛选/排序工具栏、风机卡片网格 |

页面加载数据时，中央显示加载动画；加载完成后各图表与列表同步展示。

### 4.2 查询条件设置

查询条件位于 **页面顶部工具栏**（页面标题右侧区域）：

| 控件 | 操作步骤 | 说明 |
|------|----------|------|
| 风场选择 | ① 点击风场下拉框 → ② 在组织树中选择目标风场 | 支持关键字搜索过滤；仅可选择有权限的风场节点 |
| 时间 | ① 点击日期选择器 → ② 选择分析日期 | 默认昨日；变更后自动触发全页数据刷新 |

**触发刷新规则：** 风场或日期任一条件变更后，系统自动重新请求数据，无需手动点击查询按钮。

**从驾驶舱跳转时：** 风场编码与分析日期已由系统自动回填，页面加载完成后直接展示对应风场数据。

### 4.3 全场健康度面板

面板标题为 **「全场健康度」**，展示当前所选风场的综合健康评估结果。

| 区域 | 内容说明 |
|------|----------|
| 环形图中心数字 | **综合评分**，展示接口返回的原始评分数值（支持小数，如 88.44） |
| 环形图扇区 | 按优/良/中/差四个等级展示风机台数占比，颜色与等级对应 |
| 底部四格统计 | 分别显示 **优(台)、良(台)、中(台)、差(台)** 各等级的风机数量 |

**交互：** 鼠标悬停环形图扇区可查看该等级的台数及占比。

### 4.4 子系统健康度图表

面板标题为 **「子系统健康度」**，以柱状图形式展示风场层面的三项子系统评分：

| 子系统 | 说明 |
|--------|------|
| 结构健康 | 风场结构类设备健康综合评分 |
| 系统健康 | 风场系统类设备健康综合评分 |
| 部件健康 | 风场部件类设备健康综合评分 |

**交互：** 将鼠标悬停在对应柱体上，提示框显示该子系统的具体评分数值（按接口原值展示，不做取整）。

### 4.5 排行榜面板

排行榜面板包含两个独立榜单，均取自当前风场下全部风机的综合评分排名：

| 榜单名称 | 排序规则 | 展示内容 |
|----------|----------|----------|
| 设备运行健康榜 (Top 5) | 综合评分从高到低 | 评分最高的 5 台风机名称及评分 |
| 设备异常预警榜 (Top 5) | 综合评分从低到高 | 评分最低的 5 台风机名称及评分（低分机组以警示色标识） |

**说明：** 两个榜单均支持自动轮播滚动；当榜单条目超出可视区域时，列表会自动向上滚动切换显示。

### 4.6 风机列表

#### 4.6.1 列表工具栏

列表标题为 **「风机列表」**，右侧提供筛选与排序工具：

**筛选（按健康等级）：**

| 按钮 | 筛选范围 |
|------|----------|
| 全部 | 显示风场下所有风机（默认） |
| 优 (90,100) | 仅显示综合评分 ≥ 90 的风机 |
| 良 (70,90) | 仅显示综合评分在 [70, 90) 的风机 |
| 中 (50,70) | 仅显示综合评分在 [50, 70) 的风机 |
| 差 (0,50) | 仅显示综合评分在 (0, 50) 的风机 |

当前选中的筛选按钮以高亮边框标识。若筛选后无符合条件的风机，列表区域显示 **「暂无符合条件的风机」**。

**排序（按综合评分）：**

| 按钮 | 排序方式 |
|------|----------|
| 评分从高到低 | 综合评分降序（默认选中） |
| 评分从低到高 | 综合评分升序 |

#### 4.6.2 风机卡片说明

每张风机卡片包含以下信息：

| 信息项 | 说明 |
|--------|------|
| 风机名称 | 机组名称，过长时自动截断显示 |
| 型号 | 风机型号代码 |
| 运行状态标签 | 根据健康等级显示：运行优 / 运行良 / 运行中 / 故障中 |
| 综合评分 | 大号数字展示接口原值（支持小数，不做四舍五入），颜色随健康等级变化 |
| 结构健康 | 接口原值百分比 + 彩色进度条（支持小数） |
| 系统健康 | 接口原值百分比 + 彩色进度条（支持小数） |
| 部件健康 | 接口原值百分比 + 彩色进度条（支持小数） |

进度条颜色规则：优/良为绿色或蓝色，中为黄色，差为红色并带光晕效果。

#### 4.6.3 查看机组诊断详情

| 步骤 | 操作 |
|------|------|
| 1 | 在风机列表中找到目标机组卡片 |
| 2 | 点击卡片底部 **「查看诊断详情 →」** 链接 |
| 3 | 页面右侧滑出 **机组详情抽屉** |

**抽屉内容说明：**

| 区块 | 内容 | 操作 |
|------|------|------|
| 综合健康评分仪表盘 | 半圆形仪表盘展示该风机综合评分 | 只读展示 |
| 综合健康评分趋势图 | 该风机综合评分的历史变化折线图 | 可切换 **近 7 天 / 近 30 天 / 近 1 年** |
| 结构健康明细 | 叶轮、塔筒分项评分、等级标签 | 只读展示；无评分项显示「/」 |
| 系统健康明细 | 偏航、变桨、液压、主控系统分项 | 同上 |
| 部件健康明细 | 发电机、齿轮箱、主轴、变流器分项 | 同上 |
| 结构健康趋势图 | 叶轮、塔筒评分历史趋势 | 可切换 7/30/365 天 |
| 系统健康趋势图 | 四大系统评分历史趋势 | 可切换 7/30/365 天 |
| 部件健康趋势图 | 四大部件评分历史趋势 | 可切换 7/30/365 天 |

**关闭抽屉：** 点击抽屉右上角 **×** 关闭按钮，或点击抽屉外侧遮罩层。

**补充说明：** 分项名称旁出现 **问号图标** 时，表示该分项未达到评估标准，悬停可查看提示「未达到评估标准」。

---

## 5. 尾流分析模块操作说明

**入口路径：** 左侧菜单 → **尾流分析（风资源尾流）**。

### 5.1 页面整体布局

尾流分析页面自上而下分为：

| 区域 | 内容 |
|------|------|
| 顶部筛选栏 | 风场选择、分析日期 |
| Tab 切换栏 | 「资源概览」/「尾流情况」两个 Tab |
| 内容展示区 | 根据当前 Tab 展示对应图表与表格 |

### 5.2 查询条件设置

| 控件 | 操作步骤 | 说明 |
|------|----------|------|
| 风场 | ① 点击风场下拉框 → ② 在组织树中选择风场 | 支持关键字搜索；选择后自动加载该风场数据 |
| 时间 | ① 点击日期选择器 → ② 选择分析日期 | 默认昨日；变更后自动刷新当前 Tab 内容 |

**说明：** 须先选择风场，页面才会发起数据请求；未选择风场时内容区为空。

### 5.3 Tab 切换

| Tab 名称 | 功能概述 |
|----------|----------|
| 资源概览 | 展示风场内各机组的风速概率分布及风向玫瑰图 |
| 尾流情况 | 展示尾流速度亏损分布、置信度散点图、柱状对比及明细表 |

点击 Tab 按钮即可切换，当前选中的 Tab 以高亮样式标识。切换后系统自动渲染对应图表。

### 5.4 资源概览 Tab

#### 5.4.1 各机组风速分布

| 项目 | 说明 |
|------|------|
| 图表类型 | 多曲线概率密度图 |
| 图表含义 | 对比展示风场内各机组的风速概率密度分布 |
| 交互 | 鼠标悬停曲线可查看对应 **风速（m/s）** 及 **概率密度** 数值 |
| 无数据 | 显示「暂无风速分布数据」提示文字 |

#### 5.4.2 风向玫瑰图

| 项目 | 说明 |
|------|------|
| 布局 | 按机组分格网格排列，每格带边框；**机组编号显示在玫瑰图下方** |
| 图表含义 | 展示各机组不同风向、风速段的出现频率（N 为正北方向） |
| 图例 | 图表底部以色块标注各风速段及其对应颜色 |
| 无数据 | 显示「暂无风向玫瑰图数据」提示文字 |

### 5.5 尾流情况 Tab

#### 5.5.1 速度与损失分布

页面顶部标题为 **「速度与损失分布」**，左右并排两张图表：

| 图表位置 | 内容 | 交互 |
|----------|------|------|
| 左侧 | 尾流速度亏损分布图 | 若为图片形式，点击可 **放大预览** |
| 右侧 | 尾流损失置信度散点图 | 鼠标悬停散点可查看速度损耗及置信度数值 |

#### 5.5.2 尾流影响评估

标题为 **「尾流影响评估」**，包含柱状图与明细表：

**柱状图：**

- 两张柱状图采用 **上下单列** 布局（先尾流速度亏损，后附加湍流强度）；
- 鼠标悬停柱体可查看具体数值；发电量相关提示以百分比形式展示。

**明细表工具栏：**

| 控件 | 说明 |
|------|------|
| 筛选 | 可按「全部 / 受尾流影响 / 不受尾流影响」过滤表格行 |

**明细表字段说明：**

| 列名 | 说明 |
|------|------|
| 风机名称 | 机组标识名称；列标题旁有排序按钮 |
| 是否受尾流影响 | 「是」或「否」，以颜色区分 |
| 附加湍流强度 | 数值，按阈值高低以不同颜色显示；列标题旁有排序按钮 |
| 尾流速度损耗（m/s） | 尾流引起的速度损失值；列标题旁有排序按钮 |
| 置信度 | 分析结果可信程度（接口原值展示）；列标题旁有排序按钮 |
| 尾流速度亏损分布图 | 缩略图，**点击可放大预览**完整分布图 |

**表头排序：**

- 点击 **风机名称、附加湍流强度、尾流速度损耗（m/s）、置信度** 列标题旁的排序图标可切换升序/降序；
- 风机名称按 **自然排序**（如 04、09、12、13 的顺序），非简单字符串排序；
- 当前排序列图标高亮，再次点击同一列可在升序与降序间切换。

**分页：** 表格底部提供首页/上一页/下一页/末页及每页条数选择，可浏览全部机组。

---

## 6. 功能测试验收要点（健康评估）

| 编号 | 测试项 | 操作步骤 | 预期结果 |
|------|--------|----------|----------|
| H-01 | 驾驶舱风场选择 | 左侧面板分别选择公司级、风场级节点 | 地图标记正确更新；健康 Tab 数据同步刷新 |
| H-02 | 驾驶舱日期切换 | 修改日期选择器 | 健康 Tab 饼图与表格按新日期刷新 |
| H-03 | 面板显示开关 | 切换显示/隐藏 | 右侧面板正确展开或收起，地图区域相应调整 |
| H-04 | 健康 Tab 跳转 | 点击表格风场名称 | 跳转健康评估页，风场与日期正确回填 |
| H-05 | 左侧菜单进入 | 点击左侧菜单「健康评估」 | 正常进入健康评估页面 |
| H-06 | 健康评估查询 | 切换风场和日期 | 全场健康度、子系统图、排行榜、风机列表同步刷新 |
| H-07 | 等级筛选 | 依次点击优/良/中/差 | 风机列表仅显示对应等级机组；无匹配时显示空状态 |
| H-08 | 评分排序 | 切换高到低 / 低到高 | 列表按综合评分正确排序 |
| H-09 | 机组详情抽屉 | 点击「查看诊断详情」 | 抽屉展示评分、分项明细及趋势图 |
| H-10 | 趋势图时间范围 | 在抽屉中切换 7/30/365 天 | 各趋势折线图数据与坐标轴正确更新 |
| H-11 | 尾流菜单进入 | 点击左侧菜单「尾流分析（风资源尾流）」 | 正常进入尾流分析页面 |
| H-12 | 尾流风场查询 | 选择风场与日期 | 资源概览与尾流情况数据正确加载 |
| H-13 | 尾流 Tab 切换 | 切换资源概览 / 尾流情况 | 对应图表与表格正常渲染 |
| H-14 | 尾流图片预览 | 点击分布图缩略图 | 弹出大图预览 |
| H-15 | 尾流表格筛选 | 切换「受尾流影响/不受尾流影响」 | 表格仅显示符合条件机组 |
| H-16 | 尾流表头排序 | 点击风机名称等列排序按钮 | 数据按升序/降序正确排列；风机名称自然排序 |
| H-17 | 尾流玫瑰图布局 | 查看资源概览风向玫瑰图 | 机组编号在图下方，单元格有边框 |
| H-18 | 无数据场景 | 选择无数据风场或日期 | 页面展示空状态提示，无报错 |

---

## 7. 常见问题

| 问题 | 可能原因 | 处理建议 |
|------|----------|----------|
| 页面显示「暂无数据」 | 风场未选择、日期无分析结果或权限不足 | 确认风场已选择、日期有效，或联系管理员核对后台数据 |
| 从驾驶舱跳转后风场未回填 | 驾驶舱仅选择了公司层级而未选到具体风场 | 在驾驶舱左侧组织树中选择具体风场后再点击表格跳转 |
| 图表未显示或布局错乱 | 浏览器窗口尺寸变化后图表未重绘 | 刷新页面，或调整浏览器窗口大小触发图表自适应 |
| 机组详情某项显示「/」 | 该分项未达到评估标准或无有效评分 | 属正常状态，悬停问号图标可查看说明 |
| 筛选后列表为空 | 当前风场下无对应健康等级的风机 | 切换筛选条件为「全部」查看完整列表 |
| 尾流页面无内容 | 未选择风场 | 先在顶部筛选栏选择风场 |
| 尾流表格排序结果异常 | 误按其他列排序 | 点击风机名称列排序按钮，确认升序/降序图标状态 |

---

*文档结束*