# 风机数据管理平台 — 台账管理系统操作说明

| 项目 | 说明 |
|------|------|
| 文档版本 | V1.0 |
| 适用系统 | 台账管理子系统 |
| 适用对象 | 运维人员、业务用户、测试人员、台账维护人员 |
| 文档用途 | 项目交付、软件著作权申报、功能测试报告 |

---

## 1. 系统概述

台账管理子系统用于维护平台基础主数据，包括 **企业组织、风场、风机、机型及部件** 等台账信息。系统以列表查询、表单新增/编辑、启用停用、导入上传等操作为主，为健康评估、异常检测、性能分析等业务模块提供基础数据支撑。

**主要功能模块：**

| 序号 | 模块名称 | 功能说明 |
|------|----------|----------|
| 1 | 企业信息 | 维护企业/单位组织树，管理启用状态及下属风场查看 |
| 2 | 风场信息 | 维护风场基础属性、关联公司与测风塔，支持导入、文件上传及批量改风机 |
| 3 | 风机信息 | 维护风机台账，支持按风场导入、新增编辑及启停 |
| 4 | 机型信息 | 维护收资机型型号及技术参数，可跳转录入部件信息 |
| 5 | 维护部件 | 维护部件字典、部件属性配置及品牌/型号参数 |

**菜单入口：** 登录后，在左侧菜单展开 **「台账管理」**，点击对应子菜单进入。

| 子菜单 | 说明 |
|--------|------|
| 企业信息 | 企业/单位组织台账 |
| 风场信息 | 风场台账 |
| 风机信息 | 风机台账 |
| 机型信息 | 机型台账 |
| 维护部件 | 部件字典与品牌维护（菜单正式名称为「维护部件」） |

**说明：** 台账管理下另有「测风塔信息」「部件信息」等菜单；「部件信息」亦可从机型信息操作列进入，用于按机型录入主轴/齿轮箱/发电机等部件参数。本文重点说明上述五个常用功能。

**共性业务规则：**

| 规则 | 说明 |
|------|------|
| 启用中不可删除 | 处于「启用」状态的记录不可删除，需先停用后再删 |
| 删除确认 | 删除前弹出确认框，确认后执行永久删除 |
| 状态切换 | 列表操作列提供「启用 / 停用」，切换后即时生效 |

---

## 2. 登录与进入系统

### 2.1 系统登录

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

### 2.2 进入台账管理模块

| 步骤 | 操作 |
|------|------|
| 1 | 登录后，在 **左侧菜单** 中展开 **「台账管理」** |
| 2 | 点击目标子菜单（如「企业信息」「风场信息」等） |
| 3 | 右侧主区域打开对应台账页面 |

---

## 3. 企业信息操作说明

**入口路径：** 左侧菜单 → 台账管理 → **企业信息**。

### 3.1 界面布局

| 区域 | 内容 |
|------|------|
| 筛选栏 | 单位名称、状态（启用 / 停用）、「查询」「重置」 |
| 工具栏 | 「新增」「展开 / 收起」（树形表格展开或收起） |
| 列表区 | 树形表格，展示单位层级关系 |

**列表字段：**

| 列名 | 说明 |
|------|------|
| 单位名称 | 企业/单位名称 |
| 单位ID | 单位编码（companyCode） |
| 风场数量 | 下属风场数量；点击数字可查看风场清单 |
| 状态 | 启用 / 停用 |
| 创建时间 | 记录创建时间 |
| 操作 | 编辑、新增子单位、启用/停用、删除 |

### 3.2 查询与重置

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 输入单位名称（可选） | 按名称过滤 |
| 2 | 选择状态（可选） | 启用或停用 |
| 3 | 点击「查询」 | 刷新树表 |
| 4 | 点击「重置」 | 清空条件并重新加载 |

