1.1 Qu'est-ce qu'AGTM Digital Academy ?

AGTM Digital Academy est une plateforme numérique tout-en-un de gestion pédagogique et administrative pour l'académie AGTM. Elle permet de gérer en temps réel les étudiants, les finances, les séances de cours, les ressources humaines, les documents officiels et la communication externe — le tout depuis un seul tableau de bord sécurisé, accessible depuis n'importe quel navigateur web.

1.2 Rôles et niveaux d'accès

Rôle	Accès	Fonctions clés
Admin	Accès complet à tous les modules	Gestion globale : étudiants, finances, RH, paramètres, marketing, espace client
Formateur	Accès aux modules pédagogiques	Planning, feuilles de séance, présences, rapports, tests, progression étudiants
Étudiant	Accès à son espace personnel	Ses notes, quiz, devoirs, activités pédagogiques, évaluation de séances
Secrétaire	Accès administratif partiel	Gestion des inscriptions, étudiants, classes, emplois du temps, messagerie
Investisseur	Accès lecture seule aux rapports	Tableau de bord financier, statistiques académie, rapports de performance
Public (sans connexion)	Pages publiques via lien partagé	Pointage, satisfaction, test de placement, marketing, espace client

1.3 Connexion à la plateforme

1. Ouvrez votre navigateur et allez sur la page de connexion (index.html)
2. Saisissez votre adresse email et votre mot de passe
3. Cliquez sur "Se connecter" — le tableau de bord s'ouvre automatiquement selon votre rôle
4. Si vous avez oublié votre mot de passe, contactez l'administrateur (ISSA BAMBA)

1.4 Navigation

La plateforme est organisée autour d'un menu latéral gauche (sidebar) et d'une zone de contenu principale à droite.

• Sidebar : liste les modules accessibles selon votre rôle. Cliquez sur un module pour l'ouvrir.
• Titre de page : indique la section active en haut de l'écran.
• Bouton Retour (←) : apparaît après navigation, permet de revenir à la page précédente.
• Historique de navigation : la plateforme mémorise vos 10 derniers écrans dans la session.
• Notifications toast : des messages de confirmation (vert) ou d'erreur (rouge) s'affichent en bas à droite lors de chaque action.

1.5 Barre de recherche globale 🔍 NOUVEAU

Une barre de recherche est intégrée dans la barre supérieure du tableau de bord, à droite du titre de page. Elle permet de naviguer rapidement entre les onglets sans parcourir le menu latéral.

Comment l'utiliser

1. Cliquez dans le champ "Rechercher un onglet, une section…" dans le bandeau supérieur
2. Tapez le nom de la section souhaitée (ex : "Notes", "Planning", "Finance", "Messages"…)
3. Une liste déroulante affiche les correspondances en temps réel
4. Cliquez sur l'entrée voulue — la navigation s'effectue immédiatement
5. Appuyez sur Echap ou cliquez ailleurs pour fermer sans naviguer

1.6 Déconnexion

Cliquez sur le bouton "Déconnexion" en bas de la sidebar. Vous êtes automatiquement redirigé vers la page de connexion. Votre session est sécurisée par Supabase Auth.

2.1 Vue d'ensemble (Dashboard Admin)

La page d'accueil admin présente un tableau de bord en temps réel avec :

• KPIs principaux : nombre d'étudiants actifs, chiffre d'affaires du mois en cours, inscriptions web en attente, nombre de formateurs actifs, séances de la semaine, dépenses du mois
• Graphique financier : évolution encaissements vs dépenses sur 6 mois
• Dernières séances : les 5 séances les plus récentes avec statut
• Alertes : paiements en retard, inscriptions web non traitées
• Assistant IA intégré : chatbot en bas de page pour poser des questions sur les données (navigation, statistiques, aide à la décision)

2.2 Inscription complète d'un étudiant — Étapes à suivre

Admin — Processus complet depuis la première prise de contact jusqu'à l'accès à la plateforme.

📋 Parcours A — Inscription directe (admin)

1. Aller dans Étudiants → "+ Nouvel Étudiant"
   Saisissez : prénom, nom, email, téléphone, niveau CECRL (A1 → C2), formation(s), mode de cours (Présentiel / En ligne / Hybride)
2. Renseigner le plan financier
   Montant total de la formation, plan de paiement (en 1 fois, 2 tranches, mensuel…)
3. Enregistrer le dossier
   Cliquez "Enregistrer" — un numéro de dossier unique (ex : DOS-0042) est généré automatiquement
4. Inscrire à une classe
   Ouvrez le dossier étudiant → section Classes → sélectionnez la classe adaptée au niveau → cliquez "Inscrire"
5. Configurer l'échéancier
   Allez dans Finance → Échéancier → créez les échéances de paiement pour cet étudiant avec dates et montants
6. Créer le compte d'accès à la plateforme
   Allez dans Paramètres → Utilisateurs → "+ Créer"
   Choisissez le mode :
     • Accès immédiat : compte actif sans email — partagez email + mot de passe directement à l'étudiant
     • Avec confirmation email : Supabase envoie un lien — l'étudiant confirme avant de se connecter
7. Communiquer les accès
   Envoyez à l'étudiant via WhatsApp : son email, son mot de passe temporaire, l'URL de connexion (index.html), et le lien de pointage de sa prochaine séance
8. Générer les documents contractuels
   Dans le dossier étudiant : 📋 Fiche d'engagement (à signer), 📅 Emploi du temps (à remettre), 📁 Dossier complet

🌐 Parcours B — Inscription via formulaire public

1. Le prospect remplit le formulaire public (?inscription=1 ou lien Marketing)
2. La demande apparaît dans Inscriptions Web avec statut "Nouveau"
3. Cliquez "✅ Valider" — un dossier étudiant est créé automatiquement
4. Reprenez depuis l'étape 4 du Parcours A (inscription classe, échéancier, compte accès)

2.3 Module Étudiants

Admin

Consulter la liste des étudiants

Le tableau liste tous les étudiants avec : numéro de dossier, nom, prénom, niveau, statut (Actif / Inactif / Suspendu), formations inscrites, mode de cours et solde financier.

• Barre de recherche : filtrez par nom, prénom, numéro de dossier ou email
• Filtre par statut : Tous / Actif / Inactif / Suspendu
• Tri par colonne : cliquez sur l'en-tête pour trier

Modifier / Supprimer un étudiant

• Cliquez sur ✏️ Modifier à droite de la ligne pour éditer les informations
• Cliquez sur 🗑️ Supprimer pour supprimer (confirmation demandée)
• Cliquez sur 📁 Dossier pour accéder au dossier complet de l'étudiant

Dossier étudiant (fiche complète)

Le dossier complet contient :

• Informations personnelles et pédagogiques
• Plan de paiement et historique des versements
• Présences et taux d'assiduité
• Évaluations et notes
• Classes inscrites
• Boutons de génération PDF : Fiche d'engagement, Emploi du temps personnalisé, Dossier complet, Certificat de formation

2.5 Inscriptions Web

Admin — Gestion des demandes d'inscription reçues via le formulaire public.

Action	Description
Voir la demande	Cliquez sur une ligne pour voir tous les détails du prospect
✅ Valider	Convertit la demande en étudiant actif + crée la fiche dans la base
❌ Refuser	Marque la demande comme refusée
🗑️ Supprimer	Supprime définitivement la demande

2.6 Gestion des Classes

Admin

• Créer une classe : nom, niveau, horaire récurrent, formateur assigné, nombre max d'élèves
• Modifier une classe : cliquez sur ✏️ — tous les champs sont éditables
• Supprimer une classe : cliquez sur 🗑️ (supprime aussi les inscriptions liées)
• Inscrire des étudiants : via le dossier étudiant → Classes

2.7 Synchronisation Programmes ↔ Séances ↔ EDT NOUVEAU

Le programme d'une classe est automatiquement synchronisé avec les séances planifiées. Toute modification d'une séance (date, sujet, statut) met à jour le programme de la classe en temps réel.

• ✅ Séance marquée "Réalisée" → le programme affiche ✅ devant la séance correspondante
• ❌ Séance annulée → le programme affiche ❌
• 📅 Séance planifiée → le programme affiche 📅 avec la date et l'heure
• Les emplois du temps affichés dans l'espace étudiant reflètent automatiquement ces mises à jour

3.1 Vue d'ensemble financière

Résumé complet du mois en cours :

• Total encaissé vs total dépensé
• Solde de caisse disponible
• Nombre de paiements reçus ce mois
• Impayés en cours (étudiants avec solde négatif)
• Graphique d'évolution mensuelle sur 6 mois

