MadJax
0e6a97ca61
- 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.
37 lines
1.8 KiB
C#
37 lines
1.8 KiB
C#
using SchotzIadKmTracker.Api.Models.DTOs;
|
|
|
|
namespace SchotzIadKmTracker.Api.Services;
|
|
|
|
/// <summary>
|
|
/// Logique métier des Montant_Regle (montants effectivement versés, saisis par l'utilisateur)
|
|
/// et du Montant_Previsionnel (indication de versement à 80% du barème, purement informative).
|
|
/// </summary>
|
|
public interface IMontantRegleService
|
|
{
|
|
/// <summary>
|
|
/// Enregistre ou met à jour (upsert) le Montant_Regle pour un couple (année, mois, véhicule).
|
|
/// S'il existe déjà une ligne pour la même (Annee, Mois, VehiculeId), elle est mise à jour ;
|
|
/// sinon une nouvelle ligne est insérée (Property 26, Exigences 14.1/14.2/14.3).
|
|
/// Rejette un montant négatif via <see cref="Exceptions.MontantRegleNegatifException"/> (Exigence 14.4).
|
|
/// </summary>
|
|
Task<MontantRegleDto> UpsertMontantRegleAsync(
|
|
MontantRegleDto dto, CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>
|
|
/// Retourne les Montant_Regle saisis pour une (année, véhicule), triés par mois croissant.
|
|
/// Destiné au controller et au service de régularisation.
|
|
/// </summary>
|
|
Task<IReadOnlyList<MontantRegleDto>> GetMontantsReglesAsync(
|
|
int annee, int vehiculeId, CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>
|
|
/// Calcule le Montant_Previsionnel indicatif pour un (année, mois, véhicule) :
|
|
/// 80% du Bareme_Kilometrique plein appliqué au Total_Annuel_Partiel du véhicule
|
|
/// (somme des distances de l'année pour ce véhicule jusqu'au mois indiqué inclus),
|
|
/// arrondi à deux décimales (Property 23, Exigences 13.5/13.6).
|
|
/// Cette valeur est purement informative et n'entre jamais dans la régularisation.
|
|
/// </summary>
|
|
Task<MontantPrevisionnelDto> GetMontantPrevisionnelAsync(
|
|
int annee, int mois, int vehiculeId, CancellationToken cancellationToken = default);
|
|
}
|