Files
SchotzIAD/backend/TrajetKmTracker.Api/Repositories/IVehiculeRepository.cs
T
MadJax e3f946f7d4 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

36 lines
1.7 KiB
C#

using TrajetKmTracker.Api.Models.Entities;
namespace TrajetKmTracker.Api.Repositories;
/// <summary>
/// Accès aux données des véhicules et aux trajets impactés par une réaffectation.
/// L'historique des véhicules est conservé (aucune suppression) — Exigence 10.12 / Property 22.
/// </summary>
public interface IVehiculeRepository
{
/// <summary>Retourne l'historique complet des véhicules, trié par Date_Effet décroissante puis Id décroissant.</summary>
Task<List<Vehicule>> GetHistoriqueAsync(CancellationToken cancellationToken = default);
/// <summary>Retourne le véhicule par identifiant, ou <c>null</c> s'il n'existe pas.</summary>
Task<Vehicule?> GetByIdAsync(int id, CancellationToken cancellationToken = default);
/// <summary>
/// Résout le véhicule courant à une date donnée : Date_Effet la plus récente parmi
/// celles &lt;= <paramref name="date"/> (ORDER BY DateEffet DESC, Id DESC LIMIT 1).
/// Retourne <c>null</c> si aucun véhicule n'a de Date_Effet &lt;= <paramref name="date"/>.
/// </summary>
Task<Vehicule?> GetVehiculeCourantAsync(DateOnly date, CancellationToken cancellationToken = default);
/// <summary>Ajoute un nouveau véhicule (sans persister). L'appelant gère la transaction.</summary>
Task AddAsync(Vehicule vehicule, CancellationToken cancellationToken = default);
/// <summary>
/// Retourne les trajets dont la Date est &gt;= <paramref name="dateEffet"/> et dont la
/// PuissanceFiscale diffère de <paramref name="puissanceFiscale"/> (candidats à la réaffectation).
/// </summary>
Task<List<Trajet>> GetTrajetsAReaffecterAsync(
DateOnly dateEffet,
int puissanceFiscale,
CancellationToken cancellationToken = default);
}