AlloArbitre
Outil de désignation des arbitres pour le CD45. Next.js (App Router) +
TypeScript + Supabase (Postgres + Auth), via @supabase/supabase-js.
Fonctionnalités (V1)
- Liste des matchs filtrable par semaine, niveau de compétition et statut
- Vue dédiée "matchs incomplets"
- Fiche arbitre (niveau, club, adresse, contact, charge actuelle, n° de
licence, date de naissance, dates réglementaires : qualification, dossier
médical, recyclage)
- Algorithme de suggestion d'arbitres par match : filtre par niveau minimum
requis (table éditable dans "Admin niveaux"), exclusion des conflits
d'horaire, tri par équité (nombre de désignations croissant)
- Validation manuelle obligatoire : une désignation n'est jamais créée
automatiquement, toujours par un clic explicite sur une suggestion
- Authentification multi-utilisateurs via Supabase Auth (email + mot de passe)
- Import des matchs par fichier Excel (
/admin/import, réservé ADMIN) :
colonnes Équipe domicile / Équipe extérieur / Date / Heure / Lieu / Niveau,
avec alias reconnus (Equipe 1/Equipe 2, Salle, Code) pour être compatible
directement avec l'export "Recherche désignation" de FFBB Compet.
Idempotent - un match déjà présent (même date, mêmes équipes, même niveau)
est complété/mis à jour plutôt que dupliqué, donc le même fichier peut être
réimporté sans risque. Les niveaux de compétition inconnus sont créés
automatiquement.
- CRUD manuel des matchs (
/matchs/nouveau, /matchs/[id]/modifier) et des
arbitres (/arbitres/nouveau, /arbitres/[id]/modifier) : créer, modifier,
annuler/désactiver, supprimer
- Gestion des niveaux eux-mêmes (pas seulement leur correspondance) et des
comptes utilisateurs (
/admin/utilisateurs, réservé ADMIN)
- Indisponibilités des arbitres (période du/au sur la fiche arbitre) :
exclues automatiquement des suggestions de désignation
- Auto-désignation en lot (
/matchs/incomplets) : sélection de matchs via
cases à cocher, assigne directement la meilleure suggestion à chaque
créneau vacant sans écran de confirmation intermédiaire
- Règles de désignation (
src/lib/designation-rules.ts, page /reglement) :
quotas par arbitre (max 3 désignations/semaine, max 3/week-end) vérifiés
avant toute désignation (manuelle ou auto), avec pop-up d'alerte en cas de
blocage. Liste vouée à être complétée au fur et à mesure des règles du CD45
Volontairement non traité pour l'instant
- Pas de filtre de disponibilité des arbitres (table Disponibilités pas
encore fournie)
- La correspondance niveau de compétition -> niveau d'arbitre minimum est
une valeur par défaut construite pour ce projet ; à corriger via
"Admin niveaux" (réservé aux comptes ADMIN) si elle ne colle pas à la
grille réelle du CD45
Architecture des données
Le projet parle directement à Supabase via @supabase/supabase-js (pas
d'ORM). Deux clients :
src/lib/supabase/server.ts : client lié à la session du visiteur
(cookies), utilisé uniquement pour l'authentification (login/signup/
session Supabase Auth)src/lib/supabase/admin.ts : client "service_role", utilisé pour toutes
les données applicatives (matchs, arbitres, désignations...). Contourne
volontairement les policies RLS - l'autorisation (qui peut faire quoi)
est vérifiée par notre propre code (getCurrentUser() + rôle), jamais
par la base
supabase/schema.sql et supabase/seed.sql documentent le schéma et les
données de référence (déjà appliqués sur le projet). Ce ne sont pas des
migrations exécutées automatiquement : toute évolution de schéma se fait
en SQL direct sur le projet Supabase (dashboard > SQL editor, ou les
outils MCP Supabase), puis en mettant à jour supabase/schema.sql.
Authentification (Supabase Auth)
L'authentification passe entièrement par le service Auth natif de Supabase
(GoTrue), via @supabase/ssr. Deux pages : /login et /signup
(inscription libre, ouverte à qui a l'URL - pas de code d'invitation).
Un nouveau compte créé via /signup obtient le rôle REPARTITEUR par
défaut ; à évaluer si un contrôle d'accès plus strict devient nécessaire
(code d'invitation, validation manuelle...).
Table Profile (schéma public) : id = auth.users.id, email, name,
role (ADMIN ou REPARTITEUR, défaut REPARTITEUR). Un trigger Postgres
(handle_new_user, voir supabase/schema.sql) crée automatiquement la
ligne Profile à chaque nouvelle inscription dans auth.users, que ce
soit via /signup ou créée manuellement depuis le dashboard Supabase.
Créer un compte manuellement (alternative à /signup) : dashboard
Supabase > Authentication > Users > Add user (cocher "Auto Confirm User"
pour se connecter immédiatement sans email de confirmation).
Promouvoir un compte en ADMIN (accès à /admin/niveaux) :
UPDATE "Profile" SET role = 'ADMIN' WHERE email = '[email protected]';
Variables d'environnement
NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY : URL et clé
publique du projet Supabase (Project Settings > API)SUPABASE_SERVICE_ROLE_KEY : clé secrète (même page, section
"service_role") - ne jamais l'exposer côté client, uniquement utilisée
dans du code serveur (src/lib/supabase/admin.ts)GOOGLE_MAPS_API_KEY (optionnelle) : clé API Google Cloud avec la
Geocoding API activée. Sert à convertir l'adresse d'un arbitre et
l'adresse d'un gymnase en coordonnées GPS, pour prioriser les
suggestions par proximité et estimer la rémunération (40€/match +
0,35€/km aller-retour). Sans cette variable, l'app fonctionne
normalement, juste sans ce tri par distance ni cette estimation.
Piège fréquent en collant une valeur dans les Environment Variables de
Vercel : ne pas inclure les guillemets (le format .env en a, Vercel
non) - une URL du genre "https://...supabase.co" avec les guillemets
inclus est invalide et fait planter toutes les pages (500 générique). Le
code tente de nettoyer ça automatiquement (src/lib/supabase/env.ts),
mais autant coller la valeur propre dès le départ.
Démarrage
npm install
npm run dev
Créer ensuite un compte via /signup ou le dashboard Supabase (voir
section Authentification ci-dessus) pour pouvoir te connecter.
Déploiement
- Base de données + Auth : Supabase (déjà provisionné)
- Application : Vercel — connecter le repo GitHub, brancher sur
claude/referee-assignment-system-zy1i9t (ou main une fois mergé),
renseigner les trois variables d'environnement ci-dessus (cocher
Production + Preview pour chacune), puis déployer.
