Bedrud - это монорепозиторий, содержащий сервер на Go, три клиентских приложения, ботов-агентов на Python и общие пакеты. Эта страница описывает взаимосвязь между компонентами.

Высокоуровневая диаграмма

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

Компоненты

Сервер (server/)

Бэкенд на Go - ядро Bedrud. Он отвечает за:

• REST API - аутентификация, управление комнатами, административные операции
• Раздача статических файлов - скомпилированный веб-фронтенд встраивается через //go:embed
• Интеграция с LiveKit - генерация токенов и управление комнатами через LiveKit Protocol SDK
• Встроенный сервер LiveKit - бинарник медиасервера запускается как дочерний процесс

Сервер использует веб-фреймворк Fiber (аналог Express.js в Node.js) и GORM в качестве ORM. Поддерживает SQLite для разработки и PostgreSQL для продакшена.

Подробнее см. Архитектура сервера.

Веб-фронтенд (apps/web/)

Приложение на React, построенное с TanStack Start, TailwindCSS v4 и shadcn/ui. В продакшене оно предварительно рендерится на сервере, а клиентские ресурсы встраиваются в бинарник Go.

Ключевые возможности:

• Интерфейс видеоконференций с LiveKit Client SDK
• Аутентификация на основе JWT с автоматическим обновлением токенов
• Панель администратора для управления пользователями и комнатами
• Система дизайна с единообразной библиотекой компонентов

Подробнее см. Веб-фронтенд.

Приложение для Android (apps/android/)

Нативное приложение для Android, построенное на Jetpack Compose и Kotlin. Использует Koin для внедрения зависимостей и Retrofit для HTTP-запросов.

Ключевые возможности:

• Полноценный интерфейс видеоконференций с LiveKit Android SDK
• Режим «картинка в картинке»
• Обработка глубоких ссылок (bedrud.com/m/* и bedrud.com/c/*)
• Управление звонками через Android ConnectionService
• Поддержка нескольких экземпляров (подключение к нескольким серверам)

Подробнее см. Приложение для Android.

Приложение для iOS (apps/ios/)

Нативное приложение для iOS, построенное на SwiftUI. Использует KeychainAccess для безопасного хранения учётных данных и LiveKit Swift SDK для работы с медиа.

Ключевые возможности:

• Полноценный интерфейс видеоконференций
• Поддержка нескольких экземпляров
• Обработка глубоких ссылок
• Безопасное хранение учётных данных в Keychain

Подробнее см. Приложение для iOS.

Десктопное приложение (apps/desktop/)

Нативное приложение для Windows и Linux, построенное на Rust и UI-фреймворке Slint. Компилируется в единый бинарник без зависимостей времени выполнения.

Ключевые возможности:

• Полноценный интерфейс видеоконференций через LiveKit Rust SDK
• Нативный рендеринг: Windows (Direct3D 11) и Linux (OpenGL/Vulkan)
• Поддержка нескольких экземпляров (подключение к нескольким серверам Bedrud)
• Интеграция с OS keyring для безопасного хранения учётных данных

Подробнее см. Десктопное приложение.

Боты-агенты (agents/)

Скрипты на Python, которые подключаются к комнатам как боты и транслируют медиаконтент:

• Музыкальный агент - воспроизводит аудиофайлы
• Радио-агент - транслирует интернет-радиостанции
• Видеостриминг-агент - делится видеоконтеинтом (HLS, MP4)

Подробнее см. Боты-агенты.

Процесс аутентификации

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

Все аутентифицированные запросы используют JWT-токены в заголовке Authorization. Обёртка authFetch веб-фронтенда автоматически добавляет токен и обновляет его.

Поддерживаемые методы аутентификации:

Процесс подключения к конференции

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. Клиент запрашивает подключение к комнате через REST API
2. Сервер проверяет разрешения и генерирует подписанный LiveKit-токен
3. Клиент подключается напрямую к LiveKit через WebSocket, используя токен
4. ICE собирает кандидатов (host, STUN, TURN) и выбирает лучший маршрут
5. Аудио- и видеодорожки проходят через SFU LiveKit

Подробнее см. Подключение WebRTC - полный стек подключения.

Модель данных

User

Room

Passkey

RefreshToken

Архитектура развёртывания

В продакшене Bedrud работает как два сервиса systemd:

Оба сервиса управляются единым бинарником. Traefik или другой обратный прокси обрабатывает TLS-терминацию и маршрутизацию трафика.

Инструкции по настройке см. в Руководстве по развёртыванию.

Ключевые термины

Эти термины встречаются в документации по архитектуре:

См. также

• Подключение WebRTC - полный стек подключения STUN/ICE/TURN/SFU
• Руководство по TURN-серверу - архитектура и настройка TURN-ретрансляции
• Интеграция с LiveKit - как Bedrud встраивает LiveKit