MedGuru Docsv0.17.0 Voir le changelog
Skip to content

Dépannage — Public

Cette page regroupe les pannes courantes rencontrées côté utilisateur public et leur résolution. Chaque entrée suit le modèle Symptôme → Cause probable → Solution.

Upload échoue avec erreur 413

Symptôme : Après le drag-and-drop d'un PDF, le bandeau affiche 413 Payload Too Large et l'upload s'arrête.

Cause probable : Le fichier dépasse la limite de 500 Mo imposée par le reverse proxy nginx.

Solution :

  1. Vérifier la taille du fichier localement (ls -lh mag.pdf)
  2. Si > 500 Mo, compresser le PDF (par exemple avec Adobe Acrobat Réduire la taille)
  3. Relancer l'upload
  4. Si le PDF est déjà optimal, scinder le magazine en 2 volumes

Escalade

Si la solution ne fonctionne pas, contactez Marie Dupont avec un screenshot du bandeau d'erreur et l'URL de l'upload.

Détection bloquée en état pending plus de 15 minutes

Symptôme : Un magazine uploadé reste au statut pending dans l'onglet Magazines, sans progression.

Cause probable : Le worker de détection est saturé ou le job a échoué silencieusement en amont.

Solution :

  1. Rafraîchir la page (parfois un simple F5 met à jour le statut)
  2. Vérifier l'heure d'upload : les plages 9h-11h sont les plus chargées
  3. Cliquer sur Relancer la détection dans le menu contextuel du magazine
  4. Patienter 5 minutes supplémentaires

Escalade

Si le statut reste bloqué après relance, contactez votre administrateur avec l'ID du magazine (visible dans l'URL) et l'heure d'upload précise.

Erreur 500 sur la page F06 verify

Symptôme : L'ouverture de la vue F06 verify magazine renvoie Internal Server Error ou une page blanche.

Cause probable : Le magazine a un état de détection corrompu, ou la génération des previews a échoué.

Solution :

  1. Recharger la page (Ctrl+Shift+R pour forcer le cache)
  2. Revenir à la liste Magazines puis rouvrir depuis le détail
  3. Si l'erreur persiste, tenter Relancer la détection depuis Backstage (votre administrateur)

Escalade

Contactez Marie Dupont avec l'ID du magazine, l'URL complète de la page en erreur et l'heure d'apparition.

Export PDF cassé ou tronqué

Symptôme : Le PDF exporté s'ouvre mais certaines pages sont blanches, ou le téléchargement s'interrompt à mi-parcours.

Cause probable : Timeout du worker d'export côté serveur pour les gros magazines, ou souci réseau local.

Solution :

  1. Vérifier votre connexion réseau (WiFi stable, pas de coupure)
  2. Relancer l'export en choisissant uniquement une plage de pages (ex. 1-50)
  3. Si OK en partiel, exporter les autres plages successivement
  4. Fusionner les PDF localement via un outil comme pdftk

Escalade

Si même l'export partiel échoue, contactez Marie Dupont avec l'ID du magazine et l'heure des tentatives.

SuperFilter renvoie une liste vide

Symptôme : Malgré des filtres qui semblent légitimes, la recherche renvoie 0 résultat.

Cause probable : Les filtres sont trop restrictifs, ou l'index de recherche est désynchronisé.

Solution :

  1. Retirer les filtres un par un pour isoler celui qui tue les résultats
  2. Élargir la période (passer de 7 jours à 90 jours)
  3. Vérifier la graphie : FULL_PAGE_QUADRIfull page quadri côté filtre exact
  4. Utiliser le bouton Réinitialiser les filtres puis relancer

Problème de connexion

Symptôme : L'écran de login refuse vos identifiants ou boucle sans passer à l'app.

Cause probable : Session expirée, cookie corrompu, ou compte désactivé.

Solution :

  1. Vider les cookies du domaine MedGuru (DevTools > Application > Cookies)
  2. Essayer en navigation privée pour isoler un cache agressif
  3. Utiliser le lien Mot de passe oublié si l'erreur indique Invalid credentials
  4. Vérifier avec Marie Dupont si votre compte est bien actif

Escalade

Pour une boucle de redirection persistante, contactez Marie Dupont avec un screenshot de l'URL finale et l'heure de tentative.

Contacter le support

Pour toute panne non listée ici, ouvrez une issue sur GitHub ou contactez votre administrateur Marie Dupont avec : screenshot, URL, heure précise, ID de ressource concerné.

Version v0.17.0 — Changelog