Lancer l'ingestion

L'ingestion récupère les copies que tu as transférées à l'adresse de dépôt du devoir, identifie chaque expéditeur·rice dans ton registre étudiants, et crée une remise par étudiant·e dans le système de l'app.

Prérequis

Avant de cliquer « Ingérer », vérifie que :

1. Ton registre étudiants est rempli (au moins un·e dans data/groupe*.csv). Sinon, code d'erreur STUDENTS_MISSING.
2. Tu as transféré les copies à l'adresse de dépôt du devoir (vois Transférer les copies par mail).

Comment lancer

Onglet Devoirs de la classe → bouton « ↓ Ingérer » sur la ligne du devoir.

L'ingestion est asynchrone : tu vois un message « Ingestion en cours… » et tu peux continuer à utiliser l'app. Le serveur va :

1. Se connecter à la boîte mail de dépôt en IMAP.
2. Lire tous les messages reçus à l'adresse contact+<token>@mathmender.com de ce devoir.
3. Pour chaque message, parser les pièces jointes (PDF, images).
4. Identifier l'expéditeur·rice original·e (l'élève) à partir des en-têtes du message.
5. Apparier l'email à un·e étudiant·e du registre.
6. Créer un dossier corrections/<identifiant_élève>/<slug_devoir>/ avec les pièces jointes et un metadata.json.

Compte ~2 à 5 min pour une classe de 20-30 élèves. La table des remises se remplit progressivement — actualise la page si elle n'apparaît pas seule.

États visibles côté UI

Sur la ligne du devoir, la colonne Ingestion affiche :

• non ingéré : aucune ingestion n'a tourné, la boîte mail n'a pas été lue.
• ingéré : au moins une ingestion a réussi.

Le bouton « ↓ Ingérer » peut être cliqué autant de fois que tu veux — l'app traite chaque fois les nouveaux messages depuis la dernière exécution (idempotent).

Cas d'erreur courants

STUDENTS_MISSING

Registre étudiants vide. Va dans l'onglet Étudiants & groupes et importe ton CSV.

BUSY

Une autre ingestion (ou un autre pipeline) tourne déjà sur cette remise. Attends quelques secondes et réessaie.

Aucune copie trouvée

L'ingestion s'est bien passée mais 0 remise n'est apparue. Causes fréquentes :

• Tu n'as pas encore transféré les emails (vérifie ta boîte d'envoi : sont-ils partis ?).
• Tu as utilisé « Transférer » au lieu de « Transférer comme pièce jointe » → l'app n'arrive pas à identifier l'expéditeur·rice original·e (vois Transférer les copies par mail).
• Les expéditeur·rices original·es n'ont pas leur email dans ton registre → ils sont archivés dans un dossier de rejets avec la raison « étudiant non trouvé ».

Vois 0 copies ingérées pour le détail du dépannage.

Et après ?

Une fois l'ingestion réussie, ouvre la fiche du devoir (clic sur la ligne) pour voir la table des remises. La suite, c'est de préparer l'énoncé corrigé puis lancer le pipeline. Vois Pipeline de correction.