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.
23 lines
1002 B
C#
23 lines
1002 B
C#
using TrajetKmTracker.Api.Models.DTOs;
|
|
|
|
namespace TrajetKmTracker.Api.Services;
|
|
|
|
/// <summary>
|
|
/// Client de l'API BAN (Base Adresses Nationale) pour l'autocomplétion
|
|
/// et le géocodage des adresses françaises.
|
|
/// </summary>
|
|
public interface IBANClient
|
|
{
|
|
/// <summary>
|
|
/// Recherche des adresses correspondant à <paramref name="query"/> via l'endpoint
|
|
/// <c>/search/</c> de la BAN (limité à 5 résultats).
|
|
/// </summary>
|
|
/// <param name="query">Texte de recherche (adresse partielle ou complète).</param>
|
|
/// <param name="cancellationToken">Jeton d'annulation.</param>
|
|
/// <returns>La liste des adresses trouvées, mappées en <see cref="BANAdresseDto"/>.</returns>
|
|
/// <exception cref="Exceptions.BANIndisponibleException">
|
|
/// Levée en cas d'échec réseau, de réponse non réussie ou de dépassement du délai.
|
|
/// </exception>
|
|
Task<IReadOnlyList<BANAdresseDto>> RechercherAsync(string query, CancellationToken cancellationToken = default);
|
|
}
|