# Manuel PIGBF — Section B — Administrateur ONG / Admin IT ONG

Section B du Manuel Administrateur PIGBF — Administrateur ONG / Administrateur IT ONG

# B.1 — Introduction et périmètre

Chapitre B.1 du Manuel PIGBF

# B.1.1.1 — À qui s'adresse cette section ?

## 1.1 À qui s'adresse cette section ?

Cette section du manuel est destinée à deux profils d'utilisateurs de la PIGBF qui interviennent au niveau des organisations non gouvernementales (ONG) partenaires du programme PAAF :

- L'**Administrateur ONG** (rôle : *Admin ONG*) — responsable de la gestion opérationnelle de son ONG sur la plateforme : supervision des écoles, des élèves bénéficiaires et des tuteurs relevant de son périmètre, validation des données collectées par ses enquêteurs sur le terrain via ODK, génération des rapports de son organisation.
- L'**Administrateur IT ONG** (rôle : *Admin IT ONG*) — profil à dominante technique au sein de l'ONG : gestion des comptes enquêteurs, configuration des tablettes ODK, appui à la collecte terrain, validation des données ODK. Ce rôle partage plusieurs modules avec l'Admin ONG, avec un focus plus marqué sur l'aspect technique et opérationnel de la collecte.

Ces deux rôles sont **cloisonnés par organisation** : un Admin ONG ou un Admin IT ONG ne peut voir, modifier ni exporter aucune donnée appartenant à une autre ONG. Cette étanchéité est assurée automatiquement par la plateforme dès la connexion — aucune manipulation n'est nécessaire de la part de l'utilisateur.

> **Important :** Cette section couvre les fonctionnalités accessibles aux rôles **Admin ONG** et **Admin IT ONG**. Les fonctionnalités réservées à l'Administrateur Plateforme (Super Admin / Admin) sont documentées dans la Section A du présent manuel.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Interface après connexion sous le rôle Admin ONG : menu latéral visible avec uniquement les modules accessibles à ce rôle (Dashboard, Bénéficiaires, Données Collectées, Rapports, Utilisateurs/Enquêteurs, Profil) — sans les modules Paramètres système, Prestataires, ni Rôles et permissions</callout>`

---

# B.1.1.2 — Rappel du programme PAAF et de la PIGBF

## 1.2 Rappel du programme PAAF et de la PIGBF

Le **Programme d'Appui à l'Autonomisation des Femmes (PAAF)** est un programme d'envergure provinciale mis en œuvre dans la Province du Kasaï (République Démocratique du Congo). L'un de ses axes centraux est l'attribution de **bourses scolaires aux filles** issues de familles vulnérables, afin de favoriser leur maintien dans le système éducatif et de réduire le taux d'abandon scolaire féminin.

La **PIGBF — Plateforme Informatique de Gestion des Bourses pour les Filles** — est l'outil numérique central qui permet de gérer l'intégralité du cycle de vie de ces bourses :

<table id="bkmrk-%C3%89tape-description-id"><thead><tr><th>Étape</th><th>Description</th></tr></thead><tbody><tr><td>**Identification**</td><td>Recensement des filles bénéficiaires, de leurs tuteurs et des établissements scolaires partenaires via les formulaires ODK Collect</td></tr><tr><td>**Collecte**</td><td>Enregistrement des données scolaires : classes, options, frais, présences, résultats</td></tr><tr><td>**Validation**</td><td>Vérification et approbation des données collectées avant leur intégration dans la base de production</td></tr><tr><td>**Paiement**</td><td>Génération et exécution des instructions de paiement vers les tuteurs (via M-Pesa) et les établissements scolaires (via Equity BCDC)</td></tr><tr><td>**Suivi**</td><td>Rapports de pilotage, tableaux de bord, traçabilité des paiements et des abandons scolaires</td></tr></tbody></table>

Les **ONG partenaires** jouent un rôle d'exécution terrain dans ce cycle : elles organisent et supervisent la collecte des données dans les établissements scolaires de leur zone d'intervention, et assurent la première validation de qualité des données avant leur transmission à la coordination PAAF.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Schéma du cycle de vie d'une bourse : 5 étapes représentées en ligne horizontale — Identification → Collecte → Validation → Paiement → Suivi — avec indication du rôle impliqué à chaque étape (Enquêteur ODK pour les deux premières, Admin ONG pour la validation, Validateur Paiement pour le paiement, Admin PAAF pour le suivi)</callout>`

---

# B.1.1.3 — Architecture du système vue par l'Admin ONG

## 1.3 Architecture du système vue par l'Admin ONG

Du point de vue de l'Administrateur ONG, la PIGBF se présente comme une interface web unique accessible à l'adresse **https://pigbf.org**. Il n'est pas nécessaire de comprendre l'architecture technique sous-jacente pour utiliser la plateforme au quotidien. Néanmoins, quelques éléments de contexte permettent de comprendre certains comportements de l'interface.

**Les données arrivent depuis le terrain via ODK :** Les enquêteurs collectent les données sur des tablettes Android à l'aide de l'application **ODK Collect**. Ces données transitent automatiquement par le serveur ODK Central, puis sont traitées et déposées dans une zone de staging de la plateforme, où elles apparaissent dans le module **Données Collectées** en attente de validation.

**La validation est une étape clé :** Les données collectées ne sont pas directement intégrées dans la base de production. Elles doivent être **examinées et validées** par l'Admin ONG (ou l'Admin IT ONG) avant d'être définitivement enregistrées comme données officielles du programme. Cette étape garantit la qualité et l'intégrité des informations.

**Les paiements sont gérés par un rôle distinct :** L'Admin ONG n'a pas accès au module de paiements. La validation et l'envoi des instructions de paiement relèvent exclusivement du **Validateur de paiement PAAF**, un rôle autonome documenté dans la Section C de ce manuel.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Schéma simplifié du flux de données vu par l'Admin ONG : (1) Enquêteurs → ODK Collect → ODK Central (flèche automatique), (2) ODK Central → Zone de staging PIGBF — module "Données Collectées" (flèche automatique), (3) Admin ONG valide → Base de production (action manuelle), (4) Base de production → Rapports disponibles. Chaque étape avec une icône représentative. L'étape manuelle est mise en évidence</callout>`

---

# B.1.1.4 — Les deux rôles de cette section — comparatif détaillé

## 1.4 Les deux rôles de cette section — comparatif détaillé

Bien que l'Admin ONG et l'Admin IT ONG partagent la même interface et les mêmes modules principaux, leurs responsabilités et leurs permissions diffèrent sur certains points. Le tableau ci-dessous présente une vue comparative complète des accès de chaque profil :

<table id="bkmrk-module-%2F-action-admi"><thead><tr><th>Module / Action</th><th>Admin ONG</th><th>Admin IT ONG</th></tr></thead><tbody><tr><td>**Dashboard**</td><td>✅ Accès complet (données de son ONG)</td><td>✅ Accès complet (données de son ONG)</td></tr><tr><td>**Bénéficiaires — Écoles**</td><td>✅ Consultation, modification, création</td><td>✅ Consultation uniquement</td></tr><tr><td>**Bénéficiaires — Élèves**</td><td>✅ Consultation, modification, création</td><td>✅ Consultation uniquement</td></tr><tr><td>**Bénéficiaires — Tuteurs**</td><td>✅ Consultation, modification, création</td><td>✅ Consultation uniquement</td></tr><tr><td>**Données Collectées — Écoles**</td><td>✅ Validation complète</td><td>✅ Validation complète</td></tr><tr><td>**Données Collectées — Élèves**</td><td>✅ Validation complète</td><td>✅ Validation complète</td></tr><tr><td>**Données Collectées — Tuteurs**</td><td>✅ Validation complète</td><td>✅ Validation complète</td></tr><tr><td>**Enquêteurs**</td><td>✅ Consultation, création, modification</td><td>✅ Consultation, création, modification</td></tr><tr><td>**Rapports**</td><td>✅ Génération et téléchargement</td><td>✅ Consultation uniquement</td></tr><tr><td>**Paiements**</td><td>❌ Aucun accès</td><td>❌ Aucun accès</td></tr><tr><td>**Paramètres système**</td><td>❌ Aucun accès</td><td>❌ Aucun accès</td></tr><tr><td>**Rôles et permissions**</td><td>❌ Aucun accès</td><td>❌ Aucun accès</td></tr><tr><td>**Gestion des utilisateurs**</td><td>❌ Aucun accès</td><td>❌ Aucun accès</td></tr><tr><td>**Journal d'activités (Logs)**</td><td>✅ Consultation (périmètre ONG)</td><td>✅ Consultation (périmètre ONG)</td></tr><tr><td>**Mon profil**</td><td>✅ Modification de ses propres informations</td><td>✅ Modification de ses propres informations</td></tr></tbody></table>

> ℹ️ **Note :** Les accès exacts peuvent varier selon la configuration des permissions effectuée par l'Administrateur Plateforme. Le tableau ci-dessus représente la configuration standard préconfigurée. En cas de doute sur vos accès, contactez l'équipe IT GROUP ou votre responsable PAAF.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Comparaison visuelle des menus latéraux : côte à côte, le menu vu par un Admin ONG (à gauche) et le menu vu par un Admin IT ONG (à droite) — les entrées de menu communes surlignées en bleu, les différences identifiées</callout>`

---

# B.1.1.5 — Le cloisonnement par ONG — principe fondamental

## 1.5 Le cloisonnement par ONG — principe fondamental

Le cloisonnement par ONG est le mécanisme de sécurité le plus important à comprendre pour un Admin ONG. Il garantit que **chaque organisation ne peut accéder qu'à ses propres données**, sans risque d'accès accidentel ou malveillant aux données d'une autre ONG partenaire du programme.

Ce cloisonnement opère de manière totalement transparente et automatique :

- **Listes filtrées automatiquement :** Dès la connexion, toutes les listes (écoles, élèves, tuteurs, enquêteurs, données collectées) n'affichent que les enregistrements rattachés à l'ONG de l'utilisateur connecté.
- **Rapports limités au périmètre ONG :** Les rapports générés ne contiennent que les données de l'ONG concernée. Il n'est pas possible de générer un rapport consolidant plusieurs ONG depuis ce rôle.
- **Recherche restreinte :** La recherche globale ne renvoie que des résultats appartenant à l'ONG de l'utilisateur.
- **Aucune option de changement d'ONG :** L'interface ne propose pas de sélecteur d'ONG — le périmètre est fixé à la création du compte et ne peut être modifié que par un Administrateur Plateforme.

⚠️ **Important :** Si vous constatez que des données appartenant à une autre ONG sont visibles depuis votre compte, signalez-le immédiatement à l'équipe IT GROUP à l'adresse **support@itgroup.cd**. Il pourrait s'agir d'une erreur de configuration des droits d'accès.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Illustration du cloisonnement : liste des écoles vue par un Admin ONG — toutes les lignes affichent uniquement les écoles de son ONG ; la barre supérieure affiche le nom de l'utilisateur et le badge de son ONG</callout>`

---

# B.1.1.6 — L'année scolaire dans le contexte ONG

## 1.6 L'année scolaire dans le contexte ONG

Comme pour tous les rôles de la plateforme, toutes les données affichées dans l'interface de l'Admin ONG sont **filtrées par l'année scolaire active**. Le sélecteur d'année scolaire est visible en permanence dans la barre supérieure.

L'Admin ONG peut consulter les données des années scolaires précédentes (en lecture seule) en changeant la sélection dans ce sélecteur. En revanche, **toute création ou modification de données ne s'applique qu'à l'année scolaire active** — il n'est pas possible d'ajouter des données sur une année scolaire clôturée.

🔒 **Restriction :** L'Admin ONG ne peut pas créer, modifier ni clôturer une année scolaire. Cette opération est réservée au Super Admin (cf. Section A, chapitre A.14).

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Barre supérieure vue par un Admin ONG : sélecteur d'année scolaire "2024-2025 ▼" bien visible, icône cloche notifications, icône paramètres, avatar et nom d'utilisateur à droite</callout>`

---

# B.1.1.7 — Connexion et prise en main

## 1.7 Connexion et prise en main

La procédure de connexion à la PIGBF est identique quel que soit le rôle. L'Admin ONG et l'Admin IT ONG se connectent à l'adresse **https://pigbf.org** avec leur adresse email et leur mot de passe fournis par l'Administrateur Plateforme.

Pour la procédure de connexion complète (étapes détaillées, gestion du mot de passe oublié, cas d'erreurs courants), reportez-vous au **chapitre A.2 — Connexion et prise en main** de la Section A de ce manuel. Ces informations s'appliquent intégralement aux rôles Admin ONG et Admin IT ONG.

Une fois connecté, l'interface s'affiche avec le **tableau de bord** en page d'accueil, filtré sur les données de l'ONG de l'utilisateur et sur l'année scolaire active.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Interface complète après connexion sous le rôle Admin ONG : tableau de bord centré avec les statistiques de l'ONG, menu latéral à gauche avec les modules disponibles, barre supérieure avec année scolaire et nom de l'utilisateur</callout>`

---

# B.1.1.8 — Conventions utilisées dans cette section

## 1.8 Conventions utilisées dans cette section

<table id="bkmrk-symbole-%2F-format-sig"><thead><tr><th>Symbole / Format</th><th>Signification</th></tr></thead><tbody><tr><td>`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> description</callout>`</td><td>Emplacement réservé pour une capture d'écran réelle</td></tr><tr><td>⚠️</td><td>Action irréversible ou point de vigilance critique</td></tr><tr><td>ℹ️</td><td>Information complémentaire ou bonne pratique</td></tr><tr><td>🔒</td><td>Fonctionnalité restreinte ou inaccessible pour ce rôle</td></tr><tr><td>**Texte en gras**</td><td>Élément d'interface cliquable (bouton, lien, menu)</td></tr><tr><td>`Texte en code`</td><td>Chemin de navigation ou valeur exacte à saisir</td></tr><tr><td>*Texte en italique*</td><td>Exemple de valeur ou libellé affiché à l'écran</td></tr></tbody></table>

---

*Fin du chapitre B.1 — Introduction et périmètre*

---

---

# B.2 — Tableau de bord ONG

Chapitre B.2 du Manuel PIGBF

# B.2.2.1 — Rôle et nature du tableau de bord ONG

## 2.1 Rôle et nature du tableau de bord ONG

Le tableau de bord est la **première page affichée après chaque connexion réussie**. Pour l'Admin ONG, il constitue le centre de pilotage opérationnel de son organisation : un espace qui synthétise en temps réel l'état du programme PAAF pour l'ONG concernée et pour l'année scolaire active.

Son objectif est triple :

1. **Vision macroscopique instantanée** — les volumes de bénéficiaires, d'écoles et de tuteurs enregistrés pour l'ONG, sans avoir à parcourir les listes détaillées.
2. **Alerte opérationnelle** — signaler les actions en attente qui requièrent une intervention urgente : validations ODK non traitées, anomalies détectées dans les données collectées par ses enquêteurs.
3. **Pilotage analytique** — visualiser la distribution des bénéficiaires par classe, par statut migratoire, par zone géographique de l'ONG, permettant de détecter des déséquilibres dans la collecte.

> ℹ️ **Différence avec le tableau de bord de l'Admin Plateforme :** Toutes les statistiques et tous les indicateurs du tableau de bord de l'Admin ONG sont **automatiquement filtrés sur son ONG**. Il ne voit jamais les données consolidées de l'ensemble du programme, ni les données des autres ONG partenaires.

Toutes les données affichées sont **filtrées par l'année scolaire sélectionnée** dans la barre supérieure. Changer l'année scolaire actualise immédiatement l'ensemble des indicateurs et graphiques.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Vue complète du tableau de bord pour un Admin ONG : titre "Dashboard" visible, compteurs globaux en haut filtrés sur l'ONG, section "Validations en attente" avec les trois cartes, blocs abandons, puis graphiques analytiques. Barre supérieure avec l'année scolaire et le nom de l'utilisateur</callout>`

---

# B.2.2.2 — Structure générale du tableau de bord

## 2.2 Structure générale du tableau de bord

Le tableau de bord est organisé en plusieurs blocs successifs, empilés de haut en bas dans la zone de contenu centrale :

<table id="bkmrk-bloc-contenu-priorit"><thead><tr><th>Bloc</th><th>Contenu</th><th>Priorité de consultation</th></tr></thead><tbody><tr><td>**Compteurs globaux ONG**</td><td>4 indicateurs clés : total bénéficiaires, avec handicap, écoles, tuteurs — filtrés ONG</td><td>Référence rapide</td></tr><tr><td>**Validations en attente**</td><td>3 cartes d'alerte ODK : écoles / élèves / tuteurs à valider (de ses enquêteurs)</td><td>⚡ Priorité haute — action requise</td></tr><tr><td>**Abandons scolaires**</td><td>Compteur et taux d'abandon parmi les bénéficiaires de l'ONG</td><td>Indicateur de risque programme</td></tr><tr><td>**Graphiques analytiques**</td><td>Répartitions par classe, statut migratoire, zone géographique</td><td>Analyse et pilotage stratégique</td></tr><tr><td>**Tops et classements**</td><td>Top 10 élèves par résultats, top 10 écoles par effectif, répartition tuteurs</td><td>Pilotage de la performance</td></tr></tbody></table>

---

# B.2.2.3 — Bloc 1 — Compteurs globaux ONG

## 2.3 Bloc 1 — Compteurs globaux ONG

La première ligne du tableau de bord affiche quatre compteurs en temps réel donnant une vision immédiate des volumes gérés par l'ONG pour l'année scolaire en cours.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Ligne des quatre compteurs globaux filtrés ONG : "Total des bénéficiaires" (nombre), "Bénéficiaires avec handicap" (nombre), "Total des écoles" (nombre), "Total des tuteurs" (nombre). Chaque compteur dans une carte blanche avec son label, son icône colorée et une flèche de navigation vers la liste correspondante</callout>`

<table id="bkmrk-compteur-description"><thead><tr><th>Compteur</th><th>Description</th><th>Ce qu'il mesure concrètement</th></tr></thead><tbody><tr><td>**Total des bénéficiaires**</td><td>Nombre total d'élèves filles enregistrées et validées dans le périmètre de l'ONG</td><td>Toutes les bénéficiaires ayant une fiche active dans la PIGBF pour cette ONG et cette année</td></tr><tr><td>**Bénéficiaires avec handicap**</td><td>Sous-population identifiée avec une situation de handicap déclarée</td><td>Bénéficiaires dont le champ "Situation de handicap" est renseigné à "Oui"</td></tr><tr><td>**Total des écoles**</td><td>Nombre d'établissements scolaires actifs dans le programme pour cette ONG</td><td>Écoles validées ayant au moins une bénéficiaire rattachée</td></tr><tr><td>**Total des tuteurs**</td><td>Nombre de tuteurs légaux enregistrés et associés aux bénéficiaires de l'ONG</td><td>Tuteurs ayant une fiche validée et liés à au moins une bénéficiaire</td></tr></tbody></table>

Chaque compteur dispose d'une **icône de lien** (flèche ou carré en haut à droite de la carte) qui redirige directement vers la liste complète correspondante dans le module concerné.

---

# B.2.2.4 — Bloc 2 — Validations en attente

## 2.4 Bloc 2 — Validations en attente

Cette section est l'**indicateur opérationnel le plus critique** du tableau de bord pour l'Admin ONG au quotidien. Elle affiche, sous forme de trois cartes cliquables, le nombre de fiches collectées par les enquêteurs de l'ONG via ODK qui n'ont pas encore été validées et transférées dans la base de production.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Validations en attente" avec ses trois cartes : "Écoles — En attente de validation" (icône bleue école, avec le nombre de formulaires), "Élèves — En attente de validation" (icône orange bénéficiaire, avec le nombre de formulaires), "Tuteurs — En attente de validation" (icône tuteur, avec le nombre de formulaires). Titre de la section avec icône horloge visible</callout>`

### Signification de chaque carte

**Carte 1 — Écoles en attente de validation**

Représente le nombre total de formulaires ODK portant sur les établissements scolaires soumis par les enquêteurs de l'ONG, arrivés dans la zone de staging mais pas encore traités. Cela peut inclure des formulaires d'identification d'une nouvelle école, de mise à jour du numéro SECOPE, de mise à jour de l'arrêté ministériel, de renseignement des frais scolaires ou des classes et options. Un clic sur cette carte redirige directement vers **Données Collectées → Données écoles**.

**Carte 2 — Élèves en attente de validation**

