> ## 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.

# Consultation de l'Historique des Dépenses

> Examiner et analyser les dépenses passées de l'organisation avec pagination, filtrage et tri

## Aperçu

La page d'historique des dépenses affiche toutes les dépenses enregistrées, vous permettant d'examiner les dépenses, d'identifier les tendances, de vérifier les transactions et d'analyser les modèles. Vous pouvez filtrer par plage de dates, rechercher par titre et trier selon différents champs.

## Accéder à l'Historique des Dépenses

<Steps>
  <Step title="Accéder aux Dépenses">
    Cliquer sur **Dépenses** dans la barre latérale
  </Step>

  <Step title="Voir la liste des dépenses">
    Toutes les dépenses affichées avec pagination
  </Step>

  <Step title="Utiliser les contrôles">
    Filtrer, rechercher et trier selon les besoins
  </Step>
</Steps>

## Affichage de la Liste des Dépenses

Chaque dépense dans la liste affiche :

| Champ               | Description                                     | Source                                          |
| ------------------- | ----------------------------------------------- | ----------------------------------------------- |
| **Titre**           | Description/nom de la dépense                   | Texte libre (à utiliser pour la catégorisation) |
| **Montant**         | Combien a été dépensé                           | Depuis l'écriture comptable                     |
| **Date**            | Quand la dépense a eu lieu                      | Date de transaction                             |
| **Description**     | Détails supplémentaires                         | Champ optionnel                                 |
| **Compte Bancaire** | Quel compte a payé (si affiché)                 | Depuis la ligne de grand livre CAISSE           |
| **Réserve**         | Allocation de réserve (si financée par réserve) | Dépenses financées par réserve uniquement       |
| **Frais Bancaires** | Frais bancaires liés (si existants)             | Écriture liée séparée                           |

<Note>
  **Pas de colonne "Catégorie"** : Agatabo ne dispose pas d'un champ de catégorie intégré. Les catégories sont mises en œuvre via des conventions de nommage cohérentes dans les titres (ex. "Dépenses Opérationnelles - Loyer", "Salaires - Trésorier").
</Note>

## Pagination

Les dépenses sont affichées par pages pour améliorer les performances :

**Paramètres par défaut** :

* **Taille de page** : 10 dépenses par page
* **Tri par défaut** : Plus récent en premier (par date, décroissant)

**Navigation** :

* Utiliser les numéros de page ou les boutons suivant/précédent
* Accéder directement à une page spécifique
* Modifier les éléments par page (généralement 10, 25, 50 ou 100)

## Filtrage des Dépenses

### Par Plage de Dates

Filtrer les dépenses sur une période spécifique avec des dates de début et de fin :

<Steps>
  <Step title="Définir la date de début (optionnel)">
    Dépenses à partir de cette date
  </Step>

  <Step title="Définir la date de fin (optionnel)">
    Dépenses jusqu'à cette date incluse
  </Step>

  <Step title="Appliquer le filtre">
    La liste se met à jour pour n'afficher que les dépenses dans la plage
  </Step>
</Steps>

**Plages de dates courantes** :

* Aujourd'hui
* Cette semaine
* Ce mois
* Le mois dernier
* Ce trimestre
* Cette année
* Plage personnalisée

**Exemples de filtres** :

```
Date Début : 2026-06-01
Date Fin : 2026-06-30
Résultat : Toutes les dépenses de juin 2026

Date Début : 2026-01-01
Date Fin : (vide)
Résultat : Toutes les dépenses depuis le 1er janvier 2026
```

### Par Titre (Recherche)

Rechercher des dépenses par titre avec recherche textuelle :

<Steps>
  <Step title="Saisir le terme de recherche">
    Taper un mot-clé ou une phrase dans la boîte de recherche
  </Step>

  <Step title="La recherche s'exécute">
    Correspondance partielle insensible à la casse sur le champ titre
  </Step>

  <Step title="Les résultats se mettent à jour">
    Seules les dépenses correspondantes sont affichées
  </Step>
</Steps>

**La recherche est insensible à la casse et correspond aux titres partiels** :

**Exemples** :

```
Recherche : "loyer"
Correspond à :
- "Dépenses Opérationnelles - Loyer Bureau - Juin 2026"
- "Dépenses Opérationnelles - Loyer Bureau - Mai 2026"
- "Paiement Loyer"

Recherche : "salaires"
Correspond à :
- "Salaires - Indemnité Trésorier"
- "Salaires - Honoraires Comptable"
- "Salaires Personnel - Juin"

Recherche : "frais bancaires"
Correspond à :
- "Frais Bancaires - Virement"
- "Frais Bancaires - Tenue de Compte"
```

