Bingo AE2V

Application Web du bingo humain AE2V pour la soirée d’intégration du 17 septembre 2026, prévue pour https://bingo.ae2v.fr.

Fonctionnalités livrées

• interface joueur mobile-first : inscription, grille 4×4, scan QR, saisie manuelle, code tournant, règles, progression et résultats ;
• reprise réseau : App Shell en cache, validation conservée dans IndexedDB et renvoyée automatiquement ;
• premier bingo complet attribué dans une transaction PostgreSQL ;
• tirage pondéré par lignes/colonnes, nombre de gagnants et lots configurables ;
• interface admin mobile et bureau : DÉMARRER, TERMINER, RESET, recherche, réinitialisation d’appareil, score de suspicion et tirage ;
• affichage public limité aux prénoms, noms complets réservés à l’administration ;
• cookies de session HttpOnly, limitation de débit, en-têtes de sécurité et audit des actions sensibles.

La direction visuelle et les captures de repérage sont dans docs/STRATEGIE_GRAPHIQUE.md.

Lancer en local

Prérequis : Node 22+, Docker Desktop.

Windows — lancement automatique

Double-cliquer sur lancer-local.bat. Le lanceur :

• démarre Docker Desktop si nécessaire ;
• démarre PostgreSQL et attend qu’il soit prêt ;
• crée .env et installe les dépendances au premier lancement ;
• applique les migrations et charge les 31 cases ;
• lance les serveurs puis ouvre automatiquement le navigateur.

Lancement manuel

docker compose up -d db
cp .env.example .env
npm install
npm run db:migrate
npm run db:seed
npm run dev

• joueur : http://localhost:5173
• admin : http://localhost:5173/admin
• mot de passe d’exemple local : exemplemdp

Déployer sur bingo.ae2v.fr

1. Faire pointer l’enregistrement DNS A de bingo.ae2v.fr vers le serveur.
2. Copier .env.production.example vers .env et remplacer toutes les valeurs.
3. Démarrer la pile :

docker compose -f docker-compose.prod.yml up -d --build

Caddy obtient et renouvelle automatiquement le certificat TLS. Remplacez le mot de passe d’exemple et les secrets cryptographiques avant toute mise en production hors Vercel.

Commandes de contrôle

npm test
npm run build
npm audit --omit=dev
docker compose ps

Procédure événement

1. Ouvrir /admin, régler les lots et le nombre de gagnants.
2. Laisser les participants créer leur grille.
3. Appuyer sur Démarrer pour autoriser les validations.
4. À la fin, appuyer sur Terminer, puis Lancer le tirage.
5. Utiliser Reset uniquement pour repartir de zéro ; la confirmation exacte RESET BINGO est exigée.