7amza7amrouni/study-tunisia-ai

Plateforme éducative tunisienne complète avec IA # 📚 Study Tunisia AI - Plateforme Éducative Tunisienne Premium ## 🎯 Description **Study Tunisia AI** est une plateforme éducative web et mobile complète destinée aux élèves du collège, lycée et baccalauréat tunisien. L'application offre une expérience d'apprentissage personnalisée, fluide et moderne avec intelligence artificielle intégrée. ### ✨ Caractéristiques Principales - 📖 Bibliothèque complète de cours tunisiens (tous niveaux et sections) - 🤖 Assistant IA éducatif intelligent (ChatGPT intégré) - 📸 Scanner IA pour correction d'exercices (OCR + IA) - 📊 Calculateur de moyenne avancé - 🎮 Système de gamification (XP, Badges, Niveaux) - 📅 Planning d'étude avec technique Pomodoro - 👥 Communauté d'apprentissage par matière - 💎 Abonnement Premium - 📱 100% Responsive Mobile - 🌍 Support FR/AR ## 🚀 Démarrage Rapide ### Prérequis - Node.js 18+ - MongoDB Atlas (gratuit) - Clé API OpenAI - Docker (optionnel) ### Installation avec Docker (Recommandé) ```bash # Cloner le repository git clone github.com cd study-tunisia-ai # Copier le fichier .env cp .env.example .env # Éditer .env avec vos clés API nano .env # Démarrer avec Docker docker-compose up -d # Frontend: localhost # Backend API: localhost # MongoDB: localhost:27017 ``` ### Installation Manuelle #### Backend ```bash cd backend npm install cp .env.example .env npm run dev # Écoute sur localhost ``` #### Frontend ```bash cd frontend npm install npm start # Ouvre localhost ``` ## 📁 Structure du Projet ``` study-tunisia-ai/ ├── frontend/ # React + TypeScript │ ├── src/ │ │ ├── components/ │ │ │ ├── Header.tsx │ │ │ ├── Sidebar.tsx │ │ │ ├── CourseCard.tsx │ │ │ ├── ExerciseViewer.tsx │ │ │ ├── AIAssistant.tsx │ │ │ └── ... │ │ ├── pages/ │ │ │ ├── Dashboard.tsx │ │ │ ├── Courses.tsx │ │ │ ├── Exercises.tsx │ │ │ ├ …