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.2 KiB
C#
42 lines
2.2 KiB
C#
using TrajetKmTracker.Api.Models.DTOs;
|
|
|
|
namespace TrajetKmTracker.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 <= 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 <= <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 >= 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 >= 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);
|
|
}
|