This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Mes erreurs frequentes et comment les corriger

Depannage personnel

Les blocages qui reviennent et la bonne reaction

Cette page t’aide a garder ton calme quand quelque chose ne marche pas. Le but n’est pas de tout memoriser, mais de reconnaitre les situations classiques et de savoir par quoi commencer.

❌ Le site local ne s’ouvre pas

Verifier si le serveur de dev tourne, si le bon port est utilise et si le terminal n’a pas plante.

🖼️ Des images manquent

Verifier les chemins, les uploads, les assets et si la version locale correspond bien a la version en ligne.

🚀 Le deploiement passe mais le rendu ne suit pas

Verifier le healthcheck, les assets, le cache navigateur, la home et les pages critiques en reel.

🔐 Je crois etre admin mais je ne peux pas agir

Verifier le role, les droits reels et si l’action est reservee au super administrateur.

🧭 La carte n’affiche pas ce que j’attends

Verifier le style charge, les filtres actifs, la source carto et le niveau de zoom.

📚 Le wiki ne ressemble pas au theme attendu

Verifier la synchronisation du CSS Forgejo et redemarrer l’instance locale si besoin.

🧠 La bonne methode

Devant un bug, ne saute pas tout de suite a la conclusion. Commence par identifier: est-ce un probleme local, un probleme de code, un probleme d’assets, un probleme de role, ou un probleme de deploiement ?

🛟 Mon reflexe de reprise

1. je regarde ce qui est visible et reel ;
2. je verifie si le probleme existe en local, en preprod ou en prod ;
3. je controle les messages, les logs et le healthcheck ;
4. je corrige le plus petit niveau utile ;
5. je reteste tout de suite sur le vrai parcours.

📌 Ce que je dois retenir

Une erreur n’est pas une preuve que je ne comprends pas mon projet. C’est souvent juste un signal qui me dit ou reprendre le fil: environnement, droits, assets, deploiement ou logique metier.