### 3.3 新增单位 / 新增子单位

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 点击工具栏「新增」 | 新增一级单位；或点击行内「新增子单位」挂到当前节点下 |
| 2 | 填写表单 | 见下表必填项 |
| 3 | 点击确定 | 保存成功后关闭弹窗并刷新列表 |

**表单字段：**

| 字段 | 是否必填 | 说明 |
|------|----------|------|
| 单位名称 | 是 | 请填写单位名称 |
| 所属省 | 是 | 下拉选择 |
| 所属市 | 是 | 随省联动选择 |
| 备注 | 否 | 补充说明 |

### 3.4 编辑、启停与删除

| 操作 | 说明 |
|------|------|
| 编辑 | 打开「编辑」弹窗，回显后修改并保存 |
| 启用 / 停用 | 切换单位状态，成功提示「状态已更新成功」 |
| 删除 | 启用中不可删；停用后确认删除 |

### 3.5 查看下属风场

| 步骤 | 操作 |
|------|------|
| 1 | 在列表中点击目标单位的 **风场数量** |
| 2 | 弹出「风场数量」窗口，展示下属风场清单 |

**弹窗字段：** 风场名称、所在省、所在市、海拔高度/米、经度、纬度、额定容量/kW。

---

## 4. 风场信息操作说明

**入口路径：** 左侧菜单 → 台账管理 → **风场信息**。

### 4.1 界面布局

| 区域 | 内容 |
|------|------|
| 筛选栏 | 风场名称、选择日期（区间）、所属公司、所在省、「查询」「重置」 |
| 工具栏 | 「导入」「新增」 |
| 列表区 | 分页表格 |

**列表字段：**

| 列名 | 说明 |
|------|------|
| 风场名称 | 点击可打开「风场信息」详情 |
| 所属公司 | 关联企业 |
| 风机数量 | 点击可查看该风场风机列表 |
| 测风塔 | 点击可查看关联测风塔信息 |
| 合同功率曲线数 | 点击可查看已上传合同功率曲线，支持删除/下载 |
| 所在省/市、创建时间、状态 | 基础属性 |
| 操作 | 编辑、上传、启用/停用、批量更改、删除 |

### 4.2 查询与重置

| 步骤 | 操作 |
|------|------|
| 1 | 按需填写风场名称、日期区间、所属公司、所在省 |
| 2 | 点击「查询」刷新列表；点击「重置」清空条件 |

### 4.3 导入风场

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 点击「导入」 | 打开「导入文件」弹窗 |
| 2 | 按提示下载导入模板 | 按模板填写数据 |
| 3 | 选择所属公司 | 组织树选择，必填 |
| 4 | 上传 xlsx 文件 | 仅支持 xlsx，且不超过 5MB |
| 5 | 点击提交 | 未选公司或未上传附件时系统给出警告 |

### 4.4 新增 / 编辑风场

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 点击「新增」或行内「编辑」 | 打开宽表单弹窗 |
| 2 | 填写必填字段 | 见下表 |
| 3 | （可选）点击「创建机型」 | 新窗口打开机型信息页，便于补录机型 |
| 4 | 确定保存 | 编辑时可管理已上传附件（删除） |

**主要表单字段：**

| 字段 | 是否必填 | 说明 |
|------|----------|------|
| 风场名称 | 是 | |
| 空气密度 kg/m³ | 是 | 数字 |
| 所属公司 | 是 | 树形选择 |
| 海拔高度/米 | 是 | 数字 |
| 所在省 / 所在市 | 是 | 省市联动 |
| 测风塔 | 否 | 多选关联 |
| 经纬度类型 | — | 十进制或度分秒 |
| 经度 / 纬度 | 是 | 数字 |

### 4.5 上传文件

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 点击行内「上传」 | 打开「上传文件」弹窗 |
| 2 | 选择文件类型 | **合同功率曲线** 或 **资源文件** |
| 3 | 按类型补充信息并上传 | 合同功率曲线可选机型，支持模板下载，xlsx ≤5MB；资源文件支持 jpg/png/pdf/docx ≤5MB |
| 4 | 提交 | 须先上传附件再提交 |

