# B.4 — Validation des données ODK

Chapitre B.4 du Manuel PIGBF

# B.4.4.1 — Vue d'ensemble

## 4.1 Vue d'ensemble

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

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

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

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

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

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

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

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

---

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

## 4.2 Validation des données écoles

### Accéder à la page

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

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

### Les deux onglets de navigation

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

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

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

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

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

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

### Filtrer les données en attente

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

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

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

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

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

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

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

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

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

### Valider une école individuellement

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

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

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

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

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

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

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

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

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

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

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

### Exporter les données en attente

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

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

---

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

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

### Accéder à la page

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

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

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

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

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

### Filtres disponibles

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

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

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

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

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

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

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

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

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

### Valider des élèves

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

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

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

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

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

---

# B.4.4.4 — Validation des données tuteurs

## 4.4 Validation des données tuteurs

### Accéder à la page

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

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

### Colonnes du tableau des données tuteurs

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

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

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

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

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

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

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

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

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

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

### Valider des tuteurs

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

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

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

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

---

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

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

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

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

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

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

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

---

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

---

---