MobileCitoyenExchange

Gestion de l'authentification — login, logout et changement de mot de passe.

Authentifie un utilisateur et retourne un token JWT.

Les identifiants de connexion (nom d'utilisateur et mot de passe). Un token JWT contenant les informations de l'utilisateur et ses rôles. Le token est valide pendant 20 minutes. Endpoint public — aucune authentification requise. Le token JWT retourné contient les claims suivants : - **NameIdentifier** : identifiant unique de l'utilisateur - **Name** : nom d'utilisateur - **Email** : adresse email - **GivenName** : prénom - **Surname** : nom de famille - **Gender** : sexe (M ou F) - **Role** : rôle(s) de l'utilisateur (Admin, RH, GrandCommis, Fonctionnaire) - **MinistereId** : identifiant du ministère (si applicable) - **SectionId** : identifiant de la section (si applicable) Après plusieurs tentatives infructueuses, le compte est temporairement verrouillé (protection anti-force-brute) et l'endpoint répond 423. Exemple de requête : POST /api/auth/login { "username": "votre_nom_utilisateur", "password": "votre_mot_de_passe" } Exemple de réponse : { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "expiration": "2024-01-15T10:20:00Z", "username": "jdupont", "prenom": "Jean", "nom": "Dupont", "sexe": "M", "email": "jdupont@mef.gouv.ht", "ministereId": "1112", "sectionId": "1112001", "roles": ["GrandCommis"] } Retourne le token JWT avec les informations de l'utilisateur. Le corps de la requête est invalide ou manquant. Nom d'utilisateur ou mot de passe incorrect. Compte temporairement verrouillé suite à trop de tentatives échouées.

Permet à un utilisateur authentifié de changer son mot de passe.

L'ancien mot de passe, le nouveau mot de passe et sa confirmation. Un message de confirmation si le changement a réussi. Endpoint privé — requiert un token JWT valide (tout rôle accepté). Règles de validation : - L'ancien mot de passe doit être correct - Le nouveau mot de passe doit contenir au moins 8 caractères - Le nouveau mot de passe et sa confirmation doivent être identiques - Le nouveau mot de passe ne peut pas être identique à l'ancien Exemple de requête : POST /api/auth/change-password Authorization: Bearer {token} { "currentPassword": "ancien_mot_de_passe", "newPassword": "nouveau_mot_de_passe", "confirmPassword": "nouveau_mot_de_passe" } Exemple de réponse : { "message": "Mot de passe modifié avec succès.", "reauthenticationRequired": true } Après un changement réussi, le jeton courant est invalidé (rotation du SecurityStamp) : le client doit se reconnecter pour obtenir un nouveau jeton. Mot de passe modifié avec succès. Validation échouée — ancien mot de passe incorrect, nouveau invalide ou confirmation non concordante. Token JWT manquant ou invalide.

Demande de réinitialisation : envoie un code à 6 chiffres par email.

Endpoint public. La réponse est toujours identique, que le compte existe ou non (on ne révèle jamais l'existence d'un email). Le code expire après quelques minutes.

Réinitialise le mot de passe à partir du code à 6 chiffres reçu par email.

cette méthode permet de récupérer la déclaration définitive d'impôt pour un contribuable donné (identifié par son NIF) et une année fiscale spécifique.

le NIF au format "XXX-XXX-XXX-X" où chaque "X" représente un chiffre. Par exemple, "003-456-789-0". L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024). retourne la liste des cheques emis pour le contribuable pendant l'année fiscale spécifiée. Si aucune déclaration n'est trouvée, elle retourne une réponse 404 Not Found. Sinon, elle retourne les données de la déclaration avec une réponse 200 OK. Endpoint privé — requiert le rôle **GrandCommis, Fonctionnaire ou RH**. Chaque utilisateur ne peut consulter que **sa propre** déclaration : le NIF demandé doit correspondre au NIF présent dans son jeton JWT, sinon la requête est refusée (403). Exemple de requête : GET /api/DeclarationDefinitiveImpot/003-456-789-0/2023-2024 Exemple de réponse : { "Nif": "003-456-789-0", "Nom": "Doe", "Prenom": "John", "NoCheque": "CHK-0001", "MontantBrut": 10000.00, "MontantFDU": 200.00, "MontantCAS": 150.00, "MontantPension": 300.00, "MontantCFGDCT": 50.00, "MontantAssurance": 75.00, "MontantISR": 1200.00, "MontantDGI": 100.00, "MontantNet": 8125.00, "AnneeFiscale": "2023-2024" } Retourne la déclaration définitive d'impôt pour le contribuable et l'année fiscale spécifiés. Le NIF et l'année fiscale sont requis. Le NIF demandé ne correspond pas à celui de l'utilisateur authentifié. Aucune déclaration définitive d'impôt trouvée pour le NIF et l'année fiscale spécifiés.

