Developers
Setup
MongoDB (collection database)
podman volume create mongo_data
podman run -d -it --rm \
-p 27017:27017 \
-v mongo_data:/data/db \
--name mongo \
mongo
- Poser les index (idempotent, rien n'est jamais supprimé ; la base visée est celle de
MONGODB_URI) :
npm run indexes # crée ce qui manque
npm run indexes -- --dry-run # liste ce qui serait créé, sans rien écrire
Les index sont déclarés dans lib/db/indexes/, chacun avec la requête qu'il sert.
Thème Hivernal 🎄❄️
L'application supporte un thème hivernal festif avec décorations de Noël et d'hiver.
Pour activer le thème hivernal, définissez la variable d'environnement :
NEXT_PUBLIC_THEME=winter
Consultez la documentation complète : docs/WINTER_THEME.md
Pour voir une démo du thème : /winter-demo
Fonctionnalités
Historique des Parties
Les utilisateurs peuvent enregistrer et consulter l'historique de leurs parties jouées, avec ou sans compte pour les autres participants (joueurs invités).
Pour plus de détails, voir docs/GAME_MATCHES.md.
Rapports de bataille (jeux de figurines)
Les parties des jeux qui l'activent se saisissent en rapport de bataille : liste d'armée de chaque joueur (avec autocomplétion des figurines du catalogue), scénario joué, fiche de notes libres, et une table de jeu vue de dessus où l'on pose décor et unités, instant par instant.
Pour plus de détails, voir docs/BATTLE_REPORTS.md.
Signalement de contenus
Les utilisateurs connectés peuvent signaler les contenus créés par d'autres utilisateurs (bouton drapeau). Les administrateurs les traitent depuis /admin/reports.
Pour plus de détails, voir docs/REPORTS.md.
Abonnements
Trois offres adossées à Patreon — Supporter, Joutes Expert et Joutes Pro —
débloquent des fonctionnalités supplémentaires, aux joueurs d'un côté, aux
organisateurs de l'autre. Patreon reste la source de vérité : on n'en garde
qu'une projection recalculée, si bien qu'un abonnement qui s'arrête éteint ses
droits sans qu'aucune révocation ne tourne.
Pour plus de détails, voir docs/SUBSCRIPTIONS.md.
Erratas
Tout utilisateur connecté peut créer un errata ; chacun ne peut modifier ou supprimer que les siens, sauf permission erratas:manage.
Pour plus de détails, voir docs/ERRATAS.md.
Collection de produits (jeux de figurines)
Les jeux qui ne se jouent pas avec des cartes ont leur propre catalogue : boîtes, figurines et accessoires, gérés depuis /admin/products et activés par la fonctionnalité « Produits » de la fiche du jeu. Une boîte déclare ce qu'elle contient ; l'ajouter à sa collection y verse ses figurines, et une boîte dont on possède déjà tout le contenu est signalée comme telle.
Pour plus de détails, voir docs/COLLECTION_PRODUCTS.md.
Foil et variantes d'impression
Une carte peut être marquée « toujours foil » et porter une liste de variantes d'impression (promo pack, pre-release, judge…), avec une image propre optionnelle.
Pour plus de détails, voir docs/CARD_PRINTINGS.md.
Outils du site pour les agents IA (WebMCP)
Toutes les pages déclarent au navigateur, via WebMCP, les actions principales de Joutes : recherche globale, catalogue de cartes d'un jeu, événements, lieux de jeu, ouverture d'une page. Un agent qui ouvre le site s'en sert avec la session de l'utilisateur, au lieu de simuler des clics.
Pour plus de détails, voir docs/WEBMCP.md.
Documents d'export hors ligne
Chaque jeu expose un document JSON (cartes, erratas, policies, règles) que les clients téléchargent pour fonctionner hors ligne. Il est généré en flux, une génération à la fois par jeu.
Pour plus de détails, voir docs/GAME_EXPORTS.md.
Import d'une actualité depuis un site extérieur
Une actualité peut être reprise d'un article publié ailleurs — la FAQ d'une sortie sur le site officiel, par exemple — en gardant sa mise en page et ses images, avec les noms de cartes mis en forme comme ailleurs sur Joutes. La source est citée et liée sur l'actualité.
Pour plus de détails, voir docs/NEWS_IMPORT.md.
Réseaux d'un éditeur sur la fiche de son jeu
Un jeu peut republier ce que publient les comptes de son éditeur : deux fois par
jour, Joutes sonde son compte Bluesky et sa chaîne YouTube, et affiche leurs
dernières publications, vidéos et shorts en grille — sur la fiche du jeu et sur
sa page « Réseaux ». Un administrateur peut masquer une publication, et le
masquage survit aux tours suivants.
Pour plus de détails, voir docs/GAME_SOCIAL.md.
Liens des éditeurs et directs sur la fiche d'un jeu
La fiche d'un jeu porte le site officiel de son éditeur et ses réseaux, saisis
depuis /admin/games. Le lien YouTube fait en plus autre chose qu'ouvrir une
page : un sondage horaire y détecte les directs, qui s'affichent alors en grand
en tête de la fiche et dans le bandeau des directs de l'accueil pour qui suit ce
jeu.
Pour plus de détails, voir docs/GAME_LIVES.md.
Traduction des actualités
Une actualité est écrite dans une langue et peut être traduite dans les autres. /news/:newsId la sert dans la langue de l'interface du lecteur ; /news/:newsId/:lang sert une langue précise, et chacune a donc son adresse partageable.
Pour plus de détails, voir docs/NEWS_TRANSLATIONS.md.
