Beta 1.3 (v0.1.3)

🚀 Kepler Bot - Beta 1.3 (v0.1.3)

Codename: Kepler Beta
Date: 5 janvier 2026
Type: Beta Release

Cette release se concentre sur trois axes majeurs : statistiques avancées, conformité RGPD, et optimisations techniques.

---

✨ Nouveautés principales

📊 Système de statistiques avancé

• Nouvelle commande /graph (owner uniquement) avec 5 types de graphiques :
  • 📈 Commandes les plus utilisées (top 15, 30 derniers jours)
  • 📨 Volume de messages par jour (historique 30 jours)
  • 👥 Utilisateurs actifs par jour (timeline 30 jours)
  • 📊 Tendances hebdomadaires (comparaison semaine actuelle vs précédente)
  • 🌍 Vue d'ensemble globale (métriques clés)
• Tracking automatique en temps réel des commandes et messages
• Agrégation quotidienne avec métriques détaillées
• Nouvelle commande /botstats : Alias amélioré de l'ancienne commande stats

🎮 Nouvelles commandes de jeux

Commande /couple ⭐

• Génération d'images de couples aléatoires avec avatars Discord
• Descriptions romantiques variées et personnalisées
• Optimisation progressive : Canvas → Jimp → Sharp (performance maximale)
• Support des avatars GIF et formats variés
• Cache intelligent pour éviter les rate limits Discord
• Optimisation WebP : Réduction de 60-70% de la bande passante

Système de comptage /count ⭐

• Mini-jeu de comptage par canal avec progression
• Suppression automatique des messages incorrects
• Épinglage du message d'initialisation
• Gestion des erreurs Discord API améliorée

Commande /qrcode ⭐

• Générateur de QR codes instantané
• Support textes et URLs
• Format optimisé pour Discord

🎯 Commandes de statistiques de jeux ⭐

• /minecraft : Stats Minecraft par username (UUID, skin, historique)
• /dota2 : Stats Dota 2 par username ou Steam ID (MMR, winrate, héros favoris)
• /osu : Stats osu! par username (rank, pp, accuracy, top plays)
• Recherche intelligente avec fallback username/ID
• Avatars optimisés (Visage Surgeplay pour Minecraft)
• Gestion d'erreurs améliorée avec messages ephemeral

🔐 RGPD & Protection des données

• Nouvelle commande /mesdonnees pour tous les utilisateurs :
  • voir : Résumé complet de vos données stockées
  • exporter : Export JSON via Pastebin (portabilité des données)
  • supprimer : Effacement de toutes vos données personnelles
  • info : Informations sur la conservation des données
• Conformité complète : accès, portabilité, effacement, limitation
• Purge automatique : 90 jours pour les stats, 2 ans pour la modération
• Couverture totale : stats, anniversaires, rappels, modération, participations

🎁 Système de giveaways amélioré

• Ajout du timestamp dans le footer pour clarté
• Durée obligatoire pour éviter les giveaways infinis
• Support des rôles requis pour participer
• Système de fin automatique avec sélection de gagnants

📋 Commandes unifiées

• /info : Commande unique avec sous-commandes

  • serveur : Informations détaillées du serveur
  • utilisateur : Profil utilisateur complet
  • canal : Détails du canal
  • role : Informations sur un rôle
  • Emojis et formatage améliorés

• /sanctions : Fusion de /modinfo et /warnings

  • Historique complet des sanctions
  • Affichage des sanctions actives
  • Liste des avertissements
  • Interface unifiée et claire

🏷️ Système de versioning

• Affichage de la version dans /help et /botstats
• Version visible dans le statut Discord du bot
• Changelog structuré avec détails par version dans changelogs/
• Configuration centralisée dans version.json

---

🔧 Améliorations & Optimisations

⚡ Images WebP (commande /couple)

