From cb0c3b01f8cb3375b3fe3c1d8a4ff581c8f0e7fc Mon Sep 17 00:00:00 2001 From: StillHammer Date: Fri, 19 Sep 2025 02:02:07 +0800 Subject: [PATCH] Clean repository: remove 42 debug, test and temporary files MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Remove all debug-*.js and test-*.* files from root directory - Remove temporary conversion and example files - Remove documentation files that cluttered root - Remove admin and start batch files - Keep only essential core files and organized directory structure 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- ADVENTURE-READER-DRAGON-PEARL.md | 117 -- COMPATIBILITY-SYSTEM.md | 240 --- CORRECTION-APPLIQUÉE.txt | 41 - OPTIMISATION-GRILLE-JEUX.md | 71 - PREUVE-SYSTÈME-FONCTIONNEL.txt | 30 - RAPPORT-COMPATIBILITÉ-RÉSOLU.md | 136 -- RESUME-MODIFICATIONS-SESSION.md | 106 -- Start_Class_Generator.bat | 68 - Start_Class_Generator_HTTP.bat | 43 - admin-ultra-modular.html | 643 -------- convert-vocabulary.js | 27 - debug-adventure-reader.js | 85 - debug-compatibility.js | 84 - diagnostic-scan-dynamique.js | 182 --- english_exemple.json | 244 --- english_exemple_commented.json | 620 ------- english_exemple_fixed.json | 828 ---------- english_exemple_ultra_commented.json | 2224 -------------------------- migrate-console.js | 114 -- quick-debug.js | 56 - sbs-level-7-8-GENERATED-from-js.json | 206 --- start-websocket-logger.bat | 12 - start-websocket-logger.sh | 12 - test-aws-signature.js | 147 -- test-chinese-content.json | 58 - test-compatibility-system.html | 222 --- test-connection.html | 44 - test-content-loading.html | 62 - test-conversion-english-exemple.js | 321 ---- test-conversion.js | 368 ----- test-curl.js | 102 -- test-digitalocean.html | 374 ----- test-do-auth.html | 100 -- test-dragon-pearl.js | 59 - test-extraction-direct.js | 87 - test-final-compatibility.html | 333 ---- test-flux-bouton-back.md | 60 - test-logs-interface.html | 78 - test-node-compatibility.js | 107 -- test-real-flow.js | 116 -- test-reverse-conversion.html | 457 ------ test-ultra-modular.html | 332 ---- test-websocket-simple.html | 75 - todotemp.md | 158 -- validate-compatibility-system.js | 75 - verify-real-app.js | 148 -- 46 files changed, 10072 deletions(-) delete mode 100644 ADVENTURE-READER-DRAGON-PEARL.md delete mode 100644 COMPATIBILITY-SYSTEM.md delete mode 100644 CORRECTION-APPLIQUÉE.txt delete mode 100644 OPTIMISATION-GRILLE-JEUX.md delete mode 100644 PREUVE-SYSTÈME-FONCTIONNEL.txt delete mode 100644 RAPPORT-COMPATIBILITÉ-RÉSOLU.md delete mode 100644 RESUME-MODIFICATIONS-SESSION.md delete mode 100644 Start_Class_Generator.bat delete mode 100644 Start_Class_Generator_HTTP.bat delete mode 100644 admin-ultra-modular.html delete mode 100644 convert-vocabulary.js delete mode 100644 debug-adventure-reader.js delete mode 100644 debug-compatibility.js delete mode 100644 diagnostic-scan-dynamique.js delete mode 100644 english_exemple.json delete mode 100644 english_exemple_commented.json delete mode 100644 english_exemple_fixed.json delete mode 100644 english_exemple_ultra_commented.json delete mode 100644 migrate-console.js delete mode 100644 quick-debug.js delete mode 100644 sbs-level-7-8-GENERATED-from-js.json delete mode 100644 start-websocket-logger.bat delete mode 100644 start-websocket-logger.sh delete mode 100644 test-aws-signature.js delete mode 100644 test-chinese-content.json delete mode 100644 test-compatibility-system.html delete mode 100644 test-connection.html delete mode 100644 test-content-loading.html delete mode 100644 test-conversion-english-exemple.js delete mode 100644 test-conversion.js delete mode 100644 test-curl.js delete mode 100644 test-digitalocean.html delete mode 100644 test-do-auth.html delete mode 100644 test-dragon-pearl.js delete mode 100644 test-extraction-direct.js delete mode 100644 test-final-compatibility.html delete mode 100644 test-flux-bouton-back.md delete mode 100644 test-logs-interface.html delete mode 100644 test-node-compatibility.js delete mode 100644 test-real-flow.js delete mode 100644 test-reverse-conversion.html delete mode 100644 test-ultra-modular.html delete mode 100644 test-websocket-simple.html delete mode 100644 todotemp.md delete mode 100644 validate-compatibility-system.js delete mode 100644 verify-real-app.js diff --git a/ADVENTURE-READER-DRAGON-PEARL.md b/ADVENTURE-READER-DRAGON-PEARL.md deleted file mode 100644 index f9f0e48..0000000 --- a/ADVENTURE-READER-DRAGON-PEARL.md +++ /dev/null @@ -1,117 +0,0 @@ -# 🐉 ADVENTURE READER + DRAGON'S PEARL - CORRECTIONS - -## 🔍 Problème Identifié - -Adventure Reader ne pouvait pas utiliser le contenu de Dragon's Pearl car il cherchait le contenu dans une structure **ultra-modulaire** (`content.rawContent.texts[]`) alors que Dragon's Pearl utilise une structure **custom** (`content.story.chapters[].sentences[]`). - -## 🔧 Corrections Apportées - -### 1. Support Structure Dragon's Pearl - -#### `extractSentences()` - Ligne 110-127 -```javascript -// Support pour Dragon's Pearl structure: content.story.chapters[].sentences[] -if (content.story && content.story.chapters && Array.isArray(content.story.chapters)) { - content.story.chapters.forEach(chapter => { - if (chapter.sentences && Array.isArray(chapter.sentences)) { - chapter.sentences.forEach(sentence => { - if (sentence.original && sentence.translation) { - sentences.push({ - original_language: sentence.original, - user_language: sentence.translation, - pronunciation: sentence.pronunciation || '', - chapter: chapter.title || '', - id: sentence.id || sentences.length - }); - } - }); - } - }); -} -``` - -#### `extractStories()` - Ligne 189-205 -```javascript -// Support pour Dragon's Pearl structure -if (content.story && content.story.chapters && Array.isArray(content.story.chapters)) { - // Créer une histoire depuis les chapitres de Dragon's Pearl - stories.push({ - title: content.story.title || content.name || "Dragon's Pearl", - original_language: content.story.chapters.map(ch => - ch.sentences.map(s => s.original).join(' ') - ).join('\n\n'), - user_language: content.story.chapters.map(ch => - ch.sentences.map(s => s.translation).join(' ') - ).join('\n\n'), - chapters: content.story.chapters.map(chapter => ({ - title: chapter.title, - sentences: chapter.sentences - })) - }); -} -``` - -#### `extractVocabulary()` - Ligne 78-100 -```javascript -// Support pour Dragon's Pearl vocabulary structure -if (content.vocabulary && typeof content.vocabulary === 'object') { - vocabulary = Object.entries(content.vocabulary).map(([original_language, vocabData]) => { - if (typeof vocabData === 'string') { - // Simple format: "word": "translation" - return { - original_language: original_language, - user_language: vocabData, - type: 'unknown' - }; - } else if (typeof vocabData === 'object') { - // Rich format: "word": { user_language: "translation", type: "noun", ... } - return { - original_language: original_language, - user_language: vocabData.user_language || vocabData.translation || 'No translation', - type: vocabData.type || 'unknown', - pronunciation: vocabData.pronunciation, - difficulty: vocabData.difficulty - }; - } - return null; - }).filter(item => item !== null); -} -``` - -## 🎯 Résultats - -Maintenant Adventure Reader peut : - -### ✅ Extraire les Phrases de Dragon's Pearl -- **150+ phrases** des chapitres 1-4 de l'histoire -- **Chinois original + traduction anglaise** -- **Prononciation pinyin** -- **Organisation par chapitres** - -### ✅ Utiliser le Vocabulaire -- **50+ mots chinois** avec traductions -- **Types grammaticaux** (noun, verb, adjective...) -- **Prononciation pinyin** - -### ✅ Créer l'Histoire Complète -- **Titre** : "The Dragon's Pearl - 龙珠传说" -- **Chapitres structurés** -- **Texte complet** pour l'aventure - -## 🎮 Fonctionnement en Jeu - -Quand tu lances **Adventure Reader** avec **Dragon's Pearl** : - -1. **Carte interactive** avec des pots 🏺 et ennemis 👹 -2. **Clique sur les pots** → Affiche des **phrases chinoises** de l'histoire -3. **Combat les ennemis** → Teste ton **vocabulaire chinois** -4. **Modal de lecture** → Affiche **chinois + anglais + pinyin** -5. **Progression** → Traverse toute l'histoire de Li Ming et le Dragon - -## 🔗 Compatibilité - -✅ **Rétrocompatible** : Fonctionne toujours avec l'ancien format ultra-modulaire -✅ **Dragon's Pearl** : Support complet de la structure custom -✅ **Autres contenus** : Tous les autres modules continuent de fonctionner - -Adventure Reader peut maintenant utiliser **toutes les phrases et tout le vocabulaire** de Dragon's Pearl pour créer une expérience d'apprentissage immersive ! 🐉✨ \ No newline at end of file diff --git a/COMPATIBILITY-SYSTEM.md b/COMPATIBILITY-SYSTEM.md deleted file mode 100644 index 03e4ff2..0000000 --- a/COMPATIBILITY-SYSTEM.md +++ /dev/null @@ -1,240 +0,0 @@ -# 🎯 Système de Compatibilité Content-Game - -## Vue d'Ensemble - -Le système de compatibilité Content-Game analyse automatiquement le contenu éducatif et détermine quels jeux sont optimaux pour chaque type de contenu. Il fournit des scores de compatibilité, des recommandations visuelles, et des suggestions d'amélioration. - -## 🔧 Architecture - -### Composants Principaux - -1. **`ContentGameCompatibility`** (`js/core/content-game-compatibility.js`) - - Moteur d'analyse de compatibilité - - Calculs de scores par type de jeu - - Système de suggestions d'amélioration - -2. **Navigation Intelligente** (`js/core/navigation.js`) - - Intégration avec le système de compatibilité - - Affichage séparé des jeux compatibles/incompatibles - - Interface visuelle avec badges de compatibilité - -3. **Interface Visuelle** (`css/main.css`) - - Styles pour les badges de compatibilité - - Couleurs et animations - - Modal d'aide pour jeux incompatibles - -## 🎮 Fonctionnalités - -### Analyse de Compatibilité - -- **Scores automatiques** : 0-100% basés sur les besoins réels de chaque jeu -- **Seuils configurables** : Minimums personnalisables par jeu -- **Cache intelligent** : Optimisation des performances - -### Interface Utilisateur - -- **Badges visuels** : - - 🎯 **Excellent** (80%+) : Violet - - ✅ **Recommandé** (60-79%) : Vert - - 👍 **Compatible** (seuil-59%) : Bleu-vert - - ⚠️ **Limité** (= 30, - score, - reason: `Compatible: ${reasons.join(', ')}` - }; -} -``` - -### Styles Visuels - -Modifiez les couleurs dans `css/main.css` : - -```css -.compatibility-badge.excellent { - background: linear-gradient(135deg, #your-color, #your-color-2); -} -``` - -## 🚀 Déploiement - -### Fichiers Requis - -**Core System:** -- `js/core/content-game-compatibility.js` -- Modifications dans `js/core/navigation.js` -- Styles dans `css/main.css` - -**Chargement HTML:** -```html - - - -``` - -### Production - -1. Le système fonctionne automatiquement une fois intégré -2. Aucune configuration supplémentaire requise -3. Compatible avec tous les contenus existants -4. Graceful fallback en cas d'erreur - -## 🛠️ Maintenance - -### Ajout de Nouveau Contenu - -Le système détecte automatiquement les nouveaux modules. Aucune configuration requise. - -### Débogage - -Utilisez les logs intégrés : -```javascript -// Activer debug dans la console -window.AppNavigation.compatibilityChecker.clearCache(); -``` - -### Monitoring - -Le système log automatiquement : -- Scores de compatibilité calculés -- Erreurs de chargement -- Suggestions générées - -## ✅ Statut - -**SYSTÈME COMPLET ET FONCTIONNEL** - -- ✅ Analyse automatique de compatibilité -- ✅ Interface utilisateur intégrée -- ✅ Tests complets validés -- ✅ Documentation complète -- ✅ Prêt pour la production - -Le système évite maintenant d'afficher des jeux incompatibles et guide l'utilisateur vers les meilleurs choix selon le contenu disponible! \ No newline at end of file diff --git a/CORRECTION-APPLIQUÉE.txt b/CORRECTION-APPLIQUÉE.txt deleted file mode 100644 index a4d4a46..0000000 --- a/CORRECTION-APPLIQUÉE.txt +++ /dev/null @@ -1,41 +0,0 @@ - -🔧 CORRECTION APPLIQUÉE: CONVERSION HONNÊTE 🔧 -================================================ - -❌ AVANT (SYSTÈME DÉFAILLANT): - - Inventait type, difficulty_level, semantic_category, usage_frequency - - Générais des examples et grammar_notes fantaisistes - - Hallucinait des métadonnées inexistantes - - Fichier: 9.8 KB avec des données inventées - -✅ APRÈS (SYSTÈME CORRECT): - - Garde SEULEMENT les données réelles: mot → traduction - - Convertit le format mais n'invente RIEN - - Ajoute uniquement l'ID et la structure ultra-modulaire - - Fichier: 5.0 KB avec SEULEMENT des données vraies - -🎯 DONNÉES CONSERVÉES (LÉGITIMES): - - vocabulary: central → 中心的；中央的 ✅ - - sentences: anglais → chinois ✅ - - difficulty_level: 7 (inféré du nom 'Level 7-8') ✅ - - langues: détectées des données ✅ - - tags: extraits du contenu réel ✅ - -🚫 DONNÉES SUPPRIMÉES (INVENTÉES): - - types de mots ❌ - - niveaux de difficulté par mot ❌ - - catégories sémantiques ❌ - - fréquences d'usage ❌ - - exemples artificiels ❌ - - notes grammaticales ❌ - - skills_covered, target_audience ❌ - -💡 PRINCIPE APPRIS: - Un bon système de conversion doit être HONNÊTE: - - Transformer le format ✅ - - Préserver les données ✅ - - JAMAIS inventer ❌ - -================================================ -SYSTÈME CORRIGÉ: Conversion fidèle et transparente ✅ - diff --git a/OPTIMISATION-GRILLE-JEUX.md b/OPTIMISATION-GRILLE-JEUX.md deleted file mode 100644 index beb7655..0000000 --- a/OPTIMISATION-GRILLE-JEUX.md +++ /dev/null @@ -1,71 +0,0 @@ -# 🎯 OPTIMISATION AFFICHAGE GRILLE DES JEUX - -## ✅ Modifications Apportées - -### 1. Taille Minimale des Colonnes Réduite -```css -/* AVANT */ -grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); - -/* APRÈS */ -grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); -``` - -### 2. Cartes Plus Compactes -- **Padding** : `30px 25px` → `20px 15px` -- **Min-height** : `180px` → `160px` -- **Gap** : `25px` → `20px` - -### 3. Contenu des Cartes Optimisé -- **Icon** : `3rem` → `2.5rem` -- **Title** : `1.4rem` → `1.2rem` -- **Description** : `0.95rem` → `0.85rem` -- **Marges** réduites - -### 4. Responsive Amélioré - -#### Desktop (1200px+) -```css -grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); -min-height: 140px; -``` -**→ Jusqu'à 6 jeux par ligne sur grand écran** - -#### Tablette (768px) -```css -grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); -``` -**→ 3-4 jeux par ligne sur tablette** - -#### Mobile (480px) -```css -padding: 20px 15px; -``` -**→ 2 jeux par ligne même sur mobile** - -## 🎯 Résultats Attendus - -### Avant (1 jeu par ligne) ❌ -``` -[ Whack-a-Mole ] -[ Memory Match ] -[ Quiz Game ] -[ Fill the Blank ] -``` - -### Après (Plusieurs jeux par ligne) ✅ -``` -[ Whack-a-Mole ] [ Memory Match ] [ Quiz Game ] -[ Fill Blank ] [ Text Reader ] [ Adventure ] -[ Story Reader ] [ Chinese Game ] [ Quiz Hard ] -``` - -## 📱 Adaptabilité - -**Large Desktop (1400px+)** : 6-7 jeux/ligne -**Desktop (1200px)** : 5-6 jeux/ligne -**Laptop (1024px)** : 4-5 jeux/ligne -**Tablette (768px)** : 3-4 jeux/ligne -**Mobile (480px)** : 2 jeux/ligne - -Navigation **beaucoup plus rapide** et **vue d'ensemble** des options disponibles ! 🚀 \ No newline at end of file diff --git a/PREUVE-SYSTÈME-FONCTIONNEL.txt b/PREUVE-SYSTÈME-FONCTIONNEL.txt deleted file mode 100644 index f045b1e..0000000 --- a/PREUVE-SYSTÈME-FONCTIONNEL.txt +++ /dev/null @@ -1,30 +0,0 @@ - -🏆 PREUVE ABSOLUE: SYSTÈME ULTRA-MODULAIRE FONCTIONNEL 🏆 -================================================================ - -✅ CHALLENGE RÉUSSI: - - Données JS chargées: 27 mots vocabulaire + 4 phrases - - Analysées en mémoire avec notre ContentScanner - - Converties en JSON ultra-modulaire complet - - Fichier généré: sbs-level-7-8-GENERATED-from-js.json (9.8 KB) - -🎯 CAPACITÉS DÉTECTÉES: - - Vocabulaire: ✅ (27 mots) - - Phrases: ✅ (4 phrases) - - Profondeur vocab: 1/6 (format simple détecté) - - Richesse contenu: 2.7/10 - -🎮 COMPATIBILITÉ JEUX (4/4 COMPATIBLES): - - whack-a-mole: ✅ 54% (vocabulaire disponible) - - memory-match: ✅ 40.5% (vocabulaire visuel) - - quiz-game: ✅ 42% (contenu polyvalent) - - text-reader: ✅ 40% (phrases disponibles) - -📊 QUALITÉ FINALE: 91/100 ⭐⭐⭐⭐⭐ - -🔄 SYSTÈME PROUVÉ: - JS → Analyse → JSON Ultra-Modulaire → Validation ✅ - -================================================================ -Le défi est RELEVÉ ! Le système fonctionne parfaitement ! 🚀 - diff --git a/RAPPORT-COMPATIBILITÉ-RÉSOLU.md b/RAPPORT-COMPATIBILITÉ-RÉSOLU.md deleted file mode 100644 index d9d44d4..0000000 --- a/RAPPORT-COMPATIBILITÉ-RÉSOLU.md +++ /dev/null @@ -1,136 +0,0 @@ -# 🎯 RAPPORT : SYSTÈME DE COMPATIBILITÉ RÉSOLU - -## 📋 Problème Identifié - -**Symptôme** : En cliquant sur Dragon's Pearl, l'interface affichait toujours les mêmes messages génériques au lieu d'analyser la compatibilité réelle du contenu avec les jeux. - -## 🔍 Analyse des Causes - -### 1. Architecture en Deux Systèmes Parallèles - -L'application avait effectivement **deux systèmes de gestion du contenu** : - -#### Système 1 : Configuration Statique ❌ -- Fichier : `config/games-config.json` + `navigation.js` ligne 96-120 -- Usage : Configuration fixe des contenus et jeux -- Problème : Pas de compatibilité dynamique - -#### Système 2 : Scan Dynamique ✅ -- Fichiers : `ContentScanner` + `ContentGameCompatibility` -- Usage : Détection automatique + analyse de compatibilité -- Problème : **Pas connecté au flux principal** - -### 2. Bug de Connexion - -**Flux cassé** : -``` -renderLevelsGrid() → ContentScanner ✅ (Bon système) - ↓ clic sur Dragon's Pearl -renderGamesGrid() → Config statique ❌ (Mauvais système) -``` - -**Le problème exact** (ligne 424 dans `renderGamesGrid()`) : -```javascript -// ❌ AVANT : Utilisait les métadonnées du scan au lieu du module JS -compatibility = this.compatibilityChecker.checkCompatibility(contentInfo, key); - -// ✅ APRÈS : Utilise le vrai module JavaScript -const actualContentModule = window.ContentModules?.[moduleName]; -compatibility = this.compatibilityChecker.checkCompatibility(actualContentModule, key); -``` - -## 🔧 Solution Implémentée - -### 1. Connexion des Systèmes -- **Forcé l'utilisation du scan dynamique** dans `renderGamesGrid()` -- **Ajout de `getModuleName()`** : convertit `"chinese-long-story"` → `"ChineseLongStory"` -- **Correction du bug de compatibilité** : utilise le module JS réel - -### 2. Fonctions Ajoutées - -#### `getModuleName(contentType)` - navigation.js:640 -```javascript -getModuleName(contentType) { - const mapping = { - 'chinese-long-story': 'ChineseLongStory', - 'sbs-level-7-8-new': 'SBSLevel78New', - // ... autres mappings - }; - return mapping[contentType] || this.toPascalCase(contentType); -} -``` - -#### `toPascalCase(str)` - navigation.js:653 -Convertit `kebab-case` → `PascalCase` - -### 3. Correction du Bug Principal - navigation.js:424-435 -```javascript -// Récupérer le module JavaScript réel pour le test de compatibilité -const moduleName = this.getModuleName(contentType); -const actualContentModule = window.ContentModules?.[moduleName]; - -if (actualContentModule) { - compatibility = this.compatibilityChecker.checkCompatibility(actualContentModule, key); - logSh(`🎯 ${game.name} compatibility: ${compatibility.compatible ? '✅' : '❌'} (score: ${compatibility.score}%) - ${compatibility.reason}`, 'DEBUG'); -} else { - logSh(`⚠️ Module JavaScript non trouvé: ${moduleName}`, 'WARN'); - compatibility = { compatible: true, score: 50, reason: "Module not loaded - default compatibility" }; -} -``` - -## 🎯 Résultat Attendu - -Maintenant quand l'utilisateur clique sur **Dragon's Pearl** : - -### 1. Analyse Automatique ✅ -- Le système utilise le **scan dynamique** qui a détecté le contenu -- Il récupère le **vrai module JavaScript** `window.ContentModules.ChineseLongStory` -- Il lance l'**analyse de compatibilité** avec chaque jeu - -### 2. Affichage Adaptatif ✅ -Dragon's Pearl contient une **longue histoire avec chapitres**, donc : - -**🎯 Jeux Recommandés (score élevé)** : -- ✅ **Text Reader** (95%) - Parfait pour histoires longues -- ✅ **Story Reader** (95%) - Optimisé pour les histoires -- ✅ **Adventure Reader** (85%) - Mode RPG avec vocabulaire - -**👍 Jeux Compatibles (score moyen)** : -- ✅ **Quiz Game** (70%) - Questions sur vocabulaire -- ✅ **Memory Match** (60%) - Basé sur vocabulaire - -**⚠️ Jeux avec Limitations** : -- ⚠️ **Whack-a-Mole** (45%) - Besoin plus de vocabulaire isolé -- ⚠️ **Fill-the-Blank** (40%) - Format histoire pas optimal - -## 🧪 Pour Tester - -### 1. Test Manuel -1. Ouvrir `index.html` dans le navigateur -2. Cliquer sur **"LEVELS"** → Dragon's Pearl apparaît via scan dynamique ✅ -3. Cliquer sur **Dragon's Pearl** → Analyse de compatibilité s'exécute ✅ -4. Observer l'affichage par **sections** avec **badges de compatibilité** ✅ - -### 2. Test Console (Diagnostic) -Copier-coller `diagnostic-scan-dynamique.js` dans la console pour vérifier : -- ✅ ContentScanner chargé -- ✅ ContentGameCompatibility chargé -- ✅ Dragon's Pearl détecté dans le scan -- ✅ Module `ChineseLongStory` chargé -- ✅ Tests de compatibilité fonctionnels - -## 📊 Bilan Final - -### ✅ Problèmes Résolus -- **Deux systèmes parallèles** → Unifié sur scan dynamique -- **Messages génériques** → Analyse de compatibilité réelle -- **Bug de connexion** → Module JS réel utilisé -- **Mapping des modules** → Fonction `getModuleName()` ajoutée - -### 🎯 Système Maintenant Opérationnel -- **Dragon's Pearl est correctement analysé** -- **Compatibilité calculée pour chaque jeu** -- **Affichage visuel avec badges et sections** -- **Dégradation gracieuse si module manquant** - -Le système de compatibilité content-jeux est maintenant **100% fonctionnel** ! 🚀 \ No newline at end of file diff --git a/RESUME-MODIFICATIONS-SESSION.md b/RESUME-MODIFICATIONS-SESSION.md deleted file mode 100644 index ae1f956..0000000 --- a/RESUME-MODIFICATIONS-SESSION.md +++ /dev/null @@ -1,106 +0,0 @@ -# 📋 RÉSUMÉ DES MODIFICATIONS - Session Actuelle - -## 🎯 Objectifs Accomplis - -### 1. 🔧 Système de Compatibilité Content-Jeux -**Problème** : Les jeux s'affichaient même s'ils n'étaient pas compatibles avec le contenu sélectionné. - -**Solution** : Système complet de compatibilité qui analyse le contenu et affiche seulement les jeux adaptés. - -### 2. 🐉 Adventure Reader + Dragon's Pearl -**Problème** : Adventure Reader ne pouvait pas utiliser le contenu de Dragon's Pearl. - -**Solution** : Support complet de la structure Dragon's Pearl avec extraction des phrases et prononciations. - -### 3. 🎮 Interface Multi-Colonnes -**Problème** : Interface des jeux affichait un seul jeu par ligne, navigation lente. - -**Solution** : Grille responsive avec 3-6 jeux par ligne selon la taille d'écran. - -### 4. 🍞 Navigation Améliorée -**Problème** : Breadcrumb manquait le niveau "Levels", pas de boutons back. - -**Solution** : Navigation complète avec breadcrumb correct et boutons back sur toutes les pages. - -## 📊 Statistiques Git -``` -29 fichiers modifiés -+5312 lignes ajoutées --2097 lignes supprimées -``` - -## 🔧 Fichiers Clés Modifiés - -### Navigation & Interface -- **`js/core/navigation.js`** : Système de compatibilité intégré, breadcrumb corrigé -- **`css/main.css`** : Grille multi-colonnes, styles compatibilité, boutons back -- **`index.html`** : Boutons back ajoutés dans headers - -### Système de Compatibilité -- **`js/core/content-game-compatibility.js`** ⭐ **NOUVEAU** : Classe principale de compatibilité -- **`css/main.css`** : Badges de compatibilité, sections visuelles - -### Adventure Reader -- **`js/games/adventure-reader.js`** : Support Dragon's Pearl, extraction phrases, prononciations -- **`js/core/json-content-loader.js`** : Support structure `story.chapters[]` -- **`css/games.css`** : Styles prononciations vocabulaire et phrases - -### Contenu -- **`js/content/chinese-long-story.js`** ⭐ **NOUVEAU** : Dragon's Pearl (150+ phrases chinoises) - -## 🎯 Fonctionnalités Ajoutées - -### 🔍 Système de Compatibilité Intelligent -- **Analyse automatique** du contenu (vocabulaire, phrases, dialogues, audio...) -- **Scores de compatibilité** 0-100% par jeu -- **Badges visuels** : Excellent (🎯), Recommandé (✅), Compatible (👍), Limité (⚠️) -- **Sections organisées** : Jeux recommandés vs jeux avec limitations -- **Messages d'aide** : Suggestions pour améliorer le contenu - -### 🐉 Dragon's Pearl dans Adventure Reader -- **150+ phrases chinoises** avec traductions anglaises -- **Vocabulaire riche** avec prononciations pinyin -- **Structure par chapitres** : L'histoire de Li Ming et la perle du dragon -- **Ennemis générés** basés sur le nombre de phrases -- **Pots pour vocabulaire** avec prononciations -- **Modal de lecture** avec chinois + anglais + pinyin - -### 🎮 Interface Multi-Colonnes -- **Desktop** : 4-6 jeux par ligne -- **Tablette** : 3-4 jeux par ligne -- **Mobile** : 2 jeux par ligne -- **Navigation rapide** : Vue d'ensemble de tous les jeux - -### 🧭 Navigation Complète -- **Breadcrumb corrigé** : Home > Levels > Dragon's Pearl > Jeu -- **Boutons back** sur pages levels et games -- **Historique** de navigation avec goBack() fonctionnel -- **Styles responsive** pour tous les écrans - -### 🗣️ Système de Prononciations -- **Vocabulaire** : Affichage pinyin dans popup (龙 → dragon → 🗣️ lóng) -- **Phrases** : Construction automatique des prononciations complètes -- **Styles visuels** : Fond coloré, italique, emoji 🗣️ - -## 🚀 Fichiers de Debug Créés -- `diagnostic-scan-dynamique.js` - Diagnostic système complet -- `debug-adventure-reader.js` - Debug Adventure Reader spécifique -- `test-extraction-direct.js` - Test extraction phrases Dragon's Pearl - -## 📋 Rapports Générés -- `COMPATIBILITY-SYSTEM.md` - Documentation système compatibilité -- `ADVENTURE-READER-DRAGON-PEARL.md` - Guide Adventure Reader + Dragon's Pearl -- `RAPPORT-COMPATIBILITÉ-RÉSOLU.md` - Analyse problèmes/solutions -- `OPTIMISATION-GRILLE-JEUX.md` - Détails interface multi-colonnes - -## ✅ Résultat Final - -L'application est maintenant **beaucoup plus intelligente et utilisable** : - -1. **Choix intelligent** des jeux selon le contenu -2. **Navigation rapide** avec vue d'ensemble -3. **Expérience immersive** avec Dragon's Pearl + Adventure Reader -4. **Apprentissage optimisé** avec prononciations chinoises -5. **Interface moderne** responsive et intuitive - -**🎯 Mission accomplie !** Le système analyse automatiquement le contenu, recommande les meilleurs jeux, et offre une expérience d'apprentissage riche avec Dragon's Pearl ! 🐉✨ \ No newline at end of file diff --git a/Start_Class_Generator.bat b/Start_Class_Generator.bat deleted file mode 100644 index 6e8b181..0000000 --- a/Start_Class_Generator.bat +++ /dev/null @@ -1,68 +0,0 @@ -@echo off -title Class Generator - Startup -color 0A - -echo ======================================== -echo CLASS GENERATOR - DEMARRAGE -echo ======================================== -echo. - -cd /d "%~dp0" - -echo [1/6] Arret des instances precedentes... -echo ---------------------------------------- -taskkill /F /IM node.exe >nul 2>&1 -taskkill /F /IM python.exe >nul 2>&1 -echo OK - Instances precedentes arretees - -timeout /t 1 /nobreak > nul - -echo [2/6] Demarrage du serveur WebSocket Logger (port 8082)... -echo ---------------------------------------- -cd export_logger -start /B node websocket-server.js -cd .. - -timeout /t 2 /nobreak > nul - -echo [3/6] Demarrage du serveur HTTP (port 8080)... -echo ---------------------------------------- -start /B python -m http.server 8080 - -timeout /t 3 /nobreak > nul - -echo [4/6] Verification des serveurs... -echo ---------------------------------------- -echo OK - Serveur WebSocket demarre sur le port 8082 -echo OK - Serveur HTTP demarre sur le port 8080 - -echo. -echo [5/6] Ouverture du logger en priorite... -echo ---------------------------------------- -start "" "http://localhost:8080/export_logger/logs-viewer.html" - -timeout /t 2 /nobreak > nul - -echo [6/6] Ouverture de l'application principale... -echo ---------------------------------------- -start "" "http://localhost:8080" - -echo. -echo ======================================== -echo DEMARRAGE TERMINE AVEC SUCCES! -echo ======================================== -echo. -echo Serveur HTTP: http://localhost:8080 -echo Serveur WebSocket: ws://localhost:8082 -echo Application: Ouverte dans votre navigateur -echo Logger: Accessible via le bouton en haut a droite -echo. -echo Cette fenetre peut etre fermee. -echo Les serveurs continuent en arriere-plan. -echo. -echo Pour arreter les serveurs: -echo - Relancez ce script (il tue automatiquement les anciennes instances) -echo - Ou dans le gestionnaire de taches: Terminer node.exe et python.exe -echo. -timeout /t 5 /nobreak > nul -exit \ No newline at end of file diff --git a/Start_Class_Generator_HTTP.bat b/Start_Class_Generator_HTTP.bat deleted file mode 100644 index 7489c16..0000000 --- a/Start_Class_Generator_HTTP.bat +++ /dev/null @@ -1,43 +0,0 @@ -@echo off -title Class Generator - HTTP Server -color 0A - -echo ======================================== -echo CLASS GENERATOR - SERVEUR HTTP -echo ======================================== -echo. - -cd /d "%~dp0" - -echo [1/3] Demarrage du serveur WebSocket Logger (port 8082)... -echo ---------------------------------------- -cd export_logger -start /min cmd /c "node websocket-server.js" -cd .. - -timeout /t 2 /nobreak > nul - -echo [2/3] Demarrage du serveur HTTP (port 8080)... -echo ---------------------------------------- -start /min cmd /c "python -m http.server 8080" - -timeout /t 3 /nobreak > nul - -echo [3/3] Ouverture de l'application... -echo ---------------------------------------- -start "" "http://localhost:8080" - -echo. -echo ======================================== -echo DEMARRAGE TERMINE AVEC SUCCES! -echo ======================================== -echo. -echo Serveur HTTP: http://localhost:8080 -echo Serveur WebSocket: ws://localhost:8082 -echo Logger: Accessible via le bouton en haut a droite -echo. -echo Cette fenetre peut etre fermee. -echo Les serveurs continuent en arriere-plan. -echo. -timeout /t 5 /nobreak > nul -exit \ No newline at end of file diff --git a/admin-ultra-modular.html b/admin-ultra-modular.html deleted file mode 100644 index 399217e..0000000 --- a/admin-ultra-modular.html +++ /dev/null @@ -1,643 +0,0 @@ - - - - - - 🚀 Admin: Ultra-Modular JSON System - - - -
-

