# JWE

<p align="center">
JWE est un jeu de géolocalisation souverain, dans l'esprit de GeoGuessr, centré sur 4 régions : <strong>Guadeloupe, Martinique, Guyane, La Réunion</strong>. Le joueur voit une photo unique d'un lieu — ou navigue dans une rue en visionneuse Mapillary (mode <em>An lari a</em>) — et place un marqueur sur une carte pour deviner la commune — puis découvre une fiche éducative Wikipédia/Wikidata… ou un appel à contribution quand le lieu n'y est pas documenté (<em>Pwen blindé</em>).
</p>

<p align="center">
  <a href="https://liberapay.com/OKI/donate/">
    <img src="https://img.shields.io/liberapay/receives/OKI.svg?logo=liberapay">
    <img src="https://img.shields.io/liberapay/patrons/OKI.svg?logo=liberapay">
    <img src="https://img.shields.io/liberapay/goal/OKI.svg?logo=liberapay">
  </a>
</p>

- **Souverain** : zéro Google, zéro Mapbox. MapLibre + tiles libres, Wikipédia/Wikidata, auto-hébergeable sur un petit VPS. (Exception documentée : le mode street « An lari a » utilise la visionneuse Mapillary — images CC BY-SA 4.0, lib MIT, token client gratuit.)
- **Éthique** : pas de comptes, pas de leaderboard, pas de mécanique dopaminergique.
- **Bilingue** : français / créole.
- **5 modes** : Konnèt moniman, Kote mwen ye ?, Défi 5 rounds, Aprann (explorer), An lari a (street-level Mapillary).
- **Stack** : Svelte 5 + SvelteKit 2, MapLibre GL JS, mapillary-js, Node ≥ 20, licence MIT.

## Utilisation

```bash
git clone https://labola.o-k-i.net/ORGANISATION-KA-INTERNATIONALE/JWE.git
cd JWE/app
npm ci
cp .env.example .env   # puis renseignez PUBLIC_MAPILLARY_TOKEN (token client gratuit)
npm run dev        # développement
npm run build && node build   # production (adapter-node)
```

## Documentation

- [`docs/architecture.md`](docs/architecture.md) — décisions d'architecture (ADR).
- [`docs/deploiement.md`](docs/deploiement.md) — auto-hébergement (SvelteKit + tileserver-gl).
- [`docs/contribution.md`](docs/contribution.md) — ajouter un lieu et lier sa fiche Wikidata.
- [`docs/audit-oki.md`](docs/audit-oki.md) — audit qualité et doctrine OKI.

## Contributions

Les contributions sont les bienvenues ! Ajouter un lieu se fait par pull request (voir [`docs/contribution.md`](docs/contribution.md)).

## Historique

La version 1 (PHP, cartes des communes) a été remplacée par cette refonte en juillet 2026 ; elle reste disponible dans l'historique Git (`git log` avant le commit de refonte).

## Licence

Copyright (C) 2024-2026 Cédric Famibelle-Pronzola & ORGANISATION KA INTERNATIONALE (OKI)

Code sous licence **MIT** (voir [LICENSE](LICENSE)). Les photographies restent la propriété de leurs auteurs sous leurs licences Wikimedia Commons ; les images street-level Mapillary sont sous CC BY-SA 4.0 par leurs contributeurs (voir [`content/credits.md`](content/credits.md)) ; les extraits Wikipédia sont sous CC BY-SA 4.0.