# 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

```

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> 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</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> 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</callout>`

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**.

---