### 4.6 批量更改风机

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 点击行内「批量更改」 | 若该风场暂无风机，提示「暂无风机无法批量更改」 |
| 2 | 在列表中修改风机属性 | 可改风机名称、海拔高度、额定容量、经度、纬度等 |
| 3 | 提交 | 批量保存 |

### 4.7 详情与关联查看

| 入口 | 展示内容 |
|------|----------|
| 点击风场名称 | 风场基础信息、资源文件列表及「查看附件」 |
| 点击风机数量 | 风机名称、风场编号、机型、主机厂商、是否标杆、海拔、经纬度、额定容量等（带分页） |
| 点击测风塔 | 测风塔名称、编号、经纬度、高度（米） |
| 点击合同功率曲线数 | 机型名称、上传时间；支持删除、下载 |

### 4.8 启停与删除

与企业信息相同：启用中不可删除；可先停用再删除。

---

## 5. 风机信息操作说明

**入口路径：** 左侧菜单 → 台账管理 → **风机信息**。

### 5.1 界面布局

| 区域 | 内容 |
|------|------|
| 筛选栏 | 风机名称、选择日期、「查询」「重置」 |
| 工具栏 | 「导入」「新增」 |
| 列表区 | 分页表格 |

**列表字段：**

| 列名 | 说明 |
|------|------|
| 系统编号 | 点击打开「风机详情」 |
| 风机名称 | |
| 关联风场 | |
| 经度 / 纬度 | 无数据时显示「-」 |
| 海拔高度/米 | |
| 是否标杆 | 是 / 否 |
| 状态、创建时间 | |
| 操作 | 编辑、启用/停用、删除 |

### 5.2 查询、导入与新增编辑

| 操作 | 说明 |
|------|------|
| 查询 / 重置 | 按风机名称、日期筛选或清空条件 |
| 导入 | 选择所属风场 + 上传 xlsx（≤5MB），可按提示下载模板；未上传附件时提示先提交附件 |
| 新增 / 编辑 | 填写表单后保存；表单内可点「创建机型」新窗口打开机型页 |
| 删除 | 启用中不可删 |

**主要表单字段：**

| 字段 | 是否必填 | 说明 |
|------|----------|------|
| 风机名称 | 是 | |
| 关联风场 | 是 | 可搜索 |
| 机型编号 | 是 | 可搜索过滤 |
| 额定容量 | 是 | |
| 海拔高度、轮毂高度 | 是 | 数字 |
| 是否标杆 | 是 | 是 / 否 |
| 经纬度类型 | — | 十进制或度分秒 |
| 纬度、经度 | 是 | 数字 |

### 5.3 风机详情

点击系统编号后，查看关联风场、风机名称、机型编号、额定容量(kW)、海拔、经纬度、轮毂高度、是否标杆、状态等信息。

---

## 6. 机型信息操作说明

**入口路径：** 左侧菜单 → 台账管理 → **机型信息**。

### 6.1 界面布局

| 区域 | 内容 |
|------|------|
| 筛选栏 | 收资机型型号、选择日期、「查询」「重置」 |
| 工具栏 | 「新增」 |
| 列表区 | 分页表格 |

**列表字段：**

| 列名 | 说明 |
|------|------|
| 收资机型型号 | 点击打开「机型详情」 |
| 机型类型 | 双馈 / 直驱 / 半直驱 |
| 厂商名称、厂商编号 | |
| 状态、创建时间 | |
| 操作 | 编辑、启用/停用、部件信息、删除 |

**权限说明：** 操作列「部件信息」需具备 `home:ledger:modules` 权限；无权限时该按钮不可见。

### 6.2 新增 / 编辑机型

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 点击「新增」或行内「编辑」 | 标题分别为「新增机型」「编辑机型」 |
| 2 | 填写技术参数 | 见下表 |
| 3 | 确定保存 | |

