# Live Quiz ⚡ — V2.1
### Outil de Quiz Interactif en Classe

**Live Quiz** est une application web permettant aux enseignants d'organiser des quiz interactifs en salle de classe en temps réel, inspirée de la dynamique de Kahoot!. L'enseignant crée ou génère des questions via l'IA, ouvre une session et les élèves se connectent depuis leurs appareils pour répondre simultanément.

## 🚀 Fonctionnement Général

L'interface enseignant est organisée en **3 blocs verticaux** progressifs :

1. **Utiliser vos questions** : Générez des questions avec l'IA Albert en un clic, importez un CSV, chargez une banque prédéfinie, ou saisissez vos questions manuellement. Toutes les questions sont éditables, réordonnables par glisser-déposer et exportables en CSV.
2. **Choisir le Mode de jeu** : Mode *Classique* (élèves sur smartphone/PC) ou *Scan papier — Cardvote* (élèves lèvent des cartes imprimées, l'enseignant scanne la classe avec son téléphone).
3. **Lancer l'activité** : Cliquez sur **« Ouvrir la Classe »** pour créer une salle. Un code à 6 caractères et un QR code permettent aux élèves de rejoindre la session.

## 🛠️ Architecture Technique

Live Quiz repose sur une architecture entièrement côté client.

### 1. Frontend
-   **Langages** : HTML5, CSS3, JavaScript (Vanilla).
-   **Communication temps réel** : **PeerJS** (WebRTC) pour la communication directe entre l'enseignant (hôte) et les élèves (clients), sans serveur dédié.
-   **Rendu mathématique** : **MathJax** pour l'affichage des formules dans les questions.

### 2. Pages principales
-   **`index.html`** : Interface enseignant. Gestion des questions, options de partie, et contrôle du quiz en temps réel.
-   **`eleve.html`** : Interface élève. Connexion par code de salle, réponse aux questions, affichage du score.
-   **`cards.html`** : Impression des cartes A/B/C/D pour le mode Scan papier.
-   **`generateur_questions.html`** : Éditeur avancé de questions (CSV, saisie manuelle, IA).

### 3. Fonctionnalités principales

-   **Génération IA en un clic (Albert)** : Entrez un thème, un niveau (Primaire → Supérieur) et un nombre de questions — l'API Albert génère un QCM complet en quelques secondes.
-   **Génération guidée — IA externe** : Générez un prompt optimisé à copier/coller dans Mistral, Gemini, etc.
-   **Banques de questions prédéfinies** : Chargez des ensembles de questions prêts à l'emploi (Capitales, Histoire, Sciences…).
-   **Import/Export CSV** : Importez vos questions depuis un CSV (séparateur `;`). Un modèle téléchargeable est disponible. Exportez votre banque pour la réutiliser.
-   **Mode Scan papier — Cardvote** : Les élèves lèvent des cartes A/B/C/D imprimées. L'enseignant scanne la classe avec son téléphone. Les résultats (par carte/élève) s'affichent au projecteur en temps réel et sont exportables en CSV.
-   **Éditeur intégré** : Toutes les questions sont modifiables (titre, réponses, temps) via une fenêtre modale. Les questions peuvent être réordonnées par glisser-déposer ou dupliquées.
-   **Mode Équipes 👥** : Les élèves utilisant le même prénom voient leurs scores automatiquement cumulés.
-   **Mécaniques d'engagement** : Compteurs animés, podium Kahoot-style pour le Top 3, sons.
-   **Options flexibles** : Mélanger les questions, désactiver le minuteur, anonymiser le classement, bouton d'aide (SOS) élève.
-   **Accès rapide** : Les élèves rejoignent via un QR Code projeté ou un code à 6 caractères. Un code flottant reste affiché tout au long de la session.
-   **Formules mathématiques** : Les questions peuvent contenir du LaTeX (entouré de `$`, ex : `$\frac{x^2}{2}$`).

## 🔐 Sécurité & Confidentialité

-   **Aucun serveur** : Toute la communication se fait en pair à pair (WebRTC/PeerJS). Aucune donnée n'est stockée sur un serveur tiers.
-   **Aucun tracking** : Aucun cookie publicitaire ou de tracking n'est utilisé.
-   **IA souveraine** : La fonctionnalité « Générer avec Albert » utilise une infrastructure souveraine française.

## 🤖 Intégration Albert (IA souveraine)

Live Quiz intègre l'API **Albert**, une IA souveraine française, pour la génération automatique de questions. L'intégration est réalisée via un serveur intermédiaire **n8n** hébergé par l'Incubateur de l'Éducation nationale.

### Architecture du flux « Générer »

```
Navigateur (Live Quiz)      n8n (Incubateur ÉN)         API Albert
┌──────────────────┐    ┌──────────────────┐    ┌────────────────┐
│  Thème + Nombre   │───▶│ Clé API stockée  │───▶│ Génération des  │
│  de questions     │    │ côté serveur     │    │ questions QCM   │
│                   │◀───│                  │◀───│ (Mistral Small) │
│  Questions JSON   │    │                  │    │                │
└──────────────────┘    └──────────────────┘    └────────────────┘
```

-   **Protection de la clé API** : La clé d'accès Albert est stockée côté serveur dans n8n. Elle n'est jamais exposée dans le code source.
-   **Infrastructure souveraine** : Le serveur n8n est hébergé par l'Incubateur de l'Éducation nationale (`n8n.incubateur.education.gouv.fr`).

## ⚙️ Installation & Utilisation

Vous pouvez utiliser l'outil en ligne ici : [https://live-quiz.forge.apps.education.fr/](https://live-quiz.forge.apps.education.fr/)

Si vous souhaitez héberger l'outil vous-même :

1.  **Dépôt Source** : Retrouvez le code sur [la forge Éducation](https://forge.apps.education.fr/live-quiz/live-quiz.forge.apps.education.fr)
2.  **Téléchargement** : Clonez ou téléchargez le dépôt.
3.  **Hébergement** : Déployez les fichiers sur n'importe quel serveur web statique ou ouvrez `index.html` directement dans votre navigateur.
4.  **Utilisation** : Aucune configuration supplémentaire n'est nécessaire.

### Workflow typique :
1.  **Questions** : Entrez un thème et générez avec Albert, importez un CSV, ou chargez une banque prédéfinie.
2.  **Vérification** : Relisez et ajustez les questions dans le tableau éditable.
3.  **Mode** : Choisissez entre Classique et Scan papier, configurez les options.
4.  **Lancement** : Cliquez sur **« Ouvrir la Classe »** et partagez le code aux élèves.
5.  **Quiz** : Les élèves répondent en temps réel, suivez le classement.
6.  **Export** : Exportez les résultats si nécessaire.

## 📄 Licence

Ce projet est distribué sous la licence **GNU GPL v3.0 ou ultérieure**. Vous êtes libre de l'utiliser, de le modifier et de le distribuer, à condition de conserver la même licence pour les travaux dérivés.

---
*V2.1 — Développé par Vincent SCHOEFFTER & Gauthier REMANDE*
