Quiz expert énergie

Trois quiz chronométrés tirés du document « Quiz revus » du client : débutant, intermédiaire et expert, 10 questions chacun, 2 minutes au compte à rebours. Il reprend la stack et le langage visuel de brikelec : Nuxt 4, Baloo 2 et Nunito, couleurs CIPREL et techniciens guides (voir DESIGN.md).

npm install
npm run dev          # http://localhost:3000
npm run build        # build de production (.output)

Parcours

• Accueil : l'écran de choix. Les trois quiz sont indépendants, on commence par celui qu'on veut. Chaque quiz réussi met une partie du cycle combiné sous tension (turbine à gaz, chaudière et cycle eau-vapeur, alternateur et réseau). On y trouve aussi la jauge « Charge de la centrale », les récompenses et le classement.
• Partie classée : le compte à rebours part au premier écran de question et ne s'arrête pas. Chaque réponse est définitive, la correction détaillée arrive à la fin, avec un bouton Choisir un autre quiz qui ramène à l'accueil.
• Échec : si les 2 minutes s'écoulent avant la dernière question, l'écran « Temps écoulé : échec » s'affiche. La partie n'entre pas au classement.
• Points : 100 par bonne réponse, plus 2 par seconde restante au prorata des bonnes réponses (10/10 avec 45 s restantes : 1 090 points ; 5/10 avec 45 s restantes : 545). Le classement trie par points, puis bonnes réponses, durée et ancienneté.
• Repère de quiz : partout où un score s'affiche (classement, résultat, accueil), une pastille dit de quel quiz il s'agit : couleur, 1 à 3 barres et nom du niveau. Le classement a un onglet « Tous les quiz » et un onglet par quiz.
• Réviser mes erreurs (?revision=1) : seulement les questions ratées, sans chrono, corrigées une à une, hors classement.
• Partage :
  • page publique /resultat/<slug> (aperçu Open Graph, juste ou faux sans les réponses) ;
  • carte PNG ;
  • LinkedIn, WhatsApp, Facebook et X ;
  • lien « Défier un collègue » (/quiz/<id>?defi=<slug>), qui affiche le score à battre.
• Au clavier : flèches, A à D (ou 1 à 4) pour choisir, Entrée pour valider puis passer à la suite. La tentative en cours reprend après un rechargement.

Contenu

Fichier	Rôle
reference/quizzes-revus.docx	document source du client
scripts/extract-docx.mjs	npm run content:extract : lit le Word et écrit supabase/seed/quizzes.json. La bonne réponse est l'option cochée (✓ ou ✔), contrôlée contre la lettre de l'explication quand elle est donnée. Titres, sous-titres et durée (120 s) sont fixés dans le script.
scripts/build-seed.mjs	npm run content:seed : génère supabase/migrations/0002_quiz_seed.sql (rejouable)

Pour corriger un texte : modifier le Word, relancer les deux scripts, puis rejouer 0002_quiz_seed.sql.

Supabase

Projet yzgbqpmopzhjefyyrzzr, partagé avec brikelec (table scores) : tout ce qui concerne le quiz est préfixé quiz_. À faire une fois, dans l'éditeur SQL du projet :

1. supabase/migrations/0001_quiz.sql : tables, droits et fonctions.
2. supabase/migrations/0003_quiz_chrono.sql : durée des quiz, points, échec au temps écoulé.
3. supabase/migrations/0002_quiz_seed.sql : les 3 quiz et les 30 questions. Les quiz qui ne sont plus au questionnaire sont archivés (archived), pas supprimés : leurs tentatives et leurs liens de résultat restent.

Ordre de mise en ligne de la version web : appliquer 0003 puis 0002 avant de déployer le code. L'ancien code continue de fonctionner sur la base migrée, alors que le nouveau code a besoin des nouvelles colonnes. La borne, elle, n'utilise pas Supabase (stockage local).

Table	Contenu	Accès public
quiz_quizzes	les 3 quiz et leur durée	lecture
quiz_questions	énoncé, choix, corrigé, explication	lecture sans answer ni explanation (droits par colonne)
quiz_attempts	pseudo, points, bonnes réponses, niveau, durée, échec, lien de partage, jeton secret	lecture des parties terminées, classées et réussies, sans le jeton
quiz_answers	chaque réponse, juste ou fausse, et son temps	aucun

Aucune écriture directe : tout passe par des fonctions security definer qui valident côté base.

• quiz_start(quiz, pseudo, questions?) démarre une tentative (sous-ensemble de questions : révision hors classement).
• quiz_answer(tentative, jeton, question, choix, temps) enregistre une réponse (idempotente). Elle renvoie la correction en révision, et rien avant la fin en partie classée. Une partie classée refuse les réponses une fois le temps écoulé.
• quiz_finish(tentative, jeton) calcule les points, le niveau et le rang, crée le lien de partage et renvoie la correction. Une partie classée incomplète est un échec : 0 point, hors classement.
• quiz_result(slug) renvoie le résumé public d'un résultat.

L'API Nitro (server/api) relaie ces appels. La clé reste côté serveur.

Route	Rôle
GET /api/quizzes, GET /api/quizzes/:id	quiz et questions sans corrigé
POST /api/attempts, POST /api/attempts/:id/answer, POST /api/attempts/:id/finish	une tentative
GET /api/results/:slug	résultat partagé
GET /api/leaderboard?quiz=	classement

La progression (meilleurs scores, erreurs à réviser, récompenses, tentative en cours) est aussi gardée sur l'appareil, dans localStorage.

Variables d'environnement

Variable	Valeur
NUXT_SUPABASE_URL	https://yzgbqpmopzhjefyyrzzr.supabase.co
NUXT_SUPABASE_KEY	la clé publishable (sb_publishable_…), jamais la clé secrète
NUXT_PUBLIC_SITE_URL	l'adresse publique du quiz (liens de partage, Open Graph)

En local, elles vont dans .env (non versionné, voir .env.example). Sur Vercel, Nuxt est détecté automatiquement : il suffit de définir ces variables dans Project Settings → Environment Variables.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