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,86 @@
+using System.Globalization;
+using Microsoft.AspNetCore.Mvc;
+using SchotzIadKmTracker.Api.Models.DTOs;
+using SchotzIadKmTracker.Api.Services;
+
+namespace SchotzIadKmTracker.Api.Controllers;
+
+/// <summary>
+/// Endpoints de navigation temporelle et de totaux du Panneau_Totaux :
+/// années/mois/jours disponibles (périodes ayant des données) et totaux
+/// jour/mois/année partiel pour une date donnée (Exigences 12.15, 12.16).
+/// </summary>
+[ApiController]
+[Route("api")]
+public class NavigationController : ControllerBase
+{
+    private readonly ITotauxService _totauxService;
+
+    public NavigationController(ITotauxService totauxService)
+    {
+        _totauxService = totauxService;
+    }
+
+    /// <summary>
+    /// Retourne les années comportant au moins un Trajet, complétées par l'année
+    /// courante, triées croissantes (Exigence 12.15).
+    /// </summary>
+    [HttpGet("annees-disponibles")]
+    [ProducesResponseType(typeof(IReadOnlyList<int>), StatusCodes.Status200OK)]
+    public async Task<ActionResult<IReadOnlyList<int>>> GetAnneesDisponibles(
+        CancellationToken cancellationToken)
+    {
+        var annees = await _totauxService.GetAnneesDisponiblesAsync(cancellationToken);
+        return Ok(annees);
+    }
+
+    /// <summary>
+    /// Retourne les mois (1..12) de l'année comportant au moins un Trajet,
+    /// triés croissants (Exigence 12.16).
+    /// </summary>
+    [HttpGet("mois-disponibles/{annee:int}")]
+    [ProducesResponseType(typeof(IReadOnlyList<int>), StatusCodes.Status200OK)]
+    public async Task<ActionResult<IReadOnlyList<int>>> GetMoisDisponibles(
+        int annee, CancellationToken cancellationToken)
+    {
+        var mois = await _totauxService.GetMoisDisponiblesAsync(annee, cancellationToken);
+        return Ok(mois);
+    }
+
+    /// <summary>
+    /// Retourne les jours du mois de l'année comportant au moins un Trajet,
+    /// triés croissants (Exigence 12.16).
+    /// </summary>
+    [HttpGet("jours-disponibles/{annee:int}/{mois:int}")]
+    [ProducesResponseType(typeof(IReadOnlyList<int>), StatusCodes.Status200OK)]
+    public async Task<ActionResult<IReadOnlyList<int>>> GetJoursDisponibles(
+        int annee, int mois, CancellationToken cancellationToken)
+    {
+        var jours = await _totauxService.GetJoursDisponiblesAsync(annee, mois, cancellationToken);
+        return Ok(jours);
+    }
+
+    /// <summary>
+    /// Retourne les totaux jour/mois/année partiel du Panneau_Totaux pour la date
+    /// indiquée et le véhicule (Véhicule_Courant si <paramref name="vehiculeId"/> omis).
+    /// La date est attendue au format ISO <c>yyyy-MM-dd</c> ; un format invalide est
+    /// rejeté avec un code HTTP 400.
+    /// </summary>
+    [HttpGet("totaux/{date}")]
+    [ProducesResponseType(typeof(TotauxDto), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    public async Task<ActionResult<TotauxDto>> GetTotaux(
+        string date, [FromQuery] int? vehiculeId, CancellationToken cancellationToken)
+    {
+        if (!DateOnly.TryParseExact(date, "yyyy-MM-dd", CultureInfo.InvariantCulture,
+                DateTimeStyles.None, out var jour))
+        {
+            return Problem(
+                detail: $"La date '{date}' est invalide. Format attendu : yyyy-MM-dd.",
+                statusCode: StatusCodes.Status400BadRequest);
+        }
+
+        var totaux = await _totauxService.GetTotauxAsync(jour, vehiculeId, cancellationToken);
+        return Ok(totaux);
+    }
+}