# D.2.2.4 — Phase 3 — Configuration du projet PIGBF via QR Code

## 2.4 Phase 3 — Configuration du projet PIGBF via QR Code

C'est l'étape qui connecte l'application ODK Collect à l'enquêteur et au serveur ODK Central du programme PIGBF. Elle repose sur le **QR Code personnalisé** généré depuis la fiche de l'enquêteur dans la plateforme web.

### 2.4.1 Obtenir le QR Code de l'enquêteur

Le QR Code est généré par l'Admin IT ONG depuis l'interface web PIGBF :

1. Se connecter à https://pigbf.org avec un compte Admin IT ONG ou Admin ONG
2. Menu latéral → **Enquêteurs**
3. Cliquer sur l'icône **Voir** (œil) sur la ligne de l'enquêteur concerné
4. Dans la fiche de l'enquêteur, localiser la section **QR Code ODK**
5. Le QR Code s'affiche à l'écran — il peut être **imprimé** ou **téléchargé** en PNG

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Fiche enquêteur dans l'interface web PIGBF, section "QR Code ODK" : carré QR code affiché en grand format, bouton "Imprimer le QR code" et bouton "Télécharger le QR code (PNG)" visibles en dessous du code. Note explicative : "Ce QR Code est unique pour cet enquêteur. Il encode les paramètres de connexion ODK Central."</callout>`

> ℹ️ **Note sur la confidentialité du QR Code :** Le QR Code encode les identifiants de connexion ODK Central personnels de l'enquêteur (URL du serveur, email et mot de passe ODK). Ne jamais le partager par voie non sécurisée (groupes WhatsApp publics, emails non chiffrés). Le remettre directement en main propre à l'enquêteur ou l'envoyer par un canal professionnel de confiance.

### 2.4.2 Scanner le QR Code sur la tablette

Une fois le QR Code disponible (imprimé ou affiché sur un autre écran), procédez à la configuration de la tablette :

1. Ouvrez l'application **ODK Collect** sur la tablette.
2. Sur l'écran d'accueil de l'application, appuyez sur l'icône **menu** (trois points verticaux ⋮) en haut à droite de l'écran, puis appuyez sur **Configure via QR code**.

*Alternative :* Sur certaines versions, un bouton dédié **"Configurer par QR code"** peut apparaître directement sur l'écran d'accueil si l'application n'est pas encore configurée.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Écran d'accueil ODK Collect sans projet configuré : message d'invitation à configurer l'application visible, bouton ou option "Configure via QR code" mis en évidence</callout>`

3. L'application demande l'autorisation d'utiliser la caméra si ce n'est pas déjà accordé. Appuyez sur **Autoriser**.
4. Le **scanner de QR Code** s'ouvre : un cadre de visée apparaît au centre de l'écran.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Écran scanner QR Code dans ODK Collect : cadre de visée carré au centre, fond de caméra actif, instructions textuelles en bas de l'écran invitant à aligner le QR Code dans le cadre</callout>`

5. Présentez le QR Code devant la caméra de la tablette. Centrez-le dans le cadre de visée en maintenant la tablette stable.
6. ODK Collect lit automatiquement le QR Code dès qu'il est correctement positionné dans le cadre. **Ne pas appuyer sur aucun bouton — la lecture est automatique.**
7. Une fois le QR Code reconnu, l'application affiche un message de confirmation et la liste des formulaires assignés à l'enquêteur se charge automatiquement.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Tablette Android après scan réussi du QR Code : message de confirmation "Projet configuré avec succès" (ou équivalent), nom du projet "Plateforme Informatique de Gestion..." affiché en en-tête, liste des formulaires disponibles commençant à s'afficher</callout>`

### 2.4.3 Vérifier la configuration

Après le scan réussi, vérifiez que la configuration est correcte :

1. L'écran d'accueil doit afficher le **nom du projet PIGBF** dans la barre du haut : *"Plateforme Informatique de Gest..."*
2. Appuyez sur **+ Start new form** — la liste des formulaires assignés à l'enquêteur doit s'afficher.
3. Vérifiez que les formulaires correspondant à la mission de l'enquêteur sont bien présents.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Écran "Start new form" après configuration réussie : liste complète des formulaires assignés à l'enquêteur, chacun avec son titre, son numéro de version, son ID et sa date de dernière synchronisation. La présence de l'icône de géolocalisation sur certains formulaires est visible</callout>`

> ⚠️ **Si aucun formulaire n'apparaît :** Cela signifie que l'Admin IT ONG n'a pas assigné de formulaires à l'enquêteur, ou que la synchronisation initiale n'a pas abouti (problème de connexion réseau). Vérifiez la connexion internet de la tablette et contactez l'Admin IT ONG pour vérifier l'assignation des formulaires (cf. Section B, chapitre B.3).

### 2.4.4 Synchroniser les formulaires

Après la configuration initiale, il est recommandé de procéder à une **synchronisation manuelle** pour s'assurer que les formulaires sont à leur version la plus récente :

1. Depuis l'écran d'accueil ODK Collect, appuyez sur **+ Start new form**.
2. Dans la liste des formulaires, appuyez sur l'icône de **rafraîchissement** (↺) en haut à droite de l'écran.
3. ODK Collect se connecte au serveur ODK Central et télécharge les versions les plus récentes des formulaires.
4. Une barre de progression indique l'avancement du téléchargement.
5. Une fois terminé, la liste est mise à jour avec les nouvelles versions.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> Écran de synchronisation des formulaires dans ODK Collect : barre de progression visible, liste des formulaires en cours de mise à jour, indicateur de connexion réseau</callout>`

---