LF Core Architecture // Birleşik Sistem Motoru

Tek Çekirdek.
Çoklu Sistem.
Birleşik Zeka.

Karmaşık Discord ekosistemlerini merkezi bir Node.js mimarisi üzerinden koordine etmek, güvenceye almak ve yönetmek için tasarlanmış bütünleşik altyapı motoru.

Çalışma Modeli Single-Process Event Loop
Arayüz Standardı Discord Components V2
Hızlı Davet Rotası lucianof.com/invite-bot
SYS_ID // LF_UNIFIED_CORE NODE.JS 20 LTS
LF CORE
GATEWAY TRANSPORT Discord.js + ws
HTTP GATEWAY Express OAuth2
PROCESS MANAGER PM2 (lf-master)
GRAPHICS ENGINE @napi-rs/canvas
01 // Altyapı Özeti

Dağıtık Bot Karmaşasını Tek Çekirdekte Birleştirin.

Büyük Discord toplulukları genellikle birbirinden kopuk onlarca bota güvenir; bu durum mükerrer veritabanı bağlantılarına, yetki çakışmalarına ve parçalanmış denetim kayıtlarına yol açar. LF Core tüm alt sistemleri tek bir senkronize kod tabanında toplar.

Merkezi Olay Koordinasyonu

SINGLE_PROCESS

Guard, Moderasyon, Ses, Hesap Doğrulama, Ekonomi, Kulüp ve Telemetri modüllerinin tamamı tek bir ana Node.js çalışma zamanında (index.js) yürütülür. Gateway olayları tek seferde alınır ve süreçler arası serileştirme kaybı olmadan dahili işleyicilere dağıtılır.

Ortak Durum & Bağlantı Havuzu

PG_POOL + WS

Her özellik için ayrı veritabanı tutmak yerine tüm alt sistemler ortak bir PostgreSQL şemasına ve Node.js 20 için özel WebSocket (ws) aktarım katmanıyla yapılandırılmış Supabase istemcisine okuma/yazma yapar.

Discord Components V2 Arayüzü

UI_V2_CONTAINERS

Yönetim panelleri, kullanıcı sicil sorguları ve moderasyon kayıtları; Container, Separator ve TextDisplay gibi modern Discord Components V2 yapıtaşları ve sunucu taraflı Canvas grafik motoruyla üretilir.

02 // Çekirdek Mimarisi

Katmanlı Yürütme Topolojisi.

Olayların, Slash komutlarının ve harici OAuth2 geri dönüşlerinin LF Core çalışma zamanında nasıl ilerlediğini incelemek için aşağıdaki mimari düğümlere tıklayın.

İNCELEMEK İÇİN DÜĞÜME TIKLAYIN
INSPECTING // Discord Gateway & REST API

Message Content ve Guild Members izinleriyle gerçek zamanlı WebSocket olaylarını (messageCreate, voiceStateUpdate, interactionCreate) yakalar ve çekirdeğe iletir.

ACTIVE NODE
03 // Sistem Bileşenleri

Entegre Modül Kataloğu.

LF Core, 10 operasyonel alt sistemi tek bir dağıtım biriminde birleştirir. Her modülün komutlarını ve teknik sorumluluklarını aşağıdan inceleyin.

MODULE // GUARD_CORE SLASH COMMANDS & EVENT LISTENERS

Guard & Karantina Alt Sistemi

Sunucu bütünlüğünü baskınlara (raid), izinsiz davet linklerine ve ele geçirilmiş hesaplara karşı korur. Bir üye karantinaya alındığında LF Core kullanıcının tüm rol dizisini PostgreSQL'e yedekler, aktif yetkilerini sıfırlar ve inceleme bitene kadar izole hücreye hapseder.

Birincil Slash Komutları
/guard-karantina, /guard-ihtar, /guard-kilit
Otomatik Tetikleyiciler
trap_guard, anti_ad (+2 ihtar), Ghost Ping İfşa
Durum Kalıcılığı
Rol Dizisi Yedeği & İhtar Puanı Sicili
Acil Durum Kontrolleri
Kanal Klonlama (Nuke) & Tüm Sunucu Kilidi
04 // Güvenlik Altyapısı

