# Bienvenue

# À quoi sert cette app

# À 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 d'usage typiques

- **Pendant une partie de Gloomhaven**, savoir si une figurine peut traverser une case piège sans subir les dégâts.
- **Avant de monter un deck Magic**, lui demander quelles cartes synergisent avec un thème (« propose-moi des elfes verts mana coût ≤ 3 »).
- **Sur Flesh and Blood**, coller ton decklist Fabrary depuis le presse-papier et lui demander d'analyser les couvertures de rôle.
- **Quand tu doutes** (« est-ce que cette extension change la règle de base sur X ? ») il te montre la règle d'origine ET la modification d'extension côte-à-côte.
- **Sur Lorcana**, lever le doute sur ce que fait exactement une carte sans avoir à fouiller dans une boîte.

## Ce qui le rend différent

- **Citations cliquables** : chaque réponse pointe vers la page exacte du PDF, ouverture en un clic.
- **Vision** : pour les questions visuelles (icônes, plateau, schémas), Claude lit la PNG de la page directement.
- **Multi-livret** : tu coches les extensions actives, l'oracle compose les règles base + ext + FAQ avec priorité explicite.
- **Mémoire conversationnelle** : les cartes citées au tour 1 restent dans le contexte au tour 5 (sticky mentions).
- **Self-hosted** : tout tourne sur ton Unraid, aucune donnée envoyée à un cloud tiers (sauf appels Claude via la VM oracle).

# Ce dont tu as besoin

# 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 navigateur récent** : Chromium / Firefox / Safari modernes. SSE + fetch streaming requis (compatible avec tous les navigateurs depuis 2023).
- **Connexion réseau** vers `https://rules.thymon.fr` (ou le LAN `192.168.10.x` si tu es sur le subnet local).

## Côté admin (toi)

- Accès SSH à l'Unraid pour redémarrer le container ou consulter les logs.
- Accès à l'instance Gitea (`gitea.thymon.fr`) pour pousser les builds.
- Connaissance des PDFs des règles que tu veux ingérer (ils restent sur le serveur, pas dans git).

## Côté infra (déjà en place sur ton Unraid)

- Container `boardgame-referee` (image Gitea registry)
- Container `qdrant` (vector DB)
- Containers TEI (`bge-m3` sur 8099 + reranker `bge-reranker-v2-m3` sur 8990) sur la RTX 3060
- VM SSH avec compte `oracle` qui exécute Claude Code CLI
- Reverse proxy NPM avec cert Let's Encrypt sur `rules.thymon.fr`