EzBro

EzBro Nedir? EzBro, Discord sunucularının tüm yönetim, güvenlik, otomasyon ve topluluk ihtiyaçlarını tek bir çatı altında karşılamak amacıyla sıfırdan tasarlanmış, tam kapsamlı bir Discord bot ve web yönetim platformudur. Node.js üzerinde çalışan güçlü bir bot altyapısı ile React + TypeScript tabanlı modern bir web panelinden oluşur. Hem teknik derinliği hem de kullanıcı odaklı tasarımıyla EzBro, Discord ekosistemi için üretilmiş en bütünleşik Türkçe platformlardan biridir.

Yalnızca bir bot değil; bir ekosistemdir. Sunucu koruma kalkanından yapay zeka destekli sohbet sistemine, gelişmiş moderasyondan müzik ve oyun sistemlerine, detaylı sicil takibinden gerçek zamanlı web dashboard'una kadar uzanan 100'ü aşkın özelliğiyle EzBro, Discord sunucu yöneticilerinin hayatını kökten kolaylaştırmayı hedefler.

Teknik Altyapı EzBro'nun teknik temeli, yüksek ölçeklenebilirlik ve dayanıklılık göz önünde bulundurularak inşa edilmiştir:

Bot Katmanı: Discord.js v14 ile yazılmış, tüm Discord Intent'lerini aktif kullanan bot motoru; 100'ü aşkın slash komutu, 68 event handler'ı ve çift katmanlı bir veritabanı mimarisine sahiptir. CroxyDB (MongoDB adaptörlü anahtar-değer deposu) basit ve hızlı erişimler için kullanılırken; Mongoose şemaları karmaşık, sorgulanabilir ve ilişkisel veriler için devreye girer. Her iki katman da aynı MongoDB instance'ına bağlanarak tutarlılık sağlar.