Représente le nombre de fiches d'identification de bénéficiaires soumises par les enquêteurs de l'ONG, en attente d'examen et de transfert. Chaque fiche correspond à une élève identifiée sur le terrain lors d'une campagne de collecte. Un clic redirige vers **Données Collectées → Données élèves**.

**Carte 3 — Tuteurs en attente de validation**

Représente le nombre de fiches tuteurs collectées sur le terrain par les enquêteurs de l'ONG, non encore traitées. Un clic redirige vers **Données Collectées → Données tuteurs**.

⚠️ **Attention critique :** Tant qu'une fiche ODK n'est pas validée et transférée, les données correspondantes **n'apparaissent pas** dans les listes officielles de bénéficiaires, d'écoles ou de tuteurs. Elles ne peuvent donc pas être incluses dans les calculs de paiement, les rapports officiels ou les statistiques du programme. Un volume élevé de validations en attente — particulièrement après une campagne de collecte intensive — signale un retard dans le circuit de traitement qui doit être résorbé en priorité.

---

# B.2.2.5 — Bloc 3 — Abandons scolaires

## 2.5 Bloc 3 — Abandons scolaires

Ce bloc surveille un indicateur de risque programme fondamental : le nombre et le taux d'abandon scolaire parmi les bénéficiaires de l'ONG au cours de l'année active.

### Ce que ce bloc affiche

- **Compteur absolu** : nombre d'élèves bénéficiaires ayant abandonné la scolarité au cours de l'année (statut "Abandonné" dans leur fiche)
- **Taux d'abandon** : pourcentage calculé automatiquement sur la base du total des bénéficiaires actives de l'ONG pour l'année
- **Base de calcul** : total des élèves de référence, rappelé sous le taux

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Bloc "Abandons Scolaires" : compteur numérique, taux en pourcentage, libellé "élèves ont abandonné", total des élèves de référence en pied de carte, badge de couleur orange ou rouge selon le niveau</callout>`

ℹ️ **Note :** Une élève est enregistrée comme ayant abandonné lorsque son statut scolaire est mis à jour en conséquence dans la plateforme, soit manuellement par un administrateur, soit via les formulaires ODK de suivi des notes et présences soumis par les enquêteurs. Ce chiffre est directement utilisable dans les rapports de redevabilité auprès des bailleurs du programme.

---

# B.2.2.6 — Bloc 4 — Graphiques analytiques

## 2.6 Bloc 4 — Graphiques analytiques

La partie inférieure du tableau de bord présente plusieurs visualisations graphiques interactives permettant d'analyser en détail la composition et la distribution des bénéficiaires de l'ONG enregistrées pour l'année scolaire active.

### Graphique 1 — Bénéficiaires par classe

Histogramme vertical représentant la répartition des élèves bénéficiaires selon leur niveau scolaire (6ème EB, 1ère H, 2ème H, 3ème H, 4ème H, etc.). Chaque barre correspond à un niveau, avec l'effectif en ordonnée. Ce graphique permet d'identifier les classes les plus représentées dans le programme et de détecter des déséquilibres éventuels dans la collecte de l'ONG.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Graphique en barres verticales "Bénéficiaires par classe" : abscisse = niveaux scolaires, ordonnée = effectifs, barres de couleurs distinctes par niveau, valeurs visibles au-dessus de chaque barre</callout>`

### Graphique 2 — Bénéficiaires par statut migratoire

Graphique en secteurs (camembert) montrant la répartition des bénéficiaires de l'ONG selon leur statut migratoire déclaré lors de la collecte terrain : **Résidente**, **Déplacée**, **Réfugiée**, **Rapatriée**. Chaque segment est affiché avec sa couleur distinctive et son pourcentage. Ce graphique est un indicateur clé pour le suivi des populations vulnérables couvertes par l'ONG.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Graphique camembert "Bénéficiaires par statut migratoire" : segments colorés pour chaque statut avec leurs pourcentages, légende associée</callout>`

### Graphique 3 — Répartition géographique

Histogramme ou carte affichant la densité des bénéficiaires par Sous-PROVED dans la zone d'intervention de l'ONG. Permet d'identifier les zones géographiques sous-représentées ou au contraire très denses dans la collecte.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Graphique de répartition géographique : barres horizontales ou carte représentant les effectifs par Sous-PROVED, avec les noms des Sous-PROVED sur l'axe et les effectifs en valeur</callout>`

### Graphique 4 — Top 10 des écoles par effectif de bénéficiaires

Classement des dix établissements scolaires de l'ONG comptant le plus grand nombre de bénéficiaires enregistrées. Permet d'identifier les écoles les plus importantes du dispositif et de prioriser les visites de suivi.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Liste "Top 10 des écoles" : tableau ou liste ordonnée avec rang, nom de l'école, Sous-PROVED et effectif de bénéficiaires pour chaque établissement</callout>`

### Graphique 5 — Répartition des tuteurs par genre

Proportion hommes/femmes parmi les tuteurs légaux enregistrés dans le périmètre de l'ONG. Indicateur utile pour analyser la structure familiale des bénéficiaires et les dynamiques de genre dans la réception des bourses.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Graphique camembert ou barres "Répartition tuteurs par genre" : proportion Hommes / Femmes avec pourcentages et valeurs absolues</callout>`

---

# B.2.2.7 — Utiliser le tableau de bord comme outil de pilotage quotidien

## 2.7 Utiliser le tableau de bord comme outil de pilotage quotidien

Le tableau de bord est conçu pour être consulté **en priorité à chaque connexion**. Voici la routine de consultation recommandée pour l'Admin ONG :

**1. Vérifier les validations en attente (section prioritaire)**  
Si les trois cartes affichent des volumes significatifs, traitez les validations ODK en priorité avant d'entreprendre d'autres tâches. Des données non validées bloquent l'ensemble du circuit en aval : elles n'apparaissent pas dans les listes, ne peuvent pas être incluses dans les paiements et faussent les statistiques.

**2. Surveiller les abandons scolaires**  
Un pic soudain sur ce compteur nécessite une investigation dans le module Élèves pour identifier les écoles ou zones concernées et en informer votre coordinateur PAAF.

