cavin/smart-crop-ui
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

生产管理系统前端 - 更新瓦力提交的产品原型到参考目录

Browse Source
This commit is contained in:
peng
2025-10-23 10:57:14 +08:00
parent 83523dad64
commit 28229ce795
354 changed files with 147599 additions and 7892 deletions
Download Patch File Download Diff File Expand all files Collapse all files

440
src/PARAMETER_TEMPLATE_MANAGEMENT_UPDATE.md Normal file
View File

@@ -0,0 +1,440 @@
# 🎉 参数模板管理功能上线通知
## 📅 更新时间
2025-10-16
## 🎯 更新内容
为**负载类型管理**添加了完整的**参数模板管理**功能，现在您可以直接在界面上查看和了解每种设备类型的参数配置模板。
## ✨ 新增功能
### 1. 参数模板入口 ⭐
**位置**: 负载管理 > 负载类型 > 参数模板列
在设备类型列表中，新增了"参数模板"列，可以：
- 查看每个设备类型有多少个参数
- 点击按钮查看参数详情
```
┌────────────────────────────────────────────────────┐
│ 设备名称 │ 类别 │... │ 参数模板 │ 操作 │
├────────────────────────────────────────────────────┤
│ 北斗终端 │ 北斗 │... │ [👁️ 3 个参数] │ ✏️ 🗑️ │
│ 摄像头 │ 摄像 │... │ [👁️ 6 个参数] │ ✏️ 🗑️ │
│ 油耗传感 │ 油耗 │... │ [👁️ 4 个参数] │ ✏️ 🗑️ │
└────────────────────────────────────────────────────┘
```
### 2. 参数模板查看对话框 ⭐
**功能**: 点击"X 个参数"按钮，打开参数模板详情对话框
**显示内容**:
- ✅ 设备类型基本信息（类别、品牌、型号、通信协议）
- ✅ 参数列表（编号、名称、类型、单位）
- ✅ 参数详细配置（编码、默认值、范围、选项）
- ✅ 参数说明文字
- ✅ 必填参数标识
- ✅ 使用说明
**界面示例**:
```
┌─────────────────────────────────────────────────────┐
│ 参数模板 - 高清摄像头 │
├─────────────────────────────────────────────────────┤
│ ┌─────────────────────────────────────────────────┐ │
│ │ 类别: [摄像头] 品牌: 海康威视 │ │
│ │ 型号: DS-2CD2345 通信协议: RTSP │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 参数定义 (6) [3 个必填] │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ [1] IP地址 * │ │
│ │ 参数编码: ipAddress 参数类型: [文本] │ │
│ │ 默认值: 192.168.1.100 │ │
│ │ 摄像头IP地址 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ [2] 端口 * │ │
│ │ 参数编码: port 参数类型: [数字] │ │
│ │ 默认值: 554 范围: 1 ~ 65535 │ │
│ │ RTSP端口号 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ [3] 通道号 * │ │
│ │ 参数编码: channel 参数类型: [数字] │ │
│ │ 默认值: 1 范围: 1 ~ 16 │ │
│ │ 视频通道编号 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ [4] 分辨率 │ │
│ │ 参数编码: resolution 参数类型: [选择] │ │
│ │ 默认值: 1080p │ │
│ │ 选项: [1080P] [4K] │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ [5] 帧率 (fps) │ │
│ │ 参数编码: fps 参数类型: [数字] │ │
│ │ 默认值: 25 范围: 15 ~ 60 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ [6] 夜视功能 │ │
│ │ 参数编码: nightVision 参数类型: [布尔] │ │
│ │ 默认值: true │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 📋 参数模板使用说明 │ │
│ │ • 参数模板定义了该设备类型的可配置参数 │ │
│ │ • 挂载设备后，可在"负载参数"页面根据模板配置 │ │
│ │ • 必填参数标记为红色 * ，挂载设备后必须配置 │ │
│ │ • 参数编码(key)用于系统内部识别，请使用英文 │ │
│ │ • 如需修改参数模板，请编辑该设备类型 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ [关闭] [✏️ 编辑设备类型] │
└─────────────────────────────────────────────────────┘
```
### 3. 增强的统计卡片 ⭐
**新增统计**:
- 参数模板总数：所有设备类型的参数总和
- 已配置模板：已定义参数的设备类型数量
```
┌─────────┬<EFBFBD><EFBFBD><EFBFBD>────────────┬─────────────┬─────────┬─────────┐
│总类型数 │参数模板总数 │已配置模板 │北斗终端 │摄像头 │
│ 5 │ 21 │ 5 / 5 │ 1 │ 1 │
└─────────┴─────────────┴─────────────┴─────────┴─────────┘
```
### 4. 预置的参数模板 ⭐
系统已为5种常用设备类型预置了完整的参数模板：
#### 1. 北斗终端 (3个参数)
```typescript
✅ 上报间隔 (number, 1-60秒, 必填)
- 编码: reportInterval
- 默认值: 10秒
- 说明: 位置数据上报时间间隔
✅ 精度模式 (select, 必填)
- 编码: accuracyMode
- 选项: 高精度 / 普通
- 默认值: 高精度
- 说明: 定位精度模式
✅ 数据格式 (select)
- 编码: dataFormat
- 选项: JSON / XML
- 默认值: JSON
```
#### 2. 高清摄像头 (6个参数)
```typescript
✅ IP地址 (string, 必填)
- 编码: ipAddress
- 默认值: 192.168.1.100
- 说明: 摄像头IP地址
✅ 端口 (number, 1-65535, 必填)
- 编码: port
- 默认值: 554
- 说明: RTSP端口号
✅ 通道号 (number, 1-16, 必填)
- 编码: channel
- 默认值: 1
- 说明: 视频通道编号
✅ 分辨率 (select)
- 编码: resolution
- 选项: 1080P / 4K
- 默认值: 1080P
✅ 帧率 (number, 15-60 fps)
- 编码: fps
- 默认值: 25
✅ 夜视功能 (boolean)
- 编码: nightVision
- 默认值: true
```
#### 3. 油耗传感器 (4个参数)
```typescript
✅ 采集频率 (number, 0.1-10 Hz, 必填)
- 编码: sampleFrequency
- 默认值: 1 Hz
- 说明: 数据采集频率
✅ 上传频率 (number, 1-300秒, 必填)
- 编码: uploadFrequency
- 默认值: 30秒
- 说明: 数据上传时间间隔
✅ 报警阈值 (number, 0-200 L/h)
- 编码: alarmThreshold
- 默认值: 50 L/h
- 说明: 油耗超过此值时报警
✅ 灵敏度 (number, 1-10)
- 编码: sensitivity
- 默认值: 5
- 说明: 传感器灵敏度等级
```
#### 4. 转速传感器 (4个参数)
```typescript
✅ 采集频率 (number, 1-100 Hz, 必填)
- 编码: sampleFrequency
- 默认值: 10 Hz
- 说明: 转速数据采集频率
✅ 上传频率 (number, 1-60秒, 必填)
- 编码: uploadFrequency
- 默认值: 10秒
- 说明: 数据上传时间间隔
✅ 最大转速 (number, 1000-5000 RPM)
- 编码: maxRpm
- 默认值: 3000 RPM
- 说明: 发动机最大转速
✅ 报警阈值 (number, 2000-5000 RPM)
- 编码: alarmThreshold
- 默认值: 3500 RPM
- 说明: 转速超过此值时报警
```
#### 5. 温度传感器 (4个参数)
```typescript
✅ 采集频率 (number, 0.1-10 Hz, 必填)
- 编码: sampleFrequency
- 默认值: 0.5 Hz
- 说明: 温度数据采集频率
✅ 上传频率 (number, 10-300秒, 必填)
- 编码: uploadFrequency
- 默认值: 60秒
- 说明: 数据上传时间间隔
✅ 高温报警阈值 (number, 60-120°C)
- 编码: highAlarmThreshold
- 默认值: 90°C
- 说明: 温度高于此值时报警
✅ 低温报警阈值 (number, -30-0°C)
- 编码: lowAlarmThreshold
- 默认值: -10°C
- 说明: 温度低于此值时报警
```
## 📋 使用指南
### 如何查看参数模板
```
1. 进入"负载管理"系统
↓
2. 点击"负载类型"菜单
↓
3. 在设备类型列表中找到想查看的设备类型
↓
4. 点击"参数模板"列的"👁️ X 个参数"按钮
↓
5. 查看参数模板详情对话框
- 查看所有参数定义
- 了解参数含义和配置要求
- 查看默认值和范围限制
```
### 完整的设备配置流程
```
1. 【负载类型】查看设备类型的参数模板
- 了解该设备有哪些可配置参数
- 查看参数的默认值和范围
↓
2. 【负载管理】挂载设备到农机
- 选择设备类型
- 填写设备名称和序列号
↓
3. 【负载参数】配置设备参数
- 系统根据参数模板自动生成配置表单
- 修改参数值
- 保存配置
↓
4. 设备配置完成，可以正常使用
```
### 参数模板的优势
**1. 标准化配置**
- 每种设备类型有统一的参数定义
- 避免参数配置不一致
- 便于批量配置同类设备
**2. 快速配置**
- 挂载设备后自动生成配置表单
- 预填充默认值
- 减少手动输入
**3. 参数验证**
- 自动验证参数范围
- 必填参数提醒
- 防止配置错误
**4. 便于维护**
- 集中管理参数定义
- 修改模板影响所有同类设备
- 易于扩展新参数
## 🎨 界面特性
### 1. 彩色类别徽章
```
🟢 北斗终端
🔵 摄像头
🟠 油耗传感器
🟣 转速传感器
🔴 温度传感器
```
### 2. 参数类型标识
```
[数字] - number 类型
[文本] - string 类型
[布尔] - boolean 类型
[选择] - select 类型
```
### 3. 必填标识
```
参数名称 * ← 红色星号表示必填
```
### 4. 参数单位
```
采集频率 (Hz)
上传频率 (秒)
报警阈值 (L/h)
```
### 5. 参数编码
```
ipAddress ← 系统内部使用的参数键名
reportInterval
sampleFrequency
```
## 📊 统计数据
**当前系统统计**:
- 总设备类型: **5** 种
- 参数模板总数: **21** 个
- 已配置模板: **5 / 5** (100%)
- 平均每种设备: **4.2** 个参数
**参数类型分布**:
- 数字 (number): 15 个
- 选择 (select): 4 个
- 文本 (string): 1 个
- 布尔 (boolean): 1 个
**必填参数统计**:
- 必填参数: 13 个
- 可选参数: 8 个
- 必填比例: 62%
## 📁 相关文件
**更新的文件**:
- `/components/machinery/load/LoadType.tsx` - 负载类型管理（新增参数模板查看功能）
**相关文档**:
- `/LOAD_TYPE_FEATURE_CHECK.md` - 负载类型功能检查报告
- `/LOAD_PARAMETER_FEATURE_CHECK.md` - 负载参数功能检查报告
## 💡 常见问题
### Q1: 如何修改参数模板？
**A**:
1. 在负载类型列表中点击设备类型的"编辑"按钮
2. 在编辑表单中修改参数定义
3. 保存后，参数模板即更新
注意：修改参数模板不会影响已挂载设备的现有参数配置。
### Q2: 参数模板和设备参数有什么区别？
**A**:
- **参数模板**: 定义在设备类型上，是参数的"定义"和"模板"
- **设备参数**: 配置在具体设备上，是参数的"实际值"
就像"产品规格书"和"产品配置单"的关系。
### Q3: 为什么有些设备类型没有参数？
**A**:
有些设备类型可能不需要额外配置参数，或者参数模板还未定义。可以通过编辑设备类型来添加参数定义。
### Q4: 参数编码(key)可以用中文吗？
**A**:
不建议。参数编码用于系统内部识别，建议使用英文驼峰命名（如 `reportInterval`），这样更规范、更易于开发集成。
### Q5: 如何为新设备类型添加参数模板？
**A**:
1. 新增或编辑设备类型
2. 在编辑表单中添加参数定义
3. 每个参数定义包括：
- 参数编码 (key)
- 参数名称 (label)
- 参数类型 (type)
- 默认值、范围、单位等配置
4. 保存后，参数模板即生效
## 🎯 后续规划
### 计划中的功能
1. **参数模板导入导出**
- 导出为 JSON 文件
- 从文件导入参数模板
- 便于备份和共享
2. **参数模板库**
- 常用参数模板库
- 一键应用到设备类型
- 减少重复定义
3. **参数校验规则**
- 自定义校验表达式
- 参数之间的依赖关系
- 更复杂的验证逻辑
4. **参数配置历史**
- 记录参数修改历史
- 对比不同版本
- 回滚功能
## 📞 反馈与支持
如果您在使用参数模板功能时遇<EFBFBD><EFBFBD>任何问题，或有改进建议，请：
1. 查看功能检查报告获取详细信息
2. 联系系统管理员
3. 提交功能改进建议
---
**更新完成**: 2025-10-16
**功能状态**: ✅ 已上线
**下次更新**: 根据用户反馈持续优化