namespace SchotzIadKmTracker.Api.Services;

/// <summary>
/// Résultat du calcul du montant barème pour un (année, puissance fiscale, total km) donné.
/// Lorsque aucune tranche n'est configurée, <see cref="BaremeConfigure"/> vaut <c>false</c>,
/// le <see cref="Montant"/> est nul et un <see cref="Avertissement"/> décrit la situation
/// (Exigence 13.4) — le calcul n'est jamais interrompu par une exception bloquante.
/// </summary>
/// <param name="Montant">Montant calculé : total_km × Coefficient + Base de la tranche, ou 0 si non configuré.</param>
/// <param name="BaremeConfigure">Vrai si une tranche a été trouvée et appliquée.</param>
/// <param name="Coefficient">Coefficient €/km de la tranche appliquée (0 si non configuré).</param>
/// <param name="Base">Base fixe € de la tranche appliquée (0 si non configuré).</param>
/// <param name="Avertissement">Message d'avertissement lorsque le barème n'est pas configuré, sinon <c>null</c>.</param>
public record BaremeCalculResult(
    decimal Montant,
    bool BaremeConfigure,
    decimal Coefficient,
    decimal Base,
    string? Avertissement);