<Note>
  **Utiliser la recherche pour les catégories** : Comme les catégories sont dans le titre, vous pouvez rechercher par préfixe de catégorie. Rechercher "Dépenses Opérationnelles" pour voir toutes les dépenses avec cette catégorie dans le titre.
</Note>

## Tri des Dépenses

Cliquer sur les en-têtes de colonnes ou utiliser les contrôles de tri pour réordonner la liste :

**Champs de tri disponibles** :

* **Titre** : Ordre alphabétique (A-Z ou Z-A)
* **Montant** : Du plus petit au plus grand ou du plus grand au plus petit
* **Date** : Du plus ancien au plus récent ou du plus récent au plus ancien
* **Créé le** : Quand la dépense a été enregistrée dans le système

**Ordre de tri** :

* **Croissant (asc)** : Faible à élevé, A à Z, plus ancien au plus récent
* **Décroissant (desc)** : Élevé à faible, Z à A, plus récent au plus ancien

**Par défaut** : Date décroissante (dépenses les plus récentes en premier)

### Exemples de Tri

**Tri par Titre (croissant)** — Regroupe les dépenses avec le même préfixe de catégorie :

```
Dépenses Opérationnelles - Électricité
Dépenses Opérationnelles - Loyer Bureau
Frais Bancaires - Frais de Virement
Salaires - Honoraires Comptable
Salaires - Indemnité Trésorier
```

**Tri par Montant (décroissant)** — Identifie rapidement les dépenses les plus importantes :

```
2 000 000 RWF - "Honoraires Audit Annuel"
500 000 RWF - "Achat Équipement"
150 000 RWF - "Loyer Bureau"
50 000 RWF - "Indemnité Trésorier"
```

## Combinaison des Filtres et du Tri

### Exemple 1 : Dépenses Opérationnelles de Juin par Montant

```
Filtres :
- Date Début : 2026-06-01
- Date Fin : 2026-06-30
- Recherche : "Dépenses Opérationnelles"

Tri :
- Trier Par : Montant
- Ordre : Décroissant

Résultat : Toutes les dépenses opérationnelles de juin, les plus importantes en premier
```

### Exemple 2 : Paiements de Salaires Récents

```
Filtres :
- Date Début : 2026-01-01
- Recherche : "Salaires"

Tri :
- Trier Par : Date
- Ordre : Décroissant

Résultat : Tous les paiements de salaires de cette année, les plus récents en premier
```

### Exemple 3 : Analyse de Catégorie Annuelle

```
Filtres :
- Date Début : 2026-01-01
- Date Fin : 2026-12-31
- Recherche : "Salaires"

Tri :
- Trier Par : Date
- Ordre : Croissant

Résultat : Tous les paiements de salaires chronologiquement
Calcul manuel : Additionner tous les montants pour le total annuel
```

## Consultation des Détails d'une Dépense

Cliquer sur une dépense pour voir les détails complets :

**La vue détaillée affiche** :

* Titre et description complets
* Montant exact
* Date de transaction
* Compte bancaire utilisé
* Allocation de réserve (si financée par réserve)
* Frais bancaires liés (si existants)
* Documents/reçus joints
* Qui a enregistré la dépense
* Quand elle a été enregistrée
* Informations sur l'écriture comptable
* Options de modification et de suppression (si autorisé)

## Quelles Dépenses sont Affichées

La liste des dépenses inclut :

**Incluses** :

* ✅ Dépenses standard (nature PAIEMENT\_DÉPENSE)
* ✅ Dépenses financées par réserves (nature DÉPENSE\_RÉSERVE)
* ✅ Dépenses publiées (actives) uniquement

**Exclues** :

* ❌ Frais bancaires (affichés comme liés à la dépense parente)
* ❌ Dépenses annulées/supprimées
* ❌ Décaissements de prêts (pas des dépenses)
* ❌ Distributions de dividendes (pas des dépenses)
* ❌ Retraits d'épargne (pas des dépenses)

## Cas d'Utilisation Courants

### Révision Mensuelle des Dépenses

**Objectif** : Examiner les dépenses du mois en cours

<Steps>
  <Step title="Définir le filtre de date">
    Date Début : Premier jour du mois / Date Fin : Dernier jour du mois
  </Step>

  <Step title="Trier par titre">
    Regroupe les dépenses par préfixe de catégorie
  </Step>

  <Step title="Examiner chaque catégorie">
    Vérifier les montants par rapport au budget
  </Step>

  <Step title="Identifier les dépenses inhabituelles">
    Chercher les montants inattendus ou importants
  </Step>
