BoardGame Referee — Documentation technique
Doc dev/ops complète : architecture, pipeline RAG, TCG, déploiement, sécurité, ADRs.
ADRs
ADR-001 : Hono plutôt qu'Express ou Fastify
ADR-001 : Hono plutôt qu'Express ou Fastify Date : 2026 (initial setup) — Statut : accepté Cont...
ADR-002 : SQLite + Drizzle plutôt que Postgres
ADR-002 : SQLite + Drizzle plutôt que Postgres Date : 2026 (initial setup) — Statut : accepté C...
ADR-003 : Claude via SSH plutôt qu'API Anthropic directe
ADR-003 : Claude via SSH plutôt qu'API Anthropic directe Date : 2026 (premiers tests RAG) — Stat...
ADR-004 : Vision inline (lue au moment Q) plutôt que pré-ingestion
ADR-004 : Vision inline (lue au moment Q) plutôt que pré-ingestion Date : 2026-04-11 — Statut : ...
ADR-005 : Fusion RRF v2 (pondération question×2 + blending position-aware)
ADR-005 : Fusion RRF v2 (pondération question×2 + blending position-aware) Date : 2026-Q1 — Stat...
ADR-006 : Repository pattern (Phase 2)
ADR-006 : Repository pattern (Phase 2) Date : 2026-Q1 (Phase 2 refactoring) — Statut : accepté ...
ADR-007 : Handlers MVC (Phase 4)
ADR-007 : Handlers MVC (Phase 4) Date : 2026-Q2 (Phase 4 refactoring) — Statut : en cours / acce...
Architecture
API REST
API REST Dernière mise à jour : 2026-05-10 34 endpoints, tous prefixés /api. Auth par cookie de...
Architecture — Backend
Architecture — Backend Dernière mise à jour : 2026-05-10 Couches src/ ├── routes/ # C...
Architecture — Frontend
Architecture — Frontend Dernière mise à jour : 2026-05-10 Structure frontend/src/ ├── views/ ...
Intégrations externes
Intégrations externes Dernière mise à jour : 2026-05-10 Pour chaque service tiers : à quoi il s...
Modèle de données
Modèle de données Dernière mise à jour : 2026-05-10 SQLite (Drizzle ORM) Schéma : src/schema.ts...
Déploiement
Pipeline CI/CD (Gitea)
Pipeline CI/CD (Gitea) Dernière mise à jour : 2026-05-10 Workflow .gitea/workflows/build.yml 87...
Reverse proxy (Nginx Proxy Manager)
Reverse proxy (Nginx Proxy Manager) Dernière mise à jour : 2026-05-10 URL prod Public : https:...
Rollback
Rollback Dernière mise à jour : 2026-05-10 Stratégie La CI Gitea push 2 tags par build : lates...
Déploiement Unraid
Déploiement Unraid Dernière mise à jour : 2026-05-10 Architecture des containers unraid/ ├── Co...
Doctrine
Getting started
Données de test
Données de test Dernière mise à jour : 2026-05-10 Premier jeu de test L'app n'a pas de seed aut...
Prérequis
Prérequis Dernière mise à jour : 2026-05-10 Outils CLI Outil Version Notes Node.js 22.x ...
Setup local
Setup local Dernière mise à jour : 2026-05-10 Étapes # 1. Cloner git clone <gitea-url>/boardgam...
Variables d'environnement
Variables d'environnement Dernière mise à jour : 2026-05-10 Toutes les variables sont déclarées...
Glossaire
Maintenance
Backup et recovery
Backup et recovery Dernière mise à jour : 2026-05-10 ⚠️ À COMPLÉTER Aucune stratégie de backup ...
Mise à jour des dépendances
Mise à jour des dépendances Dernière mise à jour : 2026-05-10 Politique : manuel Pas de Renovat...
Logs
Logs Dernière mise à jour : 2026-05-10 Logger central Tous les logs serveur passent par src/lib...
Monitoring
Monitoring Dernière mise à jour : 2026-05-10 État actuel : minimal L'app expose un seul endpoin...
Troubleshooting
Troubleshooting Dernière mise à jour : 2026-05-10 Pièges connus déjà rencontrés, à actualiser a...
Pipeline RAG
Mode deckbuilding
Mode deckbuilding Dernière mise à jour : 2026-05-10 Depuis 2026-04-24 (Axe 2 Phase 1), un 4e in...
Flux d'ingestion (PDF → Qdrant)
Flux d'ingestion (PDF → Qdrant) Dernière mise à jour : 2026-05-10 Source de vérité : ARCHITECTU...
Flux d'une question (RAG complet)
Flux d'une question (RAG complet) Dernière mise à jour : 2026-05-10 Source de vérité : ARCHITEC...
Pause / reprise après quota Claude
Pause / reprise après quota Claude Dernière mise à jour : 2026-05-10 Le compte Claude utilisé p...
Vision inline (Claude lit les PNG au moment Q)
Vision inline (Claude lit les PNG au moment Q) Dernière mise à jour : 2026-05-10 Depuis 2026-04...
Sécurité
Modèle d'authentification
Modèle d'authentification Dernière mise à jour : 2026-05-10 Mécanisme Mots de passe : hashés a...
Gestion des secrets
Gestion des secrets Dernière mise à jour : 2026-05-10 Inventaire des secrets Secret Stocké o...
Verrouillage SSH Oracle
Verrouillage SSH Oracle Dernière mise à jour : 2026-05-10 L'appel à Claude Code se fait via SSH...
Surface d'exposition
Surface d'exposition Dernière mise à jour : 2026-05-10 Endpoints publics vs internes Public (vi...
TCG integrations
Ajouter un nouveau TCG
Ajouter un nouveau TCG Dernière mise à jour : 2026-05-10 ⭐ Page critique — procédure complète p...
Aperçu des TCG supportés
Aperçu des TCG supportés Dernière mise à jour : 2026-05-10 6 TCG intégrés. Chaque TCG a une pag...
Ark Nova
Ark Nova Dernière mise à jour : 2026-05-10 Jeu de société (zoo), pas un TCG. Traité avec base d...
Disney Lorcana
Disney Lorcana Dernière mise à jour : 2026-05-10 Source LorcanaJSON.org : https://github.com/L...
Flesh and Blood (FAB)
Flesh and Blood (FAB) Dernière mise à jour : 2026-05-10 Source Package npm : @flesh-and-blood/...
Magic: The Gathering
Magic: The Gathering Dernière mise à jour : 2026-05-10 Source Bulk Scryfall : https://api.scry...
Mettre à jour les cartes d'un TCG
Mettre à jour les cartes d'un TCG Dernière mise à jour : 2026-05-11 ⭐ Page critique — workflow ...
Riftbound
Riftbound Dernière mise à jour : 2026-05-10 TCG Riot Games (univers League of Legends). Source ...
Terraforming Mars
Terraforming Mars Dernière mise à jour : 2026-05-10 Pas un TCG au sens strict (jeu de société a...
Vue d'ensemble
Choix structurants
Choix structurants Dernière mise à jour : 2026-05-10 Liste rapide des décisions d'architecture ...
Présentation du projet
Présentation du projet Dernière mise à jour : 2026-05-10 But Webapp RAG (Retrieval-Augmented Ge...
Schéma d'architecture
Schéma d'architecture Dernière mise à jour : 2026-05-10 Vue containers flowchart LR User[Ut...
Stack technique
Stack technique Dernière mise à jour : 2026-05-10 Runtime Composant Version Rôle Node.js...