按照软件设计文档开始重构代码01

This commit is contained in:
2025-07-21 14:35:17 +08:00
parent a7b0a5d108
commit 29a2d44319
127 changed files with 12265 additions and 1586 deletions

View File

@@ -0,0 +1,47 @@
using DMS.Application.DTOs;
using DMS.Core.Enums;
namespace DMS.Application.Interfaces;
/// <summary>
/// 定义设备管理相关的应用服务操作。
/// </summary>
public interface IDeviceAppService
{
/// <summary>
/// 异步根据ID获取设备DTO。
/// </summary>
Task<DeviceDto> GetDeviceByIdAsync(int id);
/// <summary>
/// 异步获取所有设备DTO列表。
/// </summary>
Task<List<DeviceDto>> GetAllDevicesAsync();
/// <summary>
/// 异步创建一个新设备及其关联的变量表和菜单(事务性操作)。
/// </summary>
/// <param name="dto">包含设备、变量表和菜单信息的DTO。</param>
/// <returns>新创建设备的ID。</returns>
Task<int> CreateDeviceWithDetailsAsync(CreateDeviceWithDetailsDto dto);
/// <summary>
/// 异步更新一个已存在的设备。
/// </summary>
Task UpdateDeviceAsync(UpdateDeviceDto deviceDto);
/// <summary>
/// 异步删除一个设备。
/// </summary>
Task DeleteDeviceAsync(int id);
/// <summary>
/// 异步切换设备的激活状态。
/// </summary>
Task ToggleDeviceActiveStateAsync(int id);
/// <summary>
/// 异步获取指定协议类型的设备列表。
/// </summary>
Task<List<DeviceDto>> GetDevicesByProtocolAsync(ProtocolType protocol);
}

View File

@@ -0,0 +1,34 @@
using DMS.Application.DTOs;
namespace DMS.Application.Interfaces;
/// <summary>
/// 定义菜单管理相关的应用服务操作。
/// </summary>
public interface IMenuService
{
/// <summary>
/// 异步根据ID获取菜单DTO。
/// </summary>
Task<MenuBeanDto> GetMenuByIdAsync(int id);
/// <summary>
/// 异步获取所有菜单DTO列表。
/// </summary>
Task<List<MenuBeanDto>> GetAllMenusAsync();
/// <summary>
/// 异步创建一个新菜单。
/// </summary>
Task<int> CreateMenuAsync(MenuBeanDto menuDto);
/// <summary>
/// 异步更新一个已存在的菜单。
/// </summary>
Task UpdateMenuAsync(MenuBeanDto menuDto);
/// <summary>
/// 异步删除一个菜单。
/// </summary>
Task DeleteMenuAsync(int id);
}

View File

@@ -0,0 +1,34 @@
using DMS.Application.DTOs;
namespace DMS.Application.Interfaces;
/// <summary>
/// 定义MQTT别名管理相关的应用服务操作。
/// </summary>
public interface IMqttAliasAppService
{
/// <summary>
/// 异步根据ID获取MQTT别名DTO。
/// </summary>
Task<VariableMqttAliasDto> GetMqttAliasByIdAsync(int id);
/// <summary>
/// 异步获取所有MQTT别名DTO列表。
/// </summary>
Task<List<VariableMqttAliasDto>> GetAllMqttAliasesAsync();
/// <summary>
/// 异步创建一个新的MQTT别名。
/// </summary>
Task<int> CreateMqttAliasAsync(VariableMqttAliasDto mqttAliasDto);
/// <summary>
/// 异步更新一个已存在的MQTT别名。
/// </summary>
Task UpdateMqttAliasAsync(VariableMqttAliasDto mqttAliasDto);
/// <summary>
/// 异步删除一个MQTT别名。
/// </summary>
Task DeleteMqttAliasAsync(int id);
}

View File

@@ -0,0 +1,34 @@
using DMS.Application.DTOs;
namespace DMS.Application.Interfaces;
/// <summary>
/// 定义MQTT服务器管理相关的应用服务操作。
/// </summary>
public interface IMqttAppService
{
/// <summary>
/// 异步根据ID获取MQTT服务器DTO。
/// </summary>
Task<MqttServerDto> GetMqttServerByIdAsync(int id);
/// <summary>
/// 异步获取所有MQTT服务器DTO列表。
/// </summary>
Task<List<MqttServerDto>> GetAllMqttServersAsync();
/// <summary>
/// 异步创建一个新的MQTT服务器。
/// </summary>
Task<int> CreateMqttServerAsync(MqttServerDto mqttServerDto);
/// <summary>
/// 异步更新一个已存在的MQTT服务器。
/// </summary>
Task UpdateMqttServerAsync(MqttServerDto mqttServerDto);
/// <summary>
/// 异步删除一个MQTT服务器。
/// </summary>
Task DeleteMqttServerAsync(int id);
}

View File

@@ -0,0 +1,34 @@
using DMS.Application.DTOs;
namespace DMS.Application.Interfaces;
/// <summary>
/// 定义变量管理相关的应用服务操作。
/// </summary>
public interface IVariableAppService
{
/// <summary>
/// 异步根据ID获取变量DTO。
/// </summary>
Task<VariableDto> GetVariableByIdAsync(int id);
/// <summary>
/// 异步获取所有变量DTO列表。
/// </summary>
Task<List<VariableDto>> GetAllVariablesAsync();
/// <summary>
/// 异步创建一个新变量。
/// </summary>
Task<int> CreateVariableAsync(VariableDto variableDto);
/// <summary>
/// 异步更新一个已存在的变量。
/// </summary>
Task UpdateVariableAsync(VariableDto variableDto);
/// <summary>
/// 异步删除一个变量。
/// </summary>
Task DeleteVariableAsync(int id);
}