API Rôles et Permissions

L'API Rôles gère les rôles utilisateurs et leurs permissions associées.

Vue d'ensemble

Endpoint	Méthode	Description
/api/roles	GET	Liste des rôles
/api/roles	POST	Créer un rôle
/api/roles/{id}	GET	Détail d'un rôle
/api/roles/{id}	PUT/PATCH	Modifier un rôle
/api/roles/{id}	DELETE	Supprimer un rôle
/api/roles/{id}/permissions	PUT	Modifier les permissions

Structure d'un rôle

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "nom": "Spécialiste Transferts Monétaires",
  "code": "ROLE_TM_SPECIALIST",
  "description": "Gestion des cycles de paiement et suivi des transferts",
  "permissions": [
    "transferts.cycles_view",
    "transferts.cycles_create",
    "transferts.paiements_view",
    "transferts.paiements_export"
  ],
  "isActive": true,
  "isSystem": false,
  "usersCount": 12,
  "createdAt": "2025-01-01T00:00:00+00:00"
}

Rôles système (non modifiables)

Code	Description
ROLE_ADMIN	Administrateur système - accès complet
ROLE_COORDINATEUR	Coordinateur national
ROLE_USER	Utilisateur de base

Format des permissions

Les permissions suivent le format module.action :

registre.menages_view      # Voir les ménages
registre.menages_edit      # Modifier les ménages
transferts.cycles_create   # Créer des cycles
plaintes.assign            # Assigner des plaintes
admin.settings             # Accéder aux paramètres

Modules disponibles

Module	Description
registre	Ménages, bénéficiaires, membres
transferts	Cycles, paiements, réconciliation
plaintes	Gestion des plaintes
geo	Données géographiques
admin	Administration système
rapports	Génération de rapports