⌨️ Clav'Master - Dactylographie Interactive & Ludique

Clav'Master est une application web moderne, fluide et entièrement gratuite conçue pour apprendre et maîtriser la dactylographie au clavier à 10 doigts.

Elle combine un guide visuel réactif du clavier et des mains en SVG, des tests de vitesse, des dictées vocales, un jeu d'arcade d'entraînement et un système complet de gamification avec sauvegarde automatique en LocalStorage.

---

🌟 Fonctionnalités Principales

• 🖐️ Guide Visuel Réactif des Mains & Clavier (SVG) :
  • Surbrillance en temps réel de la touche suivante à presser.
  • Code couleur distinctif par doigt (Auriculaire, Annulaire, Majeur, Index, Pouces).
  • Mains vectorielles (SVG) indiquant visuellement quel doigt utiliser.
• ⌨️ Support Multi-Dispositions :
  • AZERTY PC (France)
  • AZERTY Mac  (France avec touches ⌘ cmd, ⌥ opt, @, #)
  • QWERTY US (International)
• 🎯 5 Modes d'Exercice Ludiques :
  1. Leçons de Positionnement : Exercices progressifs de la ligne de repos aux majuscules.
  2. Sprint & Test de Vitesse : Chrono 30s, 60s, 120s avec calcul direct des WPM (Mots/Min), CPM et précision.
  3. Dictée Vocale : Utilisation de la synthèse vocale (SpeechSynthesis API) pour taper ce que l'on entend.
  4. Jeu d'Arcade "Pluie de Mots" : Mini-jeu avec système de combos et de vies pour détruire les mots néon qui tombent du ciel.
  5. Tableau de Bord & Stats : Graphiques Canvas d'évolution du WPM et carte thermique de précision par doigt.
• 🏆 Gamification & Progression (LocalStorage) :
  • Système de niveau et d'expérience (XP).
  • 8 Badges et succès à débloquer.
  • Sauvegarde locale 100% privée sans besoin de création de compte.
• 🔊 Moteur Audio Synthétisé (Web Audio API) :
  • Reproduction du son de switchs mécaniques (Cherry MX Blue), machine à écrire vintage ou zaps sci-fi sans aucun fichier audio externe.
• 🌙 Thème Sombre & Clair : Interface glassmorphic néon avec basculement en un clic.

---

🚀 Prise en main rapide (Aucun serveur requis !)

L'application est construite en HTML, CSS et JavaScript pur sans aucune dépendance npm ni serveur backend nécessaire.

Option A : Ouverture Directe (Recommandé)

1. Téléchargez ou clonez le dépôt :

   git clone https://github.com/votre-compte/clavmaster.git

2. Double-cliquez directement sur le fichier index.html dans votre explorateur de fichiers (Finder Mac / Explorateur Windows).

Option B : Via un serveur HTTP local (Optionnel)

python3 -m http.server 8000

Puis ouvrez http://localhost:8000 dans votre navigateur.

---

📁 Structure du Projet

typewriter/
├── index.html            # Application SPA principale
├── css/
│   └── styles.css        # Design system, glassmorphism, animations & styles clavier/mains
├── js/
│   ├── app.js            # Bundle JS autonome (gestion des touches mortes, storage, modes)
│   ├── keyboard.js       # Layouts AZERTY / MAC AZERTY / QWERTY & visualiseur des mains
│   ├── audio.js          # Moteur son Web Audio API
│   ├── speech.js         # Moteur de synthèse vocale pour les dictées
│   ├── storage.js        # Gestion du LocalStorage & Profil utilisateur
│   ├── stats.js          # Graphiques Canvas (WPM & précision des doigts)
│   └── modes/
│       ├── lessons.js    # Contrôleur des leçons
│       ├── speedtest.js  # Contrôleur des tests de vitesse WPM
│       ├── dictation.js  # Contrôleur des dictées vocales
│       └── arcade.js     # Contrôleur du jeu d'arcade
└── dns/                  # Configuration BIND9 pour hébergement DNS dédié

---

💻 Compatibilité Navigateurs

Navigateur	Version Recommandée	Support Web Speech / Audio
Google Chrome	80+	✅ 100%
Apple Safari	13+	✅ 100%
Mozilla Firefox	75+	✅ 100%
Microsoft Edge	80+	✅ 100%

---

📄 Licence

Ce projet est sous licence MIT - vous êtes libre de l'utiliser, le modifier et le redistribuer.