给数据中心添加菜单操作功能

DMS.Application/DTOs/Events/MenuChangedEventArgs.cs

@@ -0,0 +1,44 @@
+using System;
+
+namespace DMS.Application.DTOs.Events
+{
+    /// <summary>
+    /// 菜单变更事件参数
+    /// </summary>
+    public class MenuChangedEventArgs : System.EventArgs
+    {
+        /// <summary>
+        /// 变更类型
+        /// </summary>
+        public DataChangeType ChangeType { get; }
+
+        /// <summary>
+        /// 菜单DTO
+        /// </summary>
+        public MenuBeanDto Menu { get; }
+
+        /// <summary>
+        /// 父级菜单DTO
+        /// </summary>
+        public MenuBeanDto ParentMenu { get; }
+
+        /// <summary>
+        /// 变更时间
+        /// </summary>
+        public DateTime ChangeTime { get; }
+
+        /// <summary>
+        /// 构造函数
+        /// </summary>
+        /// <param name="changeType">变更类型</param>
+        /// <param name="menu">菜单DTO</param>
+        /// <param name="parentMenu">父级菜单DTO</param>
+        public MenuChangedEventArgs(DataChangeType changeType, MenuBeanDto menu, MenuBeanDto parentMenu)
+        {
+            ChangeType = changeType;
+            Menu = menu;
+            ParentMenu = parentMenu;
+            ChangeTime = DateTime.Now;
+        }
+    }
+}

DMS.Application/DTOs/MenuBeanDto.cs

@@ -3,27 +3,62 @@ using DMS.Core.Enums;
 namespace DMS.Application.DTOs;
 
 /// <summary>
-/// 用于在UI上显示菜单项的DTO。
+/// 菜单数据传输对象（DTO）
+/// 用于在应用程序层和表示层之间传输菜单数据，特别是在UI上显示菜单项时使用。
 /// </summary>
 public class MenuBeanDto
 {
+    /// <summary>
+    /// 菜单项的唯一标识符
+    /// </summary>
     public int Id { get; set; }
-    public int? ParentId { get; set; }
+    
+    /// <summary>
+    /// 父级菜单项的ID，用于构建层级菜单结构
+    /// 如果为0表示为顶级菜单项
+    /// </summary>
+    public int ParentId { get; set; }
+    
+    /// <summary>
+    /// 菜单项显示的标题文本
+    /// </summary>
     public string Header { get; set; }
+    
+    /// <summary>
+    /// 菜单项显示的图标资源路径或标识符
+    /// </summary>
     public string Icon { get; set; }
+    
     /// <summary>
     /// 菜单的类型,例如菜单关联的是设备，还是变量表，或者是MQTT
+    /// 用于区分不同类型的菜单项，决定点击菜单项时的行为
     /// </summary>
     public MenuType MenuType { get; set; }
     
     /// <summary>
     /// 菜单关联的数据ID，例如设备Id，变量表Id
+    /// 根据MenuType的不同，此ID可以指向不同的数据实体
     /// </summary>
     public int TargetId { get; set; } 
+    
     /// <summary>
-    /// 菜单关联的数据ID，例如设备Id，变量表Id
+    /// 目标视图的键值，用于导航到特定的视图页面
     /// </summary>
     public string TargetViewKey { get; set; }
+    
+    /// <summary>
+    /// 导航参数，传递给目标视图的额外参数信息
+    /// </summary>
     public string NavigationParameter { get; set; }
+    
+    /// <summary>
+    /// 菜单项在同级菜单中的显示顺序
+    /// 数值越小显示越靠前
+    /// </summary>
     public int DisplayOrder { get; set; }
+
+    /// <summary>
+    /// 子菜单项集合，用于构建层级菜单结构
+    /// </summary>
+    public List<MenuBeanDto> Children { get; set; } = new List<MenuBeanDto>();
 }