Search Results

Architecture — Frontend Dernière mise à jour : 2026-05-10 Structure frontend/src/ ├── views/ # 15 pages routables (LoginView, PlayView, AdminView, etc.) ├── components/ # ~50 composants Vue, par domaine │ ├── admin/ # AdminGamesS...

Intégrations externes Dernière mise à jour : 2026-05-10 Pour chaque service tiers : à quoi il sert, endpoints consommés, où sont les credentials, quel est le mode dégradé. Qdrant Rôle : Vector DB. Une collection par jeu (rules_<slug>) + une par TCG (magic-c...

Modèle de données Dernière mise à jour : 2026-05-10 SQLite (Drizzle ORM) Schéma : src/schema.ts. Migrations : migrations/*.sql + meta JSON. Diagramme entité-relation erDiagram users ||--o{ games : "addedBy" users ||--o{ questions : "userId" games...

Pipeline CI/CD (Gitea) Dernière mise à jour : 2026-05-10 Workflow .gitea/workflows/build.yml 87 lignes. Trigger : push sur main. Job test Runner : ubuntu-latest Container : node:22-bookworm-slim Pourquoi container custom : Alpine (musl libc) ne supporte pas...

Reverse proxy (Nginx Proxy Manager) Dernière mise à jour : 2026-05-10 URL prod Public : https://rules.thymon.fr LAN direct : http://192.168.10.100:3000 (utile pour debug si NPM tombe — dans la limite du CORS_ORIGIN configuré) Config NPM Côté UI NPM (pas da...

Rollback Dernière mise à jour : 2026-05-10 Stratégie La CI Gitea push 2 tags par build : latest (mutable, suit toujours le dernier commit main) sha-<7chars> (immuable) Pour revenir à une version antérieure : pull et utilise un tag sha-<7chars>. Étapes 1. I...

Déploiement Unraid Dernière mise à jour : 2026-05-10 Architecture des containers unraid/ ├── Container `boardgame-referee` (image gitea.thymon.fr/thymon/boardgame-referee:latest) ├── Container `qdrant` (image qdrant/qdrant) ├── Container TEI (text-embeddings...

Conventions de code Dernière mise à jour : 2026-05-10 Source de vérité : CONTRIBUTING.md. Cette page reformule les règles structurantes. Règles d'or backend 1. Logger central uniquement Tout log passe par src/lib/logger.ts Aucun console.* dans src/ (sauf sr...

Tests Dernière mise à jour : 2026-05-10 Deux types de tests, complémentaires : Vitest unitaires : déterministes, détectent les régressions silencieuses Banc d'éval RAG : qualité subjective de l'oracle (judge Haiku) Vitest unitaires Périmètre Toute fonctio...

Données de test Dernière mise à jour : 2026-05-10 Premier jeu de test L'app n'a pas de seed automatique. Pour avoir des données de test : Login avec le premier admin (FIRST_ADMIN_USERNAME / FIRST_ADMIN_PASSWORD) /add-game → ajouter un PDF de règles court (5...

Prérequis Dernière mise à jour : 2026-05-10 Outils CLI Outil Version Notes Node.js 22.x (node:22-bookworm-slim en CI/prod) Pas Alpine — better-sqlite3 n'a pas de prebuilt musl npm 10.x (vient avec Node 22) Docker 24+ Pour docker compose up qdrant...

Setup local Dernière mise à jour : 2026-05-10 Étapes # 1. Cloner git clone <gitea-url>/boardgame-referee.git cd boardgame-referee # 2. Configurer l'env cp .env.example .env # Éditer .env (cf. variables-environnement.md pour la liste complète) # 3. Installe...

Variables d'environnement Dernière mise à jour : 2026-05-10 Toutes les variables sont déclarées dans src/config.ts (Zod schema avec validation au boot). Le fichier .env.example les documente avec commentaires. Aucune variable ne doit apparaître ailleurs que ...

Glossaire Dernière mise à jour : 2026-05-10 A ADR (Architecture Decision Record) : note courte qui documente une décision d'architecture (contexte, décision, conséquences). Voir le chapitre Adrs. Anchor cards : cartes obligatoires dans une decklist (mode dec...

Backup et recovery Dernière mise à jour : 2026-05-10 ⚠️ À COMPLÉTER Aucune stratégie de backup applicative n'est implémentée dans le code (pas de script scripts/backup.sh, pas de cron dans src/cron/, pas de doc dans ARCHITECTURE.md / CONTRIBUTING.md). La pro...

Mise à jour des dépendances Dernière mise à jour : 2026-05-10 Politique : manuel Pas de Renovate / Dependabot configurés. Mises à jour manuelles, en bloc, quand tu en as envie. Pourquoi pas Renovate ? Volume de PR auto trop élevé sur un projet d'un seul mai...

Logs Dernière mise à jour : 2026-05-10 Logger central Tous les logs serveur passent par src/lib/logger.ts. Conventions : Aucun console.* dans src/ (sauf src/config.ts qui boot avant le logger) Préfixer le scope : logger.info('[meta-sync] ...'), logger.error...

Monitoring Dernière mise à jour : 2026-05-10 État actuel : minimal L'app expose un seul endpoint health, qui sert au healthcheck Docker. Pas de Prometheus / Grafana / OpenTelemetry / Sentry actuellement. GET /api/health { "status": "ok", "timestamp": "20...