> ## Documentation Index
> Fetch the complete documentation index at: https://help.agatabo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Utilisateurs & Membres

> Gestion de tous les utilisateurs de la tontine - les membres qui participent à l'épargne/aux prêts et le personnel qui exploite le système

## Comprendre les Utilisateurs de la Tontine

Votre tontine compte deux types de personnes ayant accès à Agatabo :

1. **Membres** - Personnes qui épargnent et peuvent contracter des prêts (les participants principaux)
2. **Personnel** - Personnes qui exploitent le système (trésoriers, comptables, administrateurs) sans nécessairement épargner ou emprunter

Les deux sont des "utilisateurs" dans le système, mais ils ont des rôles et des autorisations différents.

## Utilisateur vs Membre

<Tabs>
  <Tab title="Utilisateur (Général)">
    **Toute personne disposant d'identifiants de connexion à votre tontine**

    * Dispose d'identifiants de connexion (e-mail ou numéro de téléphone)
    * A un ou plusieurs rôles attribués
    * Peut se connecter et effectuer les actions autorisées
    * Peut ou non être membre
    * L'e-mail est optionnel ; le numéro de téléphone est obligatoire

    **Exemples** : Trésorier, Comptable, Administrateur, Responsable des Prêts, Gestionnaire, Membre
  </Tab>

  <Tab title="Membre (Spécifique)">
    **Un utilisateur qui participe à l'épargne et aux prêts**

    * A le rôle "Membre" attribué
    * Cotise en épargne à la tontine
    * Peut demander et recevoir des prêts
    * Dispose d'un compte de grand livre d'épargne
    * Reçoit des dividendes lors de leur distribution
    * Peut également avoir d'autres rôles (ex. : Trésorier + Membre)

    **Point clé** : Tous les membres sont des utilisateurs, mais tous les utilisateurs ne sont pas membres. Votre trésorier pourrait être uniquement du personnel (non membre), ou à la fois personnel ET membre.
  </Tab>
</Tabs>

## Cycle de Vie d'un Utilisateur

<Steps>
  <Step title="Invitation">
    L'administrateur crée l'utilisateur et envoie une invitation (par e-mail, SMS ou partage manuel du lien)
  </Step>

  <Step title="Activation du Compte">
    La personne clique sur le lien d'activation et définit son mot de passe
  </Step>

  <Step title="Utilisateur Actif">
    Peut se connecter avec son e-mail ou numéro de téléphone et effectuer les tâches assignées
  </Step>

  <Step title="Mise à Jour des Rôles">
    L'administrateur ajoute/supprime des rôles selon les besoins
  </Step>

  <Step title="Désactivation (optionnelle)">
    L'utilisateur quitte la tontine, le compte est désactivé
  </Step>
</Steps>

## Opérations Courantes

<CardGroup cols={2}>
  <Card title="Invitation des Utilisateurs" icon="user-plus" href="/fr/tontines/organization-users/inviting-users">
    Ajouter de nouveaux membres ou du personnel à votre tontine
  </Card>

  <Card title="Gestion des Utilisateurs" icon="users-gear" href="/fr/tontines/organization-users/managing-users">
    Modifier les informations, désactiver les comptes, mettre à jour les rôles
  </Card>

  <Card title="Rôles & Autorisations" icon="user-tag" href="/fr/tontines/organization-users/roles">
    Comprendre les rôles et ce que chacun peut faire
  </Card>

  <Card title="Consulter les Détails d'un Utilisateur" icon="address-card" href="/fr/tontines/organization-users/viewing-member-details">
    Accéder aux profils et à l'historique des comptes
  </Card>
</CardGroup>

## Rôles par Défaut

Votre tontine dispose de deux rôles par défaut :

| Rôle               | Objectif            | Autorisations Typiques                                          |
| ------------------ | ------------------- | --------------------------------------------------------------- |
| **Membre**         | Épargne et emprunte | Consulter sa propre épargne, consulter ses propres prêts        |
| **Administrateur** | Gère le système     | Toutes les autorisations, y compris la gestion des utilisateurs |