Web Dashboard: Express.js tabanlı REST API sunucusu (32 ayrı route namespace'i), Socket.IO ile gerçek zamanlı iletişim altyapısı, JWT + Discord OAuth2 ile güvenli kimlik doğrulama ve React + TypeScript + Vite ile oluşturulmuş 129 sayfalık modern bir SPA arayüzünden oluşur. Üretim ortamında aynı süreç hem bot hem de web sunucusunu ayağa kaldırır; geliştirme ortamında ise Vite hot-reload sunucusu bot ile eş zamanlı çalışır.

Güvenlik Katmanı: Helmet.js ile HTTP güvenlik başlıkları, CORS kısıtlamaları, rate-limiting (genel: 1000 istek/15 dk, auth: 50 istek/15 dk), path traversal saldırılarına karşı URI decode koruması ve GZIP sıkıştırma ile production-grade bir güvenlik zırhı oluşturulmuştur.

Koruma ve Güvenlik Sistemleri EzBro'nun en kritik bileşenlerinden biri, Discord sunucularını gerçek zamanlı olarak tehditlerden koruyan çok katmanlı güvenlik mimarisidir. Her koruma sistemi birbirinden bağımsız çalışır, ayrı ayrı yapılandırılabilir ve Discord event akışını anlık izler:

Sunucu Bütünlüğü Koruması: Ban, kick, rol, kanal, webhook, bot ve emoji koruma sistemleri; toplu saldırıları (raid) eşik değerleri üzerinden tespit eder. Örneğin ban-koruma sistemi kısa süre içinde gerçekleşen art arda yasaklamaları fark edip otomatik geri alır. Yetkisiz admin rolü verilmesini ve izinsiz bot eklenmesini de ayrı sistemler engeller.

İçerik Filtreleme: Küfür engeli, reklam engeli (Discord davet linkleri), capslock engeli, @everyone/@here engeli, yasaklı kelime filtresi ve spam engeli; her biri kendi event listener'ı ile çalışan, guild bazında yapılandırılabilen bağımsız sistemlerdir.

Sazan Avı (Scam/Phishing) Tespiti: Bilinen dolandırıcılık ve oltalama linklerini tespit eden özel bir sistem sunuculardaki kullanıcıları gerçek zamanlı olarak korur.

Hesap Koruma: Yeni katılan üyelerin Discord hesap yaşını kontrol eder; yapılandırılan eşiğin altındaki hesapları otomatik olarak sunucudan kaldırır.

Sicil Sistemi — Sunucular Arası Moderasyon Hafızası EzBro'nun en özgün özelliklerinden biri olan sicil sistemi, Discord'un her sunucunun bağımsız olduğu yapısını aşan bir moderasyon hafızası oluşturur.

Her moderasyon eylemi (ban, kick, timeout, uyarı, hesap koruma çıkarması vb.) merkezi bir SicilKayit koleksiyonuna yazılır. Bir kullanıcı EzBro kullanan herhangi bir sunucuya katıldığında, bot o kullanıcının tüm moderasyon geçmişini çeker, bir risk skoru hesaplar (düşük / orta / yüksek) ve skoru sunucunun yapılandırdığı eşiği geçiyorsa yetkilileri uyarır. Bu sayede bir kullanıcının başka sunucularda ne tür sorunlar yarattığı anında görülebilir.

Yapay Zeka Entegrasyonu EzBro, kendi geliştirdiği ezbro-ai-2.0 modeliyle çalışan gelişmiş bir yapay zeka sohbet sistemi barındırır:

Sunucu bazında etkinleştirilebilen sistem, kullanıcı başına son 10 mesaj geçmişini bellekte tutarak bağlamsal sohbet sağlar. Kişilik özelleştirmesi, görsel (multimodal) girdi desteği, dakika bazlı rate limiting (10 istek/dk), 3 saniyelik cooldown, üstel geri çekilme ile yeniden deneme ve yedek model fallback mekanizmaları içerir. Özellikle güçlü olan iki bağlam enjeksiyon özelliği öne çıkar: kullanıcı çekiliş ile ilgili bir şey yazarsa bot aktif çekiliş bilgilerini, destek konuşması başlatırsa açık destek talebi bilgilerini otomatik olarak ezbro-ai-2.0'a bağlam olarak ekler.

Müzik Sistemi — Sıfırdan Yazılmış Lavalink İstemcisi EzBro'nun müzik altyapısı, Lavalink v4 protokolünü tamamen sıfırdan uygulayan özel bir istemci üzerine kuruludur. WebSocket bağlantı yönetimi, HTTP REST çağrıları, sıra yönetimi (queue), oynat/duraklat/geç/geri sar/loop (0-2)/karıştır/ses (0-200)/önceki şarkı/taşı/kaldır işlemleri, çoklu oynatıcı yönetimi ve fallback arama motoru desteğini kapsar. YouTube, Spotify, SoundCloud, Deezer, Apple Music ve Tidal platformlarından içerik oynatılabilir.

Topluluk ve Eğlence Sistemleri EzBro yalnızca koruma ve yönetimle sınırlı kalmaz; canlı bir topluluk deneyimi için de kapsamlı araçlar sunar:

Seviye & XP Sistemi: Her sunucuda bağımsız çalışan deneyim puanı ve seviye takibi. Seviye atlandığında canvas kütüphanesi ile kişiselleştirilmiş görsel kart üretilir. Seviyeye bağlı otomatik rol atamaları yapılandırılabilir.

Çekiliş Sistemi: Zamanlayıcı tabanlı çekilişler, otomatik kazanan seçimi ve yeniden çekiliş (reroll) desteği. ezbro-ai-2.0 bağlam entegrasyonu ile de bütünleşiktir.

Oylama Paneli: Sunucu bazında oylama sistemleri, aylık arşivleme (her ayın ilk günü otomatik sıfırlama ve VoteArchive'e yazma) ve sunucu listesi paneli entegrasyonu.

Kelime Türetme & Sayı Saymaca: Oyun durumları MongoDB'de kalıcı olarak tutulur; bot yeniden başlatılsa bile oyunlar kaldığı yerden devam eder.

Özel Oda Sistemi: Sesli kanal oluşturduğunda kullanıcı için dinamik özel oda açılır; sahip ayrılınca otomatik silinir.

Davet Takip Sistemi: Detaylı davet izleme (kim kimi getirdi, sahte davet tespiti, yeniden katılım takibi), ödül yapılandırması ve canvas tabanlı özel hoş geldin kartı üretimi.

Destek Talebi (Ticket) Sistemi: Tam kapsamlı ticket açma, mesajlaşma ve kapatma akışı. Socket.IO ile web panelinden gerçek zamanlı ticket takibi.

Öneri Sistemi, OtoCevap, Evet/Hayır Sistemi, Gömülü Mesaj Oluşturucu ve Bildirim Sistemi de EzBro'nun topluluk araçları arasında yer alır.

İhbar Hattı Sistemi EzBro'nun özgün özelliklerinden biri olan ihbar hattı, platform güvenliğini topluluk katılımıyla destekleyen bir şikayet mekanizmasıdır. Kullanıcılar web paneli üzerinden ihbar gönderir; yöneticiler ihbarları değerlendirip onayladığında ilgili kullanıcı veya sunucu IhbarYasak listesine eklenir. Bot her yeni sunucuya katıldığında bu listeyi kontrol eder; yasak listesindeki bir sunucu veya sunucu sahibiyle karşılaşıldığında bot anında sunucudan ayrılır ve durumu yönetici kanalına iletir.

Web Dashboard — Gerçek Zamanlı Yönetim Paneli EzBro'nun web arayüzü, 129 sayfalık React + TypeScript uygulamasıyla Discord sunucu yönetimini tarayıcıdan mümkün kılar. Genel kullanıcılara açık sayfalar; ana sayfa, komut listesi, premium sayfası, sunucu listesi, sunucu profil sayfaları, oy arşivleri, duyurular, mağaza, ihbar hattı ve kullanıcı profil sayfalarını kapsar. Giriş yapan kullanıcılar için 19 farklı koruma sistemi yönetim sayfası, moderasyon, seviye, destek talebi, çekiliş, davet, kayıt, haber, deprem, öneri, yetkili alım, embed oluşturucu, oy paneli, denetim günlüğü, ekip yönetimi, profil düzenleyici, canvas editörü ve daha fazlası sunulur.

Gerçek zamanlılık Socket.IO ile sağlanır: ayarlar değiştiğinde veya yeni ticket açıldığında sayfa yenilemeye gerek kalmadan panel güncellenir. Admin kullanıcılar için ise premium kod üretimi ve yönetimi, sunucu listesi onayları, mağaza başvuruları, duyuru yönetimi ve veri sıfırlama araçlarını barındıran gelişmiş bir yönetim arayüzü mevcuttur.

Haber & Deprem Sistemi EzBro, Türkiye'ye özgü iki kritik bilgi servisi sunar: haber sistemi ve deprem uyarı sistemi. Haber sistemi belirli aralıklarla haber API'sini yoklayarak yapılandırılan kanallara güncel haberler gönderir. Deprem sistemi ise Türkiye'deki sismik aktiviteyi takip ederek eşik üzerindeki depremleri yapılandırılmış Discord kanallarına anlık bildirim olarak iletir. Her iki sistem de ayrı MongoDB koleksiyonlarında istatistik tutar.

Genel Mimari Felsefesi EzBro'nun tüm bileşenleri tek bir tasarım ilkesiyle şekillendirilmiştir: her şey sunucu bazında yapılandırılabilir, hiçbir şey sunucu yöneticisine dayatılmaz. Bir koruma sistemi aktif değilse olay dinleyicisi sessizce geçer. Bir özellik kullanılmıyorsa veritabanına hiçbir şey yazılmaz. Bu yaklaşım hem kaynak verimliliğini hem de operasyonel esnekliği garanti eder.

Hata yönetiminde benimsenen yaklaşım da bu felsefeyi yansıtır: kritik olmayan Discord API hataları sessizce filtrelenir; bot asla çökmez. Yalnızca gerçek anlamda kritik hatalar yüzeye taşınır.