MathPath AI - Document de Référence Technique

🌟 Vision du Projet

Objectif Principal

Créer un écosystème d'apprentissage mathématique complet, adaptatif et engageant qui transforme l'expérience d'apprentissage des élèves tunisiens de 7ème année en utilisant l'intelligence artificielle, la gamification et la visualisation 3D interactive.

Principes Fondateurs

Personnalisation totale - Chaque élève suit son propre parcours
Engagement par le jeu - Motivation intrinsèque via gamification
Diagnostic intelligent - Identification précise des lacunes
Feedback immédiat - Correction progressive et pédagogique
Visualisation intuitive - Compréhension spatiale des concepts
Rigueur pédagogique - Respect strict du curriculum tunisien

⚠️ Contraintes Pédagogiques Strictes

Interdiction absolue d'utiliser des concepts mathématiques non adaptés au niveau :

❌ Pas de vecteurs (niveau lycée)
❌ Pas de théorème de Pythagore avant 9ème
❌ Pas de trigonométrie avant 9ème
❌ Pas de fonctions avancées avant niveau approprié
✅ Utiliser uniquement les méthodes du programme tunisien

🎯 Les 9 Composantes de MathPath AI

🔍 1. Diagnostic Intelligent et Adaptatif

Fonctionnalités

Évaluation initiale du niveau de l'élève
Identification précise des lacunes et points forts
Adaptation continue selon les performances en temps réel
Questions adaptatives qui s'ajustent à la difficulté
Analyse des patterns d'erreurs récurrentes

🗺️ 2. Carte 3D Interactive des Connaissances

Fonctionnalités

Visualisation spatiale en 3D des concepts mathématiques
Navigation immersive dans l'arbre des compétences
Connexions visuelles entre notions liées
Zoom sur les compétences spécifiques
Code couleur selon le niveau de maîtrise (vert/orange/rouge)
Interface rotative et interactive (Three.js)

🤖 3. Ulysse - Le Compagnon IA

Fonctionnalités

Avatar intelligent qui guide l'élève personnellement
Dialogue personnalisé et encourageant
Explications adaptées au niveau de compréhension
Intervention lors de difficultés détectées
Célébration des réussites
Conseils stratégiques d'apprentissage

🎥 4. Vidéos d'Erreurs Pédagogiques

Fonctionnalités

Analyse vidéo des erreurs courantes
Explications visuelles animées
Prévention des malentendus conceptuels
Exemples concrets et contre-exemples
Bibliothèque d'erreurs typiques par chapitre

📅 5. Missions Quotidiennes Personnalisées

Fonctionnalités

Exercices ciblés selon le profil unique de l'élève
Progression adaptative basée sur performance
Objectifs quotidiens atteignables et motivants
Rappels et notifications
Séries d'exercices thématiques (streaks)

🎮 6. Gamification et Engagement

Système de Points et Niveaux

Points XP par exercice réussi
Niveaux progressifs (Débutant → Apprenti → Expert → Maître)
Multiplicateurs de points (combos, streaks)

Badges de Réussite

Badges de maîtrise par compétence
Badges spéciaux (vitesse, perfection, persévérance)
Collection visible dans le profil

Défis Boss

Exercices complexes débloqués après maîtrise
Récompenses exceptionnelles
Classement des vainqueurs Boss

Classements

Leaderboard de classe
Leaderboard inter-écoles
Compétitions amicales

📊 7. Suivi et Visualisation de Progression

Barres de Santé (0-100%)

Indicateur visuel par compétence
Mise à jour en temps réel
Code couleur (vert >70%, orange 40-70%, rouge <40%)

Analyses Détaillées

Checkmarks ✓ pour compétences maîtrisées
Warnings ⚠️ pour compétences à améliorer
Graphiques de progression temporelle
Statistiques détaillées (taux réussite, temps moyen, etc.)

Conseils Personnalisés

Recommandations d'exercices ciblés
Suggestions de révisions
Plan d'action adaptatif