Deterministik İzolasyon & Erişim Kontrolü.

LF Core içindeki güvenlik, 7 kademeli yetki hiyerarşisi ve üye geçmişini kaybetmeden tehditleri etkisiz hale getiren durum tabanlı karantina protokolüyle yürütülür.

STATEFUL QUARANTINE ISOLATION PROTOCOL (/guard-karantina)
STEP 01 // DETECTION

Tehdit Algılama

Yetkili tarafından /guard-karantina işlem:al komutuyla veya otomatik güvenlik filtreleriyle tetiklenir.

STEP 02 // SNAPSHOT

Rol Serileştirme

Hedef üyenin üzerindeki tüm rol ID'leri serileştirilir ve PostgreSQL veritabanına kaydedilir.

STEP 03 // ISOLATION

Yetki Arındırma

Tüm yetkili ve normal roller sökülür; kullanıcı yalnızca izole karantina hücresini görebilen role atanır.

STEP 04 // RECOVERY

Durum Geri Yükleme

/guard-karantina işlem:cikar çalıştırıldığında veritabanındaki rol yedeği çekilir ve eski roller eksiksiz iade edilir.

Tuzak Kanal Koruması (Trap Guard)

trap_channels tablosuyla izlenen honeypot kanallar. Bu kanallara mesaj atan botlar veya hesaplar anında silinir ve sunucudan kalıcı olarak yasaklanır.

7 Kademeli Yetki Hiyerarşisi

Komutlar çağrıyı yapan kişiyi 7 seviyede doğrular: LUCIANO FERRETTI (Lv.7), SERVER OWNER (Lv.6), CVIP, SSSVIP, C-SUB, SSVIP / SVIP / VIP ve MEMBER.

Sunucu & Kullanıcı Bloklama

guild_activity_block tablosu ve BLOCKED_USERS kümesi ile yetkisiz sunucular veya kara listedeki hesaplar komut katmanına ulaşmadan engellenir.

05 // Veritabanı & Kalıcılık

Hibrit PostgreSQL & Supabase Katmanı.

LF Core, doğrudan PostgreSQL bağlantı havuzunu Supabase SDK ile birleştirerek moderasyon sicilleri, rol yedekleri ve ekonomi işlemleri için kalıcı depolama sunar.

Node.js 20 WebSocket Aktarımı

Node.js 20 Linux ortamlarında tam uyumluluk için @supabase/supabase-js Realtime istemcisi özel ws paketiyle yapılandırılmıştır.

Zamanlanmış Rol Sona Erme Takibi

/rol-yönetim işlem:gecici_ver ile verilen süreli roller bitiş zaman damgasıyla kaydedilir ve arka planda çalışan node-cron görevleriyle otomatik geri alınır.

Yetkili İstihbarat Sicil Notları

Moderatörler /sistem-araç araç:not_ekle ile kullanıcı ID'lerine kalıcı notlar bırakır; bu notlar id_sorgu sorgularında anında listelenir.

POSTGRESQL // CORE SCHEMA pg + supabase-js
Tablo / Koleksiyon Birincil Anahtar Saklanan Veri
guild_activity_block guild_id Sunucu askıya alma ve erişim kilidi
trap_channels channel_id Sunucu bazlı aktif tuzak kanal kayıtları
quarantine_snapshots user_id, guild_id Tahliye için serileştirilmiş rol ID dizileri
guard_warnings user_id, guild_id Kademeli ihtar puanları ve ihlal geçmişi
staff_user_notes target_id Moderatörler arası kalıcı sicil notları
oauth_identity_links discord_id Doğrulanmış Roblox ve Google hesap bağları
economy_ledgers user_id Cüzdan bakiyeleri, banka ve mağaza envanteri
06 // API & Entegrasyonlar

Harici Kimlik & Ağ Geçidi Köprüleri.

Standart Discord etkileşimlerinin ötesinde LF Core, üçüncü taraf OAuth2 sağlayıcılarını doğrudan sunucu rol yönetimine bağlamak için yerleşik bir Express HTTP sunucusu çalıştırır.

OAUTH2 IDENTITY // ROBLOX

Roblox Hesap Eşleştirme