🚀 Admin: Ultra-Modular JSON System

-

Validation et gestion des spécifications de contenu ultra-modulaires

-
- -
- -
-
- 🔍 -

Validation de Spécifications

-
- -

Fichiers JSON Disponibles:

-
-
Chargement des fichiers...
-
- - -
- - -
-
- 📊 -

Analyse des Capacités

-
- - -
-
- - - - - - - - - - - - \ No newline at end of file diff --git a/convert-vocabulary.js b/convert-vocabulary.js deleted file mode 100644 index 3b1586c..0000000 --- a/convert-vocabulary.js +++ /dev/null @@ -1,27 +0,0 @@ -// Quick script to convert old vocabulary format to new language-agnostic format -const fs = require('fs'); - -function convertVocabularyFormat(inputFile, outputFile) { - let content = fs.readFileSync(inputFile, 'utf8'); - - // Pattern to match: word: "translation", - const pattern = /(\s+)(\w+|"[^"]*"): "([^"]*)",?/g; - - content = content.replace(pattern, (match, indent, word, translation) => { - // Determine word type based on translation or word - let type = "noun"; // Default - if (translation.includes("的") && !translation.includes("；")) type = "adjective"; - if (word.includes(" ")) type = "phrase"; - - return `${indent}${word}: { user_language: "${translation}", type: "${type}" },`; - }); - - fs.writeFileSync(outputFile, content); - console.log(`Converted ${inputFile} to ${outputFile}`); -} - -// Convert the sbs file -convertVocabularyFormat( - 'js/content/sbs-level-7-8-new.js', - 'js/content/sbs-level-7-8-new-converted.js' -); \ No newline at end of file diff --git a/debug-adventure-reader.js b/debug-adventure-reader.js deleted file mode 100644 index 6a8bf31..0000000 --- a/debug-adventure-reader.js +++ /dev/null @@ -1,85 +0,0 @@ -// === DEBUG ADVENTURE READER + DRAGON'S PEARL === - -// Script à copier-coller dans la console pour déboguer - -function debugAdventureReader() { - console.log('🐉 Debug Adventure Reader + Dragon\\'s Pearl'); - - // 1. Vérifier que le module Dragon's Pearl est chargé - console.log('\\n1️⃣ Module Dragon\\'s Pearl:'); - const dragonModule = window.ContentModules?.ChineseLongStory; - console.log(' Module trouvé:', !!dragonModule); - - if (dragonModule) { - console.log(' Nom:', dragonModule.name); - console.log(' Vocabulary entries:', Object.keys(dragonModule.vocabulary || {}).length); - console.log(' Story structure:', !!dragonModule.story); - - if (dragonModule.story) { - console.log(' Story title:', dragonModule.story.title); - console.log(' Chapters:', dragonModule.story.chapters?.length || 0); - - if (dragonModule.story.chapters?.[0]) { - console.log(' First chapter sentences:', dragonModule.story.chapters[0].sentences?.length || 0); - console.log(' Sample sentence:', dragonModule.story.chapters[0].sentences?.[0]?.original); - } - } - } - - // 2. Tester l'extraction si possible - console.log('\\n2️⃣ Test d\\'extraction:'); - if (dragonModule && window.AdventureReaderGame) { - // Créer une instance temporaire pour tester - const testReader = { - extractSentences: window.AdventureReaderGame.prototype.extractSentences, - extractVocabulary: window.AdventureReaderGame.prototype.extractVocabulary, - extractStories: window.AdventureReaderGame.prototype.extractStories - }; - - try { - const sentences = testReader.extractSentences(dragonModule); - console.log(' Phrases extraites:', sentences.length); - if (sentences.length > 0) { - console.log(' Première phrase:', sentences[0]); - } - - const vocab = testReader.extractVocabulary(dragonModule); - console.log(' Vocabulaire extrait:', vocab.length); - if (vocab.length > 0) { - console.log(' Premier mot:', vocab[0]); - } - - const stories = testReader.extractStories(dragonModule); - console.log(' Histoires extraites:', stories.length); - if (stories.length > 0) { - console.log(' Première histoire:', stories[0].title); - } - - } catch (error) { - console.error(' ❌ Erreur d\\'extraction:', error); - } - } - - // 3. Vérifier l'instance active si elle existe - console.log('\\n3️⃣ Instance active:'); - // Chercher dans le DOM s'il y a un jeu actif - const gameContainer = document.querySelector('.adventure-reader-wrapper'); - console.log(' Jeu Adventure Reader actif:', !!gameContainer); - - // Vérifier les éléments du DOM - const modal = document.getElementById('reading-modal'); - console.log(' Modal de lecture:', !!modal); - - const mapElement = document.querySelector('.game-map'); - console.log(' Carte de jeu:', !!mapElement); - - const pots = document.querySelectorAll('.pot'); - const enemies = document.querySelectorAll('.enemy'); - console.log(' Pots sur la carte:', pots.length); - console.log(' Ennemis sur la carte:', enemies.length); - - console.log('\\n✅ Debug terminé'); -} - -// Auto-exécution -debugAdventureReader(); \ No newline at end of file diff --git a/debug-compatibility.js b/debug-compatibility.js deleted file mode 100644 index 6e677dd..0000000 --- a/debug-compatibility.js +++ /dev/null @@ -1,84 +0,0 @@ -// === DEBUG SYSTÈME DE COMPATIBILITÉ === - -// Script à injecter dans la console pour débugger les problèmes - -window.debugCompatibility = { - - // Fonction pour logger les informations détaillées - logContentInfo: function(contentType) { - console.log('🔍 Debug Compatibilité pour:', contentType); - - // 1. Vérifier si le contentScanner a ce contenu - if (window.AppNavigation && window.AppNavigation.scannedContent) { - const foundContent = window.AppNavigation.scannedContent.found.find(c => c.id === contentType); - console.log('📦 Contenu trouvé par scanner:', foundContent); - } - - // 2. Vérifier dans ContentModules - const moduleName = this.getModuleName(contentType); - console.log('🏷️ Nom de module calculé:', moduleName); - - if (window.ContentModules && window.ContentModules[moduleName]) { - const module = window.ContentModules[moduleName]; - console.log('📋 Module dans ContentModules:', module); - - // 3. Tester compatibilité directement - if (window.AppNavigation && window.AppNavigation.compatibilityChecker) { - const checker = window.AppNavigation.compatibilityChecker; - const games = ['whack-a-mole', 'memory-match', 'quiz-game', 'fill-the-blank', 'text-reader', 'adventure-reader']; - - console.log('🎮 Tests de compatibilité:'); - games.forEach(game => { - const result = checker.checkCompatibility(module, game); - console.log(` ${result.compatible ? '✅' : '❌'} ${game}: ${result.score}%`); - }); - } - } else { - console.error('❌ Module non trouvé:', moduleName); - console.log('📋 Modules disponibles:', Object.keys(window.ContentModules || {})); - } - }, - - // Fonction pour convertir contentType vers moduleName (copie de la logique) - getModuleName: function(contentType) { - const mapping = { - 'sbs-level-7-8-new': 'SBSLevel78New', - 'basic-chinese': 'BasicChinese', - 'english-class-demo': 'EnglishClassDemo', - 'chinese-long-story': 'ChineseLongStory', - 'test-minimal': 'TestMinimal', - 'test-rich': 'TestRich' - }; - return mapping[contentType] || this.toPascalCase(contentType); - }, - - toPascalCase: function(str) { - return str.split('-').map(word => - word.charAt(0).toUpperCase() + word.slice(1) - ).join(''); - }, - - // Fonction pour tester avec Dragon's Pearl spécifiquement - testDragonsPearl: function() { - console.log('🐉 Test spécifique Dragon\'s Pearl'); - this.logContentInfo('chinese-long-story'); - }, - - // Fonction pour vérifier le contenu scanné - listScannedContent: function() { - if (window.AppNavigation && window.AppNavigation.scannedContent) { - console.log('📋 Contenu scanné:', window.AppNavigation.scannedContent.found.map(c => ({ - id: c.id, - name: c.name, - filename: c.filename - }))); - } else { - console.log('❌ Pas de contenu scanné trouvé'); - } - } -}; - -console.log('🔧 Script de debug chargé. Utilisez:'); -console.log(' debugCompatibility.testDragonsPearl() - Test Dragon\'s Pearl'); -console.log(' debugCompatibility.listScannedContent() - Liste le contenu scanné'); -console.log(' debugCompatibility.logContentInfo("content-id") - Debug contenu spécifique'); \ No newline at end of file diff --git a/diagnostic-scan-dynamique.js b/diagnostic-scan-dynamique.js deleted file mode 100644 index 2d78b39..0000000 --- a/diagnostic-scan-dynamique.js +++ /dev/null @@ -1,182 +0,0 @@ -// === DIAGNOSTIC COMPLET DU SCAN DYNAMIQUE === - -// Script de diagnostic à exécuter dans la console pour identifier TOUS les problèmes - -function diagnosticComplet() { - console.log('🔍 DIAGNOSTIC COMPLET DU SCAN DYNAMIQUE\n'); - console.log('=====================================\n'); - - const issues = []; - const success = []; - - // 1. Vérification des classes de base - console.log('1️⃣ VÉRIFICATION DES CLASSES DE BASE'); - console.log('-------------------------------------'); - - if (!window.ContentScanner) { - issues.push('❌ ContentScanner non chargé'); - console.log('❌ ContentScanner: NON CHARGÉ'); - } else { - success.push('✅ ContentScanner chargé'); - console.log('✅ ContentScanner: CHARGÉ'); - } - - if (!window.ContentGameCompatibility) { - issues.push('❌ ContentGameCompatibility non chargé'); - console.log('❌ ContentGameCompatibility: NON CHARGÉ'); - } else { - success.push('✅ ContentGameCompatibility chargé'); - console.log('✅ ContentGameCompatibility: CHARGÉ'); - } - - if (!window.AppNavigation) { - issues.push('❌ AppNavigation non chargé'); - console.log('❌ AppNavigation: NON CHARGÉ'); - return { issues, success }; - } else { - success.push('✅ AppNavigation chargé'); - console.log('✅ AppNavigation: CHARGÉ'); - } - - // 2. Vérification de l'initialisation - console.log('\n2️⃣ VÉRIFICATION DE L\'INITIALISATION'); - console.log('--------------------------------------'); - - if (!window.AppNavigation.contentScanner) { - issues.push('❌ ContentScanner non initialisé dans AppNavigation'); - console.log('❌ AppNavigation.contentScanner: NON INITIALISÉ'); - } else { - success.push('✅ ContentScanner initialisé'); - console.log('✅ AppNavigation.contentScanner: INITIALISÉ'); - } - - if (!window.AppNavigation.compatibilityChecker) { - issues.push('❌ CompatibilityChecker non initialisé dans AppNavigation'); - console.log('❌ AppNavigation.compatibilityChecker: NON INITIALISÉ'); - } else { - success.push('✅ CompatibilityChecker initialisé'); - console.log('✅ AppNavigation.compatibilityChecker: INITIALISÉ'); - } - - // 3. Vérification du contenu scanné - console.log('\n3️⃣ VÉRIFICATION DU CONTENU SCANNÉ'); - console.log('----------------------------------'); - - if (!window.AppNavigation.scannedContent) { - issues.push('❌ Aucun contenu scanné trouvé'); - console.log('❌ scannedContent: VIDE'); - } else { - const found = window.AppNavigation.scannedContent.found || []; - console.log(`✅ scannedContent: ${found.length} modules trouvés`); - - if (found.length === 0) { - issues.push('❌ Scanner n\'a trouvé aucun module'); - } else { - success.push(`✅ ${found.length} modules détectés`); - - console.log('\n 📋 MODULES DÉTECTÉS:'); - found.forEach((content, index) => { - console.log(` ${index + 1}. "${content.name}" (ID: ${content.id})`); - console.log(` 📁 Fichier: ${content.filename}`); - console.log(` 📊 Vocab: ${content.stats?.vocabularyCount || 0}, Phrases: ${content.stats?.sentenceCount || 0}`); - }); - - // Chercher spécifiquement Dragon's Pearl - const dragonPearl = found.find(c => - c.name.includes('Dragon') || - c.id.includes('chinese-long-story') || - c.filename.includes('chinese-long-story') - ); - - if (dragonPearl) { - success.push('✅ Dragon\'s Pearl détecté dans le scan'); - console.log(`\n 🐉 DRAGON'S PEARL TROUVÉ:`); - console.log(` Nom: "${dragonPearl.name}"`); - console.log(` ID: "${dragonPearl.id}"`); - console.log(` Fichier: "${dragonPearl.filename}"`); - } else { - issues.push('❌ Dragon\'s Pearl non trouvé dans le scan'); - console.log('\n ❌ DRAGON\'S PEARL: NON TROUVÉ'); - } - } - } - - // 4. Vérification des modules JavaScript - console.log('\n4️⃣ VÉRIFICATION DES MODULES JAVASCRIPT'); - console.log('---------------------------------------'); - - if (!window.ContentModules) { - issues.push('❌ window.ContentModules non défini'); - console.log('❌ window.ContentModules: NON DÉFINI'); - } else { - const modules = Object.keys(window.ContentModules); - console.log(`✅ window.ContentModules: ${modules.length} modules`); - console.log(` Modules: ${modules.join(', ')}`); - - if (window.ContentModules.ChineseLongStory) { - success.push('✅ Module ChineseLongStory chargé'); - console.log('✅ ChineseLongStory: CHARGÉ'); - - const module = window.ContentModules.ChineseLongStory; - console.log(` Nom: "${module.name}"`); - console.log(` Vocabulaire: ${Object.keys(module.vocabulary || {}).length} mots`); - console.log(` Story: ${module.story ? 'OUI' : 'NON'}`); - } else { - issues.push('❌ Module ChineseLongStory non chargé'); - console.log('❌ ChineseLongStory: NON CHARGÉ'); - } - } - - // 5. Test de compatibilité - console.log('\n5️⃣ TEST DE COMPATIBILITÉ'); - console.log('-------------------------'); - - if (window.AppNavigation?.compatibilityChecker && window.ContentModules?.ChineseLongStory) { - try { - const checker = window.AppNavigation.compatibilityChecker; - const content = window.ContentModules.ChineseLongStory; - - console.log('✅ Test de compatibilité possible'); - - const games = ['whack-a-mole', 'memory-match', 'quiz-game', 'text-reader']; - games.forEach(game => { - const result = checker.checkCompatibility(content, game); - const status = result.compatible ? '✅' : '❌'; - console.log(` ${status} ${game}: ${result.score}% - ${result.reason}`); - }); - - success.push('✅ Système de compatibilité fonctionnel'); - } catch (error) { - issues.push(`❌ Erreur test compatibilité: ${error.message}`); - console.log(`❌ ERREUR TEST: ${error.message}`); - } - } else { - issues.push('❌ Test de compatibilité impossible'); - console.log('❌ Test de compatibilité: IMPOSSIBLE'); - } - - // 6. Rapport final - console.log('\n📊 RAPPORT FINAL'); - console.log('================'); - console.log(`✅ Succès: ${success.length}`); - console.log(`❌ Problèmes: ${issues.length}`); - - if (issues.length > 0) { - console.log('\n🚨 PROBLÈMES IDENTIFIÉS:'); - issues.forEach((issue, index) => { - console.log(`${index + 1}. ${issue}`); - }); - } - - if (success.length > 0) { - console.log('\n🎉 ÉLÉMENTS FONCTIONNELS:'); - success.forEach((item, index) => { - console.log(`${index + 1}. ${item}`); - }); - } - - return { issues, success }; -} - -// Auto-exécution -diagnosticComplet(); \ No newline at end of file diff --git a/english_exemple.json b/english_exemple.json deleted file mode 100644 index 105ce7a..0000000 --- a/english_exemple.json +++ /dev/null @@ -1,244 +0,0 @@ -{ - "name": "English Class Demo", - "description": "Complete example with all content types - vocabulary, grammar, audio, poems, exercises", - "difficulty": "mixed", - "language": "english", - "icon": "🇬🇧", - "vocabulary": { - "apple": { - "translation": "pomme", - "type": "noun", - "pronunciation": "audio/apple.mp3", - "difficulty": "beginner", - "examples": ["I eat an apple every day", "The apple is red and sweet"], - "grammarNotes": "Count noun - can be singular or plural" - }, - "run": { - "translation": "courir", - "type": "verb", - "pronunciation": "audio/run.mp3", - "difficulty": "beginner", - "examples": ["I run in the park", "She runs very fast"], - "grammarNotes": "Regular verb: run, runs, running, ran" - }, - "beautiful": { - "translation": "beau/belle", - "type": "adjective", - "pronunciation": "audio/beautiful.mp3", - "difficulty": "intermediate", - "examples": ["The sunset is beautiful", "She has beautiful eyes"], - "grammarNotes": "Can be used before noun or after 'be'" - }, - "hello": { - "translation": "bonjour", - "type": "greeting", - "pronunciation": "audio/hello.mp3", - "difficulty": "beginner", - "examples": ["Hello, how are you?", "Hello everyone!"], - "grammarNotes": "Common greeting used anytime" - }, - "cat": "chat", - "dog": "chien", - "house": "maison" - }, - "grammar": { - "presentSimple": { - "title": "Present Simple Tense", - "explanation": "Used for habits, facts, and general truths. Form: Subject + base verb (+ s for he/she/it)", - "examples": [ - { "english": "I walk to school", "french": "Je marche à l'école" }, - { "english": "She walks to school", "french": "Elle marche à l'école" }, - { "english": "They walk to school", "french": "Ils marchent à l'école" } - ], - "exercises": [ - "Complete: I _____ (play) tennis every Sunday", - "Transform: He walk to work → He _____ to work" - ] - }, - "articles": { - "title": "Articles: A, An, The", - "explanation": "A/An = indefinite articles (one of many). The = definite article (specific one)", - "examples": [ - { "english": "I see a cat", "french": "Je vois un chat" }, - { "english": "I see an elephant", "french": "Je vois un éléphant" }, - { "english": "I see the cat from yesterday", "french": "Je vois le chat d'hier" } - ] - } - }, - "audio": { - "withText": [ - { - "title": "Daily Routine Conversation", - "audioFile": "audio/daily_routine.mp3", - "transcript": "A: What time do you wake up? B: I usually wake up at 7 AM. A: That's early! I wake up at 8:30. B: I like to exercise before work. A: That's a good habit!", - "translation": "A: À quelle heure te réveilles-tu? B: Je me réveille habituellement à 7h. A: C'est tôt! Je me réveille à 8h30. B: J'aime faire de l'exercice avant le travail. A: C'est une bonne habitude!", - "timestamps": [ - { "time": 0.5, "text": "What time do you wake up?" }, - { "time": 3.2, "text": "I usually wake up at 7 AM" }, - { "time": 6.8, "text": "That's early! I wake up at 8:30" }, - { "time": 11.1, "text": "I like to exercise before work" }, - { "time": 14.5, "text": "That's a good habit!" } - ] - }, - { - "title": "Weather Report", - "audioFile": "audio/weather.mp3", - "transcript": "Today's weather: It's sunny and warm with a high of 25 degrees. Light winds from the south. Perfect day for outdoor activities!", - "translation": "Météo d'aujourd'hui: Il fait ensoleillé et chaud avec un maximum de 25 degrés. Vents légers du sud. Journée parfaite pour les activités extérieures!" - } - ], - "withoutText": [ - { - "title": "Mystery Conversation", - "audioFile": "audio/mystery.mp3", - "questions": [ - { "question": "How many people are speaking?", "type": "ai_interpreted" }, - { "question": "What are they talking about?", "type": "ai_interpreted" }, - { "question": "What is the mood of the conversation?", "type": "ai_interpreted" } - ] - } - ] - }, - "poems": [ - { - "title": "Roses Are Red", - "content": "Roses are red,\nViolets are blue,\nSugar is sweet,\nAnd so are you.", - "translation": "Les roses sont rouges,\nLes violettes sont bleues,\nLe sucre est doux,\nEt toi aussi.", - "audioFile": "audio/roses_poem.mp3", - "culturalContext": "Traditional English nursery rhyme pattern, often used to teach basic rhyming and poetry structure to children." - }, - { - "title": "Twinkle, Twinkle", - "content": "Twinkle, twinkle, little star,\nHow I wonder what you are.\nUp above the world so high,\nLike a diamond in the sky.", - "audioFile": "audio/twinkle.mp3", - "culturalContext": "Famous children's lullaby, one of the most recognizable songs in English-speaking countries." - } - ], - "fillInBlanks": [ - { - "sentence": "I _____ to school every day", - "options": ["go", "goes", "going", "went"], - "correctAnswer": "go", - "explanation": "Present simple with 'I' uses base form of verb" - }, - { - "sentence": "She _____ a book right now", - "options": ["read", "reads", "reading", "is reading"], - "correctAnswer": "is reading", - "explanation": "Present continuous for actions happening now" - }, - { - "sentence": "The weather is _____ today", - "type": "open_ended", - "acceptedAnswers": ["nice", "good", "beautiful", "sunny", "warm", "pleasant", "lovely"], - "aiPrompt": "Evaluate if the answer is a positive adjective that could describe good weather" - }, - { - "sentence": "I feel _____ when I listen to music", - "type": "open_ended", - "acceptedAnswers": ["happy", "relaxed", "calm", "peaceful", "good", "better"], - "aiPrompt": "Check if the answer describes a positive emotion or feeling" - } - ], - "corrections": [ - { - "incorrect": "I are happy today", - "correct": "I am happy today", - "explanation": "Use 'am' with pronoun 'I', not 'are'", - "type": "grammar_correction" - }, - { - "incorrect": "She don't like apples", - "correct": "She doesn't like apples", - "explanation": "Use 'doesn't' with he/she/it, not 'don't'", - "type": "grammar_correction" - }, - { - "incorrect": "I can to swim", - "correct": "I can swim", - "explanation": "After modal verbs like 'can', use base form without 'to'", - "type": "grammar_correction" - } - ], - "comprehension": [ - { - "text": "Sarah is a 25-year-old teacher who lives in London. Every morning, she wakes up at 6:30 AM and goes for a jog in the park near her house. After jogging, she has breakfast and reads the news. She loves her job because she enjoys working with children and helping them learn. On weekends, Sarah likes to visit museums and try new restaurants with her friends.", - "questions": [ - { - "question": "What is Sarah's profession?", - "type": "multiple_choice", - "options": ["Doctor", "Teacher", "Engineer", "Artist"], - "correctAnswer": "Teacher" - }, - { - "question": "What does Sarah do every morning?", - "type": "ai_interpreted", - "evaluationPrompt": "Check if answer mentions waking up early, jogging, and having breakfast" - }, - { - "question": "Why does Sarah love her job?", - "type": "ai_interpreted", - "evaluationPrompt": "Verify answer mentions working with children and helping them learn" - }, - { - "question": "How would you describe Sarah's lifestyle?", - "type": "ai_interpreted", - "evaluationPrompt": "Accept answers mentioning active, healthy, social, or organized lifestyle" - } - ] - } - ], - "matching": [ - { - "title": "Match Animals to Their Sounds", - "leftColumn": ["Cat", "Dog", "Cow", "Bird"], - "rightColumn": ["Woof", "Meow", "Tweet", "Moo"], - "correctPairs": [ - { "left": "Cat", "right": "Meow" }, - { "left": "Dog", "right": "Woof" }, - { "left": "Cow", "right": "Moo" }, - { "left": "Bird", "right": "Tweet" } - ] - }, - { - "title": "Match Colors in English and French", - "leftColumn": ["Red", "Blue", "Green", "Yellow"], - "rightColumn": ["Bleu", "Vert", "Rouge", "Jaune"], - "correctPairs": [ - { "left": "Red", "right": "Rouge" }, - { "left": "Blue", "right": "Bleu" }, - { "left": "Green", "right": "Vert" }, - { "left": "Yellow", "right": "Jaune" } - ] - } - ], - "sentences": [ - { "english": "Hello, how are you?", "french": "Bonjour, comment allez-vous?" }, - { "english": "I like to read books", "french": "J'aime lire des livres" }, - { "english": "The weather is nice today", "french": "Il fait beau aujourd'hui" }, - { "english": "Can you help me please?", "french": "Pouvez-vous m'aider s'il vous plaît?" } - ], - "texts": [ - { - "title": "My Daily Routine", - "content": "I wake up at 7 AM every day. First, I brush my teeth and take a shower. Then I have breakfast with my family. After breakfast, I go to work by bus. I work from 9 AM to 5 PM. In the evening, I cook dinner and watch TV. I go to bed at 10 PM.", - "translation": "Je me réveille à 7h tous les jours. D'abord, je me brosse les dents et prends une douche. Ensuite je prends le petit déjeuner avec ma famille. Après le petit déjeuner, je vais au travail en bus. Je travaille de 9h à 17h. Le soir, je cuisine le dîner et regarde la télé. Je me couche à 22h." - }, - { - "title": "The Four Seasons", - "content": "There are four seasons in a year: spring, summer, autumn, and winter. Spring is warm and flowers bloom. Summer is hot and sunny. Autumn is cool and leaves change colors. Winter is cold and it sometimes snows.", - "translation": "Il y a quatre saisons dans une année: le printemps, l'été, l'automne et l'hiver. Le printemps est chaud et les fleurs fleurissent. L'été est chaud et ensoleillé. L'automne est frais et les feuilles changent de couleur. L'hiver est froid et il neige parfois." - } - ], - "dialogues": [ - { - "title": "At the Restaurant", - "conversation": [ - { "speaker": "Waiter", "english": "Good evening! Welcome to our restaurant.", "french": "Bonsoir! Bienvenue dans notre restaurant." }, - { "speaker": "Customer", "english": "Thank you. Can I see the menu please?", "french": "Merci. Puis-je voir le menu s'il vous plaît?" }, - { "speaker": "Waiter", "english": "Of course! Here you are. What would you like to drink?", "french": "Bien sûr! Voici. Que voulez-vous boire?" }, - { "speaker": "Customer", "english": "I'll have a glass of water, please.", "french": "Je prendrai un verre d'eau, s'il vous plaît." } - ] - } - ] -} \ No newline at end of file diff --git a/english_exemple_commented.json b/english_exemple_commented.json deleted file mode 100644 index 04e7748..0000000 --- a/english_exemple_commented.json +++ /dev/null @@ -1,620 +0,0 @@ -{ - // ======================================== - // EDUCATIONAL CONTENT MODULE SPECIFICATION - // ======================================== - // This JSON defines a complete content module for language learning applications. - // All fields are OPTIONAL unless explicitly marked as REQUIRED. - // Systems should gracefully handle missing fields and adapt functionality accordingly. - - // === CORE METADATA (REQUIRED) === - // Essential identification and configuration data - "id": "english_class_demo_complete_example", // REQUIRED: Unique identifier (lowercase, underscores) - "name": "English Class Demo - Complete Example", // REQUIRED: Human-readable display name - "description": "Comprehensive example showcasing all content structure possibilities", // REQUIRED: Brief description - "difficulty": 6, // REQUIRED: Integer 1-10 (1=absolute beginner, 10=native level) - "original_lang": "english", // REQUIRED: ISO language code of source content - "user_lang": "french", // REQUIRED: ISO language code for translations - "icon": "assets/icons/uk-flag.svg", // OPTIONAL: Path to icon file (relative or absolute) - "icon_fallback": "🇬🇧", // REQUIRED if icon specified: Emoji fallback for missing files - - // === CLASSIFICATION SYSTEM === - // Used for content discovery, filtering, and game compatibility assessment - "tags": [ - // Content characteristics - systems can filter/search using these - "beginner-friendly", // Suitable for beginners (difficulty ≤ 4) - "audio-rich", // Contains significant audio content (>50% items have audio) - "grammar-focus", // Emphasizes grammar learning (has grammar section) - "cultural-content", // Includes cultural context (has cultural section) - "interactive", // Has interactive exercises (matching, corrections, etc.) - "daily-life", // Real-world applicable content - "conversation", // Dialogue-based learning (has dialogues section) - "multimedia" // Multiple content types (text, audio, visual) - ], - - // === LEARNING OBJECTIVES === - // Skills and competencies this module addresses - used for progress tracking - "skills_covered": [ - "vocabulary_recognition", // Identifying and understanding words - "vocabulary_production", // Using words correctly in context - "listening_comprehension", // Understanding spoken language - "reading_comprehension", // Understanding written text - "pronunciation", // Correct sound production - "grammar_application", // Using grammar rules correctly - "cultural_awareness", // Understanding cultural context - "conversation_skills", // Interactive dialogue ability - "translation", // Converting between languages - "pattern_recognition", // Identifying linguistic patterns - "error_correction", // Identifying and fixing mistakes - "audio_discrimination" // Distinguishing between sounds - ], - - // ======================================== - // VOCABULARY SECTION - PROGRESSIVE COMPLEXITY - // ======================================== - // Word definitions with varying levels of detail. Systems should adapt based on available data. - "vocabulary": { - - // LEVEL 1: MINIMAL (Translation only) - // Simplest form - just word and translation string - // Usage: Basic vocabulary games, simple matching - "cat": "chat", - "dog": "chien", - "house": "maison", - - // LEVEL 2: BASIC (Essential data) - // Translation + grammatical type - // Usage: Games that need word categorization - "book": { - "translation": "livre", - "type": "noun" // Values: noun, verb, adjective, adverb, greeting, number, etc. - }, - - "read": { - "translation": "lire", - "type": "verb" - }, - - // LEVEL 3: MEDIUM (Enhanced with media OR pronunciation) - // Add ONE media type: pronunciation OR image - // Usage: Games with visual or audio components - "apple": { - "translation": "pomme", - "type": "noun", - "pronunciation": "/ˈæp.əl/", // IPA phonetic notation (recommended format) - "image": "images/vocabulary/apple.jpg" // Path to image file - }, - - "beautiful": { - "translation": "beau/belle", - "type": "adjective", - "pronunciation": "/ˈbjuː.tɪ.fəl/", - "examples": ["The sunset is beautiful"] // Array of usage examples - }, - - // LEVEL 4: RICH (Multi-media) - // Multiple media types for enhanced learning - // Usage: Advanced vocabulary games, multimedia lessons - "elephant": { - "translation": "éléphant", - "type": "noun", - "pronunciation": "/ˈel.ɪ.fənt/", - "audio": "audio/vocabulary/elephant.mp3", // Audio pronunciation file - "image": "images/vocabulary/elephant.jpg", // Visual representation - "examples": [ - "The elephant is huge", - "Elephants have good memory" - ] - }, - - // LEVEL 5: COMPREHENSIVE (Full linguistic data) - // Maximum detail for advanced language learning - // Usage: Professional language learning, detailed grammar games - "run": { - "translation": "courir", - "type": "verb", - "pronunciation": "/rʌn/", - "audio": "audio/vocabulary/run.mp3", - "image": "images/vocabulary/run_action.gif", // Can be GIF for actions - "examples": [ - "I run in the park every morning", - "She runs faster than me", - "They ran to catch the bus" - ], - "grammarNotes": "Irregular verb: run/runs/running/ran/run", // Teaching notes - "conjugation": { // Verb forms for grammar games - "present": ["run", "runs"], - "past": "ran", - "participle": "run", - "continuous": "running" - }, - "difficulty_context": "Physical action verb - easy to demonstrate" // Teaching hints - }, - - // LEVEL 6: ADVANCED (Cultural context) - // Includes cultural and contextual information - // Usage: Cultural awareness games, advanced language courses - "breakfast": { - "translation": "petit-déjeuner", - "type": "noun", - "pronunciation": "/ˈbrek.fəst/", - "audio": "audio/vocabulary/breakfast.mp3", - "image": "images/vocabulary/breakfast.jpg", - "examples": [ - "I have breakfast at 7 AM", - "What did you have for breakfast?", - "Breakfast is the most important meal" - ], - "cultural_note": "Traditional English breakfast includes eggs, bacon, beans, and toast" - } - }, - - // ======================================== - // GRAMMAR SYSTEM - STRUCTURED LESSONS - // ======================================== - // Step-by-step grammar instruction with alternating explanations and exercises - // NOTE: This system is for dedicated grammar games/apps, not general content games - "grammar": { - "present_simple_be": { // Lesson identifier (must be unique) - "id": "present_simple_be", // Same as key for validation - "title": "Present Simple - Verb 'to be'", // Display title - "difficulty": 3, // 1-10 scale - "prerequisite": null, // null = no prerequisite, or reference another lesson id - "estimated_time": 15, // Estimated minutes to complete - "learning_objectives": [ // Clear, measurable goals - "Conjugate 'to be' in present tense", - "Use 'to be' in affirmative sentences", - "Form questions with 'to be'" - ], - - // Sequential learning steps - MUST be in order - "steps": [ - { - "type": "explanation", // Types: "explanation" or "exercise" - "order": 1, // Integer ordering (must be sequential) - "title": "Introduction to 'be'", - "content": "The verb 'to be' is the most important verb in English. It has three forms in present tense.", - "translation": "Le verbe 'être' est le verbe le plus important en anglais. Il a trois formes au présent.", - "examples": [ // Array of example objects - { "original": "I am happy", "userLanguage": "Je suis heureux" }, - { "original": "You are smart", "userLanguage": "Tu es intelligent" }, - { "original": "She is tall", "userLanguage": "Elle est grande" } - ] - }, - { - "type": "exercise", - "order": 2, - "exercise_type": "multiple_choice", // Exercise types: multiple_choice, transformation, fill_blanks, classification, conjugation - "title": "Choose the correct form", - "questions": [ // Array of question objects - { - "question": "I ___ a student", - "options": ["am", "is", "are"], // Array of choices - "correct": "am", // Single correct answer - "explanation": "Use 'am' with 'I'" // Feedback for learner - }, - { - "question": "She ___ my friend", - "options": ["am", "is", "are"], - "correct": "is", - "explanation": "Use 'is' with 'she', 'he', 'it'" - } - ] - }, - { - "type": "explanation", - "order": 3, - "title": "Negative forms", - "content": "To make negative sentences with 'be', add 'not' after the verb. We often use contractions.", - "translation": "Pour faire des phrases négatives avec 'être', ajoutez 'not' après le verbe. On utilise souvent des contractions.", - "examples": [ - { - "original": "I am not tired", - "userLanguage": "Je ne suis pas fatigué", - "contraction": "I'm not tired" // Optional contraction form - } - ] - }, - { - "type": "exercise", - "order": 4, - "exercise_type": "transformation", - "title": "Make these sentences negative", - "questions": [ - { - "original": "I am busy", // Source sentence - "correct": "I am not busy", // Primary correct answer - "alternative_correct": ["I'm not busy"] // Array of acceptable alternatives - } - ] - } - ], - - // Lesson summary and reinforcement - "summary": { - "key_points": [ // Main takeaways - "I am, you are, he/she/it is, we are, they are", - "Negative: add 'not' after 'be'", - "Questions: put 'be' before subject" - ], - "common_mistakes": [ // Frequent errors with corrections - { - "incorrect": "I are happy", - "correct": "I am happy", - "explanation": "Use 'am' with 'I'" - } - ] - } - } - }, - - // ======================================== - // TEXT CONTENT - FLEXIBLE USAGE - // ======================================== - // Text-based content that can optionally include exercises - "texts": [ - { - "title": "My Daily Routine", // Display title - "content": "I wake up at 7 AM every day. First, I brush my teeth and take a shower...", // Main text - "translation": "Je me réveille à 7h tous les jours. D'abord, je me brosse les dents...", // Full translation - - // OPTIONAL: Add comprehension questions to any text - "questions": [ - { - "question": "What time does the person wake up?", - "type": "multiple_choice", // Types: multiple_choice, ai_interpreted - "options": ["6 AM", "7 AM", "8 AM", "9 AM"], - "correctAnswer": "7 AM" - }, - { - "question": "Describe the person's evening routine", - "type": "ai_interpreted", // Requires AI evaluation - "evaluationPrompt": "Check if answer mentions cooking dinner and watching TV" // Prompt for AI evaluator - } - ], - - // OPTIONAL: Add fill-in-the-blank exercises to any text - "fillInBlanks": [ - { - "sentence": "I wake up ___ 7 AM every day", - "options": ["at", "in", "on"], // Multiple choice options - "correctAnswer": "at", - "explanation": "Use 'at' with specific times" - }, - { - "sentence": "The routine is very ___", - "type": "open_ended", // Open-ended answer - "acceptedAnswers": ["good", "nice", "healthy", "regular"], // Acceptable answers - "aiPrompt": "Check if answer describes routine positively" // AI evaluation prompt - } - ] - } - ], - - // ======================================== - // AUDIO-ONLY CONTENT - // ======================================== - // Pure listening exercises WITHOUT transcripts - // NOTE: Audio WITH text should go in texts[] or dialogues[] sections - "audio": [ - { - "title": "Mystery Conversation - Restaurant", - "audioFile": "audio/listening/restaurant_sounds.mp3", // Audio file path - "type": "ambient_listening", // Types: ambient_listening, sound_identification, pronunciation_exercise - "description": "Listen to the ambient sounds and conversation", // Optional description - "questions": [ // Listening comprehension questions - { - "question": "Where does this conversation take place?", - "type": "multiple_choice", - "options": ["Restaurant", "Office", "School", "Park"], - "correctAnswer": "Restaurant" - }, - { - "question": "How many people are speaking?", - "type": "ai_interpreted", - "evaluationPrompt": "Accept numeric answers indicating number of distinct voices" - } - ] - }, - { - "title": "Pronunciation Discrimination", - "audioFile": "audio/pronunciation/minimal_pairs.mp3", - "type": "pronunciation_exercise", - "description": "Listen to similar sounding words and identify differences", - "word_pairs": [ // For pronunciation exercises - ["ship", "sheep"], - ["live", "leave"], - ["cat", "cut"] - ] - } - ], - - // ======================================== - // CULTURAL CONTENT - RICH CONTEXT - // ======================================== - // Cultural material with educational value and context - "cultural": { - // Poetry and literary works - "poems": [ - { - "title": "Roses Are Red", - "content": "Roses are red,\nViolets are blue,\nSugar is sweet,\nAnd so are you.", - "translation": "Les roses sont rouges,\nLes violettes sont bleues...", - "audio": "audio/poems/roses.mp3", // Optional audio recitation - "image": "images/cultural/roses_poem_illustration.jpg", // Optional illustration - "type": "nursery_rhyme", // Types: nursery_rhyme, classic_poem, song, etc. - "cultural_context": "Traditional English nursery rhyme pattern...", - "learning_focus": ["rhyme_patterns", "basic_vocabulary", "rhythm"] // Educational objectives - } - ], - - // Proverbs and sayings - "proverbs": [ - { - "original": "The early bird catches the worm", - "userLanguage": "L'avenir appartient à ceux qui se lèvent tôt", - "meaning": "People who wake up early and start working have better chances of success", - "image": "images/cultural/early_bird_illustration.jpg", - "cultural_context": "Common English saying emphasizing the value of being proactive...", - "equivalent_proverbs": { // Cross-cultural equivalents - "french": "L'avenir appartient à ceux qui se lèvent tôt", - "literal": "Le premier oiseau attrape le ver" - } - } - ], - - // Unified cultural facts system - "culture_facts": [ - { - "name": "Tea Time", - "category": "tradition", // Categories: tradition, holiday, food, custom, etc. - "description": "Traditional British custom of drinking tea in the afternoon, usually around 4 PM", - "translation": "L'heure du thé - tradition britannique...", - "image": "images/cultural/tea_time.jpg", - "cultural_significance": "Social ritual that brings people together...", - "vocabulary_related": ["tea", "biscuit", "afternoon", "tradition", "social"], // Related vocabulary - "region": "uk" // Geographic association (uk, us, global, etc.) - }, - { - "name": "Christmas", - "category": "holiday", - "date": "December 25th", // Optional date field for holidays - "description": "Major Christian holiday celebrating the birth of Jesus Christ", - "translation": "Noël - grande fête chrétienne...", - "image": "images/cultural/christmas_celebration.jpg", - "customs": ["gift_giving", "family_gatherings", "christmas_tree", "caroling"], // Associated customs - "vocabulary_related": ["Christmas", "gift", "tree", "family", "celebration"], - "region": "global" - }, - { - "name": "Fish and Chips", - "category": "food", - "description": "Traditional British dish of battered fish with fried potatoes", - "translation": "Poisson-frites - plat britannique traditionnel...", - "image": "images/cultural/fish_and_chips.jpg", - "cultural_context": "Popular working-class meal, often served in newspaper wrapping", - "vocabulary_related": ["fish", "chips", "batter", "traditional", "popular"], - "region": "uk", - "ingredients": ["fish", "potatoes", "batter", "oil"], // For food items - "typical_sides": ["mushy_peas", "tartar_sauce", "malt_vinegar"] - } - ] - }, - - // ======================================== - // SENTENCES WITH PARAMETERS - // ======================================== - // Generic sentence structure used for various exercises including corrections - "sentences": [ - { - "original": "Hello, how are you?", // Source language sentence - "userLanguage": "Bonjour, comment allez-vous?", // Target language translation - "type": "greeting", // Sentence classification - "formality": "neutral" // Additional parameter - }, - { - "original": "I like to read books", - "userLanguage": "J'aime lire des livres", - "type": "preference_statement", - "tense": "present_simple" - }, - - // Sentences with correction exercise data - { - "original": "I am happy today", // CORRECT version - "userLanguage": "Je suis heureux aujourd'hui", - "type": "correction_target", // Indicates this is for correction exercises - "correction_data": { - "incorrect_versions": [ // Array of common mistakes - { - "text": "I are happy today", // Incorrect version - "error_type": "subject_verb_agreement", // Classification of error - "explanation": "Use 'am' with pronoun 'I', not 'are'", - "difficulty": 2 // Difficulty of catching this error (1-10) - }, - { - "text": "I is happy today", - "error_type": "subject_verb_agreement", - "explanation": "Use 'am' with pronoun 'I', not 'is'", - "difficulty": 1 // Easier to spot - } - ], - "grammar_focus": "be_verb_conjugation", // Grammar topic - "common_mistake": true // Boolean: is this a frequent error? - } - } - ], - - // ======================================== - // MATCHING EXERCISES - DUAL SYSTEM - // ======================================== - // Two types of matching exercises: traditional 2-column and flexible multi-column - "matching": [ - - // TYPE 1: Traditional two-column matching (backward compatibility) - { - "title": "Match Animals to Their Sounds", - "type": "two_column_matching", // Explicit type declaration - "leftColumn": ["Cat", "Dog", "Cow", "Bird"], // Left side items - "rightColumn": ["Woof", "Meow", "Tweet", "Moo"], // Right side items - "correctPairs": [ // Valid connections - { "left": "Cat", "right": "Meow" }, - { "left": "Dog", "right": "Woof" }, - { "left": "Cow", "right": "Moo" }, - { "left": "Bird", "right": "Tweet" } - ] - }, - - // TYPE 2: Multi-column matching (new flexible system) - { - "title": "Build Correct Sentences", - "type": "multi_column_matching", // Flexible N-column system - "columns": [ // Array of columns (minimum 2, no maximum) - { - "id": 1, // REQUIRED: Numeric identifier for referencing - "name": "Subject", // OPTIONAL: Display label (can be omitted) - "items": ["I", "She", "They", "We"] // REQUIRED: Items in this column - }, - { - "id": 2, - "name": "Verb", - "items": ["am", "is", "are", "are"] - }, - { - "id": 3, - "name": "Complement", - "items": ["happy", "a teacher", "students", "friends"] - } - ], - "valid_combinations": [ // Valid combinations using column IDs - {"1": "I", "2": "am", "3": "happy"}, // References by column ID - {"1": "I", "2": "am", "3": "a teacher"}, - {"1": "She", "2": "is", "3": "happy"}, - {"1": "She", "2": "is", "3": "a teacher"}, - {"1": "They", "2": "are", "3": "students"}, - {"1": "They", "2": "are", "3": "friends"}, - {"1": "We", "2": "are", "3": "students"}, - {"1": "We", "2": "are", "3": "friends"} - ] - }, - - // TYPE 2 Example without column names (demonstrates flexibility) - { - "title": "Match Country Information", - "type": "multi_column_matching", - "columns": [ - { - "id": 1, - "name": "Country", - "items": ["France", "Spain", "Italy", "Germany"] - }, - { - "id": 2, - "name": "Capital", - "items": ["Paris", "Madrid", "Rome", "Berlin"] - }, - { - "id": 3, - // NO "name" field - demonstrates optional nature - "items": ["French", "Spanish", "Italian", "German"] - } - ], - "valid_combinations": [ - {"1": "France", "2": "Paris", "3": "French"}, - {"1": "Spain", "2": "Madrid", "3": "Spanish"}, - {"1": "Italy", "2": "Rome", "3": "Italian"}, - {"1": "Germany", "2": "Berlin", "3": "German"} - ] - } - ], - - // ======================================== - // DIALOGUES - CONVERSATIONAL CONTENT - // ======================================== - // Structured conversations between speakers - // NOTE: Audio WITH text belongs here, not in audio[] section - "dialogues": [ - { - "title": "At the Restaurant", // Dialogue title - "conversation": [ // Array of turns in conversation - { - "speaker": "Waiter", // Speaker identification - "original": "Good evening! Welcome to our restaurant.", - "userLanguage": "Bonsoir! Bienvenue dans notre restaurant." - }, - { - "speaker": "Customer", - "original": "Thank you. Can I see the menu please?", - "userLanguage": "Merci. Puis-je voir le menu s'il vous plaît?" - } - ] - }, - - // Dialogue with synchronized audio - { - "title": "Daily Routine Conversation", - "audio": "audio/conversations/daily_routine.mp3", // Audio file with spoken dialogue - "conversation": [ - { - "speaker": "A", - "original": "What time do you wake up?", - "userLanguage": "À quelle heure te réveilles-tu?", - "timestamp": 0.5 // OPTIONAL: Time in audio file (seconds) - }, - { - "speaker": "B", - "original": "I usually wake up at 7 AM.", - "userLanguage": "Je me réveille habituellement à 7h.", - "timestamp": 3.2 - } - ] - } - ] - - // ======================================== - // IMPLEMENTATION NOTES FOR AI SYSTEMS - // ======================================== - /* - FIELD OPTIONALITY: - - All fields are optional unless marked REQUIRED - - Systems should gracefully handle missing fields - - Adapt functionality based on available data richness - - VOCABULARY LEVELS: - - Level 1 (string): Basic games only - - Level 2-3 (basic object): Standard games - - Level 4-6 (rich object): Advanced features - - EXERCISE TYPES: - - multiple_choice: Fixed options with single correct answer - - transformation: Convert one form to another - - fill_blanks: Complete sentences with missing words - - classification: Categorize items into groups - - conjugation: Verb form exercises - - ai_interpreted: Requires AI evaluation with prompt - - AUDIO PLACEMENT: - - audio[]: ONLY for content without transcripts - - texts[]/dialogues[]: For content WITH transcripts - - vocabulary.*.audio: Individual word pronunciation - - MATCHING SYSTEMS: - - two_column_matching: Traditional left-right matching - - multi_column_matching: Flexible N-column system with numeric IDs - - CULTURAL CONTENT: - - poems[]: Literary works with cultural context - - proverbs[]: Sayings with cross-cultural equivalents - - culture_facts[]: Unified system for traditions, holidays, food, customs - - ERROR HANDLING: - - Missing files (audio, images): Use fallbacks or skip features - - Invalid references: Ignore and continue with available content - - Malformed data: Log errors but don't crash, use defaults - - EXTENSIBILITY: - - New exercise types can be added without breaking existing systems - - Additional fields can be added to any section - - New sections can be added at root level - - Systems should ignore unknown fields gracefully - */ -} \ No newline at end of file diff --git a/english_exemple_fixed.json b/english_exemple_fixed.json deleted file mode 100644 index 11a7f00..0000000 --- a/english_exemple_fixed.json +++ /dev/null @@ -1,828 +0,0 @@ -{ - // === METADATA SECTION === - // Core module identification and language configuration - "id": "english_class_demo_complete_example", // Unique ID based on name (lowercase, underscores) - "name": "English Class Demo - Complete Example", - "description": "Comprehensive example showcasing all content structure possibilities", - "difficulty": 6, // Scale 1-10: 1=absolute beginner, 10=native level - "original_lang": "english", // Language of the original content - "user_lang": "french", // User's native language for translations - "icon": "assets/icons/uk-flag.svg", // Path to icon file - "icon_fallback": "🇬🇧", // Emoji fallback if file missing - - // === SYSTEM TAGS === - // Categorization for content discovery and filtering - "tags": [ - "beginner-friendly", // Suitable for beginners - "audio-rich", // Contains significant audio content - "grammar-focus", // Emphasizes grammar learning - "cultural-content", // Includes cultural context - "interactive", // Has interactive exercises - "daily-life", // Real-world applicable content - "conversation", // Dialogue-based learning - "multimedia" // Multiple content types (text, audio, visual) - ], - - // === SKILLS COVERED === - // Learning objectives and competencies addressed - "skills_covered": [ - "vocabulary_recognition", // Identifying and understanding words - "vocabulary_production", // Using words correctly in context - "listening_comprehension", // Understanding spoken language - "reading_comprehension", // Understanding written text - "pronunciation", // Correct sound production - "grammar_application", // Using grammar rules correctly - "cultural_awareness", // Understanding cultural context - "conversation_skills", // Interactive dialogue ability - "translation", // Converting between languages - "pattern_recognition", // Identifying linguistic patterns - "error_correction", // Identifying and fixing mistakes - "audio_discrimination" // Distinguishing between sounds - ], - - // === VOCABULARY SECTION === - // Multiple levels of vocabulary completion from minimal to comprehensive - "vocabulary": { - - // === MINIMAL LEVEL (Translation only) === - // Simplest form - just word and translation - "cat": "chat", - "dog": "chien", - "house": "maison", - - // === BASIC LEVEL (Essential data) === - // Translation + type - "book": { - "translation": "livre", - "type": "noun" - }, - - "read": { - "translation": "lire", - "type": "verb" - }, - - // === MEDIUM LEVEL (Common teaching elements) === - // Translation + type + pronunciation OR image - "apple": { - "translation": "pomme", - "type": "noun", - "pronunciation": "/ˈæp.əl/", - "image": "images/vocabulary/apple.jpg" // Visual representation - }, - - "beautiful": { - "translation": "beau/belle", - "type": "adjective", - "pronunciation": "/ˈbjuː.tɪ.fəl/", - "examples": ["The sunset is beautiful"] // Single example - }, - - // === RICH LEVEL (Audio + visual) === - // Multiple media types for enhanced learning - "elephant": { - "translation": "éléphant", - "type": "noun", - "pronunciation": "/ˈel.ɪ.fənt/", - "audio": "audio/vocabulary/elephant.mp3", - "image": "images/vocabulary/elephant.jpg", - "examples": [ - "The elephant is huge", - "Elephants have good memory" - ] - }, - - // === COMPREHENSIVE LEVEL (Full linguistic data) === - // All possible fields for maximum educational value - "run": { - "translation": "courir", - "type": "verb", - "pronunciation": "/rʌn/", - "audio": "audio/vocabulary/run.mp3", - "image": "images/vocabulary/run_action.gif", // Can be GIF for actions - "examples": [ - "I run in the park every morning", - "She runs faster than me", - "They ran to catch the bus" - ], - "grammarNotes": "Irregular verb: run/runs/running/ran/run", - "conjugation": { - "present": ["run", "runs"], - "past": "ran", - "participle": "run", - "continuous": "running" - }, - "difficulty_context": "Physical action verb - easy to demonstrate" - }, - - // === ADVANCED LEVEL (Cultural and contextual) === - "breakfast": { - "translation": "petit-déjeuner", - "type": "noun", - "pronunciation": "/ˈbrek.fəst/", - "audio": "audio/vocabulary/breakfast.mp3", - "image": "images/vocabulary/breakfast.jpg", - "examples": [ - "I have breakfast at 7 AM", - "What did you have for breakfast?", - "Breakfast is the most important meal" - ], - "cultural_note": "Traditional English breakfast includes eggs, bacon, beans, and toast" - } - }, - - // === GRAMMAR SYSTEM === - // Step-by-step grammar lessons with explanation -> exercise -> explanation -> exercise flow - "grammar": { - "present_simple_be": { - "id": "present_simple_be", - "title": "Present Simple - Verb 'to be'", - "difficulty": 3, - "prerequisite": null, // No prerequisite - foundational lesson - "estimated_time": 15, // minutes - "learning_objectives": [ - "Conjugate 'to be' in present tense", - "Use 'to be' in affirmative sentences", - "Form questions with 'to be'" - ], - - // Sequential steps: explanation -> exercise -> explanation -> exercise - "steps": [ - { - "type": "explanation", - "order": 1, - "title": "Introduction to 'be'", - "content": "The verb 'to be' is the most important verb in English. It has three forms in present tense.", - "translation": "Le verbe 'être' est le verbe le plus important en anglais. Il a trois formes au présent.", - "examples": [ - { "original": "I am happy", "userLanguage": "Je suis heureux" }, - { "original": "You are smart", "userLanguage": "Tu es intelligent" }, - { "original": "She is tall", "userLanguage": "Elle est grande" } - ] - }, - { - "type": "exercise", - "order": 2, - "exercise_type": "multiple_choice", - "title": "Choose the correct form", - "questions": [ - { - "question": "I ___ a student", - "options": ["am", "is", "are"], - "correct": "am", - "explanation": "Use 'am' with 'I'" - }, - { - "question": "She ___ my friend", - "options": ["am", "is", "are"], - "correct": "is", - "explanation": "Use 'is' with 'she', 'he', 'it'" - }, - { - "question": "They ___ teachers", - "options": ["am", "is", "are"], - "correct": "are", - "explanation": "Use 'are' with 'they', 'we', 'you'" - } - ] - }, - { - "type": "explanation", - "order": 3, - "title": "Negative forms", - "content": "To make negative sentences with 'be', add 'not' after the verb. We often use contractions.", - "translation": "Pour faire des phrases négatives avec 'être', ajoutez 'not' après le verbe. On utilise souvent des contractions.", - "examples": [ - { "original": "I am not tired", "userLanguage": "Je ne suis pas fatigué", "contraction": "I'm not tired" }, - { "original": "He is not here", "userLanguage": "Il n'est pas ici", "contraction": "He isn't here" }, - { "original": "We are not ready", "userLanguage": "Nous ne sommes pas prêts", "contraction": "We aren't ready" } - ] - }, - { - "type": "exercise", - "order": 4, - "exercise_type": "transformation", - "title": "Make these sentences negative", - "questions": [ - { - "original": "I am busy", - "correct": "I am not busy", - "alternative_correct": ["I'm not busy"] - }, - { - "original": "She is happy", - "correct": "She is not happy", - "alternative_correct": ["She isn't happy"] - }, - { - "original": "They are at home", - "correct": "They are not at home", - "alternative_correct": ["They aren't at home"] - } - ] - }, - { - "type": "explanation", - "order": 5, - "title": "Questions with 'be'", - "content": "To make questions, put the 'be' verb before the subject. The word order changes.", - "translation": "Pour faire des questions, mettez le verbe 'être' avant le sujet. L'ordre des mots change.", - "pattern": { - "statement": "Subject + be + complement", - "question": "Be + subject + complement + ?" - }, - "examples": [ - { - "statement": "You are ready", - "question": "Are you ready?", - "answer": "Yes, I am / No, I'm not" - }, - { - "statement": "He is a doctor", - "question": "Is he a doctor?", - "answer": "Yes, he is / No, he isn't" - } - ] - }, - { - "type": "exercise", - "order": 6, - "exercise_type": "transformation", - "title": "Transform to questions", - "questions": [ - { - "original": "You are tired", - "correct": "Are you tired?" - }, - { - "original": "She is a teacher", - "correct": "Is she a teacher?" - }, - { - "original": "They are students", - "correct": "Are they students?" - } - ] - }, - { - "type": "exercise", - "order": 7, - "exercise_type": "fill_blanks", - "title": "Complete the conversation", - "context": "A conversation between two people meeting for the first time", - "questions": [ - { - "sentence": "Hi! ___ you a new student?", - "correct": "Are", - "options": ["Are", "Is", "Am"] - }, - { - "sentence": "Yes, I ___. My name ___ Sarah.", - "correct": ["am", "is"], - "options": ["am/is", "is/am", "are/are"] - }, - { - "sentence": "___ you from France?", - "correct": "Are", - "options": ["Are", "Is", "Am"] - } - ] - } - ], - - // Summary and reinforcement - "summary": { - "key_points": [ - "I am, you are, he/she/it is, we are, they are", - "Negative: add 'not' after 'be'", - "Questions: put 'be' before subject" - ], - "common_mistakes": [ - { - "incorrect": "I are happy", - "correct": "I am happy", - "explanation": "Use 'am' with 'I'" - }, - { - "incorrect": "She am tired", - "correct": "She is tired", - "explanation": "Use 'is' with 'she'" - } - ] - } - }, - - "present_simple_verbs": { - "id": "present_simple_verbs", - "title": "Present Simple - Regular Verbs", - "difficulty": 4, - "prerequisite": "present_simple_be", // Must complete 'be' lesson first - "estimated_time": 20, - "learning_objectives": [ - "Use present simple for habits and facts", - "Add 's' for he/she/it", - "Form negatives with don't/doesn't" - ], - - "steps": [ - { - "type": "explanation", - "order": 1, - "title": "Present Simple usage", - "content": "We use present simple for habits, routines, facts, and things that are always true.", - "translation": "Nous utilisons le présent simple pour les habitudes, routines, faits, et choses toujours vraies.", - "examples": [ - { "original": "I work every day", "userLanguage": "Je travaille tous les jours", "usage": "routine" }, - { "original": "The sun rises in the east", "userLanguage": "Le soleil se lève à l'est", "usage": "fact" }, - { "original": "She likes coffee", "userLanguage": "Elle aime le café", "usage": "preference" } - ] - }, - { - "type": "exercise", - "order": 2, - "exercise_type": "classification", - "title": "Is it a habit, fact, or preference?", - "questions": [ - { - "sentence": "I eat breakfast at 8 AM", - "correct": "habit", - "options": ["habit", "fact", "preference"] - }, - { - "sentence": "Water boils at 100°C", - "correct": "fact", - "options": ["habit", "fact", "preference"] - }, - { - "sentence": "He loves music", - "correct": "preference", - "options": ["habit", "fact", "preference"] - } - ] - }, - { - "type": "explanation", - "order": 3, - "title": "Third person singular (he/she/it + s)", - "content": "With he, she, it, add 's' to the verb. This is very important in English!", - "translation": "Avec he, she, it, ajoutez 's' au verbe. C'est très important en anglais!", - "rules": [ - { "rule": "Normal verbs: add 's'", "example": "work → works, play → plays" }, - { "rule": "Verbs ending in s,x,ch,sh: add 'es'", "example": "watch → watches, fix → fixes" }, - { "rule": "Verbs ending in consonant + y: change y to ies", "example": "study → studies, try → tries" } - ], - "examples": [ - { "original": "I work in London", "userLanguage": "Je travaille à Londres" }, - { "original": "She works in London", "userLanguage": "Elle travaille à Londres" } - ] - }, - { - "type": "exercise", - "order": 4, - "exercise_type": "conjugation", - "title": "Add 's' when needed", - "questions": [ - { - "sentence": "He ___ (play) football", - "correct": "plays", - "base_verb": "play" - }, - { - "sentence": "She ___ (watch) TV", - "correct": "watches", - "base_verb": "watch" - }, - { - "sentence": "It ___ (fly) in the sky", - "correct": "flies", - "base_verb": "fly" - } - ] - } - ], - - "summary": { - "key_points": [ - "Present simple = habits, facts, preferences", - "He/she/it + verb + s", - "I/you/we/they + base verb" - ], - "common_mistakes": [ - { - "incorrect": "She work here", - "correct": "She works here", - "explanation": "Add 's' with he/she/it" - } - ] - } - } - }, - - // === TEXT CONTENT SECTION === - // All text-based content with optional question/exercise metadata - "texts": [ - { - "title": "My Daily Routine", - "content": "I wake up at 7 AM every day. First, I brush my teeth and take a shower. Then I have breakfast with my family. After breakfast, I go to work by bus. I work from 9 AM to 5 PM. In the evening, I cook dinner and watch TV. I go to bed at 10 PM.", - "translation": "Je me réveille à 7h tous les jours. D'abord, je me brosse les dents et prends une douche. Ensuite je prends le petit déjeuner avec ma famille. Après le petit déjeuner, je vais au travail en bus. Je travaille de 9h à 17h. Le soir, je cuisine le dîner et regarde la télé. Je me couche à 22h.", - // Optional: Add comprehension questions to any text - "questions": [ - { - "question": "What time does the person wake up?", - "type": "multiple_choice", - "options": ["6 AM", "7 AM", "8 AM", "9 AM"], - "correctAnswer": "7 AM" - }, - { - "question": "Describe the person's evening routine", - "type": "ai_interpreted", - "evaluationPrompt": "Check if answer mentions cooking dinner and watching TV" - } - ] - }, - - { - "title": "The Four Seasons", - "content": "There are four seasons in a year: spring, summer, autumn, and winter. Spring is warm and flowers bloom. Summer is hot and sunny. Autumn is cool and leaves change colors. Winter is cold and it sometimes snows.", - "translation": "Il y a quatre saisons dans une année: le printemps, l'été, l'automne et l'hiver. Le printemps est chaud et les fleurs fleurissent. L'été est chaud et ensoleillé. L'automne est frais et les feuilles changent de couleur. L'hiver est froid et il neige parfois.", - // Optional: Add fill-in-the-blank exercises to any text - "fillInBlanks": [ - { - "sentence": "There are _____ seasons in a year", - "options": ["three", "four", "five", "six"], - "correctAnswer": "four", - "explanation": "Spring, summer, autumn, and winter make four seasons" - }, - { - "sentence": "Spring is _____ and flowers bloom", - "type": "open_ended", - "acceptedAnswers": ["warm", "nice", "pleasant", "mild"], - "aiPrompt": "Check if answer describes spring weather positively" - } - ] - } - ], - - // === AUDIO-ONLY CONTENT === - // Pure listening exercises WITHOUT text/transcript (text-based audio goes in texts/dialogues) - "audio": [ - { - "title": "Mystery Conversation - Restaurant", - "audioFile": "audio/listening/restaurant_sounds.mp3", - "type": "ambient_listening", - "questions": [ - { - "question": "Where does this conversation take place?", - "type": "multiple_choice", - "options": ["Restaurant", "Office", "School", "Park"], - "correctAnswer": "Restaurant" - }, - { - "question": "How many people are speaking?", - "type": "ai_interpreted", - "evaluationPrompt": "Accept numeric answers indicating number of distinct voices" - } - ] - }, - { - "title": "Sound Recognition", - "audioFile": "audio/sounds/morning_routine.mp3", - "type": "sound_identification", - "description": "Listen and identify the morning routine sounds", - "questions": [ - { - "question": "What sounds did you hear?", - "type": "ai_interpreted", - "evaluationPrompt": "Check for mentions of alarm, shower, coffee, breakfast sounds" - } - ] - }, - { - "title": "Pronunciation Discrimination", - "audioFile": "audio/pronunciation/minimal_pairs.mp3", - "type": "pronunciation_exercise", - "description": "Listen to similar sounding words and identify differences", - "word_pairs": [ - ["ship", "sheep"], - ["live", "leave"], - ["cat", "cut"] - ] - } - ], - - // === CULTURAL CONTENT === - // Rich cultural material with context and educational value - "cultural": { - // Poetry and literary works - "poems": [ - { - "title": "Roses Are Red", - "content": "Roses are red,\nViolets are blue,\nSugar is sweet,\nAnd so are you.", - "translation": "Les roses sont rouges,\nLes violettes sont bleues,\nLe sucre est doux,\nEt toi aussi.", - "audio": "audio/poems/roses.mp3", - "image": "images/cultural/roses_poem_illustration.jpg", - "type": "nursery_rhyme", - "cultural_context": "Traditional English nursery rhyme pattern, often used to teach basic rhyming and poetry structure to children.", - "learning_focus": ["rhyme_patterns", "basic_vocabulary", "rhythm"] - } - ], - - // Proverbs and sayings - "proverbs": [ - { - "original": "The early bird catches the worm", - "userLanguage": "L'avenir appartient à ceux qui se lèvent tôt", - "meaning": "People who wake up early and start working have better chances of success", - "image": "images/cultural/early_bird_illustration.jpg", - "cultural_context": "Common English saying emphasizing the value of being proactive and starting early", - "equivalent_proverbs": { - "french": "L'avenir appartient à ceux qui se lèvent tôt", - "literal": "Le premier oiseau attrape le ver" - } - } - ], - - // Cultural facts - unified system for traditions, holidays, food, etc. - "culture_facts": [ - { - "name": "Tea Time", - "category": "tradition", - "description": "Traditional British custom of drinking tea in the afternoon, usually around 4 PM", - "translation": "L'heure du thé - tradition britannique de boire le thé l'après-midi, généralement vers 16h", - "image": "images/cultural/tea_time.jpg", - "cultural_significance": "Social ritual that brings people together, often includes biscuits or small cakes", - "vocabulary_related": ["tea", "biscuit", "afternoon", "tradition", "social"], - "region": "uk" - }, - { - "name": "Christmas", - "category": "holiday", - "date": "December 25th", - "description": "Major Christian holiday celebrating the birth of Jesus Christ", - "translation": "Noël - grande fête chrétienne célébrant la naissance de Jésus-Christ", - "image": "images/cultural/christmas_celebration.jpg", - "customs": ["gift_giving", "family_gatherings", "christmas_tree", "caroling"], - "vocabulary_related": ["Christmas", "gift", "tree", "family", "celebration"], - "region": "global" - }, - { - "name": "Fish and Chips", - "category": "food", - "description": "Traditional British dish of battered fish with fried potatoes", - "translation": "Poisson-frites - plat britannique traditionnel de poisson en pâte avec des pommes de terre frites", - "image": "images/cultural/fish_and_chips.jpg", - "cultural_context": "Popular working-class meal, often served in newspaper wrapping", - "vocabulary_related": ["fish", "chips", "batter", "traditional", "popular"], - "region": "uk", - "ingredients": ["fish", "potatoes", "batter", "oil"], - "typical_sides": ["mushy_peas", "tartar_sauce", "malt_vinegar"] - }, - { - "name": "Thanksgiving", - "category": "holiday", - "date": "Fourth Thursday in November", - "description": "American holiday celebrating gratitude and harvest", - "translation": "Action de grâce - fête américaine célébrant la gratitude et la récolte", - "image": "images/cultural/thanksgiving_dinner.jpg", - "customs": ["family_dinner", "turkey_meal", "gratitude_sharing", "football_watching"], - "vocabulary_related": ["thanksgiving", "turkey", "grateful", "harvest", "family"], - "region": "us" - } - ] - }, - - // === SENTENCES WITH CORRECTION PARAMETERS === - // Generic sentence structure that can be used for various exercises including corrections - "sentences": [ - { - "original": "Hello, how are you?", - "userLanguage": "Bonjour, comment allez-vous?", - "type": "greeting", - "formality": "neutral" - }, - { - "original": "I like to read books", - "userLanguage": "J'aime lire des livres", - "type": "preference_statement", - "tense": "present_simple" - }, - { - "original": "The weather is nice today", - "userLanguage": "Il fait beau aujourd'hui", - "type": "observation", - "topic": "weather" - }, - // Sentences specifically for correction exercises - { - "original": "I am happy today", // Correct version - "userLanguage": "Je suis heureux aujourd'hui", - "type": "correction_target", - "correction_data": { - "incorrect_versions": [ - { - "text": "I are happy today", - "error_type": "subject_verb_agreement", - "explanation": "Use 'am' with pronoun 'I', not 'are'", - "difficulty": 2 - }, - { - "text": "I is happy today", - "error_type": "subject_verb_agreement", - "explanation": "Use 'am' with pronoun 'I', not 'is'", - "difficulty": 1 - } - ], - "grammar_focus": "be_verb_conjugation", - "common_mistake": true - } - }, - { - "original": "She doesn't like apples", // Correct version - "userLanguage": "Elle n'aime pas les pommes", - "type": "correction_target", - "correction_data": { - "incorrect_versions": [ - { - "text": "She don't like apples", - "error_type": "subject_verb_agreement", - "explanation": "Use 'doesn't' with he/she/it, not 'don't'", - "difficulty": 3 - }, - { - "text": "She not like apples", - "error_type": "auxiliary_verb_missing", - "explanation": "Need auxiliary verb 'doesn't' for negative statements", - "difficulty": 4 - } - ], - "grammar_focus": "negative_present_simple", - "common_mistake": true - } - }, - { - "original": "I can swim", // Correct version - "userLanguage": "Je sais nager", - "type": "correction_target", - "correction_data": { - "incorrect_versions": [ - { - "text": "I can to swim", - "error_type": "infinitive_after_modal", - "explanation": "After modal verbs like 'can', use base form without 'to'", - "difficulty": 5 - } - ], - "grammar_focus": "modal_verbs", - "common_mistake": true - } - } - ], - - // === MATCHING EXERCISES === - // Connect-the-lines style exercises - "matching": [ - { - "title": "Match Animals to Their Sounds", - "type": "two_column_matching", - "leftColumn": ["Cat", "Dog", "Cow", "Bird"], - "rightColumn": ["Woof", "Meow", "Tweet", "Moo"], - "correctPairs": [ - { "left": "Cat", "right": "Meow" }, - { "left": "Dog", "right": "Woof" }, - { "left": "Cow", "right": "Moo" }, - { "left": "Bird", "right": "Tweet" } - ] - }, - { - "title": "Match Colors in English and French", - "type": "two_column_matching", - "leftColumn": ["Red", "Blue", "Green", "Yellow"], - "rightColumn": ["Bleu", "Vert", "Rouge", "Jaune"], - "correctPairs": [ - { "left": "Red", "right": "Rouge" }, - { "left": "Blue", "right": "Bleu" }, - { "left": "Green", "right": "Vert" }, - { "left": "Yellow", "right": "Jaune" } - ] - }, - { - "title": "Build Correct Sentences", - "type": "multi_column_matching", - "columns": [ - { - "id": 1, - "name": "Subject", - "items": ["I", "She", "They", "We"] - }, - { - "id": 2, - "name": "Verb", - "items": ["am", "is", "are", "are"] - }, - { - "id": 3, - "name": "Complement", - "items": ["happy", "a teacher", "students", "friends"] - } - ], - "valid_combinations": [ - {"1": "I", "2": "am", "3": "happy"}, - {"1": "I", "2": "am", "3": "a teacher"}, - {"1": "She", "2": "is", "3": "happy"}, - {"1": "She", "2": "is", "3": "a teacher"}, - {"1": "They", "2": "are", "3": "students"}, - {"1": "They", "2": "are", "3": "friends"}, - {"1": "We", "2": "are", "3": "students"}, - {"1": "We", "2": "are", "3": "friends"} - ] - }, - { - "title": "Match Country Information", - "type": "multi_column_matching", - "columns": [ - { - "id": 1, - "name": "Country", - "items": ["France", "Spain", "Italy", "Germany"] - }, - { - "id": 2, - "name": "Capital", - "items": ["Paris", "Madrid", "Rome", "Berlin"] - }, - { - "id": 3, - "items": ["French", "Spanish", "Italian", "German"] - } - ], - "valid_combinations": [ - {"1": "France", "2": "Paris", "3": "French"}, - {"1": "Spain", "2": "Madrid", "3": "Spanish"}, - {"1": "Italy", "2": "Rome", "3": "Italian"}, - {"1": "Germany", "2": "Berlin", "3": "German"} - ] - } - ], - - - // === DIALOGUES === - // Structured conversations between speakers (text with audio goes here, not in audio section) - "dialogues": [ - { - "title": "At the Restaurant", - "conversation": [ - { - "speaker": "Waiter", - "original": "Good evening! Welcome to our restaurant.", - "userLanguage": "Bonsoir! Bienvenue dans notre restaurant." - }, - { - "speaker": "Customer", - "original": "Thank you. Can I see the menu please?", - "userLanguage": "Merci. Puis-je voir le menu s'il vous plaît?" - }, - { - "speaker": "Waiter", - "original": "Of course! Here you are. What would you like to drink?", - "userLanguage": "Bien sûr! Voici. Que voulez-vous boire?" - } - ] - }, - { - "title": "Daily Routine Conversation", - "audio": "audio/conversations/daily_routine.mp3", // Audio WITH text belongs here - "conversation": [ - { - "speaker": "A", - "original": "What time do you wake up?", - "userLanguage": "À quelle heure te réveilles-tu?", - "timestamp": 0.5 - }, - { - "speaker": "B", - "original": "I usually wake up at 7 AM.", - "userLanguage": "Je me réveille habituellement à 7h.", - "timestamp": 3.2 - }, - { - "speaker": "A", - "original": "That's early! I wake up at 8:30.", - "userLanguage": "C'est tôt! Je me réveille à 8h30.", - "timestamp": 6.8 - }, - { - "speaker": "B", - "original": "I like to exercise before work.", - "userLanguage": "J'aime faire de l'exercice avant le travail.", - "timestamp": 11.1 - }, - { - "speaker": "A", - "original": "That's a good habit!", - "userLanguage": "C'est une bonne habitude!", - "timestamp": 14.5 - } - ] - } - ] -} \ No newline at end of file diff --git a/english_exemple_ultra_commented.json b/english_exemple_ultra_commented.json deleted file mode 100644 index 863f0d9..0000000 --- a/english_exemple_ultra_commented.json +++ /dev/null @@ -1,2224 +0,0 @@ -{ - // ======================================================================================================== - // ======================================================================================================== - // EDUCATIONAL CONTENT MODULE SPECIFICATION - // COMPLETE REFERENCE IMPLEMENTATION - // ======================================================================================================== - // ======================================================================================================== - // - // This JSON file serves as the definitive specification and reference implementation for educational - // content modules used in language learning applications. It demonstrates EVERY possible field, - // parameter, and configuration option available in the system. - // - // CRITICAL IMPLEMENTATION NOTES FOR AI SYSTEMS: - // ============================================= - // 1. FIELD OPTIONALITY: Unless explicitly marked as "REQUIRED", every single field in this specification - // is OPTIONAL. AI systems and game engines MUST be designed to gracefully handle missing fields. - // Do NOT crash or throw errors when fields are absent - instead, adapt functionality based on - // available data richness. - // - // 2. PROGRESSIVE ENHANCEMENT: This specification follows a progressive enhancement model. Basic games - // can work with minimal data (just translations), while advanced features unlock as more data - // becomes available. AI systems should detect data richness and enable appropriate features. - // - // 3. BACKWARD COMPATIBILITY: This format maintains 100% backward compatibility with simpler formats. - // Legacy content using old structures will continue to work without modification. - // - // 4. EXTENSIBILITY: New fields and sections can be added without breaking existing implementations. - // AI systems should ignore unknown fields and continue processing known data. - // - // 5. VALIDATION: Before processing, AI systems should validate the basic structure but should NOT - // fail on missing optional fields. Use default values and graceful degradation. - // - // ======================================================================================================== - - // ======================================================================================================== - // CORE METADATA SECTION - // ======================================================================================================== - // This section contains essential identification and configuration data that every content module - // MUST provide. These fields are used for content discovery, compatibility assessment, and basic - // system functionality. Without these core fields, the content module cannot be processed. - - // REQUIRED: Unique identifier for this content module - // SPECIFICATION: Must be lowercase, use underscores for spaces, contain only alphanumeric characters - // USAGE: Used as primary key in databases, file naming, URL generation, and cross-references - // VALIDATION: Must be unique across all content modules in the system - // AI SYSTEMS: Use this for caching, indexing, and relationship mapping between modules - "id": "english_class_demo_complete_example", - - // REQUIRED: Human-readable display name for this content module - // SPECIFICATION: Should be concise but descriptive, maximum 100 characters recommended - // USAGE: Displayed in user interfaces, content browsers, and selection menus - // LOCALIZATION: This is in the original language; translations may be provided separately - // AI SYSTEMS: Use for search indexing, content recommendations, and display purposes - "name": "English Class Demo - Complete Example", - - // REQUIRED: Brief description explaining what this content module contains and teaches - // SPECIFICATION: Should be 1-3 sentences, maximum 300 characters, clear and informative - // USAGE: Shown in content previews, tooltips, and selection interfaces - // SEO: Should contain relevant keywords for content discovery - // AI SYSTEMS: Use for content categorization, similarity matching, and recommendation algorithms - "description": "Comprehensive example showcasing all content structure possibilities", - - // REQUIRED: Difficulty level on a standardized 1-10 scale - // SPECIFICATION: Integer values only, standardized meanings: - // 1-2: Absolute beginner (first words, basic greetings) - // 3-4: Beginner (simple sentences, basic grammar) - // 5-6: Intermediate (complex sentences, intermediate grammar) - // 7-8: Advanced (nuanced language, advanced concepts) - // 9-10: Native/Expert level (idioms, cultural subtleties, professional language) - // USAGE: Used for content filtering, prerequisite checking, and adaptive difficulty - // AI SYSTEMS: Critical for content sequencing and personalized learning path generation - "difficulty": 6, - - // REQUIRED: ISO 639-1 language code for the source/original language of the content - // SPECIFICATION: Two-letter lowercase ISO code (en, fr, es, de, etc.) - // USAGE: Determines the source language for all "original" fields throughout the module - // LOCALIZATION: Enables proper text-to-speech, spell checking, and grammar analysis - // AI SYSTEMS: Essential for language-specific processing and cross-language content mapping - "original_lang": "english", - - // REQUIRED: ISO 639-1 language code for the user's native language (translation target) - // SPECIFICATION: Two-letter lowercase ISO code, determines translation language - // USAGE: Defines the language for all "userLanguage" fields in the module - // PERSONALIZATION: Allows system to adapt content to user's native language - // AI SYSTEMS: Used for translation validation, cultural adaptation, and localized feedback - "user_lang": "french", - - // OPTIONAL: Path to icon file representing this content module - // SPECIFICATION: Can be relative path, absolute path, or URL. Supported formats: SVG, PNG, JPG, WebP - // FALLBACK: If file is missing or fails to load, use icon_fallback instead - // SIZING: Recommended size 64x64px minimum, should be square aspect ratio - // AI SYSTEMS: Validate file existence before display, implement graceful fallback to icon_fallback - "icon": "assets/icons/uk-flag.svg", - - // REQUIRED IF icon IS SPECIFIED: Emoji fallback for when icon file is unavailable - // SPECIFICATION: Single Unicode emoji character that represents the content theme - // USAGE: Displayed when icon file fails to load, in text-only interfaces, or minimal UIs - // ACCESSIBILITY: Should be descriptive and relevant to content theme - // AI SYSTEMS: Always validate this field exists when icon field is present - "icon_fallback": "🇬🇧", - - // ======================================================================================================== - // CLASSIFICATION AND TAGGING SYSTEM - // ======================================================================================================== - // This section provides structured metadata for content discovery, filtering, and automatic - // compatibility assessment. Tags enable AI systems to make intelligent decisions about content - // usage, game compatibility, and learning path optimization. - - // OPTIONAL: Array of classification tags for content discovery and filtering - // SPECIFICATION: Use lowercase, hyphen-separated tags from the standardized taxonomy below - // USAGE: Content browsers can filter by these tags, AI can assess game compatibility - // EXTENSIBILITY: New tags can be added, but use standard taxonomy when possible - // AI SYSTEMS: Use for automatic content categorization and compatibility scoring - "tags": [ - // CONTENT DIFFICULTY TAGS (mutually exclusive): - "beginner-friendly", // Suitable for beginners (difficulty ≤ 4) - // "intermediate-level", // For intermediate learners (difficulty 5-6) - // "advanced-content", // For advanced learners (difficulty 7-8) - // "expert-native", // For native/expert level (difficulty 9-10) - - // MEDIA RICHNESS TAGS (can combine multiple): - "audio-rich", // Contains significant audio content (>50% of vocabulary items have audio) - // "image-heavy", // Contains many images (>50% of vocabulary items have images) - // "video-content", // Contains video materials - // "text-only", // Primarily text-based content - - // LEARNING FOCUS TAGS (can combine multiple): - "grammar-focus", // Emphasizes grammar learning (has grammar section or grammar exercises) - // "vocabulary-focus", // Primarily vocabulary building - // "pronunciation-focus", // Emphasis on pronunciation and phonetics - // "conversation-focus", // Dialogue and speaking practice emphasis - - // CONTENT TYPE TAGS (can combine multiple): - "cultural-content", // Includes cultural context, traditions, customs (has cultural section) - "interactive", // Has interactive exercises (matching, corrections, fill-in-blanks) - "daily-life", // Real-world applicable content (practical situations) - "conversation", // Dialogue-based learning (has dialogues section) - "multimedia", // Multiple content types (text, audio, visual combined) - - // PEDAGOGICAL APPROACH TAGS (can combine multiple): - // "gamified", // Designed for game-based learning - // "formal-academic", // Academic/textbook style content - // "informal-casual", // Casual, conversational learning style - // "immersive", // Immersive, context-rich learning - - // THEMATIC CONTENT TAGS (can combine multiple): - // "business-english", // Professional/business context - // "travel-language", // Travel and tourism focused - // "academic-language", // Academic and educational contexts - // "everyday-situations" // Common daily life situations - ], - - // OPTIONAL: Array of learning skills and competencies addressed by this content module - // SPECIFICATION: Use standardized skill identifiers for consistency across modules - // USAGE: Progress tracking systems use this to map learning objectives and outcomes - // ASSESSMENT: AI tutoring systems can focus on specific skills based on this metadata - // ANALYTICS: Learning analytics can track skill development across multiple modules - "skills_covered": [ - // VOCABULARY SKILLS: - "vocabulary_recognition", // Passive vocabulary: recognizing and understanding words when encountered - "vocabulary_production", // Active vocabulary: using words correctly in speech and writing - "vocabulary_categorization", // Grouping words by themes, topics, or grammatical categories - - // LISTENING SKILLS: - "listening_comprehension", // Understanding spoken language in various contexts - "audio_discrimination", // Distinguishing between similar sounds, words, or phrases - "listening_for_detail", // Extracting specific information from audio content - "listening_for_gist", // Understanding general meaning and main ideas from audio - - // READING SKILLS: - "reading_comprehension", // Understanding written text at sentence and paragraph level - "reading_for_detail", // Extracting specific information from written text - "reading_fluency", // Reading smoothly and efficiently - "skimming_scanning", // Quick reading techniques for information gathering - - // SPEAKING AND PRONUNCIATION SKILLS: - "pronunciation", // Correct sound production and accent training - "intonation_stress", // Proper word stress and sentence intonation patterns - "oral_fluency", // Speaking smoothly and naturally - "conversation_skills", // Interactive dialogue ability and turn-taking - - // GRAMMAR AND STRUCTURE SKILLS: - "grammar_application", // Using grammar rules correctly in context - "sentence_construction", // Building grammatically correct sentences - "pattern_recognition", // Identifying linguistic patterns and structures - "error_correction", // Identifying and fixing grammatical mistakes - - // CULTURAL AND CONTEXTUAL SKILLS: - "cultural_awareness", // Understanding cultural context and appropriateness - "pragmatic_competence", // Using language appropriately in social contexts - "cross_cultural_communication", // Communicating effectively across cultures - - // COGNITIVE AND LEARNING SKILLS: - "translation", // Converting meaning between languages - "language_comparison", // Understanding similarities and differences between languages - "metalinguistic_awareness", // Understanding how language works as a system - "learning_strategies", // Developing effective language learning techniques - - // FUNCTIONAL SKILLS: - "task_completion", // Using language to accomplish specific tasks - "information_processing", // Understanding and organizing linguistic information - "critical_thinking", // Analyzing and evaluating language use and meaning - "creative_expression" // Using language for creative and personal expression - ], - - // ======================================================================================================== - // VOCABULARY SECTION - PROGRESSIVE COMPLEXITY - // ======================================================================================================== - // The vocabulary section demonstrates a progressive complexity model where content creators can - // start with basic word-translation pairs and gradually add richer linguistic data. This design - // ensures that simple content works in basic games while enabling advanced features as data - // richness increases. AI systems should detect the complexity level of each vocabulary entry - // and enable appropriate features accordingly. - // - // PROGRESSIVE COMPLEXITY LEVELS: - // ============================= - // Level 1 (MINIMAL): String value only - "word": "translation" - // Level 2 (BASIC): Object with translation and type - // Level 3 (MEDIUM): Adds pronunciation OR image (single media enhancement) - // Level 4 (RICH): Multiple media types (audio + image + examples) - // Level 5 (COMPREHENSIVE): Full linguistic data (conjugations, grammar notes) - // Level 6 (ADVANCED): Cultural context and regional variations - // - // AI GAME COMPATIBILITY MATRIX: - // ============================= - // Basic matching games: Require Level 1 minimum - // Pronunciation games: Require Level 3+ with pronunciation or audio - // Visual games: Require Level 3+ with images - // Grammar games: Require Level 5+ with conjugation data - // Cultural games: Require Level 6+ with cultural context - // - "vocabulary": { - - // ================================================================================================ - // LEVEL 1: MINIMAL COMPLEXITY - // ================================================================================================ - // DESCRIPTION: Simplest possible format - just a word and its translation as a string value - // USAGE: Perfect for basic vocabulary games, simple matching exercises, flashcards - // GAME COMPATIBILITY: Works with ALL game types that need basic translation pairs - // PERFORMANCE: Fastest to parse and process, minimal memory footprint - // AUTHORING: Easiest for content creators - just word pairs in spreadsheets - // AI PROCESSING: Detect by checking if value is string (not object) - - "cat": "chat", // English word -> French translation (string format) - "dog": "chien", // Simple word pair, no additional metadata - "house": "maison", // Minimal format ensures maximum compatibility - "water": "eau", // AI systems: treat these as basic vocabulary items - "food": "nourriture", // Enable basic matching, flashcard, and quiz games - - // ================================================================================================ - // LEVEL 2: BASIC COMPLEXITY - // ================================================================================================ - // DESCRIPTION: Object format with essential linguistic metadata - // ADDS: Grammatical type classification for enhanced game mechanics - // USAGE: Enables grammar-aware games, categorization exercises, word type sorting - // GAME COMPATIBILITY: Grammar games can now categorize words appropriately - // AUTHORING EASE: Still simple - just add one field for word type - // AI PROCESSING: Detect by checking for object with 'translation' and 'type' fields only - - "book": { - "translation": "livre", - "type": "noun" // REQUIRED: grammatical category for this word - // STANDARD VALUES: noun, verb, adjective, adverb, pronoun, - // preposition, conjunction, interjection, article, greeting, - // number, color, food, animal, body_part, clothing, etc. - // AI SYSTEMS: Use for word categorization games and grammar exercises - }, - - "read": { - "translation": "lire", - "type": "verb" // Enables verb conjugation games and grammar pattern recognition - }, - - "happy": { - "translation": "heureux", - "type": "adjective" // Enables adjective comparison games and descriptive exercises - }, - - // ================================================================================================ - // LEVEL 3: MEDIUM COMPLEXITY - // ================================================================================================ - // DESCRIPTION: Enhanced with ONE media type - either pronunciation OR image - // ADDS: Single multimedia enhancement for richer learning experience - // USAGE: Enables pronunciation games OR visual recognition games (not both) - // STRATEGY: Choose pronunciation for abstract words, images for concrete nouns - // GAME COMPATIBILITY: Unlocks pronunciation games OR visual matching games - // AUTHORING: Moderate effort - requires recording audio OR finding/creating images - // AI PROCESSING: Detect by presence of 'pronunciation' OR 'image' field (mutually exclusive at this level) - - "apple": { - "translation": "pomme", - "type": "noun", - "pronunciation": "/ˈæp.əl/", // IPA (International Phonetic Alphabet) notation - // SPECIFICATION: Use standard IPA symbols enclosed in forward slashes - // USAGE: Text-to-speech systems, pronunciation games, phonetic exercises - // VALIDATION: AI should verify IPA format correctness - // ALTERNATIVES: Can also accept simplified phonetic (AP-uhl) - "image": "images/vocabulary/apple.jpg" // Path to visual representation - // SPECIFICATION: Relative or absolute path, supports JPG, PNG, SVG, WebP - // USAGE: Visual vocabulary games, memory games, image-word matching - // FALLBACK: AI should handle missing image files gracefully - // SIZING: Recommended minimum 256x256px for clarity - }, - - "beautiful": { - "translation": "beau/belle", - "type": "adjective", - "pronunciation": "/ˈbjuː.tɪ.fəl/", - "examples": ["The sunset is beautiful"] // OPTIONAL: Array of usage examples in context - // USAGE: Help learners understand word usage and context - // SPECIFICATION: Use simple, clear sentences appropriate for difficulty level - // AI SYSTEMS: Can be used for context-based exercises and comprehension - }, - - // ================================================================================================ - // LEVEL 4: RICH COMPLEXITY - // ================================================================================================ - // DESCRIPTION: Multiple media types for comprehensive multimedia learning - // ADDS: Combination of audio, visual, and textual enhancements - // USAGE: Enables advanced vocabulary games with multiple sensory inputs - // LEARNING THEORY: Supports multiple learning styles (visual, auditory, kinesthetic) - // GAME COMPATIBILITY: Unlocks ALL types of multimedia vocabulary games - // AUTHORING: Significant effort - requires multiple media assets per word - // AI PROCESSING: Detect by presence of multiple media fields (audio + image + examples) - - "elephant": { - "translation": "éléphant", - "type": "noun", - "pronunciation": "/ˈel.ɪ.fənt/", - "audio": "audio/vocabulary/elephant.mp3", // Audio pronunciation file - // SPECIFICATION: MP3, WAV, or OGG format, max 10 seconds - // QUALITY: Clear, native speaker pronunciation, minimal background noise - // USAGE: Pronunciation games, listening exercises, audio-visual matching - // FALLBACK: If audio fails, use text-to-speech as backup - "image": "images/vocabulary/elephant.jpg", // Visual representation - // SPECIFICATION: High-quality image, clear subject, minimal background - // CONTEXT: Should show typical/recognizable example of the concept - // ACCESSIBILITY: Should work well with colorblind users - "examples": [ - "The elephant is huge", // Multiple usage examples - "Elephants have good memory" // Shows different contexts and grammatical patterns - ] - // AI SYSTEMS: Rich media enables sophisticated games like: - // - Audio-visual matching (hear word, click correct image) - // - Multi-modal memory games (audio + visual + text) - // - Pronunciation practice with visual feedback - // - Context-based sentence completion exercises - }, - - // ================================================================================================ - // LEVEL 5: COMPREHENSIVE COMPLEXITY - // ================================================================================================ - // DESCRIPTION: Complete linguistic analysis with grammatical patterns and relationships - // ADDS: Advanced linguistic metadata for professional language learning - // USAGE: Enables sophisticated grammar games, conjugation practice, linguistic analysis - // TARGET AUDIENCE: Advanced learners, language teachers, linguistic research - // GAME COMPATIBILITY: Unlocks advanced grammar games and linguistic pattern recognition - // AUTHORING: Expert-level effort - requires linguistic knowledge and detailed analysis - // AI PROCESSING: Detect by presence of 'conjugation' or 'grammarNotes' fields - - "run": { - "translation": "courir", - "type": "verb", - "pronunciation": "/rʌn/", - "audio": "audio/vocabulary/run.mp3", - "image": "images/vocabulary/run_action.gif", // SPECIFICATION: Can be GIF for action words - // USAGE: Animated images help demonstrate actions - // PERFORMANCE: Keep GIFs under 2MB for web performance - "examples": [ - "I run in the park every morning", // Present tense usage - "She runs faster than me", // Third person singular form - "They ran to catch the bus" // Past tense usage - shows verb conjugation in context - ], - "grammarNotes": "Irregular verb: run/runs/running/ran/run", // Educational notes for teachers/advanced learners - // USAGE: Displayed in grammar-focused exercises - // CONTENT: Should highlight important patterns, irregularities, or usage rules - "conjugation": { // OPTIONAL: Detailed verb conjugation patterns - "present": ["run", "runs"], // Array: [base form, third person singular] - "past": "ran", // Past tense form (string for regular, object for complex) - "participle": "run", // Past participle form - "continuous": "running" // Present participle / gerund form - // EXTENSIBILITY: Can add more tenses (future, conditional, subjunctive) as needed - // AI SYSTEMS: Use for automatic conjugation exercises and grammar pattern recognition - }, - "difficulty_context": "Physical action verb - easy to demonstrate" // Teaching hints for AI tutors - // USAGE: Helps AI systems provide contextual learning tips - // CONTENT: Pedagogical insights for optimal teaching approach - }, - - // ================================================================================================ - // LEVEL 6: ADVANCED COMPLEXITY (Cultural Context) - // ================================================================================================ - // DESCRIPTION: Maximum linguistic richness with cultural and contextual information - // ADDS: Cultural awareness, regional variations, cross-cultural understanding - // USAGE: Advanced cultural competency games, cross-cultural communication training - // TARGET AUDIENCE: Advanced learners, cultural immersion programs, international communication - // GAME COMPATIBILITY: Enables cultural awareness games and contextual learning - // AUTHORING: Expert cultural knowledge required, significant research effort - // AI PROCESSING: Detect by presence of 'cultural_note' field - - "breakfast": { - "translation": "petit-déjeuner", - "type": "noun", - "pronunciation": "/ˈbrek.fəst/", - "audio": "audio/vocabulary/breakfast.mp3", - "image": "images/vocabulary/breakfast.jpg", // Should show culturally representative breakfast - "examples": [ - "I have breakfast at 7 AM", - "What did you have for breakfast?", - "Breakfast is the most important meal" - ], - "cultural_note": "Traditional English breakfast includes eggs, bacon, beans, and toast" - // SPECIFICATION: Brief cultural context explaining cultural significance - // USAGE: Cultural awareness games, cross-cultural communication training - // CONTENT: Should explain cultural practices, traditions, or social norms - // LENGTH: Keep concise (1-2 sentences) for game integration - // AI SYSTEMS: Use for cultural competency assessment and awareness building - } - - // ================================================================================================ - // AI IMPLEMENTATION GUIDELINES FOR VOCABULARY - // ================================================================================================ - /* - COMPLEXITY DETECTION ALGORITHM: - ============================== - 1. Check if value is string -> Level 1 (Minimal) - 2. Check if object has only 'translation' and 'type' -> Level 2 (Basic) - 3. Check if has 'pronunciation' OR 'image' (not both) -> Level 3 (Medium) - 4. Check if has multiple media fields -> Level 4 (Rich) - 5. Check if has 'conjugation' or 'grammarNotes' -> Level 5 (Comprehensive) - 6. Check if has 'cultural_note' -> Level 6 (Advanced) - - GAME COMPATIBILITY MATRIX: - ========================= - Basic Flashcards: Level 1+ - Visual Matching: Level 3+ (with image) - Audio Pronunciation: Level 3+ (with pronunciation or audio) - Grammar Exercises: Level 5+ (with conjugation) - Cultural Games: Level 6+ (with cultural_note) - Advanced Multimedia: Level 4+ (with multiple media) - - ERROR HANDLING: - ============== - - Missing audio files: Fall back to text-to-speech - - Missing image files: Use default placeholder or skip visual components - - Invalid IPA pronunciation: Use simplified phonetic or skip pronunciation features - - Malformed conjugation: Fall back to basic form without conjugation exercises - - PERFORMANCE OPTIMIZATION: - ======================== - - Lazy load media files (audio, images) only when needed - - Cache processed vocabulary data for faster game startup - - Preload critical media for smooth gameplay experience - - Use progressive image loading for better perceived performance - */ - }, - - // ======================================================================================================== - // GRAMMAR SYSTEM - STRUCTURED PEDAGOGY - // ======================================================================================================== - // The grammar system implements a comprehensive pedagogical framework for step-by-step language - // instruction. It follows educational best practices with alternating explanation and practice phases, - // prerequisite tracking, and competency-based progression. This system is designed for dedicated - // grammar learning applications rather than general content games. - // - // PEDAGOGICAL FRAMEWORK: - // ===================== - // 1. SCAFFOLDED LEARNING: Each lesson builds on previous knowledge with clear prerequisites - // 2. INTERLEAVED PRACTICE: Explanations alternate with exercises for optimal retention - // 3. COMPETENCY MAPPING: Clear learning objectives and measurable outcomes - // 4. ADAPTIVE DIFFICULTY: Multiple exercise types accommodate different learning styles - // 5. IMMEDIATE FEEDBACK: Explanations provided for every exercise answer - // - // IMPLEMENTATION NOTES FOR AI SYSTEMS: - // =================================== - // - This system requires a dedicated grammar learning interface - // - Steps must be completed in order - do not allow skipping - // - Track completion status for prerequisite validation - // - Provide rich feedback using explanation fields - // - Adapt presentation based on user performance and learning style - // - "grammar": { - - // ================================================================================================ - // FOUNDATIONAL GRAMMAR LESSON EXAMPLE - // ================================================================================================ - // This lesson demonstrates the complete structure for grammar instruction, including all - // possible fields and educational components. AI systems should use this as a template - // for grammar lesson implementation. - - "present_simple_be": { // LESSON IDENTIFIER: Must be unique within this content module - // NAMING CONVENTION: Use descriptive, hierarchical naming - // VALIDATION: Must match the object key for consistency - - // === LESSON METADATA === - "id": "present_simple_be", // REQUIRED: Exact duplicate of object key (for validation) - "title": "Present Simple - Verb 'to be'", // REQUIRED: Human-readable lesson title for UI display - "difficulty": 3, // REQUIRED: Lesson difficulty on 1-10 scale - // GUIDELINE: Should align with overall module difficulty ±2 levels - "prerequisite": null, // REQUIRED: Reference to prerequisite lesson ID, or null if foundational - // VALIDATION: AI must verify prerequisite completion before allowing access - // DEPENDENCY CHAIN: Must not create circular dependencies - "estimated_time": 15, // REQUIRED: Estimated completion time in minutes - // USAGE: Help learners plan study sessions and set expectations - // ACCURACY: Should be realistic for average learner at stated difficulty level - - // === LEARNING OBJECTIVES === - "learning_objectives": [ // REQUIRED: Array of clear, measurable learning goals - // SPECIFICATION: Use action verbs (conjugate, identify, form, apply) - // ASSESSMENT: Each objective should be testable through lesson exercises - // GRANULARITY: 3-5 objectives per lesson for optimal focus - "Conjugate 'to be' in present tense", // Specific skill: verb conjugation - "Use 'to be' in affirmative sentences", // Application: positive statements - "Form questions with 'to be'" // Synthesis: interrogative transformation - ], - - // === INSTRUCTIONAL SEQUENCE === - // CRITICAL: Steps must be completed in order. AI systems should enforce sequential progression - // PEDAGOGY: Alternates between explanation (input) and exercise (practice) for optimal learning - // ADAPTIVITY: AI can adjust pacing based on user performance but must maintain sequence - "steps": [ - - // ======================================================================================== - // EXPLANATION STEP EXAMPLE - // ======================================================================================== - // Explanation steps provide new information, concepts, and examples before practice - - { - "type": "explanation", // REQUIRED: "explanation" or "exercise" - "order": 1, // REQUIRED: Sequential integer, must start at 1 - "title": "Introduction to 'be'", // REQUIRED: Brief title for this instructional step - "content": "The verb 'to be' is the most important verb in English. It has three forms in present tense.", - // REQUIRED: Main instructional content - // GUIDELINES: Clear, concise language appropriate for difficulty level - // LENGTH: 1-3 sentences for explanations, longer for complex concepts - "translation": "Le verbe 'être' est le verbe le plus important en anglais. Il a trois formes au présent.", - // REQUIRED: Translation in user's native language - // USAGE: Ensures comprehension for non-native speakers - // QUALITY: Should be natural, not literal translation - "examples": [ // OPTIONAL: Array of illustrative examples - { - "original": "I am happy", - "userLanguage": "Je suis heureux" - }, - { - "original": "You are smart", - "userLanguage": "Tu es intelligent" - }, - { - "original": "She is tall", - "userLanguage": "Elle est grande" - } - ] - }, - - // ======================================================================================== - // EXERCISE STEP - MULTIPLE CHOICE - // ======================================================================================== - // Exercise steps provide immediate practice of concepts just taught - - { - "type": "exercise", - "order": 2, - "exercise_type": "multiple_choice", // REQUIRED: Specific exercise format - // AVAILABLE TYPES: multiple_choice, transformation, - // fill_blanks, classification, conjugation, matching - "title": "Choose the correct form", // REQUIRED: Clear instruction for the exercise - "questions": [ // REQUIRED: Array of question objects - { - "question": "I ___ a student", // The exercise prompt with blank to fill - "options": ["am", "is", "are"], // Array of possible answers (2-5 options recommended) - "correct": "am", // The correct answer (must match one option exactly) - "explanation": "Use 'am' with 'I'" // REQUIRED: Feedback explaining why this answer is correct - // PEDAGOGY: Reinforces the grammatical rule - }, - { - "question": "She ___ my friend", - "options": ["am", "is", "are"], - "correct": "is", - "explanation": "Use 'is' with 'she', 'he', 'it'" - }, - { - "question": "They ___ teachers", - "options": ["am", "is", "are"], - "correct": "are", - "explanation": "Use 'are' with 'they', 'we', 'you'" - } - ] - }, - - // ======================================================================================== - // ADVANCED EXPLANATION WITH PATTERNS - // ======================================================================================== - // More complex explanations can include structured patterns and detailed examples - - { - "type": "explanation", - "order": 3, - "title": "Negative forms", - "content": "To make negative sentences with 'be', add 'not' after the verb. We often use contractions.", - "translation": "Pour faire des phrases négatives avec 'être', ajoutez 'not' après le verbe. On utilise souvent des contractions.", - "examples": [ - { - "original": "I am not tired", - "userLanguage": "Je ne suis pas fatigué", - "contraction": "I'm not tired" // OPTIONAL: Shows contracted form - }, - { - "original": "He is not here", - "userLanguage": "Il n'est pas ici", - "contraction": "He isn't here" - }, - { - "original": "We are not ready", - "userLanguage": "Nous ne sommes pas prêts", - "contraction": "We aren't ready" - } - ] - }, - - // ======================================================================================== - // EXERCISE STEP - TRANSFORMATION - // ======================================================================================== - // Transformation exercises require converting one form to another - - { - "type": "exercise", - "order": 4, - "exercise_type": "transformation", - "title": "Make these sentences negative", - "questions": [ - { - "original": "I am busy", // Source sentence to transform - "correct": "I am not busy", // Primary correct answer - "alternative_correct": ["I'm not busy"] // OPTIONAL: Array of acceptable alternatives - // USAGE: Accommodates contractions, word order variations - }, - { - "original": "She is happy", - "correct": "She is not happy", - "alternative_correct": ["She isn't happy"] - }, - { - "original": "They are at home", - "correct": "They are not at home", - "alternative_correct": ["They aren't at home"] - } - ] - }, - - // ======================================================================================== - // EXPLANATION WITH STRUCTURAL PATTERNS - // ======================================================================================== - // Advanced explanations can include formal patterns and systematic rules - - { - "type": "explanation", - "order": 5, - "title": "Questions with 'be'", - "content": "To make questions, put the 'be' verb before the subject. The word order changes.", - "translation": "Pour faire des questions, mettez le verbe 'être' avant le sujet. L'ordre des mots change.", - - "pattern": { // OPTIONAL: Formal grammatical patterns - "statement": "Subject + be + complement", // Pattern for statements - "question": "Be + subject + complement + ?" // Pattern for questions - // USAGE: Helps visual learners understand structural relationships - // EXTENSION: Can include negative patterns, other transformations - }, - - "examples": [ - { - "statement": "You are ready", // Statement form - "question": "Are you ready?", // Question form - "answer": "Yes, I am / No, I'm not" // OPTIONAL: Expected response patterns - }, - { - "statement": "He is a doctor", - "question": "Is he a doctor?", - "answer": "Yes, he is / No, he isn't" - } - ] - }, - - // ======================================================================================== - // CONTEXTUAL EXERCISE - // ======================================================================================== - // Exercises can include context to make practice more meaningful and engaging - - { - "type": "exercise", - "order": 6, - "exercise_type": "fill_blanks", - "title": "Complete the conversation", - "context": "A conversation between two people meeting for the first time", // OPTIONAL: Situational context - // USAGE: Makes exercises more engaging and realistic - // BENEFITS: Provides cultural context and practical application - "questions": [ - { - "sentence": "Hi! ___ you a new student?", - "correct": "Are", - "options": ["Are", "Is", "Am"] // Can include options for guidance - }, - { - "sentence": "Yes, I ___. My name ___ Sarah.", - "correct": ["am", "is"], // Multiple blanks require array of answers - "options": ["am/is", "is/am", "are/are"] // Can show combined options for clarity - }, - { - "sentence": "___ you from France?", - "correct": "Are", - "options": ["Are", "Is", "Am"] - } - ] - } - ], - - // === LESSON SUMMARY AND REINFORCEMENT === - // Provides consolidation and reference material for the completed lesson - "summary": { - "key_points": [ // REQUIRED: Essential takeaways from lesson - // FORMAT: Concise bullet points (3-7 items) - // CONTENT: Core rules, patterns, or concepts taught - "I am, you are, he/she/it is, we are, they are", // Conjugation pattern - "Negative: add 'not' after 'be'", // Negation rule - "Questions: put 'be' before subject" // Question formation rule - ], - "common_mistakes": [ // OPTIONAL: Frequent errors with corrections - // PEDAGOGY: Helps learners avoid typical pitfalls - // FORMAT: incorrect → correct with explanation - { - "incorrect": "I are happy", - "correct": "I am happy", - "explanation": "Use 'am' with 'I'" - }, - { - "incorrect": "She am tired", - "correct": "She is tired", - "explanation": "Use 'is' with 'she'" - } - ] - } - } - - // ================================================================================================ - // ADDITIONAL GRAMMAR LESSON EXAMPLE - // ================================================================================================ - // Demonstrates prerequisite system and lesson sequencing - - // "present_simple_verbs": { // Second lesson building on first - // "id": "present_simple_verbs", - // "title": "Present Simple - Regular Verbs", - // "difficulty": 4, // Slightly harder than prerequisite - // "prerequisite": "present_simple_be", // Must complete "be" lesson first - // "estimated_time": 20, // Longer, more complex lesson - // "learning_objectives": [ - // "Use present simple for habits and facts", - // "Add 's' for he/she/it", - // "Form negatives with don't/doesn't" - // ], - // // ... additional steps following same pattern - // } - - // ================================================================================================ - // AI IMPLEMENTATION GUIDELINES FOR GRAMMAR - // ================================================================================================ - /* - PREREQUISITE VALIDATION: - ====================== - - Check completion status before allowing lesson access - - Display prerequisite chain to learners - - Recommend review if prerequisite scores are low - - Prevent circular dependencies in lesson design - - STEP SEQUENCING: - =============== - - Enforce strict sequential progression (no skipping) - - Save progress after each completed step - - Allow review of previous steps within same lesson - - Resume from last incomplete step on lesson restart - - EXERCISE TYPE HANDLING: - ===================== - multiple_choice: Present options, validate single selection - transformation: Accept input, check against correct and alternatives - fill_blanks: Handle single or multiple blanks per question - classification: Sort items into categories - conjugation: Provide base verb, expect correct form - matching: Connect items from different columns - - FEEDBACK SYSTEMS: - ================ - - Always show explanation after answer (correct or incorrect) - - Provide immediate feedback, not delayed - - Use explanations to reinforce grammatical concepts - - Adapt feedback tone to learner's proficiency level - - PERFORMANCE TRACKING: - =================== - - Track completion time for each step - - Monitor error rates by exercise type - - Identify struggling concepts for review recommendations - - Generate progress reports for learner motivation - - ERROR HANDLING: - ============== - - Handle malformed lesson data gracefully - - Provide fallback content for missing steps - - Validate answer formats before processing - - Log errors for content improvement feedback - */ - }, - - // ======================================================================================================== - // TEXT CONTENT - FLEXIBLE INTEGRATION - // ======================================================================================================== - // The text content section provides reading materials that can optionally be enhanced with exercises. - // This flexible design allows content creators to start with simple reading texts and progressively - // add interactive elements. AI systems should detect the presence of exercise fields and enable - // appropriate interactive features while gracefully handling text-only content. - // - // DESIGN PHILOSOPHY: - // ================== - // 1. CONTENT FIRST: Texts are valuable on their own, exercises are enhancement - // 2. OPTIONAL INTERACTION: Any text can become interactive by adding exercise fields - // 3. MULTIPLE EXERCISE TYPES: Supports comprehension questions and fill-in-blanks in same text - // 4. CONTEXTUAL LEARNING: Exercises draw from the actual text content for authenticity - // 5. PROGRESSIVE ENHANCEMENT: Basic reading → comprehension → interactive completion - // - "texts": [ - - // ================================================================================================ - // BASIC TEXT WITH COMPREHENSION - // ================================================================================================ - // Demonstrates text with reading comprehension questions of multiple types - - { - "title": "My Daily Routine", // REQUIRED: Display title for the text - // USAGE: Shown in content browsers, reading interfaces - // LENGTH: Keep concise and descriptive - - "content": "I wake up at 7 AM every day. First, I brush my teeth and take a shower. Then I have breakfast with my family. After breakfast, I go to work by bus. I work from 9 AM to 5 PM. In the evening, I cook dinner and watch TV. I go to bed at 10 PM.", - // REQUIRED: Main text content for reading - // LANGUAGE: Should be in original_lang specified in metadata - // COMPLEXITY: Appropriate for stated difficulty level - // LENGTH: 50-500 words recommended for optimal engagement - - "translation": "Je me réveille à 7h tous les jours. D'abord, je me brosse les dents et prends une douche. Ensuite je prends le petit déjeuner avec ma famille. Après le petit déjeuner, je vais au travail en bus. Je travaille de 9h à 17h. Le soir, je cuisine le dîner et regarde la télé. Je me couche à 22h.", - // REQUIRED: Complete translation in user_lang - // QUALITY: Should be natural, culturally appropriate translation - // USAGE: Learning support, comprehension verification, cultural adaptation - - // OPTIONAL: Reading comprehension questions - // ACTIVATION: AI systems should detect presence of this field and enable comprehension mode - // VARIETY: Mix question types for comprehensive assessment - "questions": [ - { - "question": "What time does the person wake up?", // Factual recall question - "type": "multiple_choice", // QUESTION TYPES: multiple_choice, ai_interpreted - "options": ["6 AM", "7 AM", "8 AM", "9 AM"], // 3-5 options recommended - "correctAnswer": "7 AM" // Must match one option exactly - // AI PROCESSING: Straightforward validation, immediate feedback possible - }, - { - "question": "Describe the person's evening routine", // Open-ended comprehension - "type": "ai_interpreted", // Requires AI evaluation - "evaluationPrompt": "Check if answer mentions cooking dinner and watching TV" - // REQUIRED for ai_interpreted: Guidance for AI evaluator - // SPECIFICITY: Clear criteria for acceptable answers - // FLEXIBILITY: Allow for paraphrasing and varied expression - }, - { - "question": "How does the person get to work?", // Detail extraction - "type": "multiple_choice", - "options": ["by car", "by bus", "on foot", "by train"], - "correctAnswer": "by bus" - }, - { - "question": "What do you think about this daily routine? Is it healthy?", // Critical thinking - "type": "ai_interpreted", - "evaluationPrompt": "Accept thoughtful opinions about the routine's health aspects, whether positive or negative, as long as reasoning is provided" - } - ], - - // OPTIONAL: Fill-in-the-blank exercises based on the text content - // PEDAGOGY: Reinforces vocabulary and grammar from authentic reading material - // INTEGRATION: Blanks should come from actual text sentences for authenticity - "fillInBlanks": [ - { - "sentence": "I wake up ___ 7 AM every day", // Direct quote from text with blank - "options": ["at", "in", "on"], // Preposition practice - "correctAnswer": "at", - "explanation": "Use 'at' with specific times" // Grammar rule reinforcement - }, - { - "sentence": "I ___ breakfast with my family", // Vocabulary reinforcement - "options": ["have", "make", "do"], // Collocations practice - "correctAnswer": "have", - "explanation": "'Have breakfast' is the correct collocation" - }, - { - "sentence": "The daily routine seems very ___", // Open-ended vocabulary practice - "type": "open_ended", // No fixed options - "acceptedAnswers": ["organized", "structured", "regular", "busy", "normal"], // Multiple valid answers - "aiPrompt": "Accept descriptive adjectives that could reasonably describe a daily routine" - } - ] - }, - - // ================================================================================================ - // CONTENT-RICH TEXT EXAMPLE - // ================================================================================================ - // Demonstrates more complex text with cultural elements and varied exercise types - - { - "title": "The Four Seasons", - "content": "There are four seasons in a year: spring, summer, autumn, and winter. Spring is warm and flowers bloom. Summer is hot and sunny. Autumn is cool and leaves change colors. Winter is cold and it sometimes snows.", - "translation": "Il y a quatre saisons dans une année: le printemps, l'été, l'automne et l'hiver. Le printemps est chaud et les fleurs fleurissent. L'été est chaud et ensoleillé. L'automne est frais et les feuilles changent de couleur. L'hiver est froid et il neige parfois.", - - // VOCABULARY INTEGRATION: Questions can reference vocabulary from other sections - "questions": [ - { - "question": "How many seasons are there in a year?", - "type": "multiple_choice", - "options": ["three", "four", "five", "six"], - "correctAnswer": "four" - }, - { - "question": "Which season do you like best and why?", // Personal connection - "type": "ai_interpreted", - "evaluationPrompt": "Accept any season choice with reasonable explanation about weather, activities, or personal preferences" - } - ], - - "fillInBlanks": [ - { - "sentence": "There are _____ seasons in a year", - "options": ["three", "four", "five", "six"], - "correctAnswer": "four", - "explanation": "Spring, summer, autumn, and winter make four seasons" - }, - { - "sentence": "Spring is _____ and flowers bloom", - "type": "open_ended", - "acceptedAnswers": ["warm", "nice", "pleasant", "mild"], - "aiPrompt": "Check if answer describes spring weather positively" - } - ] - } - - // ================================================================================================ - // TEXT-ONLY EXAMPLE (Minimal Configuration) - // ================================================================================================ - // Demonstrates that texts can exist without exercises for simple reading practice - - // { - // "title": "Simple Reading Practice", - // "content": "This is a simple text for reading practice. It has no exercises attached.", - // "translation": "Ceci est un texte simple pour la pratique de lecture. Il n'a pas d'exercices attachés." - // // NO questions or fillInBlanks fields - just reading material - // // AI SYSTEMS: Should present this as reading-only content - // } - - // ================================================================================================ - // AI IMPLEMENTATION GUIDELINES FOR TEXTS - // ================================================================================================ - /* - CONTENT DETECTION: - ================= - - Check for presence of 'questions' field to enable comprehension mode - - Check for presence of 'fillInBlanks' field to enable interactive completion - - Present text-only content in reading mode without interactive elements - - Combine both modes if both fields are present - - QUESTION TYPE HANDLING: - ====================== - multiple_choice: Present options clearly, validate selection - ai_interpreted: Use evaluationPrompt for AI assessment, provide detailed feedback - Mix types within same text for varied assessment - - FILL-IN-BLANKS PROCESSING: - ========================= - Standard format: Present options, validate selection - Open-ended format: Use AI evaluation with acceptedAnswers as guidance - Hybrid approach: Accept predefined answers OR AI evaluation for flexibility - - CONTENT ADAPTATION: - ================== - - Adjust reading difficulty presentation based on user level - - Provide vocabulary support for difficult words - - Enable translation toggle for comprehension support - - Track reading time and comprehension scores - - EXERCISE INTEGRATION: - ==================== - - Present reading first, then exercises (or interleaved for advanced users) - - Reference text content in exercise feedback - - Allow re-reading during exercise completion - - Highlight relevant text sections for answers - - ACCESSIBILITY: - ============= - - Support text-to-speech for reading content - - Provide font size adjustment - - Enable high contrast mode for visual accessibility - - Support keyboard navigation for exercises - */ - ], - - // ======================================================================================================== - // AUDIO-ONLY CONTENT - PURE LISTENING - // ======================================================================================================== - // This section is specifically for audio content WITHOUT accompanying text or transcripts. - // The key distinction is that learners must rely solely on listening skills without textual support. - // Content that has both audio AND text should be placed in the texts[] or dialogues[] sections instead. - // - // PEDAGOGICAL PURPOSE: - // =================== - // 1. PURE LISTENING SKILLS: Develops audio comprehension without visual text cues - // 2. REAL-WORLD SIMULATION: Mimics authentic listening situations (conversations, announcements, etc.) - // 3. AUDIO DISCRIMINATION: Trains ear to distinguish sounds, accents, and speech patterns - // 4. CONTEXTUAL INFERENCE: Builds ability to understand meaning from audio context alone - // - // CONTENT GUIDELINES: - // ================== - // - Audio should be clear and professionally recorded - // - Background noise should be minimal unless part of the exercise design - // - Duration should be appropriate for difficulty level (30 seconds to 3 minutes) - // - Multiple speakers can be used for realistic conversation practice - // - "audio": [ - - // ================================================================================================ - // AMBIENT LISTENING EXERCISE - // ================================================================================================ - // Tests ability to identify context and extract information from environmental audio cues - - { - "title": "Mystery Conversation - Restaurant", // REQUIRED: Descriptive title for the exercise - "audioFile": "audio/listening/restaurant_sounds.mp3", // REQUIRED: Path to audio file - // SPECIFICATION: MP3, WAV, or OGG format - // QUALITY: Clear audio, appropriate volume levels - // DURATION: 30 seconds to 2 minutes recommended - - "type": "ambient_listening", // REQUIRED: Type of listening exercise - // TYPES: ambient_listening, sound_identification, - // pronunciation_exercise, dictation, conversation_analysis - - "description": "Listen to the ambient sounds and conversation", // OPTIONAL: Brief description of what to expect - // USAGE: Helps set learner expectations - // CONTENT: Should not give away answers - - "questions": [ // REQUIRED: Array of listening comprehension questions - { - "question": "Where does this conversation take place?", // Context identification - "type": "multiple_choice", - "options": ["Restaurant", "Office", "School", "Park"], - "correctAnswer": "Restaurant" - // PEDAGOGY: Tests ability to identify setting from audio context clues - }, - { - "question": "How many people are speaking?", // Audio discrimination - "type": "ai_interpreted", - "evaluationPrompt": "Accept numeric answers indicating number of distinct voices" - // CHALLENGE: Requires distinguishing between different speakers - }, - { - "question": "What is the mood or atmosphere of the conversation?", // Inference skills - "type": "ai_interpreted", - "evaluationPrompt": "Accept descriptions of mood such as friendly, formal, rushed, relaxed, etc." - // ADVANCED SKILL: Reading emotional context from audio cues - } - ] - }, - - // ================================================================================================ - // SOUND IDENTIFICATION EXERCISE - // ================================================================================================ - // Focuses on recognizing specific sounds and their sequence in daily life contexts - - { - "title": "Sound Recognition - Morning Routine", - "audioFile": "audio/sounds/morning_routine.mp3", - "type": "sound_identification", - "description": "Listen and identify the morning routine sounds in order", - - "questions": [ - { - "question": "What sounds did you hear in order?", // Sequencing challenge - "type": "ai_interpreted", - "evaluationPrompt": "Check for mentions of alarm clock, shower, coffee brewing, breakfast preparation sounds in logical sequence" - // COGNITIVE SKILL: Memory and sequencing from audio information - }, - { - "question": "Which sound happened first?", // Specific identification - "type": "multiple_choice", - "options": ["Alarm clock", "Shower running", "Coffee brewing", "Door closing"], - "correctAnswer": "Alarm clock" - }, - { - "question": "How long do you think this morning routine takes?", // Time estimation - "type": "ai_interpreted", - "evaluationPrompt": "Accept reasonable time estimates between 15-45 minutes with basic reasoning" - } - ] - }, - - // ================================================================================================ - // PRONUNCIATION DISCRIMINATION EXERCISE - // ================================================================================================ - // Specialized for training phonetic discrimination and pronunciation awareness - - { - "title": "Pronunciation Discrimination - Minimal Pairs", - "audioFile": "audio/pronunciation/minimal_pairs.mp3", - "type": "pronunciation_exercise", - "description": "Listen to similar sounding words and identify differences", - - "word_pairs": [ // OPTIONAL: Specific to pronunciation exercises - ["ship", "sheep"], // Minimal pair examples - ["live", "leave"], // Helps learners focus on specific sound differences - ["cat", "cut"] // Used for targeted pronunciation training - ], - - "questions": [ - { - "question": "Which word did you hear first in the first pair?", - "type": "multiple_choice", - "options": ["ship", "sheep"], - "correctAnswer": "ship" - // PRECISION SKILL: Distinguishing minimal sound differences - }, - { - "question": "How many different word pairs did you identify?", - "type": "multiple_choice", - "options": ["2", "3", "4", "5"], - "correctAnswer": "3" - // COUNTING SKILL: Audio attention and memory - } - ] - }, - - // ================================================================================================ - // DICTATION EXERCISE EXAMPLE - // ================================================================================================ - // Pure dictation without visual text support - advanced listening skill - - { - "title": "Simple Dictation - Numbers and Time", - "audioFile": "audio/dictation/numbers_time.mp3", - "type": "dictation", - "description": "Listen and write down exactly what you hear", - - "questions": [ - { - "question": "Write the time you heard", // Exact transcription required - "type": "ai_interpreted", - "evaluationPrompt": "Accept variations of 'three thirty', '3:30', 'half past three' for the time mentioned" - // PRECISION: Tests ability to capture specific information accurately - }, - { - "question": "How many numbers were mentioned in total?", // Quantitative listening - "type": "multiple_choice", - "options": ["3", "4", "5", "6"], - "correctAnswer": "4" - } - ] - } - - // ================================================================================================ - // AI IMPLEMENTATION GUIDELINES FOR AUDIO - // ================================================================================================ - /* - AUDIO FILE HANDLING: - =================== - - Validate audio file existence before presenting exercise - - Provide audio controls: play, pause, rewind, adjust speed - - Support multiple playback attempts (typically 2-3 times) - - Handle audio loading errors gracefully with user-friendly messages - - EXERCISE TYPE PROCESSING: - ======================== - ambient_listening: Focus on context and environment recognition - sound_identification: Emphasize specific sound recognition and sequencing - pronunciation_exercise: Use word_pairs data for focused phonetic training - dictation: Require exact or near-exact transcription accuracy - conversation_analysis: Analyze speaker interactions and communication patterns - - QUESTION RESPONSE HANDLING: - ========================== - multiple_choice: Standard validation against correct answer - ai_interpreted: Use evaluationPrompt for flexible assessment - Allow partial credit for complex listening tasks - Provide rich feedback referencing specific audio segments when possible - - ACCESSIBILITY AND USABILITY: - ============================ - - Provide volume controls and audio quality indicators - - Support keyboard shortcuts for audio control - - Enable subtitle toggle ONLY for accessibility needs (not for exercise content) - - Implement progress tracking for long audio files - - ADAPTIVE FEATURES: - ================= - - Allow playback speed adjustment (0.75x to 1.25x) - - Provide difficulty progression (start with clear audio, add background noise) - - Track listening patterns to identify problem areas - - Suggest replay strategies for improved comprehension - */ - ], - - // ======================================================================================================== - // CULTURAL CONTENT - COMPREHENSIVE CONTEXT - // ======================================================================================================== - // The cultural section provides rich contextual information that enhances language learning with - // cultural awareness and cross-cultural understanding. This content supports advanced pedagogical - // goals beyond pure language mechanics, helping learners understand the cultural framework in - // which the language operates. - // - // PEDAGOGICAL OBJECTIVES: - // ====================== - // 1. CULTURAL COMPETENCY: Understanding cultural norms, values, and practices - // 2. CONTEXTUAL LANGUAGE USE: Learning when and how to use language appropriately - // 3. CROSS-CULTURAL AWARENESS: Comparing and contrasting different cultural approaches - // 4. AUTHENTIC COMMUNICATION: Preparing for real-world cultural interactions - // 5. CULTURAL SENSITIVITY: Developing respect and understanding for cultural differences - // - "cultural": { - - // ================================================================================================ - // POETRY AND LITERARY WORKS - // ================================================================================================ - // Literary content provides cultural insights through traditional and contemporary works - - "poems": [ - { - "title": "Roses Are Red", // REQUIRED: Title of the literary work - "content": "Roses are red,\nViolets are blue,\nSugar is sweet,\nAnd so are you.", - // REQUIRED: Full text of the poem/literary work - // FORMAT: Use \n for line breaks in poetry - // PRESERVATION: Maintain original formatting and structure - - "translation": "Les roses sont rouges,\nLes violettes sont bleues,\nLe sucre est doux,\nEt toi aussi.", - // REQUIRED: Translation preserving poetic structure - // CHALLENGE: Maintain rhythm and rhyme when possible - // CULTURAL ADAPTATION: May require cultural equivalent rather than literal translation - - "audio": "audio/poems/roses.mp3", // OPTIONAL: Audio recitation of the poem - // QUALITY: Should demonstrate proper pronunciation and rhythm - // SPEAKER: Native speaker with clear articulation - - "image": "images/cultural/roses_poem_illustration.jpg", // OPTIONAL: Visual illustration - // CONTENT: Should enhance understanding or cultural context - // STYLE: Can be artistic, historical, or educational - - "type": "nursery_rhyme", // REQUIRED: Classification of literary work - // TYPES: nursery_rhyme, classic_poem, song, proverb, - // folk_tale, modern_poetry, traditional_chant - - "cultural_context": "Traditional English nursery rhyme pattern, often used to teach basic rhyming and poetry structure to children.", - // REQUIRED: Explanation of cultural significance - // CONTENT: Historical background, social context, usage patterns - // AUDIENCE: Should be accessible to language learners - - "learning_focus": ["rhyme_patterns", "basic_vocabulary", "rhythm"] - // OPTIONAL: Specific pedagogical elements highlighted - // USAGE: Guides teachers and AI systems on educational applications - // VALUES: linguistic features, cultural concepts, learning skills - } - ], - - // ================================================================================================ - // PROVERBS AND SAYINGS - // ================================================================================================ - // Traditional wisdom expressions that reveal cultural values and thinking patterns - - "proverbs": [ - { - "original": "The early bird catches the worm", // REQUIRED: Proverb in original language - "userLanguage": "L'avenir appartient à ceux qui se lèvent tôt", - // REQUIRED: Translation (may be cultural equivalent, not literal) - - "meaning": "People who wake up early and start working have better chances of success", - // REQUIRED: Plain language explanation of the proverb's meaning - // AUDIENCE: Should be clear to non-native speakers - // DEPTH: Explain both literal and metaphorical meanings - - "image": "images/cultural/early_bird_illustration.jpg", // OPTIONAL: Visual representation - // CONTENT: Can be literal (bird with worm) or metaphorical (early worker) - - "cultural_context": "Common English saying emphasizing the value of being proactive and starting early", - // REQUIRED: Cultural significance and usage context - // SCOPE: When, where, and by whom this proverb is commonly used - - "equivalent_proverbs": { // OPTIONAL: Cross-cultural equivalent expressions - "french": "L'avenir appartient à ceux qui se lèvent tôt", // Direct cultural equivalent - "literal": "Le premier oiseau attrape le ver" // Literal translation for comparison - // USAGE: Helps learners understand cultural translation vs. literal translation - // EXPANSION: Can include equivalents from multiple cultures - } - } - ], - - // ================================================================================================ - // UNIFIED CULTURAL FACTS SYSTEM - // ================================================================================================ - // Comprehensive system for various cultural elements: traditions, holidays, food, customs, etc. - // This unified approach allows for consistent data structure across different cultural domains. - - "culture_facts": [ - - // ============================================================================================ - // TRADITION EXAMPLE - // ============================================================================================ - { - "name": "Tea Time", // REQUIRED: Name of the cultural element - "category": "tradition", // REQUIRED: Type of cultural element - // CATEGORIES: tradition, holiday, food, custom, - // celebration, social_norm, business_practice, educational_practice - - "description": "Traditional British custom of drinking tea in the afternoon, usually around 4 PM", - // REQUIRED: Clear, factual description - // AUDIENCE: Accessible to non-native speakers and cultural outsiders - - "translation": "L'heure du thé - tradition britannique de boire le thé l'après-midi, généralement vers 16h", - // REQUIRED: Translation with cultural adaptation - // APPROACH: May include explanatory additions for cultural clarity - - "image": "images/cultural/tea_time.jpg", // OPTIONAL: Representative photograph or illustration - // CONTENT: Should show authentic cultural practice - // QUALITY: High quality, culturally respectful representation - - "cultural_significance": "Social ritual that brings people together, often includes biscuits or small cakes", - // OPTIONAL: Deeper cultural meaning and social function - // DEPTH: Explains WHY this practice is culturally important - - "vocabulary_related": ["tea", "biscuit", "afternoon", "tradition", "social"], - // OPTIONAL: Associated vocabulary for language learning - // INTEGRATION: Links cultural content with vocabulary learning - // USAGE: Can be used for themed vocabulary exercises - - "region": "uk" // OPTIONAL: Geographic/cultural region identifier - // VALUES: uk, us, australia, canada, global, etc. - // USAGE: Helps learners understand cultural scope and variation - }, - - // ============================================================================================ - // HOLIDAY EXAMPLE - // ============================================================================================ - { - "name": "Christmas", - "category": "holiday", - "date": "December 25th", // OPTIONAL: Specific date for holidays and celebrations - // FORMAT: Natural language date description - // CULTURAL VARIATION: Note when dates vary by culture/region - - "description": "Major Christian holiday celebrating the birth of Jesus Christ", - "translation": "Noël - grande fête chrétienne célébrant la naissance de Jésus-Christ", - "image": "images/cultural/christmas_celebration.jpg", - - "customs": ["gift_giving", "family_gatherings", "christmas_tree", "caroling"], - // OPTIONAL: Associated practices and traditions - // FORMAT: Array of short descriptive phrases - // USAGE: Vocabulary building and cultural understanding - - "vocabulary_related": ["Christmas", "gift", "tree", "family", "celebration"], - "region": "global" // Indicates widespread cultural adoption - }, - - // ============================================================================================ - // FOOD EXAMPLE - // ============================================================================================ - { - "name": "Fish and Chips", - "category": "food", - "description": "Traditional British dish of battered fish with fried potatoes", - "translation": "Poisson-frites - plat britannique traditionnel de poisson en pâte avec des pommes de terre frites", - "image": "images/cultural/fish_and_chips.jpg", - - "cultural_context": "Popular working-class meal, often served in newspaper wrapping", - // OPTIONAL: Social and historical context - // CONTENT: Class associations, historical development, social significance - - "vocabulary_related": ["fish", "chips", "batter", "traditional", "popular"], - "region": "uk", - - "ingredients": ["fish", "potatoes", "batter", "oil"], - // OPTIONAL: Specific to food items - // USAGE: Cooking vocabulary, dietary information - - "typical_sides": ["mushy_peas", "tartar_sauce", "malt_vinegar"] - // OPTIONAL: Additional food vocabulary and cultural eating patterns - }, - - // ============================================================================================ - // HOLIDAY WITH REGIONAL VARIATION - // ============================================================================================ - { - "name": "Thanksgiving", - "category": "holiday", - "date": "Fourth Thursday in November", // US-specific date format - "description": "American holiday celebrating gratitude and harvest", - "translation": "Action de grâce - fête américaine célébrant la gratitude et la récolte", - "image": "images/cultural/thanksgiving_dinner.jpg", - - "customs": ["family_dinner", "turkey_meal", "gratitude_sharing", "football_watching"], - "vocabulary_related": ["thanksgiving", "turkey", "grateful", "harvest", "family"], - "region": "us" // Region-specific cultural element - } - - // ============================================================================================ - // ADDITIONAL CULTURAL CATEGORY EXAMPLES - // ============================================================================================ - // Additional categories can include: - // - business_practice: "Bowing in Japanese business meetings" - // - social_norm: "Queuing politely in British culture" - // - educational_practice: "Raising hand to speak in American classrooms" - // - celebration: "Quinceañera in Latin American culture" - // - custom: "Removing shoes before entering homes in many Asian cultures" - ] - - // ================================================================================================ - // AI IMPLEMENTATION GUIDELINES FOR CULTURAL CONTENT - // ================================================================================================ - /* - CULTURAL SENSITIVITY: - ==================== - - Present cultural information respectfully and accurately - - Avoid stereotypes and overgeneralizations - - Include cultural variations within same regions/countries - - Acknowledge cultural evolution and contemporary changes - - CONTENT ORGANIZATION: - ==================== - - Use category field for systematic organization and filtering - - Enable region-based filtering for location-specific learning - - Cross-reference vocabulary_related with main vocabulary section - - Link cultural facts to relevant exercises and activities - - MULTIMEDIA INTEGRATION: - ====================== - - Validate image files and provide meaningful alt text - - Support audio pronunciation for cultural terms - - Enable interactive cultural comparison exercises - - Provide visual cultural timelines for historical context - - PEDAGOGICAL APPLICATIONS: - ======================== - - Create cultural awareness quizzes using culture_facts data - - Develop comparative culture exercises across regions - - Integrate cultural vocabulary into standard language games - - Generate discussion prompts for cultural exchange - - ACCESSIBILITY AND INCLUSION: - =========================== - - Provide multiple cultural perspectives on shared practices - - Include contemporary as well as traditional cultural elements - - Support learners from diverse cultural backgrounds - - Enable cultural reflection and comparison exercises - */ - }, - - // ======================================================================================================== - // SENTENCES WITH COMPREHENSIVE PARAMETERS - // ======================================================================================================== - // The sentences section serves as a versatile, unified system for various language exercises including - // translation practice, grammar correction, and contextual learning. This design eliminates redundancy - // by using a single data structure with rich parameters to support multiple exercise types. - // - // DESIGN PHILOSOPHY: - // ================== - // 1. UNIFIED STRUCTURE: One sentence format supports multiple exercise types - // 2. RICH PARAMETERS: Extensive metadata enables sophisticated exercise generation - // 3. CORRECTION INTEGRATION: Includes both correct forms and common errors - // 4. CONTEXTUAL CLASSIFICATION: Sentences tagged for situational appropriateness - // 5. PROGRESSIVE COMPLEXITY: From simple translation to advanced error correction - // - "sentences": [ - - // ================================================================================================ - // BASIC SENTENCE EXAMPLES - // ================================================================================================ - // Simple sentences with fundamental classification for basic exercises - - { - "original": "Hello, how are you?", // REQUIRED: Source language sentence - "userLanguage": "Bonjour, comment allez-vous?", // REQUIRED: Target language translation - "type": "greeting", // REQUIRED: Functional classification - // TYPES: greeting, question, statement, command, exclamation, - // request, invitation, apology, thanks, goodbye - - "formality": "neutral" // OPTIONAL: Register and appropriateness level - // VALUES: formal, neutral, informal, casual, intimate - // USAGE: Teaches sociolinguistic appropriateness - }, - - { - "original": "I like to read books", - "userLanguage": "J'aime lire des livres", - "type": "preference_statement", // Semantic classification - "tense": "present_simple" // OPTIONAL: Grammatical tense identification - // VALUES: present_simple, present_continuous, past_simple, etc. - // USAGE: Grammar-focused exercises and tense practice - }, - - { - "original": "The weather is nice today", - "userLanguage": "Il fait beau aujourd'hui", - "type": "observation", - "topic": "weather" // OPTIONAL: Thematic classification - // VALUES: weather, food, family, work, travel, health, etc. - // USAGE: Thematic vocabulary exercises and conversation practice - }, - - // ================================================================================================ - // CORRECTION-ENABLED SENTENCES - // ================================================================================================ - // Sentences with comprehensive error correction data for grammar instruction - - { - "original": "I am happy today", // CORRECT version serves as the teaching target - "userLanguage": "Je suis heureux aujourd'hui", - "type": "correction_target", // REQUIRED: Indicates this sentence has error correction data - - "correction_data": { // REQUIRED for correction_target type - "incorrect_versions": [ // Array of common mistakes and their analysis - { - "text": "I are happy today", // The incorrect sentence learners might produce - "error_type": "subject_verb_agreement", // Classification of the grammatical error - // TYPES: subject_verb_agreement, tense_error, word_order, - // article_error, preposition_error, spelling_error, etc. - - "explanation": "Use 'am' with pronoun 'I', not 'are'", - // REQUIRED: Clear explanation of why it's wrong - // PEDAGOGY: Should teach the underlying rule - - "difficulty": 2 // OPTIONAL: How hard this error is to catch (1-10 scale) - // USAGE: Adaptive error presentation based on learner level - }, - { - "text": "I is happy today", - "error_type": "subject_verb_agreement", - "explanation": "Use 'am' with pronoun 'I', not 'is'", - "difficulty": 1 // Easier error to spot than the previous one - } - ], - - "grammar_focus": "be_verb_conjugation", // OPTIONAL: Main grammatical concept being taught - // INTEGRATION: Links to grammar section lessons - // VALUES: Should match grammar lesson IDs when possible - - "common_mistake": true // OPTIONAL: Boolean indicating if this is a frequent error - // USAGE: Prioritize common mistakes in error correction exercises - } - }, - - { - "original": "She doesn't like apples", // Another correction example with different error types - "userLanguage": "Elle n'aime pas les pommes", - "type": "correction_target", - "correction_data": { - "incorrect_versions": [ - { - "text": "She don't like apples", - "error_type": "subject_verb_agreement", - "explanation": "Use 'doesn't' with he/she/it, not 'don't'", - "difficulty": 3 - }, - { - "text": "She not like apples", - "error_type": "auxiliary_verb_missing", - "explanation": "Need auxiliary verb 'doesn't' for negative statements", - "difficulty": 4 - } - ], - "grammar_focus": "negative_present_simple", - "common_mistake": true - } - }, - - { - "original": "I can swim", // Modal verb correction example - "userLanguage": "Je sais nager", - "type": "correction_target", - "correction_data": { - "incorrect_versions": [ - { - "text": "I can to swim", - "error_type": "infinitive_after_modal", - "explanation": "After modal verbs like 'can', use base form without 'to'", - "difficulty": 5 - } - ], - "grammar_focus": "modal_verbs", - "common_mistake": true - } - }, - - // ================================================================================================ - // CONTEXTUALLY RICH SENTENCES - // ================================================================================================ - // Sentences with extensive contextual metadata for sophisticated exercises - - { - "original": "Could you please pass the salt?", - "userLanguage": "Pourriez-vous me passer le sel, s'il vous plaît?", - "type": "polite_request", - "formality": "formal", - "topic": "dining", - "situation": "restaurant_meal", // OPTIONAL: Specific situational context - // VALUES: restaurant_meal, business_meeting, family_dinner, - // casual_conversation, phone_call, etc. - // USAGE: Situational language practice and appropriateness training - - "cultural_note": "Polite request format commonly used in formal dining situations" - // OPTIONAL: Cultural usage information - // INTEGRATION: Links sentence usage to cultural practices - }, - - { - "original": "I'm running late for the meeting", - "userLanguage": "Je suis en retard pour la réunion", - "type": "statement", - "formality": "neutral", - "topic": "work", - "situation": "business_context", - "tense": "present_continuous", - "emotion": "stress" // OPTIONAL: Emotional context - // VALUES: happiness, stress, anger, excitement, sadness, etc. - // USAGE: Emotional expression exercises and empathy building - } - - // ================================================================================================ - // SPECIALIZED SENTENCE TYPES - // ================================================================================================ - // Examples of sentences optimized for specific learning objectives - - // PRONUNCIATION FOCUS: - // { - // "original": "She sells seashells by the seashore", - // "userLanguage": "Elle vend des coquillages au bord de mer", - // "type": "tongue_twister", - // "pronunciation_focus": ["s_sound", "sh_sound"], - // "difficulty_pronunciation": 8 - // } - - // IDIOM TEACHING: - // { - // "original": "It's raining cats and dogs", - // "userLanguage": "Il pleut des cordes", - // "type": "idiom", - // "literal_meaning": "It's raining very heavily", - // "cultural_origin": "English weather expressions" - // } - - // CONDITIONAL STRUCTURES: - // { - // "original": "If I were rich, I would travel the world", - // "userLanguage": "Si j'étais riche, je voyagerais autour du monde", - // "type": "conditional_statement", - // "conditional_type": "second_conditional", - // "grammar_focus": "hypothetical_situations" - // } - - // ================================================================================================ - // AI IMPLEMENTATION GUIDELINES FOR SENTENCES - // ================================================================================================ - /* - EXERCISE TYPE GENERATION: - ======================== - - Use type field to generate appropriate exercise formats - - Leverage correction_data for error identification games - - Apply formality/situation filters for contextual appropriateness training - - Combine multiple parameters for complex exercise generation - - CORRECTION EXERCISE PROCESSING: - ============================== - - Present incorrect_versions for learners to identify and correct - - Use difficulty ratings for adaptive error presentation - - Provide rich feedback using explanation fields - - Track error_type patterns for personalized grammar focus - - CONTEXTUAL EXERCISE INTEGRATION: - =============================== - - Group sentences by topic for thematic learning sessions - - Filter by situation for role-play and scenario practice - - Use formality levels for register awareness training - - Apply cultural_note data for cross-cultural communication exercises - - PARAMETER-BASED FILTERING: - ========================= - - Enable complex queries: "formal greetings for business situations" - - Support multi-parameter filtering: topic + formality + tense - - Provide parameter-based difficulty progression - - Generate themed exercise sets using metadata combinations - - ADAPTIVE LEARNING FEATURES: - ========================== - - Track learner performance by error_type for focused practice - - Adapt sentence selection based on cultural background - - Provide situational appropriateness feedback - - Generate personalized correction exercise sequences - */ - ], - - // ======================================================================================================== - // MATCHING EXERCISES - DUAL SYSTEM ARCHITECTURE - // ======================================================================================================== - // The matching section implements a dual system that supports both traditional two-column matching - // (for backward compatibility) and a flexible multi-column system (for advanced exercises). - // This design ensures existing content continues to work while enabling sophisticated new exercise types. - // - // ARCHITECTURAL BENEFITS: - // ====================== - // 1. BACKWARD COMPATIBILITY: Existing two-column exercises continue to work unchanged - // 2. PROGRESSIVE ENHANCEMENT: Content creators can migrate to multi-column format when needed - // 3. FLEXIBLE COMPLEXITY: Support for 2-N column exercises with single data structure - // 4. UNIVERSAL APPLICABILITY: Same system works for vocabulary, grammar, geography, logic, etc. - // 5. CLEAR TYPE DISTINCTION: Explicit type field prevents processing confusion - // - "matching": [ - - // ================================================================================================ - // TYPE 1: TRADITIONAL TWO-COLUMN MATCHING - // ================================================================================================ - // Classic left-right matching format for simple correspondence exercises - // MAINTAINED FOR: Backward compatibility, simple vocabulary matching, basic concept pairs - - { - "title": "Match Animals to Their Sounds", // REQUIRED: Exercise title for display - "type": "two_column_matching", // REQUIRED: Explicit type declaration - // PROCESSING: AI systems should detect this type and use legacy matching interface - - "leftColumn": ["Cat", "Dog", "Cow", "Bird"], // REQUIRED: Items for left side of matching interface - // ORDER: Can be randomized by game engine for variety - - "rightColumn": ["Woof", "Meow", "Tweet", "Moo"], // REQUIRED: Items for right side of matching interface - // COUNT: Should match leftColumn count for 1:1 matching - - "correctPairs": [ // REQUIRED: Array defining correct matches - { "left": "Cat", "right": "Meow" }, // Each pair object specifies one correct connection - { "left": "Dog", "right": "Woof" }, // VALUES: Must exactly match items from left/right columns - { "left": "Cow", "right": "Moo" }, - { "left": "Bird", "right": "Tweet" } - ] - // GAME MECHANICS: Drag-and-drop, click-to-connect, or tap-based matching - // VALIDATION: Check learner connections against correctPairs array - // FEEDBACK: Immediate validation with visual/audio feedback - }, - - { - "title": "Match Colors in English and French", // Another traditional matching example - "type": "two_column_matching", - "leftColumn": ["Red", "Blue", "Green", "Yellow"], - "rightColumn": ["Bleu", "Vert", "Rouge", "Jaune"], - "correctPairs": [ - { "left": "Red", "right": "Rouge" }, - { "left": "Blue", "right": "Bleu" }, - { "left": "Green", "right": "Vert" }, - { "left": "Yellow", "right": "Jaune" } - ] - }, - - // ================================================================================================ - // TYPE 2: MULTI-COLUMN MATCHING SYSTEM - // ================================================================================================ - // Flexible N-column system for complex relationships and sentence construction - // APPLICATIONS: Grammar construction, complex relationships, logical sequences, categorization - - { - "title": "Build Correct Sentences", // REQUIRED: Descriptive title for complex exercise - "type": "multi_column_matching", // REQUIRED: Identifies this as flexible column system - - "columns": [ // REQUIRED: Array of column definitions (minimum 2, no maximum) - { - "id": 1, // REQUIRED: Numeric identifier for referencing in valid_combinations - // SPECIFICATION: Use simple integers starting from 1 - // UNIQUENESS: Must be unique within this exercise - - "name": "Subject", // OPTIONAL: Display label for column header - // USAGE: Shown in game interface to guide learners - // OMISSION: Can be left out for unlabeled columns - - "items": ["I", "She", "They", "We"] // REQUIRED: Array of items available in this column - // FLEXIBILITY: Any number of items, any content type - }, - { - "id": 2, - "name": "Verb", - "items": ["am", "is", "are", "are"] // Note: "are" appears twice for multiple subjects - }, - { - "id": 3, - "name": "Complement", - "items": ["happy", "a teacher", "students", "friends"] - } - ], - - "valid_combinations": [ // REQUIRED: Array of correct multi-column combinations - // REFERENCE: Uses column IDs as keys, item text as values - {"1": "I", "2": "am", "3": "happy"}, // Valid sentence: "I am happy" - {"1": "I", "2": "am", "3": "a teacher"}, // Valid sentence: "I am a teacher" - {"1": "She", "2": "is", "3": "happy"}, // Valid sentence: "She is happy" - {"1": "She", "2": "is", "3": "a teacher"}, // Valid sentence: "She is a teacher" - {"1": "They", "2": "are", "3": "students"}, // Valid sentence: "They are students" - {"1": "They", "2": "are", "3": "friends"}, // Valid sentence: "They are friends" - {"1": "We", "2": "are", "3": "students"}, // Valid sentence: "We are students" - {"1": "We", "2": "are", "3": "friends"} // Valid sentence: "We are friends" - ] - // GAME MECHANICS: Sequential selection across columns, drag-and-drop assembly, or tap-to-build - // VALIDATION: Check learner's column selections against valid_combinations array - // PARTIAL VALIDATION: Can check partial combinations for immediate feedback - // COMPLEXITY SCALING: More columns = more complex relationships and grammar concepts - }, - - // ================================================================================================ - // MULTI-COLUMN WITHOUT COLUMN NAMES - // ================================================================================================ - // Demonstrates flexibility by omitting optional column names - - { - "title": "Match Country Information", - "type": "multi_column_matching", - "columns": [ - { - "id": 1, - "name": "Country", // Has name for clear identification - "items": ["France", "Spain", "Italy", "Germany"] - }, - { - "id": 2, - "name": "Capital", // Has name for educational clarity - "items": ["Paris", "Madrid", "Rome", "Berlin"] - }, - { - "id": 3, - // NO "name" field - demonstrates optional nature - // INTERFACE: Game can show "Column 3" or use generic label - "items": ["French", "Spanish", "Italian", "German"] - } - ], - "valid_combinations": [ - {"1": "France", "2": "Paris", "3": "French"}, - {"1": "Spain", "2": "Madrid", "3": "Spanish"}, - {"1": "Italy", "2": "Rome", "3": "Italian"}, - {"1": "Germany", "2": "Berlin", "3": "German"} - ] - } - - // ================================================================================================ - // ADVANCED MULTI-COLUMN EXAMPLES - // ================================================================================================ - // Additional examples showing the system's versatility - - // COMPLEX GRAMMAR CONSTRUCTION (5 columns): - // { - // "title": "Build Complex English Sentences", - // "type": "multi_column_matching", - // "columns": [ - // {"id": 1, "name": "Subject", "items": ["I", "She", "They"]}, - // {"id": 2, "name": "Auxiliary", "items": ["don't", "doesn't", "do"]}, - // {"id": 3, "name": "Main Verb", "items": ["eat", "like", "want"]}, - // {"id": 4, "name": "Object", "items": ["fish", "coffee", "chocolate"]}, - // {"id": 5, "name": "Time", "items": ["often", "never", "sometimes"]} - // ], - // "valid_combinations": [ - // {"1": "I", "2": "don't", "3": "eat", "4": "fish", "5": "often"}, - // {"1": "She", "2": "doesn't", "3": "like", "4": "coffee", "5": "never"} - // ] - // } - - // LOGICAL CATEGORIZATION (4 columns): - // { - // "title": "Categorize by Properties", - // "type": "multi_column_matching", - // "columns": [ - // {"id": 1, "name": "Animal", "items": ["Dog", "Fish", "Bird"]}, - // {"id": 2, "name": "Habitat", "items": ["Land", "Water", "Air"]}, - // {"id": 3, "name": "Movement", "items": ["Walks", "Swims", "Flies"]}, - // {"id": 4, "name": "Sound", "items": ["Barks", "Silent", "Chirps"]} - // ], - // "valid_combinations": [ - // {"1": "Dog", "2": "Land", "3": "Walks", "4": "Barks"}, - // {"1": "Fish", "2": "Water", "3": "Swims", "4": "Silent"}, - // {"1": "Bird", "2": "Air", "3": "Flies", "4": "Chirps"} - // ] - // } - - // ================================================================================================ - // AI IMPLEMENTATION GUIDELINES FOR MATCHING - // ================================================================================================ - /* - TYPE DETECTION AND PROCESSING: - ============================== - - Check 'type' field first to determine processing approach - - two_column_matching: Use traditional left-right interface - - multi_column_matching: Use flexible column-based interface - - Validate data structure matches declared type - - TWO-COLUMN PROCESSING: - ===================== - - Present leftColumn and rightColumn in separate interface areas - - Randomize order for variety while maintaining correctPairs validation - - Support drag-and-drop, click-to-connect, or touch-based matching - - Validate against correctPairs array for immediate feedback - - MULTI-COLUMN PROCESSING: - ======================= - - Dynamically generate interface based on columns array length - - Use column 'name' fields for headers when provided - - Fall back to generic labels ("Column 1", "Column 2") when name absent - - Reference valid_combinations using column IDs as keys - - VALIDATION STRATEGIES: - ===================== - - For two-column: Direct lookup in correctPairs array - - For multi-column: Check learner selection against valid_combinations - - Support partial validation for multi-column exercises - - Provide immediate feedback for correct and incorrect combinations - - INTERFACE ADAPTATION: - ==================== - - Scale interface layout based on number of columns - - Adapt to different screen sizes and orientations - - Support keyboard navigation for accessibility - - Provide clear visual feedback for selections and validation - - EXERCISE GENERATION: - =================== - - Use multi-column system for sentence construction exercises - - Apply two-column system for simple vocabulary matching - - Generate exercises of varying complexity based on column count - - Support themed exercises using column categorization - */ - ], - - // ======================================================================================================== - // DIALOGUES - CONVERSATIONAL CONTENT SYSTEM - // ======================================================================================================== - // The dialogues section provides structured conversational content for communication skills development. - // This system supports both text-only conversations and audio-synchronized dialogues with precise timing. - // It serves as the primary location for content that combines audio WITH text (unlike the audio section - // which is for audio-only content). - // - // PEDAGOGICAL APPLICATIONS: - // ======================== - // 1. CONVERSATION PRACTICE: Role-play and dialogue repetition exercises - // 2. PRONUNCIATION TRAINING: Audio-text synchronization for pronunciation practice - // 3. CONTEXTUAL LEARNING: Language use in realistic social situations - // 4. CULTURAL COMMUNICATION: Appropriate language use in different cultural contexts - // 5. LISTENING COMPREHENSION: Following conversations with textual support - // - "dialogues": [ - - // ================================================================================================ - // TEXT-ONLY DIALOGUE EXAMPLE - // ================================================================================================ - // Simple conversational content without audio for reading and role-play practice - - { - "title": "At the Restaurant", // REQUIRED: Descriptive title for the dialogue - // USAGE: Shown in content browsers and exercise interfaces - // CONTEXT: Should indicate setting or situation - - "conversation": [ // REQUIRED: Array of dialogue turns/exchanges - // STRUCTURE: Sequential turns between speakers - // FLEXIBILITY: Any number of turns, any number of speakers - - { - "speaker": "Waiter", // REQUIRED: Speaker identification - // FORMAT: Can be names, roles, or generic labels (A, B, C) - // CONSISTENCY: Use same identifier throughout dialogue - - "original": "Good evening! Welcome to our restaurant.", - // REQUIRED: Speaker's utterance in source language - // NATURALNESS: Should reflect authentic conversational language - - "userLanguage": "Bonsoir! Bienvenue dans notre restaurant." - // REQUIRED: Translation in learner's target language - // CULTURAL ADAPTATION: Should reflect appropriate cultural norms - }, - { - "speaker": "Customer", - "original": "Thank you. Can I see the menu please?", - "userLanguage": "Merci. Puis-je voir le menu s'il vous plaît?" - }, - { - "speaker": "Waiter", - "original": "Of course! Here you are. What would you like to drink?", - "userLanguage": "Bien sûr! Voici. Que voulez-vous boire?" - } - ] - // USAGE APPLICATIONS: - // - Reading comprehension exercises - // - Role-play practice (learners take different speaker roles) - // - Translation practice - // - Cultural appropriateness training - // - Conversation pattern recognition - }, - - // ================================================================================================ - // AUDIO-SYNCHRONIZED DIALOGUE - // ================================================================================================ - // Advanced dialogue with audio track and precise timing for multimedia learning - - { - "title": "Daily Routine Conversation", - "audio": "audio/conversations/daily_routine.mp3", // OPTIONAL: Audio file containing spoken dialogue - // SPECIFICATION: Should contain clear recording of entire conversation - // QUALITY: Professional recording with distinct speakers - // SYNCHRONIZATION: Must match conversation array content exactly - - "conversation": [ - { - "speaker": "A", // Generic speaker labels for role-play flexibility - "original": "What time do you wake up?", - "userLanguage": "À quelle heure te réveilles-tu?", - "timestamp": 0.5 // OPTIONAL: Time in seconds when this line begins in audio - // PRECISION: Allows for precise audio-text synchronization - // APPLICATIONS: Pronunciation practice, listening comprehension - }, - { - "speaker": "B", - "original": "I usually wake up at 7 AM.", - "userLanguage": "Je me réveille habituellement à 7h.", - "timestamp": 3.2 // Next speaker's line starts at 3.2 seconds - }, - { - "speaker": "A", - "original": "That's early! I wake up at 8:30.", - "userLanguage": "C'est tôt! Je me réveille à 8h30.", - "timestamp": 6.8 - }, - { - "speaker": "B", - "original": "I like to exercise before work.", - "userLanguage": "J'aime faire de l'exercice avant le travail.", - "timestamp": 11.1 - }, - { - "speaker": "A", - "original": "That's a good habit!", - "userLanguage": "C'est une bonne habitude!", - "timestamp": 14.5 - } - ] - // ADVANCED APPLICATIONS: - // - Audio-text synchronization exercises - // - Pronunciation training with native speaker models - // - Listening comprehension with textual support - // - Speed and rhythm training - // - Accent and intonation practice - } - - // ================================================================================================ - // ADDITIONAL DIALOGUE EXAMPLES - // ================================================================================================ - // Examples showing various dialogue types and complexity levels - - // BUSINESS CONVERSATION: - // { - // "title": "Job Interview", - // "audio": "audio/conversations/job_interview.mp3", - // "conversation": [ - // { - // "speaker": "Interviewer", - // "original": "Tell me about your work experience.", - // "userLanguage": "Parlez-moi de votre expérience professionnelle.", - // "timestamp": 1.0, - // "formality": "formal", // Additional metadata for register training - // "cultural_note": "Direct questioning is normal in American job interviews" - // }, - // { - // "speaker": "Candidate", - // "original": "I have five years of experience in marketing.", - // "userLanguage": "J'ai cinq ans d'expérience en marketing.", - // "timestamp": 4.5, - // "formality": "formal" - // } - // ] - // } - - // CASUAL CONVERSATION: - // { - // "title": "Friends Meeting", - // "conversation": [ - // { - // "speaker": "Alex", - // "original": "Hey! How's it going?", - // "userLanguage": "Salut! Comment ça va?", - // "formality": "casual", - // "emotion": "friendly" - // }, - // { - // "speaker": "Jordan", - // "original": "Pretty good! Want to grab some coffee?", - // "userLanguage": "Plutôt bien! Tu veux prendre un café?", - // "formality": "casual", - // "speech_act": "invitation" - // } - // ] - // } - - // CULTURAL CONTEXT DIALOGUE: - // { - // "title": "British Tea Time", - // "cultural_context": "Traditional British afternoon tea customs", - // "conversation": [ - // { - // "speaker": "Host", - // "original": "Would you care for some tea?", - // "userLanguage": "Prendriez-vous du thé?", - // "cultural_note": "Formal invitation typical in British tea culture" - // }, - // { - // "speaker": "Guest", - // "original": "That would be lovely, thank you.", - // "userLanguage": "Ce serait merveilleux, merci.", - // "cultural_note": "Polite acceptance maintaining formal register" - // } - // ] - // } - - // ================================================================================================ - // AI IMPLEMENTATION GUIDELINES FOR DIALOGUES - // ================================================================================================ - /* - AUDIO SYNCHRONIZATION: - ===================== - - Use timestamp data for precise audio-text alignment - - Support playback controls: play, pause, rewind, segment replay - - Enable click-to-play functionality for individual dialogue lines - - Provide speed adjustment (0.5x to 1.5x) for pronunciation practice - - ROLE-PLAY FUNCTIONALITY: - ======================= - - Allow learners to select and practice different speaker roles - - Provide recording capability for pronunciation practice - - Compare learner pronunciation with original audio when available - - Support turn-taking exercises with audio cues - - COMPREHENSION EXERCISES: - ======================= - - Generate comprehension questions based on dialogue content - - Create fill-in-the-blank exercises using dialogue text - - Develop role-appropriate response generation exercises - - Support dialogue completion and continuation activities - - CULTURAL INTEGRATION: - ==================== - - Use cultural_note data for cross-cultural communication training - - Highlight formality and register variations within dialogues - - Provide cultural context explanations for communication patterns - - Enable comparative dialogue analysis across cultures - - PROGRESSIVE DIFFICULTY: - ====================== - - Start with text-only dialogues for reading comprehension - - Progress to audio-supported dialogues for listening skills - - Advance to role-play and production exercises - - Culminate in free conversation based on dialogue patterns - - ACCESSIBILITY FEATURES: - ====================== - - Provide subtitle toggle for hearing-impaired users - - Support keyboard navigation for audio controls - - Enable adjustable text size for visual accessibility - - Offer translation toggle for comprehension support - */ - ] - - // ======================================================================================================== - // FINAL IMPLEMENTATION NOTES - // ======================================================================================================== - /* - GLOBAL VALIDATION RULES: - ======================== - 1. Required fields must be present and non-empty - 2. Optional fields can be omitted entirely - 3. File paths should be validated for existence before use - 4. Language codes should follow ISO 639-1 standard - 5. Difficulty scales should be consistent (1-10 integers) - 6. Cross-references (like prerequisite IDs) should be validated - - ERROR HANDLING STRATEGIES: - ========================= - 1. Missing required fields: Log error and skip content item - 2. Missing optional fields: Continue processing with graceful degradation - 3. Invalid file paths: Use fallbacks or skip media-dependent features - 4. Malformed data: Log error details for content creator feedback - 5. Unknown fields: Ignore silently to support future extensibility - - PERFORMANCE OPTIMIZATION: - ======================== - 1. Lazy load media files (audio, images) only when needed - 2. Cache processed content data for faster subsequent access - 3. Pre-validate content structure on load for quick error detection - 4. Use efficient data structures for fast content lookup and filtering - 5. Implement progressive loading for large content modules - - LOCALIZATION SUPPORT: - ==================== - 1. All user-facing text should support translation - 2. Cultural content should adapt to learner's cultural context - 3. Date, time, and number formats should follow locale conventions - 4. Audio content should support multiple accent variations when possible - 5. Interface elements should support right-to-left languages when applicable - - EXTENSIBILITY FRAMEWORK: - ======================= - 1. New exercise types can be added without breaking existing content - 2. Additional metadata fields can be added to any content section - 3. New content sections can be added at the root level - 4. Custom field validation can be implemented for specific use cases - 5. Plugin architecture should support third-party content enhancements - - QUALITY ASSURANCE: - ================= - 1. Content should be reviewed by native speakers for linguistic accuracy - 2. Cultural content should be validated by cultural experts - 3. Audio quality should meet professional standards for educational use - 4. Visual content should be tested for accessibility and cultural sensitivity - 5. Exercise difficulty should be validated through learner testing - */ -} \ No newline at end of file diff --git a/migrate-console.js b/migrate-console.js deleted file mode 100644 index cd1cdeb..0000000 --- a/migrate-console.js +++ /dev/null @@ -1,114 +0,0 @@ -#!/usr/bin/env node -// Script de migration des console.log vers logSh -const fs = require('fs'); -const path = require('path'); - -// Fonction pour parcourir récursivement les fichiers -function walkSync(dir, filelist = []) { - const files = fs.readdirSync(dir); - - files.forEach(file => { - const filepath = path.join(dir, file); - const stat = fs.statSync(filepath); - - if (stat.isDirectory()) { - // Skip certains dossiers - if (!['node_modules', '.git', 'export_logger'].includes(file)) { - filelist = walkSync(filepath, filelist); - } - } else if (file.endsWith('.js') && !file.startsWith('migrate-')) { - filelist.push(filepath); - } - }); - - return filelist; -} - -// Fonction pour migrer un fichier -function migrateFile(filepath) { - console.log(`🔄 Migration: ${filepath}`); - - let content = fs.readFileSync(filepath, 'utf8'); - let modified = false; - - // Remplacements avec mapping vers logSh - const replacements = [ - // console.log -> logSh avec niveau INFO - { - pattern: /console\.log\((.*?)\);?/g, - replacement: (match, args) => { - // Si c'est déjà un template string avec des variables, le garder tel quel - if (args.includes('`') || args.includes('${')) { - return `logSh(${args}, 'INFO');`; - } - // Sinon, traiter normalement - return `logSh(${args}, 'INFO');`; - } - }, - - // console.warn -> logSh avec niveau WARN - { - pattern: /console\.warn\((.*?)\);?/g, - replacement: (match, args) => { - return `logSh(${args}, 'WARN');`; - } - }, - - // console.error -> logSh avec niveau ERROR - { - pattern: /console\.error\((.*?)\);?/g, - replacement: (match, args) => { - return `logSh(${args}, 'ERROR');`; - } - } - ]; - - // Appliquer les remplacements - replacements.forEach(({ pattern, replacement }) => { - const originalContent = content; - content = content.replace(pattern, replacement); - if (content !== originalContent) { - modified = true; - } - }); - - // Sauvegarder si modifié - if (modified) { - fs.writeFileSync(filepath, content, 'utf8'); - console.log(`✅ Migré: ${filepath}`); - return true; - } else { - console.log(`⏸️ Pas de changement: ${filepath}`); - return false; - } -} - -// Script principal -function main() { - console.log('🚀 Démarrage migration console vers logSh...'); - - const projectRoot = __dirname; - const jsFiles = walkSync(projectRoot); - - console.log(`📁 Trouvé ${jsFiles.length} fichiers JavaScript`); - - let migratedCount = 0; - - jsFiles.forEach(filepath => { - if (migrateFile(filepath)) { - migratedCount++; - } - }); - - console.log(`\n🎉 Migration terminée!`); - console.log(`📊 ${migratedCount} fichiers modifiés sur ${jsFiles.length}`); - console.log(`\n🔍 Pour vérifier, lance:`); - console.log(`grep -r "console\\." --include="*.js" . || echo "✅ Plus de console dans le code!"`); -} - -// Lancer le script -if (require.main === module) { - main(); -} - -module.exports = { migrateFile, walkSync }; \ No newline at end of file diff --git a/quick-debug.js b/quick-debug.js deleted file mode 100644 index b484ac7..0000000 --- a/quick-debug.js +++ /dev/null @@ -1,56 +0,0 @@ -// === TEST RAPIDE À COPIER-COLLER DANS LA CONSOLE === - -// Copie-colle ça dans la console du navigateur pour déboguer -function quickDebug() { - console.log('🔧 Quick Debug du système de compatibilité\n'); - - // 1. Vérifier que les classes existent - console.log('1️⃣ Classes disponibles:'); - console.log(' ContentGameCompatibility:', !!window.ContentGameCompatibility); - console.log(' ContentScanner:', !!window.ContentScanner); - console.log(' AppNavigation:', !!window.AppNavigation); - - // 2. Vérifier l'initialisation - console.log('\n2️⃣ Initialisation AppNavigation:'); - if (window.AppNavigation) { - console.log(' compatibilityChecker:', !!window.AppNavigation.compatibilityChecker); - console.log(' contentScanner:', !!window.AppNavigation.contentScanner); - console.log(' scannedContent:', !!window.AppNavigation.scannedContent); - - if (window.AppNavigation.scannedContent) { - console.log(' Contenu trouvé:', window.AppNavigation.scannedContent.found?.length || 0); - } - } - - // 3. Vérifier les modules chargés - console.log('\n3️⃣ Modules de contenu:'); - if (window.ContentModules) { - const modules = Object.keys(window.ContentModules); - console.log(' Modules:', modules); - - if (window.ContentModules.ChineseLongStory) { - console.log(' ✅ ChineseLongStory trouvé'); - } else { - console.log(' ❌ ChineseLongStory manquant'); - } - } else { - console.log(' ❌ window.ContentModules manquant'); - } - - // 4. Test de compatibilité direct - console.log('\n4️⃣ Test de compatibilité direct:'); - if (window.AppNavigation?.compatibilityChecker && window.ContentModules?.ChineseLongStory) { - const checker = window.AppNavigation.compatibilityChecker; - const content = window.ContentModules.ChineseLongStory; - - const result = checker.checkCompatibility(content, 'whack-a-mole'); - console.log(' Test whack-a-mole:', result.compatible, `(${result.score}%)`); - } else { - console.log(' ❌ Impossible - composants manquants'); - } - - console.log('\n✅ Debug terminé'); -} - -// Auto-exécution -quickDebug(); \ No newline at end of file diff --git a/sbs-level-7-8-GENERATED-from-js.json b/sbs-level-7-8-GENERATED-from-js.json deleted file mode 100644 index 8934274..0000000 --- a/sbs-level-7-8-GENERATED-from-js.json +++ /dev/null @@ -1,206 +0,0 @@ -{ - "id": "sbs_level_7_8_converted_from_js", - "name": "SBS Level 7-8 (Converted from JavaScript)", - "description": "English learning content covering housing and clothing vocabulary - automatically converted from legacy JavaScript format to ultra-modular JSON specification", - "difficulty_level": 7, - "original_lang": "english", - "user_lang": "chinese", - "icon": "🏠", - "tags": [ - "vocabulary", - "intermediate", - "places", - "housing", - "clothing" - ], - "vocabulary": { - "central": { - "user_language": "中心的；中央的", - "original_language": "central" - }, - "avenue": { - "user_language": "大街；林荫道", - "original_language": "avenue" - }, - "refrigerator": { - "user_language": "冰箱", - "original_language": "refrigerator" - }, - "closet": { - "user_language": "衣柜；壁橱", - "original_language": "closet" - }, - "elevator": { - "user_language": "电梯", - "original_language": "elevator" - }, - "building": { - "user_language": "建筑物；大楼", - "original_language": "building" - }, - "air conditioner": { - "user_language": "空调", - "original_language": "air conditioner" - }, - "superintendent": { - "user_language": "主管；负责人", - "original_language": "superintendent" - }, - "bus stop": { - "user_language": "公交车站", - "original_language": "bus stop" - }, - "jacuzzi": { - "user_language": "按摩浴缸", - "original_language": "jacuzzi" - }, - "shirt": { - "user_language": "衬衫", - "original_language": "shirt" - }, - "coat": { - "user_language": "外套、大衣", - "original_language": "coat" - }, - "dress": { - "user_language": "连衣裙", - "original_language": "dress" - }, - "skirt": { - "user_language": "短裙", - "original_language": "skirt" - }, - "blouse": { - "user_language": "女式衬衫", - "original_language": "blouse" - }, - "jacket": { - "user_language": "夹克、短外套", - "original_language": "jacket" - }, - "sweater": { - "user_language": "毛衣、针织衫", - "original_language": "sweater" - }, - "suit": { - "user_language": "套装、西装", - "original_language": "suit" - }, - "tie": { - "user_language": "领带", - "original_language": "tie" - }, - "pants": { - "user_language": "裤子", - "original_language": "pants" - }, - "jeans": { - "user_language": "牛仔裤", - "original_language": "jeans" - }, - "belt": { - "user_language": "腰带、皮带", - "original_language": "belt" - }, - "hat": { - "user_language": "帽子", - "original_language": "hat" - }, - "glove": { - "user_language": "手套", - "original_language": "glove" - }, - "glasses": { - "user_language": "眼镜", - "original_language": "glasses" - }, - "pajamas": { - "user_language": "睡衣", - "original_language": "pajamas" - }, - "shoes": { - "user_language": "鞋子", - "original_language": "shoes" - } - }, - "sentences": [ - { - "id": "sentence_1", - "original_language": "Amy's apartment building is in the center of town.", - "user_language": "艾米的公寓楼在城镇中心。" - }, - { - "id": "sentence_2", - "original_language": "There's a lot of noise near Amy's apartment building.", - "user_language": "艾米的公寓楼附近很吵。" - }, - { - "id": "sentence_3", - "original_language": "The superintendent is very helpful.", - "user_language": "管理员非常乐于助人。" - }, - { - "id": "sentence_4", - "original_language": "I need to buy new clothes for winter.", - "user_language": "我需要为冬天买新衣服。" - } - ], - "conversion_metadata": { - "converted_from": "legacy_javascript_module", - "conversion_timestamp": "2025-09-16T11:50:26.158Z", - "conversion_system": "ultra_modular_converter_v1.0", - "original_format": "js_content_module", - "target_format": "ultra_modular_json_v2.0", - "original_stats": { - "vocabulary_count": 27, - "sentence_count": 4, - "has_complex_phrases": true - }, - "detected_capabilities": { - "hasVocabulary": true, - "hasSentences": true, - "hasGrammar": false, - "hasAudio": false, - "hasDialogues": false, - "hasExercises": false, - "hasMatching": false, - "hasCulture": false, - "vocabularyDepth": 1, - "contentRichness": 2.7, - "vocabularyCount": 27, - "sentenceCount": 4, - "complexPhrases": 2 - }, - "game_compatibility": { - "whack-a-mole": { - "compatible": true, - "score": 54, - "reason": "Nécessite vocabulaire" - }, - "memory-match": { - "compatible": true, - "score": 40.5, - "reason": "Optimal pour vocabulaire visuel" - }, - "quiz-game": { - "compatible": true, - "score": 42, - "reason": "Fonctionne avec tout contenu" - }, - "text-reader": { - "compatible": true, - "score": 40, - "reason": "Nécessite phrases à lire" - } - }, - "quality_score": 91 - }, - "system_validation": { - "format_version": "2.0", - "specification": "ultra_modular", - "backwards_compatible": true, - "memory_stored": true, - "conversion_verified": true, - "ready_for_games": true - } -} \ No newline at end of file diff --git a/start-websocket-logger.bat b/start-websocket-logger.bat deleted file mode 100644 index ac59987..0000000 --- a/start-websocket-logger.bat +++ /dev/null @@ -1,12 +0,0 @@ -@echo off -echo ======================================== -echo WebSocket Logger Server -echo ======================================== -echo. - -cd /d "%~dp0\export_logger" - -echo Demarrage du serveur WebSocket sur le port 8082... -node websocket-server.js - -pause \ No newline at end of file diff --git a/start-websocket-logger.sh b/start-websocket-logger.sh deleted file mode 100644 index 8865120..0000000 --- a/start-websocket-logger.sh +++ /dev/null @@ -1,12 +0,0 @@ -#!/bin/bash - -echo "========================================" -echo " WebSocket Logger Server" -echo "========================================" -echo "" - -# Se déplacer dans le dossier export_logger -cd "$(dirname "$0")/export_logger" - -echo "Démarrage du serveur WebSocket sur le port 8082..." -node websocket-server.js \ No newline at end of file diff --git a/test-aws-signature.js b/test-aws-signature.js deleted file mode 100644 index 987f72f..0000000 --- a/test-aws-signature.js +++ /dev/null @@ -1,147 +0,0 @@ -#!/usr/bin/env node - -// Test de signature AWS pour DigitalOcean Spaces -const crypto = require('crypto'); - -// Configuration avec ta clé read-only -const config = { - DO_ACCESS_KEY: 'DO801XTYPE968NZGAQM3', - DO_SECRET_KEY: 'rfKPjampdpUCYhn02XrKg6IWKmqebjg9HQTGxNLzJQY', - DO_REGION: 'fra1', - DO_ENDPOINT: 'https://autocollant.fra1.digitaloceanspaces.com', - DO_CONTENT_PATH: 'Class_generator/ContentMe' -}; - -// Fonction de hash SHA256 -function sha256(message) { - return crypto.createHash('sha256').update(message, 'utf8').digest('hex'); -} - -// Fonction HMAC SHA256 -function hmacSha256(key, message) { - return crypto.createHmac('sha256', key).update(message, 'utf8').digest(); -} - -// Génération de la signature AWS V4 -async function generateAWSSignature(method, url) { - const accessKey = config.DO_ACCESS_KEY; - const secretKey = config.DO_SECRET_KEY; - const region = config.DO_REGION; - const service = 's3'; - - const now = new Date(); - const dateStamp = now.toISOString().slice(0, 10).replace(/-/g, ''); - const timeStamp = now.toISOString().slice(0, 19).replace(/[-:]/g, '') + 'Z'; - - console.log(`🕐 Timestamp: ${timeStamp}`); - console.log(`📅 Date: ${dateStamp}`); - - // Parse URL - const urlObj = new URL(url); - const host = urlObj.hostname; - const canonicalUri = urlObj.pathname || '/'; - const canonicalQueryString = urlObj.search ? urlObj.search.slice(1) : ''; - - console.log(`🌐 Host: ${host}`); - console.log(`📍 URI: ${canonicalUri}`); - console.log(`❓ Query: ${canonicalQueryString}`); - - // Canonical headers - const canonicalHeaders = `host:${host}\nx-amz-date:${timeStamp}\n`; - const signedHeaders = 'host;x-amz-date'; - - console.log(`📝 Canonical headers:\n${canonicalHeaders}`); - - // Create canonical request - const payloadHash = method === 'GET' ? sha256('') : 'UNSIGNED-PAYLOAD'; - const canonicalRequest = [ - method, - canonicalUri, - canonicalQueryString, - canonicalHeaders, - signedHeaders, - payloadHash - ].join('\n'); - - console.log(`📋 Canonical request:\n${canonicalRequest}`); - console.log(`🔢 Payload hash: ${payloadHash}`); - - // Create string to sign - const algorithm = 'AWS4-HMAC-SHA256'; - const credentialScope = `${dateStamp}/${region}/${service}/aws4_request`; - const canonicalRequestHash = sha256(canonicalRequest); - const stringToSign = [ - algorithm, - timeStamp, - credentialScope, - canonicalRequestHash - ].join('\n'); - - console.log(`🔐 String to sign:\n${stringToSign}`); - console.log(`🔗 Canonical request hash: ${canonicalRequestHash}`); - - // Calculate signature - const kDate = hmacSha256('AWS4' + secretKey, dateStamp); - const kRegion = hmacSha256(kDate, region); - const kService = hmacSha256(kRegion, service); - const kSigning = hmacSha256(kService, 'aws4_request'); - const signature = hmacSha256(kSigning, stringToSign).toString('hex'); - - console.log(`✍️ Signature: ${signature}`); - - // Create authorization header - const authorization = `${algorithm} Credential=${accessKey}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`; - - console.log(`🔑 Authorization: ${authorization}`); - - return { - 'Authorization': authorization, - 'X-Amz-Date': timeStamp, - 'X-Amz-Content-Sha256': payloadHash - }; -} - -// Test avec fetch -async function testDigitalOceanAccess() { - console.log('🚀 Test d\'accès DigitalOcean Spaces avec signature AWS\n'); - - const testUrl = `${config.DO_ENDPOINT}/${config.DO_CONTENT_PATH}/greetings-basic.json`; - console.log(`🎯 URL de test: ${testUrl}\n`); - - try { - const headers = await generateAWSSignature('GET', testUrl); - - console.log('\n📦 Headers finaux:'); - console.log(JSON.stringify(headers, null, 2)); - - // Test avec node-fetch si disponible - try { - const fetch = require('node-fetch'); - console.log('\n🌐 Test avec node-fetch...'); - - const response = await fetch(testUrl, { - method: 'GET', - headers: headers - }); - - console.log(`📡 Status: ${response.status} ${response.statusText}`); - - if (response.ok) { - const content = await response.text(); - console.log(`✅ Succès ! Contenu (${content.length} chars): ${content.substring(0, 200)}...`); - } else { - const errorText = await response.text(); - console.log(`❌ Erreur: ${errorText}`); - } - } catch (fetchError) { - console.log('⚠️ node-fetch non disponible, test signature seulement'); - console.log('✅ Signature générée avec succès !'); - } - - } catch (error) { - console.error(`❌ Erreur: ${error.message}`); - } -} - -// Lancer le test -testDigitalOceanAccess(); \ No newline at end of file diff --git a/test-chinese-content.json b/test-chinese-content.json deleted file mode 100644 index a76397a..0000000 --- a/test-chinese-content.json +++ /dev/null @@ -1,58 +0,0 @@ -{ - "name": "Test Chinese Vocabulary", - "description": "Basic Chinese characters for testing", - "difficulty": "beginner", - "language": "chinese", - "vocabulary": { - "你好": { - "user_language": "bonjour", - "type": "greeting", - "pronunciation": "nǐ hǎo", - "hskLevel": "HSK1", - "examples": ["你好，欢迎！", "你好吗？"] - }, - "谢谢": { - "user_language": "merci", - "type": "greeting", - "pronunciation": "xiè xiè", - "hskLevel": "HSK1" - }, - "猫": { - "user_language": "chat", - "type": "noun", - "pronunciation": "māo", - "hskLevel": "HSK1", - "examples": ["我有一只猫"] - }, - "狗": { - "user_language": "chien", - "type": "noun", - "pronunciation": "gǒu", - "hskLevel": "HSK1" - }, - "水": { - "user_language": "eau", - "type": "noun", - "pronunciation": "shuǐ", - "hskLevel": "HSK1" - }, - "学习": { - "user_language": "étudier", - "type": "verb", - "pronunciation": "xué xí", - "hskLevel": "HSK2" - }, - "老师": { - "user_language": "professeur", - "type": "noun", - "pronunciation": "lǎo shī", - "hskLevel": "HSK2" - }, - "学生": { - "user_language": "étudiant", - "type": "noun", - "pronunciation": "xué shēng", - "hskLevel": "HSK2" - } - } -} \ No newline at end of file diff --git a/test-compatibility-system.html b/test-compatibility-system.html deleted file mode 100644 index 56bab77..0000000 --- a/test-compatibility-system.html +++ /dev/null @@ -1,222 +0,0 @@ - - - - - - Test Système de Compatibilité - - - -

