Troubleshooting

Octavius ne répond pas à mes commandes slash

1. Vérifie que tu es dans un serveur où Octavius est ajouté (pas en DM pour les commandes liées à la guild).
2. Tape /help : si tu vois des commandes, le bot est OK. Si pas de réponse, le bot est probablement hors-ligne — vérifie sur le serveur de support.
3. Permission Discord serveur : vérifie que ton rôle a l'autorisation "Utiliser les commandes slash" (Server Settings > Roles).
4. Permission Octavius : vérifie que Octavius a toujours les permissions listées dans Ajouter Octavius.

Je n'ai pas accès à une commande

Octavius applique une hiérarchie de rôles stricte :

Niveau	Commandes accessibles
👥 Membre	/ia, /rank, /top, /help, /ping, /memory, /play
🛡️ Staff	+ /kick, /mute, /warn, /clear, /closeticket
🔧 Admin	+ /ban, /unban, /lockdown, /setchannel, /setrole, groupes /automod, /antinuke, /analytics, /customcommand, /reactionrole, /ticketconfig, /rankconfig, /aichat
👑 Fondateur	+ /setup, /setservertype, /protect, /setlimit
⚙️ Dev (mère)	+ /restart, /shutdown, /premium set

Si tu pensais avoir accès à une commande, vérifie ton rôle effectif via /userinfo et compare aux rôles configurés via /showconfig.

Le bot ne rejoint pas le vocal

1. Vérifie qu'Octavius a les permissions Connect + Speak dans le salon vocal cible.
2. Vérifie qu'il n'y a pas déjà 1 stream musique actif sur la guild (cap selon le plan : 1 Free/Bronze, 3 Silver, 5 Gold).
3. Re-essaye /play <terme>. Si toujours bloqué, fais /stop pour reset l'état puis re-play.

Mes XP ne montent pas

Vérifie :

• Le cooldown de 60 secondes entre 2 gains XP (1 message tous les 60s).
• Ton message fait plus de 3 caractères (anti-emoji-only).
• Ton message n'est pas une commande-préfixe (!ping = pas d'XP).
• La mémoire est activée pour ce salon (/memory status).
• Le pool Postgres est actif (sinon mode dégradé, les XP ne sont pas persistés — vérifie sur le serveur support).

Mon ticket n'est pas archivé après fermeture

Plusieurs cas :

1. Salon archive non configuré → seul le DM owner est envoyé. Solution : /ticketconfig channel salon:#tickets-archive
2. Bot n'a pas la permission attach_files dans le salon archive. Active dans les permissions du rôle Octavius.
3. DM bloqué par l'utilisateur → le bot post quand même dans le salon archive mais le DM échoue silencieusement.

Sentry / Logs

Les erreurs runtime sont visibles dans :

• bot.log (RotatingFileHandler, 5 MB × 5 fichiers)
• Stdout du container (docker compose logs -f bot api)
• Sentry si SENTRY_DSN configuré

Postgres "POSTGRES_HOST non defini"

C'est un log d'info, pas une erreur. Si tu ne veux pas Postgres (mode JSON-only), c'est normal. Sinon décommente POSTGRES_HOST=127.0.0.1 dans ton .env et fais docker compose up -d postgres.

Redis "REDIS_HOST non defini"

Idem, log d'info. Redis est optionnel en V1, le bot tourne sans.

UnicodeEncodeError 'charmap'

Si tu lances le bot/API en PowerShell sur Windows :

$env:PYTHONIOENCODING="utf-8"
python -X utf8 main.py

Le -X utf8 force le mode UTF-8 même si la console est en cp1252.

/antinuke restore ne fonctionne pas

Possible :

1. Permissions bot insuffisantes : il faut Manage Channels et/ou Manage Roles.
2. Snapshot trop vieux (>rétention du plan) : il a été purgé. Free=12h, Bronze=24h, Silver=48h, Gold=72h.
3. Limite Discord 50 rôles/serveur : si tu as déjà 50 rôles, tu ne peux pas en créer de nouveaux. Supprime des rôles non essentiels avant.

Le dashboard ne charge pas

1. Vérifie que api_central.py tourne (http://127.0.0.1:8000/health).
2. Vide le cache du navigateur (Ctrl+F5).
3. Vérifie que ALLOWED_ORIGINS dans .env contient l'URL du dashboard.
4. Logs API : docker compose logs -f api ou stdout direct.

Autre problème non listé

Rejoins le serveur de support :

• Description claire du problème
• Steps to reproduce
• Capture d'écran si UI
• Plan d'abonnement actif (Free / Bronze / Silver / Gold)
• Server ID (clic droit sur le nom du serveur > Copier l'ID)