• Réduction de 60-70% de la bande passante :
  • Format PNG → WebP (compression optimale)
  • Avatars 512px → 128px (qualité suffisante)
  • ~27KB → ~10-15KB par image générée
• Cache intelligent : 5 minutes de TTL, évite les regénérations inutiles

🏓 Latence améliorée (commande /ping)

• Mesure round-trip réelle avec calcul précis
• Gestion des cas -1ms (websocket non initialisé)
• Layout optimisé pour tous les appareils

🖥️ Compatibilité Deno

• Remplacement de process.cpuUsage() par Deno.loadavg()
• Plus de warnings dans la console
• Performance système correctement affichée

---

🐛 Corrections

Supabase & Base de données

• ✅ Fix RLS Supabase : Policies bloquant les inserts de stats

Commandes de jeux

• ✅ Fix /couple :

  • Correction de la syntaxe Sharp blend
  • Import correct de Buffer depuis node:buffer
  • Utilisation correcte de l'API Jimp (fromBuffer, create)
  • Gestion des avatars GIF
  • Fallback fetch si cache vide
  • Évitement des rate limits avec cache de presences
  • Optimisation du processus de génération d'images
  • Parallélisation du téléchargement des avatars

• ✅ Fix /count :

  • Suppression uniquement des messages sans numéro en début
  • Gestion des erreurs Discord API
  • Messages d'erreur en ephemeral

• ✅ Fix /qrcode : Formatage correct des URLs dans l'embed

Statistiques de jeux

• ✅ Fix gamestats :
  • Conversion des nombres en strings pour Discord
  • Utilisation de editReply dans les handlers d'erreur
  • Avatars Minecraft via Visage Surgeplay
  • Recherche Dota 2 par username ou ID
  • Meilleure gestion des erreurs de recherche

Performance & Affichage

• ✅ Fix latence -1ms : Gestion correcte des valeurs invalides
• ✅ Fix layout embeds : Suppression des spacer fields forcés
• ✅ Fix warning Deno : Compatibilité process.cpuUsage()

Système

• ✅ Fix footer : Édition et amélioration des footers d'embeds

---

📚 Documentation

• ✅ 5 READMEs complets : commands/, database/, utils/, events/, docs/
• ✅ Guide de release : RELEASE.md avec workflow Dokploy
• ✅ Changelogs détaillés : Dossier changelogs/ avec versionning
• ✅ Index des commandes : Table complète des 40+ commandes

---

📊 Base de données

Nouvelles tables :

• command_stats : Tracking des commandes exécutées
• message_stats : Tracking des messages envoyés
• daily_stats : Agrégation quotidienne par serveur
• global_daily_stats : Métriques globales journalières

RLS renforcé sur toutes les 15 tables Supabase.

---

🎮 Commandes disponibles

45+ commandes réparties en 5 catégories :

🛡️ Administration (8)

• /graph - Statistiques avancées avec graphiques ⭐ NOUVEAU
• /giveaway - Système de giveaways avec rôles ⭐ AMÉLIORÉ
• /annonce, /audit
• /bdayconfig, /logconfig, /moderationconfig, /muteroleconfig

🎲 Jeux (10)

• /couple - Générateur d'images de couples ⭐ NOUVEAU
• /count - Mini-jeu de comptage ⭐ NOUVEAU
• /minecraft - Stats Minecraft ⭐ NOUVEAU
• /dota2 - Stats Dota 2 ⭐ NOUVEAU
• /osu - Stats osu! ⭐ NOUVEAU
• /puissance4, /8ball, /chifoumi, /coinflip, /meme, /blague, /golem

👮 Modération (11)

• /sanctions - Historique unifié (fusion modinfo + warnings) ⭐ AMÉLIORÉ
• /ban, /unban, /kick
• /mute, /unmute, /timeout, /untimeout
• /warn, /clear

🛠️ Utilitaires (12)

