FileShare/FileShare-EFCore/Models/ApiRefreshTokenEntity.cs

using Microsoft.EntityFrameworkCore;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace FileShare_EFCore.Models
{
    /// <summary>
    /// API refresh token。只保存哈希，不保存明文 token。
    /// </summary>
    [Comment("API refresh token")]
    [Table("api-refresh-token")]
    public class ApiRefreshTokenEntity
    {
        /// <summary>
        /// 获取或设置主键 ID（自增）。
        /// </summary>
        [Key]
        [Column("id")]
        [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
        public long Id { get; set; }

        /// <summary>
        /// 获取或设置关联的用户 ID。
        /// </summary>
        [Column("user-id")]
        public int UserId { get; set; }

        /// <summary>
        /// 获取或设置 Token 的 SHA256 哈希值，用于安全存储和查询。
        /// </summary>
        [Column("token-hash")]
        [MaxLength(128)]
        public string TokenHash { get; set; } = string.Empty;

        /// <summary>
        /// 获取或设置 Token 创建时间。
        /// </summary>
        [Column("created-at")]
        public DateTime CreatedAt { get; set; } = DateTime.UtcNow;

        /// <summary>
        /// 获取或设置 Token 过期时间。
        /// </summary>
        [Column("expires-at")]
        public DateTime ExpiresAt { get; set; }

        /// <summary>
        /// 获取或设置 Token 撤销时间，null 表示尚未撤销。
        /// </summary>
        [Column("revoked-at")]
        public DateTime? RevokedAt { get; set; }

        /// <summary>
        /// 获取或设置替换此 Token 的新 Token 哈希值（轮换时设置）。
        /// </summary>
        [Column("replaced-by-token-hash")]
        [MaxLength(128)]
        public string? ReplacedByTokenHash { get; set; }

        /// <summary>
        /// 获取或设置创建设备标识（如 User-Agent）。
        /// </summary>
        [Column("device")]
        [MaxLength(200)]
        public string? Device { get; set; }

        /// <summary>
        /// 获取或设置创建时的客户端 IP 地址。
        /// </summary>
        [Column("ip-address")]
        [MaxLength(64)]
        public string? IpAddress { get; set; }

        /// <summary>
        /// 获取 Token 是否有效（未被撤销且未过期）。
        /// </summary>
        public bool IsActive => RevokedAt is null && ExpiresAt > DateTime.UtcNow;
    }
}