🎯 Test du Système de Compatibilité Content-Game

- -
-

Chargement des modules

- -
-
- -
-

Tests de compatibilité

- -
-
- -
-

Log des opérations

- -
-
- - - - - - - - - - \ No newline at end of file diff --git a/test-connection.html b/test-connection.html deleted file mode 100644 index 60a98fe..0000000 --- a/test-connection.html +++ /dev/null @@ -1,44 +0,0 @@ - - - - Test WebSocket Connection - - -

Test WebSocket Connection

-
Connecting...
-
- - - - \ No newline at end of file diff --git a/test-content-loading.html b/test-content-loading.html deleted file mode 100644 index 4f0cadf..0000000 --- a/test-content-loading.html +++ /dev/null @@ -1,62 +0,0 @@ - - - - - - Test Content Loading - - -

Content Loading Test

-
- - - - - - - - - - \ No newline at end of file diff --git a/test-conversion-english-exemple.js b/test-conversion-english-exemple.js deleted file mode 100644 index 10d0eb5..0000000 --- a/test-conversion-english-exemple.js +++ /dev/null @@ -1,321 +0,0 @@ -#!/usr/bin/env node - -// Test de conversion: english-exemple-commented.js → JSON Ultra-Modulaire -console.log('🚀 Conversion english-exemple-commented.js → JSON Ultra-Modulaire'); -console.log('================================================================'); - -// Simuler l'environnement browser -global.window = { - ContentModules: {} -}; - -// Charger le module JS -require('./js/content/english-exemple-commented.js'); - -// Récupérer le module depuis l'objet global -const englishModule = global.window?.ContentModules?.EnglishExempleCommented; - -if (!englishModule) { - console.error('❌ Erreur: Module EnglishExempleCommented non trouvé'); - process.exit(1); -} - -console.log('✅ Module JS chargé:'); -console.log(` - ${Object.keys(englishModule.vocabulary).length} mots de vocabulaire`); -console.log(` - ${englishModule.sentences?.length || 0} phrases`); -console.log(` - ${englishModule.texts?.length || 0} textes`); -console.log(` - ${englishModule.dialogues?.length || 0} dialogues`); -console.log(''); - -// Fonction de conversion COMPLÈTE (toutes les données JS) -function convertToUltraModular(jsModule) { - const ultraModular = { - // ======================================== - // CORE METADATA - Conversion honnête - // ======================================== - id: "english_exemple_commented_from_js", - name: jsModule.name || "English Example Commented", - description: jsModule.description || "Converted from JavaScript module", - - // Difficulté: on peut l'inférer du champ difficulty s'il existe - difficulty_level: jsModule.difficulty === 'intermediate' ? 5 : - jsModule.difficulty === 'easy' ? 3 : - jsModule.difficulty === 'hard' ? 7 : 4, - - // Langues détectées - original_lang: jsModule.language || "english", - user_lang: "french", // Détecté depuis les traductions - - // Icon simple - icon: "📚", - - // Tags basés sur le contenu réel - tags: [], - - // Skills covered si disponible - skills_covered: jsModule.skills_covered || [], - - // ======================================== - // VOCABULARY - Conversion fidèle avec tous les niveaux - // ======================================== - vocabulary: {}, - - // ======================================== - // GRAMMAR - Système de grammaire complet - // ======================================== - grammar: {}, - - // ======================================== - // SENTENCES - Conversion fidèle - // ======================================== - sentences: [], - - // ======================================== - // TEXTS - Conversion fidèle - // ======================================== - texts: [], - - // ======================================== - // DIALOGUES - Conversion fidèle - // ======================================== - dialogues: [], - - // ======================================== - // AUDIO - Contenu audio - // ======================================== - audio: [], - - // ======================================== - // CORRECTIONS - Exercices de correction - // ======================================== - corrections: [], - - // ======================================== - // FILL-IN-BLANKS - Exercices fill-in-blanks - // ======================================== - fillInBlanks: [], - - // ======================================== - // CULTURAL - Contenu culturel - // ======================================== - cultural: {}, - - // ======================================== - // MATCHING - Exercices de matching - // ======================================== - matching: [], - - // ======================================== - // METADATA - Pour tracer la conversion - // ======================================== - conversion_metadata: { - converted_from: "javascript_module", - conversion_timestamp: new Date().toISOString(), - source_file: "english-exemple-commented.js", - conversion_system: "honest_converter_v3.0_complete", - conversion_notes: "Conversion complète de toutes les données JS" - } - }; - - // ======================================== - // VOCABULARY - Conversion complète avec tous les niveaux - // ======================================== - if (jsModule.vocabulary) { - for (const [word, translation] of Object.entries(jsModule.vocabulary)) { - if (typeof translation === 'string') { - // Format simple: garder tel quel - ultraModular.vocabulary[word] = { - user_language: translation, - original_language: word - }; - } else if (typeof translation === 'object') { - // Objet complet: préserver toutes les propriétés - ultraModular.vocabulary[word] = { - user_language: translation.translation || translation.french || translation, - original_language: word - }; - - // Ajouter toutes les propriétés qui existent - if (translation.type) ultraModular.vocabulary[word].type = translation.type; - if (translation.pronunciation) ultraModular.vocabulary[word].pronunciation = translation.pronunciation; - if (translation.audio) ultraModular.vocabulary[word].audio = translation.audio; - if (translation.image) ultraModular.vocabulary[word].image = translation.image; - if (translation.examples) ultraModular.vocabulary[word].examples = translation.examples; - if (translation.grammarNotes) ultraModular.vocabulary[word].grammarNotes = translation.grammarNotes; - if (translation.conjugation) ultraModular.vocabulary[word].conjugation = translation.conjugation; - if (translation.difficulty_context) ultraModular.vocabulary[word].difficulty_context = translation.difficulty_context; - if (translation.cultural_note) ultraModular.vocabulary[word].cultural_note = translation.cultural_note; - } - } - } - - // ======================================== - // GRAMMAR - Conversion complète - // ======================================== - if (jsModule.grammar) { - ultraModular.grammar = jsModule.grammar; - } - - // ======================================== - // SENTENCES - Conversion fidèle - // ======================================== - if (jsModule.sentences && Array.isArray(jsModule.sentences)) { - ultraModular.sentences = jsModule.sentences.map((sentence, idx) => ({ - id: `sentence_${idx + 1}`, - original_language: sentence.english || sentence.original, - user_language: sentence.french || sentence.translation - })); - } - - // ======================================== - // TEXTS - Conversion complète avec exercices - // ======================================== - if (jsModule.texts && Array.isArray(jsModule.texts)) { - ultraModular.texts = jsModule.texts.map((text, idx) => { - const convertedText = { - id: `text_${idx + 1}`, - title: text.title, - original_language: text.content || text.english, - user_language: text.translation || text.french - }; - - // Ajouter les exercices s'ils existent - if (text.questions) convertedText.questions = text.questions; - if (text.fillInBlanks) convertedText.fillInBlanks = text.fillInBlanks; - - return convertedText; - }); - } - - // ======================================== - // DIALOGUES - Conversion fidèle - // ======================================== - if (jsModule.dialogues && Array.isArray(jsModule.dialogues)) { - ultraModular.dialogues = jsModule.dialogues.map((dialogue, idx) => ({ - id: `dialogue_${idx + 1}`, - title: dialogue.title, - conversation: dialogue.conversation.map((line, lineIdx) => ({ - id: `line_${lineIdx + 1}`, - speaker: line.speaker, - original_language: line.english, - user_language: line.french - })) - })); - } - - // ======================================== - // AUDIO - Conversion complète - // ======================================== - if (jsModule.audio && Array.isArray(jsModule.audio)) { - ultraModular.audio = jsModule.audio; - } - - // ======================================== - // CORRECTIONS - Exercices de correction - // ======================================== - if (jsModule.corrections && Array.isArray(jsModule.corrections)) { - ultraModular.corrections = jsModule.corrections; - } - - // ======================================== - // FILL-IN-BLANKS - Exercices fill-in-blanks - // ======================================== - if (jsModule.fillInBlanks && Array.isArray(jsModule.fillInBlanks)) { - ultraModular.fillInBlanks = jsModule.fillInBlanks; - } - - // ======================================== - // CULTURAL - Contenu culturel complet - // ======================================== - if (jsModule.cultural) { - ultraModular.cultural = jsModule.cultural; - } - - // ======================================== - // MATCHING - Exercices de matching - // ======================================== - if (jsModule.matching && Array.isArray(jsModule.matching)) { - ultraModular.matching = jsModule.matching; - } - - // ======================================== - // TAGS basés sur le contenu RÉEL - // ======================================== - if (Object.keys(ultraModular.vocabulary).length > 0) ultraModular.tags.push("vocabulary"); - if (ultraModular.sentences.length > 0) ultraModular.tags.push("sentences"); - if (ultraModular.texts.length > 0) ultraModular.tags.push("texts"); - if (ultraModular.dialogues.length > 0) ultraModular.tags.push("dialogues"); - if (ultraModular.grammar && Object.keys(ultraModular.grammar).length > 0) ultraModular.tags.push("grammar"); - if (ultraModular.audio && ultraModular.audio.length > 0) ultraModular.tags.push("audio"); - if (ultraModular.corrections && ultraModular.corrections.length > 0) ultraModular.tags.push("corrections"); - if (ultraModular.fillInBlanks && ultraModular.fillInBlanks.length > 0) ultraModular.tags.push("fillInBlanks"); - if (ultraModular.cultural && Object.keys(ultraModular.cultural).length > 0) ultraModular.tags.push("cultural"); - if (ultraModular.matching && ultraModular.matching.length > 0) ultraModular.tags.push("matching"); - ultraModular.tags.push("converted_from_js"); - - // ======================================== - // STATS COMPLÈTES de conversion - // ======================================== - ultraModular.conversion_metadata.stats = { - vocabulary_count: Object.keys(ultraModular.vocabulary).length, - sentence_count: ultraModular.sentences.length, - text_count: ultraModular.texts.length, - dialogue_count: ultraModular.dialogues.length, - grammar_count: ultraModular.grammar ? Object.keys(ultraModular.grammar).length : 0, - audio_count: ultraModular.audio ? ultraModular.audio.length : 0, - corrections_count: ultraModular.corrections ? ultraModular.corrections.length : 0, - fillInBlanks_count: ultraModular.fillInBlanks ? ultraModular.fillInBlanks.length : 0, - cultural_sections_count: ultraModular.cultural ? Object.keys(ultraModular.cultural).length : 0, - matching_count: ultraModular.matching ? ultraModular.matching.length : 0, - skills_covered_count: ultraModular.skills_covered ? ultraModular.skills_covered.length : 0 - }; - - return ultraModular; -} - -// Effectuer la conversion -console.log('🔄 Conversion en cours...'); -const ultraModularJSON = convertToUltraModular(englishModule); - -console.log('✅ Conversion COMPLÈTE terminée!'); -console.log(` - ${Object.keys(ultraModularJSON.vocabulary).length} mots convertis`); -console.log(` - ${ultraModularJSON.sentences.length} phrases converties`); -console.log(` - ${ultraModularJSON.texts.length} textes convertis`); -console.log(` - ${ultraModularJSON.dialogues.length} dialogues convertis`); -console.log(` - ${ultraModularJSON.conversion_metadata.stats.grammar_count} leçons de grammaire`); -console.log(` - ${ultraModularJSON.conversion_metadata.stats.audio_count} contenus audio`); -console.log(` - ${ultraModularJSON.conversion_metadata.stats.corrections_count} exercices de correction`); -console.log(` - ${ultraModularJSON.conversion_metadata.stats.fillInBlanks_count} exercices fill-in-blanks`); -console.log(` - ${ultraModularJSON.conversion_metadata.stats.cultural_sections_count} sections culturelles`); -console.log(` - ${ultraModularJSON.conversion_metadata.stats.matching_count} exercices de matching`); -console.log(` - ${ultraModularJSON.conversion_metadata.stats.skills_covered_count} compétences couvertes`); -console.log(''); - -// Sauvegarder le fichier JSON -const fs = require('fs'); -const outputFile = 'english-exemple-commented-GENERATED.json'; -const jsonContent = JSON.stringify(ultraModularJSON, null, 2); - -try { - fs.writeFileSync(outputFile, jsonContent, 'utf8'); - console.log(`📁 Fichier JSON généré: ${outputFile}`); - console.log(`📏 Taille: ${(jsonContent.length / 1024).toFixed(1)} KB`); - console.log(`📄 Lignes: ${jsonContent.split('\n').length}`); - console.log(''); - - // Validation finale - const reloaded = JSON.parse(jsonContent); - console.log('✅ VALIDATION:'); - console.log(` - JSON valide: ✅`); - console.log(` - ID: ${reloaded.id}`); - console.log(` - Nom: ${reloaded.name}`); - console.log(` - Tags: ${reloaded.tags.join(', ')}`); - console.log(` - Conversion honnête: ✅ (pas de données inventées)`); - -} catch (error) { - console.error('❌ Erreur:', error.message); - process.exit(1); -} - -console.log('================================================================'); -console.log('🎉 Conversion JS → JSON Ultra-Modulaire RÉUSSIE (honnête)!'); \ No newline at end of file diff --git a/test-conversion.js b/test-conversion.js deleted file mode 100644 index b9cfe06..0000000 --- a/test-conversion.js +++ /dev/null @@ -1,368 +0,0 @@ -#!/usr/bin/env node - -// Test de conversion JS → JSON Ultra-Modulaire -// Prouve que notre système fonctionne en mémoire - -console.log('🚀 Démarrage du test de conversion JS → JSON Ultra-Modulaire'); -console.log('========================================================'); - -// Simuler l'environnement browser avec les logs -global.logSh = function(message, level = 'INFO') { - console.log(`[${level}] ${message}`); -}; - -// Simuler window.ContentModules -global.window = { - ContentModules: {} -}; - -// Charger le contenu JavaScript (simulation du module SBS) -const sbsContent = { - name: "SBS Level 7-8", - difficulty: "intermediate", - vocabulary: { - // Housing and Places - central: "中心的；中央的", - avenue: "大街；林荫道", - refrigerator: "冰箱", - closet: "衣柜；壁橱", - elevator: "电梯", - building: "建筑物；大楼", - "air conditioner": "空调", - superintendent: "主管；负责人", - "bus stop": "公交车站", - jacuzzi: "按摩浴缸", - - // Clothing and Accessories - shirt: "衬衫", - coat: "外套、大衣", - dress: "连衣裙", - skirt: "短裙", - blouse: "女式衬衫", - jacket: "夹克、短外套", - sweater: "毛衣、针织衫", - suit: "套装、西装", - tie: "领带", - pants: "裤子", - jeans: "牛仔裤", - belt: "腰带、皮带", - hat: "帽子", - glove: "手套", - glasses: "眼镜", - pajamas: "睡衣", - shoes: "鞋子" - }, - - sentences: [ - { - english: "Amy's apartment building is in the center of town.", - chinese: "艾米的公寓楼在城镇中心。" - }, - { - english: "There's a lot of noise near Amy's apartment building.", - chinese: "艾米的公寓楼附近很吵。" - }, - { - english: "The superintendent is very helpful.", - chinese: "管理员非常乐于助人。" - }, - { - english: "I need to buy new clothes for winter.", - chinese: "我需要为冬天买新衣服。" - } - ] -}; - -// Ajouter aux modules globaux -global.window.ContentModules.SBSLevel78New = sbsContent; - -console.log('✅ Module JavaScript chargé en mémoire:'); -console.log(` - ${Object.keys(sbsContent.vocabulary).length} mots de vocabulaire`); -console.log(` - ${sbsContent.sentences.length} phrases d'exemple`); -console.log(''); - -// ======================================== -// ANALYSEUR DE CAPACITÉS SIMPLIFIÉ -// ======================================== - -class SimpleContentAnalyzer { - analyzeCapabilities(module) { - const vocab = module.vocabulary || {}; - const sentences = module.sentences || []; - - return { - hasVocabulary: Object.keys(vocab).length > 0, - hasSentences: sentences.length > 0, - hasGrammar: false, - hasAudio: false, - hasDialogues: false, - hasExercises: false, - hasMatching: false, - hasCulture: false, - - vocabularyDepth: this.analyzeVocabularyDepth(vocab), - contentRichness: Object.keys(vocab).length / 10, - - // Stats - vocabularyCount: Object.keys(vocab).length, - sentenceCount: sentences.length, - complexPhrases: Object.keys(vocab).filter(word => word.includes(' ')).length - }; - } - - analyzeVocabularyDepth(vocabulary) { - let maxDepth = 1; // Simple strings - - for (const [word, translation] of Object.entries(vocabulary)) { - if (typeof translation === 'string') { - maxDepth = Math.max(maxDepth, 1); - } else if (typeof translation === 'object') { - maxDepth = Math.max(maxDepth, 2); - // Pourrait analyser plus profondément ici - } - } - - return maxDepth; - } - - calculateGameCompatibility(capabilities) { - return { - 'whack-a-mole': { - compatible: capabilities.hasVocabulary, - score: capabilities.vocabularyCount * 2, - reason: 'Nécessite vocabulaire' - }, - 'memory-match': { - compatible: capabilities.hasVocabulary, - score: capabilities.vocabularyCount * 1.5, - reason: 'Optimal pour vocabulaire visuel' - }, - 'quiz-game': { - compatible: capabilities.hasVocabulary || capabilities.hasSentences, - score: (capabilities.vocabularyCount + capabilities.sentenceCount * 2) * 1.2, - reason: 'Fonctionne avec tout contenu' - }, - 'text-reader': { - compatible: capabilities.hasSentences, - score: capabilities.sentenceCount * 10, - reason: 'Nécessite phrases à lire' - } - }; - } -} - -// ======================================== -// CONVERTISSEUR VERS ULTRA-MODULAIRE -// ======================================== - -class JSToUltraModularConverter { - convert(jsModule) { - const analyzer = new SimpleContentAnalyzer(); - const capabilities = analyzer.analyzeCapabilities(jsModule); - const compatibility = analyzer.calculateGameCompatibility(capabilities); - - console.log('🔍 Analyse des capacités:'); - console.log(` - Vocabulaire: ${capabilities.vocabularyCount} mots`); - console.log(` - Phrases: ${capabilities.sentenceCount}`); - console.log(` - Profondeur vocab: ${capabilities.vocabularyDepth}/6`); - console.log(` - Richesse: ${capabilities.contentRichness.toFixed(1)}/10`); - console.log(''); - - const ultraModularSpec = { - // ======================================================================================================== - // CORE METADATA SECTION - GENERATED FROM JS MODULE - // ======================================================================================================== - id: "sbs_level_7_8_converted_from_js", - name: "SBS Level 7-8 (Converted from JavaScript)", - description: "English learning content covering housing and clothing vocabulary - automatically converted from legacy JavaScript format to ultra-modular JSON specification", - - // CORRECTION: Inférence raisonnable basée sur les données existantes - // Difficulty: on peut l'inférer du nom "Level 7-8" - difficulty_level: 7, // Basé sur "SBS Level 7-8" - - // Langues: on peut les détecter des données (english → chinese) - original_lang: "english", // Détecté des clés du vocabulaire - user_lang: "chinese", // Détecté des valeurs du vocabulaire - - // Icon: on peut faire une inférence basée sur le contenu détecté - icon: "🏠", // Basé sur la prédominance du vocabulaire housing - - // CORRECTION: On peut extraire les tags du contenu existant (ça c'est de l'analyse, pas de l'invention) - tags: this.extractTags(jsModule.vocabulary), - - // SUPPRIMÉ: skills_covered, target_audience, estimated_duration - // On n'a PAS ces infos dans le JS original, donc on n'invente pas ! - - // ======================================================================================================== - // VOCABULARY SECTION - ENHANCED FROM ORIGINAL - // ======================================================================================================== - vocabulary: this.enhanceVocabulary(jsModule.vocabulary || {}), - - // ======================================================================================================== - // SENTENCES SECTION - ENHANCED FROM ORIGINAL - // ======================================================================================================== - sentences: this.enhanceSentences(jsModule.sentences || []), - - // ======================================================================================================== - // CONVERSION METADATA - PROOF OF SYSTEM FUNCTIONALITY - // ======================================================================================================== - conversion_metadata: { - converted_from: "legacy_javascript_module", - conversion_timestamp: new Date().toISOString(), - conversion_system: "ultra_modular_converter_v1.0", - original_format: "js_content_module", - target_format: "ultra_modular_json_v2.0", - - // Original module stats - original_stats: { - vocabulary_count: capabilities.vocabularyCount, - sentence_count: capabilities.sentenceCount, - has_complex_phrases: capabilities.complexPhrases > 0 - }, - - // Detected capabilities - detected_capabilities: capabilities, - - // Game compatibility analysis - game_compatibility: compatibility, - - // Quality metrics - quality_score: this.calculateQualityScore(capabilities, compatibility) - }, - - // ======================================================================================================== - // SYSTEM VALIDATION - PROVES THE SYSTEM WORKS - // ======================================================================================================== - system_validation: { - format_version: "2.0", - specification: "ultra_modular", - backwards_compatible: true, - memory_stored: true, - conversion_verified: true, - ready_for_games: Object.values(compatibility).some(game => game.compatible) - } - }; - - return ultraModularSpec; - } - - extractTags(vocabulary) { - const tags = new Set(['vocabulary', 'intermediate']); - - for (const word of Object.keys(vocabulary)) { - if (word.match(/shirt|coat|dress|pants|jacket|shoes|clothing/)) { - tags.add('clothing'); - } - if (word.match(/building|apartment|house|room|elevator|housing/)) { - tags.add('housing'); - } - if (word.match(/street|town|center|avenue|places/)) { - tags.add('places'); - } - } - - return Array.from(tags); - } - - enhanceVocabulary(originalVocab) { - const enhanced = {}; - - for (const [word, translation] of Object.entries(originalVocab)) { - // CORRECTION: Ne pas inventer de données inexistantes! - // Conversion minimaliste: garder SEULEMENT ce qu'on a - enhanced[word] = { - user_language: translation, - original_language: word - // FINI. Pas d'invention de type, difficulté, catégorie, etc. - }; - } - - return enhanced; - } - - enhanceSentences(originalSentences) { - return originalSentences.map((sentence, index) => ({ - id: `sentence_${index + 1}`, - original_language: sentence.english, - user_language: sentence.chinese - // FINI. Pas d'invention de grammatical_focus, topic, etc. - })); - } - - // CORRECTION: Helper methods - SEULEMENT pour l'analyse des données existantes, pas l'invention - - calculateQualityScore(capabilities, compatibility) { - let score = 0; - - // Base content score - if (capabilities.hasVocabulary) score += 30; - if (capabilities.hasSentences) score += 20; - - // Volume bonus - score += Math.min(25, capabilities.vocabularyCount); - score += Math.min(15, capabilities.sentenceCount * 2); - - // Compatibility bonus - const compatibleGames = Object.values(compatibility).filter(g => g.compatible).length; - score += compatibleGames * 2; - - return Math.min(100, score); - } -} - -// ======================================== -// EXÉCUTION DU TEST -// ======================================== - -console.log('🔄 Conversion en cours...'); - -const converter = new JSToUltraModularConverter(); -const ultraModularJSON = converter.convert(sbsContent); - -console.log('✅ Conversion terminée avec succès!'); -console.log(`📊 Score de qualité: ${ultraModularJSON.conversion_metadata.quality_score}/100`); -console.log(`🎮 Jeux compatibles: ${Object.values(ultraModularJSON.conversion_metadata.game_compatibility).filter(g => g.compatible).length}/4`); -console.log(''); - -// ======================================== -// GÉNÉRATION DU FICHIER JSON -// ======================================== - -const fs = require('fs'); -const path = require('path'); - -const outputFile = 'sbs-level-7-8-GENERATED-from-js.json'; -const jsonContent = JSON.stringify(ultraModularJSON, null, 2); - -try { - fs.writeFileSync(outputFile, jsonContent, 'utf8'); - console.log(`📁 Fichier JSON généré: ${outputFile}`); - console.log(`📏 Taille: ${(jsonContent.length / 1024).toFixed(1)} KB`); - console.log(`📄 Lignes: ${jsonContent.split('\n').length}`); - console.log(''); - - // Validation finale - const reloaded = JSON.parse(jsonContent); - console.log('✅ VALIDATION FINALE:'); - console.log(` - JSON valide: ✅`); - console.log(` - ID: ${reloaded.id}`); - console.log(` - Nom: ${reloaded.name}`); - console.log(` - Vocabulaire: ${Object.keys(reloaded.vocabulary).length} mots`); - console.log(` - Phrases: ${reloaded.sentences.length}`); - console.log(` - Métadonnées conversion: ✅`); - console.log(` - Score qualité: ${reloaded.conversion_metadata.quality_score}/100`); - console.log(''); - console.log('🎉 PREUVE ÉTABLIE: Le système fonctionne parfaitement!'); - console.log(' - Données JS chargées en mémoire ✅'); - console.log(' - Analyse des capacités ✅'); - console.log(' - Conversion ultra-modulaire ✅'); - console.log(' - Génération JSON ✅'); - console.log(' - Validation finale ✅'); - -} catch (error) { - console.error('❌ Erreur lors de l\'écriture du fichier:', error.message); - process.exit(1); -} - -console.log('========================================================'); -console.log('✅ Test de conversion JS → JSON Ultra-Modulaire RÉUSSI'); \ No newline at end of file diff --git a/test-curl.js b/test-curl.js deleted file mode 100644 index cd2b5c2..0000000 --- a/test-curl.js +++ /dev/null @@ -1,102 +0,0 @@ -#!/usr/bin/env node - -const crypto = require('crypto'); -const { spawn } = require('child_process'); - -// Configuration -const config = { - DO_ACCESS_KEY: 'DO801MU8BZBB89LLK4FN', - DO_SECRET_KEY: 'rfKPjampdpUCYhn02XrKg6IWKmqebjg9HQTGxNLzJQY', - DO_REGION: 'fra1' -}; - -function sha256(message) { - return crypto.createHash('sha256').update(message, 'utf8').digest('hex'); -} - -function hmacSha256(key, message) { - return crypto.createHmac('sha256', key).update(message, 'utf8').digest(); -} - -async function generateSignatureAndTest() { - const testUrl = 'https://autocollant.fra1.digitaloceanspaces.com/Class_generator/ContentMe/greetings-basic.json'; - const method = 'GET'; - - // Timestamp actuel - const now = new Date(); - const dateStamp = now.toISOString().slice(0, 10).replace(/-/g, ''); - const timeStamp = now.toISOString().slice(0, 19).replace(/[-:]/g, '') + 'Z'; - - console.log(`🕐 Génération signature pour: ${timeStamp}`); - - // Parse URL - const urlObj = new URL(testUrl); - const host = urlObj.hostname; - const canonicalUri = urlObj.pathname; - - // Headers canoniques - const canonicalHeaders = `host:${host}\nx-amz-date:${timeStamp}\n`; - const signedHeaders = 'host;x-amz-date'; - - // Requête canonique - const payloadHash = sha256(''); - const canonicalRequest = [ - method, - canonicalUri, - '', // query string - canonicalHeaders, - signedHeaders, - payloadHash - ].join('\n'); - - // String to sign - const algorithm = 'AWS4-HMAC-SHA256'; - const credentialScope = `${dateStamp}/${config.DO_REGION}/s3/aws4_request`; - const canonicalRequestHash = sha256(canonicalRequest); - const stringToSign = [ - algorithm, - timeStamp, - credentialScope, - canonicalRequestHash - ].join('\n'); - - // Signature - const kDate = hmacSha256('AWS4' + config.DO_SECRET_KEY, dateStamp); - const kRegion = hmacSha256(kDate, config.DO_REGION); - const kService = hmacSha256(kRegion, 's3'); - const kSigning = hmacSha256(kService, 'aws4_request'); - const signature = hmacSha256(kSigning, stringToSign).toString('hex'); - - const authorization = `${algorithm} Credential=${config.DO_ACCESS_KEY}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`; - - console.log(`🔑 Authorization: ${authorization}`); - - // Test avec curl - const curlArgs = [ - '-X', 'GET', - testUrl, - '-H', `Authorization: ${authorization}`, - '-H', `X-Amz-Date: ${timeStamp}`, - '-H', `X-Amz-Content-Sha256: ${payloadHash}`, - '-H', 'User-Agent: test-client', - '-i' - ]; - - console.log('🌐 Test curl...'); - - const curl = spawn('curl', curlArgs); - - curl.stdout.on('data', (data) => { - console.log(data.toString()); - }); - - curl.stderr.on('data', (data) => { - console.error(data.toString()); - }); - - curl.on('close', (code) => { - console.log(`✅ Curl terminé avec code: ${code}`); - }); -} - -generateSignatureAndTest(); \ No newline at end of file diff --git a/test-digitalocean.html b/test-digitalocean.html deleted file mode 100644 index d09b0bc..0000000 --- a/test-digitalocean.html +++ /dev/null @@ -1,374 +0,0 @@ - - - - - - Test DigitalOcean Spaces Connection - - - -
-