Gestion des dépenses budgétaires. Certains endpoints sont publics, d'autres requièrent le rôle GrandCommis.

Retourne le total global des dépenses pour une année fiscale.

L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024). Le montant total alloué et le montant total dépensé pour l'année fiscale, tous ministères confondus. Endpoint public — aucune authentification requise. Exemple de requête : GET /api/depense/total/2023-2024 Exemple de réponse : { "montantAlloue": 150000000.00, "montantDepense": 120000000.00 } Retourne le total global des dépenses. L'année fiscale est manquante ou invalide. Aucune dépense trouvée pour cette année fiscale.

Retourne les dépenses par article budgétaire pour un ministère donné.

L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024). L'identifiant du ministère sur 4 chiffres (ex: 1112). Une liste regroupant les dépenses du ministère par article budgétaire, avec les montants alloués, engagés et dépensés pour chaque article. Endpoint public — aucune authentification requise. Exemple de requête : GET /api/depense/ministere/2023-2024/1112 Retourne les dépenses groupées par article. L'année fiscale ou le ministère est manquant. Aucune dépense trouvée pour ce ministère et cette année fiscale.

Retourne le total des dépenses par article budgétaire pour une année fiscale.

L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024). Une liste des 9 articles budgétaires avec le total des montants alloués, engagés et dépensés sur l'ensemble des ministères. Endpoint public — aucune authentification requise. Les articles budgétaires sont : - 1 : Dépenses de personnel - 2 : Services et charges diverses - 3 : Achats de biens de consommation - 4 : Immobilisation corporelle - 5 : Immobilisation incorporelle - 6 : Prêts, avances et participations - 7 : Subventions et contributions - 8 : Amortissement de la dette - 9 : Autres dépenses publiques Exemple de requête : GET /api/depense/article/2023-2024 Retourne les dépenses groupées par article. L'année fiscale est manquante ou invalide. Aucune dépense trouvée pour cette année fiscale.

Retourne les dépenses mensuelles par période d'allocation pour une année fiscale.

L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024). Une liste de 13 périodes (Octobre → Septembre + Correction) avec les montants alloués, engagés et dépensés par mois. Endpoint public — aucune authentification requise. L'année fiscale haïtienne commence en Octobre et se termine en Septembre. La période "Correction" (13e mois) correspond aux ajustements de fin d'exercice. Exemple de requête : GET /api/depense/periode/allocation/2023-2024 Retourne les dépenses par période d'allocation. L'année fiscale est manquante ou invalide. Aucune dépense trouvée pour cette année fiscale.

Retourne les dépenses par alinéa budgétaire pour un ministère donné.

L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024). L'identifiant du ministère sur 4 chiffres (ex: 1112). Une liste regroupant les dépenses du ministère par alinéa budgétaire, avec les montants alloués, engagés et dépensés pour chaque alinéa. Endpoint privé — requiert le rôle **GrandCommis**. L'alinéa est le niveau de détail le plus fin de la nomenclature budgétaire, en dessous de l'article et du paragraphe. Exemple de requête : GET /api/depense/ministere/alinea/2023-2024/1112 Retourne les dépenses groupées par alinéa. L'année fiscale ou le ministère est manquant. Token d'authentification manquant ou invalide. L'utilisateur n'a pas le rôle GrandCommis, ou le ministère demandé n'est pas le sien. Aucune dépense trouvée pour ce ministère et cette année fiscale.

