jwe_ynh 2.0.0~ynh1 — paquet YunoHost initial (format v2, helpers 2.1)

doc/ADMIN.md

@@ -0,0 +1,17 @@
+### Configuration
+
+The app configuration lives in `/var/www/__APP__/app/.env` (regenerated on upgrade and URL change):
+
+- `PUBLIC_MAPILLARY_TOKEN` — Mapillary client token for the street mode *An lari a*. Get a free token on <https://www.mapillary.com/dashboard/developers>. Without it, the other 4 modes work normally.
+- `PUBLIC_TILES_URL` — optional URL of a self-hosted tileserver-gl `style.json`. Empty = default OpenFreeMap style. See the [deployment guide](https://labola.o-k-i.net/ORGANISATION-KA-INTERNATIONALE/JWE/src/branch/master/docs/deploiement.md) for hosting your own OSM tiles.
+
+After editing the file manually, restart the service: `systemctl restart __APP__`.
+
+### Logs and service
+
+- Service: `systemctl status __APP__`
+- Logs: `/var/log/__APP__/__APP__.log` or `journalctl -u __APP__`
+
+### Adding places to the game corpus
+
+The location corpus is embedded in the build: adding places (see `docs/contribution.md` upstream) requires pushing to the upstream repository, then upgrading the app (`yunohost app upgrade __APP__`).

doc/ADMIN_fr.md

@@ -0,0 +1,17 @@
+### Configuration
+
+La configuration de l'app se trouve dans `/var/www/__APP__/app/.env` (régénéré à chaque mise à jour ou changement d'URL) :
+
+- `PUBLIC_MAPILLARY_TOKEN` — token client Mapillary pour le mode street *An lari a*. Token gratuit obtenu sur <https://www.mapillary.com/dashboard/developers>. Sans lui, les 4 autres modes fonctionnent normalement.
+- `PUBLIC_TILES_URL` — URL optionnelle d'un `style.json` tileserver-gl auto-hébergé. Vide = style OpenFreeMap par défaut. Voir le [guide de déploiement](https://labola.o-k-i.net/ORGANISATION-KA-INTERNATIONALE/JWE/src/branch/master/docs/deploiement.md) pour héberger vos propres tiles OSM.
+
+Après une modification manuelle du fichier, redémarrer le service : `systemctl restart __APP__`.
+
+### Logs et service
+
+- Service : `systemctl status __APP__`
+- Logs : `/var/log/__APP__/__APP__.log` ou `journalctl -u __APP__`
+
+### Ajouter des lieux au corpus
+
+Le corpus de lieux est embarqué dans le build : l'ajout de lieux (voir `docs/contribution.md` upstream) demande de pousser sur le dépôt upstream, puis de mettre à jour l'app (`yunohost app upgrade __APP__`).

doc/DESCRIPTION.md

@@ -0,0 +1,8 @@
+JWE is a sovereign, GeoGuessr-like geolocation game focused on four overseas regions: **Guadeloupe, Martinique, Guyane and La Réunion**. The player sees a photo of a place — or navigates a street in the Mapillary viewer (*An lari a* mode) — and drops a pin on a map to guess the municipality, then discovers an educational Wikipedia/Wikidata factsheet… or a call for contributions when the place is undocumented (*Pwen blindé*).
+
+### Features
+
+- **Sovereign**: no Google, no Mapbox — MapLibre + free tiles, Wikipedia/Wikidata, self-hostable on a small server. (Documented exception: the *An lari a* street mode uses the Mapillary viewer, CC BY-SA 4.0 images, free client token.)
+- **Ethical**: no accounts, no leaderboard, no dopaminergic mechanics.
+- **Bilingual**: French / Creole.
+- **5 game modes**: Konnèt moniman, Kote mwen ye ?, Défi 5 rounds, Aprann (explore), An lari a (street-level Mapillary).

doc/DESCRIPTION_fr.md

@@ -0,0 +1,8 @@
+JWE est un jeu de géolocalisation souverain, dans l'esprit de GeoGuessr, centré sur 4 régions : **Guadeloupe, Martinique, Guyane, La Réunion**. Le joueur voit une photo unique d'un lieu — ou navigue dans une rue en visionneuse Mapillary (mode *An lari a*) — 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é (*Pwen blindé*).
+
+### Fonctionnalités
+
+- **Souverain** : zéro Google, zéro Mapbox — MapLibre + tiles libres, Wikipédia/Wikidata, auto-hébergeable sur un petit serveur. (Exception documentée : le mode street *An lari a* utilise la visionneuse Mapillary, images CC BY-SA 4.0, token client gratuit.)
+- **Éthique** : pas de comptes, pas de leaderboard, pas de mécanique dopaminergique.
+- **Bilingue** : français / créole.
+- **5 modes de jeu** : Konnèt moniman, Kote mwen ye ?, Défi 5 rounds, Aprann (explorer), An lari a (street-level Mapillary).

doc/POST_INSTALL.md

@@ -0,0 +1,3 @@
+JWE is installed and available at https://__DOMAIN__
+
+If you did not provide a Mapillary token, the street mode « An lari a » will show as unavailable — the 4 other modes work. You can add the token later in `/var/www/__APP__/app/.env` (then `systemctl restart __APP__`).

doc/POST_INSTALL_fr.md

@@ -0,0 +1,3 @@
+JWE est installé et accessible sur https://__DOMAIN__
+
+Si vous n'avez pas fourni de token Mapillary, le mode street « An lari a » affichera un message d'indisponibilité — les 4 autres modes fonctionnent. Vous pouvez ajouter le token plus tard dans `/var/www/__APP__/app/.env` (puis `systemctl restart __APP__`).