</Steps>

### Trouver une Dépense Spécifique

<Steps>
  <Step title="Utiliser la recherche">
    Saisir un mot-clé du titre ou de la description
  </Step>

  <Step title="Ajouter un filtre de date si nécessaire">
    Affiner si vous vous souvenez approximativement de la date
  </Step>

  <Step title="Parcourir les résultats">
    Trouver la dépense correspondante
  </Step>

  <Step title="Cliquer pour voir les détails">
    Voir les informations complètes
  </Step>
</Steps>

**Exemple** :

```
Recherche : "audit"
Date Début : 2026-04-01
Date Fin : 2026-04-30

Résultat : "Services Professionnels - Honoraires Audit Annuel"
```

### Préparer un Audit

<Steps>
  <Step title="Définir la période d'audit">
    Utiliser la plage de dates pour l'exercice fiscal ou la période d'audit
  </Step>

  <Step title="Supprimer le filtre de recherche">
    Afficher tous les types de dépenses
  </Step>

  <Step title="Trier par date">
    Ordre chronologique (croissant)
  </Step>

  <Step title="Vérifier l'exhaustivité">
    * S'assurer que toutes les dépenses ont des descriptions
    * Vérifier les reçus/documents manquants
    * Vérifier que les montants sont raisonnables
  </Step>
</Steps>

## Limitations et Solutions

### Pas de Filtre par Plage de Montant

**Contournement** :

1. Récupérer toutes les dépenses pour la période
2. Trier par montant
3. Parcourir manuellement pour la plage souhaitée

### Pas de Filtre par Catégorie

**Contournement** :

* Utiliser la recherche par titre avec le préfixe de catégorie
* Trier par titre pour regrouper les catégories
* Un nommage cohérent rend cela efficace

### Pas de Fonction d'Export

**Contournements** :

* Vérifier si le frontend implémente l'export
* Utiliser le Compte de Résultat (inclut la ventilation des dépenses)
* Saisie manuelle depuis la liste des dépenses
* Copier-coller dans un tableur

### Maximum 100 par Page

**Contournement** :

* Utiliser des filtres de date pour affiner les résultats
* Naviguer à travers plusieurs pages
* Utiliser la recherche pour réduire les résultats

## Bonnes Pratiques

<Note>
  **Conseils de révision des dépenses :**

  **Révisions régulières :**

  * Réviser les dépenses hebdomadairement pour la période récente
  * Révision mensuelle de tout le mois
  * Révisions trimestrielles et annuelles pour les tendances

  **Rechercher efficacement :**

  * Utiliser les préfixes de catégorie dans la recherche
  * Combiner la recherche avec des filtres de date
  * Essayer différents mots-clés si la première recherche ne fonctionne pas

  **Stratégies de tri :**

  * Trier par titre pour regrouper les catégories
  * Trier par montant pour trouver les dépenses les plus importantes
  * Trier par date pour une révision chronologique

  **Vérification :**

  * Comparer la liste des dépenses aux relevés bancaires
  * Vérifier les dépenses manquantes (lacunes dans les dates)
  * Vérifier les montants importants ou inhabituels
  * S'assurer que toutes les dépenses ont des descriptions adéquates

  **Documentation :**

  * Cliquer pour vérifier que les documents sont joints
  * Noter les reçus manquants pour suivi
  * S'assurer que les descriptions sont assez claires pour un audit
</Note>

## Autorisations Requises

| Action                             | Autorisation     | Portée |
| ---------------------------------- | ---------------- | ------ |
| Consulter la liste des dépenses    | `expenses:read`  | TOUTE  |
| Consulter les détails des dépenses | `expenses:read`  | TOUTE  |
| Modifier une dépense               | `expenses:write` | TOUTE  |
| Supprimer une dépense              | `expenses:write` | TOUTE  |

## Sujets Connexes

<CardGroup cols={2}>
  <Card title="Enregistrement des Dépenses" icon="plus" href="/fr/tontines/expenses/recording-expenses">
    Ajouter de nouvelles dépenses au système
  </Card>

  <Card title="Catégories de Dépenses" icon="tags" href="/fr/tontines/expenses/expense-categories">
    Organiser les dépenses avec des conventions de titre
  </Card>

  <Card title="Aperçu des Dépenses" icon="receipt" href="/fr/tontines/expenses/overview">
    Comprendre les types et fonctionnalités des dépenses
  </Card>

  <Card title="Compte de Résultat" icon="chart-line" href="/fr/tontines/reports/profit-and-loss">
    Voir l'impact des dépenses sur la rentabilité
  </Card>
</CardGroup>