> ## 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.
# Aperçu des Dividendes
> Distribuer les bénéfices organisationnels aux membres selon leur participation et leurs contributions
## Que sont les Dividendes ?
Les **dividendes** sont des distributions des bénéfices organisationnels aux membres. Dans les tontines et les groupes d'épargne, les dividendes récompensent les membres pour leur participation et leur épargne, retournant une part des bénéfices de l'organisation directement sur les comptes d'épargne des membres.
**Fonctionnement** : Les dividendes transfèrent des fonds des résultats reportés de l'organisation vers les comptes d'épargne individuels des membres. Cela diminue les capitaux propres de l'organisation et augmente les capitaux propres des membres du même montant — les capitaux propres totaux restent inchangés.
## Pourquoi Distribuer des Dividendes ?
**Avantages clés :**
* Récompenser les membres pour leur participation et leur fidélité
* Partager le succès organisationnel avec les membres
* Inciter à l'épargne et à une adhésion active
* Démontrer la santé financière et la rentabilité
* Répondre aux attentes des membres (beaucoup rejoignent les tontines en anticipant des dividendes)
* Maintenir l'engagement et la rétention des membres
* Offrir un retour tangible sur l'épargne
* Renforcer la confiance grâce au partage transparent des bénéfices
## Comment Fonctionnent les Dividendes dans Agatabo
### 1. Créer un Bassin de Dividendes (Brouillon)
Configurer une distribution de dividendes pour une période spécifique :
**Informations requises** :
* **Libellé de Période** : Nom lisible (ex. "T1 2026", "Dividende Annuel 2025")
* **Début de Période** : Premier jour de la période de dividende (ex. 2026-01-01)
* **Fin de Période** : Dernier jour de la période de dividende (ex. 2026-03-31)
* **Montant** : Total à distribuer à tous les membres éligibles
**Statut** : Le bassin démarre en statut **brouillon** (journalEntryId = null)
**Validation** :
* La fin de période doit être au plus égale à la fin de la dernière période comptable clôturée
* La période ne peut pas chevaucher les bassins de dividendes existants
* Le montant doit être d'au moins 0,01
**État brouillon** : Les bassins brouillons sont comme des propositions — ils calculent les allocations et montrent ce que chaque membre recevrait, mais ne distribuent pas réellement les fonds jusqu'à ce que vous les marquiez comme distribués.
### 2. Calculer les Parts Individuelles (Automatique)
Agatabo calcule automatiquement le dividende de chaque membre selon la méthode de distribution configurée :
**Méthodes de Distribution** :
| Méthode | Fonctionnement | Idéal Pour |
| ---------------------- | --------------------------------------------- | -------------------------------------------- |
| **Distribution Égale** | Chaque membre éligible reçoit le même montant | Petits groupes avec contributions similaires |
| **Par Contribution** | Proportionnel au solde d'épargne | Groupes avec niveaux d'épargne variés |
**Pondération Temporelle** (optionnel) :
* Peut être activée pour l'une ou l'autre méthode
* Tient compte de la durée d'adhésion pendant la période
* Empêche les nouveaux membres de recevoir le dividende intégral
* Ajuste l'allocation en fonction des jours de participation
**Critères d'Éligibilité** :
* ✅ Le membre doit être **actif** (isActive = true)
* ❌ **Aucun** solde d'épargne minimum requis
* ❌ **Aucune** restriction sur le statut des prêts
* ❌ **Aucune** exigence d'ancienneté minimum (la pondération temporelle gère cela)
### 3. Distribuer les Dividendes (Exécution)
Lorsque vous êtes prêt, marquer le bassin comme **distribué** :
**Ce qui se passe** :
1. Crée une écriture comptable DISTRIBUTION\_DIVIDENDE
2. Débite RÉSULTATS\_REPORTÉS (organisation)
3. Crédite le compte ÉPARGNE de chaque membre (allocations individuelles)
4. Met à jour le statut du bassin à "distribué" (journalEntryId renseigné)
5. **Permanent** — ne peut pas être annulé (uniquement inversé via opération de suppression)
**Mode de paiement** : Les dividendes sont **automatiquement crédités sur les comptes d'épargne des membres** — pas de retrait en espèces, de chèques ou de virements bancaires.
**Prérequis** :
* La date de distribution doit être après la dernière période comptable clôturée
* Nécessite une clé d'idempotence (évite les distributions en double)
* L'organisation doit avoir des résultats reportés suffisants
**Contraintes importantes :**
* **Période comptable** : La fin de période du dividende doit être dans une période comptable clôturée
* **Timing de distribution** : La date de distribution doit être après la dernière période clôturée
* **Pas de chevauchement** : Impossible de créer des bassins avec des plages de dates qui se chevauchent
* **Action permanente** : La distribution ne peut pas être annulée (uniquement inversée en supprimant le bassin)
* **Pas de flux d'approbation** : Transition directe de brouillon à distribué (pas d'étape d'approbation intermédiaire)
## Périodes de Dividendes Courantes
| Période | Fréquence | Cas d'Usage | Exemple |
| -------------------- | --------------- | ----------------------------------------------- | ----------------------------------------- |
| **Trimestrielle** | Tous les 3 mois | Tontines actives avec bénéfices réguliers | 31 mars, 30 juin, 30 sept, 31 déc |
| **Semestrielle** | Tous les 6 mois | Groupes à activité moyenne | 30 juin, 31 déc |
| **Annuelle** | Une fois par an | Groupes conservateurs, organisations formelles | 31 déc |
| **Basée sur Projet** | Ad hoc | Distributions ponctuelles après projets réussis | Après vente d'immeuble, événement spécial |
**Compromis de fréquence :**
* **Trimestrielle** : Maintient l'engagement des membres, plus de travail administratif
* **Annuelle** : Versements importants et impactants, moins d'effort de distribution fréquent
* **Recommandation** : Commencer trimestriellement, passer à l'annuel si la charge administrative est trop élevée
## Méthodes de Distribution Expliquées
### Méthode 1 : Distribution Égale
**Fonctionnement** : Montant total ÷ Nombre de membres éligibles = Part de chaque membre
**Formule** :
```
Dividende Membre = Montant Total du Bassin ÷ Nombre de Membres Actifs
```
**Exemple** :
```
Bassin : 5 000 000 RWF
Membres éligibles : 50 (tous actifs)
Chacun reçoit : 100 000 RWF
Membre A : 100 000 RWF
Membre B : 100 000 RWF
Membre C : 100 000 RWF
...
Total distribué : 5 000 000 RWF
```
**Idéal pour** :
* Petits groupes où tout le monde participe également
* Modèles de propriété coopérative
* Approche simple, facile à expliquer
* Groupes avec niveaux d'épargne similaires
### Méthode 2 : Distribution par Contribution
**Fonctionnement** : Dividende membre = (Épargne membre ÷ Épargne totale) × Montant du bassin
**Formule** :
```
Dividende Membre = (Solde Épargne Membre / Total Épargnes) × Montant Total du Bassin
```
**Exemple** :
```
Bassin : 5 000 000 RWF
Épargne totale : 50 000 000 RWF
Membre A épargné : 2 000 000 RWF
→ Dividende : (2 000 000 / 50 000 000) × 5 000 000 = 200 000 RWF (4%)
Membre B épargné : 500 000 RWF
→ Dividende : (500 000 / 50 000 000) × 5 000 000 = 50 000 RWF (1%)
Membre C épargné : 10 000 000 RWF
→ Dividende : (10 000 000 / 50 000 000) × 5 000 000 = 1 000 000 RWF (20%)
```
### Pondération Temporelle (Amélioration Optionnelle)
**S'applique aux deux méthodes** : La pondération temporelle peut être activée pour la distribution égale OU par contribution
**Fonctionnement** : Ajuste l'allocation en fonction de la durée d'activité du membre pendant la période
**Exemple Égale + Pondération Temporelle** :
```
Bassin : 3 000 000 RWF pour T1 2026 (90 jours, 1er jan - 31 mars)
Membre A : Actif les 90 jours (adhéré avant le début de période)
Membre B : Adhéré le 1er fév (actif 59 jours : 1er fév - 31 mars)
Membre C : Adhéré le 1er mars (actif 31 jours : 1er mars - 31 mars)
Total jours de participation : 90 + 59 + 31 = 180
Membre A : (90 / 180) × 3 000 000 = 1 500 000 RWF (50%)
Membre B : (59 / 180) × 3 000 000 = 983 333 RWF (32,8%)
Membre C : (31 / 180) × 3 000 000 = 516 667 RWF (17,2%)
Total : 3 000 000 RWF
```
## Statut du Bassin de Dividendes
Les bassins ont deux états :
| Statut | Détermination | Signification | Actions Disponibles |
| ------------- | --------------------- | ------------------------------------------ | ------------------------------------------ |
| **Brouillon** | journalEntryId = null | Allocations calculées mais non distribuées | Consulter, Modifier, Supprimer, Distribuer |
| **Distribué** | journalEntryId ≠ null | Fonds distribués aux membres | Consulter, Supprimer (inverse) |
**Pas d'approbation intermédiaire** : Agatabo n'a pas de flux d'approbation formel. Les bassins passent directement de brouillon à distribué lors de l'exécution de la distribution. Si votre organisation requiert une approbation, mettez-la en place en dehors d'Agatabo (ex. approbation du conseil avant distribution).
## Mode de Paiement
**Mode de paiement unique : Crédit sur Compte d'Épargne**
Lors de la distribution des dividendes :
* Le **compte ÉPARGNE** de chaque membre est automatiquement crédité
* **Aucun** retrait en espèces
* **Aucun** chèque émis
* **Aucun** virement bancaire
* **Aucun** paiement manuel requis
**Accès des membres** :
* Les membres peuvent voir leur solde d'épargne augmenté immédiatement
* Les membres peuvent retirer de l'épargne s'ils le souhaitent (opération séparée)
* Ou laisser le dividende en épargne pour continuer à fructifier
## Traitement Comptable
Lors de la distribution des dividendes, Agatabo crée une écriture comptable DISTRIBUTION\_DIVIDENDE :
**Écriture Comptable** :
```
Nature : DISTRIBUTION_DIVIDENDE
Date : Date de distribution
Statut : PUBLIÉE
Dt RÉSULTATS_REPORTÉS MontantTotal
Ct ÉPARGNE (Membre A) AllocationA
Ct ÉPARGNE (Membre B) AllocationB
Ct ÉPARGNE (Membre C) AllocationC
...
```
**Effet** :
* Les résultats reportés de l'organisation **diminuent** du montant total du bassin
* Le solde d'épargne de chaque membre **augmente** de son allocation
* Les capitaux propres totaux de l'organisation **inchangés** (transfert interne de l'org vers les membres)
## Intégration avec les Autres Fonctionnalités
### Résultats Reportés
Les dividendes sont prélevés sur les **résultats reportés** (bénéfice cumulé) :
```
Disponible pour Dividendes = Résultats Reportés - Allocations de Réserves
Exemple :
Total Résultats Reportés : 25 000 000 RWF
Allocations de Réserves : -10 000 000 RWF
──────────────────────────────────────────
Disponible pour Dividendes : 15 000 000 RWF (montant maximum du bassin)
```
### Périodes Comptables
**Contrainte critique** : La distribution de dividendes requiert des périodes comptables clôturées.
```
Dernière période clôturée : 2026-03-31
✅ Valide :
Période bassin : 2026-01-01 à 2026-03-31 (dans la période clôturée)
Date de distribution : 2026-04-05 (après la période clôturée)
❌ Invalide :
Période bassin : 2026-01-01 à 2026-04-30 (fin de période après la période clôturée)
```
## Autorisations Requises
| Action | Autorisation | Portée |
| ----------------------------------- | ----------------- | ----------------- |
| Consulter les bassins de dividendes | `dividends:read` | TOUTE ou MOI-MÊME |
| Créer un bassin de dividendes | `dividends:write` | TOUTE |
| Distribuer un bassin | `dividends:write` | TOUTE |
| Supprimer un bassin | `dividends:write` | TOUTE |
| Consulter dividendes membre | `dividends:read` | MOI-MÊME ou TOUTE |
## Sujets Connexes
Configurer des distributions de dividendes
Marquer les bassins comme distribués
Consulter l'historique et les analyses des dividendes
Calculer le résultat net pour les dividendes
Mettre des fonds de côté pour les dividendes
Clôturer les périodes avant distribution