Retourne les dépenses par section et par article pour un ministère donné.

L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024). L'identifiant du ministère sur 4 chiffres (ex: 1112). Une structure hiérarchique : ministère → sections → articles, avec les montants alloués, engagés et dépensés à chaque niveau. Endpoint privé — requiert le rôle **GrandCommis**. Exemple de requête : GET /api/depense/ministere/section/2023-2024/1112 Retourne les dépenses groupées par section et article. L'année fiscale ou le ministère est manquant. Token d'authentification manquant ou invalide. L'utilisateur n'a pas le rôle GrandCommis, ou le ministère demandé n'est pas le sien. Aucune dépense trouvée pour ce ministère et cette année fiscale.

Analyse budgétaire en perspective — évolution sur plusieurs années fiscales. Certains endpoints sont publics, d'autres requièrent le rôle GrandCommis.

Retourne l'évolution globale du budget sur toutes les années fiscales disponibles.

Un objet contenant le nombre d'années fiscales analysées et la liste de l'évolution annuelle du budget (alloué, engagé, dépensé) tous ministères confondus. Endpoint public — aucune authentification requise. Exemple de requête : GET /api/perspective/annee/global Exemple de réponse : { "nombreAnneeFiscale": 3, "evolutionAnnuelle": [ { "anneeFiscale": "2021-2022", "nombreMinistere": 33, "totalMontantAlloue": 140000000.00, "totalMontantEngage": 130000000.00, "totalMontantDepense": 125000000.00 } ] } Retourne l'évolution globale du budget. Aucune donnée budgétaire trouvée.

Retourne l'évolution pluriannuelle du budget pour un article budgétaire donné.

L'identifiant de l'article budgétaire (1 seul caractère, de "1" à "9"). Un objet contenant l'identifiant et la désignation de l'article, ainsi que la liste de son évolution annuelle (alloué, engagé, dépensé). Endpoint public — aucune authentification requise. Les articles budgétaires valides sont : - "1" : Dépenses de personnel - "2" : Services et charges diverses - "3" : Achats de biens de consommation - "4" : Immobilisation corporelle - "5" : Immobilisation incorporelle - "6" : Prêts, avances et participations - "7" : Subventions et contributions - "8" : Amortissement de la dette - "9" : Autres dépenses publiques Exemple de requête : GET /api/perspective/article/1 Retourne l'évolution de l'article budgétaire. L'article est manquant ou invalide (doit être un seul caractère). Aucune donnée trouvée pour cet article.

Retourne l'évolution pluriannuelle du budget pour un ministère donné.

L'identifiant du ministère sur 4 chiffres (ex: 1112). Un objet contenant l'identifiant et la désignation du ministère, ainsi que la liste de son évolution annuelle (alloué, engagé, dépensé). Endpoint privé — requiert le rôle **GrandCommis**. Exemple de requête : GET /api/perspective/annee/1112 Retourne l'évolution annuelle du ministère. Le ministère est manquant. Token d'authentification manquant ou invalide. L'utilisateur n'a pas le rôle GrandCommis. Aucune donnée trouvée pour ce ministère.

Retourne l'évolution du budget d'un ministère pour une période mensuelle donnée, sur toutes les années fiscales disponibles.

