Inventaire Complet des Routes Backend - DDD Module Paie

Date: 2026-06-04 Serveur: http://localhost:4000 (PORT=4000)

---

📊 Synthèse par Module

Module	Nombre de routes	Préfixe
Auth	22 routes	/api/auth
UserAdmin	11 routes	/api/admin/users
Roles	6 routes	/api/admin/roles
Employes	15 routes	/api/v1/paie/employes
Bulletins	12 routes	/api/v1/paie/bulletins
Declarations	5 routes	/api/v1/paie/declarations
Rapports	4 routes	/api/v1/paie/rapports
Configuration	17 routes	/api/v1/paie/configuration
Administration	12 routes	/api/v1/paie/administration
Audit Référentiel	8 routes	/api/admin/audit

Total: 92 routes

---

🔐 Module AUTH (/api/auth)

Authentification de base

Méthode	Endpoint	Handler	Public	Description
POST	/connexion	connexion	✅	Connexion utilisateur
POST	/register	inscription	✅	Inscription nouvel utilisateur
POST	/logout	deconnexion	❌	Déconnexion utilisateur
POST	/refresh	refreshToken	✅	Rafraîchir le token d'accès
POST	/verify-email	verifierEmail	✅	Vérifier l'email avec un code
POST	/verify-email-change	verifierNouvelEmail	❌	Vérifier le changement d'email
POST	/change-email	changerEmail	❌	Demander un changement d'email

Two-Factor Authentication (2FA)

Méthode	Endpoint	Handler	Public	Description
POST	/2fa/generate-secret	generer2FASecret	❌	Générer un secret 2FA avec QR code
POST	/2fa/activate	activer2FA	❌	Activer l'authentification 2FA
POST	/2fa/verify	verifier2FA	✅	Vérifier un code 2FA
POST	/2fa/deactivate	desactiver2FA	❌	Désactiver l'authentification 2FA
POST	/2fa/backup-codes/generate	genererBackupCodes	❌	Générer des codes de récupération
POST	/2fa/backup-codes/verify	verifierBackupCode	✅	Vérifier un code de récupération
POST	/2fa/backup-codes/revoke	revoquerCodesRecuperation	❌	Révoquer tous les codes de récupération

Gestion des mots de passe

Méthode	Endpoint	Handler	Public	Description
PUT	/change-password	changerMotDePasse	❌	Changer le mot de passe
POST	/reset-password/request	demanderResetPassword	✅	Demander une réinitialisation
POST	/reset-password/verify	verifierTokenReset	✅	Vérifier la validité d'un token
POST	/reset-password/confirm	resetPassword	✅	Confirmer la réinitialisation

Gestion des sessions

Méthode	Endpoint	Handler	Public	Description
GET	/sessions	listerSessionsActives	❌	Lister les sessions actives
GET	/sessions/events	obtenirHistoriqueSession	❌	Obtenir l'historique des événements
DELETE	/sessions/:idSession	revoquerSession	❌	Révoquer une session spécifique
POST	/sessions/revoke-all	revoquerToutesSessions	❌	Révoquer toutes les sessions

Gestion des tokens

Méthode	Endpoint	Handler	Public	Description
POST	/tokens/validate	validerAccessToken	✅	Valider un access token
POST	/tokens/revoke	revoquerToken	❌	Révoquer un token spécifique
POST	/tokens/revoke-all	revoquerTousTokens	❌	Révoquer tous les tokens

Profil et paramètres

Méthode	Endpoint	Handler	Public	Description
GET	/profile	obtenirProfil	❌	Obtenir le profil connecté
PUT	/profile	modifierProfil	❌	Modifier le profil connecté
GET	/parametres/:idUtilisateur	obtenirParametres	❌	Obtenir les paramètres de sécurité
DELETE	/delete-account	supprimerCompte	❌	Supprimer le compte utilisateur
GET	/history	obtenirHistorique	❌	Obtenir l'historique utilisateur

Sécurité et administration

Méthode	Endpoint	Handler	Public	Description
POST	/security/block-ip	bloquerIP	❌	Bloquer une adresse IP (admin)
POST	/security/unblock-ip	debloquerIP	❌	Débloquer une adresse IP (admin)
GET	/security/logs	obtenirLogsSecurite	❌	Obtenir les logs de sécurité
GET	/security/suspicious-connections	detecterConnexionsSuspectes	❌	Détecter les connexions suspectes

---

👥 Module USERADMIN (/api/admin/users)

