Dépannage

Cette page explique quoi vérifier avant d'escalader un problème. L'idée est de retrouver la cause la plus probable avec quelques contrôles simples.

La page renvoie 404

• vérifier que le slug existe bien dans la navigation de la docs
• vérifier que le fichier MDX existe dans src/content
• vérifier le nom exact du fichier
• vérifier que la route attendue correspond bien à /docs/... ou /guide/...

Le domaine ne répond pas

• vérifier la configuration pnpm domain enable
• vérifier le DNS
• vérifier le port de l'app
• vérifier le reload du reverse proxy
• vérifier que le domaine pointe vers la bonne app (docs ou app)

Les transactions hors ligne ne partent pas

• vérifier que le mode hors ligne est activé
• vérifier que le type est autorisé
• vérifier l'état réseau et la file locale d'actions
• vérifier qu'aucune erreur de validation serveur n'empêche la reprise

Le produit refuse d'être créé

• vérifier unitSize
• vérifier unitByBox
• vérifier les quotas du plan
• vérifier l'authentification utilisateur
• vérifier que le code-barres n'entre pas en conflit avec un article existant

La bonne méthode

1. identifier la page ou la route concernée
2. vérifier le fichier MDX ou l'accès technique concerné
3. remonter au service responsable
4. documenter la cause dans la docs si elle revient souvent
5. ajouter un exemple précis pour éviter que le problème se répète