Üyelerin Roblox kimliklerini OAuth2 geri dönüş akışları ve Grup ID kontrolüyle doğrular; doğrulanmış üye rollerini otomatik senkronize eder.

Flow: OAuth2 RedirectHTTP GET
OAUTH2 IDENTITY // GOOGLE

Google API Doğrulaması

Resmi googleapis istemcisini kullanarak harici kullanıcı oturumlarını doğrular ve Discord profillerine onaylı kimlik rozetleri tanımlar.

Driver: googleapisOAUTH2
DISCORD API // REST & GATEWAY

Slash Senkronizasyonu & Özel Emojiler

Başlangıçta tüm uygulama komutlarını senkronize eder ve Components V2 kartlarında sunucuya özel rozet emojilerini işler.

Engine: discord.jsWSS / REST
07 // İzleme & Sistem Sağlığı

Gerçek Zamanlı Süreç Gözlemlenebilirliği.

Ubuntu VDS üzerinde PM2 süreç yöneticisi (`lf-master`) altında çalışan çekirdek, çalışma süresi ve servis sağlığı takibi için canlı bir HTTP JSON uç noktası sunar.

GET :10000/health — HTTP/1.1 200 OK application/json
{
  "status": "HEALTHY",
  "service": "LF (Luciano Ferretti) Unified Core",
  "turkey_time": "01.11.2026 23:05:00",
  "uptime": 143750.32
}
RUNTIME SPECIFICATIONS

Ubuntu VDS Servis Yapısı

Process Namelf-master (index.js)
Node.js Runtimev20.20.2 LTS
Gateway Port10000 (Express)
Native DepsCairo, Pango, LibJPEG, GIFLib
08 // Teknoloji Yığını

Doğrulanmış Üretim Bağımlılıkları.

Runtime

Node.js 20 LTS

Ubuntu Linux üzerinde çalışan asenkron olay tabanlı çalışma zamanı.

Discord Client

discord.js

Gateway WebSocket yönetimi, Slash komutları ve Components V2 arayüzleri.

Database

pg & supabase-js

PostgreSQL havuzu ve özel ws aktarımlı Supabase istemcisi.

HTTP Server

Express & Axios

OAuth2 geri dönüşleri, harici API istekleri ve /health telemetrisi.

Graphics

@napi-rs/canvas

gifwrap ile birlikte yüksek hızlı cüzdan ve profil kartı üretimi.

Identity SDK

googleapis

Resmi Google OAuth2 kimlik doğrulama ve hesap bağlama kütüphanesi.

Scheduling

node-cron & ms

Geçici rol sürelerinin takibi ve zamanlanmış arka plan görevleri.

Supervision

PM2 & dotenv

Süreç izleme, otomatik yeniden başlatma ve ortam değişkeni yönetimi.

09 // Geliştirme Yol Haritası

Mühendislik Aşamaları.

● Tamamlandı & Aktif

Faz I — Çekirdek Birleştirme

  • 10 modülün tekil index.js çekirdeğinde birleştirilmesi.
  • Ubuntu VDS üzerinde PM2 ve Node.js 20 ws uyumluluğu.
  • Rol yedeklemeli karantina, Trap Guard ve ihtar sicil sistemi.
◆ Aktif Geliştirme

Faz II — Görsel & Yetkili Standardizasyonu

  • Tüm modül arayüzlerinin yeni özel sunucu rozet emojilerine geçirilmesi.
  • Moderatör eğitim rehberi ve vaka senaryolarının tamamlanması.
  • Canvas finans kartlarının ve kulüp arayüzlerinin iyileştirilmesi.
○ Planlanan Genişleme

Faz III — Web Yönetim Paneli

  • Planlanan: Denetim kayıtlarını ve karantina durumlarını tarayıcıdan yönetmek için OAuth2 korumalı web paneli.
  • Planlanan: Sunucu bazlı kural ve filtre ayarlarının web üzerinden yapılandırılması.
10 // Yasal & Kurumsal Politikalar

Hizmet Şartları, Gizlilik ve Güvenlik Yönergesi.

LF Core altyapısını kullanan tüm sunucu sahipleri, moderatörler ve üyeler için geçerli olan şeffaf kullanım koşullarımız ve veri işleme ilkelerimiz.