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,88 @@
+using Microsoft.AspNetCore.Mvc;
+using TrajetKmTracker.Api.Models.DTOs;
+using TrajetKmTracker.Api.Services;
+using TrajetKmTracker.Api.Services.Exceptions;
+
+namespace TrajetKmTracker.Api.Controllers;
+
+/// <summary>
+/// Endpoints de gestion des véhicules : historique, véhicule courant, création et réaffectation.
+/// </summary>
+[ApiController]
+[Route("api/vehicules")]
+public class VehiculesController : ControllerBase
+{
+    private readonly IVehiculeService _vehiculeService;
+
+    public VehiculesController(IVehiculeService vehiculeService)
+    {
+        _vehiculeService = vehiculeService;
+    }
+
+    /// <summary>Historique complet des véhicules (trié par date d'effet décroissante).</summary>
+    [HttpGet]
+    [ProducesResponseType(typeof(IReadOnlyList<VehiculeDto>), StatusCodes.Status200OK)]
+    public async Task<ActionResult<IReadOnlyList<VehiculeDto>>> GetHistorique(CancellationToken cancellationToken)
+    {
+        var vehicules = await _vehiculeService.GetHistoriqueAsync(cancellationToken);
+        return Ok(vehicules);
+    }
+
+    /// <summary>Véhicule courant (date d'effet la plus récente ≤ aujourd'hui).</summary>
+    [HttpGet("courant")]
+    [ProducesResponseType(typeof(VehiculeDto), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<VehiculeDto>> GetCourant(CancellationToken cancellationToken)
+    {
+        try
+        {
+            var vehicule = await _vehiculeService.GetVehiculeCourantAsync(cancellationToken);
+            return Ok(vehicule);
+        }
+        catch (VehiculeNotFoundException ex)
+        {
+            return Problem(detail: ex.Message, statusCode: StatusCodes.Status404NotFound);
+        }
+    }
+
+    /// <summary>
+    /// Enregistre un véhicule. Retourne <see cref="VehiculeCreeDto"/> indiquant si une réaffectation
+    /// des trajets doit être proposée. Rejette une date d'effet future (400).
+    /// </summary>
+    [HttpPost]
+    [ProducesResponseType(typeof(VehiculeCreeDto), StatusCodes.Status201Created)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    public async Task<ActionResult<VehiculeCreeDto>> Create(
+        [FromBody] CreateVehiculeDto dto,
+        CancellationToken cancellationToken)
+    {
+        try
+        {
+            var resultat = await _vehiculeService.CreateAsync(dto, cancellationToken);
+            return CreatedAtAction(nameof(GetHistorique), null, resultat);
+        }
+        catch (DateEffetFutureException ex)
+        {
+            return Problem(detail: ex.Message, statusCode: StatusCodes.Status400BadRequest);
+        }
+    }
+
+    /// <summary>Accepte ou refuse la réaffectation des trajets au véhicule indiqué.</summary>
+    [HttpPost("reaffectation")]
+    [ProducesResponseType(StatusCodes.Status204NoContent)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    public async Task<IActionResult> Reaffecter(
+        [FromBody] ReaffectationDto dto,
+        CancellationToken cancellationToken)
+    {
+        try
+        {
+            await _vehiculeService.ReaffecterAsync(dto, cancellationToken);
+            return NoContent();
+        }
+        catch (VehiculeNotFoundException ex)
+        {
+            return Problem(detail: ex.Message, statusCode: StatusCodes.Status404NotFound);
+        }
+    }
+}