namespace ClassNotify.Shared.Models;
///
/// 远程维护命令类型常量
///
public static class DeviceCommandTypes
{
public const string SelfCheck = "SelfCheck";
public const string RestartClient = "RestartClient";
public const string Reconnect = "Reconnect";
public const string RefreshConfig = "RefreshConfig";
public static readonly string[] AllSupported = [SelfCheck, RestartClient, Reconnect, RefreshConfig];
public static bool IsSupported(string? commandType)
{
if (string.IsNullOrWhiteSpace(commandType)) return false;
return AllSupported.Contains(commandType, StringComparer.OrdinalIgnoreCase);
}
///
/// 获取命令类型的默认安全 TTL(生命周期)
/// 严禁长期补发,过期即弃
///
public static TimeSpan GetDefaultTtl(string commandType)
{
return commandType?.ToLowerInvariant() switch
{
"restartclient" or "restart_client" => TimeSpan.FromMinutes(2),
"reconnect" => TimeSpan.FromMinutes(2),
"refreshconfig" or "refresh_config" => TimeSpan.FromMinutes(5),
"selfcheck" or "self_check" => TimeSpan.FromMinutes(5),
_ => TimeSpan.FromMinutes(2)
};
}
}
///
/// 远程维护命令状态常量
///
public static class DeviceCommandStatuses
{
public const string Pending = "Pending";
public const string Dispatched = "Dispatched";
public const string Succeeded = "Succeeded";
public const string Failed = "Failed";
public const string TimedOut = "TimedOut";
public const string Expired = "Expired";
public static bool IsTerminal(string status) =>
status is Succeeded or Failed or TimedOut or Expired;
}
///
/// 远程运维命令传输对象
/// 全链路统一 CommandId (cmd_xxxxx),从创建到最终上报不可篡改
///
public class DeviceCommandDto
{
public string CommandId { get; set; } = string.Empty;
public string TenantId { get; set; } = string.Empty;
public string DeviceId { get; set; } = string.Empty;
public string CommandType { get; set; } = string.Empty;
public string? Parameters { get; set; }
public string CreatedBy { get; set; } = string.Empty;
public DateTimeOffset CreatedAt { get; set; } = DateTimeOffset.UtcNow;
public DateTimeOffset ExpiresAt { get; set; }
public string Status { get; set; } = DeviceCommandStatuses.Pending;
public DateTimeOffset? StartedAt { get; set; }
public DateTimeOffset? CompletedAt { get; set; }
public long? DurationMs { get; set; }
public int? ResultCode { get; set; }
public string? ResultMessage { get; set; }
}
///
/// 终端设备执行远程命令后回传的结果报文
///
public class DeviceCommandResultDto
{
public string CommandId { get; set; } = string.Empty;
public string DeviceId { get; set; } = string.Empty;
public string Status { get; set; } = DeviceCommandStatuses.Succeeded;
public int ResultCode { get; set; } = 0;
public string? ResultMessage { get; set; }
public long ExecutionDurationMs { get; set; }
public DateTimeOffset Timestamp { get; set; } = DateTimeOffset.UtcNow;
}