ki-fwi/docs/adr/0006-projet-participatif.md

# ADR 0006 — Le manque est publié, pas masqué

- **Statut :** accepté
- **Date :** 2026-07-27
- **Session :** 0 — cadre et données
- **Décideur :** le porteur

## Contexte

Le projet se heurtait à un mur prévisible : les fonds libres documentent mal la flore
antillaise, et le premier réflexe d'un projet logiciel devant un trou de données est de le
contourner — masquer la fiche incomplète, remplacer la photo absente par un visuel généré,
afficher une saison approximative sans le dire.

Chacun de ces contournements dégrade ce que le jeu prétend enseigner, et surtout : **il perd
l'information**. Un trou masqué reste un trou. Un trou publié est une tâche que quelqu'un
peut prendre.

La mesure faite en session 0 donne à cette question un poids inattendu. Wikidata enregistre
**124 noms vernaculaires** pour les 13 espèces du projet — 33 pour le fruit à pain, 22 pour
la pomme d'eau, en chinois, anglais, portugais, slovène. **Aucun en kréyòl.** Le jeu n'est
donc pas seulement consommateur de communs numériques : il est, sur cette langue, à peu près
le seul à en produire.

## Décision

**Le manque est une information de première classe, affichée dans le produit.**

### Trois conséquences concrètes

1. **L'encyclopédie affiche ce qu'elle n'a pas.** Une fiche sans photo d'écorce le dit, et
   explique comment la combler. Pas de silence, pas de remplissage.
2. **Le jeu comporte un écran de contribution** — « Ba on koudmen » — qui liste les manques
   du moment et pointe vers les plateformes où les combler. Session 2.
3. **Le manque est mesuré par script, pas décrit à la main.**
   `npm run rapport:manques` produit `docs/manques.md` : couverture des cinq vues
   pédagogiques dans les fonds publics, présence du kréyòl sur Wikidata, observations par
   île, et manques internes du dataset. Un chiffre daté vaut mieux qu'une impression.

### Ce que cette décision n'autorise pas

- **Aucune requête tierce au runtime.** Contribuer se fait sur les plateformes externes ; le
  jeu se contente de liens `<a>` ordinaires. Le rapport de manques est calculé **au build**
  (playbook P2) et embarqué comme donnée statique. Aucun appel à Commons, Wikidata,
  iNaturalist ou Pl@ntNet pendant qu'on joue.
- **Aucun compte, aucune collecte.** Le projet ne reçoit pas les contributions : il oriente
  vers Commons et Wikidata, où elles profitent à tout le monde. Un formulaire de dépôt
  interne créerait un silo, exactement ce que le projet combat, et poserait la question de
  la modération de contenus déposés par des enfants — que ce projet ne veut pas avoir à se
  poser.
- **Aucun assouplissement de la porte de validation.** Une contribution passe par la même
  relecture humaine nominative que le reste (ADR 0004). L'ouverture porte sur qui peut
  proposer, jamais sur qui peut valider.

## Conséquences

### Sur les priorités de contenu

La mesure fait apparaître une hiérarchie que l'intuition n'aurait pas donnée :

- **L'écorce est la vue manquante** — 3 trous sur les 3 restants après correction de la
  mesure, tous des écorces. C'est aussi l'indice le plus fiable sur le terrain, puisqu'un
  tronc est visible toute l'année quand un fruit ne l'est que quelques mois.
- **Le mancenillier est le plus mal servi** : 56 fichiers sur Commons contre 1076 pour la
  goyave, ses trois premiers résultats étant des gravures de 1780, 1816 et 1821. L'entrée la
  plus critique du module de sécurité est la moins bien documentée.
- **Le kréyòl est à zéro partout**, ce qui rend la contribution Wikidata prioritaire alors
  qu'elle ne demande ni appareil photo ni déplacement.

### Sur les sessions suivantes

- **Session 1** — l'encyclopédie affiche les manques de chaque fiche.
- **Session 2** — écran « Ba on koudmen », alimenté par le rapport baké au build.
- **Session 6** — `docs/contribuer.md` devient une page publique du site.

### Sur la mesure elle-même

Le premier rapport produit annonçait **28 vues manquantes sur 65**. Le chiffre était faux :
le groupement `OR` de la recherche Commons ne se comporte pas comme attendu — sur
*Annona muricata*, `section` seul remonte 17 fichiers là où `(section OR sliced OR cut OR
coupe)` en remonte 0. Après correction — un mot, une requête —, le chiffre réel est **3 sur
65**.

L'écart est instructif à deux titres. D'abord, publier 28 faux manques aurait envoyé des
bénévoles photographier ce qui existait déjà. Ensuite, une mesure qui produit un résultat
extrême — ici, `coupe` à zéro pour les treize espèces — doit être suspectée avant d'être
publiée. Le script gère désormais explicitement la limitation de débit des API, parce qu'une
réponse illisible comptée comme « 0 fichier » fabrique un manque imaginaire.

## Alternative écartée

**Un formulaire de dépôt de photos dans le jeu.** Plus simple pour le contributeur, mais il
crée un silo — les photos ne serviraient qu'à ce jeu —, impose une modération, et suppose un
serveur, un compte et une collecte. Orienter vers Commons demande un effort de plus au
contributeur et rend sa contribution utile bien au-delà du projet. C'est le sens même du mot
« communs ».