Les administrateurs peuvent créer des rôles personnalisés supplémentaires selon les besoins (Trésorier, Comptable, Responsable des Prêts, Gestionnaire, etc.) avec des autorisations spécifiques configurées par rôle.

<Note>
  **Cas courant** : Dans de nombreuses tontines, le trésorier et le comptable sont également membres (ils épargnent et empruntent). Dans ce cas, ils auraient plusieurs rôles attribués : "Membre + Trésorier" ou "Membre + Comptable". D'autres tontines embauchent du personnel qui N'EST PAS membre - ils gèrent simplement le système.
</Note>

## Informations de l'Utilisateur de l'Organisation

### Informations de Base

* **Nom** : Nom complet (champ unique)
* **Numéro de Compte** : Identifiant unique généré automatiquement
* **E-mail** : Optionnel - utilisé pour la connexion et les notifications si fourni
* **Téléphone** : Obligatoire - numéro de mobile pour les notifications SMS
* **Date d'Adhésion** : Date à laquelle l'utilisateur a rejoint l'organisation

### Informations Financières (pour les Membres)

* **Solde d'Épargne** : Total des dépôts moins les retraits
* **Prêts Actifs** : Prêts en cours
* **Historique des Prêts** : Prêts passés et statut de remboursement
* **Frais d'Adhésion** : Frais d'inscription et paiements
* **Allocations de Dividendes** : Part des bénéfices distribués

## Statut de l'Utilisateur

| Statut      | Signification    | Peut se Connecter ?            | Peut Accéder à l'Organisation ? |
| ----------- | ---------------- | ------------------------------ | ------------------------------- |
| **Actif**   | Compte activé    | ✅ Oui (si mot de passe défini) | ✅ Oui                           |
| **Inactif** | Compte désactivé | ✅ Oui (si mot de passe défini) | ❌ Non (autorisations refusées)  |

<Note>
  **Fonctionnement :**

  * Un utilisateur inactif peut techniquement se connecter mais ne pourra accéder à aucune fonctionnalité de l'organisation
  * Les autorisations ne sont résolues que pour les utilisateurs actifs (`isActive = true`)
  * Pour empêcher tout accès, désactivez l'utilisateur de l'organisation

  **Statut d'invitation :** Suivi séparément avec les valeurs `PENDING`, `ACCEPTED`, `REVOKED`
</Note>

## Système d'Autorisations

Agatabo utilise le **contrôle d'accès basé sur les rôles** (RBAC) :

### Format des Autorisations

Les autorisations utilisent le format : `ressource:action`

**Exemples** :

* `organization_users:read` - Peut consulter les utilisateurs de l'organisation
* `organization_users:write` - Peut créer/modifier les utilisateurs de l'organisation
* `savings:read` - Peut consulter les données d'épargne
* `savings:write` - Peut enregistrer des dépôts
* `loans:read` - Peut consulter les prêts
* `loans:write` - Peut créer des prêts

### Portées des Autorisations

Chaque autorisation peut être limitée pour contrôler le niveau d'accès :

**Portée PROPRE** : L'utilisateur ne peut accéder qu'à ses propres données

* Un membre avec `savings:read` (portée PROPRE) ne peut consulter que sa propre épargne

**Portée TOUTE** : L'utilisateur peut accéder à toutes les données de l'organisation

* Un trésorier avec `savings:write` (portée TOUTE) peut enregistrer des dépôts pour n'importe quel membre

## Bonnes Pratiques de Gestion des Membres

<Note>
  **Conseils de gestion des utilisateurs :**

  * Vérifiez les numéros de téléphone avant d'envoyer les invitations (le téléphone est obligatoire)
  * L'e-mail est optionnel mais recommandé pour la connexion et les notifications
  * Attribuez le minimum d'autorisations nécessaires (principe du moindre privilège)
  * Révisez les autorisations des utilisateurs trimestriellement
  * Désactivez immédiatement les anciens membres du personnel
  * Utilisez des conventions de nommage cohérentes
  * Notez que le Nom, le Téléphone et l'E-mail ne peuvent pas être facilement modifiés après la création
