# MaskEval - Guide utilisateur > **MaskEval** est une application autonome (un seul fichier HTML, sans installation) qui automatise l’assistance à l'écriture des appréciations de bilans périodiques par intelligence artificielle, tout en préservant les données confidentielles des élèves, en conformité avec le RGPD. --- ## Principe de fonctionnement MaskEval ne communique **jamais** les vrais noms des élèves à une IA externe. Avant d'envoyer quoi que ce soit, l'application remplace chaque nom par un **prénom fictif** (ex. *Alma*, *Axel*, *Célia*…). Une fois les appréciations générées par l'IA, MaskEval réasssocie automatiquement les vrais noms. Tout se passe en local, dans votre navigateur. --- ## Démarrage rapide 1. Ouvrez le fichier `MaskEval.html` dans votre navigateur (Chrome recommandé). 2. Suivez les 5 étapes dans la barre de navigation à gauche. 3. À l'étape 4, copiez le prompt et collez-le dans votre IA (Claude, ChatGPT…). 4. Collez la réponse de l'IA à l'étape 5. 5. Exportez le CSV et importez-le dans votre logiciel de notes. --- ## Étape 1 — Élèves ### Charger la liste Vous pouvez soit **glisser-déposer** un fichier, soit **coller directement** la liste depuis Pronote ou un tableur. Formats acceptés : `.csv`, `.txt`, `.tsv`, ou copier-coller. Un élève par ligne, format attendu : `NOM Prénom` (ou `NOM;Prénom` pour un export CSV). > ⚠️ Les noms ou prénoms de **moins de 3 caractères** ne pourront pas être anonymisés automatiquement. ### Prénoms fictifs Chaque élève reçoit un **prénom fictif stable** déterminé à partir de son nom réel (via un calcul de hachage). Cela garantit que le même élève recevra toujours le même prénom fictif d'un trimestre à l'autre, même si la liste change. --- ## Étape 2 — Genre L'application détecte automatiquement le genre de chaque élève à partir de son prénom, grâce à une base de données de prénoms français. ### Tableau | Colonne | Description | |---|---| | Identifiant | Le prénom fictif attribué à cet élève | | Nom complet | Le vrai nom (visible uniquement dans MaskEval) | | Prénom détecté | Le prénom utilisé pour la détection | | Genre | ♀ Fille / ♂ Garçon / ? NSP | Vérifiez et corrigez le genre si nécessaire en cliquant sur les boutons ♀ / ♂ / ?. Les accords dans les appréciations en dépendent. > 💡 En cas de changement de genre, les prénoms fictifs sont automatiquement réattribués pour rester cohérents. --- ## Étape 3 — Fichiers ### Trimestre en cours Sélectionnez le trimestre (T1, T2 ou T3). Ce choix adapte les instructions envoyées à l'IA : - **T1** — pas d'historique, appréciations basées uniquement sur ce trimestre - **T2 / T3** — possibilité de charger les appréciations des trimestres précédents ### Fichiers de données Au moins **un fichier parmi les trois suivants** est obligatoire : | Zone | Contenu | Obligatoire | | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | | **Notes** | Export CSV des notes depuis Pronote ou votre logiciel | Non (mais recommandé) | | **Investissement** | Export [InvestClass](https://edulab-rignac.forge.apps.education.fr/investclass/) ou tableau/texte de suivi de l'investissement en classe | Non | | **Niveaux de maîtrise** | Exports [ClairÉval](https://edulab-rignac.forge.apps.education.fr/claireval/) ou tableau/texte décrivant le niveau de maîtrise des élèves pur les compétences évaluées (plusieurs fichiers possibles) | Non | Tous les formats texte brut sont acceptés (`.csv`, `.txt`, `.tsv`). Les fichiers `.xlsx` et `.pdf` ne sont **pas** compatibles — exportez-les en `.csv` depuis votre tableur. > 💡 Les noms des élèves sont automatiquement remplacés dans tous les fichiers avant d'être envoyés à l'IA. Le remplacement fonctionne même si le nom et le prénom sont séparés par un point-virgule, une virgule ou une tabulation (formats d'export courants). ### Appréciations des trimestres précédents Chargez ici les appréciations rédigées lors des trimestres précédents **pour cette même classe**. MaskEval les anonymisera automatiquement avant de les inclure dans le prompt. > ⚠️ **Les élèves partis depuis les trimestres précédents doivent impérativement être supprimés des fichiers avant de les charger : ils ne peuvent être anonymisés par l'application !** ### Appréciations de référence *(optionnel)* Ce champ permet d'indiquer à l'IA votre **style rédactionnel** habituel, à partir d'exemples d'appréciations que vous avez rédigées pour d'autres classes. Ce fichier doit être anonymisé manuellement avant d'être chargé (remplacez les noms par des termes génériques comme *l'élève*). --- ## Étape 4 — Prompt ### Personnaliser le contexte Deux zones de texte sont modifiables et sauvegardées automatiquement : - **Rôle et contexte** — décrivez votre matière, le type d'établissement, les niveaux. Remplacez les espaces réservés `[MATIÈRE]`, `[TYPE D'ÉTABLISSEMENT]` et `[NIVEAUX]`. - **Format de sortie** — instructions de mise en forme pour l'IA (longueur des appréciations, format attendu…). ### Sigles dans les notes Si votre fichier de notes contient des sigles Pronote, l'IA les interprète comme suit : | Sigle | Signification | Impact sur la moyenne | |---|---|---| | `Abs` | Absent (justifié) | Non compté | | `Abs*` | Absent (injustifié) | Compte comme 0 | | `Disp` | Dispensé | Non compté | | `N.Not` | Non noté | Non compté | | `N.Rdu` | Travail non rendu | Non compté | | `N.Rdu*` | Non rendu (pénalisé) | Compte comme 0 | | `Inap` | Inapte | Non compté | > 💡 Si un élève a été absent à plusieurs évaluations, l'IA est instruite de signaler que la moyenne chiffrée est peu représentative. ### Copier et utiliser le prompt Cliquez sur **Copier**, puis collez le prompt dans votre IA (Claude, ChatGPT, Gemini…). Attendez la réponse complète avant de passer à l'étape suivante. --- ## Étape 5 — Résultats ### Coller la réponse de l'IA Collez la réponse brute de l'IA dans la zone de texte, puis cliquez sur **Traiter les résultats**. MaskEval reconnaît automatiquement les formats suivants : - Prénom fictif seul sur une ligne (`Alma`) - Prénom fictif avec markdown (`**Alma**`, `### Alma`, `1. Alma`) - Format de repli `Élève_01` si l'IA n'a pas respecté les prénoms fictifs ### Appréciations affichées Chaque appréciation est affichée avec le **vrai nom de l'élève**. Le prénom fictif a été remplacé par le prénom réel dans le texte. L'**appréciation générale de la classe** est affichée séparément en bas de page. ### Exporter Cliquez sur **Exporter CSV** pour télécharger un fichier compatible avec la plupart des logiciels de notes (encodage UTF-8 avec BOM, compatible Excel). Le CSV contient trois colonnes : *Nom complet*, *Genre*, *Appréciation*. > ⚠️ **Rappel essentiel** — Une IA générative peut produire des contenus erronés, biaisés ou inadaptés. Relisez et adaptez chaque appréciation avant de la saisir dans le bulletin officiel. Vous êtes responsable de ce que vous publiez. --- ## Bonnes pratiques - **Vérifiez toujours** les appréciations générées avant toute utilisation officielle. - **Ne chargez jamais** de fichier `.xlsx` ou `.pdf` — exportez d'abord en `.csv`. - **Corrigez le genre** des élèves à l'étape 2 : les accords incorrects signalent immédiatement une IA à un parent attentif. - **Personnalisez le prompt** une fois pour toutes en renseignant votre matière et vos niveaux — il est sauvegardé automatiquement. - Pour les trimestres suivants, **rechargez la même liste d'élèves** dans le même ordre pour retrouver les mêmes prénoms fictifs. --- ## Compatibilité | Navigateur | Support | | ----------------- | ------- | | Basé sur Chromium | ✅ | | Firefox | ✅ | | Safari | ✅ | Aucune installation requise, le fichier HTML peut fonctionner sur votre ordinateur. Aucune donnée n'est transmise à un serveur : l'application fonctionne hors ligne une fois le fichier ouvert. --- *MaskEval — Application locale et RGPD d'accompagnement à la rédaction d'appréciations* [jerome.goudin@ac-toulouse.fr](mailto:Jérôme.goudin@ac-toulouse.fr) Référent EduLAB Rignac