using System;
using System.Collections.Generic;
namespace ClassNotify.Shared.Models;
///
/// 客户端在线升级任务流转状态机 (P2.5 RC1-4 冻结 10 态模型)
///
public static class UpdateStatuses
{
public const string PendingDispatch = "PendingDispatch";
public const string Downloading = "Downloading";
public const string Verified = "Verified";
public const string Installing = "Installing";
public const string HealthChecking = "HealthChecking";
public const string Succeeded = "Succeeded";
public const string Failed = "Failed";
public const string RollingBack = "RollingBack";
public const string RolledBack = "RolledBack";
public const string RollbackFailed = "RollbackFailed";
public const string TimedOut = "TimedOut";
public static readonly HashSet ActiveStatuses = new(StringComparer.OrdinalIgnoreCase)
{
PendingDispatch,
Downloading,
Verified,
Installing,
HealthChecking,
RollingBack
};
public static readonly HashSet TerminalStatuses = new(StringComparer.OrdinalIgnoreCase)
{
Succeeded,
Failed,
RolledBack,
RollbackFailed,
TimedOut
};
}
///
/// 升级与验签标准错误码
///
public static class UpdateErrorCodes
{
public const string ReleaseNotFound = "ReleaseNotFound";
public const string ReleaseDisabled = "ReleaseDisabled";
public const string DeviceNotFound = "DeviceNotFound";
public const string UpdateAlreadyRunning = "UpdateAlreadyRunning";
public const string PackageNotReady = "PackageNotReady";
public const string PackageTooLarge = "PackageTooLarge";
public const string InvalidPackageZip = "InvalidPackageZip";
public const string InvalidSignature = "InvalidSignature";
public const string InvalidSha256 = "InvalidSha256";
public const string ArchitectureMismatch = "ArchitectureMismatch";
public const string ManifestInvalid = "ManifestInvalid";
public const string VersionMismatch = "VersionMismatch";
public const string HealthCheckFailed = "HealthCheckFailed";
public const string RollbackFailed = "RollbackFailed";
public const string UpdateTimeout = "UpdateTimeout";
public const string InvalidStoragePath = "InvalidStoragePath";
public const string Unauthorized = "Unauthorized";
public const string Forbidden = "Forbidden";
// Phase 2 Rollback Standard Error Codes
public const string InvalidUpdateStateTransition = "InvalidUpdateStateTransition";
public const string BackupCreationFailed = "BackupCreationFailed";
public const string BackupVerificationFailed = "BackupVerificationFailed";
public const string InsufficientDiskSpace = "InsufficientDiskSpace";
public const string InstallFileReplacementFailed = "InstallFileReplacementFailed";
public const string ServiceStartFailed = "ServiceStartFailed";
public const string ServiceCrashLoop = "ServiceCrashLoop";
public const string PostUpdateIpcFailed = "PostUpdateIpcFailed";
public const string PostUpdateWpfFailed = "PostUpdateWpfFailed";
public const string PostUpdateSignalRFailed = "PostUpdateSignalRFailed";
public const string RollbackFileRestoreFailed = "RollbackFileRestoreFailed";
public const string RollbackVerificationFailed = "RollbackVerificationFailed";
public const string RollbackServiceStartFailed = "RollbackServiceStartFailed";
public const string RecoveryInterrupted = "RecoveryInterrupted";
// Phase 3 Staged Rollout Standard Error Codes
public const string BatchNotFound = "BatchNotFound";
public const string InvalidBatchScope = "InvalidBatchScope";
public const string BatchInvalidState = "BatchInvalidState";
public const string CanaryNotSucceeded = "CanaryNotSucceeded";
}
///
/// 安装包内嵌 manifest.json 元数据格式
///
public sealed class UpdateManifestV1
{
public int FormatVersion { get; set; } = 1;
public string Version { get; set; } = "";
public string Architecture { get; set; } = "win-x64";
public string PayloadSha256 { get; set; } = "";
public DateTimeOffset CreatedAtUtc { get; set; }
}
///
/// 备份清单条目 (支持精准集合匹配与多余坏版文件物理清除)
///
public sealed class BackupManifestFileEntry
{
public string RelativePath { get; set; } = "";
public long SizeBytes { get; set; }
public string Sha256 { get; set; } = "";
}
///
/// 安装前全量备份清单 backup-manifest.json
///
public sealed class BackupManifestV1
{
public int ManifestVersion { get; set; } = 1;
public string RunId { get; set; } = "";
public string PreviousVersion { get; set; } = "";
public string TargetVersion { get; set; } = "";
public DateTimeOffset CreatedAtUtc { get; set; }
public List Files { get; set; } = new();
}
///
/// 独立更新代理运行日志状态 update-journal.json (掉电/中断可靠恢复)
///
public sealed class UpdateJournalV1
{
public string RunId { get; set; } = "";
public string Phase { get; set; } = "";
public string TargetVersion { get; set; } = "";
public string TargetDir { get; set; } = "";
public string BackupDir { get; set; } = "";
public string StagingZip { get; set; } = "";
public string? ServiceName { get; set; }
public DateTimeOffset UpdatedAtUtc { get; set; }
public string? ErrorCode { get; set; }
public string? ErrorMessage { get; set; }
}
///
/// 通过 SignalR 发送给受控终端的升级启动指令
/// 严格杜绝传递任意外部 URL,仅传递元数据与受控 ReleaseId
///
public sealed class StartDeviceUpdateCommand
{
public string UpdateRunId { get; set; } = "";
public string ReleaseId { get; set; } = "";
public string CorrelationId { get; set; } = "";
public string TargetVersion { get; set; } = "";
public string ExpectedSha256 { get; set; } = "";
public string ManifestSignature { get; set; } = "";
public DateTimeOffset DeadlineAtUtc { get; set; }
}
///
/// SuperAdmin 请求触发单设备更新 DTO
///
public sealed class CreateDeviceUpdateRequest
{
public string ReleaseId { get; set; } = "";
public string? ClientRequestId { get; set; }
}
///
/// 管理员查询与历史恢复 DTO (绝不暴露服务器内部物理路径)
///
public sealed class DeviceUpdateStatusDto
{
public string UpdateRunId { get; set; } = "";
public string DeviceId { get; set; } = "";
public string TenantId { get; set; } = "";
public string ReleaseId { get; set; } = "";
public string Status { get; set; } = "";
public string FromVersion { get; set; } = "";
public string TargetVersion { get; set; } = "";
public DateTimeOffset CreatedAtUtc { get; set; }
public DateTimeOffset DeadlineAtUtc { get; set; }
public DateTimeOffset? CompletedAtUtc { get; set; }
public string? ErrorCode { get; set; }
public string? ErrorMessage { get; set; }
}
///
/// 设备端上报升级阶段与结果请求
///
public sealed class DeviceUpdateReportRequest
{
public string Status { get; set; } = "";
public string? ErrorCode { get; set; }
public string? ErrorMessage { get; set; }
}
///
/// 批次升级生命周期状态
///
public static class UpdateBatchStatuses
{
public const string CanaryRunning = "CanaryRunning";
public const string AwaitingContinue = "AwaitingContinue";
public const string RollingOut = "RollingOut";
public const string Completed = "Completed";
public const string Stopped = "Stopped";
}
///
/// 设备升级分发闸门状态 (物理隔离未放行设备)
///
public static class UpdateDispatchGates
{
public const string Released = "Released";
public const string Held = "Held";
}
///
/// SuperAdmin 创建小规模灰度升级批次请求 (限 1~5 台同一租户设备)
///
public sealed class CreateUpdateBatchRequest
{
public string TenantId { get; set; } = "";
public string ReleaseId { get; set; } = "";
public string CanaryDeviceId { get; set; } = "";
public List DeviceIds { get; set; } = new();
public string? ClientRequestId { get; set; }
}
///
/// 批次升级设备状态汇总聚合 (严禁将汇总计数持久化到批次表)
///
public sealed class UpdateBatchSummaryDto
{
public int Target { get; set; }
public int Held { get; set; }
public int Updating { get; set; }
public int Succeeded { get; set; }
public int RolledBack { get; set; }
public int Failed { get; set; }
public int RollbackFailed { get; set; }
public int TimedOut { get; set; }
}
///
/// 批次内单台设备状态明细 DTO
///
public sealed class UpdateBatchDeviceDetailDto
{
public string DeviceId { get; set; } = "";
public string Hostname { get; set; } = "";
public string ClassroomName { get; set; } = "";
public bool IsCanary { get; set; }
public string DispatchGate { get; set; } = "";
public string Status { get; set; } = "";
public string FromVersion { get; set; } = "";
public string TargetVersion { get; set; } = "";
public DateTimeOffset? StartedAtUtc { get; set; }
public DateTimeOffset? CompletedAtUtc { get; set; }
public string? ErrorCode { get; set; }
public string? ErrorMessage { get; set; }
}
///
/// 批次升级任务全量 DTO
///
public sealed class UpdateBatchDto
{
public string BatchId { get; set; } = "";
public string TenantId { get; set; } = "";
public string ReleaseId { get; set; } = "";
public string TargetVersion { get; set; } = "";
public string Status { get; set; } = "";
public string CanaryDeviceId { get; set; } = "";
public DateTimeOffset CreatedAtUtc { get; set; }
public DateTimeOffset? CompletedAtUtc { get; set; }
public DateTimeOffset? StoppedAtUtc { get; set; }
public UpdateBatchSummaryDto Summary { get; set; } = new();
public List Devices { get; set; } = new();
}
///
/// 发布版本摘要 DTO (供 SuperAdmin 下拉框选择)
///
public sealed class UpdateReleaseSummaryDto
{
public string ReleaseId { get; set; } = "";
public string Version { get; set; } = "";
public string Architecture { get; set; } = "win-x64";
public long PackageSizeBytes { get; set; }
public string PackageSha256 { get; set; } = "";
public DateTimeOffset CreatedAtUtc { get; set; }
public bool IsEnabled { get; set; }
}