</Note>

## Scénarios Courants

### Ajout d'un Nouvel Utilisateur de l'Organisation

<Steps>
  <Step title="Collecter les informations de l'utilisateur">
    Nom, téléphone (obligatoire), e-mail (optionnel), date d'adhésion
  </Step>

  <Step title="Ajouter dans Agatabo">
    Utilisateurs de l'Organisation → Cliquez sur "Ajouter un Utilisateur de l'Organisation"
  </Step>

  <Step title="Remplir le formulaire">
    Complétez les champs Nom, Date d'Adhésion, Téléphone et E-mail optionnel
  </Step>

  <Step title="Choisir l'option d'invitation">
    Activez/désactivez "Envoyer une Invitation" (envoie une invitation par e-mail ou SMS)
  </Step>

  <Step title="L'utilisateur active son compte">
    L'utilisateur clique sur le lien d'invitation, définit son mot de passe et est automatiquement connecté
  </Step>

  <Step title="Attribuer des rôles">
    Après la création, accédez à l'onglet Rôles de l'utilisateur pour attribuer le rôle membre ou autre
  </Step>
</Steps>

### Ajout d'un Rôle à un Utilisateur Existant

<Steps>
  <Step title="Accéder aux Utilisateurs de l'Organisation">
    Trouver l'utilisateur
  </Step>

  <Step title="Cliquer sur le nom de l'utilisateur">
    Ouvre les détails de l'utilisateur
  </Step>

  <Step title="Aller à l'onglet Rôles">
    Cliquez sur l'onglet "Rôles"
  </Step>

  <Step title="Cliquer sur Attribuer un Rôle">
    Ouvre la boîte de dialogue d'attribution de rôle
  </Step>

  <Step title="Sélectionner le rôle dans la liste déroulante">
    Choisissez le rôle à attribuer (ex. : Trésorier, Membre)
  </Step>

  <Step title="Enregistrer les modifications">
    L'utilisateur dispose désormais du rôle supplémentaire et de ses autorisations
  </Step>
</Steps>

### Désactivation d'un Utilisateur

<Steps>
  <Step title="Supprimer tous les rôles">
    L'utilisateur ne doit avoir aucun rôle attribué avant la désactivation
  </Step>

  <Step title="Accéder aux détails de l'utilisateur">
    Utilisateurs de l'Organisation → Cliquez sur le nom de l'utilisateur
  </Step>

  <Step title="Cliquer sur Désactiver">
    Dans la section Actions du Compte, cliquez sur "Désactiver l'Utilisateur de l'Organisation"
  </Step>

  <Step title="Confirmer la désactivation">
    Confirmez dans la boîte de dialogue
  </Step>

  <Step title="Compte utilisateur désactivé">
    L'utilisateur ne peut plus se connecter ; les données sont conservées à des fins d'audit
  </Step>
</Steps>

## Besoin d'Aide ?

<CardGroup cols={2}>
  <Card title="Invitation des Utilisateurs" icon="user-plus" href="/fr/tontines/organization-users/inviting-users">
    Guide d'invitation étape par étape
  </Card>

  <Card title="Gestion des Utilisateurs" icon="users-gear" href="/fr/tontines/organization-users/managing-users">
    Modifier, désactiver, mettre à jour les rôles
  </Card>

  <Card title="Rôles Expliqués" icon="sitemap" href="/fr/tontines/organization-users/roles">
    Comprendre les rôles et les autorisations
  </Card>

  <Card title="Matrice des Autorisations" icon="shield" href="/fr/tontines/reference/permissions-matrix">
    Référence complète des autorisations
  </Card>
</CardGroup>