# JWE — Guide de contribution : ajouter un lieu

Le corpus de lieux vit dans `app/src/lib/server/data/lieux.json`, versionné dans Git. Ajouter un lieu = une pull request. La revue de PR sert de modération éditoriale (exactitude, crédits photo, licence).

## 1. Règles d'or d'un bon lieu

- **Photographiable et identifiable** : le lieu doit avoir une photo libre de qualité (Wikimedia Commons de préférence).
- **Localisé précisément** : coordonnées GPS au lieu près (le score Expert se joue à 1 km).
- **Éditorialement pertinent** : monument, paysage, lieu culturel, rue ordinaire… Le jeu mélange volontairement lieux célèbres et lieux du quotidien.
- **Lacunes assumées** : il est VOLONTAIRE d'inclure des lieux sans page Wikipédia (`wikidata_id: null`) — le jeu affiche alors un écran pédagogique « Pwen blindé » appelant à documenter le territoire. Mais c'est un choix, pas une négligence : vérifiez d'abord qu'aucune page/frwiki ni entité Wikidata n'existe.

## 2. Schéma du lieu

```json
{
  "id": "générez un uuid (uuidgen)",
  "nom": "Fort Delgrès",
  "nom_creole": "Fò Delgrès",
  "region": "GUADELOUPE | MARTINIQUE | GUYANE | REUNION",
  "commune": "Basse-Terre",
  "coordonnees": { "lat": 16.0036, "lon": -61.7319 },
  "categorie": "MONUMENT | LIEU",
  "difficulte": "FACILE | MOYEN | DIFFICILE | EXPERT",
  "wikidata_id": "Q3077840",
  "photo": {
    "url": "https://commons.wikimedia.org/wiki/Special:FilePath/FICHIER?width=1200",
    "credit": "© Auteur / Wikimedia Commons CC-BY-SA-4.0",
    "alt": "Description précise (sert d'alternative textuelle)"
  },
  "indices": [
    { "niveau": 1, "texte": "Indice doux" },
    { "niveau": 2, "texte": "Indice précis" }
  ]
}
```

## 3. Trouver et lier l'identifiant Wikidata

1. Cherchez le lieu sur https://www.wikidata.org
2. L'identifiant ressemble à `Q3077840`.
3. Vérifiez que l'entité a un lien vers une page **fr.wikipedia** (sitelink) — c'est ce qui permet au jeu d'afficher l'extrait de l'article :

```bash
curl -s "https://www.wikidata.org/w/api.php?action=wbgetentities&ids=Q3077840&props=sitelinks&format=json" | grep frwiki
```

4. **Si le lieu n'a ni page Wikipédia ni entité Wikidata** : mettez `"wikidata_id": null`. C'est une contribution précieuse : le jeu transforme la lacune en appel à contribution. Mieux encore : créez l'entité Wikidata vous-même, puis revenez renseigner l'ID !

## 4. Choisir la photo (licence obligatoire)

1. Cherchez sur https://commons.wikimedia.org une photo nette, paysage de préférence.
2. Licences acceptées : CC BY, CC BY-SA, CC0, domaine public. **Jamais** de « fair use ».
3. Vérifiez la licence et l'auteur via l'API :

```bash
curl -s "https://commons.wikimedia.org/w/api.php?action=query&titles=File:NOM_DU_FICHIER&prop=imageinfo&iiprop=url|extmetadata&format=json"
```

4. L'URL dans le JSON utilise `Special:FilePath` avec `?width=1200` (redimensionnement à la volée côté Wikimedia — pas besoin d'héberger l'image). Testez qu'elle renvoie bien 200.
5. Reportez le crédit exact (auteur + licence) dans `photo.credit` ET dans `content/credits.md`.

## 5. Valider avant la PR

```bash
cd app
node -e "const l=require('./src/lib/server/data/lieux.json');console.log(l.length,'lieux')"
npm run check
```

Checklist de revue :

- [ ] coordonnées cohérentes avec la commune déclarée
- [ ] `wikidata_id` vérifié (ou `null` justifié)
- [ ] licence photo CC vérifiée + crédit complet
- [ ] `alt` descriptif (accessibilité)
- [ ] 2 indices progressifs, sans donner la réponse
- [ ] `nom_creole` renseigné quand la forme créole est attestée (sinon, reprendre le nom français — ne pas inventer)

## 6. Contribuer à Wikipédia / Wikidata (au-delà du jeu)

Si vous ajoutez un lieu « Pwen blindé », envisagez de documenter le lieu vous-même :

- Créer un compte et un brouillon d'article : https://fr.wikipedia.org/wiki/Aide:Brouillon
- Créer une entité Wikidata : https://www.wikidata.org/wiki/Wikidata:Main_Page
- Contacter les groupes Wikimédia locaux (Wikimédia France, groupes antillais/guyanais/réunionnais).

Chaque entité créée enrichit Wikipédia, les cartes libres… et les futurs jeux comme JWE.
