refactor:将所有的ItemViewMdoel的名字删除ViewModel，并将命名空间调整为DMS.WPF.ItemViewModel.

2025-10-06 18:17:56 +08:00
parent 6cff70cd87
commit c85f89db33
72 changed files with 316 additions and 1023 deletions
--- a/DMS.WPF/ItemViewModel/VariableItem.cs
+++ b/DMS.WPF/ItemViewModel/VariableItem.cs
@@ -0,0 +1,286 @@
+using CommunityToolkit.Mvvm.ComponentModel;
+using DMS.Application.DTOs;
+using DMS.Core.Enums;
+using System;
+using System.Collections.Generic;
+using DMS.Application.Configurations;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace DMS.WPF.ItemViewModel;
+
+/// <summary>
+/// 表示单个变量项的视图模型。
+/// 此类用于UI层的数据绑定，封装了变量数据以及与UI相关的状态和逻辑。
+/// 它继承自 ObservableObject，以便于实现 INotifyPropertyChanged 接口，从而支持WPF的双向绑定。
+/// </summary>
+public partial class VariableItem : ObservableObject
+{
+    /// <summary>
+    /// 获取或设置变量的唯一标识符 (ID)。
+    /// 通常对应数据库中的主键。
+    /// </summary>
+    public int Id { get; set; }
+
+    /// <summary>
+    /// 获取或设置变量的名称。
+    /// 这个名称会显示在UI界面上，例如在列表或标签中。
+    /// [ObservableProperty] 特性会自动生成支持变更通知的属性。
+    /// </summary>
+    [ObservableProperty]
+    private string _name;
+
+    /// <summary>
+    /// 获取或设置变量的S7通信地址。
+    /// 例如："DB1.DBD0"。仅在协议为S7时有效。
+    /// </summary>
+    [ObservableProperty]
+    private string? _s7Address;
+
+    /// <summary>
+    /// 获取或设置从设备读取到的原始数据值。
+    /// 这通常是未经转换的字符串形式的值。
+    /// </summary>
+    [ObservableProperty]
+    private string? _dataValue;
+
+    /// <summary>
+    /// 获取或设置从设备读取到的数值。如果原始值是布尔类型，则True转换为1.0，False转换为0.0。
+    /// </summary>
+    [ObservableProperty]
+    private double _numericValue;
+
+    /// <summary>
+    /// 获取或设置用于在界面上显示的值。
+    /// 这可能是经过公式转换、格式化或添加了单位后的值。
+    /// </summary>
+    [ObservableProperty]
+    private string? _displayValue;
+
+    /// <summary>
+    /// 上一次的数值，用于死区报警计算
+    /// </summary>
+    private double _previousNumericValue;
+
+    partial void OnDataValueChanged(string? oldValue, string? newValue)
+    {
+        // 当DataValue发生变化时，更新NumericValue
+        if (string.IsNullOrEmpty(newValue))
+        {
+            NumericValue = 0.0;
+            return;
+        }
+
+        // 尝试将字符串转换为数值
+        if (double.TryParse(newValue, out double numericValue))
+        {
+            // 更新上一次的数值
+            _previousNumericValue = NumericValue;
+            NumericValue = numericValue;
+        }
+        // 如果是布尔值
+        else if (bool.TryParse(newValue, out bool boolValue))
+        {
+            // 更新上一次的数值
+            _previousNumericValue = NumericValue;
+            NumericValue = boolValue ? 1.0 : 0.0;
+        }
+        // 如果无法转换，保持为0.0
+        else
+        {
+            // 更新上一次的数值
+            _previousNumericValue = NumericValue;
+            NumericValue = 0.0;
+        }
+    }
+
+    /// <summary>
+    /// 获取或设置此变量所属的变量表 (VariableTable) 的数据传输对象 (DTO)。
+    /// 用于在界面上显示变量表的关联信息。
+    /// </summary>
+    [ObservableProperty]
+    private VariableTableDto? _variableTable;
+
+    /// <summary>
+    /// 获取或设置与此变量关联的MQTT别名列表。
+    /// 一个变量可以有多个MQTT别名。
+    /// </summary>
+    [ObservableProperty]
+    private List<MqttAliasItem>? _mqttAliases=new List<MqttAliasItem>();
+
+    /// <summary>
+    /// 获取或设置变量的信号类型 (如：AI, DI, AO, DO)。
+    /// </summary>
+    [ObservableProperty]
+    private SignalType _signalType =SignalType.OtherASignal;
+
+    /// <summary>
+    /// 获取或设置变量的轮询间隔（毫秒）。
+    /// 用于决定数据采集的频率。
+    /// </summary>
+    [ObservableProperty]
+    private int _pollingInterval;
+    
+    public VariableItem()
+    {
+    }
+    
+
+    /// <summary>
+    /// 获取或设置一个值，该值指示此变量是否被激活。
+    /// 未激活的变量将不会被后台服务轮询。
+    /// </summary>
+    [ObservableProperty]
+    private bool _isActive;
+
+    /// <summary>
+    /// 获取或设置变量所属的变量表的ID。
+    /// </summary>
+    [ObservableProperty]
+    private int _variableTableId;
+
+    /// <summary>
+    /// 获取或设置变量的OPC UA节点ID。
+    /// 例如："ns=2;s=MyDevice.MyVariable"。仅在协议为OpcUa时有效。
+    /// </summary>
+    [ObservableProperty]
+    private string _opcUaNodeId;
+
+    /// <summary>
+    /// 获取或设置是否为此变量启用历史记录。
+    /// </summary>
+    [ObservableProperty]
+    private bool _isHistoryEnabled;
+
+    /// <summary>
+    /// 获取或设置历史记录的死区值。
+    /// 当值的变化超过此死区值时，才会记录历史数据，用于减少不必要的数据存储。
+    /// </summary>
+    [ObservableProperty]
+    private double _historyDeadband;
+
+    /// <summary>
+    /// 获取或设置是否为此变量启用报警功能。
+    /// </summary>
+    [ObservableProperty]
+    private bool _isAlarmEnabled;
+
+    /// <summary>
+    /// 获取或设置报警的下限值。
+    /// </summary>
+    [ObservableProperty]
+    private double _alarmMinValue;
+
+    /// <summary>
+    /// 获取或设置报警的上限值。
+    /// </summary>
+    [ObservableProperty]
+    private double _alarmMaxValue;
+
+    /// <summary>
+    /// 获取或设置报警的死区值。
+    /// 用于防止在临界点附近频繁触发或解除报警。
+    /// </summary>
+    [ObservableProperty]
+    private double _alarmDeadband;
+
+    /// <summary>
+    /// 获取或设置变量使用的通信协议（如：S7, OpcUa, Modbus）。
+    /// </summary>
+    [ObservableProperty]
+    private ProtocolType _protocol;
+
+    /// <summary>
+    /// 获取或设置变量在C#中对应的数据类型。
+    /// </summary>
+    [ObservableProperty]
+    private DataType _dataType;
+
+    /// <summary>
+    /// 获取或设置值的转换公式。
+    /// 例如："x * 10" 或 "(x / 100) + 5"。'x' 代表原始值。
+    /// </summary>
+    [ObservableProperty]
+    private string _conversionFormula;
+
+    /// <summary>
+    /// 获取或设置记录的创建时间。
+    /// </summary>
+    [ObservableProperty]
+    private DateTime _createdAt;
+
+    /// <summary>
+    /// 获取或设置记录的最后更新时间。
+    /// </summary>
+    [ObservableProperty]
+    private DateTime _updatedAt;
+
+    /// <summary>
+    /// 获取或设置最后更新此记录的用户或进程。
+    /// </summary>
+    [ObservableProperty]
+    private string _updatedBy;
+
+    /// <summary>
+    /// 获取或设置一个值，该值指示此视图模型中的数据是否已被修改。
+    /// 用于跟踪UI上的更改，以便提示用户保存。
+    /// </summary>
+    [ObservableProperty]
+    private bool _isModified;
+
+    /// <summary>
+    /// 获取或设置变量的描述信息。
+    /// 提供关于该变量的更多上下文或备注。
+    /// </summary>
+    [ObservableProperty]
+    private string _description;
+
+
+    /// <summary>
+    /// 获取或设置OPC UA值的更新方式（轮询或订阅）。
+    /// </summary>
+    [ObservableProperty]
+    private OpcUaUpdateType _opcUaUpdateType;
+
+    
+    /// <summary>
+    /// 上一次的布尔值，用于布尔值变化报警计算
+    /// </summary>
+    private bool? _previousBoolValue = null;
+    
+    /// <summary>
+    /// 检查死区报警和布尔值变化报警
+    /// </summary>
+    public void CheckAdvancedAlarms(VariableDto variable)
+    {
+        // 检查死区报警
+        if (variable.IsAlarmEnabled && variable.AlarmDeadband > 0)
+        {
+            double difference = Math.Abs(NumericValue - _previousNumericValue);
+            if (difference > variable.AlarmDeadband)
+            {
+                // 触发死区报警
+                // 这里可以触发一个事件或调用报警服务
+                // 为了简单起见，我们暂时只打印日志
+                Console.WriteLine($"变量 {variable.Name} 的值变化 {difference} 超过了死区 {variable.AlarmDeadband}。");
+            }
+        }
+        
+        // 检查布尔值变化报警
+        if (variable.IsAlarmEnabled && variable.DataType == DataType.Bool)
+        {
+            if (bool.TryParse(DataValue, out bool currentBoolValue))
+            {
+                // 如果上一次的值不为空，并且当前值与上一次的值不同，则触发报警
+                if (_previousBoolValue.HasValue && _previousBoolValue.Value != currentBoolValue)
+                {
+                    // 触发布尔值变化报警
+                    // 这里可以触发一个事件或调用报警服务
+                    // 为了简单起见，我们暂时只打印日志
+                    Console.WriteLine($"变量 {variable.Name} 的布尔值从 {_previousBoolValue.Value} 变化为 {currentBoolValue}。");
+                }
+                // 更新上一次的布尔值
+                _previousBoolValue = currentBoolValue;
+            }
+        }
+    }
+}