Plyes
Birisi mi Spawnlandı?
- Katılım
- 6 Mayıs 2026
- Mesajlar
- 4
- Elmaslar
- 0
- Puan
- 105
- Yaş
- 16
- Konum
- Sakarya
- Minecraft
- Plyes
Discord:
swoxyleee
PL-GlobalRolesMerkezi Yönetim ve Asenkron Rol Dağıtım Altyapısı
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
Proje Vizyonu ve İhtiyaç AnaliziBüyük çaplı projelerde (Network ağlarında), idari kadronun yetkilendirmelerini her bir alt sunucu (node) için manuel olarak yönetmek sadece büyük bir zaman kaybı değil, aynı zamanda operasyonel bir zafiyettir.
PL-GlobalRoles, Discord.js v14 kullanılarak sıfırdan inşa edilmiş; birden fazla sunucuyu tek bir ana komut üzerinden senkronize eden, API limitlerine takılmayan ve hata toleransı (fault tolerance) en üst düzeyde tutulmuş açık kaynaklı bir yönetim mimarisidir.
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
TEKNİK MİMARİ VE ÖZELLİKLER
• Sıfır Çökme Toleransı (Fault Tolerance & Error Handling)Botun mimarisi, yetki yetersizliği veya rol hiyerarşisi hataları (Role Hierarchy) durumunda uygulamanın çökmesini (Crash) kesinlikle engeller. İşlemler kapsüllenmiş try-catch blokları içerisinde yürütülür; başarısız olan sunucular izole edilerek arka planda rapora işlenir ve döngü güvenle devam eder.
• Güvenli İterasyon ve Rate Limit KorumasıSunucu önbelleği (Guild Cache) taranırken, Discord API'sinin Rate Limit (429 Too Many Requests) kısıtlamalarından kaçınmak adına asenkron Promise.all yığınları yerine, kontrollü ve sıralı for...of döngüleri tercih edilmiştir.
• Erken Dönüş (Guard Clauses) AlgoritmasıSpagetti koda ve iç içe geçmiş if-else bloklarına yer verilmemiştir. Bot, kullanıcının bulunmadığı veya hedeflenen rolün tanımlı olmadığı sunucuları milisaniyeler içinde tespit edip anında iterasyondan eler (Early Return). Bu sayede bellek (Memory) tüketimi minimize edilir.
• Kapsamlı Telemetri ve Raporlamaİşlem tamamlandığında uygulayıcı yöneticiye, başarılı ve başarısız (yetki hatası alınan) sunucuların detaylı dökümünü içeren, minimalist ve okunabilirliği yüksek bir Embed raporu sunulur.
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
KULLANIM VE GÜVENLİK PROTOKOLÜ
Komut Dizilimi:
Güvenlik Katmanı:Sistem, modern Slash Command altyapısını kullanır. Güvenlik protokolleri gereği bu fonksiyon yalnızca Yönetici (Administrator) izin bayrağına (PermissionFlagsBits.Administrator) sahip sistem yöneticileri tarafından tetiklenebilir.
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
AÇIK KAYNAK VE REPOSITORY
Proje, PLyes tarafından temiz kod (Clean Code) prensiplerine uygun olarak geliştirilmiş ve topluluğun kullanımına açık kaynak olarak sunulmuştur. Geliştiriciler kodu inceleyebilir, kendi sistemlerine entegre edebilir veya Pull Request göndererek projeye katkıda bulunabilirler.
Sistem entegrasyonu veya altyapı sorularınız için konu altından iletişime geçebilirsiniz.— PLyes
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
Proje Vizyonu ve İhtiyaç AnaliziBüyük çaplı projelerde (Network ağlarında), idari kadronun yetkilendirmelerini her bir alt sunucu (node) için manuel olarak yönetmek sadece büyük bir zaman kaybı değil, aynı zamanda operasyonel bir zafiyettir.
PL-GlobalRoles, Discord.js v14 kullanılarak sıfırdan inşa edilmiş; birden fazla sunucuyu tek bir ana komut üzerinden senkronize eden, API limitlerine takılmayan ve hata toleransı (fault tolerance) en üst düzeyde tutulmuş açık kaynaklı bir yönetim mimarisidir.
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
TEKNİK MİMARİ VE ÖZELLİKLER
• Sıfır Çökme Toleransı (Fault Tolerance & Error Handling)Botun mimarisi, yetki yetersizliği veya rol hiyerarşisi hataları (Role Hierarchy) durumunda uygulamanın çökmesini (Crash) kesinlikle engeller. İşlemler kapsüllenmiş try-catch blokları içerisinde yürütülür; başarısız olan sunucular izole edilerek arka planda rapora işlenir ve döngü güvenle devam eder.
• Güvenli İterasyon ve Rate Limit KorumasıSunucu önbelleği (Guild Cache) taranırken, Discord API'sinin Rate Limit (429 Too Many Requests) kısıtlamalarından kaçınmak adına asenkron Promise.all yığınları yerine, kontrollü ve sıralı for...of döngüleri tercih edilmiştir.
• Erken Dönüş (Guard Clauses) AlgoritmasıSpagetti koda ve iç içe geçmiş if-else bloklarına yer verilmemiştir. Bot, kullanıcının bulunmadığı veya hedeflenen rolün tanımlı olmadığı sunucuları milisaniyeler içinde tespit edip anında iterasyondan eler (Early Return). Bu sayede bellek (Memory) tüketimi minimize edilir.
• Kapsamlı Telemetri ve Raporlamaİşlem tamamlandığında uygulayıcı yöneticiye, başarılı ve başarısız (yetki hatası alınan) sunucuların detaylı dökümünü içeren, minimalist ve okunabilirliği yüksek bir Embed raporu sunulur.
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
KULLANIM VE GÜVENLİK PROTOKOLÜ
Komut Dizilimi:
Kod:
/rolver <@kullanıcı> <rol_adı>Güvenlik Katmanı:Sistem, modern Slash Command altyapısını kullanır. Güvenlik protokolleri gereği bu fonksiyon yalnızca Yönetici (Administrator) izin bayrağına (PermissionFlagsBits.Administrator) sahip sistem yöneticileri tarafından tetiklenebilir.
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
AÇIK KAYNAK VE REPOSITORY
Proje, PLyes tarafından temiz kod (Clean Code) prensiplerine uygun olarak geliştirilmiş ve topluluğun kullanımına açık kaynak olarak sunulmuştur. Geliştiriciler kodu inceleyebilir, kendi sistemlerine entegre edebilir veya Pull Request göndererek projeye katkıda bulunabilirler.
Sistem entegrasyonu veya altyapı sorularınız için konu altından iletişime geçebilirsiniz.— PLyes
