Glossaire

Termes spécifiques utilisés dans l'app et leur définition. Ordre alphabétique.

Adresse de dépôt

Adresse email unique générée pour chaque devoir, de la forme contact+<token>@mathmender.com. Tu y transfères les copies depuis ta boîte mail habituelle pour que l'app les ingère.

Allowlist

Liste d'emails autorisés à créer un compte sur l'instance, maintenue par l'administrateur·trice. Si ton email n'est pas dans cette liste, l'inscription échoue avec NOT_ALLOWLISTED. Sur les instances ouvertes au public, l'allowlist peut être inactive (tout le monde peut s'inscrire).

assignments_count

Nombre de devoirs distincts dans une classe. Affiché dans la liste des classes.

Classe

Unité d'organisation principale. Regroupe étudiant·es, groupes, cours, devoirs. Une classe = un groupe pédagogique de niveau (« Terminale Spé Maths 2025 »).

Cohérence typographique

Étape du pipeline qui uniformise les notations entre la transcription (ce que l'OCR a lu) et le rapport (ce que l'évaluation a écrit). Garantit que \mathbb{R} et \R n'apparaissent pas en même temps dans le livret.

Devoir (assignment)

Un événement pédagogique unique (contrôle, DM, DS, TP, examen). Chaque devoir a son identifiant (slug), ses copies, son livret par étudiant·e.

Énoncé

Le fichier corrigé du devoir, en LaTeX. Trois états successifs :

• source : sujet brut déposé.
• generated : corrigé généré par IA, en cours d'édition.
• validated : corrigé validé, livret peut être produit.

Vois Énoncés.

Groupe

Sous-division d'une classe (ex : groupe1, S1-A). Permet des échéances différentes par sous-groupe sur un même devoir. Vois Groupes.

groupe_tous.csv

Fichier CSV dérivé qui agrège tous les étudiant·es de tous les groupes. Ne pas éditer directement — l'app le régénère à chaque modification du registre.

Ingestion

Action de récupérer les copies transférées à l'adresse de dépôt d'un devoir et de les apparier aux étudiant·es du registre. Vois Lancer l'ingestion.

last_activity

Date/heure de la dernière modification dans une classe (corrections/ ou statements_solutions/). Affichée dans la liste des classes.

Livret

Le PDF final produit par le pipeline pour une remise. Contient : énoncé du devoir + copie de l'élève + transcription + rapport de correction + note. C'est ce qui est envoyé par mail à l'élève.

Mail token

Chaîne de 8 caractères générée par l'app à la création d'un devoir. Sert à composer l'adresse de dépôt unique contact+<token>@mathmender.com. Permet à l'app de classer automatiquement les copies dans le bon devoir.

OCR

Optical Character Recognition. Étape du pipeline qui extrait le texte d'une copie scannée. Utilise un modèle IA (pas pdftotext).

pending_deliveries

Nombre de remises non terminées dans une classe (états new, wait, fail). Affiché dans la liste des classes.

Pipeline

Chaîne d'étapes qui transforme une copie brute (PDF/images) en livret PDF corrigé. ~7 étapes : prepare → OCR → harmoniser → évaluer → cohérence → blocs illisibles → compiler livret. Vois Pipeline.

Registre

Liste des étudiant·es d'une classe, stockée en CSV par groupe sous data/groupe*.csv.

Remise (delivery)

Envoi d'un·e étudiant·e pour un devoir. Une remise = corrections/<étudiant>/<slug_devoir>/. Chaque remise a un état (new, OK, WAIT★, FAIL, sent, absent).

Slug

Identifiant URL-friendly, généré automatiquement à partir d'un libellé. Lettres ASCII minuscules, chiffres, tirets. Exemples : terminale-spe-maths-2025 (slug de classe), controle-de-mars-2026-03-17 (slug de devoir). Immuable après création.

sent_at

Date/heure d'envoi du livret à l'étudiant·e, notée dans le metadata.json de la remise. Détermine l'état sent.

Synthèse pédagogique

Vue agrégée des résultats d'un devoir : notes moyennes par question, points faibles récurrents de la classe. Calculée à la demande à partir des rapport.tex de toutes les copies corrigées (bouton « 📊 Calculer la synthèse » sous la table des remises). Vois Synthèse par devoir.

WAIT★

État de remise : le pipeline a terminé mais une intervention humaine est requise pour valider des blocs illisibles. L'envoi est bloqué tant que tous les blocs ne sont pas validés. Vois Relire un livret.

Workspace

Espace de stockage isolé par enseignant·e, sous teachers/<uuid>/. Contient toutes ses classes et leurs données. Pas visible utilisateur — c'est de l'organisation serveur.