# Class Generator 2.0 - Système d'apprentissage

## Vision & Mission
Plateforme éducative interactive pour l'apprentissage des langues (principalement anglais/chinois) destinée aux enfants de 8-9 ans. Le projet a été entièrement réécrit avec une architecture ultra-modulaire en vanilla JavaScript.

## Architecture Ultra-Modulaire (Révolutionnaire)

### Principes Fondamentaux NON-NÉGOCIABLES
- Responsabilité Inviolable - Chaque module a exactement un rôle
- Zéro Dépendance Directe - Communication uniquement via EventBus
- Instances Scellées - Modules non-modifiables après création (Object.seal)
- État Privé - Données internes cachées via WeakMap
- Injection de Dépendances - Aucune variable globale
- Contrats Forcés - Méthodes abstraites obligatoires

### Core System (Terminé ✅)
```
src/core/
├── Module.js         # Classe abstraite base avec WeakMap privates
├── EventBus.js       # Système d'événements strict avec validation
├── ModuleLoader.js   # Injection de dépendances avec ordre d'initialisation
├── Router.js         # Navigation avec guards et middleware
└── Application.js    # Auto-bootstrap avec gestion du cycle de vie
```

## Système de Jeux (14 Modules Convertis)

### Jeux Disponibles
1. **StoryReader** - Lecture d'histoires avec chapitres
2. **LetterDiscovery** - Apprentissage lettres en 3 phases
3. **QuizGame** - Quiz bidirectionnel avec scoring
4. **WordStorm** - Action game avec mots tombants
5. **AdventureReader** - RPG interactif
6. **WhackAMole** - Tape-taupe standard
7. **WhackAMoleHard** - Version difficile (3 taupes simultanées)
8. **WizardSpellCaster** - Lanceur de sorts magiques
9. **WordDiscovery** - Découverte de vocabulaire
10. **GrammarDiscovery** - 8 étapes grammaticales rotatives
11. **FillTheBlank** - Complétion de phrases intelligente
12. **StoryBuilder** - Construction par glisser-déposer
13. **RiverRun** - Navigation fluviale avec vocabulaire
14. **ChineseStudy** - Apprentissage chinois complet (4 modes)

### À Ajouter
- **Module flashcards**
- **Module preview**

## Tech Stack
- **Frontend** : Vanilla JS/HTML/CSS, ES6 Modules
- **Backend** : Node.js serveur local
- **Architecture** : EventBus strict, WeakMap privates, Object.seal
- **Contenu** : JSON/vocabulary objects adaptatifs

## Usage
- **Cible principale** : Enfants 8-9 ans (anglais/chinois)
- **Usage personnel** : Apprentissage chinois
- **Enseignement** : Cours d'anglais aux enfants chinois

## État Actuel
- ✅ Core terminé et scellé
- ✅ 14 jeux convertis à l'architecture modulaire
- ✅ Système CSS avec injection dynamique
- ✅ Serveur de développement opérationnel
- 🚧 V1 prévue ce soir