🔧 Test de Connexion DigitalOcean Spaces

- -
-

📋 Configuration Actuelle

-
Chargement...
-
- -
-

🧪 Tests de Connexion

-
- - - - - -
-
- -
- -
-

📊 Résultats Détaillés

-
-
- -
-

💡 Recommandations

-
- Les recommandations apparaîtront après les tests... -
-
-
- - - - - - \ No newline at end of file diff --git a/test-do-auth.html b/test-do-auth.html deleted file mode 100644 index 5b998fc..0000000 --- a/test-do-auth.html +++ /dev/null @@ -1,100 +0,0 @@ - - - - Test DigitalOcean Auth - - - -

🔧 Test Authentification DigitalOcean

- - -
- - - - - \ No newline at end of file diff --git a/test-dragon-pearl.js b/test-dragon-pearl.js deleted file mode 100644 index b935722..0000000 --- a/test-dragon-pearl.js +++ /dev/null @@ -1,59 +0,0 @@ -// === TEST AVEC DRAGON'S PEARL === - -// Simuler l'environnement browser -global.window = {}; -global.document = {}; -global.logSh = (msg, level) => console.log(`[${level}] ${msg}`); - -// Charger les modules -const fs = require('fs'); -const path = require('path'); - -// Charger le système de compatibilité -const compatibilityCode = fs.readFileSync(path.join(__dirname, 'js/core/content-game-compatibility.js'), 'utf8'); -eval(compatibilityCode); - -// Charger le contenu Dragon's Pearl -const dragonPearlCode = fs.readFileSync(path.join(__dirname, 'js/content/chinese-long-story.js'), 'utf8'); -eval(dragonPearlCode); - -console.log('🐉 Test avec Dragon\'s Pearl\n'); - -try { - const checker = new window.ContentGameCompatibility(); - const dragonPearlContent = window.ContentModules.ChineseLongStory; - - console.log('📦 Contenu Dragon\'s Pearl:'); - console.log(` Nom: ${dragonPearlContent.name}`); - console.log(` Description: ${dragonPearlContent.description}`); - console.log(` Difficulté: ${dragonPearlContent.difficulty}`); - console.log(` Vocabulaire: ${Object.keys(dragonPearlContent.vocabulary || {}).length} mots`); - console.log(` Story: ${dragonPearlContent.story ? 'Oui' : 'Non'}`); - - console.log('\n🎮 Tests de compatibilité:'); - const games = ['whack-a-mole', 'memory-match', 'quiz-game', 'fill-the-blank', 'text-reader', 'adventure-reader']; - - games.forEach(game => { - const result = checker.checkCompatibility(dragonPearlContent, game); - const status = result.compatible ? '✅' : '❌'; - console.log(` ${status} ${game}: ${result.score}% - ${result.reason}`); - }); - - console.log('\n💡 Suggestions pour jeux incompatibles:'); - games.forEach(game => { - const result = checker.checkCompatibility(dragonPearlContent, game); - if (!result.compatible) { - const suggestions = checker.getImprovementSuggestions(dragonPearlContent, game); - if (suggestions.length > 0) { - console.log(` 📝 ${game}:`); - suggestions.forEach(suggestion => { - console.log(` 💡 ${suggestion}`); - }); - } - } - }); - -} catch (error) { - console.error('❌ Erreur:', error.message); - console.error(error.stack); -} \ No newline at end of file diff --git a/test-extraction-direct.js b/test-extraction-direct.js deleted file mode 100644 index 498e20d..0000000 --- a/test-extraction-direct.js +++ /dev/null @@ -1,87 +0,0 @@ -// === TEST EXTRACTION DIRECT === - -// Script pour tester l'extraction des phrases de Dragon's Pearl -// À copier-coller dans la console - -function testExtractionDirect() { - console.log('🔬 Test extraction direct Dragon\\'s Pearl'); - - // 1. Récupérer le module - const dragonModule = window.ContentModules?.ChineseLongStory; - console.log('\\n📦 Module Dragon\\'s Pearl:', !!dragonModule); - - if (!dragonModule) { - console.error('❌ Module non trouvé !'); - return; - } - - // 2. Tester la structure - console.log('\\n🔍 Structure du module:'); - console.log(' story:', !!dragonModule.story); - console.log(' story.chapters:', !!dragonModule.story?.chapters); - console.log(' Nombre de chapitres:', dragonModule.story?.chapters?.length || 0); - - if (dragonModule.story?.chapters?.[0]) { - const firstChapter = dragonModule.story.chapters[0]; - console.log('\\n📖 Premier chapitre:'); - console.log(' Titre:', firstChapter.title); - console.log(' Sentences:', !!firstChapter.sentences); - console.log(' Nombre phrases:', firstChapter.sentences?.length || 0); - - if (firstChapter.sentences?.[0]) { - const firstSentence = firstChapter.sentences[0]; - console.log('\\n💬 Première phrase:'); - console.log(' original:', firstSentence.original); - console.log(' translation:', firstSentence.translation); - console.log(' id:', firstSentence.id); - } - } - - // 3. Tester l'extraction manuellement - console.log('\\n🧪 Test extraction manuelle:'); - - const sentences = []; - - if (dragonModule.story && dragonModule.story.chapters && Array.isArray(dragonModule.story.chapters)) { - dragonModule.story.chapters.forEach(chapter => { - console.log(` Traitement chapitre: ${chapter.title}`); - - if (chapter.sentences && Array.isArray(chapter.sentences)) { - console.log(` ${chapter.sentences.length} phrases dans ce chapitre`); - - chapter.sentences.forEach(sentence => { - if (sentence.original && sentence.translation) { - sentences.push({ - original_language: sentence.original, - user_language: sentence.translation, - pronunciation: sentence.pronunciation || '', - chapter: chapter.title || '', - id: sentence.id || sentences.length - }); - } else { - console.warn(' ⚠️ Phrase ignorée:', sentence); - } - }); - } else { - console.warn(` ⚠️ Pas de sentences dans ${chapter.title}`); - } - }); - } else { - console.error(' ❌ Structure story.chapters introuvable'); - } - - console.log('\\n📊 Résultat extraction:'); - console.log(' Phrases extraites:', sentences.length); - - if (sentences.length > 0) { - console.log(' Première phrase extraite:', sentences[0]); - console.log(' Dernière phrase extraite:', sentences[sentences.length - 1]); - } else { - console.error(' ❌ Aucune phrase extraite !'); - } - - return sentences; -} - -// Auto-exécution -const results = testExtractionDirect(); \ No newline at end of file diff --git a/test-final-compatibility.html b/test-final-compatibility.html deleted file mode 100644 index aecb8df..0000000 --- a/test-final-compatibility.html +++ /dev/null @@ -1,333 +0,0 @@ - - - - - - Test Final - Système de Compatibilité - - - -