• /info - Commande unifiée (serveur/utilisateur/canal/role) ⭐ AMÉLIORÉ
• /mesdonnees - Gestion RGPD complète ⭐ NOUVEAU
• /qrcode - Générateur de QR codes ⭐ NOUVEAU
• /birthday, /reminder, /reminders
• /lyrics, /genpass, /minecraft-uuid, /rolelist

📖 Générales (4)

• /botstats - Stats techniques du bot ⭐ NOUVEAU
• /help - Aide interactive
• /ping - Latence améliorée ⭐ AMÉLIORÉ
• /credits - Crédits et informations

---

🔗 Liens utiles

• 📖 Changelog détaillé
• 📋 Liste des commandes
• 🗄️ Structure base de données
• 🚀 Guide de release

---

📦 Installation & Déploiement

Avec Dokploy (recommandé)

# 1. Sélectionner le tag v0.1.3 dans l'interface Dokploy
# 2. Cliquer sur "Deploy"
# 3. Dokploy build et déploie automatiquement

Avec Docker

docker pull ghcr.io/antoww/kepler-bot:v0.1.3
docker run -d --name kepler-bot --env-file .env ghcr.io/antoww/kepler-bot:v0.1.3

Variables d'environnement requises

TOKEN=votre_token_discord
SUPABASE_URL=votre_url_supabase
SUPABASE_KEY=votre_clé_supabase
BLAGUES_API_TOKEN=votre_token_blagues_api
PASTEBIN_API_KEY=votre_clé_pastebin

---

⚠️ Notes de migration

Pour les utilisateurs

• La commande /mesdonnees est maintenant disponible pour gérer vos données
• Les stats anciennes (>90 jours) seront automatiquement purgées
• Aucune action requise, tout est automatique ✅

Pour les administrateurs

• Les nouvelles tables sont créées automatiquement au démarrage
• Les graphiques nécessitent ~24h de données pour être pertinents
• Le statut Discord affiche maintenant "v0.1.3 • Kepler Beta"

---

🎯 Prochaines étapes (v0.2.0)

• Dashboard web pour visualiser les statistiques
• API REST pour les stats
• Système de backup automatique
• Export des graphiques en images
• Cache Redis pour optimiser les performances

---

💬 Support

• Issues : GitHub Issues
• Discord : Serveur de support disponible
• Documentation : Consultez les READMEs dans chaque dossier

---

Merci d'utiliser Kepler Bot ! 🚀

---

Checksums

Version : 0.1.3
Codename : Kepler Beta
Date : 2026-01-05
Docker Image : ghcr.io/antoww/kepler-bot:v0.1.3

v1.2.0-beta-1.2 — Notes de version

v1.2.0-beta-1.2 — Notes de version

Résumé

• Release beta 1.2 : améliorations de la fiabilité, refactor des logs, nouveaux utilitaires et corrections de bugs.

Nouveautés majeures

• Nouvelle commande: ajout de lyrics pour rechercher/parcourir les paroles directement depuis le bot.
• Archivage & fiabilité: ajout d’un système d’archivage de messages et d’un cache d’archive pour réduire les pertes lors des suppressions massives.
• Retry helper: mécanisme centralisé de retry pour résoudre les problèmes réseau intermittents.
• Docs: ajout d’un guide de résolution des problèmes réseau / retry dans docs/.

Améliorations

• Refactor logs: refonte importante du logging d’événements (guild, member, message, voice, misc) pour fiabilité et lisibilité.
• Moderation & reminders: consolidation des gestionnaires de modération et du gestionnaire de rappels pour une meilleure consistance.
• Divers ajustements et nettoyages de commandes (clear, stats, modinfo, etc.).

Corrections

• Correction de plusieurs cas de perte d’événements et d’erreurs lors du traitement de suppressions massives de messages.
• Améliorations de la robustesse du bot face aux erreurs API et aux timeouts.

Changements notables / Breaking

