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.
35 lines
1.8 KiB
C#
35 lines
1.8 KiB
C#
using TrajetKmTracker.Api.Models.DTOs;
|
|
|
|
namespace TrajetKmTracker.Api.Services;
|
|
|
|
/// <summary>
|
|
/// Logique métier des résumés kilométriques mensuels et annuels.
|
|
/// Les distances nulles (Trajet non calculé, Exigence 2.4) sont traitées comme 0 dans les totaux.
|
|
/// </summary>
|
|
public interface IResumeService
|
|
{
|
|
/// <summary>
|
|
/// Construit le Résumé_Mensuel d'un mois : liste des Trajets triés par date croissante puis
|
|
/// par Position croissante, chacun avec sa Distance, et total kilométrique (somme des distances,
|
|
/// null → 0) arrondi à 2 décimales (Property 1 — Exigences 3.2, 3.3, 6.5).
|
|
/// Filtre par véhicule lorsque <paramref name="vehiculeId"/> est fourni ; sinon inclut tous les véhicules.
|
|
/// </summary>
|
|
/// <exception cref="Exceptions.ResumeParametreInvalideException">
|
|
/// Levée si <paramref name="mois"/> ∉ [1, 12] ou <paramref name="annee"/> ∉ [2000, 2100] (Exigence 3.6).
|
|
/// </exception>
|
|
Task<ResumeMensuelDto> GetResumeMensuelAsync(
|
|
int annee, int mois, int? vehiculeId = null, CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>
|
|
/// Construit le Résumé_Annuel d'une année : toujours exactement 12 Résumés_Mensuels
|
|
/// (mois 1..12, les mois vides ayant un total de 0,00), et total annuel égal à la somme
|
|
/// des 12 totaux mensuels (Property 2, Property 7 — Exigences 4.2, 4.3, 4.4, 4.7, 6.6).
|
|
/// Filtre par véhicule lorsque <paramref name="vehiculeId"/> est fourni ; sinon inclut tous les véhicules.
|
|
/// </summary>
|
|
/// <exception cref="Exceptions.ResumeParametreInvalideException">
|
|
/// Levée si <paramref name="annee"/> ∉ [2000, 2100] (Exigence 3.6).
|
|
/// </exception>
|
|
Task<ResumeAnnuelDto> GetResumeAnnuelAsync(
|
|
int annee, int? vehiculeId = null, CancellationToken cancellationToken = default);
|
|
}
|