🎯 Test Final - Système de Compatibilité Content-Game

- -
-

📊 Vue d'ensemble

-
- -
- - -
- -
-

📦 Contenus Détectés

-
-
- -
-

🎮 Matrice de Compatibilité

-
-
- -
-

📋 Log d'Exécution

-
-
- - - - - - - - - - - \ No newline at end of file diff --git a/test-flux-bouton-back.md b/test-flux-bouton-back.md deleted file mode 100644 index c1c4042..0000000 --- a/test-flux-bouton-back.md +++ /dev/null @@ -1,60 +0,0 @@ -# 🔄 TEST DU FLUX BOUTON BACK - -## ✅ Ancienne Interface Supprimée - -La fonction `showGamesPageFallback()` a été **complètement supprimée** de `navigation.js`. - -## 🎯 Nouveau Flux Unique - -### 1. Depuis Niveau → Jeux ✅ -``` -Levels → Clic Dragon's Pearl → showGamesPage(content) → Interface avec compatibilité -``` - -### 2. Depuis Bouton Back ✅ -``` -Jeux → Bouton Back → goBack() → Récupère content depuis URL → showGamesPage(content) → Interface avec compatibilité -``` - -### 3. Si Pas de Content (Fallback) ✅ -``` -Jeux → Bouton Back → goBack() → Pas de content → Retour aux Levels -``` - -## 🔧 Modifications Apportées - -### 1. Supprimé `showGamesPageFallback()` -- ❌ **SUPPRIMÉ** : L'ancienne interface sans compatibilité -- ✅ **GARDÉ** : `showGamesPage()` + `renderGamesGrid()` avec compatibilité - -### 2. Modifié `navigateTo()` case 'games' -```javascript -case 'games': - if (!content) { - // Retour aux levels si pas de content - this.showLevelsPage(); - } else { - // Interface avec compatibilité - this.showGamesPage(content) - } -``` - -### 3. Modifié `goBack()` pour games -```javascript -} else if (previousPage === 'games') { - const urlContent = params.content; - if (urlContent) { - this.navigateTo('games', null, urlContent); // ✅ Avec content - } else { - this.navigateTo('levels'); // ✅ Fallback vers levels - } -``` - -## 🎯 Résultat - -Maintenant il n'y a plus qu'**UNE SEULE interface** pour choisir les jeux : -- ✅ **Toujours** avec analyse de compatibilité -- ✅ **Toujours** avec badges et sections -- ✅ **Toujours** avec le scan dynamique - -**Peu importe** comment tu arrives sur la page des jeux (depuis niveau ou bouton back), c'est **toujours la même interface** avec compatibilité ! 🚀 \ No newline at end of file diff --git a/test-logs-interface.html b/test-logs-interface.html deleted file mode 100644 index 222fb4e..0000000 --- a/test-logs-interface.html +++ /dev/null @@ -1,78 +0,0 @@ - - - - Test Logs Interface Direct - - - -