• utils/wowApiClient a été supprimé/retiré — si vous utilisiez ce client, migrez vers une implémentation externe ou restaurez depuis l’historique.
• Aucun changement de configuration serveur attendu ; redémarrez simplement le bot après le déploiement.

Instructions de déploiement rapide

• Tag de release : v1.2.0-beta-1.2
• Après pull + restart du service, vérifier les logs d’événements et les jobs de rappel.

Crédits

• Merci aux contributeurs de la branche Beta-1.2 pour les ajouts et la revue.

Changelog succinct (exemples)

• Ajout: système d’archivage, lyrics, retryHelper
• Modifié: refactor des logs et gestionnaires d’événements
• Supprimé: utils/wowApiClient

🚀 Beta V1.1 - Nouvelle commande d'audit, timeout/untimeout et améliorations diverses

📋 Résumé

Cette mise à jour Beta V1.1 apporte une nouvelle commande d'audit complète pour vérifier la sécurité du serveur, des commandes de modération améliorées pour les timeouts, ainsi que plusieurs améliorations sur les commandes existantes.

✨ Nouvelles fonctionnalités

🔍 Commande Audit

• Nouvelle commande `/audit` pour effectuer des vérifications de sécurité du serveur
• Analyse détaillée des permissions des canaux (texte et vocal)
• Vérification des permissions risquées sur @everyone
• Contrôles des permissions de gestion des canaux et rôles
• Interface interactive avec menu de sélection pour affichage résumé ou détaillé
• Traductions françaises des permissions pour meilleure lisibilité

⏱️ Gestion des Timeouts

• Nouvelle commande `/timeout` pour mettre en timeout un membre
• Nouvelle commande `/untimeout` pour retirer un timeout
• Historique des timeouts dans la commande `/modinfo`
• Statistiques de timeout affichées dans les informations de modération
• Retours utilisateur améliorés avec `editReply`

🔧 Améliorations

Commandes existantes

• `/credits` : Ajout de champs supplémentaires et formatage inline amélioré
• `/stats` : Support Deno et amélioration du calcul de la mémoire totale
• `/help` : Ajout de logs pour la récupération des commandes globales et de guilde
• `/modinfo` : Ajout du compteur d'actions de timeout dans l'historique de modération

🗑️ Suppressions

• Suppression de la commande `/wowguilde` et fonctionnalités associées

🐳 Configuration Docker

• Mise à jour du nom du conteneur vers `kepler-bot-prod` dans docker-compose
• Mise à jour de la version du bot dans config.json (Beta V1.1)

📊 Statistiques

• 9 fichiers modifiés
• 912 lignes ajoutées (+)
• 176 lignes supprimées (-)
• 22 commits

🔄 Type de changements

• Nouvelles fonctionnalités
• Améliorations
• Suppressions
• Configuration

✅ Checklist

• Le code suit les standards du projet
• Les commandes ont été testées
• La version a été mise à jour dans config.json
• La configuration Docker est à jour"

Beta v1.0

🚀 Version Beta - Nouvelles fonctionnalités et améliorations d'interface

📈 Statistiques Globales

• 32 fichiers modifiés avec +1767 additions et -218 suppressions
• Ajout de nouvelles fonctionnalités majeures et refactorisation d'interface utilisateur

---

🆕 Nouvelles Fonctionnalités Principales

🛡️ Système de Sanctions Avancé

• Nouveau fichier : commands/moderation/sanctions.ts (+288 lignes)
• Fonctionnalités :
  • Visualisation paginée de toutes les sanctions d'un utilisateur
  • Suppression de sanctions par numéro avec raison
  • Interface interactive avec boutons de navigation
• Suppression : commands/moderation/unwarn.ts (remplacé par le nouveau système)

⏰ Système de Rappels Complet

• Nouveau gestionnaire : events/core/reminderManager.ts (+182 lignes)
• Commandes étendues :
  • commands/utilitaires/reminder.ts : Parsing avancé de durée et validation
  • commands/utilitaires/reminders.ts : Gestion complète des rappels (+214 lignes)
