Pipeline en échec

Une remise est en état FAIL ou WAIT★ après le passage du pipeline. Voici comment diagnostiquer.

D'abord, ouvre la fiche de la remise

Clique sur la ligne de la remise dans la table. Tu vois en haut :

• L'étape qui a échoué (badge avec son nom).
• Le dernier message d'erreur (extrait des logs du worker).
• Un bouton « Relancer cette étape » ou « Repartir à zéro ».

Cas 1 — FAIL sur prepare_parts

La copie n'a pas pu être préparée. Symptômes :

• PDF corrompu (peut s'ouvrir dans un viewer mais l'app n'en fait rien).
• Image trop sombre, écriture quasi invisible.
• Mauvaise orientation (paysage au lieu de portrait).

Solutions :

• Demande à l'étudiant·e une nouvelle photo / un nouveau scan de meilleure qualité.
• Re-télécharger depuis le mail (↓ Re-télécharger mail) si un nouveau message est arrivé.
• Déposer manuellement une copie via le bouton « Déposer une copie manuellement ».

Cas 2 — FAIL sur ocr_transcribe

L'OCR n'a pas pu extraire le texte. Causes :

• Écriture très penchée ou non standard.
• Photo très floue.
• Trop de bruit / griffonnages.

Solutions :

• Relancer cette étape (parfois transitoire).
• Demander une meilleure photo.
• Si vraiment illisible, marquer comme WAIT★ et faire la saisie manuelle dans le rapport.

Cas 3 — WAIT★

Le pipeline a terminé mais l'app a détecté des blocs illisibles (encadrés \notreadableatcoherency{...} dans la transcription). Ces blocs sont notés 0 par défaut et bloquent l'envoi tant qu'ils ne sont pas validés humainement.

Les zones raturées volontairement par l'étudiant·e (encadrées \struck{N%}) ne provoquent pas de WAIT★ — elles sont traitées comme une non-réponse neutre par l'IA d'évaluation.

Sur la fiche de la remise, section Blocs en attente :

• Pour chaque bloc, l'app affiche l'image originale et la transcription tentée.
• Tu peux :
  • Valider tel quel (garde la note 0).
  • Imposer une note (saisis ce que tu lis).
  • Marquer comme illisible (note 0 confirmée).

Une fois tous les blocs validés, l'état passe à OK.

Cas 4 — FAIL sur grade_evaluation

L'évaluation IA a échoué. Causes possibles :

• Quota API dépassé (côté serveur).
• Timeout réseau.
• Réponse IA non parsable.

Solutions :

• Relancer cette étape. Souvent ça marche au 2e essai.
• Si ça échoue 3 fois de suite, contacte l'administrateur·trice — il y a probablement un problème de config IA ou de quota.

Cas 5 — FAIL sur compile_booklet

pdflatex ne compile pas le livret. Causes :

• Caractère spécial dans le rapport mal échappé (%, $, &).
• Macro inconnue dans la transcription.
• Image trop grosse.

Solutions :

• Édite le rapport (textarea sur la fiche) pour corriger les caractères problématiques, puis « Compiler le livret ».
• Si l'erreur vient de la transcription (read-only), il faut re-faire l'étape ocr_transcribe.

PDFLATEX_NOT_FOUND

pdflatex n'est pas installé sur le serveur. C'est une erreur d'administration — contacte l'administrateur·trice.

Cas 6 — BUSY pendant le pipeline

Tu cliques sur une action et l'app renvoie 409 BUSY. C'est qu'une autre opération tourne déjà sur cette remise (ou classe). Attends quelques secondes, l'état devrait se libérer seul.

Si après 1-2 minutes la remise reste BUSY sans progression visible, il y a peut-être un worker bloqué côté serveur. Solution de dernier recours : recharge la page, parfois ça « débloque » l'affichage. Si le problème persiste, contacte l'administrateur·trice.

Cas 7 — Tout est FAIL sur toutes les remises

Si toutes les remises d'un devoir échouent au même endroit, c'est probablement un problème systémique (quota IA dépassé, service IA en panne, énoncé corrigé invalide).

Vérifie :

• L'énoncé est-il bien validated et le PDF compilé ?
• Le solde est-il suffisant (si paiement activé) ?
• Les logs serveur (côté admin) montrent-ils une erreur récurrente ?

Si tu es admin, vois les logs serveur. Sinon, contacte l'administrateur·trice avec :

• Le slug du devoir.
• L'étape qui échoue.
• L'extrait de message d'erreur visible côté UI.