using System.ComponentModel.DataAnnotations;

namespace TrajetKmTracker.Api.Models.Entities;

/// <summary>
/// Tranche du barème kilométrique URSSAF pour une année et une puissance fiscale.
/// Trois tranches par (année, puissance fiscale) : ≤5000 km, 5001–20000 km, &gt;20000 km.
/// </summary>
public class TrancheBareme
{
    public int Id { get; set; }

    [Required]
    public int Annee { get; set; }

    [Required]
    public int PuissanceFiscale { get; set; }

    /// <summary>Borne minimale de kilométrage annuel (incluse).</summary>
    [Required]
    public decimal KmMin { get; set; }

    /// <summary>
    /// Borne maximale de kilométrage annuel, EXCLUSIVE : la tranche couvre [KmMin, KmMax[.
    /// <c>null</c> signifie « illimité » (dernière tranche, sans borne supérieure).
    /// </summary>
    public decimal? KmMax { get; set; }

    /// <summary>Coefficient en euros par kilomètre.</summary>
    [Required]
    public decimal Coefficient { get; set; }

    /// <summary>Base fixe en euros ajoutée au montant (nulle pour les tranches 1 et 3). Formule : km × Coefficient + Base.</summary>
    public decimal Base { get; set; } = 0m;
}