Bedrud; bir Go sunucusu, üç istemci uygulaması, Python bot aracıları ve ortak paketler içeren bir monorepo’dur. Bu sayfa bileşenlerin birbiriyle nasıl ilişkili olduğunu açıklar.

Üst Düzey Diyagram

flowchart TB
    subgraph Clients ["Clients"]
        Web["Web<br/>React"]
        Android["Android<br/>Compose"]
        iOS["iOS<br/>SwiftUI"]
        Desktop["Desktop<br/>Rust + Slint"]
    end
 
    subgraph Server ["Bedrud Server"]
        Router["Fiber HTTP Router<br/>/api/auth/* /api/room/* /api/admin/*"]
        DB["GORM / SQLite<br/>(or PostgreSQL)"]
        LKSDK["LiveKit Protocol SDK<br/>(token generation, room management)"]
        LiveKit["Embedded LiveKit<br/>Media Server (WebRTC)"]
    end
 
    Clients -->|"REST API + WebSocket"| Router
    Router --> DB
    Router --> LKSDK
    LKSDK --> LiveKit

Bileşenler

Sunucu (server/)

Go arka ucu Bedrud’un çekirdeğidir. Şunları yönetir:

• REST API - kimlik doğrulama, oda yönetimi, yönetici işlemleri
• Statik dosya sunumu - derlenmiş web ön ucu //go:embed ile gömülüdür
• LiveKit entegrasyonu - LiveKit Protocol SDK üzerinden token üretir ve odaları yönetir
• Gömülü LiveKit sunucusu - medya sunucusu ikili dosyası bir alt süreç olarak çalışır

Sunucu Fiber web çerçevesini (Node.js’deki Express.js’e benzer) ve ORM katmanı olarak GORM’u kullanır. Geliştirme için SQLite, üretim için PostgreSQL destekler.

Ayrıntılar için bkz. Sunucu Mimarisi.

Web Ön Ucu (apps/web/)

TanStack Start, TailwindCSS v4 ve shadcn/ui ile oluşturulmuş bir React uygulamasıdır. Üretimde sunucuda ön_RENDERLENİR ve istemci varlıkları Go ikili dosyasına gömülür.

Temel yetenekler:

• LiveKit Client SDK ile video toplantısı arayüzü
• Otomatik token yenileme ile JWT tabanlı kimlik doğrulama
• Kullanıcı ve oda yönetimi için yönetici paneli
• Tutarlı bileşen kütüphanesi ile tasarım sistemi

Ayrıntılar için bkz. Web Ön Ucu.

Android Uygulaması (apps/android/)

Jetpack Compose ve Kotlin ile oluşturulmuş yerel bir Android uygulamasıdır. Bağımlılık enjeksiyonu için Koin, HTTP için Retrofit kullanır.

Temel yetenekler:

• LiveKit Android SDK ile tam video toplantısı deneyimi
• Resim içinde resim (PiP) modu
• Derin bağlantı işleme (bedrud.com/m/* ve bedrud.com/c/*)
• Android ConnectionService ile arama yönetimi
• Çoklu örnek desteği (birden fazla sunucuya bağlanma)

Ayrıntılar için bkz. Android Uygulaması.

iOS Uygulaması (apps/ios/)

SwiftUI ile oluşturulmuş yerel bir iOS uygulamasıdır. Güvenli kimlik bilgisi depolama için KeychainAccess, medya için LiveKit Swift SDK kullanır.

Temel yetenekler:

• Tam video toplantısı deneyimi
• Çoklu örnek desteği
• Derin bağlantı işleme
• Keychain tabanlı güvenli depolama

Ayrıntılar için bkz. iOS Uygulaması.

Masaüstü Uygulaması (apps/desktop/)

Rust ve Slint UI araç takımı ile oluşturulmuş yerel bir Windows ve Linux masaüstü uygulamasıdır. Herhangi bir çalışma zamanı bağımlılığı olmadan tek bir ikili dosyaya derlenir.

Temel yetenekler:

• LiveKit Rust SDK ile tam video toplantısı deneyimi
• Yerel Windows (Direct3D 11) ve Linux (OpenGL/Vulkan) işleme
• Çoklu örnek desteği (birden fazla Bedrud sunucusuna bağlanma)
• Güvenli kimlik bilgisi depolama için OS keyring entegrasyonu

Ayrıntılar için bkz. Masaüstü Uygulaması.

Bot Aracıları (agents/)

Toplantı odalarına bot olarak katılan ve medya içeriği yayınlayan Python betikleri:

• Müzik Aracısı - ses dosyalarını çalar
• Radyo Aracısı - internet radyo istasyonlarını yayınlar
• Video Yayın Aracısı - video içeriği paylaşır (HLS, MP4)

Ayrıntılar için bkz. Bot Aracıları.

Kimlik Doğrulama Akışı

sequenceDiagram
    participant Client
    participant Server
    participant Database
 
    Client->>Server: POST /api/auth/login
    Server->>Database: verify credentials
    Database-->>Server: credentials valid
    Server-->>Client: access + refresh JWT
 
    Client->>Server: GET /api/room/list
    Note right of Server: "Authorization: Bearer <access_token>"
    Server-->>Client: room list

Tüm kimlik doğrulaması yapılmış istekler Authorization başlığında JWT tokenları kullanır. Web ön ucundaki authFetch sarmalayıcısı token ekleme ve otomatik yenileme işlemlerini gerçekleştirir.

Desteklenen kimlik doğrulama yöntemleri:

Toplantı Bağlantı Akışı

sequenceDiagram
    participant C as Client
    participant S as Bedrud Server
    participant LK as LiveKit SFU
 
    C->>S: POST /api/room/join
    S->>S: Validate permissions
    S->>C: LiveKit JWT token
    C->>LK: WebSocket connect (with token)
    LK->>C: SDP offer + join response
 
    Note over C,LK: ICE connectivity check
    C->>LK: Host + STUN + TURN candidates
 
    alt Direct path (UDP)
        C-->>LK: Media via UDP 50000-60000
    else TURN relay
        C-->>LK: Media via TURN relay
    end
 
    Note over C,LK: Audio/video tracks flow through SFU

1. İstemci REST API üzerinden bir odaya katılma isteği gönderir
2. Sunucu izinleri doğrular ve imzalı bir LiveKit tokenı üretir
3. İstemci bu tokenı kullanarak WebSocket üzerinden doğrudan LiveKit’e bağlanır
4. ICE adayları toplar (host, STUN, TURN) ve en iyi yolu seçer
5. Ses/video kanalları LiveKit’in SFU’sundan geçer

Tam bağlantı yığını için bkz. WebRTC Bağlantısı.

Veri Modeli

User

Room

Passkey

RefreshToken

Dağıtım Mimarisi

Üretimde Bedrud iki systemd hizmeti olarak çalışır:

İkisi de tek bir ikili dosya tarafından yönetilir. Traefik veya başka bir ters vekil TLS sonlandırmasını ve trafik yönlendirmeyi gerçekleştirir.

Kurulum talimatları için bkz. Dağıtım Kılavuzu.

Temel Terimler

Bu terimler mimari belgelerinde genel olarak kullanılır:

Ayrıca Bakınız

• WebRTC Bağlantısı - tam STUN/ICE/TURN/SFU bağlantı yığını
• TURN Sunucusu Kılavuzu - TURN aktarma mimarisi ve yapılandırması
• LiveKit Entegrasyonu - Bedrud’un LiveKit’i nasıl gömdüğü