SchotzIAD KM Tracker : suivi des trajets kilométriques (Angular + .NET 8)

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.
2026-09-14 02:08:27 +02:00
commit e3f946f7d4
225 changed files with 38168 additions and 0 deletions
@@ -0,0 +1,138 @@
+using Microsoft.EntityFrameworkCore;
+using TrajetKmTracker.Api.Data;
+using TrajetKmTracker.Api.Models.DTOs;
+using TrajetKmTracker.Api.Models.Entities;
+using TrajetKmTracker.Api.Services.Exceptions;
+
+namespace TrajetKmTracker.Api.Services;
+
+/// <inheritdoc />
+public class ResumeService : IResumeService
+{
+    private const int MoisMin = 1;
+    private const int MoisMax = 12;
+    private const int AnneeMin = 2000;
+    private const int AnneeMax = 2100;
+
+    private readonly AppDbContext _context;
+
+    public ResumeService(AppDbContext context)
+    {
+        _context = context;
+    }
+
+    /// <inheritdoc />
+    public async Task<ResumeMensuelDto> GetResumeMensuelAsync(
+        int annee, int mois, int? vehiculeId = null, CancellationToken cancellationToken = default)
+    {
+        ValiderAnnee(annee);
+        ValiderMois(mois);
+
+        var trajets = await ChargerTrajetsDuMoisAsync(annee, mois, vehiculeId, cancellationToken);
+
+        return ConstruireResumeMensuel(annee, mois, trajets);
+    }
+
+    /// <inheritdoc />
+    public async Task<ResumeAnnuelDto> GetResumeAnnuelAsync(
+        int annee, int? vehiculeId = null, CancellationToken cancellationToken = default)
+    {
+        ValiderAnnee(annee);
+
+        // Charge une seule fois tous les trajets de l'année, puis répartit par mois.
+        var query = _context.Trajets
+            .AsNoTracking()
+            .Where(t => t.Date.Year == annee);
+
+        if (vehiculeId.HasValue)
+        {
+            query = query.Where(t => t.VehiculeId == vehiculeId.Value);
+        }
+
+        var trajetsAnnee = await query.ToListAsync(cancellationToken);
+
+        var resumesMensuels = new List<ResumeMensuelDto>(MoisMax);
+        for (var mois = MoisMin; mois <= MoisMax; mois++)
+        {
+            var trajetsDuMois = trajetsAnnee
+                .Where(t => t.Date.Month == mois)
+                .ToList();
+
+            resumesMensuels.Add(ConstruireResumeMensuel(annee, mois, trajetsDuMois));
+        }
+
+        // Total annuel = somme des 12 totaux mensuels (Exigences 4.3, 4.7, 6.6).
+        var totalAnnuel = Arrondir(resumesMensuels.Sum(r => r.TotalKm));
+
+        return new ResumeAnnuelDto(annee, resumesMensuels, totalAnnuel);
+    }
+
+    /// <summary>
+    /// Charge les Trajets d'un mois donné, filtrés éventuellement par véhicule, triés par
+    /// date croissante puis par Position croissante (Exigence 3.2).
+    /// </summary>
+    private async Task<List<Trajet>> ChargerTrajetsDuMoisAsync(
+        int annee, int mois, int? vehiculeId, CancellationToken cancellationToken)
+    {
+        var query = _context.Trajets
+            .AsNoTracking()
+            .Where(t => t.Date.Year == annee && t.Date.Month == mois);
+
+        if (vehiculeId.HasValue)
+        {
+            query = query.Where(t => t.VehiculeId == vehiculeId.Value);
+        }
+
+        // Tri par Position (decimal) non traduisible par SQLite : ordonnancement côté client.
+        var trajets = await query.ToListAsync(cancellationToken);
+        return trajets
+            .OrderBy(t => t.Date)
+            .ThenBy(t => t.Position)
+            .ToList();
+    }
+
+    /// <summary>
+    /// Construit un <see cref="ResumeMensuelDto"/> à partir d'une liste de Trajets déjà triée.
+    /// Le total est la somme des distances (null → 0) arrondie à 2 décimales (Property 1).
+    /// </summary>
+    private static ResumeMensuelDto ConstruireResumeMensuel(int annee, int mois, IReadOnlyList<Trajet> trajets)
+    {
+        var trajetsDto = trajets.Select(ToDto).ToList();
+        var totalKm = Arrondir(trajets.Sum(t => t.Distance ?? 0m));
+
+        return new ResumeMensuelDto(annee, mois, trajetsDto, totalKm);
+    }
+
+    private void ValiderMois(int mois)
+    {
+        if (mois < MoisMin || mois > MoisMax)
+        {
+            throw new ResumeParametreInvalideException(
+                $"Le mois doit être compris entre {MoisMin} et {MoisMax} inclus ; valeur reçue : {mois}.");
+        }
+    }
+
+    private void ValiderAnnee(int annee)
+    {
+        if (annee < AnneeMin || annee > AnneeMax)
+        {
+            throw new ResumeParametreInvalideException(
+                $"L'année doit être comprise entre {AnneeMin} et {AnneeMax} inclus ; valeur reçue : {annee}.");
+        }
+    }
+
+    private static decimal Arrondir(decimal valeur) =>
+        Math.Round(valeur, 2, MidpointRounding.AwayFromZero);
+
+    private static TrajetDto ToDto(Trajet t) =>
+        new(
+            t.Id,
+            t.Date,
+            t.AdresseDepart,
+            t.AdresseArrivee,
+            t.Distance,
+            t.Commentaire,
+            t.Position,
+            t.VehiculeId,
+            t.PuissanceFiscale);
+}