Search Results

À quoi sert cette app Dernière mise à jour : 2026-05-10 Boardgame Referee est ton arbitre personnel pour les règles de jeux de société et de TCG. Tu lui poses une question en français, il répond en citant le passage exact du livret (avec page cliquable). Cas...

Ce dont tu as besoin Dernière mise à jour : 2026-05-10 Côté utilisateur Un compte : créé soit par toi en self-service (/register), soit invité par un admin. Les nouveaux comptes sont en statut pending jusqu'à ce qu'un admin les confirme depuis /admin. Un na...

L'oracle est en pause quota Dernière mise à jour : 2026-05-10 Symptômes Une ingestion en cours s'arrête net et passe en ingestStatus='scheduled' L'UI affiche un panneau "L'oracle se repose, reprise à HH:MM" Les questions /play peuvent renvoyer une erreur ou...

Réinitialiser un mot de passe Dernière mise à jour : 2026-05-10 Self-service (utilisateur) Pas implémenté pour l'instant — pas d'envoi de mail magic-link en self-service. Si tu oublies ton mot de passe, contacte un admin. Via admin (toi) Deux options : Optio...

Attacher un deck (FAB) Dernière mise à jour : 2026-05-10 Disponible uniquement sur Flesh and Blood pour l'instant (hasCardDatabase = 'flesh-and-blood-cards'). Workflow Sur Fabrary, ouvre ton deck → bouton "Copy as Text" Sur /play (jeu FAB sélectionné), cliq...

Citer une carte avec @ Dernière mise à jour : 2026-05-10 Sur les jeux qui ont une base de cartes (hasCardDatabase non-null en BDD), tu peux citer une carte directement dans ta question avec @. TCG supportés Magic: The Gathering (magic-cards) Disney Lorcana ...

Poser une question (flux classique) Dernière mise à jour : 2026-05-10 Étapes Va sur /play depuis le Home en cliquant sur un jeu. Coche les extensions actives dans le header (les non cochées sont ignorées par le retrieval). Tape ta question dans le composer ...

Accéder à l'app Dernière mise à jour : 2026-05-10 URLs Prod : https://rules.thymon.fr LAN direct (sans passer par NPM) : http://192.168.10.100:3000 — utile pour debug si NPM tombe Login Va sur /login. Username + password. Cookie de session valide 7 jours,...

Tour de l'interface Dernière mise à jour : 2026-05-10 Navigation Desktop : sidebar à gauche (NavSidebar.vue) Mobile : tab bar en bas (NavTabBar.vue) Pages principales Route But / (Home) Ludothèque visuelle : grille des jeux + bandeau "Reprendre la p...

ADR-001 : Hono plutôt qu'Express ou Fastify Date : 2026 (initial setup) — Statut : accepté Contexte Au moment de choisir le framework backend pour un projet TypeScript moderne avec : Streaming SSE intensif (RAG) Validation typée (Zod inline) Self-hosting (i...

ADR-002 : SQLite + Drizzle plutôt que Postgres Date : 2026 (initial setup) — Statut : accepté Contexte Stockage relationnel pour : users, games, questions, feedbacks. Volume attendu : <10K users, <100K questions sur la durée de vie du projet (usage perso + q...

ADR-003 : Claude via SSH plutôt qu'API Anthropic directe Date : 2026 (premiers tests RAG) — Statut : accepté Contexte L'app a besoin d'appeler Claude (Opus + Haiku) pour : génération RAG, HyDE, decompose-query, contextual retrieval, hierarchy LLM, conflict d...

ADR-004 : Vision inline (lue au moment Q) plutôt que pré-ingestion Date : 2026-04-11 — Statut : accepté Contexte Les règles de jeux contiennent souvent du contenu visuel important : icônes, schémas, plateau, tuiles, couleurs. Le retrieval texte seul rate ces...

ADR-005 : Fusion RRF v2 (pondération question×2 + blending position-aware) Date : 2026-Q1 — Statut : accepté Contexte Le retrieval combine plusieurs sources : Vecteur dense de la question brute (TEI bge-m3) Vecteur dense du passage HyDE (Haiku-généré) Spars...

ADR-006 : Repository pattern (Phase 2) Date : 2026-Q1 (Phase 2 refactoring) — Statut : accepté Contexte Au début du projet, les routes Hono importaient directement db et drizzle-orm : // routes/games.ts import { db } from '../db.js'; import { games } from '....

ADR-007 : Handlers MVC (Phase 4) Date : 2026-Q2 (Phase 4 refactoring) — Statut : en cours / accepté Contexte Avec le repo pattern (ADR-006), les routes étaient devenues plus propres : // routes/games.ts (avant Phase 4) app.post('/api/games/ingest', requireAu...

API REST Dernière mise à jour : 2026-05-10 34 endpoints, tous prefixés /api. Auth par cookie de session (HTTP-only). Validation Zod systématique. Auth Méthode Path Auth Description POST /api/auth/register Non Crée user (username, email, password). Has...

Architecture — Backend Dernière mise à jour : 2026-05-10 Couches src/ ├── routes/ # Contrats HTTP (Hono), validation Zod, auth ├── handlers/ # Logique métier pure (Phase 4 MVC) ├── services/ # Domaine RAG / Qdrant / TEI / Claude / c...