生产管理系统前端 - 瓦力提交代码&文档更新

src/components/irrigation/PARAMETER_CONFIGURATION_GUIDE.md

@@ -0,0 +1,458 @@
+# 水肥机参数配置功能使用指南
+
+## 📋 功能概述
+
+水肥机参数配置功能用于对水肥机各项运行参数（如压力范围、流量阈值、EC/PH标定值）进行系统内配置，实现设备参数标准化管理。
+
+## 🎯 核心功能
+
+### 1. 参数定义与管理
+- **参数类型**：支持10种参数类型（压力、流量、EC值、PH值、温度、湿度、转速、功率、液位、浓度）
+- **完整配置**：编号、名称、类型、单位、描述等基本信息
+- **设备关联**：关联所属水肥机设备
+- **启用控制**：支持参数的启用/禁用切换
+
+### 2. 量程设置
+- **最小值/最大值**：定义参数的有效测量范围
+- **默认值**：设置参数的默认初始值
+- **智能验证**：自动验证数值范围的合理性
+
+### 3. 阈值管理 ⭐核心功能
+- **预警阈值**：设置预警提示的触发值
+- **报警阈值**：设置报警的触发值
+- **分级监测**：支持两级阈值监测机制
+- **异常检测**：用于实时监测和告警
+
+### 4. 精度配置
+- **测量精度**：记录传感器的测量精度（如±0.1 bar）
+- **分辨率**：记录参数的最小分辨率（如0.01 bar）
+- **技术参数**：为部件配置提供准确的技术指标
+
+### 5. 校准管理
+- **校准周期**：设置定期校准的天数间隔
+- **最后校准日期**：记录上次校准的日期
+- **校准提醒**：自动计算并提醒需要校准的参数
+
+### 6. 完整CRUD操作
+- **新增参数**：录入新的参数配置
+- **编辑参数**：修改现有参数配置
+- **查看详情**：查看参数完整信息
+- **删除参数**：删除不再使用的参数（带确认）
+- **批量管理**：支持导入导出
+
+## 📍 访问路径
+
+**导航路径**：水肥机管理 → 水肥机管理 → 水肥机参数配置  
+**URL路径**：`/irrigation/wf-management/parameter`
+
+## 🔧 参数类型说明
+
+### 1. 压力参数
+- **用途**：监测系统管道压力
+- **常用单位**：bar、MPa、kPa
+- **典型范围**：0-10 bar
+- **应用场景**：主管道压力、支管道压力、泵体压力
+- **关键阈值**：
+  - 预警：8 bar（接近最大工作压力）
+  - 报警：9.5 bar（即将超压）
+
+### 2. 流量参数
+- **用途**：监测液体流量
+- **常用单位**：L/min、L/h、m³/h
+- **典型范围**：0-50 L/min
+- **应用场景**：灌溉流量、施肥流量、混合流量
+- **关键阈值**：
+  - 预警：45 L/min（接近最大流量）
+  - 报警：48 L/min（流量异常）
+
+### 3. EC值参数
+- **用途**：监测营养液电导率
+- **常用单位**：mS/cm、dS/m、μS/cm
+- **典型范围**：0-5 mS/cm
+- **应用场景**：营养液浓度控制、肥料配比监测
+- **关键阈值**：
+  - 预警：4.5 mS/cm（浓度偏高）
+  - 报警：4.8 mS/cm（浓度过高）
+- **特殊要求**：每月需要标定校准
+
+### 4. PH值参数
+- **用途**：监测溶液酸碱度
+- **常用单位**：pH
+- **典型范围**：0-14 pH
+- **应用场景**：营养液酸碱度控制
+- **正常范围**：5.5-7.5 pH
+- **关键阈值**：
+  - 预警：8.0 pH（偏碱性）
+  - 报警：8.5 pH（碱性过高）
+- **特殊要求**：每月需要标定校准
+
+### 5. 温度参数
+- **用途**：监测水温或环境温度
+- **常用单位**：℃、℉、K
+- **典型范围**：0-50 ℃
+- **应用场景**：灌溉水温、环境温度
+- **关键阈值**：
+  - 预警：35℃（温度偏高）
+  - 报警：40℃（温度过高）
+
+### 6. 湿度参数
+- **用途**：监测环境相对湿度
+- **常用单位**：%RH
+- **典型范围**：0-100 %RH
+- **应用场景**：环境湿度监测
+- **关键阈值**：
+  - 预警：90%（湿度偏高）
+  - 报警：95%（湿度过高）
+
+### 7. 转速参数
+- **用途**：监测电机或泵体转速
+- **常用单位**：RPM、r/min
+- **典型范围**：0-3000 RPM
+- **应用场景**：水泵转速、搅拌器转速
+- **关键阈值**：
+  - 预警：2800 RPM（接近最高转速）
+  - 报警：2950 RPM（转速过高）
+
+### 8. 功率参数
+- **用途**：监测电机运行功率
+- **常用单位**：kW、W、HP
+- **典型范围**：0-10 kW
+- **应用场景**：电机功率监测、能耗分析
+- **关键阈值**：
+  - 预警：8 kW（功率偏高）
+  - 报警：9.5 kW（功率过载）
+
+### 9. 液位参数
+- **用途**：监测液体储罐液位
+- **常用单位**：%、m、cm
+- **典型范围**：0-100 %
+- **应用场景**：肥料罐液位、水箱液位
+- **关键阈值**：
+  - 预警：20%（液位偏低，需要补充）
+  - 报警：10%（液位过低，即将耗尽）
+
+### 10. 浓度参数
+- **用途**：监测溶液浓度
+- **常用单位**：g/L、%、ppm
+- **典型范围**：0-100 g/L
+- **应用场景**：肥料溶液浓度监测
+- **关键阈值**：
+  - 预警：80 g/L（浓度偏高）
+  - 报警：95 g/L（浓度过高）
+
+## 📊 操作指南
+
+### 新增参数流程
+
+1. **点击"新增参数"按钮**
+
+2. **填写基本信息**（必填项）：
+   - 参数编号（自动生成，格式：PARAM-YYYY-NNN）
+   - 参数名称（如：系统压力）
+   - 参数类型（从10种类型中选择）
+   - 测量单位（如：bar、L/min、mS/cm）
+
+3. **设置量程范围**（必填项）：
+   - 最小值（如：0）
+   - 最大值（如：10）
+   - 默认值（如：2.5）
+   
+   💡 系统会自动验证：
+   - 最小值 < 最大值
+   - 默认值在最小值和最大值之间
+
+4. **配置阈值**（必填项）：
+   - 预警阈值（如：8）- 超过此值时发出预警提示
+   - 报警阈值（如：9.5）- 超过此值时发出报警
+   
+   💡 建议：
+   - 预警阈值 < 报警阈值
+   - 预警阈值约为最大值的80%
+   - 报警阈值约为最大值的95%
+
+5. **填写精度信息**（可选）：
+   - 测量精度（如：±0.1 bar）
+   - 分辨率（如：0.01 bar）
+
+6. **关联设备**（可选）：
+   - 所属设备名称
+   - 设备编号
+
+7. **设置校准周期**（可选）：
+   - 校准周期（天数，如：90）
+   - 最后校准日期
+   
+   💡 建议校准周期：
+   - EC/PH传感器：30天
+   - 压力/流量传感器：90天
+   - 温度传感器：365天
+
+8. **填写参数描述**（必填项）：
+   - 描述参数的用途和说明
+
+9. **填写备注**（可选）
+
+10. **设置启用状态**：
+    - 默认启用
+    - 可取消勾选设为禁用
+
+11. **点击"保存"完成**
+
+### 编辑参数流程
+
+1. 在参数列表找到目标参数
+2. 点击操作列的"编辑"按钮
+3. 修改需要更新的字段
+4. 点击"保存"完成（会自动更新"更新时间"）
+
+### 查看详情流程
+
+1. 在参数列表找到目标参数
+2. 点击操作列的"查看"按钮
+3. 查看参数完整信息：
+   - 基本信息
+   - 量程设置
+   - 阈值设置
+   - 精度信息
+   - 设备关联
+   - 校准管理
+   - 参数描述
+   - 备注说明
+   - 状态和时间信息
+4. 可直接点击"编辑"按钮进行修改
+
+### 删除参数流程
+
+1. 在参数列表找到目标参数
+2. 点击操作列的"删除"按钮（红色）
+3. 在确认对话框中核对参数信息
+4. 注意提示：删除后关联此参数的部件配置可能受到影响
+5. 点击"确认删除"完成
+
+### 启用/禁用参数
+
+1. 在参数列表找到目标参数
+2. 点击"状态"列的开关按钮
+3. 即时切换启用/禁用状态
+4. 显示操作成功提示
+
+## 📈 数据示例
+
+### 示例1：系统压力参数
+
+```
+基本信息：
+- 参数编号：PARAM-2024-001
+- 参数名称：系统压力
+- 参数类型：压力
+- 测量单位：bar
+
+量程设置：
+- 最小值：0 bar
+- 最大值：10 bar
+- 默认值：2.5 bar
+
+阈值设置：
+- 预警阈值：8 bar（80%最大值）
+- 报警阈值：9.5 bar（95%最大值）
+
+精度信息：
+- 测量精度：±0.1 bar
+- 分辨率：0.01 bar
+
+设备关联：
+- 所属设备：1号大棚水肥一体机
+- 设备编号：WF-2024-001
+
+校准管理：
+- 校准周期：180天
+- 最后校准日期：2024-09-15
+
+参数描述：系统主管道压力监测，正常工作范围2-6bar
+
+启用状态：已启用
+创建时间：2024-03-15
+```
+
+### 示例2：溶液EC值参数
+
+```
+基本信息：
+- 参数编号：PARAM-2024-003
+- 参数名称：溶液EC值
+- 参数类型：EC值
+- 测量单位：mS/cm
+
+量程设置：
+- 最小值：0 mS/cm
+- 最大值：5 mS/cm
+- 默认值：2.0 mS/cm
+
+阈值设置：
+- 预警阈值：4.5 mS/cm
+- 报警阈值：4.8 mS/cm
+
+精度信息：
+- 测量精度：±0.01 mS/cm
+- 分辨率：0.001 mS/cm
+
+设备关联：
+- 所属设备：1号大棚水肥一体机
+- 设备编号：WF-2024-001
+
+校准管理：
+- 校准周期：30天
+- 最后校准日期：2024-10-01
+
+参数描述：营养液电导率监测，用于控制肥料浓度
+
+备注：每月需要标定
+
+启用状态：已启用
+创建时间：2024-03-15
+```
+
+## 🔍 搜索与筛选技巧
+
+### 关键词搜索
+- 搜索"压力" - 显示所有包含"压力"的参数
+- 搜索"PARAM-001" - 显示编号为PARAM-001的参数
+- 搜索"EC" - 显示所有与EC相关的参数
+- 搜索"监测" - 搜索描述中包含"监测"的参数
+
+### 类型筛选
+- 选择"压力" - 显示所有压力类型的参数
+- 选择"流量" - 显示所有流量类型的参数
+- 选择"EC值" - 显示所有EC值类型的参数
+
+### 状态筛选
+- 选择"已启用" - 显示所有已启用的参数
+- 选择"已禁用" - 显示所有已禁用的参数
+
+### 设备筛选
+- 选择设备 - 显示该设备关联的所有参数
+
+### 组合筛选
+- 类型=压力 + 状态=已启用 - 显示所有已启用的压力参数
+- 类型=EC值 + 设备=WF-2024-001 - 显示1号设备的EC参数
+
+## ⚠️ 注意事项
+
+1. **参数编号唯一性**：每个参数编号必须唯一，编辑时不可修改
+2. **必填项验证**：保存前确保填写所有必填项
+3. **数值范围合理性**：
+   - 最小值必须小于最大值
+   - 默认值必须在最小值和最大值之间
+   - 阈值设置应合理，避免频繁误报
+4. **删除影响**：删除参数可能影响关联的部件配置，请谨慎操作
+5. **校准周期**：根据参数类型设置合适的校准周期
+6. **精度重要性**：精度信息影响部件配置的准确性
+7. **阈值设置**：阈值用于实时监测和告警，应根据实际情况设置
+
+## 💡 最佳实践
+
+### 1. 参数命名规范
+```
+建议格式：[监测对象]+[参数类型]
+示例：系统压力、灌溉流量、溶液EC值、溶液PH值
+```
+
+### 2. 编号规范
+```
+格式：PARAM-[年份]-[流水号]
+示例：PARAM-2024-001、PARAM-2024-002
+```
+
+### 3. 量程设置原则
+- 最小值通常为0
+- 最大值根据传感器量程或实际需求设置
+- 默认值设置为正常工作中位值
+
+### 4. 阈值设置建议
+- **预警阈值**：约为最大值的70-80%
+- **报警阈值**：约为最大值的90-95%
+- **压力参数**：
+  - 预警：80%最大工作压力
+  - 报警：95%最大工作压力
+- **流量参数**：
+  - 预警：90%最大流量
+  - 报警：96%最大流量
+- **EC/PH参数**：
+  - 预警：超出正常范围的边界值
+  - 报警：严重偏离正常范围
+- **液位参数**（低位报警）：
+  - 预警：20%（需要补充）
+  - 报警：10%（即将耗尽）
+
+### 5. 校准周期建议
+- **高精度传感器**（EC、PH）：30天
+- **压力、流量传感器**：90天
+- **温度传感器**：180-365天
+- **液位传感器**：90天
+
+### 6. 参数启用管理
+- **已启用**：用于实时监测和告警
+- **已禁用**：暂不使用或传感器故障时禁用
+- 定期检查禁用参数，及时处理问题后重新启用
+
+## 📊 功能特点
+
+1. **标准化管理**：统一的参数配置标准
+2. **全面配置**：包含量程、阈值、精度、校准等完整信息
+3. **智能验证**：自动验证数值合理性
+4. **灵活启用**：支持参数的启用/禁用控制
+5. **校准提醒**：自动提醒需要校准的参数
+6. **设备关联**：关联具体设备，便于管理
+7. **可视化展示**：类型图标、颜色标识，直观清晰
+
+## 🔗 与其他功能的关系
+
+### 参数配置 ← 部件配置
+- 部件配置时从参数配置中选择关联参数
+- 参数的量程、精度、单位等信息应用于部件
+
+### 参数配置 → 监测告警
+- 参数的阈值用于实时监测
+- 超过预警/报警阈值时触发告警
+
+### 参数配置 → 设备映射
+- 参数与物理设备的数据点映射
+- 用于实际数据采集
+
+## 📊 统计分析
+
+### 实时统计
+- 参数总数
+- 已启用数量
+- 已禁用数量
+- 待校准数量（提前7天提醒）
+
+### 类型分布
+- 压力参数数量
+- 流量参数数量
+- EC参数数量
+- PH参数数量
+- 温度参数数量
+- 其他参数数量
+
+## 🔄 数据导入导出
+
+### 导出功能
+- 点击"导出配置"按钮
+- 导出当前所有参数配置信息
+- 支持Excel格式
+
+### 导入功能
+- 点击"导入配置"按钮
+- 选择符合模板格式的配置文件
+- 批量导入参数配置
+
+## 📞 技术支持
+
+如有问题，请查阅相关文档或联系技术支持团队。
+
+---
+
+**版本**：v1.0.0  
+**更新日期**：2024-10-23  
+**所属系统**：智慧农业生产管理系统 - 水肥机管理子系统