Files
ki-fwi/README.md
T

73 lines
3.4 KiB
Markdown
Raw Normal View History

# 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.
## 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
```
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/plan.md`](docs/plan.md) | les 7 sessions et leurs portes de sortie mesurables |
| [`docs/adr/`](docs/adr/) | les cinq 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.