💡 8. Système d'Aide Progressif (COMDEM)

Completion - Indices et Méthodologie

Niveau 1 : Indices subtils
Niveau 2 : Méthodologie pas à pas
Conservation de l'autonomie de l'élève

Demandes - Solutions Complètes

Solution détaillée et expliquée
Justification de chaque étape
Disponible après tentatives

Correction en 3 Niveaux

Bouton "Aide" → Indices
Bouton "Méthode" → Méthodologie
Bouton "Solution" → Correction complète

🤝 9. Collaboration Inter-Écoles

Fonctionnalités

Partage d'expériences entre élèves
Défis collectifs inter-classes
Émulation positive et saine
Forums de discussion modérés
Tutorat entre pairs

📚 Chapitres MathPath (7ème Année)

⚠️ Périmètre Actuel

MathPath AI concerne uniquement 3 chapitres de 7ème année :

🍰 Fractions

Opérations sur les fractions
Simplification
Comparaison
Problèmes appliqués

🔢 Nombres Décimaux

Opérations (+, -, ×, ÷)
Conversions
Calculs complexes
Applications pratiques

➗ Divisibilité

Critères de divisibilité
Diviseurs et multiples
PGCD / PPCM (niveau 7ème)
Nombres premiers

📁 Structure des Fichiers

🎯 Principe FONDAMENTAL - Structure COMDEM

Chaque chapitre a son propre fichier comdem.html LOCAL

Le script charge BÊTEMENT le fichier relatif ./comdem/comdem.html

PAS de détection, PAS de logique complexe !

📁 Site Web MathPath
│
├─ 📁 fractions/
│  ├─ index.html
│  ├─ exercice1.html
│  ├─ exercice2.html
│  └─ 📁 comdem/
│     └─ comdem.html  ← Spécifique aux fractions
│
├─ 📁 decimaux/
│  ├─ index.html
│  ├─ exercice1.html
│  └─ 📁 comdem/
│     └─ comdem.html  ← Spécifique aux décimaux
│
├─ 📁 divisibilite/
│  ├─ index.html
│  ├─ exercice1.html
│  └─ 📁 comdem/
│     └─ comdem.html  ← Spécifique à la divisibilité
│
├─ 📁 css/
│  └─ basic.css  ← Contient styles COMDEM
│
├─ 📁 js/
│  └─ panellateral.js  ← Contient script COMDEM
│
└─ MATHPATH_REFERENCE.html  ← Ce fichier !

Fonctionnement du Système COMDEM

// Dans panellateral.js - Section COMDEM
/* ========================================
   SYSTÈME COMDEM - Completion & Demandes
   ======================================== */

function loadComdem() {
    // Charge simplement ./comdem/comdem.html
    // Affiche dans div flottant
    // Le chemin relatif fait TOUT le travail !
    
    fetch('./comdem/comdem.html')
        .then(response => response.text())
        .then(html => {
            // Affichage dans div flottant
            displayComdemPanel(html);
        });
}
                

Avantages de cette Structure

✅ Fichiers légers - Chaque comdem.html ne contient que son chapitre
✅ Chargement rapide - Pas de fichier lourd à parser
✅ Script simple - Aucune détection complexe
✅ Structure claire - Organisation logique par chapitre
✅ Maintenance facile - Modification isolée par chapitre
✅ Pas de détection - Le chemin relatif fait tout !

⚙️ Spécifications Techniques

Technologies Utilisées

Frontend

HTML5 - Structure sémantique
CSS3 - Styles avancés, animations, responsive
JavaScript ES6+ - Logique interactive
MathJax - Rendu des formules mathématiques
Three.js - Visualisation 3D (carte des connaissances)

Stockage

localStorage - Sauvegarde locale de la progression
JSON - Format de données structurées

Architecture

basic.css - Styles centralisés (incluant COMDEM)
panellateral.js - Scripts centralisés (incluant COMDEM)
Fichiers locaux comdem.html - Contenu spécifique par chapitre

Templates de Code

