Depannage

Cette page couvre les situations les plus frequentes. Pour chaque probleme : symptome, cause probable, solution.

Le site est inaccessible

Symptome — https://espaceclient.qovans.com ne repond pas ou affiche une erreur.

Diagnostic :

# 1. Verifier que les conteneurs tournent
docker compose -f docker-compose.prod.yml ps

# 2. Verifier Caddy
sudo systemctl status caddy

# 3. Tester les ports en local
curl http://localhost:3000  # Frontend
curl http://localhost:8000/health  # Backend

Solutions :

Les produits ne s'affichent pas

Symptome — le catalogue est vide ou les prix sont absents.

Diagnostic :

# Le VPN est-il actif ?
sudo systemctl status openvpn-client@audaxium

# Cegid repond-il ?
curl http://localhost:8000/api/test-cegid

# Ping Cegid directement
ping -c 2 192.168.4.110

Solutions :

Le catalogue utilise un cache local PostgreSQL. Meme sans VPN, les produits deja synchronises restent visibles. Seuls les stocks en temps reel et les commandes necessitent Cegid.

Erreur 502 Bad Gateway le weekend

Symptome — le site fonctionne mais certaines pages (stocks, commandes, prix temps reel) affichent des erreurs.

Cause — le serveur Cegid (192.168.4.110) est parfois arrete le weekend pour maintenance.

Solution — rien a faire. Le site continue de fonctionner en mode degrade (catalogue cache visible, mais pas de stocks en temps reel ni de creation de commande). Tout revient a la normale le lundi matin.

Espace disque plein

Symptome — erreurs aleatoires, logs qui ne s'ecrivent plus, builds qui echouent.

Diagnostic :

df -h
docker system df

Solutions :

# Nettoyer les images Docker inutilisees
docker image prune -f

# Nettoyer tout (images, volumes orphelins, cache build)
docker system prune -f

# Verifier les logs Docker
du -sh /var/lib/docker/containers/*/

Si le probleme revient souvent, ajouter la rotation des logs (voir Monitoring).

Migration de base echoue

Symptome — alembic upgrade head echoue avec une erreur.

Diagnostic :

# Voir la migration actuelle
docker exec qovans-backend alembic current

# Voir l'historique
docker exec qovans-backend alembic history --verbose | head -20

Solutions :

En dernier recours, restaurer un backup PostgreSQL et reappliquer les migrations (voir Sauvegardes).

Le backend ne demarre pas

Symptome — qovans-backend apparait comme restarting dans docker ps.

Diagnostic :

docker logs qovans-backend --tail 50

Causes frequentes :

Les emails ne partent pas

Symptome — les utilisateurs ne recoivent pas les emails (reset password, 2FA, confirmation commande).

Diagnostic :

# Verifier la cle API Brevo
grep BREVO_API_KEY .env.prod

# Chercher les erreurs email dans les logs
docker logs qovans-backend | grep -i "email\|brevo\|smtp" | tail -20

Solutions :