using TrajetKmTracker.Api.Models.DTOs;

namespace TrajetKmTracker.Api.Services;

/// <summary>
/// Résultat de la création d'un Trajet par <see cref="TrajetService.CreateAsync"/>.
/// Porte le <see cref="TrajetDto"/> persisté et un éventuel avertissement lorsque la
/// distance n'a pas pu être calculée (aucune coordonnée résoluble). Dans ce cas, le
/// Trajet est tout de même persisté avec une Distance nulle et le contrôleur retourne
/// une réponse HTTP 201 accompagnée du message d'avertissement (Exigence 2.4).
/// </summary>
/// <param name="Trajet">Le trajet créé, tel qu'il sera exposé au client.</param>
/// <param name="Avertissement">
/// Vrai lorsque la distance n'a pas pu être calculée (Distance nulle persistée).
/// </param>
/// <param name="Message">Message d'avertissement associé, ou <c>null</c>.</param>
public record TrajetCreationResult(
    TrajetDto Trajet,
    bool Avertissement,
    string? Message);