Méthode	Endpoint	Handler	Description
GET	/stats	obtenirStatistiques	Statistiques des utilisateurs
GET	/export	exporterUtilisateurs	Export CSV/JSON
GET	/	listerUtilisateurs	Liste avec filtres et pagination
POST	/	creerUtilisateur	Créer un nouvel utilisateur
GET	/:id	obtenirUtilisateur	Détails d'un utilisateur
PUT	/:id	mettreAJourUtilisateur	Mettre à jour un utilisateur
DELETE	/:id	supprimerUtilisateur	Suppression soft delete
POST	/:id/change-role	changerRole	Changer le rôle d'un utilisateur
POST	/:id/lock	verrouillerCompte	Verrouiller un compte
DELETE	/:id/lock	deverrouillerCompte	Déverrouiller un compte
POST	/:id/toggle-active	basculerActivation	Activer/désactiver utilisateur

---

🔑 Module ROLES (/api/admin/roles)

Méthode	Endpoint	Handler	Description
GET	/:idRole/permissions	listerPermissions	Permissions d'un rôle
PUT	/:idRole/permissions	assignerPermissions	Assigner des permissions
GET	/	listerRoles	Lister tous les rôles
POST	/	creerRole	Créer un nouveau rôle
GET	/:idRole	obtenirRole	Détails d'un rôle
PATCH	/:idRole	modifierRole	Modifier un rôle
DELETE	/:idRole	supprimerRole	Supprimer un rôle

---

👷 Module EMPLOYES (/api/v1/paie/employes)

Méthode	Endpoint	Handler	Description
GET	/	lister	Lister les employés (filtre: actif, fonction, recherche)
POST	/	creer	Créer un employé
POST	/importer	importer	Import CSV en masse
POST	/importer-excel	importerExcel	Import Excel
GET	/template-excel	templateExcel	Télécharger template Excel
GET	/:id	obtenir	Détails d'un employé
PUT	/:id	modifier	Modifier un employé
DELETE	/:id/definitif	supprimerDefinitivement	Suppression définitive
DELETE	/:id	desactiver	Désactiver (soft delete)
GET	/:id/primes	listerPrimes	Lister les primes d'un employé
POST	/:id/primes	attribuerPrime	Attribuer une prime
PUT	/:id/primes/:idAttribution	modifierAttribution	Modifier une attribution
DELETE	/:id/primes/:idAttribution/suspendre	suspendreAttribution	Suspendre une attribution
GET	/:id/oppositions	listerOppositions	Lister oppositions
POST	/:id/oppositions	creerOpposition	Créer une opposition
PUT	/:id/oppositions/:idOpposition	modifierOpposition	Modifier une opposition
DELETE	/:id/oppositions/:idOpposition	desactiverOpposition	Désactiver une opposition
POST	/:id/lier-compte	lierCompte	Lier compte utilisateur à employé

---

💰 Module BULLETINS (/api/v1/paie/bulletins)

Méthode	Endpoint	Handler	Description
GET	/	lister	Lister les bulletins par période
POST	/	creer	Générer un bulletin individuel
POST	/masse	lancerGenerationMasse	Génération en masse (BullMQ)
PATCH	/masse/statut	changerStatutMasse	Valider ou marquer payés (période)
GET	/tableau/:annee/:mois	tableau	Tableau état rémunération
GET	/jobs/:jobId	obtenirStatutJob	Suivi job génération masse
GET	/:id/telecharger	telecharger	Télécharger fiche paie DOCX
GET	/espace-salarie/mes-bulletins	listerMesBulletins	Espace salarié
GET	/espace-salarie/mes-bulletins/:id	obtenirMonBulletin	Détails salarié
GET	/espace-salarie/mes-bulletins/:id/telecharger	telechargerMonBulletinPDF	Téléchargement PDF salarié
GET	/espace-salarie/mon-profil	obtenirMonProfil	Profil employé salarié
DELETE	/:id	supprimer	Supprimer bulletin (statuts limités)
GET	/:id	obtenir	Détails bulletin par ID
PATCH	/:id/statut	changerStatut	Changer le statut

---

📋 Module DECLARATIONS (/api/v1/paie/declarations)

Méthode	Endpoint	Handler	Description
GET	/	listerDeclarations	Lister toutes les déclarations
GET	/cnss/:annee/:mois	declarationCNSS	Générer/obtenir déclaration CNSS
GET	/its/:annee/:mois	declarationITS	Générer/obtenir déclaration ITS
POST	/cnss/:annee/:mois/valider	validerDeclarationCNSS	Valider déclaration CNSS
POST	/its/:annee/:mois/valider	validerDeclarationITS	Valider déclaration ITS
POST	/:idDeclaration/transmis	marquerTransmis	Marquer comme transmis

