using SchotzIadKmTracker.Api.Models.DTOs;

namespace SchotzIadKmTracker.Api.Services;

/// <summary>
/// Logique métier de gestion des véhicules : historique, véhicule courant,
/// création (avec détection de réaffectation) et réaffectation des trajets.
/// </summary>
public interface IVehiculeService
{
    /// <summary>Retourne l'historique complet des véhicules (plaque, puissance fiscale, date d'effet), trié par Date_Effet décroissante.</summary>
    Task<IReadOnlyList<VehiculeDto>> GetHistoriqueAsync(CancellationToken cancellationToken = default);

    /// <summary>
    /// Retourne le Véhicule_Courant : Date_Effet la plus récente parmi celles &lt;= aujourd'hui.
    /// Lève <see cref="Exceptions.VehiculeNotFoundException"/> si aucun véhicule n'est applicable.
    /// </summary>
    Task<VehiculeDto> GetVehiculeCourantAsync(CancellationToken cancellationToken = default);

    /// <summary>
    /// Résout le véhicule applicable à une date donnée (pour l'association d'un trajet) :
    /// Date_Effet la plus récente &lt;= <paramref name="date"/>.
    /// Retourne <c>null</c> si aucun véhicule n'est applicable à cette date.
    /// </summary>
    Task<VehiculeDto?> GetVehiculeADateAsync(DateOnly date, CancellationToken cancellationToken = default);

    /// <summary>
    /// Crée un véhicule, conserve l'historique et détecte les trajets à réaffecter
    /// (date &gt;= Date_Effet et puissance fiscale différente).
    /// Lève <see cref="Exceptions.DateEffetFutureException"/> si la Date_Effet est postérieure à aujourd'hui.
    /// </summary>
    Task<VehiculeCreeDto> CreateAsync(CreateVehiculeDto dto, CancellationToken cancellationToken = default);

    /// <summary>
    /// Applique (ou non) la réaffectation des trajets au véhicule indiqué.
    /// Si <see cref="ReaffectationDto.Accepter"/> est vrai, met à jour VehiculeId + PuissanceFiscale
    /// de tous les trajets dont la Date &gt;= Date_Effet du véhicule ; sinon ne change rien.
    /// Lève <see cref="Exceptions.VehiculeNotFoundException"/> si le véhicule n'existe pas.
    /// </summary>
    Task ReaffecterAsync(ReaffectationDto dto, CancellationToken cancellationToken = default);
}