README.md

🥭 Mango

Le QCM qui se corrige tout seul

Assistant, JSON ou IA • Copies avec QR • Correction instantanée • Tableau de bord professeur

---

✨ Fonctionnalités

• 3 modes de création de QCM
  • Assistant (Wizard) guidé et ergonomique
  • Éditeur JSON pour utilisateurs avancés
  • Génération par IA (jusqu’à 20 questions) qui remplit automatiquement l’assistant
• Impression prête à l’emploi avec QR code, ordre des questions/réponses mélangé et table de conversion
• Correction instantanée côté élève (saisie d’un code 1–4 par question, note sur 20, explications)
• Espace Professeur avec analyses avancées (moyenne, médiane, écart‑type, distribution, per‑question, « questions à retravailler ») et export CSV
• Respect de la vie privée (copies anonymes par UID)

🧭 Parcours type

1. Créer un QCM (Assistant/JSON/IA) via create.php
2. Générer et imprimer les copies (QR inclus) depuis l’écran de confirmation
3. Les élèves scannent le QR (lien vers qcm.php) et saisissent leur code de réponses
4. Le professeur consulte les résultats et les statistiques via prof.php avec son Code Professeur

🧩 Format JSON attendu

Chaque question doit avoir exactement 4 choix, une bonne réponse (qui figure parmi les 4) et une explication (recommandée).

[
	{
		"question": "Quel est le plus grand océan de la Terre ?",
		"choices": [
			"Océan Atlantique",
			"Océan Pacifique",
			"Océan Indien",
			"Océan Arctique"
		],
		"correct_answer": "Océan Pacifique",
		"explanation": "Le Pacifique couvre environ 165 millions de km²."
	}
]

🔒 Confidentialité & RGPD

• Pas de données personnelles requises pour l’impression
• Copies anonymes via identifiants uniques