Renommage : TrajetKmTracker -> SchotzIadKmTracker (backend, specs, frontend)

- Backend : projets, solution, namespaces et références TrajetKmTracker.Api/.Tests -> SchotzIadKmTracker.Api/.Tests (dossiers, .csproj, .sln, .http, namespaces C#). GUID UserSecretsId préservé. - Specs : dossier .kiro/specs/trajet-km-tracker -> schotziad-km-tracker et mise à jour des références internes (chemins, tags de propriétés). - Frontend : projet Angular trajet-km-tracker -> schotziad-km-tracker (package.json, angular.json, chemin dist, Dockerfile), titre applicatif 'SchotzIAD KM Tracker'. - Docker et scripts (backend/Dockerfile, frontend/Dockerfile, run-dev.sh) mis à jour. - Suppression du fichier résiduel package.json.bak. Backend (solution) et frontend (build production) compilent sans erreur.
2026-09-14 07:50:26 +02:00
parent e3f946f7d4
commit 0e6a97ca61
133 changed files with 462 additions and 503 deletions
@@ -0,0 +1,68 @@
+using Microsoft.AspNetCore.Mvc;
+using SchotzIadKmTracker.Api.Models.DTOs;
+using SchotzIadKmTracker.Api.Services;
+using SchotzIadKmTracker.Api.Services.Exceptions;
+
+namespace SchotzIadKmTracker.Api.Controllers;
+
+/// <summary>
+/// Endpoints des résumés kilométriques : Résumé_Mensuel et Résumé_Annuel.
+/// Le filtre par véhicule est optionnel (Véhicule_Courant utilisé si omis).
+/// Les paramètres hors bornes (mois ∉ [1, 12], année ∉ [2000, 2100]) sont
+/// rejetés avec un code HTTP 400 (Exigences 3.6, 3.8, 4.1).
+/// </summary>
+[ApiController]
+[Route("api/resumes")]
+public class ResumesController : ControllerBase
+{
+    private readonly IResumeService _resumeService;
+
+    public ResumesController(IResumeService resumeService)
+    {
+        _resumeService = resumeService;
+    }
+
+    /// <summary>
+    /// Retourne le Résumé_Mensuel d'un (année, mois) pour le véhicule indiqué
+    /// (Véhicule_Courant si <paramref name="vehiculeId"/> est omis). Rejette (400)
+    /// les paramètres hors bornes (Exigences 3.6, 3.8).
+    /// </summary>
+    [HttpGet("mensuel/{annee:int}/{mois:int}")]
+    [ProducesResponseType(typeof(ResumeMensuelDto), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    public async Task<ActionResult<ResumeMensuelDto>> GetResumeMensuel(
+        int annee, int mois, [FromQuery] int? vehiculeId, CancellationToken cancellationToken)
+    {
+        try
+        {
+            var resume = await _resumeService.GetResumeMensuelAsync(annee, mois, vehiculeId, cancellationToken);
+            return Ok(resume);
+        }
+        catch (ResumeParametreInvalideException ex)
+        {
+            return Problem(detail: ex.Message, statusCode: StatusCodes.Status400BadRequest);
+        }
+    }
+
+    /// <summary>
+    /// Retourne le Résumé_Annuel d'une année (12 résumés mensuels) pour le véhicule
+    /// indiqué (Véhicule_Courant si <paramref name="vehiculeId"/> est omis). Rejette (400)
+    /// une année hors bornes (Exigences 3.6, 4.1).
+    /// </summary>
+    [HttpGet("annuel/{annee:int}")]
+    [ProducesResponseType(typeof(ResumeAnnuelDto), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    public async Task<ActionResult<ResumeAnnuelDto>> GetResumeAnnuel(
+        int annee, [FromQuery] int? vehiculeId, CancellationToken cancellationToken)
+    {
+        try
+        {
+            var resume = await _resumeService.GetResumeAnnuelAsync(annee, vehiculeId, cancellationToken);
+            return Ok(resume);
+        }
+        catch (ResumeParametreInvalideException ex)
+        {
+            return Problem(detail: ex.Message, statusCode: StatusCodes.Status400BadRequest);
+        }
+    }
+}