L'identifiant du ministère sur 4 chiffres (ex: 1112). La période mensuelle (valeur entière correspondant à l'enum PeriodeFiscale) : 1=Octobre, 2=Novembre, 3=Décembre, 4=Janvier, 5=Février, 6=Mars, 7=Avril, 8=Mai, 9=Juin, 10=Juillet, 11=Août, 12=Septembre, 13=Correction. Un objet contenant l'identifiant et la désignation du ministère, ainsi que la liste des montants pour ce mois sur chaque année fiscale. Endpoint privé — requiert le rôle **GrandCommis**. Exemple de requête : GET /api/perspective/periode/1112/4 (Retourne les données du mois de Janvier pour le MEF sur toutes les années) Retourne l'évolution mensuelle du ministère. Le ministère est manquant ou la période est invalide. Token d'authentification manquant ou invalide. L'utilisateur n'a pas le rôle GrandCommis. Aucune donnée trouvée pour ce ministère et cette période.

Retourne l'évolution pluriannuelle du budget pour une section administrative donnée.

L'identifiant de la section sur 7 caractères (ex: 1112001). Un objet contenant l'identifiant et la désignation de la section, ainsi que la liste de son évolution annuelle (alloué, engagé, dépensé). Endpoint privé — requiert le rôle **GrandCommis**. Exemple de requête : GET /api/perspective/section/1112001 Retourne l'évolution annuelle de la section. La section est manquante ou n'a pas 7 caractères. Token d'authentification manquant ou invalide. L'utilisateur n'a pas le rôle GrandCommis. Aucune donnée trouvée pour cette section.

Gestion des projets d'investissement public par département géographique. Tous les endpoints sont publics — aucune authentification requise.

Retourne la liste des projets d'investissement pour un département géographique donné.

L'identifiant du département sur 2 chiffres (l'Id en base, pas le sigle ISO). Mapping Id → région : 00 = National, 01 = Ouest, 02 = Sud-Est, 03 = Nord, 04 = Centre, 05 = Artibonite, 06 = Sud, 07 = Nord-Est, 08 = Grande-Anse, 09 = Nord-Ouest, 10 = Nippes. L'année fiscale au format "YYYY-YYYY" ou toute autre chaîne identifiant l'exercice (ex: "2024-2025"). Un objet contenant les informations du département (identifiant, sigle, désignation), le nombre total de projets, et la liste détaillée de chaque projet avec son programme, sa commune, ses coordonnées GPS et son financement. Endpoint public — aucune authentification requise. Chaque projet retourné inclut : - Le programme auquel il appartient - La commune d'exécution - Les coordonnées GPS (latitude/longitude) si disponibles - Le financement (montant alloué, montant autorisé, bailleur) Exemple de requête : GET /api/projet/departement/01/2024-2025 Exemple de réponse : { "departementId": "01", "departementSigle": "DDO", "departementDesignation": "Ouest", "nombreProjets": 70, "projets": [ { "projetId": "PRJ-001", "projetDesignation": "Construction école nationale", "anneeFiscale": "2024-2025", "programme": { "id": "111200001", "designation": "Programme Éducation" }, "commune": { "id": "0101", "designation": "Port-au-Prince" }, "latitude": "18.5392", "longitude": "-72.3288", "financement": { "montantAlloue": 5000000.00, "montantAutorise": 4800000.00, "bailleur": { "id": "BM", "designation": "Banque Mondiale", "type": "International", "typeFinancement": "Don" } } } ] } Retourne la liste des projets du département. Le code département est manquant ou n'a pas 2 caractères. Aucun projet trouvé pour ce département.

Gestion des données de référence (années fiscales, ministères). Tous les endpoints sont publics — aucune authentification requise.

Retourne la liste de toutes les années fiscales disponibles.

Une liste d'années fiscales avec leur libellé et un indicateur précisant laquelle est l'année courante. Endpoint public — aucune authentification requise. Exemple de requête : GET /api/referentiel/annees-fiscales Exemple de réponse : [ { "anneeFiscale": "2023-2024", "labelFiscale": "Exercice 2023-2024", "isCurrent": true } ] Retourne la liste des années fiscales. Aucune année fiscale trouvée en base de données.

Retourne la liste des ministères actifs pour une année fiscale donnée.

