# A.10.10.2 — Rapport des écoles

## 10.2 Rapport des écoles

### 10.2.1 Accéder au rapport des écoles

Menu latéral → **Rapports → Rapport des écoles**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page "Rapport des écoles" : interface divisée en trois zones verticales — (1) zone "Filtres géographiques et pédagogiques" en haut avec les sélecteurs cascadés Province / Proved / Sous-Proved / École / Section / Classe / Option, (2) zone "Filtres complémentaires" avec les cases à cocher, (3) zone "Colonnes à inclure" avec la liste des colonnes disponibles à gauche et les colonnes sélectionnées avec leur ordre à droite ; boutons "Tout sélectionner", "Réinitialiser" et "Générer le rapport" en bas</callout>`

### 10.2.2 Configurer les filtres géographiques et pédagogiques

Le rapport des écoles s'appuie sur une **hiérarchie de filtres cascadés** qui s'affinent progressivement. Chaque sélection restreint automatiquement les options du niveau suivant :

1. **Province** — Sélectionnez une ou plusieurs provinces. La liste est restreinte au périmètre géographique autorisé pour votre ONG (si applicable).
2. **Proved** — Se met à jour automatiquement selon la ou les provinces sélectionnées.
3. **Sous-Proved** — Se met à jour selon les Proveds sélectionnés.
4. **École** — Liste les écoles rattachées aux Sous-Proveds sélectionnés.
5. **Section** — Filtre par section pédagogique (Primaire, Secondaire, etc.).
6. **Classe** — Filtre par niveau de classe (1ère, 2ème, etc.).
7. **Option** — Filtre par option (Pédagogie générale, Commerce, Électronique, etc.). Se met à jour selon les sections sélectionnées.

⚠️ **Attention :** Un filtre géographique (Province au minimum) est **obligatoire** pour pouvoir soumettre le rapport. Si aucune province n'est sélectionnée, le bouton **Générer le rapport** reste inactif et un message d'avertissement s'affiche.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Zone filtres géographiques en mode saisie : Province "Kasaï" cochée, liste Proved chargée dynamiquement, Sous-Proved "Tshikapa 1" sélectionné, champ École en cours de sélection multiple avec recherche intégrée (Select2) ; indication "Sélection obligatoire" en rouge sous le champ Province si vide</callout>`

### 10.2.3 Configurer les filtres complémentaires

Quatre filtres booléens (cases à cocher) permettent de restreindre davantage le périmètre :