Test Direct Interface de Logs

-
En attente...
-
- - - - \ No newline at end of file diff --git a/test-node-compatibility.js b/test-node-compatibility.js deleted file mode 100644 index fde87a9..0000000 --- a/test-node-compatibility.js +++ /dev/null @@ -1,107 +0,0 @@ -// === TEST NODE.JS DU SYSTÈME DE COMPATIBILITÉ === - -// Simuler l'environnement browser -global.window = {}; -global.document = {}; -global.logSh = (msg, level) => console.log(`[${level}] ${msg}`); - -// Charger les modules -const fs = require('fs'); -const path = require('path'); - -// Charger le système de compatibilité -const compatibilityCode = fs.readFileSync(path.join(__dirname, 'js/core/content-game-compatibility.js'), 'utf8'); -eval(compatibilityCode); - -// Créer les contenus de test -const testMinimalContent = { - id: "test-minimal", - name: "Test Minimal", - vocabulary: { - "hello": "bonjour", - "world": "monde" - } -}; - -const testRichContent = { - id: "test-rich", - name: "Test Riche", - vocabulary: { - "apple": { - translation: "pomme", - prononciation: "apple", - type: "noun" - }, - "book": { - translation: "livre", - prononciation: "book", - type: "noun" - }, - "car": { - translation: "voiture", - prononciation: "car", - type: "noun" - }, - "dog": { - translation: "chien", - prononciation: "dog", - type: "noun" - }, - "eat": { - translation: "manger", - prononciation: "eat", - type: "verb" - } - }, - sentences: [ - { english: "I have an apple", french: "J'ai une pomme" }, - { english: "The dog is good", french: "Le chien est bon" }, - { english: "I like books", french: "J'aime les livres" } - ], - dialogues: [ - { - title: "Test dialogue", - conversation: [ - { speaker: "A", english: "Hello", french: "Bonjour" }, - { speaker: "B", english: "Hi there", french: "Salut" } - ] - } - ] -}; - -// Tester le système -console.log('🧪 Test du système de compatibilité Content-Game\n'); - -try { - const checker = new window.ContentGameCompatibility(); - console.log('✅ ContentGameCompatibility initialisé\n'); - - const games = ['whack-a-mole', 'memory-match', 'quiz-game', 'fill-the-blank', 'text-reader', 'adventure-reader']; - - console.log('📦 Test avec contenu minimal (2 mots):'); - games.forEach(game => { - const result = checker.checkCompatibility(testMinimalContent, game); - const status = result.compatible ? '✅' : '❌'; - console.log(` ${status} ${game}: ${result.score}% - ${result.reason}`); - }); - - console.log('\n📦 Test avec contenu riche:'); - games.forEach(game => { - const result = checker.checkCompatibility(testRichContent, game); - const status = result.compatible ? '✅' : '❌'; - console.log(` ${status} ${game}: ${result.score}% - ${result.reason}`); - }); - - console.log('\n🧪 Test des suggestions d\'amélioration:'); - const suggestions = checker.getImprovementSuggestions(testMinimalContent, 'whack-a-mole'); - console.log(` Suggestions pour "whack-a-mole":`); - suggestions.forEach(suggestion => { - console.log(` 💡 ${suggestion}`); - }); - - console.log('\n🎉 Tous les tests réussis!'); - -} catch (error) { - console.error('❌ Erreur:', error.message); - console.error(error.stack); -} \ No newline at end of file diff --git a/test-real-flow.js b/test-real-flow.js deleted file mode 100644 index 6dceec1..0000000 --- a/test-real-flow.js +++ /dev/null @@ -1,116 +0,0 @@ -// === TEST DU FLUX COMPLET === - -// Test qui simule exactement le flux réel de l'application -async function testRealFlow() { - console.log('🔄 Test du flux complet de l\'application\n'); - - // Simuler l'environnement browser - global.window = {}; - global.document = {}; - global.logSh = (msg, level) => console.log(`[${level}] ${msg}`); - - // Charger tous les modules - const fs = require('fs'); - const path = require('path'); - - // 1. Charger ContentScanner - const scannerCode = fs.readFileSync(path.join(__dirname, 'js/core/content-scanner.js'), 'utf8'); - eval(scannerCode); - - // 2. Charger ContentGameCompatibility - const compatibilityCode = fs.readFileSync(path.join(__dirname, 'js/core/content-game-compatibility.js'), 'utf8'); - eval(compatibilityCode); - - // 3. Charger le contenu Dragon's Pearl - const dragonPearlCode = fs.readFileSync(path.join(__dirname, 'js/content/chinese-long-story.js'), 'utf8'); - eval(dragonPearlCode); - - try { - console.log('🚀 1. Initialisation du système...'); - const scanner = new window.ContentScanner(); - const checker = new window.ContentGameCompatibility(); - - console.log('📦 2. Scan du contenu...'); - const results = await scanner.scanAllContent(); - console.log(` Trouvé: ${results.found.length} modules`); - - // 3. Rechercher Dragon's Pearl dans les résultats - console.log('🐉 3. Recherche Dragon\'s Pearl...'); - const dragonPearl = results.found.find(content => - content.name.includes('Dragon') || content.id.includes('chinese-long-story') - ); - - if (dragonPearl) { - console.log(` ✅ Trouvé: ${dragonPearl.name} (ID: ${dragonPearl.id})`); - - // 4. Test de compatibilité comme dans l'interface - console.log('🎮 4. Test de compatibilité des jeux...'); - const games = ['whack-a-mole', 'memory-match', 'quiz-game', 'fill-the-blank', 'text-reader', 'adventure-reader']; - - const compatibleGames = []; - const incompatibleGames = []; - - games.forEach(game => { - const compatibility = checker.checkCompatibility(dragonPearl, game); - const gameData = { game, compatibility }; - - if (compatibility.compatible) { - compatibleGames.push(gameData); - } else { - incompatibleGames.push(gameData); - } - - console.log(` ${compatibility.compatible ? '✅' : '❌'} ${game}: ${compatibility.score}%`); - }); - - console.log(`\n📊 Résultat final:`); - console.log(` 🎯 Jeux compatibles: ${compatibleGames.length}`); - console.log(` ⚠️ Jeux incompatibles: ${incompatibleGames.length}`); - - if (compatibleGames.length > 0) { - console.log(`\n🎉 SUCCESS: Dragon's Pearl devrait maintenant afficher ${compatibleGames.length} jeux compatibles`); - - // Simuler l'affichage comme dans l'interface - console.log('\n🎯 Jeux recommandés:'); - compatibleGames - .sort((a, b) => b.compatibility.score - a.compatibility.score) - .forEach(({ game, compatibility }) => { - const badge = compatibility.score >= 80 ? '🎯 Excellent' : - compatibility.score >= 60 ? '✅ Recommandé' : '👍 Compatible'; - console.log(` ${badge} ${game} (${compatibility.score}%)`); - }); - - if (incompatibleGames.length > 0) { - console.log('\n⚠️ Jeux avec limitations:'); - incompatibleGames.forEach(({ game, compatibility }) => { - console.log(` ⚠️ Limité ${game} (${compatibility.score}%) - ${compatibility.reason}`); - }); - } - } else { - console.log('❌ PROBLÈME: Aucun jeu compatible détecté'); - } - - } else { - console.log('❌ Dragon\'s Pearl non trouvé dans les résultats'); - console.log(' Contenus trouvés:'); - results.found.forEach(content => { - console.log(` - ${content.name} (ID: ${content.id})`); - }); - } - - } catch (error) { - console.error('❌ Erreur:', error.message); - console.error(error.stack); - } -} - -// Utils pour le scanner -global.window = global.window || {}; -global.window.Utils = { - storage: { - get: (key, defaultValue) => defaultValue, - set: (key, value) => {} - } -}; - -testRealFlow(); \ No newline at end of file diff --git a/test-reverse-conversion.html b/test-reverse-conversion.html deleted file mode 100644 index c93628e..0000000 --- a/test-reverse-conversion.html +++ /dev/null @@ -1,457 +0,0 @@ - - - - - - 🔄 Test: JS → JSON Ultra-Modulaire - - - -

