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