Files
ki-fwi/README.md
T
OKIandClaude Opus 5 9e3c176411 feat(participatif): publier les manques et outiller la contribution
Le manque devient une information de première classe : mesuré, daté,
affiché, et accompagné de la marche à suivre pour le combler (ADR 0006).

Mesure
- rapport:manques : couverture des 5 vues pédagogiques dans les fonds
  publics, présence du kréyòl sur Wikidata, observations GBIF par île,
  manques internes du dataset → docs/manques.md.
- Le kréyòl est absent des communs : Wikidata enregistre 124 noms
  vernaculaires pour ces 13 espèces (zh, en, pt, sl) et aucun en kréyòl ;
  0 étiquette gcf sur 13 items.
- L'écorce est la vue manquante : 3 trous sur 65, tous des écorces —
  mansiniyé 0 fichier, aki 0, kénèt 1.
- Pl@ntNet publie en CC BY-SA là où iNaturalist est à ~93 % CC BY-NC :
  meilleur canal de contribution à effort égal.

Correction d'une mesure fausse avant publication
- Le premier rapport annonçait 28 vues manquantes sur 65. Le groupement OR
  de la recherche Commons ne se comporte pas comme attendu : « section »
  seul remonte 17 fichiers là où « (section OR sliced OR cut OR coupe) » en
  remonte 0. Un mot, une requête, avec gestion du débit — le chiffre réel
  est 3 sur 65. Publier les 28 aurait envoyé des bénévoles photographier
  ce qui existait déjà.

Documents
- docs/contribuer.md : six gestes, du nom kréyòl sur Wikidata (5 min) à
  l'enregistrement d'une voix, avec le tableau de choix de licence et la
  consigne de sécurité pour photographier le mancenillier.
- docs/adr/0006-projet-participatif.md : aucun dépôt interne, aucune
  requête tierce au runtime, la porte de validation reste inchangée.
- docs/courriers/appel-liberation-tramil.md : brouillon d'appel public,
  à n'envisager qu'après la demande privée. Publication au porteur.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-27 10:12:35 -04:00

92 lines
4.7 KiB
Markdown

# KI FWI SA YÉ ?
Jeu éducatif libre qui apprend aux enfants des Antilles à reconnaître les fruits, les arbres
et les plantes de leurs îles. Le kréyòl est la langue principale ; le français en est la
traduction.
Porté par **ORGANISATION KA INTERNATIONALE** — [o-k-i.net](https://o-k-i.net).
> **État : session 0 terminée.** Cadre juridique, outillage de données et dataset vérifié.
> Aucun code applicatif n'est encore écrit. Voir [`docs/plan.md`](docs/plan.md).
## Le principe
Le jeu enseigne la reconnaissance du **réel**. Deux filières d'assets, jamais mélangées :
- **Filière A — vérité.** Photographies réelles. Seule filière autorisée pour tout ce qui
sert à identifier : épreuves, indices, fiches.
- **Filière B — décor.** Images générées. Fonds, sprites, badges. Jamais une épreuve.
Les modèles de diffusion connaissent mal le corossol, à peine la quenette, presque pas le
zikak. Ils produisent des fruits *plausibles et faux*. Un jeu d'identification bâti sur des
assets générés apprend l'erreur.
Cette règle n'est pas une consigne : c'est un script. `npm run validate:data` fait échouer
le build si une épreuve s'appuie sur un média non validé, et `npm run test:porte` prouve que
ce refus se produit.
## Un projet participatif — le manque est publié, pas masqué
Les fonds libres documentent mal la flore antillaise, et le kréyòl en est presque absent :
Wikidata enregistre **124 noms vernaculaires** pour les 13 espèces du projet — en chinois, en
anglais, en portugais, en slovène — et **aucun en kréyòl**.
Plutôt que de contourner ces trous, le projet les mesure et les publie. Une fiche sans photo
d'écorce le dit et explique comment le combler. `npm run rapport:manques` régénère
l'inventaire ; [`docs/contribuer.md`](docs/contribuer.md) explique les six gestes possibles,
de l'ajout d'un nom sur Wikidata — cinq minutes, aucun matériel — jusqu'à l'enregistrement
d'une voix kréyòl.
Contribuer se fait sur Wikimedia Commons, Wikidata, iNaturalist ou Pl@ntNet, **jamais dans le
jeu** : les contributions doivent servir à tout le monde, pas seulement à ce projet. Le jeu
se contente de liens ordinaires — il ne contacte aucun service pendant qu'on y joue.
## Commandes
```bash
npm install
npm run verify:taxa # vérifie la taxonomie contre Wikidata et GBIF
npm run ingest:commons # remonte les photos candidates sous licence libre
npm run build:dataset # compose les entrées (--force pour écraser)
npm run validate:data # la porte : schéma + règles métier
npm run test:porte # prouve que la porte refuse ce qu'elle doit refuser
npm run build:credits # régénère CREDITS.md depuis les données
npm run check:audio # liste les enregistrements kréyòl manquants
npm run rapport:manques # mesure ce qui manque, dans le projet et dans les fonds publics
```
Ces scripts vivent dans `tools/data/`, hors du bundle. **Aucun appel réseau ne subsistera au
runtime du jeu** : tout est cuit au build.
## Où regarder
| Fichier | Contenu |
|---|---|
| [`docs/contribuer.md`](docs/contribuer.md) | **comment enrichir la connaissance** — six gestes, du plus rapide au plus engageant |
| [`docs/manques.md`](docs/manques.md) | ce qui manque, mesuré et daté — régénéré par script |
| [`docs/plan.md`](docs/plan.md) | les 7 sessions et leurs portes de sortie mesurables |
| [`docs/adr/`](docs/adr/) | les six décisions d'architecture et leurs motifs |
| [`docs/audit-sources.md`](docs/audit-sources.md) | ce qu'on prend à chaque source, sous quelle licence |
| [`docs/a-arbitrer.md`](docs/a-arbitrer.md) | ce qu'un humain doit trancher avant publication |
| [`docs/kreyol-a-relire.md`](docs/kreyol-a-relire.md) | les incertitudes orthographiques, signalées non corrigées |
| [`docs/planche-relecture-medias.md`](docs/planche-relecture-medias.md) | les 130 photos candidates à valider |
| [`fruits.schema.json`](fruits.schema.json) | le contrat des données |
| [`CREDITS.md`](CREDITS.md) | attributions, généré — ne pas éditer |
## Licences
- **Code :** [AGPL-3.0-or-later](LICENSE)
- **Contenu OKI :** [CC BY-SA 4.0](LICENSE-CONTENT)
- **Médias tiers :** licence d'origine conservée, listée média par média dans
[`CREDITS.md`](CREDITS.md). Le jeu est une œuvre **collective**, pas dérivée — d'où
l'interdiction absolue de compositing, vérifiée par script.
Rien n'est « libre de droit ». Voir [`SOURCES.md`](SOURCES.md) et
[`docs/adr/0001-licences.md`](docs/adr/0001-licences.md).
## Ce que le code ne fera jamais
Aucun compte, aucune publicité, aucun traceur, aucune requête vers un domaine tiers au
runtime, aucune collecte de données sur les enfants. Le jeu est entièrement jouable hors
ligne après une première visite.