using ClassNotify.Shared.Enums; namespace ClassNotify.Shared.Models; /// /// 客户端权威状态快照(由 Windows Service 统一向 Client 推送或应答) /// public class ClientStateSnapshotDto { /// /// Turn 115 权威设备绑定生命周期状态: Unbound / Bound /// public DeviceBindingState BindingState { get; set; } = DeviceBindingState.Unbound; /// /// Turn 116 运行限制状态维度(与 BindingState 正交,互不污染) /// public OperationalRestrictionState RestrictionState { get; set; } = OperationalRestrictionState.None; /// /// 权威教室/班级ID /// public string? ClassroomId { get; set; } /// /// 权威教室/班级显示名称 /// public string? ClassroomDisplayName { get; set; } /// /// 已绑定教师总数(去实名化计数,合规保护隐私) /// public int BoundTeacherCount { get; set; } = 0; /// /// 状态版本号,单调递增,防止异步消息乱序覆盖 /// public long StateRevision { get; set; } = 0; /// /// 设备配置状态:Unactivated / Activating / Activated / CredentialError / ReprovisionRequired /// public string ProvisioningState { get; set; } = "Unactivated"; /// /// 商业授权状态:Valid / ExpiringSoon / ExpiredRestricted / RevokedRestricted / OfflineGrace / OfflineRestricted / TimeUntrusted / Perpetual /// public string LicenseStatus { get; set; } = "Valid"; public string? DeviceId { get; set; } public string? TenantId { get; set; } public string? ClassId { get; set; } public string? ClassDisplayName { get; set; } public int RemainingDays { get; set; } public int RemainingHours { get; set; } public DateTimeOffset? LicensedUntilUtc { get; set; } public bool CanRenew { get; set; } = true; public bool CanReceiveNormalNotifications { get; set; } = true; public bool CloudConnected { get; set; } public string? ErrorMessage { get; set; } /// /// 云端实时连接详细状态: Connected / Reconnecting / Disconnected / UpdatingBinding /// public string RealtimeChannelState { get; set; } = "Disconnected"; /// /// 上次与云端成功通信/心跳确认时间 /// public DateTimeOffset? LastSuccessfulHeartbeatUtc { get; set; } /// /// 状态细节说明(如最近心跳耗时、重试间隔) /// public string? ChannelDetail { get; set; } }