using Deal.Infrastructure.Persistence.Configurations;

namespace Deal.Infrastructure.Persistence.Entities;

/// <summary>
/// Счётчик фиксированного окна в системной схеме public (этап 12, пакет B).
/// </summary>
/// <remarks>
/// Используется распределённым rate limiting (auth/api/gRPC-ингресс) и guard'ом попыток входа: значение
/// общего счётчика видно всем инстансам core (ранее — память одного процесса). Строка живёт до
/// <see cref="ExpiresAt"/> (windowStart + длина окна), после чего удаляется фоновой уборкой.
/// </remarks>
public sealed class RateLimitCounterEntity
{
    /// <summary>
    /// Уникальный ключ счётчика (префикс политики/типа + партиция: IP, tenant-id или ip|login).
    /// </summary>
    public string Key { get; set; } = string.Empty;

    /// <summary>
    /// Начало текущего фиксированного окна (UTC; выровнено по длине окна).
    /// </summary>
    public DateTimeOffset WindowStart { get; set; }

    /// <summary>
    /// Момент, после которого строка считается устаревшей (windowStart + длина окна).
    /// </summary>
    public DateTimeOffset ExpiresAt { get; set; }

    /// <summary>
    /// Число потреблённых единиц в текущем окне.
    /// </summary>
    public int Count { get; set; }
}