VulCode

Boty Discord

Boty produkcyjne obsługujące serwery Discord kilku marek. Ticketowanie z pingiem zespołu, powitania nowych członków, weryfikacja adresów e-mail i porządkowanie ról - wszystko dopasowane do konkretnego serwera. Odciążają obsługę i pilnują higieny społeczności bez ręcznej roboty.

Boty Discord

Wprowadzenie

Społeczności marek, dla których działają te boty, żyją na Discordzie, a nie na stronie. To tam trafia nowy klient, tam otwiera zgłoszenie, tam czeka na rolę dającą dostęp do właściwych kanałów. Przy rosnącej liczbie członków ręczne ogarnianie ticketów, powitań i ról po prostu przestaje się spinać - ktoś musi być na miejscu, patrzeć i klikać, a to nie skaluje się z liczbą osób.

Zamiast pisać jednego uniwersalnego bota do wszystkiego, zbudowaliśmy jeden rdzeń i zestaw modułów, z których składa się każdego bota osobno. Każdy serwer ma własną rolę i konfigurację, ale logika żyje w jednym miejscu.

Dlaczego nie jeden bot do wszystkiego

Kuszące jest napisać jednego bota, który robi całą robotę na wszystkich serwerach. Problem w tym, że każdy serwer ma trochę inne potrzeby: inny zespół do pingu przy tickecie, inną ścieżkę wejścia nowego członka, inne role i inny próg weryfikacji. Uniwersalny bot, który ma obsłużyć je wszystkie, z czasem robi się choinką z flag, w której nikt nie chce niczego ruszać, bo nie wiadomo, co jeszcze od tego zależy.

Druga pułapka to współdzielony stan. Jeden proces obsługujący wszystkie serwery naraz to jeden punkt awarii - błąd w logice ticketów potrafi położyć powitania na zupełnie innym serwerze. A im więcej serwer wozi kodu, którego nie używa, tym trudniej cokolwiek w nim bezpiecznie zmienić.

Jeden rdzeń, wiele cogów

Poszliśmy w drugą stronę: jeden rdzeń z modułami, które w ekosystemie Discorda nazywają się cogami, a każdy bot to zestaw włączonych cogów. Serwer ticketowy bierze cog ticketów, serwer, który tego nie potrzebuje, po prostu go nie włącza.

Monolit kontra rdzeń z cogami

AspektJeden bot do wszystkiegoRdzeń z cogami
Nowa funkcjakolejny if w środkunowy, odizolowany cog
Serwer bez danej funkcjii tak wozi jej kodpo prostu jej nie włącza
Awaria jednego modułuryzyko dla całościograniczona do cogu
Poprawka logikiszukanie w monoliciejedno miejsce, wszędzie gdzie cog włączony

Boty i ich role

W praktyce ekosystem to odrębne boty, z których każdy robi jedną rzecz porządnie. Ticketowy otwiera wątki zgłoszeń i pinguje właściwy zespół, żeby zgłoszenie nie utknęło w próżni. Powitalny prowadzi nowego członka przez pierwsze kroki. Weryfikacyjny potwierdza adres e-mail przy wejściu. Porządkowy pilnuje higieny ról i przydziela je automatycznie.

Ten podział nie jest kosmetyczny. Każdy bot ma własny zakres uprawnień i własny stan, więc awaria jednego nie pociąga reszty, a zmiana w jednym nie wymaga myślenia o pozostałych. Wspólny jest tylko rdzeń - to, jak cog wpina się do bota, jak czyta konfigurację i jak gada z API.

Boty i ich role

BotCo robiKluczowy cog
Ticketowyotwiera wątki zgłoszeń i pinguje właściwy zespółtickets
Powitalnyonboarding i pierwsze kroki nowego członkawelcome
Weryfikacyjnypotwierdzenie adresu e-mail przy wejściumailcheck
Porządkowyautomatyczne przydzielanie i higiena rólroles

Jak wygląda cog

Cog to zamknięta jednostka: własne komendy, własne nasłuchy, własny stan. Wpinasz go do bota jedną linią, wypinasz tak samo. Nie ma globalnego splątania - cog ticketów nie wie nic o cogu ról i nie musi. Poniżej wycinek weryfikacji: nowy członek dostaje rolę oczekującego i prompt do potwierdzenia adresu, zanim zobaczy resztę serwera.

verify.py · python
class VerifyCog(commands.Cog):
    def __init__(self, bot):
        self.bot = bot

    @commands.Cog.listener()
    async def on_member_join(self, member):
        pendingRole = member.guild.get_role(self.pendingRoleId)
        await member.add_roles(pendingRole)
        await self.sendVerifyPrompt(member)

Weryfikacja e-mail przy wejściu to nie ozdoba. Najtańsza obrona przed falą fake-kont to postawienie progu, który boty rejestrujące masowo muszą przejść - potwierdzenie realnego adresu odsiewa większość z nich, zanim w ogóle zobaczą kanały. Rola oczekującego trzyma nowego członka za drzwiami do momentu potwierdzenia.

Co zostaje po stronie utrzymania

Największy zysk nie jest widoczny na serwerze, tylko w tym, jak się te boty utrzymuje. Poprawka w logice ticketów idzie w jednym miejscu i trafia wszędzie tam, gdzie ten cog jest włączony - nie przepisujesz jej w każdym bocie osobno i nie zapominasz o jednym serwerze. Żaden serwer nie wozi kodu, którego nie używa, więc jego konfiguracja jest dokładnie tak złożona, jak jego realne potrzeby.

Kolejny serwer nie oznacza pisania kolejnego bota od zera. Składa się go z tego, co już jest: bierzesz cogi, które pasują, ustawiasz konfigurację i tyle. To jest różnica między osobnymi projektami a jednym ekosystemem, który rośnie przez dokładanie modułów, a nie przez mnożenie kodu.

Pytania o Boty Discord

Więcej projektów

Inne realizacje z tej samej kategorii - zobacz, jak podchodzimy do podobnych wyzwań.

Masz podobny projekt?

Napisz do nas - wycena jest bezpłatna i wraca w godzinę.