3.2 Encaissements

Enregistre tous les paiements reçus des étudiants.

Ajouter un paiement

1. Sélectionnez l'étudiant dans le menu déroulant
2. Saisissez le montant, le mode de paiement (Cash / Virement / Orange Money / Wave), la date et une note facultative
3. Cliquez "Enregistrer le paiement"
4. Le solde de l'étudiant est mis à jour automatiquement

3.3 Dépenses

Enregistre toutes les sorties d'argent de l'académie.

• Catégories : Loyer, Salaires, Fournitures, Communication, Maintenance, Autre…
• Justificatif : référence de facture ou pièce jointe
• Synchronisation RH : les fiches de paie générées dans RH créent automatiquement une dépense de type "Salaires" — statut [En attente] puis Payé une fois validée

3.4 Journal de Caisse

Historique chronologique de toutes les opérations (entrées et sorties). Filtrable par période. Affiche le solde cumulatif jour par jour.

3.5 Échéancier

Planification des paiements à recevoir par étudiant :

• Crée un plan de paiement en N tranches pour un étudiant
• Suit les échéances avec statut (En attente / Payé / En retard)
• Génère des alertes pour les impayés
• Marquer une échéance comme payée la convertit en encaissement

3.6 Factures Proforma

Création de devis / factures proforma professionnelles :

1. Renseignez le client (nom, contact), les lignes de service (intitulé, quantité, prix unitaire)
2. La TVA et le total sont calculés automatiquement
3. Cliquez "Générer PDF" pour obtenir une facture imprimable au format AGTM
4. Sauvegardez la facture dans la base pour suivi ultérieur

3.7 Finances Personnelles Admin uniquement

Section privée réservée à l'administrateur uniquement (ISSA BAMBA). Non visible des autres rôles.