🔄 Test: Conversion JS → JSON Ultra-Modulaire

-

Démonstration complète du système : partir d'un module JS existant et générer un JSON ultra-modulaire

- -
- - - - - - - - - - - - - \ No newline at end of file diff --git a/test-ultra-modular.html b/test-ultra-modular.html deleted file mode 100644 index f445277..0000000 --- a/test-ultra-modular.html +++ /dev/null @@ -1,332 +0,0 @@ - - - - - - Test Ultra-Modular JSON System - - - -

🧪 Test du Système Ultra-Modulaire

-

Test de compatibilité avec les nouvelles spécifications JSON

- -
- - - - - - - - - - - \ No newline at end of file diff --git a/test-websocket-simple.html b/test-websocket-simple.html deleted file mode 100644 index 7219e42..0000000 --- a/test-websocket-simple.html +++ /dev/null @@ -1,75 +0,0 @@ - - - - Test WebSocket Simple - - - -

Test WebSocket Simple

-
En attente...
-
- - - - \ No newline at end of file diff --git a/todotemp.md b/todotemp.md deleted file mode 100644 index 362a10f..0000000 --- a/todotemp.md +++ /dev/null @@ -1,158 +0,0 @@ -# TODO List - Développement Technique - -## 🚨 URGENT - DEMAIN - -### Core Navigation System -- [ ] Create index.html with 3-level navigation -- [ ] Implement URL routing with params (?page=games&game=whack&content=sbs8) -- [ ] Build game-selector.html with clickable cards -- [ ] Build level-selector.html with dynamic content loading -- [ ] Create game.html generic page with dynamic module loading - -### Game Modules -- [ ] Refactor existing whack-a-mole.js into proper module format -- [ ] Refactor existing fill-the-blank.js into proper module format -- [ ] Implement game loader system (js/core/game-loader.js) -- [ ] Create base GameEngine class for inheritance - -### Content System -- [ ] Convert sbs-level-8.js to new unified format -- [ ] Implement content loader system -- [ ] Create content validation functions -- [ ] Add error handling for missing content - -### New Games (Pick 3-4) -- [ ] simon-says.js - digital "Touch the X" game -- [ ] speed-categories.js - rapid category clicking -- [ ] true-false.js - rapid true/false with images -- [ ] memory-pairs.js - classic memory game -- [ ] sound-match.js - audio to image matching -- [ ] catch-words.js - flying words to catch - ---- - -## 📚 CONTENT EXPANSION - -### Lesson Introduction Module -- [ ] Create lesson-intro.js for vocabulary presentation -- [ ] Add context presentation before games -- [ ] Implement guided repetition system -- [ ] Add audio playback for pronunciation - -### Additional Content Modules -- [ ] animals.js vocabulary set -- [ ] colors.js vocabulary set -- [ ] family-extended.js more family vocabulary -- [ ] actions.js verbs and actions - ---- - -## 🔧 TECHNICAL IMPROVEMENTS - -### Core System -- [ ] navigation.js - handle URL routing and back buttons -- [ ] utils.js - shared utility functions -- [ ] audio-manager.js - handle sound loading/playing -- [ ] progress-tracker.js - basic score tracking - -### Game Engine Enhancements -- [ ] Standardize game initialization pattern -- [ ] Add game state management (start/pause/stop/reset) -- [ ] Implement scoring system interface -- [ ] Add game configuration loading - -### Performance & UX -- [ ] Lazy loading for game modules -- [ ] Preload critical assets -- [ ] Add loading states and spinners -- [ ] Implement keyboard shortcuts (ESC = back) - ---- - -## 🎯 MODULAR ARCHITECTURE - -### File Structure Implementation -``` -├── index.html -├── css/ -│ ├── main.css -│ ├── games.css -│ └── navigation.css -├── js/ -│ ├── core/ -│ │ ├── navigation.js -│ │ ├── game-loader.js -│ │ ├── content-loader.js -│ │ └── utils.js -│ ├── games/ -│ │ ├── base-game.js -│ │ ├── whack-a-mole.js -│ │ ├── fill-blank.js -│ │ ├── simon-says.js -│ │ ├── speed-categories.js -│ │ └── temp-games.js -│ └── content/ -│ ├── sbs-level-8.js -│ ├── animals.js -│ └── colors.js -``` - -### Module Standards -- [ ] Define base game class interface -- [ ] Standardize content module format -- [ ] Create module registration system -- [ ] Implement dependency loading - ---- - -## 🌟 FUTURE TECHNICAL FEATURES - -### Advanced Game Types -- [ ] drag-drop.js - sentence building -- [ ] story-builder.js - narrative construction -- [ ] voice-game.js - speech recognition -- [ ] drawing-game.js - character tracing - -### Content Management -- [ ] JSON-based content configuration -- [ ] Content validation schemas -- [ ] Dynamic content generation helpers -- [ ] Content import/export utilities - -### System Extensions -- [ ] Plugin architecture for third-party games -- [ ] API for external content sources -- [ ] Offline caching system -- [ ] Multi-language UI support - ---- - -## 🚀 CHINESE VERSION PREP - -### Architecture Adaptation -- [ ] Extend content format for Chinese specifics -- [ ] Add tone support in audio system -- [ ] Implement character stroke order -- [ ] Add pinyin display system - -### Chinese-Specific Games -- [ ] stroke-order.js - character writing -- [ ] tone-practice.js - tone recognition -- [ ] radical-builder.js - character composition -- [ ] pinyin-typing.js - romanization practice - ---- - -## 🤖 AI INTEGRATION PREP - -### API Integration Points -- [ ] content-generator.js - AI content creation -- [ ] response-validator.js - AI answer checking -- [ ] difficulty-adapter.js - AI difficulty adjustment -- [ ] feedback-generator.js - AI personalized feedback - -### Data Collection -- [ ] User interaction logging -- [ ] Performance metrics collection -- [ ] Error pattern tracking -- [ ] Learning progress data structure \ No newline at end of file diff --git a/validate-compatibility-system.js b/validate-compatibility-system.js deleted file mode 100644 index e94a8e6..0000000 --- a/validate-compatibility-system.js +++ /dev/null @@ -1,75 +0,0 @@ -// === SCRIPT DE VALIDATION DU SYSTÈME DE COMPATIBILITÉ === - -// Fonction pour tester le chargement des modules -async function validateCompatibilitySystem() { - console.log('🧪 Validation du système de compatibilité...'); - - // Test 1: Vérifier que les classes globales existent - console.log('\n1️⃣ Test des classes globales:'); - const requiredClasses = [ - 'ContentScanner', - 'ContentGameCompatibility' - ]; - - requiredClasses.forEach(className => { - if (window[className]) { - console.log(`✅ ${className} est disponible`); - } else { - console.error(`❌ ${className} manquant!`); - } - }); - - // Test 2: Initialiser les systèmes - console.log('\n2️⃣ Test d\'initialisation:'); - try { - const scanner = new window.ContentScanner(); - console.log('✅ ContentScanner initialisé'); - - const checker = new window.ContentGameCompatibility(); - console.log('✅ ContentGameCompatibility initialisé'); - - // Test 3: Scanner le contenu - console.log('\n3️⃣ Test du scan de contenu:'); - const results = await scanner.scanAllContent(); - console.log(`✅ Scan terminé: ${results.found.length} modules trouvés`); - - // Test 4: Test de compatibilité - console.log('\n4️⃣ Test de compatibilité:'); - if (results.found.length > 0) { - const testContent = results.found[0]; - const compatibility = checker.checkCompatibility(testContent, 'whack-a-mole'); - console.log(`✅ Test compatibilité: ${testContent.name} → whack-a-mole = ${compatibility.compatible ? 'Compatible' : 'Incompatible'} (${compatibility.score}%)`); - } - - // Test 5: Vérifier AppNavigation - console.log('\n5️⃣ Test de l\'intégration navigation:'); - if (window.AppNavigation && window.AppNavigation.compatibilityChecker) { - console.log('✅ AppNavigation a le système de compatibilité intégré'); - } else { - console.log('⚠️ AppNavigation n\'a pas le système de compatibilité'); - } - - console.log('\n🎉 Tous les tests passés!'); - return true; - - } catch (error) { - console.error(`❌ Erreur pendant les tests: ${error.message}`); - console.error(error.stack); - return false; - } -} - -// Auto-exécution si ce script est chargé directement -if (typeof window !== 'undefined') { - // Attendre que tous les scripts soient chargés - if (document.readyState === 'loading') { - document.addEventListener('DOMContentLoaded', () => { - setTimeout(validateCompatibilitySystem, 1000); - }); - } else { - setTimeout(validateCompatibilitySystem, 1000); - } -} - -// Export pour utilisation manuelle -window.validateCompatibilitySystem = validateCompatibilitySystem; \ No newline at end of file diff --git a/verify-real-app.js b/verify-real-app.js deleted file mode 100644 index 46492d1..0000000 --- a/verify-real-app.js +++ /dev/null @@ -1,148 +0,0 @@ -// === SCRIPT DE VÉRIFICATION APPLICATION RÉELLE === - -// Test que tous les composants fonctionnent ensemble dans l'app réelle -async function verifyRealApplication() { - console.log('🔍 Vérification de l\'application réelle...\n'); - - const tests = []; - - // Test 1: Vérifier que AppNavigation existe et est initialisé - tests.push({ - name: 'AppNavigation disponible', - test: () => window.AppNavigation && typeof window.AppNavigation.init === 'function', - critical: true - }); - - // Test 2: Vérifier que le système de compatibilité est intégré - tests.push({ - name: 'Système de compatibilité intégré', - test: () => window.AppNavigation && window.AppNavigation.compatibilityChecker, - critical: true - }); - - // Test 3: Vérifier que ContentScanner est opérationnel - tests.push({ - name: 'ContentScanner opérationnel', - test: () => window.AppNavigation && window.AppNavigation.contentScanner, - critical: true - }); - - // Test 4: Vérifier que GameLoader existe - tests.push({ - name: 'GameLoader disponible', - test: () => window.GameLoader && typeof window.GameLoader.loadGame === 'function', - critical: true - }); - - // Test 5: Vérifier que les modules de jeu sont chargés - tests.push({ - name: 'Modules de jeu chargés', - test: () => window.GameModules && Object.keys(window.GameModules).length > 0, - critical: false - }); - - // Test 6: Vérifier que les modules de contenu sont chargés - tests.push({ - name: 'Modules de contenu chargés', - test: () => window.ContentModules && Object.keys(window.ContentModules).length > 0, - critical: false - }); - - // Test 7: Vérifier que showGamesPage est async - tests.push({ - name: 'showGamesPage est async', - test: () => { - const fn = window.AppNavigation.showGamesPage; - return fn && fn.constructor.name === 'AsyncFunction'; - }, - critical: true - }); - - // Test 8: Vérifier les CSS de compatibilité - tests.push({ - name: 'CSS de compatibilité chargé', - test: () => { - const sheets = Array.from(document.styleSheets); - return sheets.some(sheet => { - try { - const rules = Array.from(sheet.cssRules || []); - return rules.some(rule => rule.selectorText && rule.selectorText.includes('compatibility-badge')); - } catch (e) { - return false; - } - }); - }, - critical: false - }); - - // Exécuter tous les tests - let passedTests = 0; - let criticalFailed = 0; - - console.log('📋 Résultats des tests:\n'); - - for (const test of tests) { - try { - const result = test.test(); - if (result) { - console.log(`✅ ${test.name}`); - passedTests++; - } else { - const level = test.critical ? 'CRITIQUE' : 'OPTIONNEL'; - console.log(`❌ ${test.name} (${level})`); - if (test.critical) criticalFailed++; - } - } catch (error) { - const level = test.critical ? 'CRITIQUE' : 'OPTIONNEL'; - console.log(`🚨 ${test.name} - ERREUR: ${error.message} (${level})`); - if (test.critical) criticalFailed++; - } - } - - console.log(`\n📊 Résultat: ${passedTests}/${tests.length} tests réussis`); - - if (criticalFailed === 0) { - console.log('🎉 Tous les tests critiques passent! L\'application est prête.'); - - // Test bonus: essayer de charger du contenu - if (window.AppNavigation && window.AppNavigation.contentScanner) { - console.log('\n🔍 Test bonus: chargement du contenu...'); - try { - const results = await window.AppNavigation.contentScanner.scanAllContent(); - console.log(`✅ ${results.found.length} modules de contenu détectés`); - - // Test de compatibilité sur contenu réel - if (results.found.length > 0 && window.AppNavigation.compatibilityChecker) { - const testContent = results.found[0]; - const compatibility = window.AppNavigation.compatibilityChecker.checkCompatibility(testContent, 'whack-a-mole'); - console.log(`✅ Test compatibilité: ${compatibility.compatible ? 'COMPATIBLE' : 'INCOMPATIBLE'} (${compatibility.score}%)`); - } - } catch (error) { - console.log(`⚠️ Erreur lors du test bonus: ${error.message}`); - } - } - - return true; - } else { - console.log(`❌ ${criticalFailed} tests critiques ont échoué. Vérification nécessaire.`); - return false; - } -} - -// Fonction d'auto-test -function autoVerify() { - // Attendre que l'app soit complètement chargée - if (document.readyState !== 'complete') { - window.addEventListener('load', () => setTimeout(verifyRealApplication, 2000)); - } else { - setTimeout(verifyRealApplication, 2000); - } -} - -// Export pour utilisation manuelle -window.verifyRealApplication = verifyRealApplication; - -// Auto-vérification si ce script est chargé dans l'app réelle -if (typeof window !== 'undefined' && window.location.pathname === '/') { - autoVerify(); -} \ No newline at end of file