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; }