Discobot — la plateforme de bot Discord

1. 1

   Connexion

   L’utilisateur se connecte avec Discord, puis autorise le bot sur un serveur ; le quota de son offre est vérifié avant l’autorisation et au retour.

2. 2

   Configuration

   Il active un plugin dans le tableau de bord et règle ses options, validées par le schéma du plugin.

3. 3

   Événement

   Un événement Discord — arrivée d’un membre, réaction, commande — arrive dans le worker du bot.

4. 4

   Décision

   Le bot appelle l’API Laravel avec son jeton ; le plugin PHP concerné renvoie la liste des actions à effectuer.

5. 5

   Exécution

   L’exécuteur réalise les actions avec discord.js : envoyer un message, ajouter un rôle, ouvrir un salon de ticket…

6. 6

   Retour

   Le résultat de chaque action remonte à Laravel, qui le journalise et le diffuse en direct au tableau de bord.

Les entités principales, leurs champs clés et leurs relations.

Langages

PHP 8.3, JavaScript (modules ES)

Framework

Laravel 12

Front

Livewire 3, Alpine 3, Tailwind 4, Vite 7

Bot

Node.js, discord.js 14, Express 5, node-cron ; le bot tourne dans un worker thread

Base de données

MariaDB 11 en développement, MySQL 8 en CI

Files et cache

Files Laravel default et discord, Redis 7

Temps réel

Laravel Reverb, six événements diffusés

Recherche

Laravel Scout et Meilisearch sur le journal des actions

Authentification

OAuth2 Discord via Socialite, Sanctum

Paiement

Stripe Checkout en abonnement, webhook vérifié, période de grâce

Hébergement

Docker multi-étapes, Docker Compose (application, file, scheduler, Reverb, bot), image publiée sur GHCR en amd64 et arm64

CI/CD

3 workflows GitHub Actions sur runner auto-hébergé : PHPUnit, Pest, tests Node, Pint, audits Composer et npm

Tests

PHPUnit 11 et Pest 3 (environ 800 tests), Playwright (15 tests), node --test (15 tests)

Qualité

Pint, documentation d’API Scribe, couverture Codecov

Observabilité

Sentry, PostHog, paquet d’observabilité maison, Pail

Sécurité

Jeton Bearer partagé entre Laravel et le bot, comparé en temps constant des deux côtés ; limitation de débit ; signature Ed25519 des interactions Discord vérifiée

• Bienvenue et départ

  Messages personnalisés à l’arrivée et au départ des membres.

• Rôles par réaction

  Un rôle attribué ou retiré selon la réaction choisie.

• Tickets

  Catégories, prise en charge et transcriptions.

• Suivi des invitations

  Qui a invité qui, invitations douteuses repérées, top 10.

• Annonces

  Rédigées dans une fenêtre modale Discord.

• Nettoyage de salons

  Suppression de messages par lot.

1. Mauvaise version de discord.js

   ProblèmeLe code appelait des API de la v14 sur la v13 installée, et chaque erreur était avalée sans bruit.

   SolutionMigration vers la v14 et tests Node exécutés contre le vrai discord.js en CI.

2. Quota contournable par l’URL

   ProblèmeLa limite de l’offre Free n’existait qu’à l’affichage.

   SolutionContrôle côté serveur, avant l’autorisation et au retour d’OAuth.

3. Bot jamais relancé

   ProblèmeCarbon 3 renvoie un écart signé : un bot déconnecté semblait l’être depuis une durée négative.

   SolutionÉcart calculé dans le bon sens, couvert par un test.

4. sleep() bloquant

   ProblèmeUn plugin pouvait immobiliser un worker PHP jusqu’à cinq minutes.

   SolutionEnvoi différé confié à un job en file.

5. Tickets jamais enregistrés

   ProblèmeLa table pointait vers une table supprimée lors de la refonte.

   SolutionClé étrangère corrigée et nouvelles routes d’enregistrement.

1. Octobre 2025 Premier commit, projet de place de marché
2. Janvier 2026 De 20 à 6 plugins, journaux centralisés
3. Février 2026 ADR 001 : bot plateforme unique
4. Février 2026 Offres Free et Pro avec Stripe
5. Avril 2026 Stack Docker Compose
6. Septembre 2026 Migration vers discord.js 14

877

commits

146

migrations

35

types d’action dans le bot

~800

tests PHP

Relevé dans le code source et l’historique Git du projet le 8 octobre 2026. Aucun chiffre d’usage ou de revenu n’est publié.