using TrajetKmTracker.Api.Models.DTOs;

namespace TrajetKmTracker.Api.Services;

/// <summary>
/// Logique métier des Montant_Regle (montants effectivement versés, saisis par l'utilisateur)
/// et du Montant_Previsionnel (indication de versement à 80% du barème, purement informative).
/// </summary>
public interface IMontantRegleService
{
    /// <summary>
    /// Enregistre ou met à jour (upsert) le Montant_Regle pour un couple (année, mois, véhicule).
    /// S'il existe déjà une ligne pour la même (Annee, Mois, VehiculeId), elle est mise à jour ;
    /// sinon une nouvelle ligne est insérée (Property 26, Exigences 14.1/14.2/14.3).
    /// Rejette un montant négatif via <see cref="Exceptions.MontantRegleNegatifException"/> (Exigence 14.4).
    /// </summary>
    Task<MontantRegleDto> UpsertMontantRegleAsync(
        MontantRegleDto dto, CancellationToken cancellationToken = default);

    /// <summary>
    /// Retourne les Montant_Regle saisis pour une (année, véhicule), triés par mois croissant.
    /// Destiné au controller et au service de régularisation.
    /// </summary>
    Task<IReadOnlyList<MontantRegleDto>> GetMontantsReglesAsync(
        int annee, int vehiculeId, CancellationToken cancellationToken = default);

    /// <summary>
    /// Calcule le Montant_Previsionnel indicatif pour un (année, mois, véhicule) :
    /// 80% du Bareme_Kilometrique plein appliqué au Total_Annuel_Partiel du véhicule
    /// (somme des distances de l'année pour ce véhicule jusqu'au mois indiqué inclus),
    /// arrondi à deux décimales (Property 23, Exigences 13.5/13.6).
    /// Cette valeur est purement informative et n'entre jamais dans la régularisation.
    /// </summary>
    Task<MontantPrevisionnelDto> GetMontantPrevisionnelAsync(
        int annee, int mois, int vehiculeId, CancellationToken cancellationToken = default);
}