• Fonctionnalités :
  • Rappels persistants avec base de données
  • Interface de gestion avec boutons interactifs
  • Vérification automatique toutes les minutes

🎮 Intégration API World of Warcraft

• Nouveau client API : utils/wowApiClient.ts (+242 lignes)
• Configuration : Intégration avec Raider.IO pour données de guildes
• Fonctionnalités :
  • Normalisation intelligente des noms de royaumes français
  • Récupération de données de guildes avec fallback
  • Support des serveurs connectés
• Documentation :
  • docs/BLIZZARD_API_SETUP.md : Guide de configuration API Blizzard
  • docs/DOKPLOY_BLIZZARD_SETUP.md : Guide de déploiement

---

🎨 Améliorations d'Interface Utilisateur

📱 Standardisation des Embeds

• Suppression systématique des champs auteur dans tous les embeds
• Commandes affectées : 8ball, chifoumi, coinflip, credits, ping, channelinfo
• Résultat : Interface plus propre et cohérente

🎮 Amélioration des Jeux

• Puissance 4 : Utilisation de mentions utilisateur au lieu des noms
• Autres jeux : Interface unifiée et plus moderne

📊 Nouvelles Métriques

• Stats : Ajout d'informations mémoire et CPU
• Help : Simplification des libellés de boutons

---

🔧 Améliorations Techniques

🗃️ Base de Données

• Supabase : Améliorations de la gestion des connexions
• Nouvelles tables : Support pour rappels et sanctions étendues

🐳 Déploiement

• Docker Compose : Mise à jour du nom de conteneur pour la production
• Variables d'environnement : Support des credentials API Blizzard

📝 Modération

• Ban/Kick : Envoi de messages privés aux utilisateurs
• Clear : Amélioration du formatage des messages
• ModInfo : Interface étendue avec plus d'informations

---

🛠️ Correctifs et Optimisations

🔄 Refactorisation des Interactions

• InteractionCreate : Gestion améliorée des interactions (+177 lignes)
• Gestionnaire de modération : Intégration avec le nouveau système de sanctions

⚙️ Configuration

• Deno.json : Restauration des types pour un meilleur support TypeScript
• Variables d'environnement : Exemple étendu avec nouvelles APIs

---

🎯 Impact Utilisateur

✅ Pour les Modérateurs

• Interface de sanctions plus intuitive et complète
• Meilleure traçabilité des actions de modération
• Outils de gestion plus puissants

✅ Pour les Utilisateurs Généraux

• Interface plus propre et moderne
• Système de rappels personnel
• Informations WoW enrichies
• Expérience de jeu améliorée

✅ Pour les Administrateurs

• Métriques système étendues
• Configuration API simplifiée
• Documentation complète

---

🔍 Fichiers Principaux Modifiés

Nouvelles Fonctionnalités

• commands/moderation/sanctions.ts - Nouveau système de gestion des sanctions
• commands/utilitaires/reminders.ts - Gestion des rappels
• events/core/reminderManager.ts - Gestionnaire automatique des rappels
• utils/wowApiClient.ts - Client API World of Warcraft

Documentation

• docs/BLIZZARD_API_SETUP.md - Guide de configuration API
• docs/DOKPLOY_BLIZZARD_SETUP.md - Guide de déploiement

Améliorations Existantes

• Refactorisation complète des embeds pour une interface plus cohérente
• Amélioration des commandes de modération avec notifications utilisateur
• Extension du système de statistiques avec métriques système

---

Cette version beta apporte des améliorations significatives en termes d'expérience utilisateur, de fonctionnalités et de maintenabilité du code, tout en préservant la stabilité existante.

v0.1.0-alpha

Release Alpha 1.0

First build of Kepler-Bot.

Few features are available :

• Password generator
• upload to imgur
• ping
• credits
• hello

I hope you'll enjoy this.