> ## 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.
# Comptes du Grand Livre
> Consulter et comprendre le plan comptable — la liste complète des catégories financières utilisées par votre organisation
## Que sont les Comptes du Grand Livre ?
Les **comptes du grand livre** sont les catégories individuelles où les transactions financières sont enregistrées dans le système de comptabilité en partie double. Ensemble, tous les comptes du grand livre forment le **plan comptable** — la liste complète des catégories financières utilisées par votre organisation.
**Concept clé** : Chaque écriture comptable affecte au moins deux comptes du grand livre (un débit, un crédit). Les comptes du grand livre suivent l'effet cumulatif de toutes les transactions au fil du temps, fournissant un solde courant pour chaque catégorie financière.
## Structure des Comptes
Chaque compte du grand livre possède les propriétés suivantes :
| Champ | Type | Description |
| ----------------------- | ----------- | ------------------------------------------------------------------------------- |
| **id** | UUID | Identifiant unique du compte |
| **nom** | chaîne | Nom d'affichage (ex. "Caisse - Compte Principal", "Épargne Membre - Alice") |
| **solde** | Décimal | Solde actuel (positif ou négatif) |
| **estActif** | booléen | Si le compte est actif (les comptes inactifs exclus de la plupart des rapports) |
| **cléPortée** | chaîne | Portée de l'entité (organisation, utilisateur, prêt, réserve, immobilisation) |
| **définitionRôle.rôle** | chaîne | Code système (CAISSE, ÉPARGNE, PRÊTS\_À\_RECEVOIR, etc.) |
| **définitionRôle.type** | énumération | Type de compte (ACTIF, PASSIF, CAPITAUX PROPRES, PRODUITS, CHARGES) |
## Types de Comptes
### 1. Actifs (ACTIF)
**Ressources possédées par l'organisation :**
**Rôles de comptes :**
* **CAISSE** : Trésorerie disponible ou dans les comptes bancaires
* **PRÊTS\_À\_RECEVOIR** : Montant du capital des prêts en cours
* **INTÉRÊTS\_À\_RECEVOIR** : Intérêts courus non encore payés
* **PÉNALITÉS\_À\_RECEVOIR** : Pénalités courues non encore payées
* **IMMOBILISATION** : Immeubles, équipements, mobilier, bâtiments
**Solde normal** : DÉBIT (solde positif = côté débit)
**Exemples de comptes :**
```
Caisse - Compte Principal (organization:org-123) : 5 000 000 RWF
Prêt - Prêt Commercial Bob (loan:loan-456) : 2 000 000 RWF
Mobilier de Bureau (fixedAsset:asset-789) : 500 000 RWF
```
### 2. Passifs (PASSIF)
**Ce que l'organisation doit à d'autres :**
**Rôles de comptes :**
* **ÉPARGNE** : Soldes d'épargne des membres (un compte par membre)
* **EXCÉDENT\_EMPRUNTEUR** : Trop-perçus des emprunteurs
**Solde normal** : CRÉDIT (solde positif = côté crédit)
**Exemples de comptes :**
```
Épargne Membre - Alice (organizationUser:user-abc) : 500 000 RWF
Épargne Membre - Bob (organizationUser:user-def) : 800 000 RWF
Excédent Emprunteur (loan:loan-123) : 10 000 RWF
```
**Important** : L'épargne des membres est un **passif** (pas des capitaux propres) car l'organisation doit ces fonds aux membres sur demande. Les membres peuvent retirer leur épargne à tout moment, ce qui en fait une obligation.
### 3. Capitaux Propres (CAPITAUX PROPRES)
**Valeur nette de l'organisation :**
**Rôles de comptes :**
* **RÉSULTATS\_REPORTÉS** : Bénéfices accumulés des opérations
* **ALLOCATION\_RÉSERVE** : Réserves désignées (fonds d'urgence, réserve pertes sur prêts, etc.)
* **CAPITAUX\_PROPRES\_OUVERTURE** : Capital initial lors de la création de l'organisation
* **AUTRES\_CAPITAUX\_PROPRES** : Comptes de capitaux propres divers
**Solde normal** : CRÉDIT (solde positif = côté crédit)
**Exemples de comptes :**
```
Résultats Reportés (organization:org-123) : 4 500 000 RWF
Réserve Fonds d'Urgence (reserve:reserve-abc) : 1 000 000 RWF
Réserve Pertes sur Prêts (reserve:reserve-def) : 500 000 RWF
```
### 4. Produits (PRODUITS)
**Revenus gagnés par l'organisation :**
**Rôles de comptes :**
* **PRODUITS\_INTÉRÊTS** : Intérêts gagnés sur les prêts
* **PRODUITS\_PÉNALITÉS** : Pénalités de retard de paiement
* **PRODUITS\_FRAIS\_ADHÉSION** : Frais d'adhésion des membres
* **PRODUITS\_FRAIS\_DÉCAISSEMENT** : Frais de traitement des prêts
* **PRODUITS\_RÉCUPÉRATION\_CRÉANCES** : Créances douteuses récupérées
* **AUTRES\_PRODUITS** : Produits divers
**Solde normal** : CRÉDIT (solde positif = côté crédit)
**Comportement en fin de période :**
* Les comptes de produits sont réinitialisés à zéro lors de la clôture de la période
* Les soldes sont transférés aux Résultats Reportés
### 5. Charges (CHARGES)
**Coûts engagés par l'organisation :**
**Rôles de comptes :**
* **DÉPENSES\_OPÉRATIONNELLES** : Coûts opérationnels généraux (loyer, services, fournitures, salaires)
* **CHARGES\_BANCAIRES** : Frais et commissions bancaires
* **CRÉANCES\_DOUTEUSES** : Passages en pertes et profits de prêts
**Solde normal** : DÉBIT (solde positif = côté débit)
**Comportement en fin de période :**
* Les comptes de charges sont réinitialisés à zéro lors de la clôture
* Les soldes sont transférés aux Résultats Reportés (réduisant les capitaux propres)
## Clés de Portée
**Les clés de portée lient les comptes du grand livre à des entités spécifiques**, permettant une comptabilité par entité.
**Format :**
```
{type_entité}:{id_entité}
```
| Clé de Portée | Type de Compte | Exemple |
| --------------------------- | ------------------------------------- | -------------------------------------------------------- |
| `organization:org-123` | Comptes à l'échelle de l'organisation | Caisse, Résultats Reportés, Produits, Charges |
| `organizationUser:user-abc` | Comptes spécifiques au membre | Compte ÉPARGNE d'Alice |
| `loan:loan-456` | Comptes spécifiques au prêt | PRÊTS\_À\_RECEVOIR, INTÉRÊTS\_À\_RECEVOIR du prêt de Bob |
| `reserve:reserve-789` | Comptes spécifiques à la réserve | ALLOCATION\_RÉSERVE Fonds d'Urgence |
| `fixedAsset:asset-012` | Comptes spécifiques à l'actif | IMMOBILISATION Mobilier de bureau |
**Pourquoi les clés de portée sont importantes :**
* ✅ Chaque membre a son propre compte ÉPARGNE (suivi séparément)
* ✅ Chaque prêt a son propre compte PRÊTS\_À\_RECEVOIR
* ✅ Chaque réserve a son propre compte ALLOCATION\_RÉSERVE
* ✅ Permet une comptabilité par membre, par prêt, par réserve
## Calcul du Solde de Compte
**Pour chaque compte, le solde représente :**
* L'**effet cumulatif** de toutes les écritures publiées affectant ce compte
* Le **total courant** depuis la création du compte
* La **valeur actuelle** à la date de la dernière transaction
**Exemple - Compte Caisse (ACTIF) :**
```
Compte : Caisse - Compte Principal
Type : ACTIF (solde normal débit)
Solde d'Ouverture (1er jan) : 5 000 000 RWF
+ Dépôts membres (débits) : +2 000 000 RWF
- Prêts décaissés (crédits) : -1 500 000 RWF
- Dépenses payées (crédits) : -300 000 RWF
= Solde de Clôture (31 jan) : 5 200 000 RWF (débit)
```
**Exemple - Compte Épargne Membre (PASSIF) :**
```
Compte : Épargne Membre - Alice
Type : PASSIF (solde normal crédit)
Solde d'Ouverture (1er jan) : 500 000 RWF
+ Dépôts (crédits) : +100 000 RWF
+ Dividendes (crédits) : +50 000 RWF
- Retraits (débits) : -80 000 RWF
= Solde de Clôture (31 jan) : 570 000 RWF (crédit)
```
## Rapprochement des Comptes
**Le rapprochement** vérifie que les soldes des comptes correspondent aux enregistrements externes.
### Rapprochement du Compte Caisse
Le relevé bancaire indique : 5 100 000 RWF
Agatabo indique : 4 950 000 RWF
Écart : 150 000 RWF
Causes possibles :
* Chèques en circulation (émis mais non encore encaissés)
* Dépôts en transit (déposés mais non encore compensés)
* Frais bancaires non encore enregistrés dans Agatabo
* Intérêts gagnés non encore enregistrés
Créer des écritures comptables pour les frais bancaires, intérêts ou erreurs
Le solde ajusté devrait correspondre au relevé bancaire
## Impossible de Modifier les Soldes Directement
**Les soldes des comptes du grand livre ne peuvent pas être modifiés directement.** Ils changent uniquement via des écritures comptables.
Cela garantit :
* ✅ Piste d'audit complète (chaque changement enregistré)
* ✅ Intégrité de la partie double (toutes les écritures équilibrées)
* ✅ Conformité aux normes comptables
* ✅ Protection contre les modifications non autorisées
**Pour ajuster un solde de compte :**
* Utiliser les fonctionnalités standard (dépôts, prêts, dépenses, dividendes)
* Ou créer une écriture comptable manuelle (nécessite l'autorisation `ledger:write`)
## Comptes Inactifs
**Les comptes peuvent être marqués inactifs** lorsqu'ils ne sont plus utilisés.
**Effets du statut inactif :**
* ❌ Exclus des rapports par défaut (sauf si includeInactive=true)
* ❌ Ne peut pas être utilisé dans de nouvelles écritures comptables
* ✅ Apparaît toujours dans les rapports historiques
* ✅ Le solde est préservé (les soldes historiques peuvent être vérifiés)
* ✅ Peut être réactivé si nécessaire
## Autorisations Requises
| Action | Autorisation | Portée |
| ------------------------------- | -------------- | ------ |
| Consulter les comptes | `ledger:read` | TOUTE |
| Consulter l'activité du compte | `ledger:read` | TOUTE |
| Créer des comptes personnalisés | `ledger:write` | TOUTE |
## Sujets Connexes
Apprendre comment les débits et crédits affectent les types de comptes
Référence complète des rôles et types de comptes
Voir comment les transactions affectent les soldes des comptes
Rapport de comptes classifiés montrant la situation financière