**主要表单字段：**

| 字段 | 是否必填 | 说明 |
|------|----------|------|
| 收资机型型号 | 是 | 仅允许数字、字母及 `.` `/` `\` `-` |
| 厂商名称 | 是 | |
| 驱动方式 | 是 | 字典下拉 |
| 塔筒高度 | 是 | 数字 |
| 叶轮直径（风轮直径） | 是 | |
| 传动比-转速比 | 是 | |
| 叶片长度 | — | 可填写 |
| 额定/切入/切出风速 | — | 可填写 |
| 发电机/叶轮额定转速 | — | 可选数字 |

### 6.3 机型详情

点击收资机型型号，查看型号、厂商、驱动方式、状态、塔筒高度、叶片长度、叶轮直径、传动比、风速与转速等参数。

### 6.4 进入部件信息录入

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 在机型列表找到目标机型 | |
| 2 | 点击操作列 **「部件信息」** | 跳转部件信息页，并携带机型类型、机型编码 |
| 3 | 按区块填写主轴、齿轮箱、发电机等参数 | 直驱机型不展示齿轮箱、发电机等不适用区块 |
| 4 | 点击右侧 **「提交」** | 保存该机型部件配置 |

**部件信息页主要区块：**

| 区块 | 说明 |
|------|------|
| 主轴 | 润滑油品牌/型号，前/后轴承品牌/型号等 |
| 齿轮箱 | 润滑油、各轴轴承、行星轮/太阳轮结构与齿数等（直驱机型隐藏） |
| 发电机 | 润滑油、极对数、冷却方式、驱动端/非驱动端轴承等（直驱机型隐藏） |

亦可从左侧菜单 **台账管理 → 部件信息** 直接进入该页面（需具备对应菜单权限）。

---

## 7. 维护部件操作说明

**入口路径：** 左侧菜单 → 台账管理 → **维护部件**。

> 菜单正式名称为「维护部件」，用于维护部件字典、属性及品牌型号，与机型下的「部件信息」录入页不同。

### 7.1 界面布局

| 区域 | 内容 |
|------|------|
| 筛选栏 | 部件名称、「查询」 |
| 工具栏 | 「新增」 |
| 列表区 | 分页表格 |

**列表字段：**

| 列名 | 说明 |
|------|------|
| 部件模块 | |
| 部件名称 | |
| 部件类型 | 功能类型 |
| 部件编码 | |
| 创建时间、维护时间 | |
| 操作 | 按功能类型显示「部件配置」或「品牌维护」；删除 |

### 7.2 查询与新增部件

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 输入部件名称并查询 | 分页查询 |
| 2 | 点击「新增」 | 打开「新增部件」弹窗 |
| 3 | 选择部件模块、部件名称、功能类型 | 均来自字典；提交前须填写完整 |
| 4 | 确定 | 保存成功后刷新列表 |

### 7.3 部件配置（功能类型 = 属性配置类）

当部件功能类型为属性配置类时，操作列显示 **「部件配置」**：

| 步骤 | 操作 |
|------|------|
| 1 | 点击「部件配置」打开抽屉 |
| 2 | 点击「新增」录入属性名称并确定 |
| 3 | 在属性列表中可 **编辑** 或 **删除** |

### 7.4 品牌维护（功能类型 = 品牌维护类）

当部件功能类型为品牌维护类时，操作列显示 **「品牌维护」**：

| 步骤 | 操作 |
|------|------|
| 1 | 点击「品牌维护」打开抽屉 |
| 2 | 可按品牌、型号筛选并查询 |
| 3 | 点击「新增品牌」，填写品牌、型号后确定 |
| 4 | 行内可 **编辑**、**参数配置**、**删除** |

### 7.5 部件参数配置

在品牌维护抽屉中点击 **「参数配置」**，打开「部件参数配置」弹窗，录入轴承相关参数：

| 字段 | 说明 |
|------|------|
| 滚动体数量 | 数字/小数；部分字典类型下只读 |
| 滚动体直径/mm | 同上 |
| 节圆直径/mm | 同上 |
| 接触角° | 同上 |

删除品牌时确认提示：「确定删除该品牌吗?」。

### 7.6 删除部件

在主列表点击「删除」，确认框展示模块名、部件名，确认后删除。

---

## 8. 功能测试验收要点（台账管理）

| 编号 | 测试项 | 操作步骤 | 预期结果 |
|------|--------|----------|----------|
| L-01 | 菜单进入 | 依次点击企业/风场/风机/机型/维护部件 | 各页面正常打开 |
| L-02 | 企业查询重置 | 按单位名称、状态查询后重置 | 列表正确过滤并恢复 |
| L-03 | 企业树新增 | 新增一级单位与子单位 | 树结构正确，省市联动正常 |
| L-04 | 企业启停删除 | 启用状态删除；停用后再删 | 启用不可删；停用后可删 |
| L-05 | 企业风场数量 | 点击风场数量 | 弹窗展示下属风场清单 |
| L-06 | 风场导入 | 选公司并上传模板 xlsx | 导入成功或给出明确校验提示 |
| L-07 | 风场新增编辑 | 填写必填项保存 | 列表出现新记录或更新成功 |
| L-08 | 风场上传 | 分别上传合同功率曲线、资源文件 | 类型校验与大小限制生效 |
| L-09 | 风场批量更改 | 有风机时批量改属性；无风机时操作 | 有数据可提交；无风机提示无法更改 |
| L-10 | 风场关联查看 | 点击风机数量、测风塔、合同功率曲线数 | 对应弹窗数据正确 |
| L-11 | 风机导入 | 选风场并上传 xlsx | 导入成功或提示缺少附件 |
| L-12 | 风机新增编辑 | 填写必填项含是否标杆、经纬度 | 保存成功；详情可查看 |
| L-13 | 机型新增 | 按规则填写收资机型型号等 | 非法字符被拦截；合法保存成功 |
| L-14 | 机型部件入口 | 有权限点击「部件信息」 | 跳转部件页并带机型参数 |
| L-15 | 部件信息提交 | 填写主轴等区块后提交 | 保存成功；直驱隐藏不适用区块 |
| L-16 | 维护部件新增 | 选择模块/名称/功能类型 | 未填全时提示；填全后新增成功 |
| L-17 | 部件配置 | 对属性类部件新增属性 | 抽屉内增删改正常 |
| L-18 | 品牌维护与参数 | 新增品牌并配置轴承参数 | 参数保存成功；删除有确认提示 |
| L-19 | 无权限按钮 | 无部件信息权限账号打开机型页 | 「部件信息」按钮不可见 |

---

## 9. 常见问题

| 问题 | 可能原因 | 处理建议 |
|------|----------|----------|
| 无法删除某条记录 | 记录处于启用状态 | 先点击「停用」，再执行删除 |
| 风场/风机导入失败 | 未选所属公司或风场、附件为空、非 xlsx 或超过 5MB | 按弹窗提示补全条件，使用模板并控制文件大小 |
| 批量更改不可用 | 该风场下暂无风机 | 先在风机信息中新增或导入风机后再操作 |
| 看不到「部件信息」按钮 | 账号无 `home:ledger:modules` 权限 | 联系管理员开通权限 |
| 部件信息页部分区块不显示 | 直驱机型不展示齿轮箱/发电机等区块；或品牌选项未加载完成 | 确认机型驱动方式；稍后刷新重试 |
| 新增部件提示字段未填完 | 部件模块、部件名称、功能类型未全部选择 | 三项均需选择后再提交 |
| 省市下拉无市级选项 | 尚未选择省级 | 先选省，再选市 |
| 列表无数据 | 筛选条件过严或尚未录入台账 | 点击重置；或先完成新增/导入 |

---

*文档结束*