L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024). Une liste de ministères avec leur identifiant et leur désignation. Endpoint public — aucune authentification requise. Exemple de requête : GET /api/referentiel/ministeres/2023-2024 Exemple de réponse : [ { "id": "1112", "designation": "MINISTÈRE DE L'ÉCONOMIE ET DES FINANCES" } ] Retourne la liste des ministères. L'année fiscale est manquante ou invalide. Aucun ministère trouvé pour cette année fiscale.

Retourne le nombre total de ministères pour une année fiscale donnée.

L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024). Un objet contenant le nombre total de ministères actifs. Endpoint public — aucune authentification requise. Exemple de requête : GET /api/referentiel/nombres/ministere/2023-2024 Exemple de réponse : { "totalMinistere": 33 } Retourne le nombre total de ministères. L'année fiscale est manquante ou invalide. Aucun ministère trouvé pour cette année fiscale.

Retourne la désignation d'un ministère à partir de son identifiant.

L'identifiant du ministère ex. "1311". Un objet contenant la désignation du ministère. Endpoint public — aucune authentification requise. Exemple de requête : GET /api/referentiel/ministere/designation/1311 Exemple de réponse : { "id": "1311", "designation": "Ministère de l'Éducation" } Retourne la désignation du ministère. L'identifiant du ministère est manquant ou invalide. Aucun ministère trouvé avec cet identifiant.

Gestion des utilisateurs : création, consultation et profil courant.

Crée un nouvel utilisateur selon les règles de délégation de rôles.

Liste les utilisateurs visibles par l'appelant (Admin ou RH).

- **Admin** : tous les utilisateurs, tous rôles et ministères confondus. - **RH** : uniquement les RH et Fonctionnaires de son propre ministère. Chaque élément retourné contient : - **id**, **userName** : identifiants de l'utilisateur - **nom**, **prenom**, **sexe**, **email**, **phoneNumber** : informations personnelles - **nif**, **ninu** : identifiants fiscaux/nationaux - **ministereId**, **sectionId** : rattachement organisationnel - **roles** : liste des rôles - **creationUser**, **creationDate** : auteur et date de création - **updateUser**, **updateDate** : auteur et date de dernière modification (null si jamais modifié) Exemple de réponse (200) — tableau d'utilisateurs : [ { "id": "6b66d73a-7bb6-40ee-b6bc-a9d40b8ca5ba", "nom": "Dupont", "prenom": "Jean", "sexe": "M", "email": "jdupont@mef.gouv.ht", "userName": "jdupont", "ministereId": "1112", "sectionId": "1112001", "phoneNumber": "34567890", "nif": "003-456-789-0", "ninu": "1234567890", "creationUser": "admin", "creationDate": "2026-01-15T10:20:00Z", "updateUser": "rh1112", "updateDate": "2026-08-24T09:00:00Z", "roles": ["Fonctionnaire"] } ]

Modifie partiellement un utilisateur (Admin ou RH). Les champs non fournis restent inchangés. Le rôle et les champs privilégiés (NIF, ministère, section) ne sont modifiables que par un Admin.

