Dépannage — Piges

Pannes courantes rencontrées par les validateurs PIGES dans l'interface Streamlit. Chaque entrée suit le modèle Symptôme → Cause probable → Solution.

Interface Streamlit lente ou gelée

Symptôme : L'interface met plus de 10 secondes à réagir au clic, ou le spinner Running... reste affiché indéfiniment.

Cause probable : Lot de corrections trop volumineux dans une seule session, ou contention sur le worker Streamlit partagé.

Solution :

1. Rafraîchir la page (R ou bouton Rerun)
2. Réduire le filtre de sélection à moins de 200 publicités par page
3. Attendre 30 secondes si un autre validateur tourne en parallèle (Streamlit est mono-session pour certains workers)
4. Vider le cache Streamlit depuis le menu ⋮ > Clear cache

Escalade

Si le freeze dépasse 2 minutes, contactez Thomas Martin avec l'URL de la page et l'heure précise.

Échec d'embedding CLIP sur une correction

Symptôme : Après validation, un bandeau rouge CLIP embedding failed apparaît, la correction n'est pas persistée côté apprentissage.

Cause probable : Image source inaccessible (lien S3 expiré), service CLIP down, ou image corrompue.

Solution :

1. Vérifier que la vignette de la pub s'affiche bien dans l'interface (si non, l'image est le problème)
2. Passer à la correction suivante puis revenir — le re-fetch peut réussir
3. Consulter la santé du service CLIP dans PIGES > Monitoring > Services
4. Sauvegarder la correction manuellement via Forcer la sauvegarde sans embedding (fallback)

Escalade

Si plusieurs corrections consécutives échouent, contactez Thomas Martin ou Marie Dupont : le service CLIP nécessite probablement un redémarrage.

Règle métier non appliquée

Symptôme : Une règle qui devrait bloquer ou ajuster une correction ne se déclenche pas.

Cause probable : Règle inactive, périmètre (régie, format, période) non matchant, ou ordre de priorité écrasé par une règle plus spécifique.

Solution :

1. Ouvrir Paramètres > Règles et vérifier le toggle active
2. Comparer le périmètre de la règle avec le contexte de la correction (régie Plan-net SA, format FULL_PAGE_QUADRI, date)
3. Consulter le champ priorité : une règle à priorité supérieure peut la supplanter
4. Activer le mode Debug règles pour voir la trace d'exécution

Escalade

Si la trace montre que la règle devrait s'appliquer mais que rien ne se passe, contactez Thomas Martin avec la règle ID et la correction ID.

Export CSV vide

Symptôme : L'export CSV des corrections téléchargé depuis Monitoring > Export contient seulement l'en-tête, pas de lignes.

Cause probable : Filtre de période trop restrictif, permission piges:export manquante, ou erreur silencieuse côté worker export.

Solution :

1. Élargir la période d'export (passer à 30 derniers jours)
2. Retirer les filtres secondaires (validateur, régie) pour tester le périmètre global
3. Vérifier votre rôle : seul PIGES_REVIEWER peut exporter par défaut
4. Essayer un format alternatif (JSON) pour isoler un bug de sérialisation CSV

Escalade

Si l'export JSON contient des lignes mais pas le CSV, il s'agit d'un bug export — ouvrir une issue GitHub avec les filtres exacts utilisés.

Contacter le support

Pour toute panne non listée :

• Ouvrir une issue sur GitHub
• Contacter votre administrateur Marie Dupont ou Thomas Martin avec screenshot, URL, heure, ID des ressources concernées