---

📊 Module RAPPORTS (/api/v1/paie/rapports)

Méthode	Endpoint	Handler	Description
GET	/livre-paie/:annee/:mois	livrePaie	Générer le livre de paie
GET	/export-comptable/:annee/:mois	exportComptable	Export comptable SYSCOHADA
GET	/audit	audit	Rapport d'audit des opérations
GET	/etat-remuneration/:annee/:mois	etatRemunerationXlsx	Export état rémunération XLSX

---

⚙️ Module CONFIGURATION (/api/v1/paie/configuration)

Méthode	Endpoint	Handler	Description
GET	/theme	obtenirTheme	Obtenir le thème actif
PUT	/theme	sauvegarderTheme	Sauvegarder le thème
GET	/primes/templates	listerTemplatesPrimes	Lister templates de primes
POST	/primes/templates	creerTemplatePrime	Créer un template
PUT	/primes/templates/:id	modifierTemplatePrime	Modifier un template
DELETE	/primes/templates/:id	desactiverTemplatePrime	Désactiver un template
GET	/taxes	listerTaxes	Lister taxes temporaires
POST	/taxes	creerTaxe	Créer une taxe
PUT	/taxes/:id	modifierTaxe	Modifier une taxe
DELETE	/taxes/:id	desactiverTaxe	Désactiver une taxe
PUT	/parametres/:id	modifierParametre	Modifier un paramètre
GET	/parametres	listerParametres	Lister paramètres système
POST	/parametres	creerParametre	Créer un paramètre
GET	/regles	listerRegles	Lister règles de calcul
POST	/regles	creerRegle	Créer une règle
GET	/cnss	listerConfigsCNSS	Lister configs CNSS
POST	/cnss	creerConfigCNSS	Créer une config CNSS
GET	/its	listerConfigsITS	Lister configs ITS
POST	/its	creerConfigITS	Créer une config ITS
PUT	/its/:id	modifierConfigITS	Modifier un barème ITS
GET	/vps	listerConfigsVPS	Lister configs VPS
POST	/vps	creerConfigVPS	Créer une config VPS
GET	/:annee/:mois	obtenirConfigPeriode	Config active pour une période

---

🏢 Module ADMINISTRATION (/api/v1/paie/administration)

Méthode	Endpoint	Handler	Description
GET	/projets	listerProjets	Lister les projets
POST	/projets	creerProjet	Créer un projet
GET	/projets/:id	obtenirProjet	Détails d'un projet
PUT	/projets/:id	modifierProjet	Modifier un projet
DELETE	/projets/:id	desactiverProjet	Désactiver un projet
PATCH	/projets/:id/reactiver	reactiverProjet	Réactiver un projet
POST	/projets/:id/affecter	affecterEmploye	Affecter un employé
DELETE	/projets/:id/retirer/:idEmploye	retirerEmploye	Retirer un employé
POST	/archiver	archiverPeriodeHandler	Archiver une période
GET	/archives	listerArchives	Lister les archives
POST	/exporter-comptable	exporterEcrituresComptables	Exporter écritures SYSCOHADA
GET	/exports	listerExports	Lister les exports
GET	/organisation/moi	obtenirOrganisation	Obtenir mon organisation
PUT	/organisation/moi	mettreAJourOrganisation	Créer/mettre à jour organisation

---

📜 Audit Référentiel (/api/admin/audit)

Méthode	Endpoint	Description
GET	/actions	Liste toutes les actions
POST	/actions	Crée une action (niveau ≤ 2)
PUT	/actions/:id	Modifie une action
DELETE	/actions/:id	Supprime une action
GET	/ressources	Liste toutes les ressources
POST	/ressources	Crée une ressource
PUT	/ressources/:id	Modifie une ressource
DELETE	/ressources/:id	Supprime une ressource

---

🔒 Middlewares Appliqués

• Rate Limiting: rateLimiterGlobal (sur /api/), rateLimiterAuth (sur /api/auth/), rateLimiterMasse (sur /api/v1/paie/bulletins/masse)
• Sécurité: helmetMiddleware, hppMiddleware
• Authentification: authentificationMiddleware() (presque toutes les routes sauf register, connexion, refresh, verify-email, tokens/validate)

---

🔌 Points d'entrée serveur

• Health check: GET / ou GET /health
• Debug routes: GET /_debug/routes (dev uniquement)