DMS/软件设计文档/原始文档/03-应用层与基础设施层设计.md

# 软件开发文档 - 03. 应用层与基础设施层设计

本文档定义了 `DMS.Application` 和 `DMS.Infrastructure` 两个项目的详细设计。

## 1. `DMS.Application` - 应用层设计

应用层是业务流程的协调者。

### 1.1. 应用服务接口 (`Interfaces/`)

```csharp
// 文件: DMS.Application/Interfaces/IDeviceAppService.cs
namespace DMS.Application.Interfaces;

public interface IDeviceAppService
{
    Task<DeviceDto> GetDeviceByIdAsync(int id);
    Task<List<DeviceDto>> GetAllDevicesAsync();
    Task CreateDeviceAsync(CreateDeviceDto deviceDto);
    Task UpdateDeviceAsync(UpdateDeviceDto deviceDto);
    Task DeleteDeviceAsync(int id);
}

// 其他应用服务接口，如 IMqttAppService, IVariableAppService 等，结构类似。
```

### 1.2. 数据传输对象 (`DTOs/`)

DTOs 用于封装数据，在各层之间传递，特别是用于UI。

```csharp
// 文件: DMS.Application/DTOs/DeviceDto.cs
namespace DMS.Application.DTOs;

public class DeviceDto
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Protocol { get; set; }
    public bool IsActive { get; set; }
    public int OnlineStatus { get; set; } // 0: Offline, 1: Online
}

// 文件: DMS.Application/DTOs/CreateDeviceDto.cs
namespace DMS.Application.DTOs;

public class CreateDeviceDto
{
    public string Name { get; set; }
    public ProtocolType Protocol { get; set; }
    public string IpAddress { get; set; }
    public int Port { get; set; }
}

// 其他DTOs，如 UpdateDeviceDto, VariableDto, MqttServerDto 等。
```

### 1.3. 应用服务实现 (`Services/`)

应用服务实现了接口，并使用仓储库来执行操作。

```csharp
// 文件: DMS.Application/Services/DeviceAppService.cs
namespace DMS.Application.Services;

public class DeviceAppService : IDeviceAppService
{
    private readonly IDeviceRepository _deviceRepository;
    private readonly IMapper _mapper;

    public DeviceAppService(IDeviceRepository deviceRepository, IMapper mapper)
    {
        _deviceRepository = deviceRepository;
        _mapper = mapper;
    }

    public async Task CreateDeviceAsync(CreateDeviceDto deviceDto)
    {
        var device = _mapper.Map<Device>(deviceDto);
        device.IsActive = true; // 默认激活
        await _deviceRepository.AddAsync(device);
    }

    // ... 其他方法的实现
}
```

## 2. `DMS.Infrastructure` - 基础设施层设计

基础设施层提供具体的技术实现。

### 2.1. 仓储库实现 (`Repositories/`)

这里是 `DMS.Core` 中定义的仓储接口的具体实现。

```csharp
// 文件: DMS.Infrastructure/Repositories/DeviceRepository.cs
namespace DMS.Infrastructure.Repositories;

public class DeviceRepository : BaseRepository<Device, DbDevice>, IDeviceRepository
{
    public DeviceRepository(ISqlSugarClient db, IMapper mapper) : base(db, mapper) { }

    public async Task<List<Device>> GetActiveDevicesWithDetailsAsync()
    {
        // 使用 SqlSugar 的 Include/Navigate 功能来实现嵌套查询
        var dbDevices = await _db.Queryable<DbDevice>()
                                 .Where(d => d.IsActive)
                                 .ToListAsync();
        // ... 此处需要手动或通过AutoMapper的ProjectTo来加载关联数据
        return _mapper.Map<List<Device>>(dbDevices);
    }

    public async Task<List<Device>> GetDevicesByProtocolAsync(ProtocolType protocol)
    {
        var dbDevices = await _db.Queryable<DbDevice>().Where(d => d.Protocol == (int)protocol).ToListAsync();
        return _mapper.Map<List<Device>>(dbDevices);
    }
}
```

### 2.2. 外部服务 (`Services/`)

#### 2.2.1. S7通信服务

负责与Siemens S7 PLC进行通信。

```csharp
// 文件: DMS.Infrastructure/Services/S7CommunicationService.cs
namespace DMS.Infrastructure.Services;

public interface IS7CommunicationService
{
    Task<object> ReadVariableAsync(Device device, Variable variable);
    Task ConnectAsync(Device device);
    Task DisconnectAsync(Device device);
}

public class S7CommunicationService : IS7CommunicationService
{
    // 使用第三方库，如 S7.Net Plus
    private readonly ConcurrentDictionary<int, S7.Net.Plc> _clients = new();

    public async Task ConnectAsync(Device device)
    {
        // ... 实现连接逻辑
    }

    public async Task<object> ReadVariableAsync(Device device, Variable variable)
    {
        // ... 实现读变量逻辑
        // 1. 检查连接是否存在
        // 2. 解析 variable.Address
        // 3. 调用 S7.Net 的 Read 方法
        // 4. 返回读取到的值
    }
    // ... 其他方法
}
```

#### 2.2.2. MQTT发布服务

负责将数据发布到MQTT Broker。

```csharp
// 文件: DMS.Infrastructure/Services/MqttPublishService.cs
namespace DMS.Infrastructure.Services;

public interface IMqttPublishService
{
    Task PublishAsync(MqttServer server, string topic, string payload);
}

public class MqttPublishService : IMqttPublishService
{
    // 使用第三方库，如 MQTTnet
    public async Task PublishAsync(MqttServer server, string topic, string payload)
    {
        // ... 实现MQTT发布逻辑
    }
}
```