**3. Analyser les graphiques**  
Toute anomalie dans la répartition par classe, par statut migratoire ou par zone géographique peut signaler un problème de collecte (sous-représentation d'une zone), un biais dans l'identification des bénéficiaires, ou un problème de saisie dans les formulaires ODK par vos enquêteurs.

ℹ️ **Accès rapide depuis le tableau de bord :** Chaque carte cliquable (validations en attente) et chaque compteur avec icône de lien renvoient directement au module concerné. Il n'est pas nécessaire de passer par le menu latéral pour aller de l'alerte à l'action.

---

*Fin du chapitre B.2 — Tableau de bord ONG*

---

---

# B.3 — Gestion des enquêteurs

Chapitre B.3 du Manuel PIGBF

# B.3.3.1 — Vue d'ensemble

## 3.1 Vue d'ensemble

Le module **Enquêteurs** permet à l'Admin ONG et à l'Admin IT ONG de gérer les agents de terrain responsables de la collecte des données dans les établissements scolaires. Les enquêteurs sont un type particulier d'acteur de la PIGBF : **ils n'ont aucun accès à l'interface web** — ils opèrent exclusivement via l'application mobile **ODK Collect** sur tablette Android. Leurs comptes sont des comptes ODK Central gérés depuis la plateforme PIGBF.

Ce module est le **point d'entrée unique** pour créer un compte enquêteur, lui assigner les formulaires ODK auxquels il aura accès, générer son QR code de configuration de tablette, et suivre son activité de collecte.

Accès : menu latéral → **Utilisateurs → Enquêteurs** (ou directement **Enquêteurs** selon la configuration du menu).

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page liste des enquêteurs : tableau avec colonnes Nom, Email ODK, ONG de rattachement, Formulaires assignés (liste des codes de formulaires ODK accessibles), Statut (Actif en badge vert / Inactif en badge rouge), Date de création, Actions (icônes Voir / Modifier). Bouton "+ Nouvel enquêteur" en haut à droite. Barre de recherche et filtres en haut</callout>`

---

# B.3.3.2 — Liste des enquêteurs

## 3.2 Liste des enquêteurs

### Colonnes du tableau

<table id="bkmrk-colonne-description-"><thead><tr><th>Colonne</th><th>Description</th></tr></thead><tbody><tr><td>**Nom**</td><td>Nom complet de l'enquêteur</td></tr><tr><td>**Email ODK**</td><td>Adresse email utilisée comme identifiant de connexion sur ODK Central</td></tr><tr><td>**ONG**</td><td>Organisation de rattachement (visible uniquement pour les Super Admin / Admin ; pour l'Admin ONG, tous les enquêteurs listés appartiennent à son ONG)</td></tr><tr><td>**Formulaires assignés**</td><td>Liste des codes des formulaires ODK auxquels l'enquêteur a accès (ex : *01\_00 — Identification bénéficiaires, 02\_02 — Frais scolaires, etc.*)</td></tr><tr><td>**Statut**</td><td>*Actif* (badge vert) : l'enquêteur peut se connecter à ODK Collect et soumettre des données ; *Inactif* (badge rouge) : le compte est suspendu</td></tr><tr><td>**Date de création**</td><td>Date à laquelle le compte a été créé dans la plateforme</td></tr><tr><td>**Actions**</td><td>Icônes **Voir** (œil) et **Modifier** (crayon)</td></tr></tbody></table>

### Filtres et recherche

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Barre de recherche et filtres de la page enquêteurs : champ de recherche textuelle (nom, email), filtre Statut (Tous / Actif / Inactif), bouton Réinitialiser les filtres</callout>`

- **Recherche textuelle** : saisissez le nom ou l'email de l'enquêteur pour filtrer la liste en temps réel
- **Filtre Statut** : Tous / Actif / Inactif — utile pour identifier rapidement les comptes à réactiver ou à vérifier

---

# B.3.3.3 — Consulter la fiche d'un enquêteur

## 3.3 Consulter la fiche d'un enquêteur

Cliquez sur l'icône **Voir** (œil) sur la ligne d'un enquêteur pour accéder à sa fiche détaillée.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée enquêteur, haut de page : photo de l'enquêteur (si disponible), nom complet, email ODK, ONG de rattachement, statut actuel (Actif / Inactif), date de création du compte</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée enquêteur, section Formulaires assignés : liste des formulaires ODK avec leur code et leur libellé complet (ex : "01_00 — Identification des filles bénéficiaires de la Bourse", "02_02 — Enregistrement des frais scolaires", etc.)</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée enquêteur, section QR Code ODK : carré QR code affiché en grand format, bouton "Imprimer le QR code", bouton "Télécharger le QR code" (PNG), note explicative sur l'usage du QR code pour la configuration de ODK Collect</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée enquêteur, section Statistiques de collecte : tableau indiquant par formulaire le nombre total de soumissions effectuées, la date de la dernière soumission, le statut de synchronisation</callout>`

La fiche est structurée en plusieurs sections :

**Informations personnelles et compte ODK**  
Nom complet, email ODK (identifiant de connexion sur la tablette), ONG de rattachement, statut actuel du compte, date de création.

**Formulaires ODK assignés**  
Liste exhaustive des formulaires auxquels l'enquêteur a accès depuis sa tablette. Chaque formulaire est identifié par son code et son libellé complet. C'est depuis cette section que l'on peut vérifier que l'enquêteur dispose bien des accès nécessaires à sa mission.

**QR Code de configuration ODK**  
Code QR unique généré automatiquement à la création du compte. Ce code encode les paramètres de connexion ODK Central spécifiques à cet enquêteur (URL du serveur, identifiants). Il doit être scanné depuis l'application ODK Collect lors de la configuration initiale d'une tablette.

**Statistiques de collecte**  
Récapitulatif des soumissions effectuées par formulaire : nombre total de soumissions, date de la dernière soumission, état de synchronisation.

ℹ️ **Note sur la confidentialité du QR Code :** Le QR Code encode les identifiants de connexion ODK de l'enquêteur. Ne le partagez pas par des canaux non sécurisés. Remettez-le en main propre ou par un canal de communication de confiance (email professionnel, WhatsApp sécurisé) directement à l'enquêteur concerné.

---

# B.3.3.4 — Créer un nouvel enquêteur

## 3.4 Créer un nouvel enquêteur

La création d'un compte enquêteur est une procédure à effectuer avant toute campagne de collecte. Sans compte, l'enquêteur ne peut pas configurer sa tablette ni accéder aux formulaires ODK.

### Prérequis avant la création

Avant de créer un enquêteur, assurez-vous de disposer des informations suivantes :  
\- Nom complet de l'enquêteur (nom, post-nom, prénom)  
\- Adresse email valide (sera utilisée comme identifiant ODK — peut être une adresse fictive du type `prenom.nom@pigbf.org` si l'enquêteur n'a pas d'email personnel)  
\- Liste des formulaires auxquels il doit avoir accès  
\- Statut initial (Actif par défaut)

### Procédure de création

1. Cliquez sur le bouton **+ Nouvel enquêteur** en haut à droite de la liste.
2. Le formulaire de création s'ouvre.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Formulaire "Créer un enquêteur" complet : champs Nom (obligatoire), Post-nom, Prénom (obligatoire), Email ODK (obligatoire), section "Formulaires assignés" avec liste de cases à cocher pour chaque formulaire disponible, sélecteur Statut (Actif / Inactif), boutons Annuler et Enregistrer</callout>`

3. **Section Informations personnelles :**  
    \- **Nom** (obligatoire) : Nom de famille de l'enquêteur  
    \- **Post-nom** : Post-nom (deuxième nom de famille en usage en RDC)  
    \- **Prénom** (obligatoire) : Prénom usuel  
    \- **Email ODK** (obligatoire) : Adresse email servant d'identifiant de connexion sur ODK Central. Cette adresse doit être unique sur la plateforme — deux enquêteurs ne peuvent pas partager le même email. Si l'enquêteur n'a pas d'email, créez une adresse de type `prenom.nom@pigbf.org`
4. **Section Formulaires assignés :**

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Formulaires assignés" dans le formulaire de création : liste de cases à cocher avec les formulaires disponibles (ex : "01_00 — Identification des filles bénéficiaires", "02_02 — Enregistrement des frais scolaires des écoles", "02_03 — Renseignement des classes et options", "Collecte des notes et présences des élèves", "Identification des tuteurs des bénéficiaires") ; au moins un formulaire doit être coché</callout>`

Cochez les formulaires auxquels l'enquêteur devra avoir accès. Les formulaires disponibles sont :

<table id="bkmrk-code-formulaire-libe"><thead><tr><th>Code formulaire</th><th>Libellé</th><th>Usage</th></tr></thead><tbody><tr><td>`01_00`</td><td>Identification des filles bénéficiaires de la Bourse</td><td>Collecte des données d'identification des élèves</td></tr><tr><td>`02_02`</td><td>Enregistrement des frais scolaires des écoles</td><td>Collecte des frais scolaires par établissement</td></tr><tr><td>`02_03`</td><td>Renseignement des classes et options des écoles</td><td>Collecte des classes et options disponibles dans les écoles</td></tr><tr><td>`Collecte notes`</td><td>Collecte des notes et de présence des élèves</td><td>Suivi semestriel des résultats et présences</td></tr><tr><td>`Identification tuteurs`</td><td>Identification des tuteurs des bénéficiaires</td><td>Collecte des données des tuteurs légaux</td></tr><tr><td>`Identification et mise à jour écoles`</td><td>Identification et mise à jour des données des écoles</td><td>Collecte et mise à jour des informations sur les établissements</td></tr></tbody></table>

> ℹ️ **Bonne pratique :** N'assignez à chaque enquêteur que les formulaires correspondant réellement à sa mission. Un enquêteur uniquement chargé de l'identification des élèves n'a pas besoin du formulaire de frais scolaires. Cela limite les risques d'erreur de saisie sur le terrain.

5. **Section Statut :**  
    \- **Actif** : L'enquêteur peut immédiatement utiliser l'application ODK Collect et collecter des données. Statut par défaut — laissez-le tel quel sauf cas particulier.  
    \- **Inactif** : L'enquêteur ne peut pas se connecter. Utilisez ce statut si vous créez le compte en avance avant de remettre la tablette.
6. Vérifiez l'ensemble des informations saisies.
7. Cliquez sur **Enregistrer**.

### Après la création : le QR Code

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Message de confirmation après création d'un enquêteur : "Enquêteur créé avec succès. Le QR Code a été généré." avec affichage immédiat du QR Code et boutons "Imprimer" et "Télécharger"</callout>`

Après l'enregistrement, un **QR Code unique** est automatiquement généré pour cet enquêteur. Ce QR Code doit être remis à l'enquêteur pour lui permettre de configurer son application ODK Collect sur sa tablette.

**Comment transmettre le QR Code :**  
\- Imprimez-le depuis la fiche de l'enquêteur (bouton **Imprimer le QR code**) et remettez-le en main propre  
\- Téléchargez-le en format image PNG (bouton **Télécharger**) et envoyez-le par email ou WhatsApp directement à l'enquêteur  
\- Affichez-le sur l'écran de votre ordinateur et demandez à l'enquêteur de le scanner directement

⚠️ **Important :** Sans ce QR Code, l'enquêteur ne pourra pas configurer sa tablette ni accéder aux formulaires ODK. Ne démarrez pas une campagne de collecte sans avoir remis et testé le QR Code avec chaque enquêteur.

---

# B.3.3.5 — Modifier un enquêteur existant

## 3.5 Modifier un enquêteur existant

### Quand modifier un enquêteur ?

- Changement de zone d'intervention (nouvelle Sous-PROVED à couvrir)
- Ajout ou retrait de formulaires assignés (nouvelle mission ou fin de mission spécifique)
- Mise à jour des informations personnelles (correction d'un nom mal saisi, changement d'email)
- Changement de statut (activation ou désactivation du compte)

### Procédure de modification

1. Dans la liste des enquêteurs, trouvez l'enquêteur concerné (utilisez la recherche si nécessaire).
2. Cliquez sur l'icône **Modifier** (crayon) dans la colonne Actions.
3. Le formulaire s'ouvre avec les informations actuelles pré-remplies.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Formulaire de modification d'un enquêteur pré-rempli : tous les champs affichés avec leurs valeurs actuelles, formulaires assignés avec cases cochées/décochées selon l'assignation actuelle, sélecteur de statut, boutons Annuler et Mettre à jour</callout>`

4. Modifiez les champs nécessaires.
5. Cliquez sur **Mettre à jour**.

### Cas particuliers

**Modifier les formulaires assignés**

Pour changer les formulaires accessibles à un enquêteur :  
\- Décochez les formulaires à retirer  
\- Cochez les nouveaux formulaires à ajouter  
\- Cliquez sur **Mettre à jour**

L'enquêteur verra les changements appliqués lors de sa **prochaine synchronisation** sur ODK Collect (la liste des formulaires disponibles se met à jour automatiquement au prochain accès réseau de la tablette).

**Désactiver temporairement un enquêteur**

Situations justifiant une désactivation : absence prolongée, départ temporaire, suspension disciplinaire, perte ou vol de la tablette.

1. Ouvrez le formulaire de modification de l'enquêteur.
2. Changez le statut de **Actif** à **Inactif**.
3. Cliquez sur **Mettre à jour**.

L'enquêteur ne pourra plus se connecter à ODK Collect ni soumettre de données jusqu'à réactivation. Les données déjà soumises et en attente de validation ne sont pas affectées.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Sélecteur de statut dans le formulaire enquêteur : bouton radio ou toggle "Actif / Inactif", avec indication visuelle du statut actuel</callout>`

**Réactiver un enquêteur**

Procédure identique : ouvrez le formulaire de modification, remettez le statut à **Actif**, cliquez sur **Mettre à jour**. L'enquêteur peut immédiatement se reconnecter avec son QR Code existant — il n'est pas nécessaire de régénérer un nouveau QR Code.

---

# B.3.3.6 — Utiliser et distribuer le QR Code ODK

## 3.6 Utiliser et distribuer le QR Code ODK

Le QR Code est l'élément central du processus de configuration d'une tablette ODK. Comprendre son fonctionnement est indispensable pour l'Admin IT ONG et l'Admin ONG.

### Ce que le QR Code contient

Le QR Code encode de manière sécurisée les paramètres de connexion suivants :  
\- L'**URL du serveur ODK Central** du programme  
\- L'**identifiant de l'enquêteur** (email ODK)  
\- Le **mot de passe ODK** associé au compte

### Procédure de configuration d'une tablette avec le QR Code

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Écran de l'application ODK Collect affichant l'option "Configurer par QR code" sur l'écran d'accueil de l'application</callout>`

1. Sur la tablette Android, ouvrez l'application **ODK Collect**
2. Sur l'écran principal, appuyez sur **Configurer par QR code**
3. Autorisez l'utilisation de la caméra si demandé
4. Alignez le QR Code fourni dans le cadre du scanner
5. Une fois le QR Code scanné, les formulaires assignés se chargent automatiquement dans l'application

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Tablette Android affichant le scanner QR Code actif dans ODK Collect : cadre de scan bien visible, instructions à l'écran</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Tablette Android après scan réussi : message de confirmation "Projet configuré avec succès", liste des formulaires disponibles qui s'affiche</callout>`

### Régénération du QR Code

Si un QR Code est perdu ou compromis (tablette volée, QR Code partagé par erreur avec une personne non autorisée), il est possible de régénérer un nouveau QR Code depuis la fiche de l'enquêteur. L'ancien QR Code est alors invalidé.

⚠️ **Attention :** Après régénération, toutes les tablettes configurées avec l'ancien QR Code devront être reconfigurées avec le nouveau.

---

# B.3.3.7 — Bonnes pratiques — Gestion des enquêteurs

## 3.7 Bonnes pratiques — Gestion des enquêteurs

**Un compte par enquêteur, sans exception.** Ne créez jamais de compte générique partagé entre plusieurs enquêteurs. Chaque soumission ODK est horodatée et liée à l'identifiant de l'enquêteur — un compte partagé rend la traçabilité impossible en cas de données erronées.

**Désactivez immédiatement les comptes en cas de départ.** Dès qu'un enquêteur quitte le programme (fin de mission, démission, exclusion), désactivez son compte avant même la récupération de la tablette. Cela empêche toute soumission de données non autorisées.

**Vérifiez les formulaires assignés avant chaque campagne.** Avant de démarrer une nouvelle campagne de collecte, vérifiez que chaque enquêteur dispose bien des formulaires nécessaires à sa mission. Un formulaire manquant bloque l'enquêteur sur le terrain.

**Testez le QR Code avant d'envoyer l'enquêteur sur le terrain.** Faites une configuration test sur une tablette disponible pour vérifier que le QR Code fonctionne correctement avant la remise officielle.

**Documentez les distributions de tablettes.** Maintenez un registre interne indiquant quelle tablette a été remise à quel enquêteur, avec la date de remise et le numéro de série de la tablette. En cas de perte ou de vol, cela facilite la désactivation rapide du bon compte.

---

*Fin du chapitre B.3 — Gestion des enquêteurs*

---

---

# B.4 — Validation des données ODK

Chapitre B.4 du Manuel PIGBF

# B.4.4.1 — Vue d'ensemble

## 4.1 Vue d'ensemble

La validation des données ODK est la **mission opérationnelle centrale** de l'Admin ONG et de l'Admin IT ONG dans la PIGBF. C'est l'étape qui transforme les données brutes collectées par les enquêteurs sur le terrain en données officielles intégrées dans la base de production du programme.

### Pourquoi cette étape est-elle indispensable ?

Les enquêteurs collectent les données en mode déconnecté, sans vérification en temps réel par un superviseur. Des erreurs peuvent survenir : informations incomplètes, photos illisibles, numéros de téléphone incorrects, doublons accidentels. La validation est le **contrôle qualité humain** qui garantit que seules des données correctes et vérifiées entrent dans la base officielle.

**Tant qu'une fiche ODK n'est pas validée :**  
\- L'école, l'élève ou le tuteur correspondant **n'existe pas** dans la base de production  
\- Il ne peut pas figurer dans les rapports officiels  
\- Il ne peut pas être inclus dans les instructions de paiement  
\- Les statistiques du tableau de bord ne le comptabilisent pas

### Les trois types de données à valider

<table id="bkmrk-type-module-formulai"><thead><tr><th>Type</th><th>Module</th><th>Formulaires ODK concernés</th></tr></thead><tbody><tr><td>**Données écoles**</td><td>Données Collectées → Données écoles</td><td>Identification écoles, mise à jour SECOPE, arrêté ministériel, frais scolaires, classes/options</td></tr><tr><td>**Données élèves**</td><td>Données Collectées → Données élèves</td><td>Identification des filles bénéficiaires, notes et présences</td></tr><tr><td>**Données tuteurs**</td><td>Données Collectées → Données tuteurs</td><td>Identification des tuteurs des bénéficiaires</td></tr></tbody></table>

Accès : menu latéral → **Données Collectées** → puis sous-menu *Données écoles*, *Données élèves* ou *Données tuteurs*.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Menu latéral avec la section "Validation des données collectées" déroulée : sous-menus "Données Collectées" → "Données écoles", "Données élèves", "Données tuteurs" visibles et cliquables</callout>`

---

# B.4.4.2 — Validation des données écoles

## 4.2 Validation des données écoles

### Accéder à la page

Menu latéral → **Données Collectées → Données écoles**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page Données écoles complète : onglets "Non validé" (sélectionné, en bleu) et "Validé" (gris) en haut à gauche ; boutons "Validation par UIDs", "Exporter en Excel", "▼ Filtrer" en haut à droite ; sélecteur "10 écoles par page" ; tableau principal avec toutes ses colonnes ; barre de recherche à droite</callout>`

### Les deux onglets de navigation

**Onglet "Non validé"** (vue par défaut, sélectionnée à l'ouverture)  
Affiche uniquement les formulaires ODK soumis par les enquêteurs de l'ONG, non encore traités et en attente de validation. C'est la vue de travail quotidienne.

**Onglet "Validé"**  
Affiche les formulaires déjà traités et transférés en base de production. Utile pour retrouver l'historique d'une validation, vérifier qu'une école donnée a bien été traitée, ou consulter les informations telles qu'elles ont été soumises avant transfert.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Les deux onglets "Non validé" et "Validé" avec leur indicateur de compteur respectif (ex : "Non validé (217)" et "Validé (1 042)")</callout>`

### Colonnes du tableau des données écoles

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Tableau des données écoles non validées : colonnes Enquêteur (code), École (nom), Province/PROVED/Sous-PROVED (trois lignes empilées), Num. SECOPE (badge vert ou orange "Non disponible"), Arrêté Min. (référence + date de signature + nb pages), PV Réunion (nb pages ou "Non disponible"), Tranches (montant 1ère tranche estimé), Actions (icône paramètres + coche validation)</callout>`

<table id="bkmrk-colonne-description-"><thead><tr><th>Colonne</th><th>Description</th></tr></thead><tbody><tr><td>**Enquêteur**</td><td>Code de l'enquêteur ayant soumis le formulaire ODK</td></tr><tr><td>**École**</td><td>Nom de l'établissement tel que saisi dans le formulaire ODK</td></tr><tr><td>**Province / PROVED / Sous-PROVED**</td><td>Hiérarchie administrative éducative sur trois niveaux telle que déclarée</td></tr><tr><td>**Num. SECOPE**</td><td>Numéro de mécanisation de l'école : badge vert si disponible, badge orange *"Non disponible"* si non renseigné par l'enquêteur</td></tr><tr><td>**Arrêté Min.**</td><td>Référence et date de signature de l'arrêté ministériel d'agrément + nombre de pages photographiées</td></tr><tr><td>**PV Réunion**</td><td>Procès-verbal de réunion fixant les frais scolaires — nombre de pages photographiées ou *"Non disponible"*</td></tr><tr><td>**Tranches**</td><td>Montant estimé de la 1ère tranche pour cette école, calculé sur la base du nombre de bénéficiaires rattachées</td></tr><tr><td>**Actions**</td><td>Bouton **Voir le détail** (icône paramètres/œil) et bouton **Valider** (icône coche verte)</td></tr></tbody></table>

### Filtrer les données en attente

Avant de valider, filtrez les données par zone géographique ou par enquêteur pour traiter les soumissions de manière organisée et cohérente — notamment lors du traitement post-campagne d'un volume important.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Panneau de filtres ouvert sur la page Données écoles : liste déroulante PROVED (avec "Tous les PROVED" par défaut), liste déroulante Sous-PROVED (cascade, se remplit selon PROVED), liste déroulante Enquêteur (avec le code de chaque enquêteur de l'ONG), bouton "Réinitialiser les filtres"</callout>`

1. Cliquez sur le bouton **▼ Filtrer** en haut à droite du tableau.
2. Sélectionnez un ou plusieurs filtres combinables :  
     - **PROVED** : province éducationnelle  
     - **Sous-PROVED** : se remplit automatiquement selon le PROVED choisi  
     - **Enquêteur** : code de l'enquêteur dont vous souhaitez traiter les soumissions
3. Les résultats du tableau se mettent à jour instantanément.
4. Cliquez sur **Réinitialiser les filtres** pour revenir à la liste complète.

### Consulter le détail d'une soumission avant validation

Avant de valider une soumission, consultez systématiquement son détail complet, en particulier pour les premières validations ou en cas de doute sur la qualité des données.

1. Cliquez sur le bouton **Voir le détail** (icône paramètres ou œil) sur la ligne de la soumission.
2. La vue détaillée s'ouvre, affichant l'intégralité des données saisies par l'enquêteur.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Vue détaillée d'une soumission ODK école : toutes les informations collectées affichées (nom de l'école, numéro SECOPE, localisation GPS avec coordonnées, photos des pages de l'arrêté ministériel, photos des pages du PV de réunion, montants des frais scolaires par type, informations sur le préfet identifié), statut "Non validée" visible, bouton "Valider ce formulaire" en bas</callout>`

Points de contrôle essentiels lors de la consultation du détail :

<table id="bkmrk-%C3%89l%C3%A9ment-%C3%A0-v%C3%A9rifier-c"><thead><tr><th>Élément à vérifier</th><th>Ce qu'il faut contrôler</th></tr></thead><tbody><tr><td>**Nom de l'école**</td><td>Orthographe correcte, nom complet, pas d'abréviation ambiguë</td></tr><tr><td>**Localisation**</td><td>PROVED et Sous-PROVED cohérents avec la zone de collecte de l'enquêteur</td></tr><tr><td>**Photos de l'arrêté ministériel**</td><td>Toutes les pages photographiées, lisibles, non tronquées</td></tr><tr><td>**Photos du PV de réunion**</td><td>Toutes les pages photographiées, lisibles</td></tr><tr><td>**Numéro SECOPE**</td><td>S'il est disponible, vérifier sa cohérence (format attendu)</td></tr><tr><td>**Montants des frais scolaires**</td><td>Valeurs cohérentes avec les standards de la zone</td></tr><tr><td>**Informations préfet**</td><td>Nom complet présent, photo si disponible</td></tr></tbody></table>

### Valider une école individuellement

1. Sur la ligne de l'école à valider, cliquez sur le bouton **Valider** (icône coche verte dans la colonne Actions).
2. Une fenêtre de confirmation s'affiche, rappelant le nom de l'école et les informations principales.
3. Confirmez la validation en cliquant sur **Confirmer**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fenêtre de confirmation de validation individuelle d'une école : titre "Confirmer la validation", récapitulatif (nom de l'école, PROVED, Sous-PROVED, SECOPE si disponible, montant tranche 1), boutons "Annuler" et "Confirmer la validation" (bleu)</callout>`

La soumission est alors transférée : l'école est **créée** dans la base de production si elle est nouvelle, ou **mise à jour** si une fiche existe déjà avec le même identifiant. La soumission disparaît de l'onglet "Non validé" et passe dans l'onglet "Validé".

### Valider plusieurs écoles en bloc (validation groupée)

1. Cochez les cases à gauche de chaque ligne à valider dans le tableau. La case en en-tête du tableau **coche ou décoche toutes les lignes visibles** de la page courante en une seule action.
2. Un bandeau récapitulatif apparaît en haut ou en bas du tableau : « **X école(s) sélectionnée(s)** ».
3. Cliquez sur le bouton **Valider les X école(s) sélectionnée(s)** qui apparaît.
4. Une fenêtre de confirmation récapitule le nombre d'écoles à valider.
5. Confirmez. Les transferts sont effectués en masse vers la base de production.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Tableau avec plusieurs cases cochées (exemple : 8 écoles) : cases à cocher visibles et cochées à gauche de chaque ligne, bandeau "8 écoles sélectionnées" visible avec bouton "Valider les 8 écoles sélectionnées" actif et lien "Vider la sélection"</callout>`

> ℹ️ **Conseil :** La validation en masse est recommandée pour les traitements post-campagne lorsque vous avez déjà réalisé un contrôle de qualité préalable sur les soumissions (par exemple, en consultant les détails d'un échantillon avant validation groupée). Pour les premières campagnes ou en cas de doute, préférez la validation individuelle avec consultation du détail.

### Validation par liste d'UIDs (import ciblé)

Lorsqu'un superviseur ou un responsable de terrain fournit une liste précise des identifiants de formulaires ODK à valider, utilisez cette fonction pour un traitement ciblé et documenté.

1. Cliquez sur le bouton **Validation par UIDs** en haut du tableau.
2. Une fenêtre modale s'ouvre avec deux options :  
     - **Saisie manuelle** : entrez les UIDs manuellement dans la zone de texte, un identifiant par ligne  
     - **Import fichier** : importez un fichier texte (.txt) contenant les UIDs, un par ligne
3. Cliquez sur **Valider les UIDs saisis**.
4. Le système identifie et valide uniquement les formulaires correspondants.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Modale "Validation par UIDs" : deux onglets ou deux zones (Saisie manuelle / Import fichier), zone de texte multilignes pour la saisie manuelle avec exemples d'UIDs, bouton de sélection de fichier, bouton "Valider les UIDs saisis", bouton Annuler</callout>`

### Exporter les données en attente

Le bouton **Exporter en Excel** génère un fichier Excel contenant toutes les données de l'onglet actuellement affiché (non validées ou validées), avec les filtres actifs appliqués.

⚠️ **Note :** L'export est traité de manière asynchrone pour les volumes importants. Un email vous sera envoyé à votre adresse de connexion avec un lien de téléchargement dès que le fichier est prêt.

---

# B.4.4.3 — Validation des données élèves

## 4.3 Validation des données élèves

### Accéder à la page

Menu latéral → **Données Collectées → Données élèves**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page Données élèves complète : onglets Non validé / Validé, boutons Validation par UIDs / Exporter en Excel / Filtrer, tableau avec ses colonnes, pagination en bas</callout>`

### Colonnes du tableau des données élèves

<table id="bkmrk-colonne-description-"><thead><tr><th>Colonne</th><th>Description</th></tr></thead><tbody><tr><td>**Enquêteur**</td><td>Code de l'enquêteur ayant soumis le formulaire ODK</td></tr><tr><td>**Nom de l'élève**</td><td>Nom, post-nom et prénom de la bénéficiaire identifiée</td></tr><tr><td>**École**</td><td>Établissement de rattachement déclaré lors de la collecte</td></tr><tr><td>**Classe**</td><td>Niveau scolaire de l'élève</td></tr><tr><td>**Option**</td><td>Option choisie par l'élève (si applicable)</td></tr><tr><td>**Notes S1**</td><td>Moyennes du premier semestre (Période 1, Période 2, Examen, Moyenne semestrielle) si collectées</td></tr><tr><td>**Notes S2**</td><td>Idem pour le second semestre si collectées</td></tr><tr><td>**ID formulaire ODK**</td><td>Identifiant unique (UID) de la soumission dans ODK Central</td></tr><tr><td>**Actions**</td><td>Bouton Voir le détail et bouton Valider</td></tr></tbody></table>

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Tableau des données élèves non validées : colonnes visibles avec exemples de données, notamment l'enquêteur, le nom de l'élève, l'école, la classe et les boutons d'action sur chaque ligne</callout>`

### Filtres disponibles

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Panneau de filtres des données élèves ouvert : listes déroulantes PROVED, Sous-PROVED, École, Classe, Option, Enquêteur ; bouton Réinitialiser les filtres</callout>`

<table id="bkmrk-filtre-description-p"><thead><tr><th>Filtre</th><th>Description</th></tr></thead><tbody><tr><td>**PROVED**</td><td>Province éducationnelle</td></tr><tr><td>**Sous-PROVED**</td><td>Se remplit en cascade selon le PROVED sélectionné</td></tr><tr><td>**École**</td><td>Filtrer par établissement spécifique</td></tr><tr><td>**Classe**</td><td>Filtrer par niveau scolaire</td></tr><tr><td>**Option**</td><td>Filtrer par option pédagogique</td></tr><tr><td>**Enquêteur**</td><td>Filtrer par agent terrain spécifique</td></tr></tbody></table>

### Consulter le détail d'une fiche élève avant validation

La consultation du détail est **fortement recommandée** avant toute validation, en particulier pour les nouvelles campagnes de collecte ou lors du traitement de données d'un enquêteur dont vous contrôlez la qualité.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Vue détaillée d'une soumission ODK élève, haut : photo de l'élève bien visible en haut à gauche, identité complète à droite (nom, post-nom, prénom, date et lieu de naissance), âge calculé automatiquement</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Vue détaillée d'une soumission ODK élève, milieu : statut migratoire, situation parentale, informations scolaires (école, classe, option, section), coordonnées GPS de l'école, notes et présences saisies si disponibles</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Vue détaillée d'une soumission ODK élève, bas : statut "Non validée" en badge orange, bouton "Valider ce formulaire" en bleu, bouton "Retour à la liste"</callout>`

Éléments de contrôle essentiels lors de la consultation :

<table id="bkmrk-%C3%89l%C3%A9ment-ce-qu%27il-fau"><thead><tr><th>Élément</th><th>Ce qu'il faut contrôler</th></tr></thead><tbody><tr><td>**Photo de l'élève**</td><td>Visible, nette, correspond à une personne réelle et mineure</td></tr><tr><td>**Identité**</td><td>Nom, prénom, date de naissance cohérents et sans fautes manifestes</td></tr><tr><td>**Âge**</td><td>L'âge calculé automatiquement est cohérent avec le niveau scolaire déclaré</td></tr><tr><td>**École et classe**</td><td>Cohérents avec la zone de collecte de l'enquêteur</td></tr><tr><td>**Statut migratoire**</td><td>Valeur correcte parmi les options disponibles</td></tr><tr><td>**Notes et présences**</td><td>Si renseignées, valeurs dans des plages réalistes (moyennes entre 0 et 100)</td></tr><tr><td>**Doublon potentiel**</td><td>Si un avertissement de doublon possible est affiché, vérifiez avant de valider</td></tr></tbody></table>

### Valider des élèves

**Validation individuelle :**  
1\. Sur la ligne de l'élève à valider, cliquez sur le bouton **Valider** (coche verte).  
2\. Une fenêtre de confirmation s'affiche avec le récapitulatif de la fiche.  
3\. Confirmez. L'élève est créée (si nouvelle) ou mise à jour (si fiche existante avec le même UID) en base de production.

**Validation en masse :**  
1\. Cochez plusieurs lignes dans le tableau (ou cochez tout via la case d'en-tête).  
2\. Cliquez sur le bouton **Valider les X élèves sélectionnées** dans le bandeau de sélection.  
3\. Confirmez dans la fenêtre de confirmation.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Bandeau de sélection multiple avec plusieurs élèves cochées : "X élèves sélectionnées — Valider les X élèves sélectionnées | Vider la sélection"</callout>`

**Import par UIDs :** Même fonctionnement que pour les écoles — bouton **Validation par UIDs**, saisie manuelle ou import de fichier texte.

⚠️ **Attention au rapprochement automatique :** Lorsqu'une fiche élève est validée, le système vérifie automatiquement si une bénéficiaire avec le même UID existe déjà en base. Si c'est le cas, il met à jour la fiche existante plutôt qu'en créer une nouvelle. En cas d'alerte de doublon potentiel, consultez impérativement la fiche existante avant de confirmer la validation pour éviter toute confusion entre deux élèves distinctes.

---

# B.4.4.4 — Validation des données tuteurs

## 4.4 Validation des données tuteurs

### Accéder à la page

Menu latéral → **Données Collectées → Données tuteurs**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page Données tuteurs complète : onglets Non validé / Validé, boutons Validation par UIDs / Exporter en Excel / Filtrer, tableau avec ses colonnes, pagination en bas</callout>`

### Colonnes du tableau des données tuteurs

<table id="bkmrk-colonne-description-"><thead><tr><th>Colonne</th><th>Description</th></tr></thead><tbody><tr><td>**Enquêteur**</td><td>Code de l'enquêteur ayant collecté les données du tuteur</td></tr><tr><td>**Nom du tuteur**</td><td>Nom, post-nom et prénom du tuteur identifié</td></tr><tr><td>**Téléphone**</td><td>Numéro de téléphone principal du tuteur (souvent identique au numéro M-Pesa)</td></tr><tr><td>**École**</td><td>École de référence où le tuteur a été identifié lors de la collecte</td></tr><tr><td>**Nb enfants bénéficiaires**</td><td>Nombre d'élèves filles déclarées sous la responsabilité de ce tuteur dans l'école</td></tr><tr><td>**Situation de handicap**</td><td>Présence ou non d'une situation de handicap déclarée pour le tuteur</td></tr><tr><td>**Compte M-Pesa**</td><td>Numéro de téléphone M-Pesa renseigné lors de la collecte (destinataire des bourses)</td></tr><tr><td>**Actions**</td><td>Bouton Voir le détail et bouton Valider</td></tr></tbody></table>

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Tableau des données tuteurs non validées : colonnes complètes avec exemples de données, notamment le numéro de téléphone et le compte M-Pesa visibles</callout>`

### Vérification critique avant validation d'une fiche tuteur

La validation d'un tuteur est une étape de vérification **particulièrement rigoureuse**. Le tuteur est le réceptionnaire direct des fonds M-Pesa versés au nom des élèves bénéficiaires. Une erreur dans les coordonnées bancaires ou dans l'identité du tuteur peut entraîner un virement frauduleux ou erroné.

**Consultez systématiquement le détail complet avant de valider toute fiche tuteur.**

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Vue détaillée d'une soumission ODK tuteur, haut : photo du tuteur bien visible et nette, identité complète (nom, post-nom, prénom, date de naissance), genre, profession</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Vue détaillée d'une soumission ODK tuteur, milieu : photo de la pièce d'identité (carte nationale ou autre document) bien lisible, numéro de la pièce d'identité, coordonnées de contact (téléphone, WhatsApp), numéro M-Pesa</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Vue détaillée d'une soumission ODK tuteur, bas : liste des élèves bénéficiaires déclarées sous sa responsabilité (avec leur nom et leur école), situation de handicap, statut "Non validé", boutons Valider et Retour</callout>`

Éléments à contrôler **impérativement** :

<table id="bkmrk-%C3%89l%C3%A9ment-ce-qu%27il-fau"><thead><tr><th>Élément</th><th>Ce qu'il faut contrôler</th></tr></thead><tbody><tr><td>**Photo du tuteur**</td><td>Visible, nette, correspond à une personne adulte réelle</td></tr><tr><td>**Photo de la pièce d'identité**</td><td>Lisible, non tronquée, appartient clairement au tuteur (même visage)</td></tr><tr><td>**Numéro de téléphone M-Pesa**</td><td>Renseigné, 10 chiffres, format local correct (ex : 08XXXXXXXX)</td></tr><tr><td>**Lien avec les élèves**</td><td>Le nombre d'élèves déclarées est cohérent avec les données de collecte de l'école</td></tr><tr><td>**Absence de doublon**</td><td>Vérifier qu'il ne s'agit pas d'un tuteur déjà enregistré avec un numéro différent</td></tr><tr><td>**Consentement**</td><td>La fiche de consentement a été signée ou validée dans le formulaire ODK</td></tr></tbody></table>

### Valider des tuteurs

**Validation individuelle :** Bouton **Valider** sur la ligne → fenêtre de confirmation → **Confirmer**.

**Validation en masse :** Cocher plusieurs lignes → bouton **Valider les X tuteurs sélectionnés** → confirmer.

**Import par UIDs :** Même fonctionnement que pour les écoles et les élèves.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fenêtre de confirmation de validation d'un tuteur : récapitulatif (nom du tuteur, téléphone, numéro M-Pesa, nombre d'élèves liées), avertissement "Vérifiez que les coordonnées M-Pesa sont correctes avant de confirmer", boutons Annuler et Confirmer</callout>`

---

# B.4.4.5 — Bonnes pratiques — Validation des données ODK

## 4.5 Bonnes pratiques — Validation des données ODK

**Traiter les validations régulièrement, sans laisser s'accumuler.** Idéalement, traitez les nouvelles soumissions dans les 24 à 48 heures suivant la fin d'une session de collecte terrain. Un retard de validation retarde toute la chaîne en aval (paiements, rapports, contrôles).

**Ne validez jamais en masse sans avoir contrôlé un échantillon.** Avant toute validation groupée post-campagne, consultez le détail d'au moins 10 à 20% des soumissions pour vous assurer de la qualité globale de la collecte. Si des anomalies récurrentes sont détectées chez un enquêteur spécifique, traitez ses soumissions individuellement.

**Signalez les photos illisibles.** Si les photos de documents (arrêté ministériel, pièce d'identité du tuteur) sont floues, tronquées ou absentes, ne validez pas la soumission. Contactez l'enquêteur pour une nouvelle collecte sur le terrain.

**Vérifiez les numéros M-Pesa avant de valider un tuteur.** Un numéro incorrect entraîne un virement vers un mauvais destinataire. Ce type d'erreur est difficile à corriger après paiement et peut générer des réclamations.

**Utilisez les filtres pour travailler de manière organisée.** Filtrez par enquêteur ou par Sous-PROVED pour traiter les soumissions zone par zone et maintenir une traçabilité cohérente de votre travail de validation.

---

*Fin du chapitre B.4 — Validation des données ODK*

---

---

# B.5 — Gestion des écoles

Chapitre B.5 du Manuel PIGBF

# B.5.5.1 — Vue d'ensemble

## 5.1 Vue d'ensemble

Le module **Écoles**, accessible depuis **Bénéficiaires → Écoles**, permet à l'Admin ONG de consulter, créer, modifier et gérer les établissements scolaires relevant du périmètre de son ONG dans le programme PAAF.

Ce module est intimement lié au module de validation ODK (B.4) : les écoles sont principalement créées via la validation des formulaires terrain, puis complétées et maintenues depuis cette interface. Une école doit être correctement documentée avant de pouvoir prétendre recevoir les versements Equity BCDC du programme.

🔒 **Accès Admin IT ONG :** L'Admin IT ONG dispose d'un accès en **lecture seule** sur ce module. Il peut consulter les fiches des écoles mais ne peut pas les créer, les modifier ni les supprimer. Les opérations de modification sont réservées à l'Admin ONG.

Accès : menu latéral → **Bénéficiaires → Écoles**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Menu latéral déroulé avec la section "Gestion des bénéficiaires" visible : sous-menus Bénéficiaires (élèves), Écoles, Tuteurs listés sous le groupe. L'entrée "Écoles" est mise en évidence</callout>`

---

# B.5.5.2 — Liste des écoles

## 5.2 Liste des écoles

### Accéder à la liste

Dans le menu latéral, cliquez sur **Bénéficiaires → Écoles**. La page affiche le tableau des établissements scolaires de l'ONG enregistrés dans la PIGBF pour l'année scolaire active.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page liste des écoles complète : barre de recherche en haut à droite, bouton Filtrer, tableau avec toutes ses colonnes, pagination en bas (ex : "Affichage de 1 à 10 sur 324 établissements"). Bouton "+ Ajouter une école" en haut à droite</callout>`

### Colonnes du tableau

<table id="bkmrk-colonne-description-"><thead><tr><th>Colonne</th><th>Description</th></tr></thead><tbody><tr><td>**Enquêteur**</td><td>Identifiant de l'enquêteur ayant collecté les données de l'école sur le terrain lors de la première soumission</td></tr><tr><td>**École**</td><td>Nom complet de l'établissement scolaire</td></tr><tr><td>**Province / PROVED / Sous-PROVED**</td><td>Hiérarchie administrative éducative sur trois niveaux</td></tr><tr><td>**Num. SECOPE**</td><td>Numéro de mécanisation officiel de l'école. Badge **vert** si renseigné, badge **orange "Non disponible"** si absent</td></tr><tr><td>**Arrêté Min.**</td><td>Référence et date de signature de l'arrêté ministériel d'agrément de l'école + nombre de pages photographiées</td></tr><tr><td>**PV Réunion**</td><td>Procès-verbal de réunion fixant les frais scolaires — lien vers les pages photographiées ou *"Non disponible"*</td></tr><tr><td>**Tranches**</td><td>Montants estimés par tranche de paiement Equity BCDC, calculés sur la base des élèves éligibles rattachées</td></tr><tr><td>**Actions**</td><td>Icônes **Voir** (œil) / **Modifier** (crayon) / **Supprimer** (corbeille)</td></tr></tbody></table>

### Filtres de recherche disponibles

Cliquez sur le bouton **Filtrer** pour ouvrir le panneau de filtres et affiner l'affichage.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Panneau de filtres ouvert sur la liste des écoles : filtres PROVED (liste déroulante), Sous-PROVED (cascade), Statut validation paiement (Tous / Validée / Non validée), Statut SECOPE (Tous / Avec SECOPE / Sans SECOPE), Enquêteur (liste déroulante) ; bouton Réinitialiser les filtres</callout>`

<table id="bkmrk-filtre-description-p"><thead><tr><th>Filtre</th><th>Description</th></tr></thead><tbody><tr><td>**PROVED**</td><td>Filtrer par province éducationnelle</td></tr><tr><td>**Sous-PROVED**</td><td>Se remplit en cascade selon le PROVED sélectionné</td></tr><tr><td>**Statut validation paiement**</td><td>Tous / Validée pour paiement / Non validée pour paiement</td></tr><tr><td>**Statut SECOPE**</td><td>Tous / Avec numéro SECOPE / Sans numéro SECOPE (utile pour identifier les écoles à compléter)</td></tr><tr><td>**Enquêteur**</td><td>Filtrer les écoles collectées par un enquêteur spécifique</td></tr></tbody></table>

---

# B.5.5.3 — Fiche détaillée d'une école

## 5.3 Fiche détaillée d'une école

Cliquez sur l'icône **Voir** (œil) d'une école pour accéder à sa fiche complète. C'est la vue la plus exhaustive des informations disponibles sur un établissement.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée d'une école, haut de page : nom de l'école en titre, badge indiquant le statut de validation paiement (Validée pour paiement / Non validée pour paiement), bouton "Modifier" en haut à droite, bouton "Retour à la liste"</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée d'une école, section Informations administratives : N° SECOPE avec badge vert ou orange, Arrêté Ministériel (numéro de référence, date de signature, nombre de pages, miniatures cliquables des photos des pages), PV de Réunion (date, miniatures des pages photographiées)</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée d'une école, section Localisation : Province, PROVED, Sous-PROVED, Territoire, Secteur, Groupement, Village, coordonnées GPS (latitude/longitude) affichées avec lien vers la carte</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée d'une école, section Informations pédagogiques : liste des classes disponibles dans l'établissement avec leurs sections et options associées</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée d'une école, section Frais scolaires : tableau des montants validés par type de frais et par période scolaire</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée d'une école, section Préfet(s) associé(s) : photo du préfet, nom complet, genre, coordonnées de contact</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée d'une école, section Compte de paiement Equity BCDC : numéro de compte, nom de l'agence bancaire, statut du compte (actif / inactif)</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée d'une école, section Bénéficiaires : compteur total d'élèves boursières rattachées, liste des 10 premières avec nom, classe et statut paiement</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée d'une école, section Historique des modifications : tableau chronologique des actions (création, mises à jour) avec auteur, date/heure et champs modifiés</callout>`

La fiche est organisée en plusieurs sections :

**Informations administratives**  
Nom complet de l'établissement, numéro SECOPE (avec photos si disponibles), référence de l'arrêté ministériel d'agrément (numéro, date de signature, nombre de pages photographiées), PV de réunion fixant les frais scolaires (date, miniatures des pages photographiées cliquables pour agrandissement).

**Localisation**  
Province, PROVED, Sous-PROVED, territoire, secteur, groupement, village, coordonnées GPS (latitude/longitude) capturées lors de la collecte ODK. Un lien peut rediriger vers une carte en ligne pour visualiser la position géographique.

**Informations pédagogiques**  
Classes et options dispensées dans l'établissement, niveaux d'enseignement (primaire, secondaire, humanités générales, humanités techniques, etc.), tels que renseignés via le formulaire ODK de classes et options.

**Frais scolaires**  
Montants validés par type de frais (frais d'inscription, frais de scolarité, etc.) et par période, tels que collectés via le formulaire ODK de frais scolaires et validés par l'administrateur.

**Comptes de paiement Equity BCDC**  
Numéro de compte bancaire Equity BCDC et coordonnées complètes destinées à recevoir les virements du programme pour cet établissement.

**Préfet(s) rattaché(s)**  
Photo, identité et coordonnées du ou des responsables d'établissement associés à cette école dans la plateforme.

**Bénéficiaires**  
Nombre total d'élèves filles boursières rattachées à cet établissement pour l'année active, avec liste partielle et lien vers la liste complète.

**Historique des modifications**  
Traçabilité complète de toutes les mises à jour effectuées sur la fiche depuis sa création : auteur, date/heure précise et liste des champs modifiés.

---

# B.5.5.4 — Ajouter une école manuellement

## 5.4 Ajouter une école manuellement

Bien que les écoles soient principalement créées via la validation des formulaires ODK terrain (cf. chapitre B.4), un formulaire de saisie manuelle est disponible pour les cas particuliers : école hors-couverture ODK, correction d'urgence, ajout d'un établissement découvert après la campagne de collecte.

1. Cliquez sur le bouton **+ Ajouter une école** en haut à droite de la liste.
2. Le formulaire de création s'ouvre.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Formulaire "Ajouter une école" complet : champs Nom (obligatoire), Province / PROVED / Sous-PROVED (sélecteurs en cascade, obligatoires), N° SECOPE, champs Arrêté Ministériel, champs de localisation géographique fine (Territoire, Secteur, Groupement, Village), coordonnées GPS, informations frais scolaires, boutons Annuler et Enregistrer</callout>`

3. Renseignez les informations **obligatoires** :  
    \- **Nom** de l'école (obligatoire)  
    \- **Province**, **PROVED**, **Sous-PROVED** (obligatoires — sélecteurs en cascade)
4. Complétez autant que possible les informations complémentaires :  
    \- **N° SECOPE** — numéro de mécanisation officiel de l'établissement  
    \- **Arrêté ministériel** — numéro de référence et date de signature  
    \- **Localisation géographique fine** — territoire, secteur, groupement, village  
    \- **Coordonnées GPS** — latitude et longitude si disponibles  
    \- **Frais scolaires** — montants par type de frais
5. Cliquez sur **Enregistrer**.

ℹ️ **Note :** Une école créée manuellement doit ensuite être complétée avec les informations manquantes (compte Equity BCDC, préfet) via les formulaires de modification. Elle ne sera éligible aux paiements qu'une fois toutes les informations critiques renseignées et validée pour paiement.

---

# B.5.5.5 — Modifier une école

## 5.5 Modifier une école

Utilisez la modification pour compléter ou corriger les informations d'une école déjà enregistrée : ajout du numéro SECOPE récupéré après coup, correction d'une ortographe, mise à jour du compte bancaire, etc.

1. Dans la liste, cliquez sur l'icône **Modifier** (crayon) de l'école concernée.
2. Le formulaire de modification s'ouvre avec toutes les informations actuelles pré-remplies.
3. Apportez les corrections souhaitées dans les champs concernés.
4. Cliquez sur **Mettre à jour**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Formulaire de modification d'une école pré-rempli : tous les champs visibles avec leurs valeurs actuelles modifiables, boutons Annuler et Mettre à jour</callout>`

ℹ️ **Note :** Toute modification sur une fiche école est automatiquement enregistrée dans l'historique des activités avec l'identité de l'auteur et l'horodatage précis. Cette traçabilité garantit la transparence et permet de remonter à l'origine de toute modification en cas de litige ou d'audit.

---

# B.5.5.6 — Supprimer une école

## 5.6 Supprimer une école

1. Dans la liste, cliquez sur l'icône **Supprimer** (corbeille) de l'école concernée.
2. Une fenêtre de confirmation s'affiche, mentionnant le nom de l'école et avertissant des conséquences.
3. Confirmez la suppression.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fenêtre de confirmation de suppression d'une école : titre "Supprimer l'école", nom de l'école en rouge, message d'avertissement sur les conséquences (perte des données liées), boutons "Annuler" et "Supprimer définitivement" (rouge)</callout>`

⚠️ **Attention :** La suppression d'une école est **bloquée** si des bénéficiaires actives ou des instructions de paiement en cours ou déjà réalisées y sont rattachées. Le système affiche un message d'erreur listant les dépendances existantes. Traitez ces dépendances (désassociation des élèves, vérification des paiements) avant toute suppression.

⚠️ **Irréversibilité :** La suppression est définitive. En cas de doute sur la validité d'une fiche d'école, il est préférable de la laisser en l'état et de contacter votre coordinateur PAAF plutôt que de la supprimer.

---

# B.5.5.7 — Gestion des préfets

## 5.7 Gestion des préfets

### Rôle du préfet dans la PIGBF

Le préfet est le responsable légal de l'établissement scolaire. Son identification est obligatoire dans la PIGBF car il est l'interlocuteur de référence du programme au niveau de l'école : il signe les documents officiels liés à la bourse (listes de présence, PV de réunion), certifie les informations de l'établissement et est redevable vis-à-vis du programme PAAF.

### Accéder à la liste des préfets

Menu latéral → **Bénéficiaires → Écoles** → sous-onglet ou sous-menu **Préfets**.

Alternativement, depuis la fiche d'une école, cliquez sur la section **Préfets** ou sur le lien vers la liste des préfets de cet établissement.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page liste des préfets : tableau avec colonnes Nom, Post-nom, Prénom, Genre, École associée, PROVED, Sous-PROVED, Actions (Voir / Modifier / Supprimer) ; filtres PROVED, Sous-PROVED, École, Genre disponibles en haut ; bouton "+ Ajouter un préfet"</callout>`

### Colonnes du tableau des préfets

<table id="bkmrk-colonne-description-"><thead><tr><th>Colonne</th><th>Description</th></tr></thead><tbody><tr><td>**Nom / Post-nom / Prénom**</td><td>Identité complète du préfet</td></tr><tr><td>**Genre**</td><td>Homme ou Femme</td></tr><tr><td>**École associée**</td><td>Établissement dont il est responsable</td></tr><tr><td>**PROVED / Sous-PROVED**</td><td>Hiérarchie administrative de l'école associée (informations déduites)</td></tr><tr><td>**Actions**</td><td>Voir / Modifier / Supprimer</td></tr></tbody></table>

### Filtres disponibles

<table id="bkmrk-filtre-description-p"><thead><tr><th>Filtre</th><th>Description</th></tr></thead><tbody><tr><td>**PROVED**</td><td>Filtrer par province éducationnelle</td></tr><tr><td>**Sous-PROVED**</td><td>Se remplit en cascade selon le PROVED</td></tr><tr><td>**École**</td><td>Filtrer les préfets d'un établissement spécifique</td></tr><tr><td>**Genre**</td><td>Filtrer par genre (Homme / Femme)</td></tr></tbody></table>

### Consulter la fiche d'un préfet

Cliquez sur l'icône **Voir** (œil) d'un préfet pour afficher sa fiche détaillée.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée d'un préfet : photo (si disponible), identité complète (Nom, Post-nom, Prénom, Date de naissance, Genre), coordonnées de contact (téléphone, email si disponibles), école associée avec lien vers sa fiche, historique des modifications</callout>`

### Ajouter un préfet manuellement

Les préfets peuvent être créés via la collecte ODK (lors de la soumission du formulaire de données écoles) ou directement depuis cette interface.

1. Cliquez sur **+ Ajouter un préfet**.
2. Le formulaire de création s'ouvre.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Formulaire "Ajouter un préfet" : champs Nom (obligatoire), Post-nom, Prénom (obligatoire), liste déroulante Genre (Homme / Femme), liste déroulante École de rattachement (obligatoire), champs Téléphone et Email, boutons Annuler et Enregistrer</callout>`

3. Renseignez les informations :  
    \- **Nom** (obligatoire)  
    \- **Prénom** (obligatoire)  
    \- **Genre** (Homme / Femme)  
    \- **École de rattachement** (obligatoire) — sélectionnez l'établissement dans la liste déroulante  
    \- **Téléphone** et **Email** (optionnels mais recommandés pour faciliter les communications)
4. Cliquez sur **Enregistrer**.

### Modifier un préfet

1. Dans la liste, cliquez sur l'icône **Modifier** (crayon) du préfet concerné.
2. Le formulaire s'ouvre avec les informations actuelles pré-remplies.
3. Apportez les modifications.
4. Cliquez sur **Mettre à jour**.

### Supprimer un préfet

1. Cliquez sur l'icône **Supprimer** (corbeille) du préfet.
2. Une fenêtre de confirmation s'affiche.
3. Confirmez.

⚠️ **Note :** La suppression d'un préfet est bloquée s'il est encore associé à des établissements actifs. Désassociez-le d'abord des écoles concernées.

---

# B.5.5.8 — Traitement des doublons d'écoles

## 5.8 Traitement des doublons d'écoles

### Pourquoi des doublons apparaissent-ils ?

Lors de campagnes de collecte successives, un même établissement peut être saisi plusieurs fois sous des orthographes légèrement différentes (ex. : *"INST TSHIYEMBE MUAYILA"* vs *"INSTITUT TSHIYEMBE MUAYILA"*), ou deux enquêteurs différents peuvent avoir collecté la même école lors de la même campagne. Ces situations créent des doublons dans la base de données.

### Accéder au traitement des doublons

Menu latéral → **Bénéficiaires → Écoles** → sous-menu ou onglet **Traitement des doublons**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page traitement des doublons d'écoles : liste de paires d'écoles potentiellement en doublon présentées dans des blocs comparatifs côte à côte. Pour chaque paire : nom de chaque école, SECOPE, Sous-PROVED, nombre de bénéficiaires rattachées, score de similarité en pourcentage. Boutons "Fusionner", "Confirmer deux écoles distinctes" visibles pour chaque paire</callout>`

### Comprendre les paires signalées

L'algorithme de détection compare les noms, les numéros SECOPE, les localisations géographiques et d'autres attributs pour identifier les paires similaires. Un **score de similarité** (en pourcentage) indique la probabilité que les deux fiches correspondent au même établissement. Plus le score est élevé, plus il est probable qu'il s'agisse d'un doublon.

### Résoudre un doublon

Pour chaque paire signalée, examinez les informations des deux fiches côte à côte et prenez l'une des décisions suivantes :

**Fusionner**  
Les deux fiches concernent le même établissement. Sélectionnez la fiche de référence (celle dont les informations sont les plus complètes ou les plus à jour). Toutes les données de la fiche secondaire (bénéficiaires rattachées, historique de paiements, documents photographiés) sont rapatriées sur la fiche principale. La fiche secondaire est supprimée.

**Confirmer deux écoles distinctes**  
Malgré la ressemblance des noms, les deux fiches correspondent à des établissements différents (deux écoles portant un nom similaire dans des localités différentes, par exemple). Les deux fiches sont conservées et la paire est ignorée des résultats futurs.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Vue comparative d'une paire de doublons : deux colonnes affichant les informations de chaque fiche (Nom, SECOPE, Localisation, Préfet, Nombre de bénéficiaires), score de similarité en haut, boutons de décision en bas</callout>`

⚠️ **Attention — La fusion est irréversible.** Avant toute fusion, vérifiez systématiquement :  
\- Les numéros SECOPE (deux numéros différents = probablement deux écoles distinctes)  
\- Les localisations géographiques (Sous-PROVED, village)  
\- Les noms des préfets  
\- Les photos des documents (arrêtés ministériels différents = écoles distinctes)

Une fusion incorrecte (fusion de deux écoles réellement différentes) est très difficile à corriger et peut compromettre l'intégrité du registre des bénéficiaires et des paiements.

---

# B.5.5.9 — Bonnes pratiques — Gestion des écoles

## 5.9 Bonnes pratiques — Gestion des écoles

**Complétez les fiches sans SECOPE en priorité.** Les écoles sans numéro SECOPE sont identifiées par un badge orange dans la liste. Utilisez le filtre *"Sans numéro SECOPE"* pour les identifier rapidement et prendre les dispositions nécessaires pour récupérer ce numéro auprès des autorités locales ou via une nouvelle collecte ODK.

**Vérifiez les comptes Equity BCDC avant la génération des instructions de paiement.** Un numéro de compte incorrect ou manquant bloque le paiement de tous les élèves rattachés à cet établissement. Faites une vérification complète de ce champ sur toutes les écoles actives avant chaque campagne de paiement.

**Traitez les doublons dès leur détection.** Ne laissez pas les doublons s'accumuler. Chaque doublon non traité peut conduire à des bénéficiaires rattachées à la mauvaise fiche école, faussant les statistiques et compliquant les paiements.

**Documentez les modifications importantes.** Bien que l'historique des modifications soit automatiquement tracé, il est recommandé de noter les raisons des changements significatifs (correction de compte bancaire, changement de préfet) dans un registre interne pour faciliter les audits.

---

*Fin du chapitre B.5 — Gestion des écoles*

---

# B.6 — Gestion des élèves

Chapitre B.6 du Manuel PIGBF

# B.6.6.1 — Vue d'ensemble

## 6.1 Vue d'ensemble

Le module **Bénéficiaires → Élèves** est le **cœur opérationnel de la PIGBF** pour l'Admin ONG. Il centralise l'intégralité des informations relatives aux élèves filles identifiées comme bénéficiaires du programme de bourses dans le périmètre de l'ONG. C'est sur ce module que reposent toutes les décisions financières du programme : une élève sans fiche validée et éligible ne peut pas être incluse dans une instruction de paiement.

Chaque bénéficiaire est identifiée par un **UID (Unique Identifier)** généré automatiquement par la plateforme lors de la première validation de sa fiche ODK. Un **QR Code** est également généré à partir de cet UID, destiné à être imprimé sur sa carte de bénéficiaire pour faciliter son identification sur le terrain lors des visites de suivi.

Ce module accompagne le **cycle de vie complet** d'une bénéficiaire :

1. Identification sur le terrain via ODK → zone de staging
2. Validation et transfert en base de production (cf. chapitre B.4)
3. Suivi du parcours scolaire (classe, section, option)
4. Collecte et saisie des notes et présences semestrielles
5. Validation de l'éligibilité au paiement
6. Inclusion dans les instructions de paiement (Equity ou M-Pesa selon le percepteur désigné)
7. Suivi des paiements reçus et des éventuels abandons

🔒 **Accès Admin IT ONG :** L'Admin IT ONG dispose d'un accès en **lecture seule** sur ce module. Il peut consulter les fiches des élèves mais ne peut pas les créer, les modifier, les supprimer ni les valider pour paiement. Ces opérations sont réservées à l'Admin ONG.

Accès : menu latéral → **Bénéficiaires → Élèves**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Menu latéral avec la section "Gestion des bénéficiaires" déroulée : sous-menus Bénéficiaires (élèves), Écoles, Tuteurs. L'entrée "Bénéficiaires" ou "Élèves" est mise en évidence</callout>`

---

# B.6.6.2 — Liste des élèves et recherche

## 6.2 Liste des élèves et recherche

### Accéder à la liste

Cliquez sur **Bénéficiaires** dans le menu latéral, puis sélectionnez **Élèves** (ou cliquez directement sur **Bénéficiaires** si c'est l'entrée directe). La liste complète des bénéficiaires enregistrées et validées pour l'année scolaire active s'affiche dans un tableau paginé, filtré automatiquement sur le périmètre de l'ONG.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page liste des élèves complète : zone de filtres avancés en haut (dépliée ou repliée selon la configuration), tableau principal en dessous avec colonnes Nom complet de l'élève, UID (badge coloré avec code court), École, Classe, Option, Statut migratoire, Statut bourse, Actions (icônes Voir / Modifier / Supprimer). Bouton "+ Ajouter une élève" en haut à droite. Indicateur du nombre total de résultats visible en bas (ex : "Affichage de 1 à 10 sur 49 047 bénéficiaires")</callout>`

### Colonnes du tableau principal

<table id="bkmrk-colonne-description-"><thead><tr><th>Colonne</th><th>Description</th></tr></thead><tbody><tr><td>**Nom complet**</td><td>Nom, post-nom et prénom de la bénéficiaire</td></tr><tr><td>**UID**</td><td>Identifiant unique de la bénéficiaire dans la PIGBF (badge coloré avec code court de 6 caractères, ex. *6F99BN*)</td></tr><tr><td>**École**</td><td>Établissement scolaire de rattachement</td></tr><tr><td>**Classe**</td><td>Niveau scolaire (ex. : *4ème Humanités*)</td></tr><tr><td>**Option**</td><td>Option pédagogique (ex. : *Pédagogie générale*, *Commerce*, etc.)</td></tr><tr><td>**Statut migratoire**</td><td>Résidente / Déplacée / Réfugiée / Rapatriée</td></tr><tr><td>**Statut bourse**</td><td>Indicateur visuel du statut de la bourse (active, suspendue, abandonnée)</td></tr><tr><td>**Actions**</td><td>Icônes **Voir** (œil) / **Modifier** (crayon) / **Supprimer** (corbeille)</td></tr></tbody></table>

### Filtres de recherche avancés

Le moteur de recherche de la liste des élèves est l'un des plus complets de la plateforme. Cliquez sur le bouton **Filtres** (ou sur la zone de filtres si elle est déjà visible) pour accéder à l'ensemble des critères de recherche.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Zone de filtres complète de la liste élèves dépliée : première rangée avec champs texte (Nom / Postnom / Prénom / UID / Numéro SERNIE / Téléphone / WhatsApp / Email) ; deuxième rangée avec sélecteurs (Statut migratoire, Situation parentale, Statut handicap, Situation d'étude) ; troisième rangée avec filtres géographiques (Province, PROVED, Sous-PROVED, École, Classe, Section, Option) ; quatrième rangée avec filtres paiements (Avec bourse / Sans bourse, Première tranche payée, Deuxième tranche payée) ; boutons "Appliquer les filtres" et "Réinitialiser"</callout>`

<table id="bkmrk-cat%C3%A9gorie-de-filtre-"><thead><tr><th>Catégorie de filtre</th><th>Critères disponibles</th></tr></thead><tbody><tr><td>**Recherche texte**</td><td>Nom, post-nom, prénom, UID (code court), numéro SERNIE, numéro de téléphone, WhatsApp, email</td></tr><tr><td>**Caractéristiques personnelles**</td><td>Statut migratoire (Résidente / Déplacée / Réfugiée / Rapatriée), situation parentale, situation de handicap (Avec / Sans), âge (fourchette min-max)</td></tr><tr><td>**Localisation scolaire**</td><td>Province, PROVED, Sous-PROVED (cascades), école spécifique, classe, section, option</td></tr><tr><td>**Statut du dossier**</td><td>Avec ou sans numéro SERNIE renseigné</td></tr><tr><td>**Parcours**</td><td>Situation d'étude (En cours / Abandonnée)</td></tr><tr><td>**Paiements**</td><td>Avec ou sans bourse attribuée, 1ère tranche payée / non payée, 2ème tranche payée / non payée</td></tr></tbody></table>

Le bouton **Réinitialiser** efface tous les critères et revient à la liste complète.

> ℹ️ **Combinaison de filtres :** Tous les filtres sont cumulatifs (logique ET). Par exemple : *Classe = "4ème Humanités" + Statut migratoire = "Déplacée" + Sous-PROVED = "Tshikapa 1"* affiche uniquement les élèves en 4ème Humanités, déplacées, dans la Sous-PROVED de Tshikapa 1. Cette combinaison est particulièrement utile pour produire des listes ciblées avant une campagne de validation ou de suivi.

### Exporter la liste filtrée

En haut du tableau, le bouton **Exporter en Excel** génère un fichier Excel correspondant aux résultats actuellement affichés (filtres actifs inclus). Pour les volumes importants, le fichier est généré en arrière-plan et envoyé par email à l'adresse de l'utilisateur connecté.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Bouton "Exporter en Excel" mis en évidence en haut à droite du tableau, avec la liste filtrée visible dessous</callout>`

---

# B.6.6.3 — Fiche détaillée d'une élève

## 6.3 Fiche détaillée d'une élève

La fiche d'une bénéficiaire est la vue la plus complète et la plus importante de son dossier. Elle regroupe toutes les informations collectées sur le terrain et renseignées dans la plateforme.

### Accéder à la fiche

Cliquez sur l'icône **Voir** (œil) sur la ligne de l'élève dans la liste. La fiche s'ouvre dans la zone de contenu principale.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée d'une bénéficiaire, vue d'ensemble : photo de l'élève et QR Code côte à côte en haut à gauche sur un fond coloré (bleu ou vert selon le statut), UID en badge coloré (ex. "6F99BN"), nom complet en grand titre ("KABANGA MPOYI CARINE"), bouton "Modifier" en haut à droite, bouton "Retour à la liste" ; deux ou trois colonnes de sections en dessous</callout>`

La fiche est organisée en plusieurs sections :

### Section 1 — Identité et photo

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section identité : photo de l'élève en cadre arrondi, QR Code à côté avec bouton "Télécharger le QR Code", UID en badge (ex. "6F99BN"), code humain si généré, boutons d'action (Modifier, Imprimer la fiche)</callout>`

- **Photo** : photo de l'élève prise lors de la collecte ODK
- **UID** : identifiant unique permanent, jamais modifiable, utilisé pour tous les rapprochements de données
- **QR Code** : généré automatiquement à partir de l'UID — à imprimer sur la carte de bénéficiaire ou à scanner lors des visites de suivi terrain
- **Code humain** : code court lisible généré par la plateforme pour faciliter la référence orale ou écrite à la bénéficiaire

### Section 2 — Informations personnelles

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Informations personnelles" : Lieu de naissance (ex. "Tshikapa"), Date de naissance (ex. "15/03/2009"), Âge calculé automatiquement (ex. "16 ans"), Statut migratoire (badge coloré "Résidente"), Situation de handicap ("Non"), Numéro SERNIE (si renseigné), Situation familiale des parents, Nombre de frères et sœurs au foyer, Nombre d'enfants dans la même école</callout>`

<table id="bkmrk-champ-description-li"><thead><tr><th>Champ</th><th>Description</th></tr></thead><tbody><tr><td>**Lieu de naissance**</td><td>Ville ou village déclaré lors de la collecte ODK</td></tr><tr><td>**Date de naissance**</td><td>Date déclarée ; l'âge est calculé automatiquement par la plateforme</td></tr><tr><td>**Statut migratoire**</td><td>Résidente, Déplacée, Réfugiée ou Rapatriée (badge coloré selon le statut)</td></tr><tr><td>**Situation de handicap**</td><td>Oui / Non — si "Oui", la nature du besoin est précisée</td></tr><tr><td>**Numéro SERNIE**</td><td>Identifiant national scolaire de l'élève (si renseigné par l'enquêteur)</td></tr><tr><td>**Situation familiale**</td><td>Statut des parents (ex. : *Mariés*, *Orpheline de père*, *Orpheline des deux parents*, etc.)</td></tr><tr><td>**Frères et sœurs au foyer**</td><td>Nombre d'enfants vivant dans le même foyer</td></tr><tr><td>**Dans la même école**</td><td>Nombre de frères ou sœurs fréquentant le même établissement</td></tr></tbody></table>

### Section 3 — Parcours scolaire

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Parcours scolaire" : École (lien cliquable vers la fiche de l'école), Classe (ex. "4ème Humanités"), Section (ex. "Humanités Pédagogiques"), Option (ex. "Pédagogie générale"), Année scolaire en badge actif (ex. "2024-2025")</callout>`

<table id="bkmrk-champ-description-%C3%89c"><thead><tr><th>Champ</th><th>Description</th></tr></thead><tbody><tr><td>**École**</td><td>Lien cliquable redirigeant directement vers la fiche de l'établissement</td></tr><tr><td>**Classe**</td><td>Niveau scolaire exact (ex. : *6ème EB, 1ère H, 4ème H*)</td></tr><tr><td>**Section**</td><td>Section pédagogique (Primaire, Humanités Générales, Humanités Techniques, etc.)</td></tr><tr><td>**Option**</td><td>Option suivie par l'élève dans la section concernée</td></tr><tr><td>**Année scolaire**</td><td>Année scolaire active au moment de l'enregistrement</td></tr></tbody></table>

### Section 4 — Localisation éducationnelle et territoriale

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Localisation éducationnelle et territoriale" : Province, Proved, Sous-Proved, Territoire, Secteur, Groupement, Village — chaque valeur affichée sur sa propre ligne avec son libellé</callout>`

Ces informations proviennent directement du formulaire ODK et permettent de localiser précisément la bénéficiaire. Elles sont utilisées dans les filtres des rapports et dans les statistiques géographiques du tableau de bord.

### Section 5 — Notes de cours et fréquentation

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Notes de cours et fréquentation" : tableau à deux colonnes principales Semestre 1 / Semestre 2, avec pour chaque semestre les sous-colonnes Période 1, Période 2, Examen, Moyenne semestrielle, Fréquentation (%). Les valeurs sont affichées si collectées, sinon "N/A". Badge "Régulière" ou "Irrégulière" sous le taux de fréquentation</callout>`

<table id="bkmrk-indicateur-descripti"><thead><tr><th>Indicateur</th><th>Description</th></tr></thead><tbody><tr><td>**Période 1 / Période 2**</td><td>Moyennes des deux périodes d'évaluation du semestre</td></tr><tr><td>**Examen**</td><td>Résultat de l'examen semestriel</td></tr><tr><td>**Moyenne semestrielle**</td><td>Moyenne calculée sur les trois notes précédentes</td></tr><tr><td>**Fréquentation**</td><td>Taux de présence en pourcentage sur la période. Un badge **Régulière** (vert) ou **Irrégulière** (orange/rouge) est affiché selon le seuil défini par le programme</td></tr></tbody></table>

> ℹ️ **Note :** Ces données sont renseignées via le formulaire ODK de collecte des notes et présences, soumis par les enquêteurs lors des visites de suivi semestrielles. Si la collecte n'a pas encore eu lieu ou n'a pas été validée, les champs affichent *"N/A"*.

### Section 6 — Informations de contact

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Informations de contact" : Téléphone (numéro avec icône d'appel cliquable), WhatsApp (numéro avec icône WhatsApp cliquable), Email (adresse avec icône email cliquable). Les champs non renseignés affichent "Non renseigné"</callout>`

Coordonnées directes de la bénéficiaire (ou de son foyer), telles que collectées sur le terrain. Ces informations peuvent être utilisées pour des relances de terrain ou des vérifications.

### Section 7 — Tuteur légal et lien familial

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Tuteur légal" : photo du tuteur en miniature, nom complet du tuteur (lien cliquable vers sa fiche), lien de parenté (ex. : "Mère"), numéro de téléphone du tuteur, statut du compte M-Pesa (Configuré / Non configuré)</callout>`

Cette section affiche le ou les tuteurs légaux rattachés à cette élève dans la PIGBF. Un clic sur le nom du tuteur ouvre directement sa fiche complète.

<table id="bkmrk-champ-description-no"><thead><tr><th>Champ</th><th>Description</th></tr></thead><tbody><tr><td>**Nom du tuteur**</td><td>Lien cliquable vers la fiche détaillée du tuteur</td></tr><tr><td>**Lien de parenté**</td><td>Relation déclarée entre le tuteur et l'élève (ex. : Mère, Père, Grand-mère, Oncle, Tuteur légal non apparenté)</td></tr><tr><td>**Téléphone**</td><td>Numéro de contact du tuteur</td></tr><tr><td>**Compte M-Pesa**</td><td>Indicateur de configuration du compte de paiement du tuteur</td></tr></tbody></table>

### Section 8 — Validation pour paiement et statut financier

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Validation pour paiement" : tableau avec une ligne par tranche de paiement (Tranche 1, Tranche 2) ; pour chaque tranche : Statut validation (badge "Validée" vert ou "Non validée" gris), Bénéficiaire percepteur (Tuteur ou Élève elle-même), Statut du paiement (Payé / Non payé / En cours), Montant de la tranche</callout>`

Cette section est le reflet direct de la situation financière de l'élève dans le programme. Elle indique, tranche par tranche, si l'élève est validée pour recevoir un paiement et si ce paiement a été effectué.

<table id="bkmrk-indicateur-descripti-1"><thead><tr><th>Indicateur</th><th>Description</th></tr></thead><tbody><tr><td>**Statut de validation**</td><td>*Validée* : l'élève remplit les critères d'éligibilité pour cette tranche ; *Non validée* : l'élève n'est pas encore éligible ou a été invalidée</td></tr><tr><td>**Bénéficiaire percepteur**</td><td>Indique si la bourse est versée au tuteur légal (cas le plus fréquent) ou directement à l'élève (si elle est majeure ou désignée comme perceptrice)</td></tr><tr><td>**Statut du paiement**</td><td>*Payé* (vert) : le virement a été effectué et confirmé ; *Non payé* : pas encore de paiement ; *En cours* : instruction envoyée, retour en attente</td></tr></tbody></table>

### Section 9 — Comptes de paiement

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Comptes de paiement" : tableau avec colonnes Prestataire (ex. "M-Pesa"), Numéro de compte (numéro M-Pesa), Agent, Nom de transaction, Statut (case cochée "Compte choisi pour paiement" ou non). Bouton "Ajouter un compte de paiement" si aucun n'est configuré</callout>`

Affiche les comptes de paiement mobiles (M-Pesa) ou bancaires (Equity) configurés pour cette bénéficiaire. Le compte marqué **Compte choisi pour paiement** est celui qui sera crédité lors des prochaines instructions de paiement.

### Section 10 — Historique des modifications

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Historique des modifications" : tableau chronologique avec colonnes Date/Heure, Auteur (nom de l'utilisateur), Action (ex. : "Modification", "Validation paiement tranche 1", "Ajout tuteur"), Détail des champs modifiés (ex. : "Classe : 3ème H → 4ème H")</callout>`

Traçabilité complète et horodatée de toutes les modifications effectuées sur la fiche depuis sa création. Cette section est indispensable lors d'audits ou en cas de litige sur les données d'une bénéficiaire.

---

# B.6.6.4 — Ajouter une élève manuellement

## 6.4 Ajouter une élève manuellement

Les élèves sont principalement créées via la validation des formulaires ODK terrain (cf. chapitre B.4). La création manuelle est réservée aux cas particuliers : bénéficiaire absente lors de la collecte terrain, élève identifiée hors-couverture ODK, correction urgente suite à une erreur de collecte.

1. Cliquez sur **+ Ajouter une élève** en haut à droite de la liste.
2. Le formulaire de création s'ouvre.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Formulaire "Ajouter une élève", section Informations personnelles : champs Nom (obligatoire), Post-nom, Prénom (obligatoire), Date de naissance, Lieu de naissance, sélecteur Statut migratoire, toggle Situation de handicap (Oui/Non), champ Numéro SERNIE</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Formulaire "Ajouter une élève", section Parcours scolaire : sélecteur École (obligatoire, liste déroulante filtrée sur l'ONG), sélecteur Classe (obligatoire), sélecteur Section, sélecteur Option (cascade selon Section), Année scolaire (automatiquement l'année active)</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Formulaire "Ajouter une élève", section Informations de contact : champs Téléphone, WhatsApp, Email ; section upload photo avec zone de dépôt de fichier ou bouton "Choisir une photo"</callout>`

3. Renseignez les informations **obligatoires** :  
    \- **Nom** et **Prénom**  
    \- **École de rattachement**  
    \- **Classe**
4. Complétez autant que possible les informations complémentaires : date et lieu de naissance, statut migratoire, numéro SERNIE, situation de handicap, section, option, coordonnées de contact, photo.
5. Cliquez sur **Enregistrer**.

Un **UID unique** et un **QR Code** sont générés automatiquement par la plateforme dès l'enregistrement.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Message de confirmation après création : "Élève créée avec succès. UID généré : XXXXXX. QR Code disponible sur la fiche." avec bouton "Voir la fiche" et bouton "Ajouter une autre élève"</callout>`

> ℹ️ **Note :** Une élève créée manuellement devra être rattachée à son tuteur légal via la section **Tuteur légal** de sa fiche, et validée pour paiement avant de pouvoir être incluse dans une instruction de paiement.

---

# B.6.6.5 — Modifier une élève

## 6.5 Modifier une élève

1. Dans la liste, cliquez sur l'icône **Modifier** (crayon) de l'élève concernée.
2. Le formulaire de modification s'ouvre avec toutes les informations actuelles pré-remplies.
3. Apportez les corrections souhaitées.
4. Cliquez sur **Mettre à jour**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Formulaire de modification d'une élève pré-rempli : tous les champs visibles avec leurs valeurs actuelles, photo actuelle affichée avec option de remplacement, boutons Annuler et Mettre à jour</callout>`

> ℹ️ **Note :** Toute modification est automatiquement enregistrée dans l'historique des activités avec l'identité de l'auteur et l'horodatage. L'UID ne peut jamais être modifié — c'est l'identifiant permanent de la bénéficiaire dans tout le système.

⚠️ **Attention :** La modification du **statut scolaire** (passage en "Abandonnée") est une action aux conséquences importantes : l'élève est immédiatement exclue des listes de paiement futures. Utilisez cette option uniquement sur confirmation formelle de l'abandon (PV de l'école, rapport de l'enquêteur).

---

# B.6.6.6 — Supprimer une élève

## 6.6 Supprimer une élève

1. Dans la liste, cliquez sur l'icône **Supprimer** (corbeille) de l'élève concernée.
2. Une fenêtre de confirmation s'affiche, mentionnant le nom et l'UID de l'élève ainsi que les conséquences de la suppression.
3. Confirmez la suppression.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fenêtre de confirmation de suppression d'une élève : titre "Supprimer la bénéficiaire", nom en rouge, UID visible, message d'avertissement "Cette action est irréversible. Toutes les données de cette bénéficiaire seront définitivement supprimées.", boutons "Annuler" et "Supprimer définitivement" (rouge)</callout>`

⚠️ **Attention :** La suppression est **bloquée** si des instructions de paiement ont déjà été générées ou exécutées pour cette élève. Le système affiche un message d'erreur explicite. Une élève ayant déjà reçu un paiement ne peut pas être supprimée — elle peut uniquement être marquée comme "Abandonnée" pour la retirer des listes actives tout en conservant son historique.

---

# B.6.6.7 — Traitement des doublons d'élèves

## 6.7 Traitement des doublons d'élèves

### Pourquoi des doublons apparaissent-ils ?

Une même bénéficiaire peut être enregistrée plusieurs fois dans les situations suivantes :  
\- Deux enquêteurs différents ont collecté la même élève lors de sessions séparées  
\- Une mise à jour ODK a créé une nouvelle entrée au lieu de mettre à jour la fiche existante  
\- Une élève a été ajoutée manuellement alors qu'elle existait déjà en base sous un nom légèrement différent

### Accéder au traitement des doublons

Menu latéral → **Bénéficiaires → Élèves** → sous-menu ou onglet **Traitement des doublons**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page traitement des doublons élèves : titre "Doublons détectés", compteur de paires (ex. "47 paires à traiter") ; liste de paires d'élèves suspectes. Pour chaque paire : deux colonnes affichant côte à côte la Photo, l'UID, le Nom complet, la Date de naissance, l'École, la Classe de chaque fiche. Score de similarité en pourcentage visible en badge entre les deux colonnes. Boutons "Fusionner", "Confirmer deux élèves distinctes" pour chaque paire</callout>`

### Comprendre les paires signalées

L'algorithme de détection compare les noms, dates de naissance, écoles et autres attributs pour identifier les paires similaires. Un **score de similarité** (en pourcentage) indique la probabilité que les deux fiches correspondent à la même personne :

<table id="bkmrk-score-de-similarit%C3%A9-"><thead><tr><th>Score de similarité</th><th>Interprétation recommandée</th></tr></thead><tbody><tr><td>**&gt; 95%**</td><td>Très probablement un doublon — vérifiez les photos et confirmez la fusion</td></tr><tr><td>**80% à 95%**</td><td>Probablement un doublon — vérifiez attentivement les dates de naissance et les photos</td></tr><tr><td>**60% à 80%**</td><td>Similitude partielle — inspectez soigneusement avant de décider</td></tr><tr><td>**&lt; 60%**</td><td>Probablement deux élèves distinctes — à confirmer sans fusionner</td></tr></tbody></table>

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Vue comparative détaillée d'une paire de doublons : deux colonnes bien délimitées, photo de chaque élève bien visible, UID, Nom complet, Date de naissance, École, Classe, Statut bourse pour chaque fiche ; score de similarité "94%" en badge orange entre les deux colonnes ; boutons "Fusionner → Élève 1 comme référence", "Fusionner → Élève 2 comme référence", "Deux élèves distinctes" bien visibles en bas</callout>`

### Résoudre un doublon

**Option 1 — Fusionner**

Les deux fiches concernent la même élève. L'administrateur doit désigner la **fiche de référence** (celle qui sera conservée). Toutes les données de la fiche secondaire (notes, paiements, historique de modifications, lien tuteur) sont rapatriées sur la fiche principale. La fiche secondaire est supprimée et son UID devient inactif (redirigé vers l'UID de la fiche principale).

Procédure :  
1\. Examinez les informations des deux fiches côte à côte.  
2\. Identifiez quelle fiche est la plus complète et la plus fiable (photo nette, date de naissance cohérente, école correcte).  
3\. Cliquez sur **Fusionner → \[Fiche X\] comme référence**.  
4\. Une fenêtre de confirmation récapitule : *UID de référence retenu, UID supprimé, données à fusionner (notes S1/S2, paiements, tuteur)*. Confirmez.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fenêtre de confirmation de fusion : titre "Confirmer la fusion", récapitulatif en deux blocs : "Fiche conservée (référence)" avec son UID et ses données clés, "Fiche supprimée" avec son UID et les données qui seront migrées vers la fiche de référence ; avertissement "Cette action est irréversible" ; boutons "Annuler" et "Confirmer la fusion"</callout>`

**Option 2 — Confirmer deux élèves distinctes**

Malgré la ressemblance, les deux fiches correspondent à des personnes différentes. Les deux fiches sont conservées intactes et la paire est retirée des résultats de détection. Elle ne réapparaîtra plus dans les suggestions de doublons.

Procédure : cliquez sur **Deux élèves distinctes** → confirmation → les deux fiches sont conservées.

⚠️ **Attention — La fusion est irréversible.** Avant toute fusion, vérifiez **systématiquement** :  
\- Les **photos** des deux élèves (même visage ?)  
\- Les **UIDs** (deux UIDs différents = deux identités distinctes dans le système jusqu'à fusion)  
\- Les **dates de naissance** (deux dates différentes = probablement deux personnes distinctes)  
\- Les **écoles de rattachement** (même école ?)  
\- Les **tuteurs déclarés** (même famille ?)  
\- Les **paiements éventuels** sur chaque fiche (une élève ayant déjà reçu un paiement sous deux UIDs nécessite une investigation approfondie)

La bourse ne doit être attribuée qu'une seule fois par élève réelle. Une fusion incorrecte (fusion de deux élèves différentes) est extrêmement difficile à corriger et compromet l'intégrité du registre des bénéficiaires et la fiabilité des paiements.

---

# B.6.6.8 — Validation des élèves pour paiement

## 6.8 Validation des élèves pour paiement

### Vue d'ensemble

Avant qu'une bénéficiaire puisse être incluse dans une instruction de paiement, elle doit être **explicitement validée pour paiement** pour la tranche concernée. Cette validation confirme que l'élève remplit l'ensemble des critères d'éligibilité définis par le programme pour cette tranche spécifique.

### Accéder à la validation pour paiement

Menu latéral → **Bénéficiaires → Élèves** → sous-menu ou onglet **Validation de paiements**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page validation pour paiement des élèves : barre de filtres en haut (PROVED, Sous-PROVED, École, Classe, Tranche de paiement) ; tableau principal avec colonnes Nom de l'élève, UID, École, Classe, Taux de fréquentation S1 (%), Moyenne S1, Statut actuel (badge "Validée" vert / "Non validée" gris), boutons Valider (coche verte) / Invalider (croix rouge) par ligne ; cases à cocher pour validation en masse</callout>`

### Critères d'éligibilité examinés

<table id="bkmrk-crit%C3%A8re-description-"><thead><tr><th>Critère</th><th>Description</th></tr></thead><tbody><tr><td>**Taux de fréquentation**</td><td>Le taux de présence au semestre concerné atteint le seuil minimal requis par le programme</td></tr><tr><td>**Taux de réussite scolaire**</td><td>La moyenne obtenue dépasse le seuil de réussite défini pour la tranche</td></tr><tr><td>**Fiche complète**</td><td>Les informations essentielles de la fiche (école, classe, tuteur) sont renseignées</td></tr><tr><td>**Absence de doublon actif**</td><td>Aucune autre fiche active dans la base ne correspond à la même élève</td></tr><tr><td>**Compte de paiement configuré**</td><td>Un compte M-Pesa ou Equity est renseigné et activé pour le percepteur désigné</td></tr></tbody></table>

### Filtrer avant de valider

Utilisez les filtres disponibles en haut du tableau pour travailler de manière organisée :  
\- **Tranche de paiement** : sélectionnez la tranche pour laquelle vous validez (Tranche 1 ou Tranche 2)  
\- **Sous-PROVED** : traitez les élèves zone par zone pour maintenir une cohérence géographique  
\- **École** : validez établissement par établissement si nécessaire

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Zone de filtres de la page validation élèves : liste déroulante Tranche (obligatoire, "Sélectionnez une tranche"), sélecteur PROVED, sélecteur Sous-PROVED, sélecteur École, sélecteur Classe ; bouton Réinitialiser les filtres</callout>`

### Valider des élèves

**Validation individuelle :**  
1\. Sur la ligne de l'élève à valider, cliquez sur le bouton **Valider** (coche verte).  
2\. Une fenêtre de confirmation s'affiche avec le récapitulatif (nom, UID, école, classe, tranche).  
3\. Confirmez. L'élève est immédiatement disponible pour inclusion dans les instructions de paiement.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fenêtre de confirmation de validation individuelle : "Valider [NOM ÉLÈVE</callout> pour la Tranche 1", récapitulatif (UID, école, classe, taux fréquentation, moyenne), boutons Annuler et Confirmer la validation]`

**Validation en masse :**  
1\. Cochez les cases des élèves à valider (ou cochez la case d'en-tête pour tout sélectionner sur la page).  
2\. Un bandeau récapitulatif apparaît : *"X élèves sélectionnées"*.  
3\. Cliquez sur **Valider les X élèves sélectionnées**.  
4\. Une fenêtre de confirmation récapitule le nombre d'élèves. Confirmez.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Bandeau de sélection multiple actif : "47 élèves sélectionnées — Valider les 47 élèves sélectionnées pour la Tranche 1 | Désélectionner tout". Bouton de validation bien visible en bleu</callout>`

**Invalider une élève :**  
Cliquez sur le bouton **Invalider** (croix rouge) sur la ligne d'une élève précédemment validée. Une élève invalidée est immédiatement retirée des listes utilisées par le module de génération des paiements. Utilisez cette option en cas de découverte tardive d'une inéligibilité (abandon confirmé, doublon identifié, dossier incomplet).

🔒 **Restriction :** La validation pour paiement est réservée aux rôles **Admin ONG** (dans son périmètre), **Admin PAAF**, **Admin** et **Super Admin**. L'Admin IT ONG ne peut pas valider pour paiement.

---

# B.6.6.9 — Bonnes pratiques — Gestion des élèves

## 6.9 Bonnes pratiques — Gestion des élèves

**Vérifiez systématiquement les photos avant validation.** Une photo de mauvaise qualité (floue, tronquée, visage non visible) compromet l'identification sur le terrain lors des visites de suivi. Signalez les photos insuffisantes à l'enquêteur pour une nouvelle collecte.

**Traitez les doublons avant de valider pour paiement.** Une bénéficiaire en doublon actif peut recevoir une double bourse si les deux fiches sont validées séparément. Résolvez systématiquement les doublons signalés avant toute campagne de paiement.

**Documentez les abandons scolaires immédiatement.** Dès qu'un enquêteur ou un préfet vous informe de l'abandon d'une bénéficiaire, mettez à jour son statut dans la plateforme. Les abandons non documentés faussent les statistiques et peuvent conduire à des paiements indus.

**Ne supprimez jamais une fiche ayant reçu un paiement.** Même en cas d'erreur, la suppression d'une fiche avec historique de paiement est bloquée par le système. En cas de litige, contactez le Super Admin ou l'équipe IT GROUP.

---

*Fin du chapitre B.6 — Gestion des élèves*

---

---

# B.7 — Gestion des tuteurs

Chapitre B.7 du Manuel PIGBF

# B.7.7.1 — Vue d'ensemble et rôle du tuteur dans la PIGBF

## 7.1 Vue d'ensemble et rôle du tuteur dans la PIGBF

Le tuteur est la **personne physique légalement responsable** d'une ou plusieurs bénéficiaires mineures inscrites dans le programme PAAF. Il occupe une position centrale dans le circuit financier : dans le schéma de paiement standard, c'est lui qui reçoit la bourse sur son compte **M-Pesa** au nom des élèves dont il a la charge.

Le module **Bénéficiaires → Tuteurs** permet à l'Admin ONG de gérer les fiches de tous les tuteurs relevant de son périmètre : consultation, création manuelle, modification, traitement des doublons et validation pour paiement.

**Relations clés du tuteur dans la PIGBF :**

<table id="bkmrk-relation-description"><thead><tr><th>Relation</th><th>Description</th></tr></thead><tbody><tr><td>**Tuteur ↔ Élève(s)**</td><td>Un tuteur peut être responsable de plusieurs bénéficiaires (jusqu'à plusieurs dizaines dans les grands foyers). La relation est nominative et documentée</td></tr><tr><td>**Tuteur ↔ Représentant**</td><td>Si le tuteur est dans l'impossibilité de recevoir les paiements lui-même (incapacité physique, absence prolongée), un représentant légal peut être désigné à sa place</td></tr><tr><td>**Tuteur ↔ Compte M-Pesa**</td><td>Le compte mobile money est le canal de réception des bourses. Sa validité conditionne directement le succès du paiement</td></tr></tbody></table>

🔒 **Accès Admin IT ONG :** L'Admin IT ONG dispose d'un accès en **lecture seule** sur ce module. Il peut consulter les fiches des tuteurs mais ne peut pas les créer, les modifier, les supprimer ni les valider pour paiement.

Accès : menu latéral → **Bénéficiaires → Tuteurs**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Menu latéral avec "Tuteurs" mis en évidence sous le groupe "Gestion des bénéficiaires"</callout>`

---

# B.7.7.2 — Liste des tuteurs

## 7.2 Liste des tuteurs

### Accéder à la liste

Cliquez sur **Bénéficiaires → Tuteurs**. La liste des tuteurs enregistrés dans le périmètre de l'ONG s'affiche pour l'année scolaire active.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page liste des tuteurs complète : barre de filtres en haut, tableau principal avec colonnes Nom du tuteur, Téléphone, École principale, Nb élèves rattachées, Compte M-Pesa (numéro partiellement masqué), Statut validation paiement (badge), Actions (Voir / Modifier / Supprimer). Bouton "+ Ajouter un tuteur" en haut à droite. Indicateur du nombre total de tuteurs en bas</callout>`

### Colonnes du tableau

<table id="bkmrk-colonne-description-"><thead><tr><th>Colonne</th><th>Description</th></tr></thead><tbody><tr><td>**Nom complet**</td><td>Nom, post-nom et prénom du tuteur</td></tr><tr><td>**Téléphone**</td><td>Numéro de téléphone principal (souvent identique au numéro M-Pesa)</td></tr><tr><td>**École principale**</td><td>École de référence où le tuteur a été identifié lors de la collecte (école ayant le plus grand nombre d'élèves de ce tuteur)</td></tr><tr><td>**Nb élèves rattachées**</td><td>Nombre total d'élèves bénéficiaires placées sous la responsabilité de ce tuteur dans la PIGBF</td></tr><tr><td>**Compte M-Pesa**</td><td>Numéro de compte mobile money (partiellement masqué pour la confidentialité) — affiché en badge vert si configuré, badge orange "Non configuré" si absent</td></tr><tr><td>**Statut validation**</td><td>Badge *Validé pour paiement* (vert) ou *Non validé* (gris) pour la tranche en cours</td></tr><tr><td>**Actions**</td><td>Voir / Modifier / Supprimer</td></tr></tbody></table>

### Filtres disponibles

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Zone de filtres de la liste tuteurs dépliée : filtres texte (Nom, Téléphone, WhatsApp, Email), filtres géographiques (Province, PROVED, Sous-PROVED, École), filtres statut (Avec compte M-Pesa / Sans, Avec handicap / Sans, Avec représentant / Sans), filtres paiements (Ayant reçu tranche 1 / 2), boutons Appliquer et Réinitialiser</callout>`

<table id="bkmrk-cat%C3%A9gorie-filtres-di"><thead><tr><th>Catégorie</th><th>Filtres disponibles</th></tr></thead><tbody><tr><td>**Recherche texte**</td><td>Nom, post-nom, prénom, téléphone, WhatsApp, email</td></tr><tr><td>**Localisation**</td><td>Province, PROVED, Sous-PROVED, école de référence</td></tr><tr><td>**Statut compte**</td><td>Avec compte M-Pesa configuré / Sans compte</td></tr><tr><td>**Situation**</td><td>Avec handicap / Sans handicap, Avec représentant désigné / Sans</td></tr><tr><td>**Paiements**</td><td>Ayant reçu la 1ère tranche / la 2ème tranche</td></tr></tbody></table>

---

# B.7.7.3 — Fiche détaillée d'un tuteur

## 7.3 Fiche détaillée d'un tuteur

Cliquez sur l'icône **Voir** (œil) d'un tuteur pour accéder à sa fiche complète.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche détaillée d'un tuteur, haut de page : photo du tuteur (cadre arrondi), nom complet en grand titre, UID du tuteur en badge, bouton "Modifier" en haut à droite, bouton "Retour à la liste"</callout>`

La fiche est organisée en plusieurs sections :

### Section 1 — Identité et photo

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section identité tuteur : photo du tuteur, UID du tuteur, nom complet, genre, date de naissance si renseignée, nationalité</callout>`

<table id="bkmrk-champ-description-ph"><thead><tr><th>Champ</th><th>Description</th></tr></thead><tbody><tr><td>**Photo**</td><td>Photo du tuteur prise lors de la collecte ODK (ou uploadée manuellement)</td></tr><tr><td>**UID**</td><td>Identifiant unique du tuteur dans la PIGBF, généré à la première validation</td></tr><tr><td>**Nom / Post-nom / Prénom**</td><td>Identité complète</td></tr><tr><td>**Genre**</td><td>Homme ou Femme</td></tr><tr><td>**Date de naissance**</td><td>Si renseignée lors de la collecte</td></tr></tbody></table>

### Section 2 — Pièce d'identité

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Pièce d'identité" : miniatures des photos de la pièce d'identité (recto et/ou verso), type de document (Carte Nationale d'Identité / Carte de vote / Autre), numéro de la pièce si renseigné. Les miniatures sont cliquables pour affichage en plein écran</callout>`

La pièce d'identité du tuteur est un document critique pour la sécurité financière du programme. Elle est photographiée lors de la collecte ODK et accessible depuis cette section.

<table id="bkmrk-champ-description-ty"><thead><tr><th>Champ</th><th>Description</th></tr></thead><tbody><tr><td>**Type de document**</td><td>Carte Nationale d'Identité, Carte de vote, Passeport, ou autre</td></tr><tr><td>**Numéro**</td><td>Numéro de la pièce d'identité si renseigné</td></tr><tr><td>**Photos**</td><td>Miniatures cliquables des photos de la pièce (recto/verso) prises sur le terrain</td></tr></tbody></table>

### Section 3 — Informations socio-professionnelles

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Informations socio-professionnelles" : Niveau d'étude (ex. "Secondaire"), Profession (ex. "Agriculteur"), Situation parentale, Nombre total d'enfants au foyer, Nombre d'enfants fréquentant l'école de référence</callout>`

<table id="bkmrk-champ-description-ni"><thead><tr><th>Champ</th><th>Description</th></tr></thead><tbody><tr><td>**Niveau d'étude**</td><td>Niveau d'études le plus élevé atteint par le tuteur</td></tr><tr><td>**Profession**</td><td>Activité professionnelle déclarée</td></tr><tr><td>**Situation parentale**</td><td>Situation vis-à-vis des enfants (père/mère biologique, tuteur légal, etc.)</td></tr><tr><td>**Nb enfants au foyer**</td><td>Nombre total d'enfants vivant sous sa responsabilité dans le foyer</td></tr><tr><td>**Nb enfants à l'école**</td><td>Nombre d'enfants fréquentant régulièrement l'école de référence</td></tr></tbody></table>

### Section 4 — Coordonnées de contact

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Coordonnées de contact" : Téléphone (numéro avec icône appel), WhatsApp (numéro avec icône), Email, Adresse (si renseignée). Les champs non renseignés affichent "Non renseigné"</callout>`

### Section 5 — Situation de handicap

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Situation de handicap" : toggle "Le tuteur a un handicap : Oui / Non" ; si Oui : champ "Nature du besoin" décrivant le type de handicap ou de besoin d'assistance</callout>`

La situation de handicap du tuteur est documentée car elle peut influencer la désignation d'un représentant et les modalités de réception des paiements.

### Section 6 — Consentement

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Consentement" : statut du consentement (badge "Consentement signé" vert ou "Non signé" orange), date de signature, note explicative sur l'importance du consentement pour la légalité du paiement</callout>`

Le consentement formel du tuteur est un **prérequis légal et programmatique** pour la réception des bourses. Sans consentement signé et documenté, le tuteur ne peut pas être désigné comme percepteur des bourses dans les instructions de paiement.

### Section 7 — Représentant légal

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Représentant légal" : si un représentant est désigné : photo du représentant, nom complet, lien avec le tuteur (ex. "Frère du tuteur"), numéro de téléphone du représentant. Si aucun représentant : message "Aucun représentant désigné" avec bouton "Désigner un représentant"</callout>`

Le représentant est la personne qui reçoit les paiements à la place du tuteur lorsque ce dernier est dans l'incapacité de le faire. Cette désignation est formellement documentée dans la PIGBF.

<table id="bkmrk-champ-description-no"><thead><tr><th>Champ</th><th>Description</th></tr></thead><tbody><tr><td>**Nom du représentant**</td><td>Identité complète du représentant désigné</td></tr><tr><td>**Lien avec le tuteur**</td><td>Nature de la relation (ex. : Frère, Sœur, Fils majeur, Voisin de confiance)</td></tr><tr><td>**Téléphone**</td><td>Numéro de contact du représentant</td></tr></tbody></table>

### Section 8 — Élèves bénéficiaires rattachées

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Élèves bénéficiaires rattachées" : liste interactive avec une ligne par élève (Photo miniature, UID, Nom complet, École, Classe, Statut paiement tranche 1, Statut paiement tranche 2). Chaque ligne est cliquable et ouvre directement la fiche de l'élève. Compteur total "X élèves sous responsabilité" visible en haut de la section</callout>`

Cette section est la vue relationnelle centrale de la fiche tuteur. Elle permet de vérifier d'un seul coup d'œil l'intégralité du portefeuille d'élèves sous la responsabilité du tuteur et l'état des paiements pour chacune.

> ℹ️ **Navigation directe :** Un clic sur une ligne ouvre directement la fiche de l'élève concernée. Il est ainsi possible de naviguer entre la fiche tuteur et les fiches de ses élèves sans repasser par les listes.

### Section 9 — Comptes de paiement

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Comptes de paiement" : tableau avec colonnes Prestataire (ex. "M-Pesa Vodacom"), Numéro de compte (numéro M-Pesa), Agent de rattachement, Nom de transaction, Statut (toggle "Compte choisi pour paiement" activé ou non). Bouton "Ajouter un compte" si aucun n'est configuré</callout>`

<table id="bkmrk-champ-description-pr"><thead><tr><th>Champ</th><th>Description</th></tr></thead><tbody><tr><td>**Prestataire**</td><td>Opérateur de mobile money (M-Pesa Vodacom) ou banque (Equity BCDC)</td></tr><tr><td>**Numéro de compte**</td><td>Numéro M-Pesa ou numéro de compte bancaire</td></tr><tr><td>**Agent**</td><td>Agent M-Pesa de référence pour les questions relatives au paiement</td></tr><tr><td>**Nom de transaction**</td><td>Libellé attendu sur le relevé M-Pesa lors du virement</td></tr><tr><td>**Compte choisi pour paiement**</td><td>Indicateur du compte actif — c'est ce compte qui sera crédité lors des prochains paiements</td></tr></tbody></table>

### Section 10 — Historique des modifications

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Section "Historique des modifications" : tableau chronologique avec Date/Heure, Auteur, Action, Détail. Mise en évidence des modifications de compte M-Pesa avec fond coloré d'alerte</callout>`

⚠️ **Traçabilité anti-fraude :** Toute modification du numéro de compte M-Pesa est mise en évidence dans l'historique avec un fond coloré d'alerte. Cette traçabilité permet de détecter rapidement toute substitution de compte non autorisée effectuée avant une période de paiement.

---

# B.7.7.4 — Ajouter un tuteur manuellement

## 7.4 Ajouter un tuteur manuellement

Les tuteurs sont principalement créés via la validation des formulaires ODK terrain. La création manuelle est réservée aux cas particuliers : tuteur absent lors de la collecte, changement de tuteur légal en cours d'année, correction urgente.

1. Cliquez sur **+ Ajouter un tuteur** en haut à droite de la liste.
2. Le formulaire de création s'ouvre.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Formulaire "Ajouter un tuteur", section Informations personnelles : champs Nom (obligatoire), Post-nom, Prénom (obligatoire), sélecteur Genre, Date de naissance, zone upload Photo</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Formulaire "Ajouter un tuteur", section Informations de contact : champs Téléphone (obligatoire), WhatsApp, Email, Adresse</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Formulaire "Ajouter un tuteur", section Compte de paiement M-Pesa : champ Numéro M-Pesa, sélecteur Agent M-Pesa, champ Nom de transaction, case à cocher "Définir comme compte choisi pour paiement"</callout>`

3. Renseignez les informations **obligatoires** : **Nom**, **Prénom**, **Téléphone**.
4. Complétez les informations complémentaires : genre, date de naissance, niveau d'étude, profession, situation parentale, nombre d'enfants, coordonnées supplémentaires.
5. Configurez le **compte de paiement M-Pesa** : renseignez le numéro de téléphone M-Pesa, l'agent de rattachement, le nom de transaction. Cochez **Définir comme compte choisi pour paiement**.
6. Cliquez sur **Enregistrer**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Boutons Annuler et Enregistrer en bas du formulaire. Message de confirmation après enregistrement : "Tuteur créé avec succès. Vous pouvez maintenant rattacher des élèves à ce tuteur depuis la fiche de chaque élève."</callout>`

> ℹ️ **Rattachement aux élèves :** Un tuteur créé manuellement doit ensuite être rattaché aux élèves bénéficiaires concernées. Ce rattachement s'effectue depuis la **fiche de chaque élève**, dans la section **Tuteur légal**, en sélectionnant le tuteur dans la liste déroulante et en précisant le lien de parenté.

---

# B.7.7.5 — Modifier un tuteur

## 7.5 Modifier un tuteur

1. Dans la liste, cliquez sur l'icône **Modifier** (crayon) du tuteur concerné.
2. Le formulaire de modification s'ouvre avec toutes les informations actuelles pré-remplies.
3. Apportez les modifications nécessaires.
4. Cliquez sur **Mettre à jour**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Formulaire de modification d'un tuteur pré-rempli : tous les champs visibles avec leurs valeurs actuelles, photo actuelle affichée avec option de remplacement, section compte M-Pesa avec le numéro actuel, boutons Annuler et Mettre à jour</callout>`

⚠️ **Attention — Modification du compte M-Pesa :** Tout changement du numéro de compte M-Pesa est automatiquement tracé dans le journal d'activités avec l'identité de l'auteur et l'horodatage précis. Si vous modifiez le compte M-Pesa d'un tuteur, documentez la raison du changement dans vos registres internes (changement de numéro, perte de téléphone, fraude avérée). Cette traçabilité est un mécanisme anti-fraude explicite.

---

# B.7.7.6 — Supprimer un tuteur

## 7.6 Supprimer un tuteur

1. Dans la liste, cliquez sur l'icône **Supprimer** (corbeille) du tuteur concerné.
2. Une fenêtre de confirmation s'affiche, mentionnant le nom du tuteur et les conséquences.
3. Confirmez la suppression.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fenêtre de confirmation de suppression d'un tuteur : titre "Supprimer le tuteur", nom du tuteur en rouge, message d'avertissement sur les conséquences (désassociation des élèves rattachées), boutons "Annuler" et "Supprimer définitivement" (rouge)</callout>`

⚠️ **Attention :** La suppression est **bloquée** si des instructions de paiement ont déjà été générées ou exécutées pour ce tuteur. Le système affiche un message d'erreur explicite. Un tuteur ayant déjà reçu un paiement ne peut pas être supprimé.

⚠️ **Conséquence sur les élèves rattachées :** La suppression d'un tuteur **désassocie** toutes les élèves qui lui étaient rattachées. Ces élèves se retrouveront sans tuteur assigné et ne pourront plus être incluses dans les paiements jusqu'à réassignation d'un nouveau tuteur.

---

# B.7.7.7 — Traitement des doublons de tuteurs

## 7.7 Traitement des doublons de tuteurs

### Pourquoi des doublons apparaissent-ils ?

Un même tuteur peut être collecté plusieurs fois dans les situations suivantes :  
\- Deux enquêteurs dans deux écoles différentes ont identifié le même tuteur (dont les enfants fréquentent plusieurs établissements)  
\- Une légère variation d'orthographe dans le nom a créé deux entrées distinctes  
\- Une mise à jour ODK a créé une nouvelle fiche au lieu de mettre à jour l'existante

### Accéder au traitement des doublons

Menu latéral → **Bénéficiaires → Tuteurs** → sous-menu ou onglet **Traitement des doublons**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page traitement des doublons tuteurs : liste de paires de tuteurs suspectes. Pour chaque paire : Photo, Nom complet, Téléphone, Nombre d'élèves rattachées, Compte M-Pesa pour chaque fiche côte à côte. Score de similarité en pourcentage. Boutons "Fusionner", "Deux tuteurs distincts"</callout>`

### Vérifications avant fusion d'un tuteur

La fusion de tuteurs est plus délicate que celle des élèves car elle impacte directement les circuits financiers. Vérifiez **impérativement** :

<table id="bkmrk-%C3%89l%C3%A9ment-ce-qu%27il-fau"><thead><tr><th>Élément</th><th>Ce qu'il faut vérifier</th></tr></thead><tbody><tr><td>**Photos**</td><td>Les photos des deux fiches représentent-elles la même personne ?</td></tr><tr><td>**Numéros M-Pesa**</td><td>Si les deux fiches ont des numéros M-Pesa différents, il peut s'agir de deux personnes distinctes</td></tr><tr><td>**Élèves rattachées**</td><td>Les élèves de chaque fiche sont-elles dans les mêmes écoles ? Un même tuteur peut légitimement avoir des enfants dans plusieurs établissements</td></tr><tr><td>**Pièces d'identité**</td><td>Les photos des pièces d'identité correspondent-elles au même document ?</td></tr></tbody></table>

### Résoudre un doublon de tuteur

Procédure identique à celle des doublons d'élèves :  
\- **Fusionner** : sélectionnez la fiche de référence → toutes les élèves rattachées, les paiements et les données de la fiche secondaire sont migrés sur la fiche principale  
\- **Deux tuteurs distincts** : les deux fiches sont conservées et la paire retirée des suggestions

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Vue comparative de deux fiches tuteurs en doublon : photo, nom, téléphone, élèves rattachées et compte M-Pesa de chaque fiche côte à côte, score de similarité en badge, boutons de décision en bas</callout>`

⚠️ **Irréversibilité :** La fusion de tuteurs est irréversible. Un tuteur fusionné à tort (deux personnes différentes traitées comme une seule) peut conduire à l'envoi des bourses de plusieurs familles sur un seul compte M-Pesa.

---

# B.7.7.8 — Validation des tuteurs pour paiement

## 7.8 Validation des tuteurs pour paiement

### Vue d'ensemble

Avant qu'un tuteur puisse recevoir des versements M-Pesa pour les élèves dont il est responsable, il doit être **validé pour paiement** pour la tranche concernée. Cette validation confirme que le tuteur et ses informations financières sont vérifiés et conformes aux exigences du programme.

### Accéder à la validation pour paiement

Menu latéral → **Bénéficiaires → Tuteurs** → sous-menu ou onglet **Validation de paiements**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page validation pour paiement des tuteurs : barre de filtres (Tranche de paiement, PROVED, Sous-PROVED, École) ; tableau avec colonnes Nom du tuteur, Nb élèves rattachées, Compte M-Pesa (numéro masqué), Statut compte (Configuré / Non configuré), Statut actuel (badge Validé / Non validé), boutons Valider / Invalider par ligne, cases à cocher pour validation en masse</callout>`

### Critères à vérifier avant validation

<table id="bkmrk-crit%C3%A8re-description-"><thead><tr><th>Critère</th><th>Description</th></tr></thead><tbody><tr><td>**Compte M-Pesa configuré**</td><td>Un numéro M-Pesa est renseigné et marqué "Compte choisi pour paiement"</td></tr><tr><td>**Pièce d'identité vérifiée**</td><td>Photo de la pièce d'identité lisible, document valide</td></tr><tr><td>**Photo du tuteur**</td><td>Photo claire permettant l'identification</td></tr><tr><td>**Consentement signé**</td><td>Statut "Consentement signé" sur la fiche</td></tr><tr><td>**Élèves rattachées validées**</td><td>Au moins une élève validée pour paiement est rattachée à ce tuteur</td></tr></tbody></table>

### Valider des tuteurs

**Validation individuelle :**  
1\. Cliquez sur le bouton **Valider** (coche verte) sur la ligne du tuteur.  
2\. Une fenêtre de confirmation récapitule les informations clés : nom, numéro M-Pesa, nombre d'élèves rattachées, montant total de la tranche.  
3\. Confirmez.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fenêtre de confirmation de validation d'un tuteur : "Valider [NOM TUTEUR</callout> pour la Tranche 1", récapitulatif (Numéro M-Pesa, Agent, Nb élèves : X, Montant total : Y CDF), boutons Annuler et Confirmer]`

**Validation en masse :**  
1\. Cochez les tuteurs à valider.  
2\. Cliquez sur **Valider les X tuteurs sélectionnés**.  
3\. Confirmez dans la fenêtre de confirmation groupée.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Bandeau de sélection multiple : "X tuteurs sélectionnés — Valider les X tuteurs sélectionnés pour la Tranche 1 | Désélectionner tout"</callout>`

---

# B.7.7.9 — Bonnes pratiques — Gestion des tuteurs

## 7.9 Bonnes pratiques — Gestion des tuteurs

**Vérifiez toujours le numéro M-Pesa avant validation.** C'est le champ le plus critique de la fiche tuteur. Un digit erroné entraîne un virement vers un mauvais destinataire. En cas de doute, contactez l'enquêteur ou le préfet de l'école pour confirmation.

**Traitez les doublons de tuteurs en priorité.** Un tuteur en doublon peut recevoir une double bourse pour les mêmes élèves. Résolvez les doublons signalés avant chaque campagne de paiement.

**Documentez les changements de compte M-Pesa.** Tenez un registre interne des raisons des modifications (perte de téléphone, changement d'opérateur) pour faciliter les audits et investigations en cas de contestation.

**Vérifiez les consentements.** Un tuteur sans consentement signé ne peut légalement pas être percepteur des bourses. Vérifiez ce statut systématiquement avant validation pour paiement.

**Signalez les décès de tuteurs immédiatement.** En cas de décès d'un tuteur, désassociez ses élèves et désignez un nouveau tuteur légal via une nouvelle collecte ODK ou une modification manuelle. Un tuteur décédé ne doit jamais rester le percepteur actif d'une bourse.

---

*Fin du chapitre B.7 — Gestion des tuteurs*

---

---

# B.8 — Rapports

Chapitre B.8 du Manuel PIGBF

# B.8.8.1 — Vue d'ensemble du module Rapports

## 8.1 Vue d'ensemble du module Rapports

Le module **Rapports** permet à l'Admin ONG de générer des extractions Excel paramétrables des données du programme PAAF pour le périmètre de son organisation. Ces rapports constituent l'outil principal d'analyse, de suivi et de redevabilité vis-à-vis des coordinateurs PAAF et des bailleurs.

### Fonctionnement général

Le moteur de génération des rapports fonctionne en mode **asynchrone** : lorsqu'un rapport est demandé, la plateforme transmet la configuration (filtres, colonnes sélectionnées) au serveur de traitement 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 retrouver et re-télécharger ses rapports passés depuis la section **Mes Rapports**.

> ℹ️ **Délai de génération :** 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. Inutile de rester sur la page une fois la demande soumise — le rapport arrivera par email.

### Particularités pour l'Admin ONG

- Tous les rapports sont **automatiquement filtrés sur le périmètre de l'ONG**. Il n'est pas possible de générer un rapport contenant des données d'une autre ONG.
- Le filtre géographique **Province** est obligatoire pour tous les types de rapports. Sans sélection de province, le bouton **Générer le rapport** reste inactif.
- Les rapports générés par l'Admin ONG reflètent l'état des données au moment de la génération. Deux rapports identiques générés à des moments différents peuvent produire des résultats différents si des validations ont eu lieu entre-temps.

🔒 **Accès Admin IT ONG :** L'Admin IT ONG dispose d'un accès en **lecture seule** sur les rapports déjà générés (section Mes Rapports). Il ne peut pas lancer de nouvelle génération de rapport.

Accès : menu latéral → **Rapports**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page d'accueil du module Rapports vue par l'Admin ONG : menu latéral avec les entrées "Rapport des écoles", "Rapport des élèves", "Rapport des tuteurs", "Mes rapports" ; bandeau supérieur indiquant l'année scolaire active ; zone de contenu principale vide ou avec message de bienvenue</callout>`

---

# B.8.8.2 — Rapport des écoles

## 8.2 Rapport des écoles

### 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" 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 de tri à droite ; boutons "Tout sélectionner", "Réinitialiser" et "Générer le rapport" en bas</callout>`

### Zone 1 — Filtres géographiques et pédagogiques

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

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Zone de filtres géographiques dépliée : sélecteur Province avec "Kasaï" coché, liste Proved chargée dynamiquement avec plusieurs PROVED disponibles, Sous-Proved "Tshikapa 1" sélectionné, champ École en cours de sélection avec barre de recherche intégrée ; indication "Sélection obligatoire" visible sous le champ Province</callout>`

<table id="bkmrk-niveau-description-o"><thead><tr><th>Niveau</th><th>Description</th><th>Obligatoire</th></tr></thead><tbody><tr><td>**Province**</td><td>Premier niveau géographique</td><td>✅ Oui</td></tr><tr><td>**Proved**</td><td>Se charge selon la province sélectionnée</td><td>Non</td></tr><tr><td>**Sous-Proved**</td><td>Se charge selon le Proved sélectionné</td><td>Non</td></tr><tr><td>**École**</td><td>Filtre sur un ou plusieurs établissements spécifiques</td><td>Non</td></tr><tr><td>**Section**</td><td>Section pédagogique (Primaire, Humanités, Techniques…)</td><td>Non</td></tr><tr><td>**Classe**</td><td>Niveau de classe</td><td>Non</td></tr><tr><td>**Option**</td><td>Option pédagogique (cascade selon Section)</td><td>Non</td></tr></tbody></table>

⚠️ **Filtre Province obligatoire :** Si aucune province n'est sélectionnée, le bouton **Générer le rapport** reste grisé et un message d'avertissement *"Sélectionnez au moins une province"* s'affiche.

### Zone 2 — Filtres complémentaires

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Zone filtres complémentaires des écoles : 4 cases à cocher alignées horizontalement avec leurs libellés complets</callout>`

<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 1è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 2è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>

### Zone 3 — Sélection et ordonnancement des colonnes

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Zone "Colonnes à inclure" : liste gauche "Colonnes disponibles" avec barre de recherche en haut et toutes les colonnes disponibles (scrollable) ; liste droite "Colonnes sélectionnées" affichant 6 colonnes avec flèches ▲▼ pour réordonner et bouton ✕ pour retirer ; boutons "Tout sélectionner" et "Réinitialiser la sélection" sous la liste gauche ; compteur "6 colonnes sélectionnées" en haut de la liste droite</callout>`

**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\. Cliquez sur **Tout sélectionner** pour inclure toutes les colonnes disponibles.  
3\. Cliquez sur **✕** à droite d'une colonne sélectionnée pour la retirer.  
4\. Utilisez les flèches **▲** et **▼** pour modifier l'**ordre des colonnes** dans le fichier Excel généré.

**Colonnes disponibles pour le rapport des écoles :**

<table id="bkmrk-identifiant-libell%C3%A9-"><thead><tr><th>Identifiant</th><th>Libellé dans le fichier Excel</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 interne PIGBF de l'école</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 complet 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>

### Générer le rapport des écoles

1. Configurez vos filtres géographiques (Province obligatoire) et complémentaires.
2. Sélectionnez et ordonnez les colonnes souhaitées.
3. Cliquez sur **Générer le rapport**.
4. Une fenêtre modale de confirmation s'affiche.
5. Cliquez sur **Fermer**. La demande est soumise en arrière-plan.

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

Vous recevrez un email à votre adresse de connexion avec un lien de téléchargement vers le fichier Excel dès que la génération sera terminée.

---

# B.8.8.3 — Rapport des élèves

## 8.3 Rapport des élèves

### Accéder au rapport des élèves

Menu latéral → **Rapports → Rapport des élèves**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page "Rapport des élèves" : même structure 3 zones que le rapport écoles, avec les filtres géographiques Province/Proved/Sous-Proved/École/Section/Classe/Option, les filtres complémentaires spécifiques aux élèves, et la zone de sélection des colonnes</callout>`

### Filtres complémentaires pour les élèves

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Zone filtres complémentaires élèves : cases à cocher et listes déroulantes spécifiques aux élèves — Avec numéro SERNIE, Situation de handicap (liste : Toutes / Avec handicap / Sans handicap), Situation d'étude (En cours / Abandonnée), Première tranche payée, Deuxième tranche payée</callout>`

<table id="bkmrk-filtre-description-a"><thead><tr><th>Filtre</th><th>Description</th></tr></thead><tbody><tr><td>**Avec numéro SERNIE**</td><td>N'inclut que les élèves dont le numéro SERNIE national est renseigné</td></tr><tr><td>**Situation de handicap**</td><td>Toutes / Avec handicap / Sans handicap</td></tr><tr><td>**Situation d'étude**</td><td>En cours (actives) / Abandonnées</td></tr><tr><td>**Première tranche payée**</td><td>N'inclut que les élèves / tuteurs ayant perçu la 1ère tranche M-Pesa</td></tr><tr><td>**Deuxième tranche payée**</td><td>N'inclut que les élèves / tuteurs ayant perçu la 2ème tranche M-Pesa</td></tr></tbody></table>

### Colonnes disponibles pour le rapport des élèves

Le rapport des élèves offre le jeu de colonnes le plus riche de la plateforme :

<table id="bkmrk-identifiant-libell%C3%A9-"><thead><tr><th>Identifiant</th><th>Libellé dans le fichier Excel</th></tr></thead><tbody><tr><td>`nom`</td><td>Nom de l'élève</td></tr><tr><td>`postnom`</td><td>Post-nom</td></tr><tr><td>`prenom`</td><td>Prénom</td></tr><tr><td>`uid`</td><td>Identifiant unique (UID) de l'élève</td></tr><tr><td>`code`</td><td>Code humain court</td></tr><tr><td>`genre_id`</td><td>Genre</td></tr><tr><td>`date_naissance`</td><td>Date de naissance</td></tr><tr><td>`lieu_naissance`</td><td>Lieu de naissance</td></tr><tr><td>`age`</td><td>Âge calculé à la date de génération</td></tr><tr><td>`statut_migratoire_id`</td><td>Statut migratoire</td></tr><tr><td>`has_handicap`</td><td>Situation de handicap (Oui / Non)</td></tr><tr><td>`numero_sernie`</td><td>Numéro SERNIE</td></tr><tr><td>`situation_parentale_id`</td><td>Situation parentale</td></tr><tr><td>`nb_frere_soeur_foyer`</td><td>Nombre de frères et sœurs au foyer</td></tr><tr><td>`nb_frere_soeur_ecole`</td><td>Nombre de frères et sœurs dans la même école</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>`territoire`</td><td>Territoire</td></tr><tr><td>`secteur`</td><td>Secteur</td></tr><tr><td>`groupement`</td><td>Groupement</td></tr><tr><td>`village`</td><td>Village</td></tr><tr><td>`nom_ecole`</td><td>Nom de l'école</td></tr><tr><td>`classe_id`</td><td>Classe</td></tr><tr><td>`section_id`</td><td>Section</td></tr><tr><td>`option_id`</td><td>Option</td></tr><tr><td>`nom_tuteur`</td><td>Nom du tuteur légal</td></tr><tr><td>`lien_tuteur_eleve`</td><td>Lien de parenté tuteur-élève</td></tr><tr><td>`phone_tuteur`</td><td>Téléphone du tuteur</td></tr><tr><td>`compte_mpesa_tuteur`</td><td>Numéro M-Pesa du tuteur</td></tr><tr><td>`moyenne_s1_p1`</td><td>Moyenne Semestre 1, Période 1</td></tr><tr><td>`moyenne_s1_p2`</td><td>Moyenne Semestre 1, Période 2</td></tr><tr><td>`examen_s1`</td><td>Examen Semestre 1</td></tr><tr><td>`moyenne_s1`</td><td>Moyenne Semestre 1</td></tr><tr><td>`frequentation_s1`</td><td>Taux de fréquentation Semestre 1</td></tr><tr><td>`regularite_s1`</td><td>Régularité Semestre 1 (Régulière / Irrégulière)</td></tr><tr><td>`moyenne_s2_p1`</td><td>Moyenne Semestre 2, Période 1</td></tr><tr><td>`moyenne_s2_p2`</td><td>Moyenne Semestre 2, Période 2</td></tr><tr><td>`examen_s2`</td><td>Examen Semestre 2</td></tr><tr><td>`moyenne_s2`</td><td>Moyenne Semestre 2</td></tr><tr><td>`frequentation_s2`</td><td>Taux de fréquentation Semestre 2</td></tr><tr><td>`regularite_s2`</td><td>Régularité Semestre 2</td></tr><tr><td>`statut_etude`</td><td>Statut de scolarité (En cours / Abandonnée)</td></tr><tr><td>`motif_abandon`</td><td>Motif d'abandon scolaire (si applicable)</td></tr><tr><td>`premiere_tranche_payee`</td><td>Première tranche payée (Oui / Non)</td></tr><tr><td>`montant_premiere_tranche`</td><td>Montant perçu pour la 1ère tranche</td></tr><tr><td>`deuxieme_tranche_payee`</td><td>Deuxième tranche payée (Oui / Non)</td></tr><tr><td>`montant_deuxieme_tranche`</td><td>Montant perçu pour la 2ème tranche</td></tr><tr><td>`phone_call`</td><td>Téléphone de l'élève</td></tr><tr><td>`phone_whatsapp`</td><td>WhatsApp de l'élève</td></tr><tr><td>`email`</td><td>Email de l'élève</td></tr></tbody></table>

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Zone "Colonnes à inclure" du rapport élèves : liste gauche avec toutes les colonnes disponibles (scroll visible), liste droite avec 8 colonnes sélectionnées en exemple ("Nom", "Postnom", "Prénom", "UID", "École", "Classe", "Tuteur", "Compte M-Pesa tuteur") avec leurs boutons de réordonnancement et de suppression</callout>`

### Générer le rapport des élèves

Même procédure que pour le rapport des écoles :  
1\. Configurez les filtres géographiques (Province obligatoire) et les filtres complémentaires.  
2\. Sélectionnez et ordonnez les colonnes.  
3\. Cliquez sur **Générer le rapport**.  
4\. Confirmez dans la fenêtre modale.  
5\. Attendez l'email avec le lien de téléchargement.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fenêtre modale de confirmation après soumission du rapport élèves : icône succès, message de confirmation avec mention de l'adresse email de destination, bouton Fermer</callout>`

> ℹ️ **Conseil pour les rapports volumineux :** Si vous générez un rapport pour l'ensemble de votre Sous-PROVED avec toutes les colonnes, le fichier peut contenir des dizaines de milliers de lignes. La génération peut prendre plusieurs minutes. Utilisez les filtres pour générer des rapports plus ciblés si vous avez besoin de résultats rapidement.

---

# B.8.8.4 — Rapport des tuteurs

## 8.4 Rapport des tuteurs

### Accéder au rapport des tuteurs

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

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page "Rapport des tuteurs" : même structure 3 zones que les rapports précédents, avec filtres géographiques (Province, Proved, Sous-Proved, École), filtres complémentaires spécifiques aux tuteurs, zone de sélection des colonnes</callout>`

### Filtres complémentaires pour les tuteurs

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Zone filtres complémentaires tuteurs : cases à cocher Ayant reçu la 1ère tranche, Ayant reçu la 2ème tranche, Avec compte de paiement configuré, Avec handicap, Avec représentant désigné</callout>`

<table id="bkmrk-filtre-description-a"><thead><tr><th>Filtre</th><th>Description</th></tr></thead><tbody><tr><td>**Ayant reçu la 1ère tranche**</td><td>Tuteurs ayant effectivement perçu la 1ère tranche M-Pesa pour l'année active</td></tr><tr><td>**Ayant reçu la 2ème tranche**</td><td>Tuteurs ayant effectivement perçu la 2ème tranche M-Pesa pour l'année active</td></tr><tr><td>**Avec compte de paiement**</td><td>Tuteurs dont un compte M-Pesa est configuré et actif</td></tr><tr><td>**Situation de handicap**</td><td>Tuteurs avec ou sans handicap déclaré</td></tr><tr><td>**Avec représentant**</td><td>Tuteurs ayant un représentant légal désigné dans la PIGBF</td></tr></tbody></table>

### Colonnes disponibles pour le rapport des tuteurs

<table id="bkmrk-identifiant-libell%C3%A9-"><thead><tr><th>Identifiant</th><th>Libellé dans le fichier Excel</th></tr></thead><tbody><tr><td>`nom`</td><td>Nom du tuteur</td></tr><tr><td>`postnom`</td><td>Post-nom</td></tr><tr><td>`prenom`</td><td>Prénom</td></tr><tr><td>`uid`</td><td>Identifiant unique (UID) du tuteur</td></tr><tr><td>`code`</td><td>Code interne PIGBF</td></tr><tr><td>`genre_id`</td><td>Genre</td></tr><tr><td>`date_naissance`</td><td>Date de naissance</td></tr><tr><td>`niveau_etude_id`</td><td>Niveau d'étude</td></tr><tr><td>`profession_id`</td><td>Profession</td></tr><tr><td>`email`</td><td>Adresse e-mail</td></tr><tr><td>`phone_call`</td><td>Numéro de téléphone (appel)</td></tr><tr><td>`phone_whatsapp`</td><td>Numéro WhatsApp</td></tr><tr><td>`nb_enfants_foyer`</td><td>Nombre d'enfants au foyer</td></tr><tr><td>`nb_enfants_ecole`</td><td>Nombre d'enfants à l'école bénéficiaires</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>`has_handicap`</td><td>Situation de handicap du tuteur (Oui / Non)</td></tr><tr><td>`has_handicap_besoin`</td><td>Nature du besoin lié au handicap</td></tr><tr><td>`nom_representant`</td><td>Nom du représentant légal</td></tr><tr><td>`lien_representant`</td><td>Lien entre le représentant et le tuteur</td></tr><tr><td>`phone_call_representant`</td><td>Téléphone du représentant</td></tr><tr><td>`compte_paiement_type`</td><td>Type de compte de paiement (M-Pesa, Equity…)</td></tr><tr><td>`compte_paiement`</td><td>Numéro du compte de paiement</td></tr><tr><td>`montant_premiere_tranche`</td><td>Montant total reçu pour la 1ère tranche</td></tr><tr><td>`montant_deuxieme_tranche`</td><td>Montant total reçu pour la 2ème tranche</td></tr></tbody></table>

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Zone colonnes rapport tuteurs : exemple de sélection de 7 colonnes ("Nom", "Postnom", "Prénom", "Téléphone", "Compte M-Pesa", "Nb élèves", "Montant tranche 1") dans la liste de droite avec réordonnancement possible</callout>`

### Générer le rapport des tuteurs

Même procédure que pour les autres rapports : filtres → colonnes → **Générer le rapport** → confirmation → email avec lien de téléchargement.

---

# B.8.8.5 — Mes Rapports — Historique et re-téléchargement

## 8.5 Mes Rapports — Historique et re-téléchargement

### Vue d'ensemble

La section **Mes Rapports** liste l'historique de tous les rapports demandés par l'utilisateur connecté, quel que soit leur type (écoles, élèves, tuteurs). Elle permet de suivre le statut de traitement de chaque rapport et de re-télécharger un fichier déjà généré sans avoir à le régénérer.

Menu latéral → **Rapports → Mes Rapports**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Page "Mes Rapports" : tableau avec colonnes Type de rapport (Écoles / Élèves / Tuteurs avec badge coloré), Date de demande, Filtres appliqués (résumé compact des filtres), Statut (badge En cours de génération orange / Prêt vert / Erreur rouge), Bouton "Télécharger" (actif uniquement si Prêt). Pagination en bas si plusieurs rapports</callout>`

### Colonnes du tableau Mes Rapports

<table id="bkmrk-colonne-description-"><thead><tr><th>Colonne</th><th>Description</th></tr></thead><tbody><tr><td>**Type**</td><td>Type de rapport — Écoles, Élèves ou Tuteurs (badge coloré distinctif)</td></tr><tr><td>**Date de demande**</td><td>Horodatage de la soumission de la demande</td></tr><tr><td>**Filtres appliqués**</td><td>Résumé compact des filtres configurés lors de la génération (Province, Sous-PROVED, etc.)</td></tr><tr><td>**Colonnes**</td><td>Nombre de colonnes sélectionnées pour ce rapport</td></tr><tr><td>**Statut**</td><td>*En cours de génération* (orange, animé) / *Prêt* (vert) / *Erreur* (rouge)</td></tr><tr><td>**Action**</td><td>Bouton **Télécharger** (actif uniquement si le statut est *Prêt*)</td></tr></tbody></table>

### Télécharger un rapport

1. Repérez le rapport souhaité dans la liste.
2. Vérifiez que le statut est **Prêt** (badge vert).
3. Cliquez sur **Télécharger**. Le fichier Excel s'ouvre ou se télécharge dans votre dossier de téléchargements.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Ligne de rapport avec statut "Prêt" en badge vert et bouton "Télécharger" actif en bleu, en comparaison avec une ligne "En cours de génération" avec badge orange animé et bouton "Télécharger" grisé</callout>`

> ℹ️ **Durée de disponibilité :** Les fichiers de rapport restent disponibles pendant **7 jours** après leur génération. Au-delà, le lien de téléchargement expire et le rapport doit être régénéré si nécessaire.

### Rapport en erreur

Si un rapport affiche le statut **Erreur** (badge rouge), cela indique un problème lors de la génération (interruption du serveur, données trop volumineuses, erreur technique). Dans ce cas :  
1\. Notez la date et le type du rapport en erreur.  
2\. Retournez sur la page de configuration du rapport concerné.  
3\. Vérifiez vos filtres (réduisez si nécessaire la taille du jeu de données en ajoutant des filtres géographiques plus précis).  
4\. Relancez la génération.  
5\. Si l'erreur persiste, contactez l'équipe IT GROUP à l'adresse **support@itgroup.cd** en précisant le type de rapport, les filtres appliqués et l'horodatage de la demande.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Ligne de rapport avec statut "Erreur" en badge rouge, bouton "Réessayer" visible à la place du bouton Télécharger, info-bulle au survol expliquant brièvement l'erreur</callout>`

---

# B.8.8.6 — Bonnes pratiques — Rapports

## 8.6 Bonnes pratiques — Rapports

**Utilisez des filtres précis pour des rapports ciblés.** Plutôt que de générer un rapport sur l'ensemble de votre ONG avec toutes les colonnes (qui peut peser plusieurs dizaines de milliers de lignes), générez des rapports par Sous-PROVED ou par groupe d'écoles. Les rapports ciblés se génèrent plus rapidement et sont plus faciles à exploiter dans Excel.

**Vérifiez votre adresse email avant de lancer une génération.** Le rapport est envoyé à l'adresse enregistrée dans votre compte. Si cette adresse est incorrecte ou inaccessible, le rapport sera perdu. Vérifiez vos paramètres de profil avant une génération importante.

**Gardez vos rapports archivés localement.** La plateforme ne conserve les fichiers que 7 jours. Téléchargez et sauvegardez vos rapports importants immédiatement après réception.

**Utilisez la section Mes Rapports pour suivre les générations en cours.** Si vous avez lancé plusieurs rapports en parallèle, consultez régulièrement cette section pour suivre leur avancement sans attendre les emails.

**Coordonnez les générations lors des périodes de forte charge.** En période de validation post-campagne (immédiatement après une campagne de collecte terrain), plusieurs utilisateurs peuvent lancer simultanément des rapports volumineux. Les délais de génération peuvent être plus longs. Privilégiez les générations en dehors de ces pics d'activité.

---

*Fin du chapitre B.8 — Rapports*

---

---