Better Rivals FH6

Classements alternatifs pour Forza Horizon 6 : chaque classement isole une configuration exacte (même voiture, même classe, même transmission) pour que seul le pilotage fasse la différence.

Site : https://better-rivals-fh6.org

Fonctionnement

Forza (UDP « Sortie de données »)
   └─▶ Relais Windows (BetterRivals.exe, Python)
          ├─ POST /api/times          chrono → classements, notifications, objectifs
          ├─ POST /api/traces         trace du tour → coach, delta live, tour optimal
          ├─ POST /api/coach-reports  diagnostics de réglage → onglet Copilote
          └─ POST /api/torque-curves  courbe moteur (Banc moteur) → onglet Moteur

Le relais n'est pas dans ce dépôt (gitignoré, synchronisé à part). Les joueurs le téléchargent depuis /telecharger.

Stack

Next.js 16 (App Router) · React 19 · TypeScript · Tailwind CSS v4 · Supabase (Postgres, Auth, RLS, Realtime) · Vitest · Vercel (hébergement + cron).

Next.js 16 a des changements incompatibles avec les versions précédentes : la documentation de référence est celle embarquée dans node_modules/next/dist/docs/.

Démarrer en local

Prérequis : Node.js 20+ (LTS).

npm install
cp .env.example .env.local   # puis renseigner au minimum les 3 variables Supabase
npm run dev                  # http://localhost:3000

Toutes les variables sont documentées dans .env.example. Seules les variables Supabase sont obligatoires : e-mails (Resend), captcha (Turnstile), rate-limit partagé (Upstash), cron et Discord se désactivent proprement si leurs clés sont absentes.

Commandes

Commande	Rôle
npm run dev	Serveur de développement
npm run build	Build de production
npm run lint	ESLint — objectif 0 warning
npm run typecheck	tsc --noEmit
npm run test	Tests unitaires Vitest (lib/**/*.test.ts)

Organisation du code

Dossier	Contenu
app/	Pages (un page.tsx serveur + un *Client.tsx interactif) et routes API (app/api/)
components/	Composants partagés (carte du circuit, replay, navbar…)
lib/	Logique métier pure et testée (validation des chronos, coach, classements, notifications…)
hooks/	useAuth, usePlayer, usePreferences, useNotifications
supabase/migrations/	Schéma SQL versionné — appliqué à la main (voir son README)
types/	Types Supabase (database.types.ts)

Conventions détaillées (accès Supabase, format des temps, règles de lint…) : voir CLAUDE.md.

Base de données

Les migrations ne sont pas jouées automatiquement : chaque fichier de supabase/migrations/ s'applique dans Supabase → SQL Editor. Les fonctions RPC récentes ont un repli côté code, donc l'ordre déploiement / migration est libre ; le README des migrations indique comment vérifier ce qui est appliqué.

Déploiement

Vercel, à chaque push sur main. Le cron hebdomadaire (vercel.json) appelle /api/cron/weekly-recap le dimanche à 18 h UTC, protégé par CRON_SECRET.