Manuel PIGBF — Section A — Administrateur Plateforme
Section A du Manuel Administrateur PIGBF — Administrateur Plateforme
- A.1 — Introduction générale
- A.1.1.1 — Présentation du programme PAAF et de la PIGBF
- A.1.1.2 — Ce que la plateforme permet de faire
- A.1.1.3 — Architecture du système
- A.1.1.4 — Les utilisateurs de la plateforme — les 7 rôles
- A.1.1.5 — L'année scolaire — notion centrale du système
- A.1.1.6 — Conventions et symboles utilisés dans ce manuel
- A.1.1.7 — Comment utiliser ce manuel
- A.2 — Connexion et prise en main
- A.2.2.1 — Prérequis techniques
- A.2.2.2 — Se connecter à la plateforme
- A.2.2.3 — Mot de passe oublié
- A.2.2.4 — Découverte de l'interface
- A.2.2.5 — Changer l'année scolaire affichée
- A.2.2.6 — Gérer son profil et changer de mot de passe
- A.2.2.7 — Se déconnecter
- A.2.2.8 — Cas particuliers et messages d'erreur courants
- A.3 — Tableau de bord
- A.3.3.1 — Rôle et nature du tableau de bord
- A.3.3.2 — Structure générale du tableau de bord
- A.3.3.3 — Bloc 1 — Compteurs globaux
- A.3.3.4 — Bloc 2 — Validations en attente
- A.3.3.5 — Bloc 3 — État des paiements par tranche
- A.3.3.6 — Bloc 4 — Abandons scolaires
- A.3.3.7 — Bloc 5 — Graphiques analytiques
- A.3.3.8 — Utiliser le tableau de bord comme outil de pilotage quotidien
- A.4 — Gestion des organisations
- A.4.4.1 — Vue d'ensemble
- A.4.4.2 — Les ONG partenaires
- A.4.4.3 — Les axes de collecte
- A.4.4.4 — Relation ONG — Axes — Utilisateurs — Enquêteurs
- A.5 — Gestion des écoles
- A.5.5.1 — Vue d'ensemble
- A.5.5.2 — Liste des écoles
- A.5.5.3 — Fiche détaillée d'une école
- A.5.5.4 — Ajouter une école manuellement
- A.5.5.5 — Modifier une école
- A.5.5.6 — Supprimer une école
- A.5.5.7 — Liste des préfets
- A.5.5.8 — Traitement des doublons d'écoles
- A.5.5.9 — Validation des écoles pour paiement
- A.6 — Gestion des élèves
- A.6.6.1 — Vue d'ensemble
- A.6.6.2 — Liste des élèves et recherche
- A.6.6.3 — Fiche détaillée d'une élève
- A.6.6.4 — Ajouter une élève manuellement
- A.6.6.5 — Traitement des doublons d'élèves
- A.6.6.6 — Validation des élèves pour paiement
- A.7 — Gestion des tuteurs
- A.7.7.1 — Rôle du tuteur dans la PIGBF
- A.7.7.2 — Liste des tuteurs et recherche
- A.7.7.3 — Fiche détaillée d'un tuteur
- A.7.7.4 — Ajouter un tuteur manuellement
- A.7.7.5 — Modifier un tuteur
- A.7.7.6 — Supprimer un tuteur
- A.8 — Validation des données ODK
- A.8.8.1 — Comprendre le circuit de validation ODK
- A.8.8.2 — Validation des données écoles
- A.8.8.3 — Validation des données élèves
- A.8.8.4 — Validation des données tuteurs
- A.8.8.5 — Bonnes pratiques de validation ODK
- A.9 — Gestion des paiements
- A.9.9.1 — Vue d'ensemble du module paiements
- A.9.9.2 — Gestion des prestataires
- A.9.9.3 — Paiements Equity BCDC — Cycle complet
- A.9.9.4 — Paiements Vodacom M-Pesa — Cycle complet
- A.9.9.5 — Bonnes pratiques et points de vigilance — Paiements
- A.10 — Rapports
- A.10.10.1 — Vue d'ensemble du module Rapports
- A.10.10.2 — Rapport des écoles
- A.10.10.3 — Rapport des élèves
- A.10.10.4 — Rapport des tuteurs
- A.10.10.5 — Mes Rapports
- A.10.10.6 — Bonnes pratiques — Rapports
- A.11 — Gestion des utilisateurs et acteurs
- A.11.11.1 — Vue d'ensemble
- A.11.11.2 — Les acteurs
- A.11.11.3 — Créer un nouvel utilisateur
- A.11.11.4 — Modifier un utilisateur existant
- A.11.11.5 — Consulter la fiche d'un utilisateur
- A.11.11.6 — Suspendre et réactiver un compte utilisateur
- A.11.11.7 — Gestion des enquêteurs terrain
- A.11.11.8 — Bonnes pratiques — Gestion des utilisateurs
- A.12 — Rôles et permissions
- A.12.12.1 — Vue d'ensemble du module
- A.12.12.2 — Les 7 rôles de la plateforme
- A.12.12.3 — Visualiser les permissions d'un rôle
- A.12.12.4 — Créer un rôle personnalisé
- A.12.12.5 — Modifier un rôle existant
- A.12.12.6 — Supprimer un rôle personnalisé
- A.13 — Paramètres généraux
- A.13.13.1 — Vue d'ensemble
- A.13.13.2 — Fonctionnement général des référentiels
- A.13.13.3 — Référentiels géographiques
- A.13.13.4 — Référentiels pédagogiques
- A.13.13.5 — Référentiels socio-administratifs
- A.14 — Années scolaires
- A.14.14.1 — Vue d'ensemble
- A.14.14.2 — Créer une nouvelle année scolaire
- A.14.14.3 — Configurer les paramètres financiers de l'année scolaire
- A.14.14.4 — Gérer les tranches de paiement
- A.14.14.5 — Définir l'année scolaire active
- A.14.14.6 — Clôturer une année scolaire
- A.14.14.7 — Le sélecteur d'année scolaire dans l'interface
- A.15 — Logs et journal d'activités
A.1 — Introduction générale
Chapitre A.1 du Manuel PIGBF
A.1.1.1 — Présentation du programme PAAF et de la PIGBF
1.1 Présentation du programme PAAF et de la PIGBF
Le Projet d'Apprentissage et d'Autonomisation des Filles (PAAF) est un programme d'appui à la scolarisation des filles dans la province du Kasaï, en République Démocratique du Congo. Dans le cadre de ce programme, les bénéficiaires — des élèves filles identifiées selon des critères précis de vulnérabilité, d'âge et de résultats scolaires — reçoivent une bourse scolaire versée directement à leur école ou à leur tuteur légal selon la configuration définie pour chaque tranche de paiement.
Pour assurer la gestion rigoureuse, transparente et traçable de l'ensemble de ce dispositif, le programme PAAF s'appuie sur la Plateforme Informatique de Gestion des Bourses pour les Filles (PIGBF), développée par IT GROUP Sarl (169, avenue Kasa-Vubu — Immeuble Triangle Davier — 2ème Niveau, Commune de la GOMBE, Kinshasa). La PIGBF est accessible à l'adresse https://pigbf.org.
La PIGBF n'est pas un simple outil de saisie : c'est un écosystème numérique complet qui couvre l'intégralité du cycle de vie d'une bourse scolaire, depuis l'identification des bénéficiaires sur le terrain jusqu'au paiement effectif et au reporting de redevabilité auprès des bailleurs.
A.1.1.2 — Ce que la plateforme permet de faire
1.2 Ce que la plateforme permet de faire
La PIGBF est structurée autour de quatre grandes fonctions complémentaires, qui forment ensemble un cycle continu de gestion du programme :
1. Inscription et gestion des bénéficiaires
Centralisation des données des élèves, des écoles et des tuteurs. Chaque bénéficiaire reçoit un identifiant unique (UID) et un QR Code générés automatiquement par la plateforme. Des outils de détection et de traitement des doublons garantissent l'unicité de chaque dossier. Un processus de validation d'éligibilité contrôle les critères d'accès à la bourse (âge, fréquentation, résultats) avant tout paiement.
2. Gestion des paiements
Deux circuits de paiement sécurisés coexistent : Equity BCDC pour les virements bancaires vers les écoles (frais scolaires), et Vodacom M-Pesa pour les paiements mobile money aux tuteurs et élèves (subvention). Le cycle complet — génération des instructions → validation par le Validateur PAAF → envoi sécurisé par OTP (Equity) ou API (M-Pesa) → suivi des confirmations — est intégralement géré depuis la plateforme.
3. Suivi des conditionnalités
Collecte et suivi des notes scolaires et des présences des élèves via les formulaires ODK de terrain, permettant de vérifier à chaque tranche de paiement que les bénéficiaires respectent les conditions d'attribution de la bourse (taux de fréquentation minimum, seuil de résultats).
4. Administration, paramétrage et reporting
Gestion des utilisateurs et de leurs droits d'accès par rôle (RBAC), paramétrage des référentiels métier (classes, options, territoires, types de documents, etc.), gestion des années scolaires et de leur clôture, génération asynchrone de rapports paramétrables envoyés par email, et journal d'activités complet pour l'auditabilité de chaque action.
A.1.1.3 — Architecture du système
1.3 Architecture du système
La PIGBF repose sur deux applications Laravel distinctes et complémentaires :
| Application | Rôle | Accès |
|---|---|---|
| laravel-pigbf | Interface d'administration (back-office) — l'application décrite dans ce manuel | Internet — pigbf.org |
| api-pigbf | Moteur d'intégration — gère les synchronisations ODK, les exports, les rapports lourds et les paiements Equity/M-Pesa | Réseau interne — api.pigbf.org |
Stack technique : PHP 8.2+ · Laravel 12 · Livewire 3 · MySQL · Keycloak (SSO) · Ubuntu Server LTS · ODK Central.
Du point de vue de l'administrateur, une seule interface est à maîtriser : le back-office accessible sur pigbf.org. L'application api-pigbf opère en arrière-plan de manière totalement transparente. Elle prend en charge tous les traitements longs ou sensibles : synchronisation avec ODK Central, génération de fichiers d'export volumineux, chiffrement PGP et dépôt SFTP des fichiers Equity, appels API M-Pesa. La plateforme front-office lui délègue ces tâches via des appels HTTP et récupère les résultats lorsqu'ils sont disponibles.
Collecte terrain : Les enquêteurs de terrain n'ont aucun accès à l'interface web. Ils utilisent exclusivement l'application mobile ODK Collect (Android) pour collecter les données sur tablette, en mode déconnecté si nécessaire. Les données sont synchronisées vers le serveur ODK Central à la prochaine connexion réseau, puis traitées par le scheduler de l'API avant d'être mises à disposition pour validation dans la PIGBF.
📸 Capture d'écran à insérer : Schéma d'architecture simplifié à deux niveaux : (1) Enquêteurs → ODK Collect → ODK Central, (2) Administrateurs → pigbf.org (laravel-pigbf) ↔ api.pigbf.org (api-pigbf) → MySQL
A.1.1.4 — Les utilisateurs de la plateforme — les 7 rôles
1.4 Les utilisateurs de la plateforme — les 7 rôles
L'accès à la PIGBF est régi par un modèle de contrôle d'accès basé sur les rôles (RBAC — Role-Based Access Control). Chaque utilisateur se voit attribuer un profil qui détermine précisément les modules, les pages et les actions (lecture, création, modification, suppression, validation) auxquels il a accès. La plateforme définit 7 rôles :
| Rôle | Périmètre d'action |
|---|---|
| Super Admin | Accès total à toutes les fonctionnalités de la plateforme, tous programmes et toutes ONG confondus. Seul rôle pouvant créer d'autres Super Admins et modifier les paramètres système critiques. |
| Admin | Administration générale de la plateforme sur le périmètre qui lui est assigné. Accès à la quasi-totalité des modules, hors paramétrage système réservé au Super Admin. |
| Admin PAAF | Supervision du programme côté coordination PAAF. Accès aux données consolidées, aux paiements, aux rapports de tous les axes et ONG. |
| Admin ONG | Gestion des opérations de son ONG uniquement : validation ODK, suivi des écoles/élèves/tuteurs de son périmètre, rapports. Accès cloisonné par organisation. |
| Validateur paiement PAAF | Rôle autonome dédié exclusivement à la validation et à l'envoi des instructions de paiement Equity et M-Pesa. N'a pas accès aux modules de données bénéficiaires. |
| Admin IT ONG | Profil technique au sein de l'ONG : gestion des enquêteurs, validation des données ODK, support à la collecte. |
| Lecture seule | Consultation sans aucune modification possible — profil audit, supervision externe, bailleurs. |
Important : Ce manuel couvre le rôle Administrateur Plateforme (Super Admin / Admin), qui dispose du périmètre le plus étendu. Les sections B, C et D du présent manuel documentent respectivement les rôles Admin ONG / Admin IT ONG, Validateur de paiement et Enquêteur terrain ODK.
A.1.1.5 — L'année scolaire — notion centrale du système
1.5 L'année scolaire — notion centrale du système
Toutes les données de la PIGBF sont filtrées par année scolaire active. Cette notion est absolument centrale : chaque écran de liste, chaque rapport, chaque instruction de paiement, chaque statistique du tableau de bord est rattaché à une année scolaire spécifique.
L'année scolaire active est affichée en permanence dans la barre supérieure de l'interface. Il est possible de consulter les données des années précédentes (en lecture seule après leur clôture) en changeant la sélection dans la barre supérieure, mais toute création ou modification de données ne s'applique qu'à l'année scolaire active.
Conditions préalables au démarrage d'une année : Avant de pouvoir utiliser pleinement la plateforme pour une nouvelle année scolaire, un Super Admin doit avoir configuré l'année dans les Paramètres (cf. chapitre A.14) : création de l'année, définition du montant de la bourse par bénéficiaire, configuration des tranches de paiement et de leurs montants respectifs pour les écoles et pour les tuteurs/élèves.
La clôture d'une année scolaire est une opération irréversible qui verrouille l'ensemble des données de l'année concernée : aucune création, modification ou suppression n'est possible après cette action. Elle est décrite en détail au chapitre A.14.
A.1.1.6 — Conventions et symboles utilisés dans ce manuel
1.6 Conventions et symboles utilisés dans ce manuel
Tout au long de ce document, les conventions de la page de garde s'appliquent. Les captures d'écran sont indiquées par des emplacements réservés de la forme . Ces emplacements seront remplacés par les captures réelles lors de la finalisation du manuel.
Les procédures pas à pas sont toujours présentées sous forme d'étapes numérotées. Les actions irréversibles sont systématiquement signalées par le symbole ⚠️ avant leur description.
A.1.1.7 — Comment utiliser ce manuel
1.7 Comment utiliser ce manuel
Ce manuel Section A est organisé en 15 chapitres couvrant l'intégralité des fonctionnalités accessibles à l'Administrateur Plateforme :
- Chapitres A.1 à A.3 — Prise en main : présentation générale, connexion, tableau de bord
- Chapitres A.4 à A.8 — Données métier : organisations, écoles, élèves, tuteurs, validation ODK
- Chapitre A.9 — Paiements Equity BCDC et M-Pesa
- Chapitres A.10 à A.15 — Administration avancée : rapports, utilisateurs et acteurs, rôles et permissions, paramètres généraux, années scolaires, journal d'activités
Chaque chapitre est conçu pour être consulté de façon autonome. Des renvois vers d'autres chapitres sont indiqués lorsqu'une action en prérequiert une autre.
A.2 — Connexion et prise en main
Chapitre A.2 du Manuel PIGBF
A.2.2.1 — Prérequis techniques
2.1 Prérequis techniques
Avant d'accéder à la PIGBF, assurez-vous de disposer des éléments suivants :
| Prérequis | Détail |
|---|---|
| Navigateur web | Google Chrome (recommandé), Mozilla Firefox, Microsoft Edge ou Safari — version récente |
| Connexion internet | Requise en permanence pour toute utilisation de l'interface web |
| Identifiants | Adresse email et mot de passe fournis par le Super Admin ou l'équipe IT GROUP |
| URL d'accès | https://pigbf.org |
ℹ️ Note : La PIGBF est une application web accessible directement depuis un navigateur. Aucune installation de logiciel n'est nécessaire sur le poste de l'administrateur. Les navigateurs en version trop ancienne peuvent présenter des problèmes d'affichage ; il est recommandé de maintenir son navigateur à jour.
A.2.2.2 — Se connecter à la plateforme
2.2 Se connecter à la plateforme
Procédure de connexion standard
⚠️ Attention : Après plusieurs tentatives de connexion échouées consécutives, la plateforme peut temporairement bloquer l'accès depuis votre adresse IP. Si cela se produit, attendez quelques minutes avant de réessayer ou contactez l'administrateur système.
A.2.2.3 — Mot de passe oublié
2.3 Mot de passe oublié
Si vous avez oublié votre mot de passe, une procédure de réinitialisation autonome est disponible directement depuis la page de connexion, sans intervention de l'administrateur.
Procédure de réinitialisation
- Sur la page de connexion, cliquez sur le lien « Mot de passe oublié ? » situé sous le champ Mot de passe.
- Une page de réinitialisation s'affiche. Saisissez l'adresse email associée à votre compte PIGBF.
- Cliquez sur Envoyer le lien de réinitialisation.
- Un message de confirmation s'affiche à l'écran, vous indiquant qu'un email a été envoyé si l'adresse existe dans le système.
- Consultez votre boîte email. Vous recevrez un message contenant un lien de réinitialisation sécurisé. Ce lien est valide pour une durée limitée (généralement 60 minutes).
- Cliquez sur le lien reçu par email. Vous êtes redirigé vers un formulaire de définition d'un nouveau mot de passe.
- Saisissez votre nouveau mot de passe dans le premier champ, puis confirmez-le dans le second. Choisissez un mot de passe robuste (au moins 8 caractères, combinant lettres majuscules, minuscules, chiffres et caractères spéciaux).
- Cliquez sur Réinitialiser le mot de passe.
- Vous êtes redirigé vers la page de connexion. Connectez-vous avec vos nouveaux identifiants.
ℹ️ Note : Si vous ne recevez pas l'email dans les 5 minutes suivant votre demande, vérifiez votre dossier de courrier indésirable (spam/junk). En cas de problème persistant (adresse email incorrecte, email non reçu), contactez l'équipe IT GROUP.
A.2.2.4 — Découverte de l'interface
2.4 Découverte de l'interface
Une fois connecté, vous accédez à l'interface principale de la PIGBF. Celle-ci est composée de trois zones permanentes qui restent visibles quelle que soit la page consultée.
2.4.1 Le menu latéral (navigation principale)
Structure complète du menu (rôle Super Admin / Admin) :
| Groupe | Modules |
|---|---|
| (sans groupe) | Dashboard |
| Gestion des bénéficiaires | Bénéficiaires · Écoles · Tuteurs |
| Gestion des paiements | Prestataires · Paiements |
| Validation des données collectées | Données Collectées |
| Rapports | Rapports |
| Gestion des utilisateurs et param. | Utilisateurs · Paramètres |
| Journal des activités | Logs |
| Gestion de mon compte | Profil |
Cliquer sur une entrée de menu qui possède des sous-menus la développe pour afficher ses sous-sections. Un second clic la referme. Le bouton fléché (chevron) en haut du menu latéral permet de réduire entièrement la barre latérale à une bande d'icônes, libérant ainsi de l'espace pour la zone de contenu — utile sur les écrans de petite taille.
Les modules affichés varient selon les droits attribués à votre rôle. Un utilisateur Admin ONG, par exemple, ne verra pas les modules Prestataires ou Paramètres complets.
2.4.2 La barre supérieure
La barre supérieure, fixe en haut de l'écran, affiche en permanence plusieurs éléments essentiels à la navigation et au contexte de travail :
Sélecteur d'année scolaire (à gauche ou au centre) : affiche l'année scolaire en cours (ex. : 2024-2025 ▼). Ce paramètre est le filtre global de toute la plateforme : il détermine quelles données sont affichées dans tous les modules. Un clic dessus ouvre la liste des années disponibles.
Icône de notifications (cloche) : indique la présence d'alertes ou de messages système en attente de consultation. Un badge numérique rouge signale le nombre de notifications non lues.
Icône des paramètres (engrenage) : accès rapide à certains réglages de l'interface.
2.4.3 La zone de contenu centrale
C'est dans cette zone principale que s'affichent les pages, tableaux, formulaires, graphiques et détails de chaque module. Son contenu change dynamiquement selon la section sélectionnée dans le menu latéral. Elle occupe la majeure partie de l'écran et est scrollable verticalement lorsque le contenu dépasse la hauteur de l'écran.
A.2.2.5 — Changer l'année scolaire affichée
2.5 Changer l'année scolaire affichée
La notion d'année scolaire est centrale dans la PIGBF. Tous les tableaux de données, statistiques et opérations sont filtrés par l'année scolaire sélectionnée dans la barre supérieure. Naviguer d'une année à l'autre est une opération fréquente, notamment pour comparer des données entre années ou consulter l'historique.
Procédure
- Dans la barre supérieure, identifiez le sélecteur d'année scolaire affichant l'année en cours (ex. : 2024-2025).
- Cliquez dessus. Une liste déroulante présente toutes les années scolaires créées dans la plateforme, de la plus récente à la plus ancienne.
- Cliquez sur l'année souhaitée.
- L'ensemble des données affichées dans la plateforme se met à jour immédiatement pour refléter l'année sélectionnée. L'indicateur dans la barre supérieure change en conséquence.
⚠️ Attention : La consultation d'une année passée est toujours possible. En revanche, toute création ou modification de données ne peut s'effectuer que sur l'année scolaire active (non clôturée). Si vous tentez de modifier des données sur une année clôturée, la plateforme bloquera l'action et affichera un message d'avertissement.
A.2.2.6 — Gérer son profil et changer de mot de passe
2.6 Gérer son profil et changer de mot de passe
Chaque utilisateur peut mettre à jour ses informations personnelles, sa photo de profil et son mot de passe de manière autonome, sans solliciter un administrateur. Ces modifications sont immédiatement synchronisées avec le service d'authentification Keycloak.
Accéder à la page Profil
Modifier son nom affiché
Le nom affiché est celui qui apparaît dans la barre supérieure, dans le journal d'activités et dans les historiques de validation.
- Sur la page Profil, localisez le champ Nom.
- Effacez la valeur actuelle et saisissez le nouveau nom souhaité.
- Cliquez sur Enregistrer les modifications.
- Un message de confirmation vert apparaît brièvement en haut de l'écran en cas de succès.
ℹ️ Note : L'adresse email est l'identifiant technique unique du compte. Elle est affichée à titre informatif mais ne peut pas être modifiée depuis cette interface. Pour changer l'adresse email associée à un compte, contactez le Super Admin.
Changer sa photo de profil
- Sur la page Profil, cliquez sur le bouton Changer la photo situé sous l'avatar actuel.
- Une fenêtre de sélection de fichier s'ouvre. Choisissez une image sur votre ordinateur.
- Formats acceptés : JPG et PNG. Taille maximale recommandée : 2 Mo.
- Après sélection, l'aperçu de la nouvelle photo s'affiche. Confirmez si la photo vous convient.
- Cliquez sur Enregistrer les modifications. La photo est sauvegardée et synchronisée avec Keycloak.
Changer son mot de passe
- Sur la page Profil, cliquez sur le bouton Changer de mot de passe.
- Une fenêtre modale s'ouvre avec trois champs :
- Ancien mot de passe — votre mot de passe actuel, requis pour vérification
- Nouveau mot de passe — votre nouveau mot de passe souhaité
- Confirmation du nouveau mot de passe — ressaisissez le nouveau mot de passe à l'identique - Renseignez les trois champs.
- Cliquez sur Valider.
- En cas de succès, un message de confirmation s'affiche et la fenêtre se ferme. Le nouveau mot de passe est actif immédiatement et synchronisé avec Keycloak.
⚠️ Attention : En cas d'erreur lors de la saisie de l'ancien mot de passe, la plateforme affichera un message d'erreur explicite « Mot de passe actuel incorrect ». Si l'image téléversée dépasse la taille autorisée, un message spécifique vous en informera. Dans les deux cas, l'opération est annulée et aucune modification n'est enregistrée.
A.2.2.7 — Se déconnecter
2.7 Se déconnecter
Il est important de se déconnecter explicitement de la plateforme à la fin de chaque session de travail, en particulier sur un poste partagé.
Procédure
- Dans la barre supérieure, cliquez sur votre nom ou avatar (coin supérieur droit).
- Dans le menu déroulant qui s'affiche, cliquez sur Déconnexion.
- Vous êtes immédiatement redirigé vers la page de connexion. Votre session est fermée côté plateforme et côté Keycloak.
ℹ️ Bonne pratique : Ne fermez pas simplement l'onglet ou le navigateur sans vous déconnecter. La session reste active côté serveur pendant un certain temps, ce qui pourrait permettre à une autre personne accédant au même navigateur de consulter vos données. Utilisez systématiquement le bouton de déconnexion.
A.2.2.8 — Cas particuliers et messages d'erreur courants
2.8 Cas particuliers et messages d'erreur courants
| Message / situation | Cause probable | Action à entreprendre |
|---|---|---|
| Identifiants incorrects | Email ou mot de passe erroné | Vérifiez la saisie (majuscules, espaces) ; utilisez « Mot de passe oublié ? » si nécessaire |
| Trop de tentatives — accès temporairement bloqué | Protection anti-bruteforce activée | Attendez quelques minutes et réessayez |
| Compte suspendu ou inactif | Compte désactivé par un administrateur | Contactez votre responsable ou l'équipe IT GROUP |
| Aucune année scolaire configurée | Aucune année scolaire active n'a été paramétrée dans le système | Le Super Admin doit créer et activer une année scolaire (cf. chapitre A.14) |
| Accès refusé à une page | Droits insuffisants pour le rôle assigné | Contactez l'administrateur pour vérifier vos permissions |
| Page blanche ou chargement infini après connexion | Session expirée, problème réseau ou cache navigateur | Actualisez la page (F5 ou Ctrl+R), videz le cache navigateur, ou reconnectez-vous |
| Erreur 500 — Erreur serveur | Problème technique côté serveur | Notez l'heure et les actions effectuées et contactez l'équipe IT GROUP |
A.3 — Tableau de bord
Chapitre A.3 du Manuel PIGBF
A.3.3.1 — Rôle et nature du tableau de bord
3.1 Rôle et nature du tableau de bord
Le tableau de bord est la première page affichée après chaque connexion réussie. Il constitue le centre de pilotage et de Business Intelligence (BI) de la PIGBF : un espace qui synthétise en temps réel l'état global du programme pour l'année scolaire active.
Son objectif est triple :
- Vision macroscopique instantanée — les volumes de bénéficiaires, d'écoles et de tuteurs enregistrés, sans avoir à parcourir les listes détaillées.
- Alerte opérationnelle — signaler les actions en attente qui requièrent une intervention urgente de l'administrateur : validations ODK non traitées, retards dans les paiements, anomalies de cohérence.
- Pilotage analytique — visualiser la distribution des bénéficiaires par classe, par statut migratoire, par zone géographique, permettant de détecter des déséquilibres dans la collecte ou dans le programme.
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.
A.3.3.2 — Structure générale du tableau de bord
3.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 :
| Bloc | Contenu | Priorité de consultation |
|---|---|---|
| Compteurs globaux | 4 indicateurs clés : total bénéficiaires, avec handicap, écoles, tuteurs | Référence rapide |
| Validations en attente | 3 cartes d'alerte ODK : écoles / élèves / tuteurs à valider | ⚡ Priorité haute — action requise |
| État des paiements | Suivi des tranches Equity par école (payées vs non payées) | Suivi de la progression financière |
| Abandons scolaires | Compteur et taux d'abandon parmi les bénéficiaires | Indicateur de risque programme |
| Graphiques analytiques | Répartitions par classe, statut migratoire, zone géographique, etc. | Analyse et pilotage stratégique |
A.3.3.3 — Bloc 1 — Compteurs globaux
3.3 Bloc 1 — Compteurs globaux
La première ligne du tableau de bord affiche quatre compteurs en temps réel donnant une vision immédiate de l'amplitude du programme pour l'année scolaire en cours.
| Compteur | Description | Ce qu'il mesure concrètement |
|---|---|---|
| Total des bénéficiaires | Nombre total d'élèves filles enregistrées et validées | Toutes les bénéficiaires ayant une fiche active dans la PIGBF pour l'année |
| Bénéficiaires avec handicap | Sous-population identifiée avec une situation de handicap déclarée | Nombre de bénéficiaires dont le champ "Situation de handicap" est renseigné à "Oui" |
| Total des écoles | Nombre d'établissements scolaires actifs dans le programme | Écoles validées, ayant au moins une bénéficiaire rattachée |
| Total des tuteurs | Nombre de tuteurs légaux enregistrés et associés | Tuteurs ayant une fiche validée et liés à au moins une bénéficiaire |
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é.
ℹ️ Note : Ces chiffres reflètent l'état exact de la base de données à l'instant de la consultation. Ils évoluent dynamiquement au fil des validations ODK et des opérations effectuées par les administrateurs sur la plateforme.
A.3.3.4 — Bloc 2 — Validations en attente
3.4 Bloc 2 — Validations en attente
Cette section est l'indicateur opérationnel le plus critique du tableau de bord pour l'administrateur au quotidien. Elle affiche, sous forme de trois cartes cliquables, le nombre de fiches collectées sur le terrain via ODK qui n'ont pas encore été validées et transférées dans la base de production.
Signification de chaque carte
Carte 1 — Écoles en attente de validation
Représente le nombre total de formulaires ODK portant sur les établissements scolaires qui sont arrivés dans la zone de staging mais n'ont pas encore été traités par un administrateur. 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, ou de renseignement des frais scolaires. Un clic sur cette carte redirige directement vers la page 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, 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, 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é.
A.3.3.5 — Bloc 3 — État des paiements par tranche
3.5 Bloc 3 — État des paiements par tranche
Ce bloc offre une vue synthétique de l'avancement des versements Equity BCDC vers les écoles, pour chacune des tranches de paiement configurées dans l'année scolaire active. Il permet à l'administrateur de suivre la progression financière du programme d'un seul regard.
Structure du bloc
Pour chaque tranche de paiement (Première Tranche, Deuxième Tranche, etc.), deux métriques sont affichées dans une carte dédiée :
- Payées : nombre d'écoles ayant reçu le virement pour cette tranche (statut confirmé)
- Non payées : nombre d'écoles dont le paiement de cette tranche n'a pas encore été effectué
- Total : nombre total d'écoles du programme pour cette année, rappelé en pied de carte
- Une barre de progression visuelle (rouge / verte) indique le ratio payé vs non payé d'un seul regard
ℹ️ Note : Ces indicateurs concernent exclusivement les paiements Equity BCDC effectués vers les comptes bancaires des écoles. Le suivi des paiements M-Pesa vers les tuteurs et les élèves est accessible depuis le module Paiements → M-Pesa → Suivi (cf. chapitre A.9).
A.3.3.6 — Bloc 4 — Abandons scolaires
3.6 Bloc 4 — 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 la bourse 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'année
- Base de calcul : total des élèves de référence, rappelé sous le taux
ℹ️ 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 de fonds du programme.
A.3.3.7 — Bloc 5 — Graphiques analytiques
3.7 Bloc 5 — 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 enregistrées. Ces graphiques sont générés dynamiquement à partir des données de la base pour l'année scolaire sélectionnée.
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.
Graphique 2 — Bénéficiaires par statut migratoire
Graphique en secteurs (camembert) montrant la répartition des bénéficiaires 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 et la redevabilité vis-à-vis des bailleurs humanitaires.
Autres graphiques présents selon la configuration
En fonction des données disponibles et de la configuration de l'année scolaire, d'autres graphiques peuvent être présents sur le tableau de bord :
- Répartition géographique par sous-province : carte ou histogramme montrant la densité des bénéficiaires par Sous-PROVED
- Top 10 des écoles : classement des 10 établissements comptant le plus grand nombre de bénéficiaires enregistrées
- Répartition des tuteurs par genre : proportion hommes/femmes parmi les tuteurs légaux enregistrés
- Utilisateurs par type d'acteur : répartition des comptes utilisateurs actifs par rôle ou par organisation partenaire
A.3.3.8 — Utiliser le tableau de bord comme outil de pilotage quotidien
3.8 Utiliser le tableau de bord comme outil de pilotage quotidien
Le tableau de bord est conçu pour être consulté en priorité à chaque connexion. Il concentre les informations les plus importantes sur une seule page, évitant à l'administrateur de naviguer dans de multiples modules pour évaluer l'état du programme. Voici la routine de consultation recommandée :
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. Contrôler l'état des paiements
Vérifiez que l'avancement des tranches correspond au calendrier du programme. Un nombre anormalement faible d'écoles "payées" en regard de la date peut indiquer un blocage dans la chaîne de validation-envoi des instructions Equity.
3. 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 les ONG partenaires.
4. 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.
ℹ️ 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 — le tableau de bord est conçu pour être un point de départ, pas uniquement d'observation.
A.4 — Gestion des organisations
Chapitre A.4 du Manuel PIGBF
A.4.4.1 — Vue d'ensemble
4.1 Vue d'ensemble
Le module Organisations regroupe deux entités structurantes du programme : les ONG partenaires et les Axes de collecte. Ces deux référentiels définissent la gouvernance opérationnelle du terrain : quelle organisation est responsable de la collecte dans quelle zone géographique.
Ils sont accessibles depuis le menu latéral, dans la section « Gestion des utilisateurs et param. » :
- Utilisateurs → Axes — gestion des zones géographiques de collecte
- Utilisateurs → ONG — gestion des organisations partenaires
🔒 Restreint : La création, modification et suppression d'ONG et d'axes sont réservées aux rôles Super Admin et Admin. Les autres rôles disposent d'un accès en lecture seule sur ces référentiels.
ℹ️ Ordre de création recommandé : Créez d'abord les ONG, puis les Axes (qui référencent une ONG), puis les Utilisateurs et Enquêteurs (qui référencent une ONG). Le non-respect de cet ordre entraîne des listes déroulantes vides lors de la création des entités dépendantes.
A.4.4.2 — Les ONG partenaires
4.2 Les ONG partenaires
Rôle des ONG dans la PIGBF
Les ONG sont les organisations non gouvernementales chargées de l'exécution terrain du programme PAAF. Concrètement, chaque ONG partenaire :
- Recrute et encadre les enquêteurs qui collectent les données sur le terrain
- Organise les campagnes de collecte dans les écoles de sa zone géographique
- Assure la première validation des données ODK soumises par ses enquêteurs avant leur intégration en base de production
- Est responsable de la qualité des données collectées dans son périmètre
Chaque enquêteur est nécessairement rattaché à une ONG. Chaque administrateur de type Admin ONG ou Admin IT ONG n'a accès qu'aux données de sa propre organisation — les données des autres ONG lui sont invisibles. Cette étanchéité est un mécanisme de confidentialité et de contrôle fondamental.
Accéder à la liste des ONG
Consulter la fiche d'une ONG
Cliquez sur l'icône Voir (œil) d'une ONG pour afficher sa fiche détaillée : nom, description, liste des axes rattachés, nombre d'enquêteurs associés, et utilisateurs appartenant à cette organisation.
Créer une ONG
- Cliquez sur le bouton + Ajouter une ONG en haut à droite.
- Renseignez les informations requises :
- Nom de l'organisation (obligatoire) — utilisez le nom officiel complet
- Description (optionnelle) — informations complémentaires sur l'organisation, sa zone d'intervention, ses responsables - Cliquez sur Enregistrer.
La nouvelle ONG est immédiatement disponible dans les listes déroulantes lors de la création d'utilisateurs, d'enquêteurs et d'axes.
Modifier une ONG
- Dans le tableau, cliquez sur l'icône Modifier (crayon) en regard de l'ONG concernée.
- Le formulaire s'ouvre avec les informations actuelles pré-remplies.
- Apportez les modifications souhaitées (nom, description).
- Cliquez sur Mettre à jour.
Supprimer une ONG
- Cliquez sur l'icône Supprimer (corbeille) en regard de l'ONG.
- Une fenêtre de confirmation s'affiche, rappelant le nom de l'ONG et avertissant des conséquences.
- Confirmez la suppression.
⚠️ Attention : Une ONG ne peut pas être supprimée si elle est encore associée à des utilisateurs actifs, des enquêteurs ou des données de collecte. Le système bloquera la suppression et affichera un message listant les dépendances existantes. Désassociez ou désactivez ces éléments au préalable avant de procéder à la suppression.
A.4.4.3 — Les axes de collecte
4.3 Les axes de collecte
Rôle des axes
Un axe est un découpage géographique opérationnel qui permet d'organiser et de suivre la performance de la collecte de données sur le terrain. Concrètement, un axe correspond à une zone d'intervention spécifique (un ensemble de villages, un territoire, une zone administrative) assignée à une ONG partenaire responsable.
Ce découpage remplit plusieurs fonctions dans la PIGBF :
- Organisation de la collecte : les enquêteurs sont assignés à des axes pour éviter les chevauchements et garantir la couverture complète du territoire
- Suivi de performance : les données peuvent être filtrées et analysées par axe dans les rapports
- Redevabilité : chaque donnée collectée est traçable jusqu'à l'axe et l'ONG responsables
Accéder à la liste des axes
Créer un axe
- Cliquez sur le bouton + Nouvel Axe.
- Renseignez les informations requises :
- Nom de l'axe (obligatoire) — un nom descriptif identifiant clairement la zone géographique
- ONG responsable (obligatoire) — sélectionnez dans la liste déroulante l'ONG chargée de cet axe. Si la liste est vide, créez d'abord une ONG.
- Description (optionnelle) — précisions sur les limites géographiques, les localités couvertes, etc. - Cliquez sur Enregistrer.
Modifier ou supprimer un axe
La procédure est identique à celle des ONG : icône Modifier (crayon) pour mettre à jour les informations, icône Supprimer (corbeille) avec confirmation pour retirer un axe.
⚠️ Attention : La suppression d'un axe est bloquée si des enquêteurs ou des données de collecte y sont encore rattachés. Réassignez ces éléments à un autre axe avant de procéder.
A.4.4.4 — Relation ONG — Axes — Utilisateurs — Enquêteurs
4.4 Relation ONG — Axes — Utilisateurs — Enquêteurs
La structure organisationnelle de la PIGBF suit une hiérarchie claire que voici représentée :
Programme PAAF
└── ONG partenaire A
│ └── Axe Nord (zone géographique)
│ │ └── Enquêteur IDI071 (collecte ODK)
│ │ └── Enquêteur IDI039 (collecte ODK)
│ └── Axe Sud (zone géographique)
│ └── Enquêteur IDI101 (collecte ODK)
└── ONG partenaire B
└── Axe Est
└── Enquêteur IDI106 (collecte ODK)
Les Admin ONG et Admin IT ONG sont rattachés à une ONG spécifique et ne voient que les données collectées par les enquêteurs de leur propre organisation. Cette étanchéité est automatique et ne peut pas être contournée depuis l'interface.
A.5 — Gestion des écoles
Chapitre A.5 du Manuel PIGBF
A.5.5.1 — Vue d'ensemble
5.1 Vue d'ensemble
Le module Écoles est l'un des pivots centraux de la PIGBF. Une école doit être enregistrée, documentée (numéro SECOPE, arrêté ministériel, compte bancaire Equity) et validée pour paiement avant que ses bénéficiaires puissent recevoir la part de bourse versée à l'établissement via Equity BCDC. Ce module couvre deux sous-ensembles principaux : la liste des écoles avec leur gestion complète, et la liste des préfets (responsables d'établissements).
A.5.5.2 — Liste des écoles
5.2 Liste des écoles
Accéder à la liste
Colonnes du tableau et leur signification
| Colonne | Description |
|---|---|
| Enquêteur | Identifiant de l'enquêteur ayant collecté les données de l'école sur le terrain |
| École | Nom complet de l'établissement |
| Province / PROVED / Sous-PROVED | Hiérarchie administrative éducative sur trois niveaux |
| Num. SECOPE | Numéro de mécanisation de l'école. Affiché en badge vert s'il est disponible, en badge orange « Non disponible » si l'enquêteur ne l'avait pas lors de la collecte |
| Arrêté Min. | Référence et date de l'arrêté ministériel d'agrément de l'école |
| PV Réunion | Lien vers le procès-verbal de la réunion fixant les frais scolaires |
| Tranches | Montants estimés par tranche (calculés sur la base des élèves éligibles) |
| Actions | Icônes Voir / Modifier / Supprimer |
Filtres de recherche disponibles
La liste peut être affinée selon de nombreux critères. Cliquez sur le bouton Filtrer pour ouvrir le panneau de filtres.
| Filtre | Description |
|---|---|
| Recherche texte | Nom d'école, numéro SECOPE, numéro d'arrêté ministériel (recherche partielle acceptée) |
| Province | Filtre géographique de premier niveau |
| PROVED | Province éducationnelle (se remplit en cascade selon la Province choisie) |
| Sous-PROVED | Sous-province éducationnelle (se remplit en cascade selon le PROVED choisi) |
| Territoire / Secteur / Groupement | Niveaux administratifs territoriaux fins |
| Statut de mécanisation | Mécanisée (avec numéro SECOPE) / Non mécanisée |
| Validation pour paiement | Validée / Non validée — filtre les écoles selon leur éligibilité aux paiements Equity |
| Tranche payée | Filtrer les écoles ayant ou n'ayant pas reçu le paiement d'une tranche spécifique |
Les filtres se cumulent librement. Le bouton Réinitialiser les filtres remet la liste dans son état complet sans aucun filtre actif.
A.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.
La fiche est structurée en plusieurs sections :
Informations administratives
Nom complet de l'établissement, numéro SECOPE, référence de l'arrêté ministériel d'agrément (numéro, date de signature, nombre de pages), PV de réunion fixant les frais scolaires (date, liens vers les documents photographiés sur le terrain).
Localisation
Province, PROVED, Sous-PROVED, territoire, secteur, groupement, coordonnées GPS (latitude/longitude) capturées lors de la collecte ODK.
Informations pédagogiques
Classes et options dispensées dans l'établissement, niveaux d'enseignement (primaire, secondaire, humanités générales, techniques, etc.).
Frais scolaires
Montants validés par type de frais et par période, tels que renseignés via le formulaire ODK de frais scolaires et validés par l'administrateur.
Comptes de paiement
Numéro de compte Equity BCDC et coordonnées bancaires complètes destinées à recevoir les virements du programme.
Préfet(s) rattaché(s)
Responsable(s) de l'établissement associés à cette école dans la plateforme.
Bénéficiaires
Liste et nombre total d'élèves filles boursières rattachées à cet établissement pour l'année active.
Historique des modifications
Traçabilité complète de toutes les mises à jour effectuées sur la fiche depuis sa création : qui a modifié quoi, et quand.
A.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, un formulaire de saisie manuelle est disponible pour les cas particuliers (école hors-couverture ODK, correction d'urgence, ajout d'une école découverte après la collecte).
- Cliquez sur le bouton + Ajouter une école.
- Renseignez les informations obligatoires :
- Nom de l'école
- Province, PROVED, Sous-PROVED - Complétez autant que possible les informations complémentaires : N° SECOPE, arrêté ministériel, coordonnées GPS, frais scolaires, compte Equity BCDC, préfet.
- Cliquez sur Enregistrer.
A.5.5.5 — Modifier une école
5.5 Modifier une école
- Dans la liste, cliquez sur l'icône Modifier (crayon) de l'école concernée.
- Le formulaire de modification s'ouvre avec toutes les informations actuelles pré-remplies.
- Apportez les corrections souhaitées dans les champs concernés.
- Cliquez sur Mettre à jour.
ℹ️ 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.
A.5.5.6 — Supprimer une école
5.6 Supprimer une école
- Cliquez sur l'icône Supprimer (corbeille) de l'école concernée.
- Une fenêtre de confirmation s'affiche, mentionnant le nom de l'école et avertissant des conséquences.
- Confirmez la suppression.
⚠️ 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. Traitez ces dépendances (désassociation des élèves, archivage) avant toute suppression.
A.5.5.7 — Liste des préfets
5.7 Liste des préfets
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 accountable vis-à-vis du programme.
Accéder à la liste des préfets
Filtres disponibles
| Filtre | Description |
|---|---|
| PROVED | Filtrer par province éducationnelle |
| Sous-PROVED | Filtrer par sous-province (cascade) |
| École | Filtrer les préfets d'un établissement spécifique |
| Genre | Filtrer par genre (Homme / Femme) |
Ajouter un préfet manuellement
Les préfets peuvent être créés via la collecte ODK (lors du formulaire de données écoles) ou directement depuis cette interface.
- Cliquez sur + Ajouter un préfet.
- Renseignez : Nom, Post-nom, Prénom (obligatoires), Genre, École de rattachement (sélecteur).
- Ajoutez si disponibles : coordonnées de contact (téléphone, email).
- Cliquez sur Enregistrer.
A.5.5.8 — Traitement des doublons d'écoles
5.8 Traitement des doublons d'écoles
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 »), créant des doublons dans la base de données. La fonctionnalité de traitement des doublons détecte et permet de résoudre ces conflits.
Accéder au traitement des doublons
Résoudre un doublon
Pour chaque paire signalée par l'algorithme de détection, examinez les informations des deux fiches et prenez l'une des trois 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) 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 établissements portant le même nom dans des localités différentes, par exemple). Les deux fiches sont conservées et la paire est ignorée des résultats de doublon.
Supprimer : La fiche identifiée comme doublon confirmé est supprimée (applicable uniquement si elle ne possède pas de données dépendantes).
⚠️ Attention : La fusion est irréversible. Vérifiez soigneusement et systématiquement les numéros SECOPE, les localisations géographiques et les noms de préfets des deux fiches avant de confirmer une fusion. Une fusion incorrecte est beaucoup plus difficile à corriger qu'un doublon laissé en attente.
A.5.5.9 — Validation des écoles pour paiement
5.9 Validation des écoles pour paiement
Avant qu'une école puisse recevoir un virement Equity BCDC, elle doit être explicitement validée pour paiement par un administrateur habilité. Cette validation constitue le dernier verrou de sécurité avant tout décaissement financier vers l'établissement.
Accéder à la validation pour paiement
Critères à vérifier avant validation
Avant d'activer le statut "Validée pour paiement" d'une école, vérifiez que les éléments suivants sont correctement renseignés sur sa fiche :
| Critère | Vérification à effectuer |
|---|---|
| Numéro SECOPE ou Arrêté ministériel | Au moins l'un des deux documents est renseigné et lisible |
| Compte bancaire Equity BCDC | Numéro de compte présent, vérifié et actif |
| Préfet identifié | Au moins un préfet rattaché à l'école |
| Absence de doublon actif | Aucune autre fiche active ne correspond au même établissement |
| Localisation renseignée | PROVED et Sous-PROVED correctement assignés |
Valider ou invalider une école
Dans la liste de validation, chaque école dispose d'un interrupteur (toggle switch) permettant de basculer son statut entre « Validée » et « Non validée ».
- Activer l'interrupteur → statut passe à « Validée » → l'école peut recevoir des virements Equity
- Désactiver l'interrupteur → statut passe à « Non validée » → tous les flux financiers liés à cette école sont immédiatement bloqués
La désactivation est utile en cas de découverte d'une anomalie sur un établissement déjà validé (compte bancaire incorrect, doublon découvert tardivement, école fermée) : un simple clic bloque instantanément tout nouveau paiement vers cet établissement.
🔒 Restreint : Cette action est réservée aux rôles Super Admin, Admin et Admin PAAF.
A.6 — Gestion des élèves
Chapitre A.6 du Manuel PIGBF
A.6.6.1 — Vue d'ensemble
6.1 Vue d'ensemble
Le module Bénéficiaires → Élèves est le cœur de la PIGBF. Il centralise l'intégralité des informations relatives aux élèves filles identifiées comme bénéficiaires du programme de bourses. 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 payée.
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
3. Suivi du parcours scolaire (classe, section, option)
4. Collecte et saisie des notes et présences
5. Validation de l'éligibilité au paiement
6. Inclusion dans les instructions de paiement (Equity ou M-Pesa selon le bénéficiaire percepteur désigné)
7. Suivi des paiements reçus
A.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. 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é.
Filtres de recherche avancés
La zone de filtres, accessible en cliquant sur le bouton Filtres ou déjà visible en haut de la page, propose un moteur de recherche multicritère particulièrement riche :
| Catégorie | Critères disponibles |
|---|---|
| Recherche texte | Nom, post-nom, prénom, UID, ancien code, numéro SERNIE, numéro de téléphone, WhatsApp, email |
| Caractéristiques personnelles | Pays d'origine, statut migratoire (Résidente / Déplacée / Réfugiée / Rapatriée), situation parentale, situation de handicap, âge (fourchette) |
| Localisation scolaire | PROVED, Sous-PROVED, école spécifique, classe, section, option |
| Statut du dossier | Avec ou sans numéro SERNIE, statut de validation de la fiche |
| Parcours | Avec ou sans abandon scolaire en cours d'année |
| Paiements | Première tranche payée / non payée, deuxième tranche payée / non payée, avec ou sans bourse |
Le bouton Réinitialiser les filtres efface tous les critères et revient à la liste complète.
Actions disponibles sur la liste
Pour chaque bénéficiaire figurant dans le tableau, selon les droits de l'administrateur connecté :
- Voir (icône œil) — accéder à la fiche détaillée complète de la bénéficiaire
- Modifier (icône crayon) — ouvrir le formulaire de mise à jour
- Supprimer (icône corbeille) — supprimer la fiche (conditionnel, voir conditions ci-dessous)
La suppression d'une bénéficiaire est bloquée par le système si des instructions de paiement sont en cours ou ont déjà été exécutées pour cette élève. Une fiche ayant déjà été payée ne peut pas être supprimée ; elle peut uniquement être archivée ou marquée comme abandonnée.
A.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.
La fiche est organisée en plusieurs sections détaillées :
Identité et photo
Nom, post-nom, prénom, photo de la bénéficiaire, UID avec QR Code. L'UID est l'identifiant permanent et unique de l'élève dans le système, qui ne change jamais même si ses informations sont mises à jour.
Informations personnelles
Date et lieu de naissance, statut migratoire (Résidente / Déplacée / Réfugiée / Rapatriée), situation de handicap (Oui/Non), numéro SERNIE (identifiant national scolaire), situation familiale des parents ou tuteurs, composition du foyer.
Parcours scolaire
École de rattachement (lien cliquable vers la fiche de l'école), classe, section (Humanités Générales, Techniques, etc.), option (Pédagogie, Commerce, Biologie, etc.), année scolaire. Ce bloc identifie précisément la position scolaire de l'élève.
Localisation éducationnelle et territoriale
Province, PROVED, Sous-PROVED, territoire, secteur, village, groupement. Ces informations proviennent du formulaire ODK et permettent de localiser géographiquement la bénéficiaire.
Notes et régularité
Saisie et affichage des moyennes par période (Période 1, Période 2, Examen du semestre) pour les deux semestres de l'année, ainsi que du taux de fréquentation (régularité) par semestre. Ces données, collectées via les formulaires ODK de suivi, déterminent l'éligibilité de l'élève au paiement de chaque tranche.
Informations de contact
Numéro de téléphone direct de l'élève (si disponible), numéro WhatsApp, adresse email. Ces coordonnées permettent de contacter directement la bénéficiaire ou de vérifier ses coordonnées.
Validation pour paiement
Désignation du bénéficiaire percepteur (l'élève elle-même reçoit le paiement M-Pesa, ou son tuteur légal), tableau des tranches de paiement de l'année avec leur statut individuel (Validée / Non validée pour paiement).
Documents
Téléversement et consultation des pièces justificatives associées à l'élève : carte d'identité, bulletin scolaire, autres documents requis par le programme.
Comptes de paiement
Coordonnées du compte M-Pesa ou bancaire désigné pour recevoir les paiements de bourse de cette élève (directement ou via son tuteur), avec l'indicateur du compte principal sélectionné.
A.6.6.4 — Ajouter une élève manuellement
6.4 Ajouter une élève manuellement
Les bénéficiaires sont principalement créées par le biais de la validation des formulaires ODK. Le formulaire de saisie manuelle est réservé aux situations exceptionnelles (élève non collectée sur le terrain, correction d'urgence, rattrapages après clôture de collecte).
- Cliquez sur + Ajouter une élève.
- Renseignez les informations obligatoires : Nom, Post-nom, Prénom, Date de naissance, École (sélecteur), Classe, Section, Option.
- Complétez les informations complémentaires selon les données disponibles : statut migratoire, situation parentale, localisation, coordonnées de contact, tuteur responsable.
- Cliquez sur Enregistrer. Un UID et un QR Code sont générés automatiquement par la plateforme.
A.6.6.5 — Traitement des doublons d'élèves
6.5 Traitement des doublons d'élèves
Une même élève peut être enregistrée plusieurs fois lors de campagnes de collecte successives ou de réconciliations de données. Cela peut se produire si deux enquêteurs ont collecté la même élève dans deux sessions différentes, ou si une mise à jour ODK a créé une nouvelle entrée au lieu de mettre à jour l'existante.
Accéder au traitement des doublons
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. Plus le score est élevé, plus il est probable qu'il s'agisse d'un doublon.
Résoudre un doublon
Fusionner : Les deux fiches sont regroupées en une seule. L'administrateur désigne la fiche de référence (celle conservée). Toutes les données de la fiche secondaire (notes, paiements, documents, historique) sont rapatriées sur la fiche principale. La fiche secondaire est supprimée et son UID devient inactif.
Confirmer deux élèves distinctes : Les deux fiches correspondent à des personnes différentes malgré la ressemblance. Le couple est retiré des résultats de doublon et les deux fiches sont conservées telles quelles.
Supprimer : La fiche identifiée comme doublon confirmé est supprimée (applicable uniquement si aucun paiement n'y est attaché).
⚠️ Attention — Fusion irréversible : Avant toute fusion, vérifiez systématiquement les UIDs, les dates de naissance, les écoles de rattachement ET les photos si disponibles. 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 très difficile à défaire et compromet l'intégrité du registre des bénéficiaires.
A.6.6.6 — Validation des élèves pour paiement
6.6 Validation des élèves pour paiement
Avant qu'une bénéficiaire puisse être incluse dans une instruction de paiement (Equity ou M-Pesa), elle doit être explicitement validée pour paiement par un administrateur. Cette validation confirme que l'élève remplit l'ensemble des critères d'éligibilité définis par le programme pour la tranche de paiement concernée.
Accéder à la validation pour paiement
Critères d'éligibilité vérifiés
| Critère | Description et seuil |
|---|---|
| Âge | L'élève se situe dans la tranche d'âge définie par le programme pour l'année active |
| Taux de fréquentation | Le taux de présence (régularité) au semestre concerné atteint le seuil minimal requis |
| Taux de réussite scolaire | La moyenne obtenue dans la période concernée dépasse le seuil de réussite défini |
| Unicité du dossier | Aucune autre fiche active dans la base ne correspond à la même élève (absence de doublon actif) |
| Compte de paiement renseigné | Un compte M-Pesa ou Equity est configuré et associé au bénéficiaire percepteur désigné |
Valider ou invalider une élève
Validation individuelle : Cliquez sur le bouton Valider (coche verte) sur la ligne de l'élève. Une fenêtre de confirmation s'affiche avec le récapitulatif de l'élève. Confirmez.
Validation en masse : Cochez les cases de toutes les élèves à valider → cliquez sur Valider les X élèves sélectionnées → confirmez.
Invalidation : Cliquez sur le bouton Invalider (croix rouge) sur la ligne d'une élève précédemment validée. Une élève invalidée disparaît immédiatement des listes utilisées par le module de génération des paiements.
🔒 Restreint : Cette action est réservée aux rôles Super Admin, Admin, Admin PAAF et Admin ONG (dans son périmètre).
A.7 — Gestion des tuteurs
Chapitre A.7 du Manuel PIGBF
A.7.7.1 — Rôle du tuteur dans la PIGBF
7.1 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. Il occupe une position centrale dans le circuit financier : dans le schéma de paiement par défaut, c'est lui qui reçoit la bourse sur son compte M-Pesa au nom des élèves dont il a la charge.
Son identification rigoureuse est donc indispensable pour plusieurs raisons :
- Sécurité financière : garantir que les fonds arrivent à la bonne personne et prévenir tout détournement
- Conformité réglementaire : en tant que représentant légal de mineures, son consentement formel est requis et documenté
- Vérification M-Pesa : le nom enregistré sur la plateforme doit correspondre exactement au titulaire du compte mobile money pour que le virement soit accepté par Vodacom
Un tuteur peut avoir sous sa responsabilité plusieurs élèves bénéficiaires, y compris dans plusieurs écoles différentes. La plateforme gère et visualise explicitement cette relation un-à-plusieurs dans la fiche du tuteur.
Les données des tuteurs sont collectées principalement via le formulaire ODK 03_00_Identification des Tuteurs, rempli par les enquêteurs lors de visites à domicile ou à l'école. Une interface de saisie et de correction manuelle est disponible sur la plateforme pour les mises à jour nécessaires en cours d'année.
A.7.7.2 — Liste des tuteurs et recherche
7.2 Liste des tuteurs et recherche
Accéder à la liste
Cliquez sur Bénéficiaires → Tuteurs dans le menu latéral.
Filtres de recherche disponibles
| Filtre | Description |
|---|---|
| Recherche texte | Nom, post-nom, prénom, adresse email, numéro de téléphone (y compris recherche partielle) |
| Niveau d'étude | Filtre par niveau d'instruction déclaré du tuteur |
| Consentement | Filtrer les tuteurs selon qu'ils ont (Avec) ou non (Sans) signé la fiche de consentement au programme |
A.7.7.3 — Fiche détaillée d'un tuteur
7.3 Fiche détaillée d'un tuteur
La fiche d'un tuteur centralise toutes les informations collectées et renseignées. Elle est accessible via l'icône Voir (œil) dans la liste.
La fiche est structurée en plusieurs sections :
Identité civile
Nom, post-nom, prénom, genre, date et lieu de naissance. Ces informations doivent correspondre exactement à celles figurant sur la pièce d'identité officielle du tuteur, car elles servent à la vérification d'identité lors des paiements M-Pesa.
Photo et pièce d'identité
Photo du tuteur (prise sur le terrain par l'enquêteur) et scan/photo de sa carte nationale d'identité ou pièce équivalente. Ces documents sont indispensables pour valider l'identité du tuteur avant tout décaissement.
Coordonnées de contact
Numéro de téléphone principal, numéro WhatsApp (souvent identique mais parfois différent), adresse email. Le numéro de téléphone est particulièrement critique car il est utilisé comme identifiant du compte M-Pesa.
Localisation
Province, PROVED, Sous-PROVED, territoire, secteur, groupement, village de résidence.
Informations socio-économiques
Niveau d'étude, profession, situation parentale, nombre total d'enfants dans le foyer (pas seulement les bénéficiaires du programme).
Consentement
Statut et date de signature de la fiche de consentement au programme. Ce consentement formel est un prérequis légal et programmatique : sans consentement signé, le tuteur ne peut pas être désigné comme percepteur des bourses.
Enfants bénéficiaires rattachés
Liste interactive de toutes les élèves placées sous la responsabilité de ce tuteur dans la PIGBF. Chaque ligne affiche l'identité de l'élève, son école, sa classe, et l'état de ses paiements par tranche. Un clic sur une ligne ouvre directement la fiche de l'élève concernée. Cette vue relationnelle permet à l'administrateur de vérifier l'intégralité du dossier familial en un seul endroit.
Comptes de paiement
Numéro de compte M-Pesa enregistré, agent M-Pesa de référence, nom de transaction attendu et indicateur du compte actif pour les paiements. C'est ce compte qui sera crédité lors des virements M-Pesa déclenchés par la plateforme.
A.7.7.4 — Ajouter un tuteur manuellement
7.4 Ajouter un tuteur manuellement
Les tuteurs sont principalement créés par validation des formulaires ODK. La création manuelle est réservée aux cas particuliers : tuteur absent lors de la collecte terrain, changement de tuteur légal en cours d'année, correction urgente.
- Cliquez sur + Ajouter un tuteur.
- Renseignez les informations obligatoires : Nom, Post-nom, Prénom, Genre, Téléphone.
- Complétez les informations complémentaires : niveau d'étude, profession, situation parentale, localisation géographique, coordonnées supplémentaires.
- 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 Compte choisi pour paiement.
- Rattachez le tuteur aux élèves bénéficiaires concernées via la section dédiée (ou depuis la fiche de chaque élève).
- Cliquez sur Enregistrer.
A.7.7.5 — Modifier un tuteur
7.5 Modifier un tuteur
- Dans la liste, cliquez sur l'icône Modifier (crayon) du tuteur.
- Le formulaire s'ouvre avec les informations actuelles pré-remplies.
- Apportez les modifications nécessaires.
- Cliquez sur Mettre à jour.
⚠️ Attention : Tout changement de numéro de compte M-Pesa est automatiquement tracé dans le journal d'activités avec l'identité de l'auteur et l'horodatage. Cette traçabilité est un mécanisme anti-fraude explicite : elle permet de détecter et d'investiguer toute substitution de compte non autorisée effectuée juste avant une période de paiement. Si vous modifiez le compte M-Pesa d'un tuteur, documentez la raison de ce changement dans les notes internes.
A.7.7.6 — Supprimer un tuteur
7.6 Supprimer un tuteur
- Cliquez sur l'icône Supprimer (corbeille) du tuteur.
- Une fenêtre de confirmation s'affiche, listant les élèves rattachées à ce tuteur.
- Confirmez la suppression.
⚠️ Attention : La suppression est bloquée si le tuteur est le responsable percepteur désigné pour des élèves liées à des paiements en cours ou déjà réalisés. Procédez d'abord au changement de tuteur sur les fiches des élèves concernées, puis tentez à nouveau la suppression.
A.8 — Validation des données ODK
Chapitre A.8 du Manuel PIGBF
A.8.8.1 — Comprendre le circuit de validation ODK
8.1 Comprendre le circuit de validation ODK
La validation des données ODK est l'une des responsabilités les plus importantes et les plus critiques de l'Administrateur Plateforme. Elle constitue le verrou de qualité systématique entre les données brutes collectées sur le terrain et la base de production de la PIGBF.
Principe fondamental : Aucune donnée collectée sur le terrain ne peut entrer directement en production. Elle transite systématiquement par une zone de staging (base de données intermédiaire) où un administrateur humain doit l'examiner, la contrôler et l'approuver avant son intégration définitive. Ce mécanisme garantit :
- L'intégrité de la base de données (pas de pollution par des données de test ou de mauvaise qualité)
- La traçabilité (chaque donnée intégrée est liée à un administrateur validateur et à un horodatage)
- La qualité (une erreur de saisie de terrain détectée avant intégration est beaucoup plus simple à corriger)
- La sécurité (prévention de l'injection frauduleuse de données)
Flux complet de la collecte à la production
TERRAIN
Enquêteur (tablette ODK Collect)
→ Saisit le formulaire (en ligne ou hors ligne)
→ Synchronise vers ODK Central dès connexion disponible
↓
SYNCHRONISATION AUTOMATIQUE
api-pigbf (scheduler toutes les X minutes)
→ Récupère les nouvelles soumissions depuis ODK Central
→ Les stocke dans la base de staging (mysql_api)
↓
STAGING / ZONE D'ATTENTE
Administrateur Plateforme (interface Données Collectées)
→ Consulte les fiches en attente
→ Vérifie la cohérence, la qualité, la légitimité
→ Décide : Transférer (valider) ou laisser en attente
↓
PRODUCTION
Base de données principale (mysql)
→ École créée ou mise à jour dans le module Écoles
→ Élève créée ou mise à jour dans le module Bénéficiaires
→ Tuteur créé ou mis à jour dans le module Tuteurs
→ Données exploitables pour les paiements et les rapports
Les données en attente sont regroupées dans trois sous-modules accessibles depuis le menu latéral : Données Collectées → Données écoles, Données élèves, Données tuteurs.
A.8.8.2 — Validation des données écoles
8.2 Validation des données écoles
Les formulaires ODK relatifs aux écoles regroupent plusieurs types de collecte : identification initiale d'un établissement, mise à jour du numéro SECOPE, mise à jour de l'arrêté ministériel, renseignement des frais scolaires, renseignement des classes et options disponibles.
Accéder à la page
Deux onglets de navigation
Onglet "Non validé" (vue par défaut) : affiche uniquement les formulaires ODK non encore traités, en attente de validation par un administrateur. 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 spécifique, vérifier qu'une école donnée a bien été traitée, ou consulter les données avant transfert.
Filtrer les données en attente
Avant de valider, il est recommandé de filtrer les données par zone géographique ou par enquêteur pour traiter les soumissions de manière organisée et cohérente.
- Cliquez sur le bouton ▼ Filtrer en haut à droite du tableau.
- 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 - Les résultats du tableau se mettent à jour instantanément.
- Cliquez sur Réinitialiser les filtres pour revenir à la liste complète.
Consulter le détail d'une soumission avant validation
Avant de valider, il est fortement recommandé de consulter le détail complet de la soumission via l'icône de détail (bouton paramètres) pour les premières validations ou en cas de doute.
Le détail affiche l'intégralité des données saisies par l'enquêteur, y compris les photos prises sur le terrain (arrêté ministériel, PV de réunion). Cela permet à l'administrateur de vérifier la lisibilité des documents photographiés et la cohérence des informations déclarées.
Valider une école individuellement
- Sur la ligne de l'école à valider, cliquez sur le bouton Valider (icône coche verte dans la colonne Actions).
- Une fenêtre de confirmation s'affiche rappelant le nom de l'école et les informations principales.
- Confirmez la validation. La soumission est transférée : l'école est créée (si nouvelle) ou mise à jour (si existante) dans le module Écoles de la base de production.
Valider plusieurs écoles en bloc (validation groupée)
- Cochez les cases à gauche de chaque ligne à valider. La case en en-tête du tableau coche/décoche toutes les lignes visibles de la page en une seule action.
- Un bandeau récapitulatif apparaît au-dessus ou en bas du tableau : « X école(s) sélectionnée(s) ».
- Cliquez sur le bouton Valider les X école(s) sélectionnée(s) qui apparaît.
- Une fenêtre de confirmation récapitule le nombre d'écoles et les montants estimés.
- Confirmez. Les transferts sont effectués en masse vers la base de production.
Validation par liste d'UIDs (import)
Lorsqu'un responsable de terrain ou un superviseur ONG fournit une liste précise des identifiants formulaires à valider, utilisez cette fonction pour un traitement ciblé et documenté.
- Cliquez sur le bouton Validation par UIDs en haut du tableau.
- 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 - Le système identifie automatiquement les formulaires correspondant aux UIDs fournis et les sélectionne.
- Cliquez sur Valider la sélection.
Exporter les données en Excel
Cliquez sur Exporter en Excel pour générer un fichier Excel des données actuellement filtrées dans le tableau. Le fichier sera envoyé à l'adresse email de l'utilisateur connecté dès qu'il sera prêt (quelques secondes à quelques minutes selon le volume).
A.8.8.3 — Validation des données élèves
8.3 Validation des données élèves
Accéder à la page
Structure du tableau et informations affichées
Chaque ligne correspond à une soumission ODK d'identification ou de mise à jour d'une bénéficiaire. Les colonnes affichent :
- Enquêteur : code de l'enquêteur ayant soumis le formulaire
- Nom de l'élève : identité collectée sur le terrain
- École / Classe / Option : parcours scolaire déclaré
- Notes S1 : moyennes par période et taux de présence du premier semestre (si collectés)
- Notes S2 : idem pour le second semestre (si collectés)
- ID formulaire ODK : identifiant unique de la soumission dans ODK Central
Filtres disponibles
| Filtre | Description |
|---|---|
| PROVED | Province éducationnelle |
| Sous-PROVED | Cascade selon PROVED |
| École | Filtrer par établissement spécifique |
| Classe | Filtrer par niveau scolaire |
| Option | Filtrer par option de classe |
| Enquêteur | Filtrer par agent terrain |
Consulter le détail d'une fiche élève avant validation
Avant de valider une fiche, consultez le détail pour vérifier :
- La photo de l'élève est bien visible et correspond à une personne réelle
- L'identité (nom, prénom, date de naissance) est cohérente et sans fautes manifestes
- L'école et la classe sont correctement renseignées et cohérentes avec la zone de collecte
- Les notes et présences sont dans des plages réalistes (moyennes entre 0 et 100%)
- Si l'élève existe déjà dans la base, vérifiez qu'il s'agit bien d'une mise à jour légitime et non d'un doublon accidentel
Valider des élèves
Validation individuelle : Bouton Valider (coche verte) sur la ligne → confirmation → l'élève est créée ou mise à jour en base de production.
Validation en masse : Cocher plusieurs lignes → bouton Valider les X élèves sélectionnées → confirmer.
Import par UIDs : Même fonctionnement que pour les écoles.
⚠️ 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 propose une mise à jour de la fiche existante plutôt qu'une création. En cas de doute, vérifiez le détail de la soumission et consultez la fiche existante avant de confirmer.
A.8.8.4 — Validation des données tuteurs
8.4 Validation des données tuteurs
Accéder à la page
Structure du tableau
| Colonne | Description |
|---|---|
| Enquêteur | Code de l'enquêteur ayant collecté le tuteur |
| Nom du tuteur | Nom, post-nom et prénom du tuteur identifié |
| Téléphone | Numéro de téléphone principal (souvent = numéro M-Pesa) |
| École | École de référence (lieu de la collecte) |
| Nb enfants bénéficiaires | Nombre d'élèves déclarées sous la responsabilité de ce tuteur dans cette école |
| Handicap | Présence ou non d'une situation de handicap déclarée |
| Compte M-Pesa | Numéro de téléphone M-Pesa renseigné lors de la collecte |
Vérification critique avant validation d'une fiche tuteur
La validation d'un tuteur est une étape de vérification rigoureuse, car il est le réceptionnaire des fonds. Consultez systématiquement le détail complet avant de valider.
Éléments à contrôler impérativement :
1. Photo du tuteur : visible, nette, correspond à une personne adulte réelle
2. Photo de la pièce d'identité : lisible, non tronquée, appartient clairement au tuteur
3. Numéro de téléphone M-Pesa : renseigné et cohérent (10 chiffres, format local)
4. Élèves rattachées : le nombre d'élèves déclarées est cohérent avec les données de collecte de l'école
5. Consentement : la fiche de consentement a été lue et acceptée par le tuteur (étape documentée dans le formulaire ODK)
Valider des tuteurs
Les procédures de validation individuelle, en masse et par import d'UIDs sont identiques à celles des écoles et des élèves.
A.8.8.5 — Bonnes pratiques de validation ODK
8.5 Bonnes pratiques de validation ODK
La qualité des données de production de la PIGBF dépend entièrement du soin apporté lors de la phase de validation. Voici les recommandations à appliquer systématiquement :
Valider régulièrement, ne pas laisser s'accumuler. Idéalement, les validations devraient être traitées quotidiennement pendant les périodes de collecte active. Un arriéré de validations non traitées retarde tous les processus en aval (paiements, rapports) et crée un risque de perte de contexte (difficultés à vérifier des données collectées plusieurs semaines auparavant).
Vérifier avant de valider en masse. Pour les premières sessions de collecte avec un nouvel enquêteur ou une nouvelle zone, validez quelques fiches individuellement avec consultation du détail. Une fois la qualité des données confirmée, la validation en masse est acceptable. En cas de doute récurrent sur un enquêteur, signalez-le à l'ONG responsable.
Ne jamais valider une fiche manifestement incorrecte. Une fiche avec un nom vide, une photo illisible, un numéro SECOPE manifestement erroné, ou une localisation incohérente (école de Tshikapa rattachée à une Sous-PROVED de Kamonia) doit être laissée en staging et faire l'objet d'une correction par l'enquêteur. Prévenez l'ONG responsable du problème.
Utiliser la validation par UIDs pour les lots formels. Lorsqu'une ONG fournit une liste officielle de formulaires à valider (après vérification terrain), utilisez la fonction d'import d'UIDs plutôt que la sélection manuelle pour garantir exactement les formulaires souhaités et créer une trace documentée.
Documenter les anomalies détectées. Si vous détectez des données suspectes ou des erreurs récurrentes lors de la validation, notez-les et transmettez-les à l'ONG responsable pour correction à la source (formation de l'enquêteur, corrections terrain). La prévention à la source est plus efficace que la correction en base.
A.9 — Gestion des paiements
Chapitre A.9 du Manuel PIGBF
A.9.9.1 — Vue d'ensemble du module paiements
9.1 Vue d'ensemble du module paiements
Le module Paiements est le plus critique de la PIGBF du point de vue financier. Il orchestre l'intégralité du cycle de décaissement des bourses, depuis la préparation des instructions jusqu'à la confirmation de réception par les bénéficiaires et le reporting associé.
La PIGBF gère deux circuits de paiement distincts correspondant aux deux types de bénéficiaires financiers :
| Circuit | Prestataire | Destinataire | Mécanisme technique | Objet du paiement |
|---|---|---|---|---|
| Equity BCDC | Equity Bank Congo | Comptes bancaires des écoles | Fichiers H2H via SFTP chiffré PGP | Frais scolaires (part école de la bourse) |
| Vodacom M-Pesa | Vodacom | Comptes mobile money des tuteurs ou élèves | API B2C (Business-to-Consumer) | Subvention directe (part tuteur/élève de la bourse) |
Les deux circuits suivent le même cycle en quatre étapes obligatoires et séquentielles :
┌─────────────────────────────────────────────────────────────────┐
│ ÉTAPE 1 — GÉNÉRATION │
│ Sélection des bénéficiaires éligibles pour la tranche, │
│ calcul automatique des montants, création des lots en attente │
└──────────────────────────┬──────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ ÉTAPE 2 — VALIDATION │
│ Contrôle humain des lots par le Validateur de paiement PAAF, │
│ vérification des montants et des comptes, approbation ou rejet │
└──────────────────────────┬──────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ ÉTAPE 3 — ENVOI │
│ Transmission sécurisée au prestataire : │
│ OTP par email obligatoire pour Equity / API directe pour M-Pesa│
└──────────────────────────┬──────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ ÉTAPE 4 — SUIVI │
│ Réception et traitement des retours prestataires : │
│ ACK/NACK/PSR pour Equity, confirmations API pour M-Pesa │
└─────────────────────────────────────────────────────────────────┘
🔒 Restreint — Séparation des rôles : L'architecture de sécurité financière de la PIGBF repose sur le principe fondamental que la même personne ne peut pas gérer à elle seule l'intégralité du cycle. Par défaut, l'Admin PAAF génère les instructions, et le Validateur de paiement PAAF (rôle autonome distinct) les valide et les envoie. Cette séparation des rôles est un contrôle interne indispensable.
A.9.9.2 — Gestion des prestataires
9.2 Gestion des prestataires
Les prestataires financiers (Equity BCDC et Vodacom M-Pesa) doivent être configurés dans la plateforme avec leurs paramètres techniques d'API avant de pouvoir effectuer des paiements.
Accéder à la liste des prestataires
Informations d'un prestataire
Cliquez sur Voir pour consulter la configuration technique d'un prestataire.
Configurer ou modifier un prestataire
- Cliquez sur Modifier (crayon) du prestataire concerné.
- Le formulaire de configuration s'ouvre avec trois éditeurs JSON :
Credentials (JSON) : contiennent les informations d'authentification auprès du prestataire : token d'accès, clés API, identifiants de connexion. Ces données sont hautement confidentielles.
API Config (JSON) : définit les paramètres des appels API de paiement : URL de l'endpoint, méthode HTTP (POST/GET), headers requis, structure du corps de la requête. Des placeholders dynamiques permettent d'injecter les valeurs à l'exécution (ex. : {{token}}, {{montant}}, {{reference_prestataire}}).
Tracking Config (JSON) : configure le suivi du statut des paiements après envoi : URL de l'endpoint de vérification, méthode, headers, structure de la réponse.
⚠️ Attention critique : La configuration des prestataires est une opération hautement technique et sensible réservée exclusivement à l'équipe IT GROUP ou au Super Admin technique. Une configuration incorrecte peut entraîner l'échec total ou partiel de tous les paiements, voire des virements vers des comptes incorrects. Ne modifiez jamais ces paramètres sans avoir obtenu les nouvelles valeurs techniques directement auprès du prestataire et sans avoir consulté l'équipe IT GROUP.
A.9.9.3 — Paiements Equity BCDC — Cycle complet
9.3 Paiements Equity BCDC — Cycle complet
9.3.1 Étape 1 — Génération des instructions Equity
La génération consiste à préparer les lots de virements qui seront soumis à Equity Bank pour créditer les comptes bancaires des écoles sélectionnées.
Accéder à l'écran de génération
Sélectionner la tranche de paiement
La sélection d'une tranche de paiement est obligatoire. Sans cette sélection, aucune école n'est affichée dans le tableau. Cette contrainte est intentionnelle pour éviter de générer des instructions sans contexte défini.
- Dans la liste déroulante Tranche de paiement, sélectionnez la tranche à traiter (ex. : « Première Tranche 2024-2025 »). Les tranches disponibles sont celles configurées dans les Paramètres de l'année scolaire active.
- Le tableau des écoles éligibles s'affiche automatiquement.
Qui apparaît dans cette liste ? Uniquement les écoles réunissant simultanément les conditions suivantes :
- Validée pour paiement (interrupteur activé dans le module Validation des écoles)
- Possédant un compte Equity BCDC configuré et actif dans leur fiche
- Ayant des élèves validées pour paiement pour la tranche sélectionnée
- N'ayant pas encore reçu le paiement de cette tranche (pour éviter les doublons)
Examiner les données avant génération
Avant toute sélection, prenez le temps d'examiner la liste :
- Vérifiez que le nombre d'élèves éligibles par école est cohérent avec vos données de terrain
- Vérifiez que le montant total par école est correct (= nombre d'élèves × montant par élève de la tranche)
- Identifiez les écoles absentes de la liste qui devraient y figurer (vérifiez leur validation pour paiement et leurs comptes)
Si vous souhaitez affiner la liste, utilisez les filtres PROVED, Sous-PROVED ou la sélection multi-écoles.
Sélectionner les écoles et générer
- Cochez les écoles à inclure dans le lot. Utilisez la case en en-tête pour sélectionner toutes les écoles de la page.
- Un bandeau récapitulatif apparaît en haut du tableau :
- Cliquez sur Générer les instructions.
- La fenêtre modale « Générer les instructions Equity » s'ouvre :
- Vérifiez les métriques récapitulatives (écoles, élèves, montant).
- Saisissez un Commentaire descriptif (optionnel mais recommandé) : « Première tranche — Sous-PROVED Kamuesha — novembre 2024 ». Ce commentaire sera visible dans tous les écrans suivants du cycle de paiement et dans l'historique.
- Cliquez sur Lancer la génération.
Les lots sont créés dans la base de données paiements avec le statut « Généré — en attente de validation ». Un lot distinct est créé pour chaque école sélectionnée.
9.3.2 Étape 2 — Validation des instructions Equity
Les lots générés passent dans la file de validation. Le Validateur de paiement PAAF doit examiner chaque lot, vérifier son exactitude et l'approuver ou le rejeter avant l'envoi à la banque.
Accéder à l'écran de validation
Valider un lot individuellement
- Repérez le lot dans le tableau. Vérifiez la référence, l'école, le nombre de paiements et le montant.
- Pour un contrôle approfondi, cliquez sur la Référence du lot pour ouvrir le détail complet (liste des paiements individuels, commentaire saisi à la génération).
- Cliquez sur Valider (coche verte).
- Vérifiez une dernière fois l'exactitude de toutes les informations.
- Cliquez sur Valider. Le lot passe au statut « Validé » et devient visible dans l'écran d'envoi.
Rejeter un lot
Si une anomalie est détectée — montant incorrect, compte bancaire erroné, école en doublon, cohérence douteuse — il faut rejeter le lot plutôt que de le laisser en attente.
- Cliquez sur Rejeter (croix rouge) sur la ligne du lot concerné.
- Renseignez la Raison du rejet (obligatoire) : soyez précis et descriptif pour faciliter la correction.
- Cliquez sur Rejeter. Le lot est marqué comme rejeté, les paiements associés restent en attente.
ℹ️ Après un rejet : L'administrateur doit corriger l'anomalie identifiée (généralement sur la fiche de l'école concernée), puis régénérer un nouveau lot via l'écran de Génération.
9.3.3 Étape 3 — Envoi des instructions vers Equity BCDC
C'est l'étape de transmission effective et sécurisée des instructions de paiement à Equity Bank. Elle est protégée par un code OTP (One-Time Password) envoyé par email, constituant une double vérification d'identité avant tout décaissement financier.
Accéder à l'écran d'envoi
Sélectionner les lots à envoyer
- Filtrez par dates de validation si nécessaire.
- Cochez un ou plusieurs lots validés. La case en en-tête coche tous les lots visibles.
- Un bandeau d'alerte apparaît :
Procédure d'envoi sécurisé par OTP — étape par étape
- Cliquez sur Envoyer vers Equity.
- La fenêtre modale « Envoi vers Equity BCDC » s'ouvre.
- Étape 1 — Demande du code OTP : Vérifiez le récapitulatif de la sélection. Cliquez sur Recevoir le code OTP. Un code à 6 chiffres à usage unique est envoyé à l'adresse email de l'utilisateur connecté. Une alerte verte confirme l'envoi et un compte à rebours indique la durée de validité du code.
- Étape 2 — Saisie du code OTP : Consultez immédiatement votre boîte email (vérifiez aussi le dossier spam). Copiez le code reçu et saisissez-le dans le champ Code OTP. Le bouton Envoyer s'active dès qu'un code valide est détecté.
- Étape 3 — Confirmation finale : Cliquez sur Envoyer. Le système effectue les opérations suivantes en séquence :
- Marque les lots sélectionnés au statut « Envoyé »
- Met à jour les instructions associées au statut « En attente de traitement »
- Déclenche la génération des fichiers H2H (format spécifique Equity Bank)
- Chiffre les fichiers avec la clé PGP d'Equity Bank
- Dépose les fichiers sur le serveur SFTP d'Equity pour traitement
⚠️ Important — Code OTP expiré : Si le compte à rebours atteint 00:00 avant votre saisie, le code expire. Cliquez à nouveau sur Recevoir le code OTP pour en générer un nouveau. Vous pouvez demander plusieurs codes successivement sans limitation.
⚠️ Important — Sécurité absolue du code OTP : Le code OTP est votre signature électronique pour cette opération financière. Ne le partagez jamais avec une autre personne, y compris un supérieur hiérarchique. Si quelqu'un vous demande votre code OTP, refusez et signalez cet incident à l'équipe IT GROUP. La demande de votre OTP par une tierce personne est le signe d'une tentative de fraude.
9.3.4 Étape 4 — Suivi des paiements Equity H2H
Après l'envoi, Equity Bank traite les fichiers et renvoie des fichiers de retour (ACK = accusé positif, NACK = rejet, PSR = rapport de synthèse final). L'écran de suivi permet de monitorer en temps réel l'état de chaque fichier et de chaque instruction de paiement.
Accéder à l'écran de suivi
Comprendre les statuts des fichiers H2H
| Statut | Couleur du badge | Signification |
|---|---|---|
| Non envoyé | Gris | Fichier généré côté plateforme, pas encore transmis au SFTP Equity |
| Envoi en cours | Bleu | Transmission SFTP en cours de traitement |
| Envoyé | Bleu ciel | Fichier déposé sur le SFTP Equity, en attente d'accusé de réception |
| Reçu | Vert clair | Accusé de réception (ACK) reçu — Equity confirme avoir le fichier |
| Traité avec succès | Vert foncé | Paiements exécutés par Equity — fonds décaissés |
| Rejeté | Rouge | Fichier rejeté par Equity (NACK) — voir fichier de rejet pour le motif |
| Erreur | Orange | Problème technique lors de la transmission SFTP |
Actions disponibles sur un fichier (menu trois points)
- Voir détails — ouvre la fenêtre modale de détail complet du fichier
- Télécharger — selon disponibilité : fichier H2H original, ACK, NACK, PSR
- Renvoyer — redéclenche le dépôt SFTP (uniquement pour les fichiers en statut "Non envoyé" ou "Erreur")
- Supprimer — suppression irréversible du fichier et des instructions associées
Consulter le détail d'un fichier
La fenêtre de détail permet à l'administrateur de descendre jusqu'au niveau de l'instruction individuelle (une école = une instruction) et de voir précisément le statut de chaque virement, qui a effectué chaque étape du workflow, et quand.
⚠️ Attention — Suppression d'un fichier H2H : La suppression d'un fichier H2H supprime également toutes les instructions de paiement associées côté plateforme. Cette opération ne peut pas annuler un virement déjà en cours de traitement ou exécuté chez Equity Bank. Elle ne doit être utilisée qu'en cas d'erreur manifeste sur un fichier non encore envoyé. Une fenêtre d'alerte forte récapitule le nom du fichier, la référence Equity, le nombre d'instructions et le montant total avant confirmation.
A.9.9.4 — Paiements Vodacom M-Pesa — Cycle complet
9.4 Paiements Vodacom M-Pesa — Cycle complet
9.4.1 Étape 1 — Génération des instructions M-Pesa
La génération M-Pesa prépare les virements mobile money destinés aux tuteurs (ou directement aux élèves si elles sont désignées comme bénéficiaires perceptrices dans leur fiche).
Accéder à l'écran de génération
Sélectionner la tranche et afficher les tuteurs éligibles
- Sélectionnez la Tranche de paiement dans la liste déroulante.
- Le tableau des tuteurs éligibles s'affiche. Seuls les tuteurs réunissant ces conditions apparaissent :
- Ils ont des élèves validées pour paiement pour la tranche choisie
- Un compte M-Pesa est configuré et coché "compte choisi pour paiement" dans leur fiche
- Pour vérifier le détail des élèves incluses dans le calcul d'un tuteur, cliquez sur le bouton ▼ (déplier) de sa ligne :
- Affinez si nécessaire avec les filtres École(s), Classe et Option.
Sélectionner et générer
- Cochez les tuteurs à inclure. Le bandeau récapitulatif apparaît :
- Cliquez sur Générer les instructions de paiement.
- Ajoutez un Commentaire descriptif, cliquez sur Générer. Pour chaque tuteur sélectionné, le système crée un lot contenant un paiement individuel par élève (1 paiement M-Pesa = 1 virement = 1 élève).
9.4.2 Étape 2 — Validation des instructions M-Pesa
Accéder à l'écran de validation
Valider un lot individuellement
- Cliquez sur Valider (coche verte) sur la ligne du lot.
- Vérifiez toutes les informations. Cliquez sur Valider. Le lot passe au statut « Validé ».
Rejeter un lot
- Cliquez sur Rejeter (croix rouge).
- Renseignez la Raison du rejet (obligatoire). Cliquez sur Rejeter. Le lot est marqué rejeté, tous les paiements du lot passent au statut « Annulé ».
Validation ou rejet groupé
- Cochez plusieurs lots.
- Les boutons Valider plusieurs instructions et Rejeter plusieurs instructions apparaissent.
- Chaque action ouvre une fenêtre modale récapitulative :
- Pour la validation : nombre de lots, total élèves, montant global à confirmer
- Pour le rejet : même récapitulatif + champ Raison du rejet unique applicable à tous les lots sélectionnés
9.4.3 Étape 3 — Envoi des instructions M-Pesa
Accéder à l'écran d'envoi
- Filtrez si nécessaire.
- Cochez les lots à envoyer.
- Cliquez sur Envoyer (n) (n = nombre de lots sélectionnés). Les paiements sont soumis en temps réel à l'API Vodacom M-Pesa. Chaque paiement individuel (un par élève) est initié séparément, permettant un suivi granulaire.
ℹ️ Note sur la sécurité M-Pesa : L'envoi M-Pesa ne nécessite pas de code OTP, contrairement à Equity. La sécurisation repose ici sur la stricte séparation des rôles (génération, validation et envoi peuvent être attribués à des personnes différentes) et sur la traçabilité exhaustive de chaque action dans le journal d'activités.
9.4.4 Étape 4 — Suivi des paiements M-Pesa
Accéder à l'écran de suivi
Comprendre les compteurs par lot
Chaque lot M-Pesa contient un paiement individuel pour chaque élève rattachée au tuteur. Les quatre compteurs détaillent l'état en temps réel :
| Compteur | Couleur | Signification |
|---|---|---|
| Total paiements | Bleu | Nombre total de paiements dans le lot (un par élève) |
| Payé | Vert | Paiements reçus et confirmés par Vodacom M-Pesa |
| En cours | Orange | Paiements soumis, confirmation pas encore reçue de Vodacom |
| Échoué / Annulé | Rouge | Paiements échoués (numéro incorrect, compte inexistant, solde insuffisant) ou annulés manuellement |
Consulter le détail d'un lot
Cliquez sur Voir les détails pour ouvrir la fenêtre modale de détail :
Cette vue granulaire permet à l'administrateur de :
- Vérifier qu'une élève spécifique a bien été payée (recherche par UID ou nom)
- Identifier les paiements échoués et leur motif (compte inexistant, numéro incorrect) pour correction
- Préparer les justificatifs individuels pour un audit ou une réclamation d'une bénéficiaire
A.9.9.5 — Bonnes pratiques et points de vigilance — Paiements
9.5 Bonnes pratiques et points de vigilance — Paiements
Vérifier les conditions d'éligibilité avant la génération. Si une école ou un tuteur attendu n'apparaît pas dans la liste de génération, vérifiez méthodiquement : (1) validation pour paiement active, (2) compte bancaire ou M-Pesa correctement renseigné et coché « choisi pour paiement », (3) élèves validées pour paiement pour la tranche concernée, (4) tranche correctement configurée dans les Paramètres de l'année scolaire.
Respecter la séparation des rôles. Cette séparation n'est pas une contrainte administrative — c'est un contrôle interne fondamental contre la fraude et les erreurs. Une seule personne ne doit jamais être en mesure de générer ET valider ET envoyer un paiement.
Commenter systématiquement les lots générés. Un commentaire précis (tranche, zone géographique, date) facilite considérablement le suivi, le reporting et les investigations ultérieures. Il est visible dans tous les écrans du cycle et dans les exports.
Ne jamais supprimer un fichier Equity H2H déjà envoyé. Une fois un fichier déposé sur le SFTP Equity Bank, sa suppression côté plateforme ne l'annule pas côté banque. Tout problème sur un fichier déjà en cours de traitement doit être géré en coordination avec l'équipe technique IT GROUP et directement avec Equity Bank.
Surveiller quotidiennement les statuts de suivi pendant les périodes de paiement. Des paiements Equity en statut « Envoyé » depuis plus de 48h sans évolution vers « Reçu » ou « Traité » méritent une investigation. Des paiements M-Pesa « En cours » depuis plus de 24h peuvent indiquer un problème de callback API. Dans les deux cas, contactez l'équipe IT GROUP avec la référence du fichier ou du lot concerné.
Documenter tous les rejets. La raison de rejet saisie est enregistrée dans le journal d'activités. Des rejets répétés sur les mêmes écoles ou tuteurs signalent un problème structurel (compte bancaire systématiquement erroné, numéro M-Pesa invalide) qui doit être corrigé à la source dans les fiches correspondantes.
A.10 — Rapports
Chapitre A.10 du Manuel PIGBF
A.10.10.1 — Vue d'ensemble du module Rapports
10.1 Vue d'ensemble du module Rapports
Le module Rapports permet de générer, à la demande, des exports de données structurés et personnalisables couvrant les trois entités centrales de la PIGBF : les écoles, les élèves et les tuteurs. Ces exports servent à produire des tableaux de bord pour le pilotage du programme, à alimenter les rapports de redevabilité transmis aux bailleurs de fonds, à appuyer les audits internes et externes, et à répondre aux demandes ad hoc de la coordination PAAF.
Le fonctionnement du module repose sur un moteur de génération asynchrone : lorsqu'un rapport est demandé, la plateforme transmet la configuration (colonnes sélectionnées, filtres, paramètres) à l'application api-pigbf, qui traite la requête en arrière-plan. Le fichier généré — au format Excel (.xlsx) — est ensuite envoyé par email à l'utilisateur connecté à l'adresse enregistrée dans son compte. L'utilisateur peut également consulter et re-télécharger ses rapports passés depuis la section Mes Rapports.
ℹ️ Note : La génération d'un rapport peut prendre de quelques secondes à plusieurs minutes selon la taille du jeu de données et le nombre de colonnes sélectionnées. Le rapport arrive par email ; inutile de rester sur la page une fois la demande soumise.
🔒 Restreint : L'accès à chaque type de rapport est conditionné par une permission spécifique (generer rapport des ecoles, generer rapport des élèves, generer rapport des tuteurs). Un utilisateur qui ne dispose pas de la permission correspondante ne verra pas l'entrée de menu associée.
A.10.10.2 — Rapport des écoles
10.2 Rapport des écoles
10.2.1 Accéder au rapport des écoles
10.2.2 Configurer les filtres géographiques et pédagogiques
Le rapport des écoles s'appuie sur une hiérarchie de filtres cascadés qui s'affinent progressivement. Chaque sélection restreint automatiquement les options du niveau suivant :
- Province — Sélectionnez une ou plusieurs provinces. La liste est restreinte au périmètre géographique autorisé pour votre ONG (si applicable).
- Proved — Se met à jour automatiquement selon la ou les provinces sélectionnées.
- Sous-Proved — Se met à jour selon les Proveds sélectionnés.
- École — Liste les écoles rattachées aux Sous-Proveds sélectionnés.
- Section — Filtre par section pédagogique (Primaire, Secondaire, etc.).
- Classe — Filtre par niveau de classe (1ère, 2ème, etc.).
- Option — Filtre par option (Pédagogie générale, Commerce, Électronique, etc.). Se met à jour selon les sections sélectionnées.
⚠️ Attention : Un filtre géographique (Province au minimum) est obligatoire pour pouvoir soumettre le rapport. Si aucune province n'est sélectionnée, le bouton Générer le rapport reste inactif et un message d'avertissement s'affiche.
10.2.3 Configurer les filtres complémentaires
Quatre filtres booléens (cases à cocher) permettent de restreindre davantage le périmètre :
| Filtre | Description |
|---|---|
| Avec numéro SECOPE | N'inclut que les écoles dont le numéro SECOPE est renseigné dans la fiche |
| Avec arrêté ministériel | N'inclut que les écoles ayant un numéro d'arrêté ministériel enregistré |
| Ayant reçu la première tranche | Filtre les écoles ayant effectivement perçu la 1ère tranche de paiement Equity pour l'année en cours |
| Ayant reçu la deuxième tranche | Filtre les écoles ayant effectivement perçu la 2ème tranche de paiement Equity pour l'année en cours |
10.2.4 Sélectionner et ordonner les colonnes
La zone Colonnes à inclure permet de composer librement la structure du fichier Excel généré. Les colonnes disponibles sont :
| Identifiant | Libellé dans le rapport |
|---|---|
nom_ecole |
Nom de l'école |
numero_secope |
Numéro SECOPE |
numero_arrete_min |
Numéro de l'arrêté ministériel |
date_numero_arrete_min |
Date de signature de l'arrêté ministériel |
code_ecole |
Code de l'école (code interne PIGBF) |
nb_enseignant_h |
Nombre d'enseignants hommes |
nb_enseignant_f |
Nombre d'enseignantes femmes |
nb_enseignant_h_mec |
Nombre d'enseignants hommes mécanisés |
nb_enseignant_f_mec |
Nombre d'enseignantes femmes mécanisées |
province |
Province |
proved |
Proved |
sproved |
Sous-Proved |
secteur_id |
Secteur |
groupement_id |
Groupement |
village |
Village |
latitude |
Latitude GPS |
longitude |
Longitude GPS |
noms_prefet |
Nom du préfet |
genre_prefet |
Genre du préfet |
numero_phone_prefet |
Numéro de téléphone du préfet |
nb_beneficiaire_ecole |
Nombre total de bénéficiaires dans l'école |
compte_paiement_type |
Type de compte de paiement (M-Pesa, Equity, etc.) |
compte_paiement |
Numéro du compte de paiement |
montant_premiere_tranche |
Montant reçu pour la 1ère tranche |
montant_deuxieme_tranche |
Montant reçu pour la 2ème tranche |
nb_eleve_abandon |
Nombre de bénéficiaires ayant abandonné l'école |
total_frais_scolaires |
Total des frais scolaires enregistrés |
total_minerval |
Total du minerval |
total_ipp |
Total de l'IPP |
total_bulletin |
Total du bulletin |
Pour sélectionner des colonnes :
- Dans la liste de gauche, cliquez sur une colonne pour l'ajouter à votre sélection. Elle apparaît dans la liste de droite.
- Pour ajouter toutes les colonnes en une seule opération, cliquez sur Tout sélectionner.
- Pour retirer une colonne déjà sélectionnée, cliquez sur l'icône ✕ à droite de son libellé dans la liste de sélection.
- Pour modifier l'ordre des colonnes dans le fichier Excel, utilisez les flèches ▲ (monter) et ▼ (descendre) à côté de chaque colonne sélectionnée. L'ordre affiché correspond à l'ordre des colonnes dans le fichier généré.
10.2.5 Générer le rapport
- Vérifiez que vos filtres et colonnes sont configurés correctement.
- Cliquez sur Générer le rapport.
- Une fenêtre modale de confirmation s'affiche avec le message : « Votre rapport est en cours de génération. Vous recevrez un email avec le lien de téléchargement une fois qu'il sera prêt. »
- Cliquez sur Fermer. La page est réinitialisée automatiquement.
ℹ️ Note : Si une erreur de communication avec le serveur api-pigbf survient, un message d'erreur s'affiche dans la même modale : « Une erreur est survenue lors de la génération du rapport. Veuillez réessayer plus tard. » Dans ce cas, contactez l'équipe IT GROUP.
A.10.10.3 — Rapport des élèves
10.3 Rapport des élèves
10.3.1 Accéder au rapport des élèves
10.3.2 Filtres complémentaires disponibles pour les élèves
| Filtre | Description |
|---|---|
| Avec numéro SERNIE | Élèves dont le numéro SERNIE est renseigné |
| Situation handicap | Filtre selon la situation de handicap (toutes / avec handicap / sans handicap) |
| Situation étude | Filtre selon le statut de scolarité (en cours / a abandonné) |
| Ayant reçu la première tranche | Élèves/tuteurs ayant perçu la 1ère tranche de subvention M-Pesa |
| Ayant reçu la deuxième tranche | Élèves/tuteurs ayant perçu la 2ème tranche de subvention M-Pesa |
10.3.3 Colonnes disponibles pour le rapport des élèves
Le rapport des élèves offre le jeu de colonnes le plus riche de la plateforme, couvrant l'identité, le parcours scolaire, les données socio-économiques, les résultats, les frais et les informations de paiement :
| Identifiant | Libellé dans le rapport |
|---|---|
nom_eleve |
Nom de l'élève |
postnom_eleve |
Postnom de l'élève |
prenom_eleve |
Prénom de l'élève |
genre_eleve |
Genre de l'élève |
situation_parentale |
Situation parentale |
age_eleve |
Âge de l'élève |
noms_tuteur |
Noms du tuteur (nom, postnom, prénom) |
statut_migratoire |
Statut migratoire de l'élève |
lien_tuteur |
Lien de parenté entre l'élève et le tuteur |
code |
Code de l'élève (code interne PIGBF) |
numero_sernie |
Numéro SERNIE |
uid |
Identifiant unique (UID) de l'élève |
lieu_naissance |
Lieu de naissance |
date_naissance |
Date de naissance |
email |
Adresse e-mail de l'élève |
phone_call |
Numéro de téléphone (appel) |
phone_whatsapp |
Numéro WhatsApp |
has_handicap |
Situation de handicap (Oui / Non) |
handicap_besoin |
Nature du besoin lié au handicap |
code_ecole |
Code de l'école |
nom_ecole |
Nom de l'école |
section_eleve |
Section de l'élève |
classe_eleve |
Classe de l'élève |
option_eleve |
Option de l'élève |
frais_scolaires |
Frais scolaires |
minerval |
Minerval |
ipp |
IPP |
bulletin |
Bulletin |
moyenne_s1 |
Moyenne du 1er semestre |
moyenne_s2 |
Moyenne du 2ème semestre |
moyenne_presence_s1 |
Régularité (taux de présence) S1 |
moyenne_presence |
Régularité (taux de présence) S2 |
distance_ecole_maison |
Distance domicile–école |
nb_enfants_foyer |
Nombre d'enfants au foyer |
abandon_ecole |
A abandonné l'école (Oui / Non) |
annee_abandon_ecole |
Année de l'abandon |
raison_abandon_ecole |
Raison de l'abandon |
province |
Province |
proved |
Proved |
sproved |
Sous-Proved |
A.10.10.4 — Rapport des tuteurs
10.4 Rapport des tuteurs
10.4.1 Accéder au rapport des tuteurs
10.4.2 Colonnes disponibles pour le rapport des tuteurs
| Identifiant | Libellé dans le rapport |
|---|---|
nom |
Nom du tuteur |
postnom |
Postnom |
prenom |
Prénom |
code |
Code du tuteur (code interne PIGBF) |
uid |
Identifiant unique (UID) du tuteur |
niveau_etude_id |
Niveau d'études |
profession_id |
Profession |
genre_id |
Genre |
email |
Adresse e-mail |
phone_call |
Numéro de téléphone (appel) |
phone_whatsapp |
Numéro WhatsApp |
nb_enfants_foyer |
Nombre d'enfants au foyer |
nb_enfants_ecole |
Nombre d'enfants à l'école |
province |
Province |
proved |
Proved |
sproved |
Sous-Proved |
has_handicap |
Situation de handicap du tuteur |
has_handicap_besoin |
Nature du besoin lié au handicap |
nom_representant |
Nom du représentant du tuteur |
lien_representant |
Lien entre le représentant et le tuteur |
phone_call_representant |
Téléphone du représentant |
compte_paiement_type |
Type de compte de paiement (M-Pesa, Equity…) |
compte_paiement |
Numéro du compte de paiement |
montant_premiere_tranche |
Montant reçu pour la 1ère tranche |
montant_deuxieme_tranche |
Montant reçu pour la 2ème tranche |
10.4.3 Filtres complémentaires disponibles pour les tuteurs
| Filtre | Description |
|---|---|
| Ayant reçu la première tranche | Tuteurs ayant perçu la 1ère tranche de subvention |
| Ayant reçu la deuxième tranche | Tuteurs ayant perçu la 2ème tranche de subvention |
| Situation handicap | Filtre selon la situation de handicap du tuteur |
| Avec compte de paiement | Tuteurs ayant un compte M-Pesa ou Equity renseigné |
A.10.10.5 — Mes Rapports
10.5 Mes Rapports
10.5.1 Présentation
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é.
10.5.2 Statuts possibles d'un rapport
| Statut | Couleur | Signification |
|---|---|---|
| En attente | Gris | La demande a été reçue mais le traitement n'a pas encore démarré |
| En cours | Orange | Le rapport est en cours de génération dans api-pigbf |
| Complété | Vert | Le fichier est prêt — email envoyé, téléchargement disponible |
| Échoué | Rouge | Une erreur est survenue lors de la génération |
10.5.3 Télécharger un rapport complété
- Repérez la ligne du rapport dont le statut est Complété.
- Cliquez sur Télécharger.
- La plateforme interroge
api-pigbfpour obtenir l'URL sécurisée du fichier. Vous êtes redirigé automatiquement vers le téléchargement.
ℹ️ Note : Les URLs de téléchargement sont générées à la demande et ont une durée de vie limitée. Si le lien reçu par email est expiré, utilisez le bouton Télécharger dans Mes Rapports pour obtenir un nouveau lien valide.
10.5.4 Relancer un rapport échoué
Si un rapport affiche le statut Échoué :
- Cliquez sur Relancer.
- La plateforme transmet à nouveau la même configuration à
api-pigbf. - Une modale de confirmation s'affiche : « Le rapport a été relancé. Vous recevrez un email avec le lien de téléchargement une fois qu'il sera prêt. »
⚠️ Attention : Si un rapport échoue à plusieurs reprises, contactez l'équipe IT GROUP en indiquant l'identifiant du rapport (visible dans la colonne N° du tableau).
A.10.10.6 — Bonnes pratiques — Rapports
10.6 Bonnes pratiques — Rapports
Privilégier les filtres géographiques précis. Plus le périmètre filtré est large (toutes les provinces, sans filtre de Sous-Proved), plus le temps de génération est long et la taille du fichier importante. Pour des rapports opérationnels rapides, filtrez au niveau Sous-Proved ou école.
Soigner l'ordre des colonnes. L'ordre dans lequel les colonnes sont arrangées dans l'interface est l'ordre exact dans le fichier Excel. Préparez cette configuration avant de soumettre pour éviter une relance inutile.
Consulter Mes Rapports avant de relancer. Si vous n'avez pas reçu l'email après 10 minutes, vérifiez d'abord le statut dans Mes Rapports — le rapport est peut-être toujours en cours de traitement.
Vérifier l'adresse email du compte. Les rapports sont envoyés à l'adresse enregistrée dans votre profil. Si vous ne recevez rien, vérifiez votre dossier spam et confirmez que votre adresse est correcte dans Mon Profil (menu utilisateur en haut à droite).
A.11 — Gestion des utilisateurs et acteurs
Chapitre A.11 du Manuel PIGBF
A.11.11.1 — Vue d'ensemble
11.1 Vue d'ensemble
La gestion des utilisateurs est l'une des responsabilités les plus sensibles de l'Administrateur Plateforme. Elle conditionne directement qui peut accéder à quoi dans la PIGBF. Ce module permet de :
- Créer de nouveaux comptes utilisateurs et leur attribuer un rôle
- Modifier les informations et le rôle d'un utilisateur existant
- Suspendre ou réactiver un compte
- Rattacher un utilisateur à un acteur (entité organisationnelle) et/ou une ONG
- Gérer les années scolaires accessibles à chaque utilisateur
- Consulter la liste des enquêteurs terrain ODK
La liste des utilisateurs est accessible via Menu latéral → Utilisateurs.
A.11.11.2 — Les acteurs
11.2 Les acteurs
11.2.1 Définition
Un acteur est l'entité organisationnelle à laquelle un utilisateur est rattaché. Il détermine le contexte institutionnel de l'utilisateur sur la plateforme. Les acteurs principaux du programme PAAF/PIGBF sont :
| Acteur | Description |
|---|---|
| IT GROUP | Équipe technique développant et maintenant la plateforme |
| ONG partenaire | Organisation non gouvernementale opérationnelle sur le terrain |
| PROVED | Provincial de l'Éducation — entité de supervision provinciale |
| Sous-PROVED | Sous-Provincial de l'Éducation — entité de supervision locale |
| PAAF | Coordination centrale du programme |
ℹ️ Note : Le champ Acteur dans le formulaire utilisateur est distinct du champ ONG. Un utilisateur rattaché à une ONG doit avoir l'acteur « ONG partenaire » et un ONG sélectionné dans le champ dédié. Ces deux champs combinés définissent précisément son périmètre d'accès.
A.11.11.3 — Créer un nouvel utilisateur
11.3 Créer un nouvel utilisateur
11.3.1 Accéder au formulaire de création
11.3.2 Renseigner les informations du formulaire
Section « Informations personnelles »
- Nom complet — Prénom et nom de l'utilisateur. Ce nom sera affiché dans l'interface et dans les journaux d'activité.
- Email — Adresse email de connexion. Elle doit être unique sur la plateforme. C'est également l'adresse à laquelle seront envoyés les rapports et les notifications.
- Mot de passe — Définissez un mot de passe fort (minimum 8 caractères, combinant lettres, chiffres et caractères spéciaux). Cliquez sur l'icône 👁 pour afficher/masquer le mot de passe en clair.
- Confirmer le mot de passe — Ressaisissez le mot de passe pour validation.
Section « Accès et rôle »
- Rôle — Sélectionnez le rôle à attribuer. Seuls les rôles que vous êtes autorisé à attribuer sont visibles (un Admin ne peut pas créer de Super Admin).
- Acteur — Sélectionnez l'entité organisationnelle de rattachement parmi les acteurs disponibles.
- ONG — Ce champ apparaît uniquement si l'acteur sélectionné est « ONG partenaire ». Sélectionnez l'ONG dans la liste. Ceci restreint automatiquement le périmètre de données accessible à cet utilisateur à l'ONG concernée.
- Années scolaires accessibles — Cochez les années scolaires auxquelles cet utilisateur aura accès. Un utilisateur sans aucune année cochée ne pourra pas accéder aux données et sera redirigé vers une page d'information.
Section « Options »
- Statut — Par défaut, le compte est créé actif. Décochez si vous souhaitez créer un compte en attente d'activation.
- Envoyer les identifiants par email — Si cette case est cochée, la plateforme envoie automatiquement un email à l'utilisateur contenant ses identifiants de connexion (email + mot de passe) dès la validation du formulaire.
Section « Avatar »
- Cliquez sur la zone d'upload pour sélectionner une photo de profil (formats acceptés : JPG, PNG, max 4 Mo). L'avatar est optionnel mais recommandé pour faciliter l'identification dans les journaux d'activité.
11.3.3 Enregistrer l'utilisateur
- Vérifiez l'ensemble des informations saisies.
- Cliquez sur Enregistrer.
- En cas d'erreur de validation (email déjà utilisé, mot de passe trop faible, rôle non sélectionné), les champs concernés sont mis en évidence avec un message d'erreur explicite.
- En cas de succès, vous êtes redirigé vers la fiche de l'utilisateur créé.
A.11.11.4 — Modifier un utilisateur existant
11.4 Modifier un utilisateur existant
11.4.1 Accéder à la modification
- Dans la liste des utilisateurs, cliquez sur l'icône Modifier (crayon) sur la ligne de l'utilisateur concerné.
- Ou naviguez vers la fiche utilisateur (icône Voir) puis cliquez sur Modifier.
Le formulaire de modification est identique au formulaire de création, prérempli avec les données existantes.
⚠️ Attention : La modification du rôle d'un utilisateur prend effet immédiatement. Si l'utilisateur est connecté au moment de la modification, ses accès seront mis à jour à sa prochaine action sur la plateforme.
⚠️ Attention : Le champ Mot de passe est optionnel en modification. Laissez-le vide pour conserver le mot de passe existant. Si vous le renseignez, le nouveau mot de passe remplace immédiatement l'ancien.
A.11.11.5 — Consulter la fiche d'un utilisateur
11.5 Consulter la fiche d'un utilisateur
La fiche utilisateur consolide toutes les informations relatives à un compte en un seul écran.
A.11.11.6 — Suspendre et réactiver un compte utilisateur
11.6 Suspendre et réactiver un compte utilisateur
11.6.1 Suspendre un compte
La suspension d'un compte bloque immédiatement l'accès à la plateforme pour l'utilisateur concerné, sans supprimer ses données ni son historique d'activité.
- Dans la liste des utilisateurs ou dans la fiche utilisateur, cliquez sur l'icône Suspendre (cadenas).
- Une fenêtre modale de confirmation s'affiche :
- Cliquez sur Suspendre le compte pour confirmer. Le badge de statut de l'utilisateur passe à Suspendu (rouge).
ℹ️ Note : Un utilisateur suspendu qui tente de se connecter voit s'afficher une page d'information lui indiquant que son compte est inactif et l'invitant à contacter l'administrateur.
11.6.2 Réactiver un compte
- Repérez l'utilisateur suspendu dans la liste (filtrez sur le statut « Suspendu » si nécessaire).
- Cliquez sur l'icône Réactiver (cadenas ouvert ou icône dédiée).
- Une fenêtre modale de confirmation s'affiche :
- Cliquez sur Réactiver. Le badge repasse à Actif (vert).
A.11.11.7 — Gestion des enquêteurs terrain
11.7 Gestion des enquêteurs terrain
11.7.1 Présentation
Les enquêteurs terrain sont un type particulier d'utilisateur de la PIGBF. Contrairement aux autres rôles, ils n'ont aucun accès à l'interface web : ils opèrent exclusivement via l'application mobile ODK Collect sur tablette. Leurs comptes sont des comptes ODK Central gérés depuis la PIGBF.
11.7.2 Consulter la fiche d'un enquêteur
Cliquez sur l'icône Voir sur la ligne d'un enquêteur pour accéder à sa fiche détaillée.
ℹ️ Note : Le QR code affiché sur la fiche enquêteur encode les paramètres de connexion ODK Central spécifiques à cet enquêteur. C'est ce QR code qui doit être scanné depuis l'application ODK Collect lors de la configuration initiale d'une tablette, ou lors du remplacement d'une tablette. Ne le partagez pas par voie non sécurisée.
A.11.11.8 — Bonnes pratiques — Gestion des utilisateurs
11.8 Bonnes pratiques — Gestion des utilisateurs
Appliquer le principe du moindre privilège. Attribuez toujours le rôle le moins étendu qui permette à l'utilisateur d'accomplir ses tâches. Évitez de créer des comptes Admin génériques partagés entre plusieurs personnes.
Ne jamais supprimer un compte. La plateforme ne permet pas la suppression définitive d'un compte utilisateur (le bouton destroy n'est pas exposé). Utilisez la suspension. Cela préserve l'intégrité du journal d'activité et permet de retracer les actions passées en cas d'audit.
Revoir régulièrement les accès actifs. À chaque changement de personnel dans les équipes terrain ou de coordination, vérifiez et mettez à jour les comptes correspondants (suspension des départs, création des arrivées, mise à jour des rôles en cas de changement de poste).
Documenter les raisons des suspensions. Même si la plateforme ne dispose pas d'un champ commentaire sur la suspension, notez en interne la raison et la date de la décision, notamment pour les comptes d'agents terrain.
A.12 — Rôles et permissions
Chapitre A.12 du Manuel PIGBF
A.12.12.1 — Vue d'ensemble du module
12.1 Vue d'ensemble du module
Le module Rôles et permissions permet à l'Administrateur Plateforme de visualiser, créer, modifier et supprimer des rôles personnalisés, et de gérer finement les permissions associées à chacun.
La PIGBF utilise le moteur de gestion des rôles et permissions Spatie Laravel Permission. Chaque action possible sur la plateforme (consulter une liste, créer un enregistrement, valider une donnée ODK, générer un rapport…) est représentée par une permission nommée. Les rôles sont des regroupements de permissions que l'on attribue ensuite aux utilisateurs.
A.12.12.2 — Les 7 rôles de la plateforme
12.2 Les 7 rôles de la plateforme
Les rôles suivants sont préconfigurés et constituent la base du contrôle d'accès de la PIGBF. Ils ne peuvent pas être supprimés (hormis les rôles personnalisés créés ultérieurement) :
| Rôle | Périmètre | Peut être créé par |
|---|---|---|
| Super Admin | Accès total, tous programmes, toutes ONG. Configure les paramètres système critiques. Seul à pouvoir créer d'autres Super Admins. | Super Admin uniquement |
| Admin | Administration générale sur le périmètre assigné. Accès à quasi tous les modules sauf paramétrage système réservé Super Admin. | Super Admin |
| Admin PAAF | Supervision programme côté coordination PAAF. Accès aux données consolidées, paiements, rapports tous axes. | Super Admin / Admin |
| Admin ONG | Gestion des opérations de son ONG uniquement. Validation ODK, suivi écoles/élèves/tuteurs dans son périmètre. | Super Admin / Admin |
| Validateur paiement PAAF | Rôle autonome : validation et envoi des instructions Equity et M-Pesa. Aucun accès aux données bénéficiaires. | Super Admin / Admin |
| Admin IT ONG | Profil technique ONG : gestion des enquêteurs, validation ODK, support collecte. | Super Admin / Admin / Admin ONG |
| Lecture seule | Consultation sans modification. Profil audit, supervision externe, bailleurs. | Super Admin / Admin |
A.12.12.3 — Visualiser les permissions d'un rôle
12.3 Visualiser les permissions d'un rôle
- Sur la carte d'un rôle, cliquez sur Voir les permissions.
- Une fenêtre modale s'ouvre listant toutes les permissions assignées à ce rôle, regroupées par module :
A.12.12.4 — Créer un rôle personnalisé
12.4 Créer un rôle personnalisé
Il est possible de créer des rôles supplémentaires pour répondre à des besoins organisationnels spécifiques non couverts par les 7 rôles préconfigurés.
- Cliquez sur Créer un rôle.
- Une fenêtre modale s'ouvre :
- Saisissez un nom de rôle explicite (minimum 3 caractères).
- Sélectionnez les permissions à attribuer :
- Utilisez la barre de recherche pour filtrer rapidement les permissions par mot-clé (ex : « paiement », « écoles », « ODK »).
- Cliquez sur une permission pour la basculer dans la colonne « Sélectionnées ».
- Utilisez Tout sélectionner pour activer toutes les permissions d'un coup (à utiliser avec précaution). - Cliquez sur Enregistrer. Le nouveau rôle apparaît dans la grille et est immédiatement disponible dans le formulaire de création/modification d'utilisateurs.
A.12.12.5 — Modifier un rôle existant
12.5 Modifier un rôle existant
- Sur la carte du rôle, cliquez sur Modifier.
- La même modale que la création s'ouvre, préremplie avec le nom et les permissions actuelles.
- Modifiez le nom et/ou les permissions.
- Cliquez sur Enregistrer.
⚠️ Attention : La modification des permissions d'un rôle prend effet immédiatement pour tous les utilisateurs ayant ce rôle, y compris ceux actuellement connectés. Toute permission retirée est immédiatement révoquée. Procédez à ces modifications en dehors des heures d'utilisation intensive si possible.
A.12.12.6 — Supprimer un rôle personnalisé
12.6 Supprimer un rôle personnalisé
🔒 Restreint : Les 7 rôles préconfigurés ne peuvent pas être supprimés. Seuls les rôles personnalisés créés par les administrateurs sont supprimables.
- Sur la carte du rôle à supprimer, cliquez sur Supprimer.
- Une fenêtre modale de confirmation s'affiche indiquant le nombre d'utilisateurs actuellement affectés à ce rôle.
- Cliquez sur Supprimer définitivement. Le rôle est retiré de la plateforme et retiré automatiquement de tous les utilisateurs qui le possédaient.
⚠️ Attention : Cette action est irréversible. Les utilisateurs qui ne possédaient que ce rôle n'auront plus aucun accès à la plateforme jusqu'à ce qu'un nouvel rôle leur soit attribué.
A.13 — Paramètres généraux
Chapitre A.13 du Manuel PIGBF
A.13.13.1 — Vue d'ensemble
13.1 Vue d'ensemble
Le module Paramètres généraux regroupe tous les référentiels métier de la plateforme : les listes de valeurs utilisées dans les formulaires de création d'écoles, d'élèves, de tuteurs et dans les formulaires ODK terrain. Maintenir ces référentiels à jour est essentiel pour garantir la cohérence des données collectées.
Les référentiels disponibles sont regroupés en trois grandes catégories :
Référentiels géographiques
- Provinces · Proveds · Sous-Proveds · Territoires · Secteurs · Groupements · Villages
Référentiels pédagogiques
- Classes · Sections · Options · Niveaux d'études · Périodes · Semestres · Régularités
Référentiels socio-administratifs
- Genres · Situations parentales · Statuts migratoires · Professions · Liens tuteurs-élèves · Liens tuteurs-représentants · Distances domicile-école · Motifs d'abandon scolaire · Types de documents · Modes de paiement · Banques · Devises
A.13.13.2 — Fonctionnement général des référentiels
13.2 Fonctionnement général des référentiels
Chaque référentiel fonctionne selon le même modèle CRUD (Créer, Lire, Modifier, Supprimer) :
Ajouter une entrée
- Cliquez sur le bouton Ajouter [nom du référentiel] dans la section concernée.
- Un formulaire inline ou une modale s'ouvre selon le référentiel.
- Saisissez les informations requises.
- Cliquez sur Enregistrer.
Modifier une entrée
- Cliquez sur l'icône Modifier (crayon) sur la ligne concernée.
- Modifiez les informations dans le formulaire qui s'ouvre.
- Cliquez sur Enregistrer.
Supprimer une entrée
- Cliquez sur l'icône Supprimer (corbeille) sur la ligne concernée.
- Une confirmation est demandée.
⚠️ Attention : La suppression d'une entrée de référentiel peut être bloquée si des enregistrements y font référence (par exemple, supprimer une classe utilisée par des élèves est impossible). Dans ce cas, un message d'erreur explicite s'affiche.
A.13.13.3 — Référentiels géographiques
13.3 Référentiels géographiques
13.3.1 Provinces
Les provinces constituent le premier niveau de la hiérarchie géographique. Elles sont la base de filtrage dans les rapports, les listes d'écoles et les périmètres des ONG.
13.3.2 Proveds (Provinciales de l'Éducation)
Chaque Proved est rattachée à une Province. Le formulaire d'ajout inclut un sélecteur de province parente.
13.3.3 Sous-Proveds
Chaque Sous-Proved est rattaché à un Proved. Le formulaire inclut un sélecteur de Proved parent.
13.3.4 Territoires, Secteurs, Groupements, Villages
Ces quatre référentiels forment la hiérarchie administrative locale, complémentaire de la hiérarchie éducative (Province → Proved → Sous-Proved). Ils sont utilisés pour la localisation précise des écoles.
A.13.13.4 — Référentiels pédagogiques
13.4 Référentiels pédagogiques
13.4.1 Classes
Les classes sont ordonnées par un numéro d'ordre qui détermine leur affichage dans les listes et les graphiques du tableau de bord.
13.4.2 Sections
Les sections (ex : Primaire, Humanités générales, Techniques commerciales, Techniques industrielles…) sont utilisées pour catégoriser les établissements et les parcours des élèves.
13.4.3 Options
Chaque option est rattachée à une section. Le formulaire inclut un sélecteur de section parente.
13.4.4 Périodes et Semestres
Ces référentiels définissent les périodes d'évaluation utilisées lors de la collecte des notes et présences via ODK.
13.4.5 Régularités
Les régularités sont les tranches de taux de présence utilisées pour qualifier l'assiduité des élèves (ex : « Régulière ≥ 80% », « Irrégulière < 80% »).
A.13.13.5 — Référentiels socio-administratifs
13.5 Référentiels socio-administratifs
13.5.1 Genres
Permet de définir les libellés des genres utilisés dans les formulaires (ex : Masculin, Féminin, Non précisé).
13.5.2 Situations parentales
Valeurs utilisées pour décrire la situation familiale d'une élève (ex : Vit avec les deux parents, Orpheline de père, Orpheline de mère, Orpheline des deux parents, Enfant de rue, etc.).
13.5.3 Statuts migratoires
Catégorisent les élèves selon leur situation de déplacement (ex : Déplacée interne, Réfugiée, Résidente, Retournée).
13.5.4 Liens tuteurs-élèves et tuteurs-représentants
Ces deux référentiels définissent les relations de parenté ou de tutelle entre :
- Un tuteur et une élève bénéficiaire (ex : Mère, Père, Oncle, Grand-mère, Tuteur légal non apparenté…)
- Un tuteur et son représentant légal (personne qui le représente pour la réception des paiements si le tuteur est absent ou dans l'incapacité)
13.5.5 Distances domicile-école
Tranches de distance utilisées pour qualifier l'éloignement entre le domicile et l'établissement scolaire (ex : Moins de 1 km, 1 à 3 km, Plus de 3 km).
13.5.6 Motifs d'abandon scolaire
Liste des raisons pouvant expliquer l'abandon de la scolarité par une bénéficiaire (ex : Mariage précoce, Grossesse, Contraintes économiques, Déplacement, Décès, Maladie…).
13.5.7 Types de documents
Définit les types de documents pouvant être attachés aux fiches écoles et élèves (ex : Arrêté d'agrément, Fiche de bourse tranche 1, Fiche de bourse tranche 2, Bulletin scolaire, Acte de naissance…). Chaque type de document a un identifiant interne utilisé par les filtres et le module paiements.
13.5.8 Modes de paiement, Banques et Devises
- Modes de paiement : liste des canaux de paiement acceptés (Equity BCDC, Vodacom M-Pesa, Espèces…)
- Banques : liste des établissements bancaires de référence
- Devises : devises acceptées sur la plateforme (ex : Franc Congolais — CDF, Dollar américain — USD)
A.14 — Années scolaires
Chapitre A.14 du Manuel PIGBF
A.14.14.1 — Vue d'ensemble
14.1 Vue d'ensemble
La gestion des années scolaires est l'un des modules de paramétrage les plus importants de la PIGBF. L'année scolaire active est la notion centrale qui filtre l'ensemble des données affichées sur la plateforme : listes d'écoles, d'élèves, de tuteurs, validations ODK, paiements, rapports — tout est contextualisé par rapport à l'année scolaire en cours.
A.14.14.2 — Créer une nouvelle année scolaire
14.2 Créer une nouvelle année scolaire
- Cliquez sur le bouton Ajouter une année scolaire.
- Une fenêtre modale s'ouvre avec un champ Libellé (format requis :
AAAA-AAAA, ex :2026-2027). La plateforme vérifie que les deux années sont consécutives. - Cliquez sur Enregistrer.
ℹ️ Note : La création d'une nouvelle année ne la définit pas automatiquement comme active. Il faut ensuite la configurer (paramètres de bourse, tranches) et la définir manuellement comme année par défaut.
A.14.14.3 — Configurer les paramètres financiers de l'année scolaire
14.3 Configurer les paramètres financiers de l'année scolaire
Chaque année scolaire possède une configuration de bourse qui détermine les montants alloués et la structure des tranches de paiement.
14.3.1 Montants de la bourse
| Champ | Description |
|---|---|
| Montant école (CDF) | Montant versé directement à l'école par élève via Equity BCDC — couvre les frais scolaires |
| Subvention élève/tuteur (CDF) | Montant versé au tuteur ou à l'élève via M-Pesa — subvention directe |
| Montant total par bénéficiaire | Calculé automatiquement : montant école + subvention élève/tuteur |
| Montant total programme | Optionnel — montant global du programme pour l'année (à des fins de reporting) |
14.3.2 Gérer les types de frais scolaires
Les types de frais définissent les catégories de dépenses scolaires collectées lors de la phase terrain (ex : Minerval, IPP, Bulletin, Tenues, Sport…).
- Dans la section Types de frais, cliquez sur Ajouter un type de frais.
- Saisissez le libellé du type de frais.
- Cliquez sur Enregistrer.
A.14.14.4 — Gérer les tranches de paiement
14.4 Gérer les tranches de paiement
Les tranches de paiement définissent le calendrier de versement et la répartition des montants entre les différentes échéances du programme.
14.4.1 Ajouter une tranche de paiement
- Cliquez sur Ajouter une tranche.
- Renseignez les champs :
| Champ | Description |
|---|---|
| Nom de la tranche | Libellé libre (ex : « Tranche 1 Equity », « Tranche 2 M-Pesa ») |
| Bénéficiaire | École (circuit Equity) ou Élève/Tuteur (circuit M-Pesa) |
| Pourcentage / Montant | Pour Equity : % du montant école. Pour M-Pesa : montant fixe en CDF |
| Active | Une tranche inactive n'est pas proposée lors de la génération des instructions de paiement |
⚠️ Attention : La somme des pourcentages des tranches Equity doit être égale à 100%. La plateforme affiche un indicateur coloré (vert/rouge) pour vous alerter si la répartition est incorrecte. Une répartition incorrecte bloquera la génération des instructions Equity.
14.4.2 Modifier ou supprimer une tranche
- Cliquez sur Modifier sur la ligne de la tranche pour éditer ses paramètres.
- Cliquez sur Supprimer pour supprimer une tranche.
⚠️ Attention : La suppression d'une tranche est bloquée si des instructions de paiement ont déjà été générées sur cette tranche. Dans ce cas, désactivez la tranche plutôt que de la supprimer.
A.14.14.5 — Définir l'année scolaire active
14.5 Définir l'année scolaire active
La sélection de l'année scolaire active (ou « par défaut ») détermine l'année qui s'affiche par défaut lors de la connexion de chaque utilisateur. Les utilisateurs peuvent basculer manuellement vers une autre année dans le sélecteur d'année scolaire en haut de l'interface, à condition d'y avoir accès dans leur profil.
- Dans le tableau Toutes les années scolaires, repérez l'année à activer.
- Cliquez sur Définir comme active.
- Une confirmation est demandée.
ℹ️ Note : Changer l'année active ne modifie pas les données — cela change uniquement l'année affichée par défaut au chargement de la plateforme pour tous les utilisateurs.
A.14.14.6 — Clôturer une année scolaire
14.6 Clôturer une année scolaire
La clôture d'une année scolaire est une opération de fin de cycle qui verrouille définitivement toutes les données de l'année concernée. Une fois clôturée, aucune modification ne peut être apportée aux données de cette année.
- Dans le tableau des années scolaires, cliquez sur Clôturer sur la ligne de l'année à clôturer.
- Une fenêtre modale de confirmation très explicite s'affiche :
- Tapez le libellé exact de l'année (ex :
2024-2025) dans le champ de confirmation. - Le bouton Clôturer l'année scolaire s'active.
- Cliquez dessus pour finaliser.
⚠️ Attention — Action irréversible. La clôture d'une année scolaire est définitive et ne peut pas être annulée. Assurez-vous que tous les paiements de l'année ont été traités, tous les rapports générés, et toutes les données validées avant de procéder à la clôture. Consultez l'équipe de coordination PAAF avant toute clôture.
A.14.14.7 — Le sélecteur d'année scolaire dans l'interface
14.7 Le sélecteur d'année scolaire dans l'interface
En dehors du module de paramétrage, le sélecteur d'année scolaire est accessible depuis la barre de navigation supérieure de la plateforme. Il permet à chaque utilisateur de basculer entre les années auxquelles il a accès sans quitter la page en cours.
Lorsqu'un utilisateur change d'année scolaire via ce sélecteur, toutes les données affichées sur la plateforme (listes, statistiques du tableau de bord, validations ODK en attente, paiements) se mettent à jour automatiquement pour refléter l'année nouvellement sélectionnée.
A.15 — Logs et journal d'activités
Chapitre A.15 du Manuel PIGBF
A.15.15.1 — Vue d'ensemble
15.1 Vue d'ensemble
La PIGBF dispose d'un journal d'activités complet qui enregistre automatiquement toutes les actions significatives réalisées par les utilisateurs sur la plateforme. Ce journal est un outil d'auditabilité essentiel pour :
- Tracer qui a fait quoi, quand et sur quel enregistrement
- Investiguer les anomalies ou erreurs constatées dans les données
- Répondre aux exigences d'audit des bailleurs et de la coordination PAAF
- Détecter des comportements inhabituels (accès suspect, modifications massives non attendues)
Le module Logs se divise en deux journaux distincts :
| Journal | Contenu | Accès |
|---|---|---|
| Journal d'activités | Toutes les actions sur les entités métier (création, modification, validation, suppression d'écoles, élèves, tuteurs, paiements…) | Menu → Logs |
| Journal de collecte | Historique détaillé des soumissions ODK traitées (formulaire, enquêteur, date de collecte, Sous-Proved, résultat de l'intégration) | Menu → Logs → Collecte |
A.15.15.2 — Journal d'activités
15.2 Journal d'activités
15.2.1 Accéder au journal
15.2.2 Comprendre les colonnes du journal
| Colonne | Description |
|---|---|
| Utilisateur | L'utilisateur qui a réalisé l'action (nom + avatar). Les actions système automatisées (jobs, scheduler) sont identifiées par « Système » |
| Description | Résumé lisible de l'action (ex : « École Lycée de la Paix créée », « Élève Furaha Mwamba validée pour paiement tranche 1 ») |
| Module | Nom du journal auquel appartient cet événement (ex : ecoles, eleves, paiements, utilisateurs, settings) |
| Événement | Type d'action : created (création), updated (modification), deleted (suppression), ou événements métier spécifiques (validated, rejected, sent…) |
| Objet modifié | Type et identifiant de l'enregistrement concerné (ex : Ecole #147, Eleve #2304) |
| Date et heure | Horodatage précis de l'action (format JJ/MM/AAAA HH:MM:SS) |
15.2.3 Filtrer le journal
La zone de filtres en haut de page permet de cibler rapidement les événements pertinents :
- Recherche par description — Saisissez un mot-clé (nom d'école, nom d'élève, action…) pour filtrer les lignes dont la description contient ce terme.
- Module (Log name) — Sélectionnez un module dans la liste déroulante pour n'afficher que les événements de ce module (ex : n'afficher que les logs du module paiements).
- Type d'événement — Filtrez par type :
created,updated,deleted, ou événements métier. - Utilisateur auteur — Sélectionnez un utilisateur dans la liste pour voir uniquement ses actions.
- Plage de dates — Définissez une période (Date de / Date jusqu'au) pour restreindre la recherche à un intervalle temporel.
- Nombre par page — Choisissez le nombre de lignes à afficher (10, 25, 50, 100).
Pour réinitialiser tous les filtres simultanément, cliquez sur Réinitialiser les filtres.
15.2.4 Consulter le détail d'un événement
Cliquez sur le lien Voir les détails sur une ligne du journal pour ouvrir la fenêtre modale de détail :
Cette vue de détail est particulièrement utile pour :
- Identifier précisément quel champ a été modifié et quelle était la valeur précédente
- Vérifier qu'une modification erronée peut être corrigée manuellement
- Fournir des preuves documentées en cas de contestation ou d'audit
ℹ️ Note : L'état « avant » est vide pour les événements de type created (l'enregistrement n'existait pas). L'état « après » est vide pour les événements de type deleted.
A.15.15.3 — Journal de collecte
15.3 Journal de collecte
15.3.1 Présentation
Le journal de collecte trace l'historique des soumissions ODK qui ont été traitées par api-pigbf et mises à disposition pour validation dans la PIGBF. Contrairement au journal d'activités qui enregistre les actions des utilisateurs web, le journal de collecte enregistre les événements de collecte terrain.
15.3.2 Colonnes du journal de collecte
| Colonne | Description |
|---|---|
| Enquêteur | Identifiant (label) ODK de l'enquêteur qui a soumis le formulaire |
| Formulaire | Identifiant du formulaire ODK (form_id : ex : identification_eleves, frais_scolaires…) |
| ID Instance | Identifiant unique de la soumission dans ODK Central (form_instance_id). Permet de retrouver la soumission exacte dans ODK Central en cas de litige |
| Sous-Proved | Sous-Proved du formulaire concerné (issu des métadonnées de la soumission) |
| Année scolaire | Année scolaire associée à cette collecte |
| Date de collecte | Date à laquelle les données ont été collectées sur le terrain (pas la date de synchronisation) |
| Statut | Intégré = données traitées et disponibles en validation ; En attente = données reçues, pas encore traitées ; Rejeté = données rejetées lors de la validation |
15.3.3 Filtrer le journal de collecte
- Recherche — Filtrez par nom d'enquêteur, identifiant de formulaire ou identifiant d'instance ODK.
- Année scolaire — Sélectionnez une année scolaire dans la liste déroulante.
- Sous-Proved — Filtrez par Sous-Proved pour ne voir que les collectes d'une zone géographique précise.
- Plage de dates — Définissez une période de collecte pour restreindre l'affichage.
A.15.15.4 — Bonnes pratiques — Logs et journal d'activités
15.4 Bonnes pratiques — Logs et journal d'activités
Consulter le journal avant toute investigation sur une anomalie. Avant de modifier manuellement une donnée qui semble incorrecte, consultez le journal pour comprendre la chronologie des modifications : qui a modifié le champ concerné, quand, et quelle était la valeur précédente.
Utiliser les filtres de dates pour les audits périodiques. Pour un audit mensuel, filtrez le journal sur le mois écoulé et exportez ou prenez des captures d'écran des actions sensibles (validations de paiements, modifications de montants, créations d'utilisateurs).
Croiser journal d'activités et journal de collecte. Lorsqu'une école ou un élève présente des données incohérentes, il peut être utile de vérifier dans le journal de collecte quelle soumission ODK est à l'origine de l'enregistrement, puis dans le journal d'activités si des modifications manuelles ont été apportées après intégration.
Signaler immédiatement les événements suspects. Toute action effectuée par un utilisateur dont le compte devrait être suspendu, ou tout volume inhabituel de suppressions ou modifications en masse, doit être signalé immédiatement à l'équipe IT GROUP (support@itgroup.cd) avec la référence de l'événement visible dans le journal.
Conserver l'historique. Les journaux ne sont pas purgés automatiquement. Leur conservation intégrale garantit la traçabilité complète sur toute la durée du programme. Ne jamais supprimer des entrées du journal, même en cas d'erreur.
Fin du document — Sections A.1 à A.15
Session 6 à venir : Section B complète — Administrateur ONG / Admin IT ONG (chapitres B.1 à B.8)
Note de rédaction — Consignes pour la suite
Les notes suivantes sont à conserver d'une session à l'autre pour garantir la cohérence du manuel.
Densité et niveau de détail : Chaque chapitre doit décrire toutes les zones de l'interface, toutes les colonnes des tableaux, tous les champs des formulaires et toutes les actions possibles. Ne pas résumer ce qui peut être détaillé.
Screenshots : Placer un
à chaque fois qu'un état d'interface, une modale, un formulaire, un résultat ou un comportement est décrit pour la première fois. Minimum 2–3 screenshots par sous-section fonctionnelle.📸 Capture d'écran à insérer : description Tableaux de référence : Toutes les listes de colonnes, champs, statuts, permissions et types doivent être présentées en tableau pour faciliter la lecture.
Alertes ⚠️ : Systématiquement signaler les actions irréversibles, les effets de bord immédiats (modification de rôle, clôture d'année) et les règles métier bloquantes (somme 100% des tranches Equity, filtre Province obligatoire pour les rapports).
Structure cohérente : Chaque module suit le plan : Vue d'ensemble → Accès au module → Fonctionnalités détaillées étape par étape → Bonnes pratiques / Points de vigilance.