MadJax
e3f946f7d4
Application complète de saisie et de suivi des trajets kilométriques avec calcul de distance routière (OpenRouteService), barème kilométrique, résumés et régularisation annuelle. Backend (ASP.NET Core .NET 8, EF Core, SQLite) : - Trajets (CRUD, réordonnancement, insertion), calcul de distance ORS avec fallback Haversine, géométrie d'itinéraire stockée par trajet, recalcul en masse. - Profil, véhicules (avec dénomination), carnet d'adresses nommées, cache d'adresses. - Barème kilométrique : tranches multiples par puissance fiscale, borne max exclusive avec 'illimité' (KmMax nullable), coefficient à 3 décimales, recopie du dernier barème connu. - Résumés mensuel/annuel, montants réglés, régularisation, export PDF. Frontend (Angular 22, zoneless + signals) : - Consultation par jour, navigation temporelle synchronisée, carte Leaflet, formulaire de trajet (adresses nommées, domicile, autocomplétion BAN). - Détection de changement zoneless (indépendante de zone.js). Hébergement : Docker Compose (nginx + backend), scripts run-dev.sh / run-docker.sh.
42 lines
2.1 KiB
C#
42 lines
2.1 KiB
C#
namespace TrajetKmTracker.Api.Services;
|
|
|
|
/// <summary>
|
|
/// Orchestre le calcul de la distance d'un trajet à partir des adresses de départ et
|
|
/// d'arrivée et de leurs coordonnées éventuelles.
|
|
///
|
|
/// Logique :
|
|
/// <list type="bullet">
|
|
/// <item>Si les deux coordonnées sont connues → appel ORS ; en cas de timeout/échec ORS
|
|
/// → fallback orthodromique (Haversine), sans erreur pour l'utilisateur.</item>
|
|
/// <item>Si une coordonnée est absente → géocodage BAN de l'adresse manquante
|
|
/// (meilleur résultat) AVANT tout appel ORS ; ORS n'est jamais appelé avec des
|
|
/// coordonnées nulles (Property 16).</item>
|
|
/// <item>Si BAN ne peut pas résoudre (aucun résultat ou indisponible) → distance nulle
|
|
/// + avertissement, sans erreur bloquante, pour que l'appelant stocke la distance null.</item>
|
|
/// </list>
|
|
/// </summary>
|
|
public interface IDistanceCalculator
|
|
{
|
|
/// <summary>
|
|
/// Calcule la distance entre <paramref name="adresseDepart"/> et
|
|
/// <paramref name="adresseArrivee"/>, en résolvant au besoin les coordonnées manquantes
|
|
/// via BAN, puis en appelant ORS (avec fallback Haversine).
|
|
/// </summary>
|
|
/// <param name="adresseDepart">Texte de l'adresse de départ.</param>
|
|
/// <param name="adresseArrivee">Texte de l'adresse d'arrivée.</param>
|
|
/// <param name="departLatitude">Latitude de départ connue, ou <c>null</c>.</param>
|
|
/// <param name="departLongitude">Longitude de départ connue, ou <c>null</c>.</param>
|
|
/// <param name="arriveeLatitude">Latitude d'arrivée connue, ou <c>null</c>.</param>
|
|
/// <param name="arriveeLongitude">Longitude d'arrivée connue, ou <c>null</c>.</param>
|
|
/// <param name="cancellationToken">Jeton d'annulation.</param>
|
|
/// <returns>Un <see cref="DistanceCalculationResult"/> (jamais d'exception bloquante).</returns>
|
|
Task<DistanceCalculationResult> CalculerAsync(
|
|
string adresseDepart,
|
|
string adresseArrivee,
|
|
double? departLatitude,
|
|
double? departLongitude,
|
|
double? arriveeLatitude,
|
|
double? arriveeLongitude,
|
|
CancellationToken cancellationToken = default);
|
|
}
|