# A.10.10.1 — Vue d'ensemble du module Rapports

## 10.1 Vue d'ensemble du module Rapports

Le module **Rapports** permet de générer, à la demande, des exports de données structurés et personnalisables couvrant les trois entités centrales de la PIGBF : les **écoles**, les **élèves** et les **tuteurs**. Ces exports servent à produire des tableaux de bord pour le pilotage du programme, à alimenter les rapports de redevabilité transmis aux bailleurs de fonds, à appuyer les audits internes et externes, et à répondre aux demandes ad hoc de la coordination PAAF.

Le fonctionnement du module repose sur un **moteur de génération asynchrone** : lorsqu'un rapport est demandé, la plateforme transmet la configuration (colonnes sélectionnées, filtres, paramètres) à l'application `api-pigbf`, qui traite la requête en arrière-plan. Le fichier généré — au format Excel (.xlsx) — est ensuite envoyé par **email** à l'utilisateur connecté à l'adresse enregistrée dans son compte. L'utilisateur peut également consulter et re-télécharger ses rapports passés depuis la section **Mes Rapports**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page d'accueil du module Rapports : menu latéral avec les 4 entrées "Rapport des écoles", "Rapport des élèves", "Rapport des tuteurs", "Mes rapports" ; bandeau supérieur indiquant l'année scolaire active</callout>`

ℹ️ **Note :** La génération d'un rapport peut prendre de quelques secondes à plusieurs minutes selon la taille du jeu de données et le nombre de colonnes sélectionnées. Le rapport arrive par email ; inutile de rester sur la page une fois la demande soumise.

🔒 **Restreint :** L'accès à chaque type de rapport est conditionné par une permission spécifique (`generer rapport des ecoles`, `generer rapport des élèves`, `generer rapport des tuteurs`). Un utilisateur qui ne dispose pas de la permission correspondante ne verra pas l'entrée de menu associée.

---