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