• Suivi des revenus et dépenses personnels (distincts de la finance de l'académie)
• Protégé par politique RLS Supabase : seul l'admin peut lire ou écrire ces données

3.8 Rapport PDF Financier

Génère un rapport complet au format PDF comprenant :

• Bilan du mois sélectionné (encaissements, dépenses, solde net)
• Détail par catégorie de dépenses
• Liste des impayés
• Graphiques intégrés

4.1 Feuille de Séance (Création)

La feuille de séance est le document central qui déclenche l'ensemble du suivi : présences, pointage en ligne, rapports.

Créer une feuille de séance

1. Allez dans Suivi Pédagogique → Feuille de Séance
2. Remplissez : date, plage horaire (ex : 17h–19h), sujet / thème du cours, classe, formateur, format (Présentiel / En ligne / Hybride), programme, module, objectifs
3. Si le cours est en ligne : renseignez le lien Google Meet
4. Chargez les étudiants de la classe via "Charger la classe" ou ajoutez-les manuellement par numéro de dossier
5. Cochez la présence de chaque étudiant (Présent / Absent / Retard)
6. Cliquez "💾 Créer la Séance & Enregistrer"

Après enregistrement, un bloc vert apparaît avec :

• Le lien de pointage partageable (à copier/envoyer aux étudiants via WhatsApp)
• Le bouton "📋 Pointer cette séance maintenant" pour ouvrir le formulaire inline

Imprimer la feuille

1. Cliquez sur "🖨️ Imprimer la feuille" avant ou après l'enregistrement
2. Une fenêtre d'impression s'ouvre avec la feuille officielle AGTM
3. Si la séance est déjà enregistrée, le lien de pointage apparaît dans l'entête de la feuille imprimée

4.2 Séances Planifiées

Vue tableau de toutes les séances enregistrées dans le système :

• Filtres par statut : Planifiée / Réalisée / Annulée
• Pour chaque séance Planifiée :
  • 🔗 Lien : copie le lien de pointage public dans le presse-papiers
  • ✅ : marque la séance comme "Réalisée"
  • 🗑️ : supprime la séance

4.3 Présences

Consulter et modifier le registre des présences :

• Filtrez par séance, étudiant, période ou classe
• Modifiez le statut directement dans le tableau (Présent ✅ / Absent ❌)
• Exportez le rapport d'assiduité global

4.4 Évaluations

Enregistrement des notes et évaluations des étudiants :

1. Choisissez l'étudiant, le type d'évaluation (DS / Examen / Quiz / Devoir / Oral)
2. Saisissez la note obtenue et la note maximale
3. Ajoutez un commentaire pédagogique (facultatif)
4. Cliquez "Enregistrer"

4.5 Satisfactions Apprenants

Collecte et analyse des retours de satisfaction des étudiants.

Liens de satisfaction (à partager)

En haut de la section Satisfactions, un bloc vert affiche des boutons de copie de lien pour chaque séance récente. Cliquez sur un bouton pour copier le lien dans le presse-papiers et l'envoyer aux étudiants via WhatsApp ou email.

Le lien fonctionne sans connexion — l'étudiant clique, choisit sa note (1 à 5 étoiles) et laisse un commentaire.

Soumettre manuellement

L'admin peut aussi saisir une évaluation directement : séance, apprenant, note, commentaire → "💾 Soumettre".

Historique

Tableau de toutes les évaluations reçues avec : note en étoiles, commentaire, date. KPIs : note moyenne, nombre d'évaluations, notes parfaites 5/5.

4.6 Rapports de Coaching

Compte-rendus hebdomadaires par étudiant rédigés par les formateurs. Accessibles en lecture par l'admin. Filtrage par étudiant et par période.

5.1 Vue d'ensemble RH

Tableau de bord RH avec :

• Effectif total, formateurs actifs, masse salariale mensuelle
• Répartition par poste (graphique)
• Congés en attente de validation
• Total des fiches de paie du mois en cours

5.2 Personnel

Registre complet de tout le personnel de l'académie.

Ajouter un membre du personnel

1. Cliquez "+ Ajouter un membre"
2. Remplissez : nom, prénom, poste (Formateur / Secrétaire / Direction / Technicien…), type de contrat (CDI / CDD / Freelance / Stage), salaire de base, date d'embauche, téléphone, email, numéro CIN / matricule
3. Cliquez "Enregistrer"

• ✏️ Modifier : édite les informations du membre
• 🗑️ Supprimer : supprime le profil
• 📄 Contrat : génère le contrat formateur en PDF (voir section 11)

5.3 Apprenants RH

Vue synthétique des apprenants depuis la perspective RH (taux de présence global, formateur assigné).

5.4 Fiches de Paie

Génération et suivi des fiches de paie mensuelles.

Générer une fiche de paie

1. Sélectionnez le membre du personnel
2. Choisissez la période (mois/année)
3. La plateforme pré-remplit le salaire de base ; ajustez les primes, heures sup., retenues et avances si nécessaire
4. Cliquez "Générer la Fiche de Paie"
5. Une entrée Dépense — Salaires [En attente] est automatiquement créée en Finance
6. Une fois le paiement effectué, cliquez "✅ Marquer Payé" — la dépense est mise à jour

5.5 Congés

• Soumission d'une demande de congé : membre, dates, motif
• Validation ou refus par l'admin
• Compteur de jours de congé utilisés par membre

5.6 Recrutement

Suivi des candidatures reçues via le formulaire public de candidature formateur :

• Liste des candidatures avec CV et informations
• Statuts : Nouveau / En cours / Accepté / Refusé
• Conversion directe en membre du personnel si accepté

6.1 Catalogue de Cours

Bibliothèque numérique de tous les contenus pédagogiques de l'académie.

• Barre de recherche : tapez un mot-clé pour filtrer les cours par titre ou contenu
• Filtres : par niveau (A1–C2), pilier (Grammaire / Vocabulaire / Compréhension / Expression / TOEIC…)
• Ouvrir un cours : cliquez pour accéder au contenu complet avec exercices
• Ajouter un cours (admin/formateur) : titre, pilier, niveau, contenu HTML, exercices

6.2 Tests & Évaluations

Création et gestion des tests en ligne.

Créer un test (Admin / Formateur)

1. Cliquez "+ Créer un test"
2. Renseignez : titre, niveau, type (QCM / Rédaction / Oral)
3. Ajoutez les questions : énoncé, options de réponse, réponse correcte, explication
4. Sauvegardez — le test reçoit un lien partageable (?test_id=xxx)
5. Partagez le lien aux étudiants via WhatsApp

Passer un test (Étudiant)

L'étudiant clique sur le lien, répond aux questions, valide. Le résultat s'affiche immédiatement avec le score et les corrections.

6.3 Évaluations en ligne

Fiches d'évaluation avec notation directe par le formateur ou via lien partageable (?eval_id=xxx). Résultats synchronisés dans le dossier étudiant.

• Recherche : filtrez les évaluations par nom d'étudiant ou titre
• 🔗 Lien : copie le lien direct vers l'évaluation

6.4 Test de Placement

Test de niveau gratuit accessible sans connexion (?placement=1). Utilisé pour évaluer le niveau d'un nouveau prospect.

• Couvre toutes les compétences : grammaire, vocabulaire, compréhension
• Résultat automatique avec niveau CECRL recommandé (A1 à C2)
• Idéal à partager via WhatsApp ou email lors des séances découvertes

7.1 Onglet Présentation

Page vitrine complète de l'académie :

• Bannière hero avec chiffres clés (500+ apprenants, 95% satisfaction, 8+ formateurs…)
• Carte "Pourquoi choisir AGTM ?" avec arguments différenciants
• Bouton "Séance découverte gratuite" lié au Google Meet officiel
• Bouton "Découvrir nos formations" qui navigue vers l'onglet Formations

7.2 Onglet Nos Formations

Catalogue complet des offres de formation avec pour chaque programme :

• Icône, titre, niveaux couverts, durée estimée, fourchette de prix
• Description détaillée et objectifs pédagogiques
• Bouton "Demander un devis" / "S'inscrire"

Formations disponibles : Anglais Général, Business English, Préparation TOEIC, TOEFL, Anglais pour enfants, Formation en entreprise.

7.3 Onglet Brochures PDF

Génération à la demande de documents marketing imprimables :

• Plaquette Générale : présentation complète de l'académie
• Tarifs détaillés : grille complète des forfaits
• Brochure TOEIC/TOEFL : programme de préparation aux certifications

7.4 Onglet Supports de Communication

Outils de communication digitale prêts à l'emploi :

• Images sociales : visuels optimisés pour Facebook, Instagram, WhatsApp
• Export PNG : téléchargez les visuels directement (via html2canvas)
• Messages WhatsApp : modèles de messages prêts à copier (prospection, rappel de séance)

7.5 Onglet Liens & Contacts

Centrale de tous les liens publics de la plateforme :

Lien	Usage
?marketing=1	Espace marketing public (sans connexion) — à partager aux prospects
?client=1	Formulaire de prise de contact public
?placement=1	Test de placement gratuit
?pointage=ID	Formulaire de présence d'une séance spécifique
?satisfaction=ID	Formulaire d'évaluation d'une séance
?eval_id=ID	Évaluation en ligne spécifique
?test_id=ID	Test d'entraînement spécifique

Pour chaque lien : un champ texte affiche l'URL complète, un bouton 📋 la copie, et un bouton ↗ l'ouvre dans un nouvel onglet.

7.6 Onglet Contenu & Tarifs NOUVEAU

Cet onglet permet de gérer tout le contenu marketing en ligne, sans toucher au code ni à la base de données. Les modifications sont appliquées immédiatement sur toutes les pages.

Sections éditables

Section	Champs éditables
📅 Inscriptions & Dates	Statut (ouvertes/fermées) · Texte de la période · Date de rentrée · Numéro de contact · Offre spéciale
💬 Messages Marketing	Slogan principal · Texte d'appel à l'action
📊 Statistiques	Nombre d'apprenants · Taux de satisfaction · Nombre de formateurs
💰 Tarifs des formations	Prix de départ · Prix Anglais Général · Business English · TOEIC · TOEFL · BAC/BEPC · Kids & Teens · Tiers IA

1. Accédez à Espace Marketing → ⚙️ Contenu & Tarifs
2. Modifiez les champs souhaités dans les sections correspondantes
3. Cliquez sur "💾 Enregistrer tout" pour appliquer les changements
4. Les nouvelles valeurs s'affichent immédiatement sur la page de présentation et dans les brochures

8.1 Formulaire public (prospect / client)

Accessible sans connexion via dashboard.html?client=1.

Le prospect remplit :

• Prénom et nom
• Téléphone / WhatsApp (obligatoire)
• Email (facultatif)
• Sujet : Inscription / Tarifs / Séance découverte / Test de niveau / Cours particuliers / Formation entreprise / Autre
• Message détaillé

Après validation, la demande est enregistrée dans Supabase et apparaît immédiatement dans la vue admin.

8.2 Vue Admin — Gestion des demandes

Accès via la sidebar Admin → 📞 Espace Client.

• KPIs : total des demandes, en attente, traitées
• Lien public affiché avec bouton de copie rapide
• Tableau de toutes les demandes : date, nom, téléphone, sujet, statut, message
• Bouton "✅ Traité" : marque la demande comme traitée (fond vert)
• Bouton "↩ Rouvrir" : revient au statut Nouveau si besoin

9.1 Planning

Page d'accueil du formateur après connexion. En haut de la page s'affiche une carte d'identité professionnelle avec :

• Nom complet du formateur
• Poste occupé (Formateur / Enseignant)
• Numéro CIN / matricule 🪪 CI-XXXX (affiché aussi dans la sidebar sous le nom)

En dessous, la vue du planning :

• Séances passées, en cours et à venir
• Cliquez sur une séance pour voir les détails (classe, étudiants, lien Meet…)
• Indicateur de statut : Planifiée 🔵 / Réalisée 🟢 / Annulée 🔴

9.2 Mes Classes

Liste des classes assignées au formateur avec pour chaque classe :

• Nom, niveau, horaire récurrent, liste des étudiants inscrits
• Bouton pour voir la progression de chaque étudiant
• Bouton pour créer une séance directement depuis la classe

9.3 Séances

Création et gestion des séances (identique à l'admin — voir section 4.1 et 4.2).

9.4 Présences

Registre personnel des présences du formateur. Filtrage par séance. Modification possible des statuts (Présent / Absent).

9.5 Progression Étudiants

Vue de l'évolution pédagogique de chaque étudiant du formateur :

• Courbe de progression des notes dans le temps
• Taux d'assiduité individuel
• Tableau des dernières évaluations
• Recommandations pédagogiques automatiques selon les performances

9.6 Rapport de Séance

Formulaire de compte-rendu hebdomadaire à remplir après chaque cours :

1. Sélectionnez la séance concernée
2. Rédigez : objectifs atteints, difficultés observées, exercices réalisés, devoirs assignés, observations par étudiant
3. Cliquez "Enregistrer le rapport"

Les rapports sont consultables par l'admin dans Suivi Pédagogique → Rapports de coaching.

9.7 Historique Rapports

Archive de tous les rapports de séance du formateur, filtrable par période et par classe.

9.8 Tests & Évaluations

Le formateur peut créer, modifier et partager des tests (voir section 6.2). Il peut aussi consulter les résultats de ses étudiants et corriger les exercices de rédaction.

10.1 Mon Espace 🏠 (Tableau de bord personnel)

Page d'accueil personnalisée de l'étudiant :

• Message de bienvenue avec prénom, niveau, numéro de dossier 📁 DOS-XXX et statut
• KPIs personnels : nombre de présences, absences, moyenne générale
• Dernières évaluations (5 les plus récentes) avec note, type et pourcentage

10.2 Mes Séances & Cours 📅 NOUVEAU

Vue personnalisée de toutes les séances de l'étudiant :

• Liste des séances passées et à venir avec date, heure, sujet et statut de présence
• 🔗 Lien de pointage : bouton pour pointer directement depuis son espace (sans lien externe)
• 📹 Rejoindre le Meet : après avoir pointé sa présence, l'étudiant est automatiquement redirigé vers le cours Google Meet en 3 secondes
• Affichage du programme de la classe avec l'avancement séance par séance

10.3 Emploi du Temps 📆 NOUVEAU

Emploi du temps hebdomadaire personnel synchronisé avec les séances planifiées :

• Vue semaine : affiche les séances de la semaine courante avec date, heure, sujet, statut (Planifiée / Réalisée / Annulée)
• Navigation : boutons ← Semaine précédente / Semaine suivante → pour consulter les semaines passées et à venir
• Statut de présence : pour les séances passées, indique si l'étudiant était Présent ✅ ou Absent ❌
• Bouton Pointer : pour les séances en cours ou à venir, permet de pointer directement depuis l'EDT
• Programme de classe : liste chronologique de toutes les séances du programme ci-dessous le calendrier

10.4 Ressources & Documents 📚 NOUVEAU

Espace centralisé pour accéder aux contenus pédagogiques transmis par l'administration et les formateurs :

• Cours et fiches de niveau filtrés selon le niveau de l'étudiant
• Supports de cours, PDF et exercices mis à disposition
• Accès au catalogue complet des activités pédagogiques
• Tests et évaluations disponibles en ligne

10.5 Messages 💬 NOUVEAU

Système de messagerie bidirectionnelle entre l'étudiant, son formateur et l'administration :

Messages reçus (Reçus)

Affiche tous les messages envoyés à l'étudiant par l'admin ou le formateur. Chaque message contient : expéditeur, date, objet et contenu complet.

Messages envoyés (Envoyés)

Historique de tous les messages que l'étudiant a envoyés à l'administration ou au formateur.

Envoyer un message

1. Cliquez sur "✏️ Nouveau message" dans la section Messages
2. Un formulaire s'affiche — saisissez l'objet et le contenu du message
3. Cliquez "📨 Envoyer"
4. Le message est immédiatement enregistré et visible par l'admin et le formateur dans leur interface

10.6 Mes Notes & Bulletin 📈

Tableau de bord complet des évaluations synchronisé en temps réel avec la base de données :

Résumé du bulletin

• Moyenne générale /20 avec mention (Excellent / Bien / Assez bien / Passable / Insuffisant)
• Taux de présence % calculé depuis les séances réalisées
• Total des évaluations enregistrées
• Devoirs rendus

Détail des évaluations

• Date, type (DS / Examen / Quiz / Devoir / Oral)
• Note avec barre de progression colorée : vert ≥ 70% / orange ≥ 50% / rouge < 50%
• Commentaire du formateur, appréciation pédagogique
• Résultats des quiz et tests en ligne
• Devoirs soumis avec scores

10.7 Quiz Interactif 🧠

Série de 8 questions aléatoires issues de la banque de quiz AGTM :

• Questions à choix multiple avec 4 options
• Correction immédiate après chaque réponse avec explication
• Score final avec pourcentage et encouragements
• Bouton "Recommencer" pour une nouvelle série

10.8 Soumettre un Devoir 📤

1. Sélectionnez la matière / le thème
2. Collez votre texte ou rédigez directement dans le champ
3. Ajoutez une note (facultatif)
4. Cliquez "Soumettre le devoir"

Le formateur reçoit le devoir dans son espace et peut le corriger avec un commentaire et une note.

10.9 Activités Pédagogiques 📖

Accès au catalogue de cours, tests et évaluations en ligne (voir section 6 — contenu filtré selon le niveau de l'étudiant).

10.10 Évaluer mes Séances ⭐

1. Sélectionnez la séance dans la liste déroulante (séances réalisées)
2. Cliquez sur les étoiles pour choisir votre note (1 à 5)
3. Rédigez un commentaire (facultatif)
4. Cliquez "✅ Soumettre mon évaluation"

10.11 Nos Formations 🎯 NOUVEAU

Accès à l'espace marketing depuis l'espace étudiant : catalogue complet des formations AGTM (Anglais Général, Business English, TOEIC, TOEFL…) avec descriptions, durées et tarifs. Permet à un étudiant de s'informer sur d'autres niveaux ou de recommander l'académie à son entourage.

10.12 Service Client 📞 NOUVEAU

Accès direct au formulaire de contact de l'académie depuis l'espace étudiant. Permet à l'étudiant de soumettre rapidement une demande d'information, un signalement ou une question administrative à l'équipe AGTM.

11.1 Feuille de Présence (Séance)

Générée depuis Suivi Pédagogique → Feuille de Séance → 🖨️ Imprimer.

Contient : logo AGTM, date, plage horaire, sujet, classe, formateur, format du cours, liste des étudiants avec colonnes signature/présence, lien Google Meet (si en ligne), lien de pointage numérique (si séance déjà enregistrée), zones de signatures formateur et direction.

11.2 Emploi du Temps Personnalisé

Généré depuis le Dossier Étudiant → 📅 Emploi du temps.

Contient : informations de l'étudiant, planning des séances de la période, horaires, formateur, rappel des règles (préavis 5 heures, pointage obligatoire), zones de signatures.

11.3 Fiche d'Engagement Apprenant

Générée depuis le Dossier Étudiant → 📋 Fiche d'engagement.

Document contractuel signé par l'apprenant. Contient :

• Informations personnelles, forfait, durée
• Art. 1 — Pointage obligatoire avant chaque séance
• Art. 2 — Préavis de 5 heures en cas d'absence
• Art. 3 — Conditions de rattrapage des séances manquées
• Art. 4 — Rattrapage obligatoire si le formateur est absent
• Art. 5 — Volume horaire garanti (12 séances/période)
• Art. 6 — Comportement et respect du cadre pédagogique
• Zones de signatures

11.4 Contrat Formateur

Généré depuis RH → Personnel → 📄 Contrat pour chaque formateur.

Contient :

• Informations personnelles et professionnelles du formateur
• Art. 1 — Ponctualité : préavis de 5 heures en cas d'empêchement
• Art. 2 — Pointage obligatoire via formulaire numérique
• Art. 3 — Rattrapage obligatoire dans les 7 jours calendaires
• Art. 4 — Volume horaire et charge pédagogique (12 séances garanties)
• Art. 5 — Qualité pédagogique et confidentialité
• Zones de signatures

11.5 Dossier Complet Apprenant

Généré depuis le Dossier Étudiant → 📁 Dossier complet. Compilation PDF en un seul document de :

• Fiche d'identité complète
• Plan de paiement et historique des versements
• Emploi du temps de la semaine en cours
• Rapport de progression hebdomadaire
• Résumé des présences et des notes

11.6 Bulletin de Paie

Généré depuis RH → Fiches de Paie → 🖨️ Imprimer. Document officiel avec : membre, période, salaire de base, primes, retenues, net à payer, signatures.

11.7 Rapport Financier PDF

Généré depuis Finance → Rapport PDF. Bilan mensuel complet avec graphiques, détail des encaissements et dépenses, impayés.

11.8 Certificat de Formation

Généré depuis le Dossier Étudiant quand la formation est complétée. Certificat officiel AGTM Digital Academy au format A4, signé par la direction.

12.1 Pointage de Séance + Redirection Meet MIS À JOUR

dashboard.html?pointage=ID_SÉANCE

Formulaire de présence numérique pour une séance spécifique. L'étudiant ou le formateur clique sur le lien, son nom est enregistré comme présent, la date et l'heure de pointage sont horodatées.

Nouveau : si un lien Google Meet est associé à la séance, l'étudiant est automatiquement redirigé vers le cours en ligne 3 secondes après avoir pointé. Un bouton "Rejoindre maintenant" est également proposé pour accéder immédiatement sans attendre.

Comment obtenir ce lien ?

1. Créez la séance dans Suivi Pédagogique → Feuille de Séance
2. Renseignez le lien Google Meet dans le champ prévu
3. Après enregistrement, un bloc vert apparaît avec le lien de pointage
4. Cliquez "📋 Copier" et envoyez le lien aux étudiants via WhatsApp
5. OU depuis Séances Planifiées → bouton "🔗 Lien" sur chaque ligne
6. OU depuis l'espace étudiant → Mes Séances ou Emploi du Temps → bouton "Pointer"

12.2 Évaluation de Satisfaction

dashboard.html?satisfaction=ID_SÉANCE

Formulaire d'évaluation de satisfaction pour une séance. L'utilisateur entre son prénom, choisit sa note (1 à 5 étoiles) et laisse un commentaire.

Comment obtenir ce lien ?

1. Allez dans Suivi Pédagogique → Satisfactions
2. Dans le bloc vert en haut, cliquez sur le bouton de la séance voulue (🔗 JJ/MM/AAAA — Sujet)
3. Le lien est copié — envoyez-le aux étudiants après chaque cours

12.3 Espace Marketing

dashboard.html?marketing=1

Page vitrine complète de l'académie (présentation, formations, tarifs, contacts). Idéale pour les prospects qui veulent s'informer avant de s'inscrire.

12.4 Espace Client (Formulaire de contact)

dashboard.html?client=1

Formulaire simple pour qu'un prospect envoie une demande d'information. La demande atterrit directement dans l'Espace Client de l'admin.

12.5 Test de Placement

dashboard.html?placement=1

Test de niveau gratuit couvrant toutes les compétences en anglais. Résultat instantané avec niveau CECRL recommandé. Parfait pour qualifier un prospect lors d'une séance découverte.

12.6 Évaluation en ligne partagée

dashboard.html?eval_id=ID

Fiche d'évaluation spécifique à un étudiant ou un groupe, partagée par le formateur.

12.7 Test d'Entraînement

dashboard.html?test_id=ID

Test de pratique spécifique créé dans Activités Pédagogiques. Résultat avec score et corrections détaillées.

---

Lien public	Créé depuis	Durée de validité
?pointage=	Feuille de séance (après save)	Durée de la séance
?satisfaction=	Satisfactions → boutons de copie	Illimité
?marketing=1	Liens & Contacts marketing	Illimité
?client=1	Liens & Contacts marketing / Espace Client	Illimité
?placement=1	Liens & Contacts marketing	Illimité
?eval_id=	Activités Pédagogiques → Évaluations	Illimité
?test_id=	Activités Pédagogiques → Tests	Illimité

13.1 Onglet Académie

Configuration générale de l'établissement :

• Nom de l'académie et slogan
• Ville, pays, adresse
• Email et téléphone de contact
• Lien Google Meet officiel pour les séances découvertes

13.2 Onglet Utilisateurs MIS À JOUR

Gestion des comptes d'accès à la plateforme. L'admin est le seul à pouvoir créer des comptes utilisateurs.

Créer un utilisateur — 2 modes disponibles

Mode	Fonctionnement	Quand l'utiliser
⚡ Accès immédiat (recommandé)	Le compte est actif immédiatement sans confirmation par email. L'admin partage directement email + mot de passe à l'utilisateur.	Pour les étudiants sans email professionnel, les formateurs qui commencent immédiatement, ou toute situation nécessitant un accès rapide.
📧 Avec confirmation email	Supabase envoie un lien de confirmation à l'email renseigné. L'utilisateur doit cliquer le lien avant de pouvoir se connecter.	Pour les utilisateurs avec email professionnel valide, ou quand la vérification d'identité par email est souhaitée.

Étapes de création

1. Dans Paramètres → Utilisateurs, cliquez "➕ Créer"
2. Choisissez le mode : Accès immédiat ou Avec confirmation email (sélecteur radio)
3. Renseignez : prénom, nom, email, rôle (Admin / Formateur / Secrétaire / Étudiant)
4. Définissez un mot de passe temporaire
5. Cliquez "➕ Créer" — le compte est créé et apparaît dans la liste
6. En mode Accès immédiat : communiquez l'email et le mot de passe à l'utilisateur via WhatsApp
7. En mode Email : l'utilisateur reçoit un lien de confirmation — il doit cliquer pour activer son compte

Gestion des comptes existants

• ✅ Activer / 🚫 Désactiver : un compte désactivé ne peut plus se connecter
• Changer le rôle : menu déroulant sur la ligne — prend effet à la prochaine connexion
• ✏️ Modifier : édite les informations du compte
• 🗑️ Supprimer : supprime définitivement (irréversible)

13.3 Onglet Rôles & Accès

Création de rôles personnalisés au-delà des 3 rôles standards :

• Créez un rôle "Secrétaire", "Directeur", "Assistant"…
• Définissez les modules accessibles pour chaque rôle personnalisé
• Assignez le rôle à un utilisateur depuis l'onglet Utilisateurs

13.4 Onglet Matrice d'Accès

Tableau croisé rôles × modules permettant de visualiser et modifier précisément quels rôles ont accès à quels modules. Cochez/décochez les cases pour personnaliser l'accès.

13.5 Onglet Sécurité

• Historique des connexions (IP, date, email)
• Forcer la déconnexion d'une session active
• Politique de mot de passe

13.6 Onglet Données

• Export CSV : exportez les étudiants, paiements, présences en format tableur
• Sauvegarde : génère un export JSON complet de la base
• Nettoyage : supprime les données archivées anciennes (avec confirmation)

13.7 Onglet Système

• Version de la plateforme
• Statut de la connexion Supabase (vert = connecté)
• Vider le cache local du navigateur
• Informations sur la base de données (tables, nombre de lignes)

Connexion & Accès

❓ Je ne peux pas me connecter

• Vérifiez votre email et mot de passe (le bouton "Voir" permet d'afficher les caractères)
• Vérifiez votre connexion internet
• Si le message est "Email ou mot de passe incorrect", contactez l'admin pour réinitialiser
• Si votre compte a été suspendu, un message spécifique s'affiche — contactez ISSA BAMBA

❓ Je vois "Rôle non défini" après connexion

Votre rôle n'a pas été configuré. L'admin doit aller dans Supabase → SQL Editor et exécuter :

❓ Le bouton de création d'utilisateur ne fonctionne pas (limite d'email)

Supabase (plan gratuit) limite à 3-4 emails d'invitation par heure. Solutions :

• Attendez 1 heure et réessayez
• OU désactivez la confirmation d'email : Supabase → Authentication → Email Auth → désactivez "Confirm email"

Pédagogie & Séances

❓ Le lien de pointage ne fonctionne pas

• Le lien doit être copié après avoir sauvegardé la séance (bouton "💾 Créer la Séance")
• Vérifiez que l'ID de séance dans le lien est bien un nombre entier
• Le pointage fonctionne sans connexion — l'étudiant n'a pas besoin de compte

❓ Une classe n'est pas modifiable

Depuis la migration v19, les politiques RLS Supabase ont été mises à jour. Si les modifications ne s'enregistrent pas, vérifiez que vous êtes bien connecté en tant qu'admin.

❓ Les présences ne s'enregistrent pas dans la feuille de séance

Assurez-vous que les étudiants sont bien dans la liste avant de cliquer "Créer". Si vous ajoutez des étudiants manuellement, vérifiez que leur numéro de dossier est correct.

Finance

❓ Les salaires n'apparaissent pas dans les dépenses Finance

La synchronisation est automatique : quand vous générez une fiche de paie dans RH → Fiches de Paie, une dépense "Salaires [En attente]" est créée. Si elle n'apparaît pas, vérifiez dans Finance → Dépenses et cherchez le libellé du formateur.

❓ Je ne vois pas l'onglet "Finances Perso"

Cet onglet est réservé à l'admin (Admin uniquement). Les formateurs et étudiants ne le voient pas. C'est normal et intentionnel.

Documents PDF

❓ Le PDF ne s'imprime pas / la fenêtre ne s'ouvre pas

• Vérifiez que votre navigateur ne bloque pas les popups — autorisez les popups pour ce site
• Sur Chrome : barre d'adresse → icône popup bloqué → "Toujours autoriser les popups"
• Sur Firefox : Outils → Options → Contenu → Exceptions popups

❓ Le lien de pointage n'apparaît pas sur la feuille imprimée

Le lien n'est disponible qu'après l'enregistrement de la séance. Imprimez en cliquant sur "🖨️ Imprimer" après avoir cliqué sur "💾 Créer la Séance".

Données & Base de données

❓ Les données ne se chargent pas (écran blanc ou "Chargement…")

• Vérifiez votre connexion internet
• Rechargez la page (F5)
• Vérifiez que le service Supabase n'est pas en maintenance (status.supabase.com)
• Déconnectez-vous et reconnectez-vous

Espace Étudiant

❓ Mon numéro de dossier n'apparaît pas dans la sidebar / Mon Espace

• Vérifiez que l'email de votre compte de connexion est identique à celui enregistré dans votre dossier étudiant
• Signalez à l'admin l'email exact de votre compte — il pourra corriger le dossier
• L'admin peut vérifier dans Étudiants → dossier → champ Email

❓ L'emploi du temps est vide ou ne correspond pas à mes séances

• Vérifiez que vous êtes bien inscrit à une classe dans votre dossier étudiant (admin → Dossier → Classes)
• Si les séances n'ont pas encore été planifiées par le formateur, l'emploi du temps sera vide
• Contactez l'admin pour vérifier l'inscription à la classe

❓ Je ne vois aucun message dans "Messages"

• La boîte est vide si l'admin ou le formateur n'a pas encore envoyé de message
• Vous pouvez envoyer le premier message vous-même via "✏️ Nouveau message"
• Les messages reçus (onglet "Reçus") et envoyés (onglet "Envoyés") sont séparés

❓ Après le pointage, je ne suis pas redirigé vers Google Meet

• La redirection n'a lieu que si un lien Google Meet est renseigné dans la séance
• Si le lien est absent, contactez votre formateur ou l'admin pour qu'il renseigne le lien Meet dans la feuille de séance
• Vous pouvez aussi accéder au Meet depuis Mes Séances → bouton "📹 Rejoindre"

❓ Mes notes ne s'affichent pas dans "Mes Notes & Bulletin"

• Les notes sont saisies par l'admin ou le formateur dans Suivi Pédagogique → Évaluations
• Vérifiez que votre email de connexion correspond exactement au dossier étudiant
• Si votre dossier n'est pas lié, un message d'explication s'affiche avec votre email — communiquez-le à l'admin

Navigation & Interface

❓ La barre de recherche ne trouve pas un onglet

• La recherche porte sur les onglets accessibles à votre rôle uniquement
• Essayez des mots-clés différents : "Notes" → "Bulletin" / "EDT" → "Emploi" / "Cours" → "Ressources"
• Les accents ne sont pas obligatoires dans la recherche

❓ L'espace Paramètres affiche une erreur ou est vide

• Paramètres est réservé aux Admin uniquement
• Si vous êtes admin et que la page reste blanche, un message d'erreur s'affiche avec le détail — cliquez "🔄 Réessayer"
• Vérifiez que votre connexion Supabase est active (onglet Système dans Paramètres)

---

15.1 Présentation

AGTM AI est l'assistante pédagogique intelligente intégrée à la plateforme AGTM Digital Academy. Elle est accessible depuis l'onglet 🤖 Assistant IA du tableau de bord, pour tous les rôles (étudiants, formateurs, secrétaire, direction, admin).

L'IA est propulsée par DeepSeek (moteur par défaut, économique) ou Claude d'Anthropic ou Groq au choix de l'utilisateur. Un sélecteur de fournisseur est accessible dans l'interface pour basculer manuellement entre les moteurs. L'assistant est adapté au contexte pédagogique de l'AGTM grâce à une base de connaissances interne (programme, FAQ, règles de grammaire, etc.).

15.2 Les 3 tiers d'abonnement IA

Tier	Modèle IA	Prix	Fonctionnalités incluses
🔵 Essentiel	Standard (Haiku)	Inclus dans toute inscription	Questions pédagogiques, aide à la grammaire, FAQ école, explications de cours
🟡 Recommandé	Avancé (Sonnet)	+2 000 FCFA/mois	Tout Essentiel + exercices personnalisés par niveau, préparation TOEIC/TOEFL, historique des échanges, corrections détaillées
🟣 Premium	Expert (Opus)	+4 000 FCFA/mois	Tout Recommandé + analyse avancée, simulations d'entretien en anglais, réponses plus longues et approfondies, support prioritaire 24h

15.3 Utilisation — Espace Étudiant

Accéder à l'Assistant IA

1. Connectez-vous à votre tableau de bord étudiant
2. Cliquez sur 🤖 Assistant IA dans le menu latéral
3. Votre tier actuel et le nombre de messages envoyés ce mois sont affichés en haut
4. Tapez votre question dans la zone de saisie et appuyez sur Entrée (ou cliquez ➤ Envoyer)

Exemples de questions utiles

• « Explique-moi la différence entre present perfect et past simple »
• « Fais-moi un exercice de vocabulaire niveau B1 »
• « Corrige ce texte : [ton texte en anglais] »
• « Comment se préparer au TOEIC en 3 mois ? »
• « Quelles sont les dates des prochains examens à l'AGTM ? »

Nouvelle conversation

Cliquez sur 🔄 Nouvelle conv. pour effacer l'historique de la session en cours et repartir de zéro. L'historique archivé en base de données est conservé côté admin.

15.4 Demander un upgrade de tier

Depuis Mon Espace (tableau de bord)

La carte Assistant IA AGTM en haut de votre tableau de bord affiche votre tier actuel. Si vous n'êtes pas sur le tier Premium, un bouton ⬆ Upgrader est visible.

1. Cliquez sur ⬆ Upgrader dans la carte IA de votre tableau de bord
2. Une demande automatique est envoyée à l'administration par messagerie interne
3. L'administrateur traite la demande et modifie votre tier
4. Vous pouvez aussi cliquer sur ⬆ Upgrader directement dans l'en-tête de l'espace Chat IA

15.5 Utilisation — Espace Formateur

Les formateurs ont accès à l'IA avec un prompt spécialisé pour :

• Préparer des cours, séquences pédagogiques, exercices
• Générer du matériel adapté aux niveaux CECRL (A1→C1)
• Rédiger des évaluations, barèmes, corrections type
• Aider à rédiger les rapports de séances

15.6 Administration IA — Espace Admin

L'administrateur dispose de deux points d'accès pour la gestion des tiers IA :

Depuis la Gestion des Utilisateurs

Dans Administration → 👥 Utilisateurs, chaque fiche utilisateur affiche maintenant un sélecteur de tier IA :

1. Localisez l'utilisateur dans la liste
2. Dans la colonne Actions, sélectionnez le tier souhaité dans le menu déroulant (🔵 Essentiel / 🟡 Recommandé / 🟣 Premium)
3. Cliquez sur 🤖 IA pour appliquer

Panneau Config IA — Onglet 1 : Configuration

• Activer / désactiver globalement le service IA
• Définir le modèle Claude pour chaque tier (Essentiel / Recommandé / Premium)
• Définir le nombre max de tokens par réponse
• Modifier le tier IA de n'importe quel utilisateur

Onglet 2 : Instructions

• Saisir des instructions spéciales qui s'ajoutent à toutes les conversations IA
• Exemple : « Ne mentionnez pas les tarifs sans confirmation admin » ou ajouter des informations ponctuelles sur l'école
• Ces instructions sont injectées en fin de prompt système pour tous les rôles

Onglet 3 : Base de connaissances

• Gérer les fiches de connaissance utilisées par l'IA (programme, FAQ, grammaire, etc.)
• Ajouter de nouvelles fiches par catégorie et niveau
• Activer / désactiver des fiches
• Modifier la priorité d'affichage (les fiches prioritaires sont injectées en premier)

15.7 Dépannage IA

❓ Le message "Erreur service IA" s'affiche

• Vérifiez que votre connexion internet est active
• Le service IA peut être temporairement désactivé par l'admin (message "service temporairement désactivé")
• Si le problème persiste, contactez l'administration — la clé API Anthropic doit avoir un solde suffisant

❓ L'IA ne répond pas en français

• Si vous écrivez en anglais, l'IA répond en anglais (comportement normal)
• Écrivez votre question en français pour obtenir une réponse en français

❓ La réponse est coupée ou très courte

• La longueur des réponses est limitée par le paramètre Max tokens dans Config IA
• L'administrateur peut augmenter cette valeur (recommandé : 1024 à 2048)
• Le tier Essentiel (Haiku) génère des réponses plus courtes que Sonnet ou Opus

16.1 Vue d'ensemble de la stack

AGTM Digital Academy est une application web progressive (PWA) 100% cloud, sans serveur à gérer. Elle repose sur 4 technologies principales :

Technologie	Rôle	Tier utilisé
Supabase	Base de données PostgreSQL, authentification JWT, stockage, RLS (Row-Level Security)	Free / Pro
Netlify	Hébergement statique (HTML/CSS/JS), fonctions serverless (ai-chat.js, etc.), CDN mondial	Free / Starter
Claude (Anthropic)	Moteur IA complémentaire — 3 modèles selon le tier : Haiku (Essentiel), Sonnet (Recommandé), Opus (Premium)	API à la consommation
DeepSeek	Moteur IA par défaut — économique, rapide, utilisé pour les quiz et la génération de contenu	API à la consommation
Groq	Moteur IA ultra-rapide — LLaMA 3.3 70B, idéal pour les réponses instantanées	API gratuite / payante
HTML / JS / TailwindCSS	Interface utilisateur — Single Page Application sans framework lourd, Tailwind pour le style	Open source

16.2 Supabase — Base de données & Auth

Supabase fournit un backend PostgreSQL entièrement géré :

• Authentification JWT : chaque utilisateur possède une session sécurisée côté serveur
• Row-Level Security (RLS) : chaque utilisateur ne peut accéder qu'à ses propres données. Un étudiant ne peut jamais lire les données d'un autre
• Tables principales : utilisateurs, étudiants, personnel, classes, seances, presences, finances, ai_config, ai_knowledge, ai_conversations, marketing_config
• Realtime : les mises à jour sont propagées en temps réel dans l'interface

16.3 Netlify — Hébergement & Fonctions serverless

Netlify héberge les fichiers statiques (dashboard.html, vitrine.html, index.html, sw.js…) et expose des fonctions serverless dans netlify/functions/ :

• ai-chat.js : proxy sécurisé entre le navigateur et l'API Claude — la clé API Anthropic n'est jamais exposée au client
• CDN mondial : les pages se chargent rapidement depuis n'importe quel pays grâce au réseau de distribution Netlify

16.4 Moteurs IA — DeepSeek / Claude / Groq

L'Assistant IA AGTM propose 4 moteurs d'IA sélectionnables manuellement par l'utilisateur via le sélecteur de fournisseur dans l'interface :

Moteur	Utilisation	Modèles
DeepSeek	Moteur par défaut — économique et rapide, idéal pour la génération de quiz, paroles, cours	deepseek-chat, deepseek-reasoner, deepseek-coder
Claude (Anthropic)	Moteur complémentaire — 3 niveaux selon le tier	Haiku (Essentiel), Sonnet (Recommandé), Opus (Premium)
Groq	Moteur ultra-rapide — réponses instantanées	LLaMA 3.3 70B
Turbo	Mode combiné — Claude analyse, Groq synthétise	Claude + Groq

Le changement de fournisseur se fait en un clic. Le choix est conservé dans les préférences locales du navigateur.

L'IA est enrichie d'une base de connaissances interne (programme AGTM, grammaire, FAQ) et peut effectuer des recherches web en temps réel (via Wikipedia et Brave Search) pour répondre à des questions d'actualité.

16.5 PWA — Application installable

La plateforme est une Progressive Web App (PWA), ce qui signifie :

• Installable sur Android, iOS et PC (Chrome, Edge, Safari) sans passer par un App Store
• Mode hors-ligne : les pages déjà visitées sont accessibles sans connexion grâce au Service Worker
• Mise à jour automatique : une bannière s'affiche quand une nouvelle version est disponible
• Notifications push : infrastructure en place pour des notifications futures (séances, rappels)

16.6 Sécurité

• Authentification JWT avec sessions côté serveur (Supabase Auth)
• RLS PostgreSQL : isolation des données par utilisateur au niveau base de données
• Clés API jamais exposées côté client (via proxy Netlify Function)
• HTTPS obligatoire (fourni par Netlify)
• Système de rôles et de permissions configurable par l'administrateur

17.1 Qu'est-ce que l'English Corner ?

L'English Corner est un espace d'apprentissage autonome et interactif accessible depuis la plateforme AGTM. Il regroupe des ressources pédagogiques organisées par compétence et niveau CECRL (A1 → C2), ainsi qu'une salle de classe virtuelle synchronisée.

• Accessible sans connexion obligatoire pour les ressources publiques
• Contenu organisé en 8 sections : Accueil, Vidéos, Podcasts, Grammaire, Vocabulaire, Écriture, Écoute, Lecture
• Plus de 5 playlists YouTube curatées par niveau CEFR (BBC Learning English, TED, etc.)
• Section Classe Virtuelle : synchronisation en temps réel entre professeur et apprenants

17.2 Navigation dans l'English Corner

La barre de navigation latérale de l'English Corner contient :

Section	Contenu
🏠 Accueil	Vue d'ensemble, ressources recommandées selon le niveau
🎬 Vidéos	Playlists YouTube par niveau CEFR (A1 → C2) — BBC Learning English, TED, etc.
🎧 Podcasts	Épisodes audio classés par niveau et thématique
📚 Grammaire	Règles, exercices et quiz de grammaire anglaise
🔤 Vocabulaire	Listes de mots, flashcards, exercices de mémorisation
✍️ Écriture	Exercices d'expression écrite guidée
👂 Écoute	Exercices de compréhension orale avec transcription
📖 Lecture	Textes authentiques avec questions de compréhension
🎓 Live Class	Classe Virtuelle — synchronisation YouTube en temps réel

17.3 Classe Virtuelle — Synchronisation YouTube

La Classe Virtuelle permet au professeur de contrôler un lecteur YouTube sur les appareils des apprenants en temps réel, sans partage d'écran. Chaque participant regarde et entend la vidéo localement — sans dépendre de Google Meet ou Zoom.

Comment ça fonctionne ?

• Le Teacher contrôle la vidéo (play, pause, seek) — ses actions sont diffusées via Supabase Realtime
• L'Élève reçoit les événements et synchronise automatiquement son propre lecteur
• Chaque session est isolée par un code de session unique
• L'audio est lu localement sur chaque appareil — qualité optimale, zéro latence audio

Démarrer une session — Rôle Teacher (Professeur)

1. Aller dans English Corner → onglet 🎓 Live Class
2. Sélectionner le rôle "Teacher"
3. Saisir un code de session (ex : AGTM-B1-LUNDI) — ce code sera partagé aux élèves
4. Entrer l'ID YouTube de la vidéo à diffuser (11 caractères, ex : KOiMt65IQCA)
5. Cliquer "Lancer la session" — le lecteur s'ouvre
6. Contrôler la vidéo normalement : chaque action (play/pause/avance) est synchronisée sur tous les appareils élèves connectés à ce code

Rejoindre une session — Rôle Student (Élève)

1. Aller dans English Corner → onglet 🎓 Live Class
2. Sélectionner le rôle "Student"
3. Saisir le code de session donné par le professeur
4. Cliquer "Rejoindre" — le lecteur se synchronise automatiquement avec le Teacher
5. Si le professeur a déjà commencé, la vidéo démarre au bon timestamp

17.3.1 Identification & Contrôle d'accès des apprenants

Lorsqu'un apprenant rejoint une session Live Class, la plateforme vérifie automatiquement son identité dans la base de données. Seuls les étudiants enregistrés dans Supabase peuvent accéder à la vidéo.

• L'apprenant doit être connecté à son compte AGTM pour rejoindre une session
• La plateforme récupère son numéro de dossier, prénom, nom et ID étudiant par vérification automatique
• Si l'apprenant n'est pas enregistré dans la base, l'accès est refusé avec le message "⛔ Accès refusé — non enregistré"
• Le formateur voit la liste des participants en temps réel dans son panneau de droite

17.3.2 Mode Suivi (Follow Mode)

Par défaut, les apprenants sont en mode suivi : la vidéo se synchronise automatiquement sur les actions du formateur (play, pause, avance rapide). L'apprenant peut désactiver ce mode.

Mode	Comportement	Icône
Suivi activé (défaut)	Toutes les actions du formateur sont appliquées automatiquement	👁 Suivi ON
Suivi désactivé	L'apprenant contrôle sa propre vidéo librement	✋ Libre

17.3.3 Panneau d'évaluation — Formateur

Le formateur dispose d'un panneau latéral d'évaluation en direct qui liste tous les participants connectés. Il peut évaluer chaque apprenant pendant ou après la séance, et les notes sont enregistrées automatiquement.

Évaluer un apprenant depuis la Live Class

1. Dans le panneau droit de la Classe Virtuelle, cliquer sur "📝 Évaluer" à côté du nom d'un participant
2. Renseigner : Sujet (ex : Present Perfect), Thème optionnel, Score et Score maximum, Commentaire
3. Cliquer "Enregistrer" — la note est sauvegardée dans Supabase (live_evaluations + evaluations)
4. L'apprenant reçoit immédiatement une notification de note sur son écran
5. L'appréciation automatique est calculée : ≥80% → Très Bien · ≥60% → Bien · ≥50% → Passable · <50% → Insuffisant

17.3.4 Quiz Manuel — Formateur

En plus des quiz automatiques, le formateur peut diffuser un quiz instantané à tous les élèves connectés depuis le bouton "❓ Quiz" de la barre d'outils.

1. Cliquer sur "❓ Quiz" dans la barre d'outils de la Classe Virtuelle
2. Saisir la question et les choix de réponses (jusqu'à 4 options)
3. Cliquer "Diffuser" — le quiz apparaît sur l'écran de tous les élèves connectés
4. Les résultats remontent en temps réel dans le panneau formateur

17.4 Quiz Triggers — Quiz automatiques pendant la vidéo

Lorsque le lecteur atteint certains moments clés d'une vidéo, un quiz plein écran s'affiche automatiquement et suspend la lecture. L'apprenant répond, puis le cours reprend.

Pour les apprenants

1. La vidéo joue normalement
2. À un moment précis (trigger_time défini par l'administrateur), le lecteur se met en pause automatiquement
3. Un quiz plein écran s'affiche : question à choix multiples (MCQ) ou question ouverte
4. Sélectionner la réponse → cliquer "Valider"
5. Le résultat s'affiche avec l'explication — bouton "Continuer" pour reprendre la vidéo

Types de questions disponibles

• MCQ (Multiple Choice Question) : 4 options, une seule bonne réponse — correction immédiate
• Question ouverte courte : l'apprenant rédige sa réponse, un modèle de réponse lui est montré

17.5 Outils de Capture — Screen Recording

La barre d'outils de la Classe Virtuelle offre deux fonctions avancées :

🔴 Enregistrer un extrait (Screen Recording)

1. Cliquer sur "🔴 Enregistrer un extrait" dans la barre d'outils
2. Le navigateur demande l'autorisation de capturer l'écran — sélectionner l'onglet actuel
3. Un point rouge clignotant (●) indique que l'enregistrement est en cours
4. Cliquer "⏹ Arrêter" pour terminer
5. Le fichier .webm se télécharge automatiquement (nommé agtm-extrait-[session]-[date].webm)

📱 Enregistrement sur mobile (Android / Samsung / iOS)

Sur mobile et tablette, getDisplayMedia n'est pas disponible dans le navigateur. La plateforme détecte automatiquement l'appareil et affiche un guide d'enregistrement natif adapté à chaque système.

Système	Comment activer le son interne
Android (standard)	Panneau de notifications → Capture d'écran → activer "Sons de l'application" ou "Audio interne" avant de démarrer
Samsung (One UI)	Raccourci capture d'écran → réglages → activer "Son des médias". Sur One UI 5+ : Paramètres → Fonctions avancées → Capture vidéo d'écran → activer le son des médias
iOS / iPadOS	Réglages → Centre de contrôle → Ajouter "Enregistrement d'écran" → dans Centre de contrôle, appui long sur le bouton d'enregistrement → activer "Micro" pour capturer le son

🔗 Partager ce cours (Web Share)

1. Cliquer sur "🔗 Partager" dans la barre d'outils
2. Sur mobile : le menu de partage natif du téléphone s'ouvre (WhatsApp, Email, SMS…)
3. Sur PC : le lien avec les paramètres de session est copié dans le presse-papiers
4. Le lien partagé contient le code de session, le rôle "student" et l'ID vidéo — l'élève rejoint en un clic

17.6 Playlists YouTube curatées (5 niveaux)

L'English Corner propose 5 playlists prêtes à l'emploi, sélectionnées par l'équipe AGTM :

Niveau CEFR	Sources	Contenu
A1 — Débutant	BBC Learning English, EnglishClass101	Vocabulaire de base, salutations, premiers mots
A2 — Élémentaire	VOA Learning English, JenniferESL	Phrases du quotidien, présent simple, famille
B1 — Intermédiaire	BBC 6 Minute English, TED-Ed	Sujets d'actualité, Past Simple, Present Perfect
B2 — Avancé	TED Talks, BBC News, The Economist	Débats, opinions, économie, technologie
C1/C2 — Expert	TED Talks, BBC Hardtalk, academia	Conférences académiques, prise de position, nuances

17.7 Rapports de Séance & Honoraires (Formateur)

Les formateurs soumettent leurs rapports de séance directement depuis leur espace. L'admin et la direction pédagogique disposent d'un suivi temps réel avec génération PDF.

Soumettre un rapport de séance (Formateur)

1. Depuis le tableau de bord formateur → section "Rapport de Séance"
2. Renseigner : thème abordé, objectifs atteints, exercices réalisés, progression globale
3. Saisir les présences : nombre de présents, absents non justifiés, absents justifiés
4. Cliquer "Soumettre le rapport" — les honoraires sont calculés automatiquement

Générer le PDF d'un rapport (Admin / Formateur / Direction)

1. Aller dans Rapports → liste des rapports soumis
2. Cliquer sur "📄 PDF" à droite de la ligne souhaitée
3. Une fenêtre s'ouvre avec le rapport complet incluant les honoraires synchronisés
4. Cliquer "🖨️ Imprimer / Enregistrer en PDF" — le navigateur ouvre la boîte d'impression
5. Choisir "Enregistrer en PDF" comme imprimante pour télécharger le fichier

Suivi honoraires en temps réel

Dans "Mes Honoraires" (espace formateur) :

• Tableau de toutes les séances avec montant calculé, tarif appliqué et statut de paiement
• 3 indicateurs en tête de page : Total validé · Payé · En attente
• Statuts : En attente → Validé → Payé

17.8 Génération de quiz par IA & Ajout de contenu

L'English Corner intègre un moteur IA multi-fournisseur (DeepSeek par défaut, Claude, Groq) pour générer automatiquement des quiz et du contenu pédagogique.

Sélecteur de fournisseur IA

Dans la topbar de l'English Corner, un menu déroulant permet de choisir entre DeepSeek (défaut), Claude et Groq. Le choix est conservé localement.

Quiz automatique

• Live Class — bouton 🧠 Quiz → 5 questions QCM générées par IA sur la vidéo en cours
• Reading (Lecture) — bouton 🧠 Quiz → 5 questions de compréhension écrite
• Podcasts — bouton 🧠 Quiz → 5 questions de compréhension orale
• Musique — bouton 🎤 Paroles + Questions → paroles + 3-5 questions QCM

Si l'API IA est indisponible (hors ligne), un quiz de fallback statique est utilisé.

Ajout manuel de contenu (mode admin)

Les boutons d'ajout apparaissent automatiquement sur localhost ou après double-clic sur le titre "English Corner" dans la topbar.

• Vidéos — importer une playlist YouTube complète
• Musique — ajouter une chanson par ID YouTube ou playlist
• Listening (Écoute) — importer une playlist d'écoute
• Reading (Lecture) — ajouter une vidéo avec titre + ID YouTube + niveau
• Podcasts — ajouter un podcast avec titre + URL + chaîne

Les données ajoutées sont stockées dans localStorage et fusionnées avec les contenus API et fallback.

18.1 Présentation

L'assistant IA AGTM intègre un module vocal complet permettant aux apprenants de parler à la voix pour poser leurs questions, pratiquer leur speaking et recevoir les réponses lues à voix haute — en anglais ou en français.

• STT (Speech-to-Text) : votre voix est retranscrite en texte dans la zone de saisie
• TTS (Text-to-Speech) : les réponses de l'IA sont lues automatiquement à voix haute
• Score de prononciation : pour les exercices de speaking, un score de clarté est affiché
• Bilingue : basculez entre l'anglais 🇬🇧 et le français 🇫🇷 en un clic

18.2 Boutons de la zone de saisie

Bouton	Icône	Action
Microphone	🎤 / ⏹	Activer/désactiver la saisie vocale. En cours : clignotement rouge
Langue	🇬🇧 / 🇫🇷	Basculer entre anglais (en-US) et français (fr-FR)
Lecture TTS	🔇 / 🔊	Activer/désactiver la lecture vocale des réponses IA
Envoyer	➤	Envoyer le message (clavier ou voix)

18.3 Activer la saisie vocale

1. Aller dans le menu "🤖 Assistant IA" du tableau de bord
2. Cliquer sur le bouton 🎤 dans la barre de saisie — autoriser l'accès au microphone si demandé
3. La barre bleue en haut de la zone de saisie apparaît avec le texte "En écoute…"
4. Parler normalement — la transcription s'affiche en temps réel dans la zone de texte
5. Appuyer sur Entrée ou cliquer ➤ pour envoyer le message (le micro s'arrête automatiquement)

18.4 Activer la lecture des réponses (TTS)

1. Cliquer sur le bouton 🔇 dans la barre de saisie — il devient 🔊 (bleu)
2. Envoyer un message — la réponse de l'IA sera lue automatiquement à voix haute
3. Pour arrêter la lecture en cours : cliquer à nouveau sur 🔊 pour désactiver

18.5 Changer la langue vocale

Cliquer sur le bouton de langue (🇬🇧 ou 🇫🇷) pour basculer entre :

Langue	Code	Usage recommandé
🇬🇧 Anglais	en-US	Pratique du speaking, questions en anglais, préparation TOEIC/TOEFL
🇫🇷 Français	fr-FR	Questions administratives, aide à la grammaire, support en français

18.6 Score de prononciation

Lors d'exercices de speaking guidés, un badge de clarté s'affiche pendant 4 secondes après la transcription :

Score	Badge	Interprétation
≥ 85%	✅ 92%	Excellente prononciation — bien compris
60–84%	⚠ 72%	Prononciation acceptable — quelques approximations
< 60%	❌ 45%	Prononciation à améliorer — répéter l'exercice

18.7 Journal des interactions vocales

Chaque interaction vocale est enregistrée dans la base de données (voice_interactions) pour le suivi pédagogique :

• Méthode STT utilisée (Web Speech ou Whisper)
• Langue de l'interaction (en-US / fr-FR)
• Transcription envoyée à l'IA
• Score de prononciation (si exercice)
• TTS activé ou non, durée de la session vocale