Détails techniques (utilisateurs avancés seulement)

Cette section contient une documentation technique détaillée de l'architecture de MathQuest, destinée aux développeurs, administrateurs système et utilisateurs avancés souhaitant comprendre en profondeur le fonctionnement de l'application.

Vue d'ensemble

MathQuest est une application web moderne construite avec une architecture full-stack comprenant :

• Frontend : Next.js avec React et TypeScript
• Backend : Node.js avec Express, Socket.IO et Prisma
• Base de données : PostgreSQL
• Cache/Stockage : Redis
• Documentation : VuePress (cette documentation)

Sections disponibles

• Architecture générale - Vue d'ensemble de l'architecture technique
• Base de données - Schéma de la base de données et modèles
• Système de scoring - Logique de calcul des scores et pénalités
• Services backend - Services et gestion des événements quiz
• API REST - Documentation complète des endpoints REST
• Configuration - Variables d'environnement et fichiers de configuration
• Tests et qualité - Stratégie de test et qualité du code
• Déploiement et DevOps - Déploiement, monitoring et scaling
• Moodle et LTI 1.3 - Configuration Moodle, provider LTI Kutsum et diagnostics
• Multi-tenant - Ajout d'un tenant, validation locale et garde-fous avant production
• Types de questions et flux de correction - Validation, événements socket et rendu du feedback par type de question

Avertissement

Cette documentation technique est destinée aux utilisateurs expérimentés. Elle contient des détails d'implémentation qui peuvent changer avec les mises à jour. Pour une utilisation normale de l'application, consultez la documentation utilisateur.

Contribuer

Si vous êtes développeur et souhaitez contribuer au code de Kutsum, cette documentation vous aidera à comprendre l'architecture. Le code source est disponible sur GitLab.