Pipeline de correction

Le pipeline est la chaîne d'étapes qui transforme une copie brute (PDF ou images) en livret PDF corrigé. Une fois ton énoncé validé, tu peux lancer le pipeline sur les remises.

Lancer sur tout le devoir

Sur la fiche du devoir, table des remises → bouton « ▶ Tout lancer » en haut. Lance le pipeline sur toutes les remises dont l'état permet (typiquement les new).

Tu peux aussi lancer une remise à la fois depuis sa ligne (bouton ▶ par ligne).

Les étapes du pipeline

L'app traite chaque copie en série, étape par étape :

1. prepare_parts — détecte les pages, les découpe, les réordonne si nécessaire.
2. ocr_transcribe — extrait le texte de chaque page via OCR (modèle IA dédié, pas pdftotext).
3. harmonize_transcription — uniformise la transcription pour faciliter la lecture par l'évaluateur (titres, numérotation, équations LaTeX).
4. grade_evaluation — évalue chaque exercice/question contre l'énoncé corrigé, attribue une note partielle, génère un rapport.
5. typographic_coherency — passe de cohérence typographique (notations homogènes entre transcription et rapport).
6. unreadable_blocks — détection des blocs illisibles (encadrés par \notreadableatcoherency{...}). Note : les zones raturées volontairement par l'étudiant·e (encadrées par \struck{N%} dès l'OCR) ne sont pas considérées comme des blocs illisibles — l'IA les traite comme une non-réponse neutre.
7. compile_booklet — compile le livret PDF final (énoncé + copie + transcription + rapport + note).

Compte ~3 à 8 minutes par copie selon sa longueur et le modèle IA utilisé.

Suivre l'avancement

Pendant le pipeline, l'app polle toutes les 2 secondes l'état des remises. La colonne État se met à jour automatiquement avec les badges :

File d'attente globale

L'app n'exécute qu'un pipeline à la fois sur toute l'instance (toutes classes confondues). Si un·e autre enseignant·e a lancé un pipeline avant toi, tu vois « X remises devant vous » et le tien démarre quand le tien arrive. Pas d'action requise — tu peux quitter la page, le pipeline tourne en arrière-plan.

Relancer une étape

Sur la fiche d'une remise, tu peux relancer une étape spécifique sans repartir de zéro : utile si tu as modifié l'énoncé après une évaluation imparfaite, ou si une étape a échoué pour une raison transitoire.

Bouton « 🔄 Repartir à zéro » sur la fiche de la remise pour tout réinitialiser (efface les artefacts intermédiaires, garde les pièces jointes originales).

Cas d'erreur

BUSY

Une autre opération tourne sur cette remise. Attends quelques secondes.

FAIL sur prepare_parts

Copie illisible (PDF corrompu, image trop sombre, mauvaise orientation). Vérifie la pièce jointe.

FAIL sur ocr_transcribe

L'OCR n'a pas pu extraire le texte. Souvent une page très penchée ou une écriture très inhabituelle. Tu peux relancer ou faire une re-saisie manuelle (étape future).

FAIL sur compile_booklet

LaTeX cassé dans la transcription ou le rapport (souvent un caractère spécial mal échappé). Tu peux éditer le rapport manuellement puis relancer cette seule étape.

Pipeline lent ou bloqué

Vois Pipeline en échec pour le dépannage détaillé.

Coût en API

Chaque étape qui appelle un modèle IA (OCR, harmonisation, évaluation, cohérence) consomme des tokens. Sur une copie typique, compte quelques centimes d'API par livret (selon les modèles configurés sur l'instance et la longueur de la copie). Vois Comment marche le paiement.