<table id="bkmrk-filtre-description-a"><thead><tr><th>Filtre</th><th>Description</th></tr></thead><tbody><tr><td>**Avec numéro SECOPE**</td><td>N'inclut que les écoles dont le numéro SECOPE est renseigné dans la fiche</td></tr><tr><td>**Avec arrêté ministériel**</td><td>N'inclut que les écoles ayant un numéro d'arrêté ministériel enregistré</td></tr><tr><td>**Ayant reçu la première tranche**</td><td>Filtre les écoles ayant effectivement perçu la 1ère tranche de paiement Equity pour l'année en cours</td></tr><tr><td>**Ayant reçu la deuxième tranche**</td><td>Filtre les écoles ayant effectivement perçu la 2ème tranche de paiement Equity pour l'année en cours</td></tr></tbody></table>

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Zone filtres complémentaires : 4 cases à cocher alignées horizontalement, avec leurs libellés ; "Ayant reçu la première tranche" coché, les autres non cochés</callout>`

### 10.2.4 Sélectionner et ordonner les colonnes

La zone **Colonnes à inclure** permet de composer librement la structure du fichier Excel généré. Les colonnes disponibles sont :

<table id="bkmrk-identifiant-libell%C3%A9-"><thead><tr><th>Identifiant</th><th>Libellé dans le rapport</th></tr></thead><tbody><tr><td>`nom_ecole`</td><td>Nom de l'école</td></tr><tr><td>`numero_secope`</td><td>Numéro SECOPE</td></tr><tr><td>`numero_arrete_min`</td><td>Numéro de l'arrêté ministériel</td></tr><tr><td>`date_numero_arrete_min`</td><td>Date de signature de l'arrêté ministériel</td></tr><tr><td>`code_ecole`</td><td>Code de l'école (code interne PIGBF)</td></tr><tr><td>`nb_enseignant_h`</td><td>Nombre d'enseignants hommes</td></tr><tr><td>`nb_enseignant_f`</td><td>Nombre d'enseignantes femmes</td></tr><tr><td>`nb_enseignant_h_mec`</td><td>Nombre d'enseignants hommes mécanisés</td></tr><tr><td>`nb_enseignant_f_mec`</td><td>Nombre d'enseignantes femmes mécanisées</td></tr><tr><td>`province`</td><td>Province</td></tr><tr><td>`proved`</td><td>Proved</td></tr><tr><td>`sproved`</td><td>Sous-Proved</td></tr><tr><td>`secteur_id`</td><td>Secteur</td></tr><tr><td>`groupement_id`</td><td>Groupement</td></tr><tr><td>`village`</td><td>Village</td></tr><tr><td>`latitude`</td><td>Latitude GPS</td></tr><tr><td>`longitude`</td><td>Longitude GPS</td></tr><tr><td>`noms_prefet`</td><td>Nom du préfet</td></tr><tr><td>`genre_prefet`</td><td>Genre du préfet</td></tr><tr><td>`numero_phone_prefet`</td><td>Numéro de téléphone du préfet</td></tr><tr><td>`nb_beneficiaire_ecole`</td><td>Nombre total de bénéficiaires dans l'école</td></tr><tr><td>`compte_paiement_type`</td><td>Type de compte de paiement (M-Pesa, Equity, etc.)</td></tr><tr><td>`compte_paiement`</td><td>Numéro du compte de paiement</td></tr><tr><td>`montant_premiere_tranche`</td><td>Montant reçu pour la 1ère tranche</td></tr><tr><td>`montant_deuxieme_tranche`</td><td>Montant reçu pour la 2ème tranche</td></tr><tr><td>`nb_eleve_abandon`</td><td>Nombre de bénéficiaires ayant abandonné l'école</td></tr><tr><td>`total_frais_scolaires`</td><td>Total des frais scolaires enregistrés</td></tr><tr><td>`total_minerval`</td><td>Total du minerval</td></tr><tr><td>`total_ipp`</td><td>Total de l'IPP</td></tr><tr><td>`total_bulletin`</td><td>Total du bulletin</td></tr></tbody></table>

**Pour sélectionner des colonnes :**

1. Dans la liste de gauche, cliquez sur une colonne pour l'ajouter à votre sélection. Elle apparaît dans la liste de droite.
2. Pour ajouter toutes les colonnes en une seule opération, cliquez sur **Tout sélectionner**.
3. Pour retirer une colonne déjà sélectionnée, cliquez sur l'icône **✕** à droite de son libellé dans la liste de sélection.
4. Pour modifier l'**ordre des colonnes** dans le fichier Excel, utilisez les flèches **▲** (monter) et **▼** (descendre) à côté de chaque colonne sélectionnée. L'ordre affiché correspond à l'ordre des colonnes dans le fichier généré.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Zone "Colonnes à inclure" : liste gauche avec toutes les colonnes disponibles (scrollable) ; liste droite affichant 5 colonnes sélectionnées ("Nom de l'école", "Province", "Sous-Proved", "Numéro SECOPE", "Nombre total de bénéficiaires") avec flèches de réordonnancement ▲▼ et bouton ✕ par ligne ; compteur "5 colonnes sélectionnées" en haut de la liste de droite</callout>`

### 10.2.5 Générer le rapport

1. Vérifiez que vos filtres et colonnes sont configurés correctement.
2. Cliquez sur **Générer le rapport**.
3. Une fenêtre modale de confirmation s'affiche avec le message : *« Votre rapport est en cours de génération. Vous recevrez un email avec le lien de téléchargement une fois qu'il sera prêt. »*
4. Cliquez sur **Fermer**. La page est réinitialisée automatiquement.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fenêtre modale de confirmation après soumission : icône de succès (coche verte), message de confirmation, bouton "Fermer"</callout>`

ℹ️ **Note :** Si une erreur de communication avec le serveur `api-pigbf` survient, un message d'erreur s'affiche dans la même modale : *« Une erreur est survenue lors de la génération du rapport. Veuillez réessayer plus tard. »* Dans ce cas, contactez l'équipe IT GROUP.

---