Code 55 - Template Exercices Standards

Correction progressive en 3 niveaux
Système d'indices
Support MathJax
Animations CSS élégantes

Code 22 - Template Puissances/Calculs

Spécialisé pour calculs avec puissances
Propriétés et simplifications
Validation automatique

Système de Tracking

// localStorage - Structure des données
{
    "mathpath_user": {
        "userId": "unique_id",
        "name": "Nom de l'élève",
        "level": 5,
        "xp": 1250,
        "badges": ["fraction_master", "speed_demon"],
        
        "fractions": {
            "progress": 75,
            "exercises_completed": 45,
            "last_visit": "2024-12-24",
            "mastery_levels": {
                "addition": 90,
                "soustraction": 85,
                "multiplication": 70,
                "division": 65
            }
        },
        
        "decimaux": { /* ... */ },
        "divisibilite": { /* ... */ }
    }
}
                

Support RTL (Arabe)

Attribut dir="rtl" pour contenu arabe
CSS adapté pour alignement RTL
Support bilingue Arabe/Français

✅ Checklist de Contrôle MathPath

9 Composantes Principales

1. Diagnostic intelligent
2. Carte 3D
3. Ulysse (avatar IA)
4. Vidéos d'erreurs
5. Missions quotidiennes
6. Gamification
7. Suivi progression
8. COMDEM (aide progressive)
9. Collaboration inter-écoles

3 Chapitres de 7ème année

Fractions • Nombres Décimaux • Divisibilité

Structure COMDEM Locale

Chaque chapitre → ./comdem/comdem.html
Script charge BÊTEMENT le fichier relatif
PAS de détection complexe

Fichiers Centralisés

basic.css (styles COMDEM inclus)
panellateral.js (script COMDEM inclus)

Contraintes Pédagogiques

❌ Pas de vecteurs
❌ Pas de Pythagore avant 9ème
❌ Pas de trigonométrie avant 9ème
✅ Méthodes du programme tunisien uniquement

Templates de Code

Code 55 (exercices standards)
Code 22 (puissances/calculs)

Support Technique

MathJax pour formules
localStorage pour tracking
Three.js pour 3D
Support RTL (Arabe)

🚀 Roadmap et Implémentation

Phase 1 : Fondations (En cours) ✅

✅ Structure des fichiers comdem.html par chapitre
✅ Intégration CSS/JS dans basic.css et panellateral.js
✅ Templates Code 55 et Code 22
✅ Système de tracking localStorage
🔄 Finalisation système COMDEM (en cours)

Phase 2 : Diagnostic et Carte 3D

Développement du système de diagnostic
Création de la carte 3D interactive (Three.js)
Intégration Ulysse (avatar IA)
Première version des missions quotidiennes

Phase 3 : Gamification Complète

Système de points et niveaux
Badges et récompenses
Défis Boss
Classements inter-classes

Phase 4 : Vidéos et Collaboration

Bibliothèque de vidéos d'erreurs
Système de collaboration inter-écoles
Forums modérés
Tutorat entre pairs

📝 Notes Importantes

🎯 Pour Claude (Assistant IA)

Toujours consulter ce document avant de répondre sur MathPath !

Vérifier les 9 composantes
Confirmer les 3 chapitres (pas plus !)
Respecter la structure COMDEM locale
Ne jamais oublier Ulysse et les vidéos d'erreurs
Maintenir les contraintes pédagogiques

Philosophie du Projet

MathPath AI n'est pas qu'un simple site d'exercices. C'est un compagnon d'apprentissage intelligent qui s'adapte à chaque élève, le motive par le jeu, visualise sa progression en 3D, et le guide avec bienveillance via Ulysse tout en respectant scrupuleusement les standards pédagogiques tunisiens.

Approche Progressive

Faouzi privilégie une implémentation progressive : on commence par les fondations solides (COMDEM, tracking, templates) avant d'ajouter les fonctionnalités avancées (3D, IA, vidéos). Cette approche garantit la stabilité et la qualité à chaque étape.