Sémantique PATCH : seuls les champs **fournis** (non null) sont appliqués ; les champs absents ou null restent inchangés. - **Champs personnels** (Admin et RH) : prenom, nom, sexe, email, phoneNumber, ninu - **Champs privilégiés** (Admin uniquement, sinon ignorés) : nif, ministerId, sectionId - **role** : soumis aux règles de délégation (Admin ne peut pas attribuer « Admin » ; RH ne peut attribuer que « Fonctionnaire ») Exemple de requête : PUT /api/user/6b66d73a-7bb6-40ee-b6bc-a9d40b8ca5ba Authorization: Bearer {token} { "prenom": "Jean-Marc", "phoneNumber": "34567891", "nif": "003-456-789-0" } Exemple de réponse (200) — l'utilisateur à jour : { "id": "6b66d73a-7bb6-40ee-b6bc-a9d40b8ca5ba", "nom": "Dupont", "prenom": "Jean-Marc", "sexe": "M", "email": "jdupont@mef.gouv.ht", "userName": "jdupont", "ministereId": "1112", "sectionId": "1112001", "phoneNumber": "34567891", "nif": "003-456-789-0", "ninu": "1234567890", "creationUser": "admin", "creationDate": "2026-01-15T10:20:00Z", "updateUser": "rh1112", "updateDate": "2026-09-08T14:30:00Z", "roles": ["Fonctionnaire"] } Retourne l'utilisateur mis à jour. Validation échouée (format d'un champ invalide, rôle interdit…). Token JWT manquant ou invalide. Droits insuffisants (RH ciblant hors de son ministère, etc.). Utilisateur introuvable.

Retourne les informations de profil de l'utilisateur authentifié.

Modèle pour le changement de mot de passe d'un utilisateur authentifié.

Mot de passe actuel de l'utilisateur.

Nouveau mot de passe souhaité.

Confirmation du nouveau mot de passe — doit être identique à NewPassword.

Informations retournées après la création réussie d'un utilisateur.

Demande de réinitialisation : l'email du compte.

Réinitialisation via le code à 6 chiffres reçu par email.

Modification partielle d'un utilisateur (sémantique PATCH). Tout champ laissé à null n'est pas modifié ; seuls les champs fournis sont appliqués. Le mot de passe n'est pas géré ici (voir /api/auth/change-password).

Représentation d'un utilisateur dans les listes administratives (endpoint GET /api/user).

Retourne l'année fiscale en cours au format "YYYY-YYYY" Exemple : "2024-2025" si nous sommes en octobre 2024

Lecture résiliente de fichiers CSV pour l'amorçage des données (seed). Principe : un fichier manquant, illisible ou une ligne invalide n'interrompt jamais le démarrage — l'incident est journalisé et le traitement continue avec les lignes valides.

Lit un CSV (chemin relatif au dossier de l'exécutable), ignore la ligne d'en-tête, puis mappe chaque ligne via . Les lignes vides ou invalides sont ignorées et journalisées.

Type d'entité produit par ligne. Chemin relatif, ex. "Data/Seed/ministeres.csv". Fonction de mapping colonnes -> entité. Journal pour tracer fichier manquant / lignes ignorées.

Découpe une ligne CSV en champs, en gérant les champs entre guillemets (qui peuvent contenir des virgules) et les guillemets échappés ("").

Contrat pour l'accès aux données de dépenses budgétaires. Regroupe les méthodes publiques et privées liées aux dépenses.

Retourne le total global des dépenses pour une année fiscale.

Retourne les dépenses par article budgétaire pour un ministère donné.

Retourne le total des dépenses par article budgétaire pour une année fiscale, tous ministères confondus.

Retourne les dépenses mensuelles par période d'allocation pour une année fiscale.

Retourne les dépenses par alinéa budgétaire pour un ministère donné. Accès restreint au rôle GrandCommis.

Retourne les dépenses par section et par article pour un ministère donné. Accès restreint au rôle GrandCommis.

Contrat pour l'accès aux données d'analyse budgétaire en perspective — évolution pluriannuelle du budget. Regroupe les méthodes publiques et privées liées aux perspectives.

Retourne l'évolution globale du budget sur toutes les années fiscales, tous ministères confondus.

Retourne l'évolution pluriannuelle du budget pour un article budgétaire donné.

Retourne l'évolution pluriannuelle du budget pour un ministère donné. Accès restreint au rôle GrandCommis.

Retourne l'évolution du budget d'un ministère pour une période mensuelle donnée, sur toutes les années fiscales disponibles. Accès restreint au rôle GrandCommis.

Retourne l'évolution pluriannuelle du budget pour une section administrative donnée. Accès restreint au rôle GrandCommis.

Contrat pour l'accès aux données des projets d'investissement public.

Retourne la liste des projets d'investissement pour un département géographique donné, avec les détails de financement et les coordonnées GPS de chaque projet.

Contrat pour l'accès aux données de référence : années fiscales, ministères et leurs totaux.

Retourne la liste de toutes les années fiscales disponibles.

Retourne la liste des ministères actifs pour une année fiscale donnée.

Retourne le nombre total de ministères pour une année fiscale donnée.

Logique métier des déclarations définitives d'impôt. Applique la règle d'accès (chacun ne consulte que sa propre déclaration) puis délègue la lecture au repository.

Retourne la déclaration définitive d'impôt du contribuable identifié par pour l'année fiscale donnée, à condition que le NIF corresponde à celui de l'utilisateur authentifié.

Logique métier des dépenses budgétaires. Valide les entrées, applique la règle d'accès des endpoints privés (un GrandCommis ne consulte que son propre ministère), puis délègue la lecture au repository.

Envoi d'emails transactionnels (réinitialisation de mot de passe, etc.).

Envoie un email HTML à un destinataire.

Logique métier de l'analyse budgétaire en perspective (évolution pluriannuelle). Valide les paramètres d'entrée puis délègue la lecture au repository.

Évolution globale du budget sur toutes les années fiscales.

Évolution pluriannuelle du budget pour un article budgétaire.

Évolution pluriannuelle du budget pour un ministère (GrandCommis).

Évolution mensuelle du budget d'un ministère pour une période (GrandCommis).

Évolution pluriannuelle du budget pour une section administrative (GrandCommis).

Logique métier des projets d'investissement public. Valide les paramètres d'entrée puis délègue la lecture au repository.

Retourne les projets d'investissement d'un département pour une année fiscale, après validation du code département et de l'année.

Logique métier liée aux utilisateurs : création avec règles de rôles, consultation filtrée et informations de l'utilisateur connecté. Le controller se contente d'appeler ces méthodes et de traduire le en réponse HTTP.

Crée un utilisateur en appliquant les règles de délégation : un Admin ne peut pas créer d'Admin ; un RH ne peut créer que des Fonctionnaires de son propre ministère.

Le principal de l'utilisateur authentifié qui effectue la création. Les données du nouvel utilisateur.

Retourne les utilisateurs visibles par l'appelant : tous pour un Admin, uniquement RH/Fonctionnaires de son ministère pour un RH.

Retourne les informations de profil de l'utilisateur authentifié.

Modifie partiellement un utilisateur (sémantique PATCH : seuls les champs fournis sont appliqués). Applique les mêmes règles de délégation que la création : un Admin modifie tout le monde (y compris les champs privilégiés NIF/Ministère/Section et le rôle) ; un RH ne modifie que les Fonctionnaires de son ministère, et uniquement les champs personnels.

Le principal de l'utilisateur authentifié qui effectue la modification. L'identifiant de l'utilisateur à modifier. Les champs à mettre à jour (les valeurs null sont ignorées).

Vérifie que le demandé correspond au ministère du jeton de l'appelant. Retourne un échec Forbidden si ce n'est pas le cas, ou null si l'accès est autorisé.

Implémentation via MailKit (client SMTP moderne). Compatible Gmail sur le port 587 avec STARTTLS. Remplace System.Net.Mail.SmtpClient, dont la validation TLS pose problème avec Gmail (RemoteCertificateNameMismatch).

Génère un mot de passe temporaire fort conforme à la politique.

Catégorie d'erreur métier retournée par la couche Service. Volontairement découplée du HTTP : c'est le controller qui traduit chaque catégorie en code de statut (400, 401, 403, ...).

Résultat d'une opération de service : soit une valeur en cas de succès, soit une catégorie d'erreur accompagnée de messages. Permet aux services de rester ignorants du pipeline HTTP tout en communiquant clairement l'issue au controller.

Traduit l'issue d'un en réponse HTTP. Centralise le mapping catégorie d'erreur métier → code de statut, pour éviter de le dupliquer dans chaque controller.

Paramètres SMTP liés à la section "Smtp" de la configuration. Les valeurs non sensibles (Host, Port, From…) sont dans appsettings.json ; User et Password sont des secrets (User Secrets en dev, variables d'environnement Smtp__User / Smtp__Password en prod).