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

📸 Capture d'écran à insérer : Schéma illustrant le flux de validation ODK : 4 étapes visuelles avec icônes (Terrain → ODK Central → Zone staging → Production), avec les acteurs et délais indicatifs à chaque étape

📸 Capture d'écran à insérer : Menu latéral section "Validation des données collectées" déroulée : sous-menus "Données écoles", "Données élèves", "Données tuteurs" visibles, avec les badges numériques rouges indiquant le nombre de fiches en attente sur chaque sous-menu

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.