Der Bedrud-Server ist eine Go-Anwendung, die die REST API bereitstellt, das eingebettete Web-Frontend ausliefert und den LiveKit-Media-Server verwaltet.

Technologie-Stack

Verzeichnisstruktur

server/
├── cmd/
│   ├── server/main.go        # Development entry point
│   └── bedrud/main.go        # Production entry point (with install/livekit flags)
├── internal/
│   ├── auth/                  # Authentication services
│   │   ├── auth.go            # Core auth service (register, login, OAuth)
│   │   ├── jwt.go             # JWT token creation and validation
│   │   └── session_store.go   # Gorilla session store for OAuth state
│   ├── database/              # Database initialization and migrations
│   ├── handlers/              # HTTP request handlers (controller layer)
│   │   ├── auth_handler.go    # Auth endpoints
│   │   ├── room.go            # Room endpoints
│   │   └── users.go           # User management endpoints
│   ├── middleware/             # Fiber middleware
│   │   └── auth.go            # JWT validation, permission checks
│   ├── models/                # GORM models (database schemas)
│   │   ├── user.go            # User model
│   │   ├── room.go            # Room model
│   │   └── passkey.go         # Passkey model
│   ├── repository/            # Data access layer (SQL via GORM)
│   │   ├── user_repository.go
│   │   ├── room_repository.go
│   │   └── passkey_repository.go
│   ├── livekit/               # Embedded LiveKit server management
│   ├── scheduler/             # Background job scheduling
│   └── utils/                 # TLS and other utilities
├── frontend/                  # Embedded web frontend (populated at build time)
├── config.yaml                # Development configuration
├── livekit.yaml               # Development LiveKit configuration
├── go.mod
└── go.sum

Schichtenarchitektur

Der Server folgt einer dreischichtigen Architektur:

flowchart TB
    HTTP[HTTP Request] --> Middleware
    Middleware["Middleware<br/>JWT validation, CORS, logging"] --> Handlers
    Handlers["Handlers<br/>Parse requests, call services, format responses"] --> Services
    Services["Services<br/>Business logic (auth, room management)"] --> Repository
    Repository["Repository<br/>Database queries via GORM"] --> Database
    Database["Database<br/>SQLite (dev) or PostgreSQL (production)"]

Wichtige Muster

Eingebettetes Frontend

Das Web-Frontend wird zu statischen Dateien kompiliert und über //go:embed in das Go-Binary eingebettet:

//go:embed frontend/*
var frontendFS embed.FS

Zur Build-Zeit führt bun run build:embed ein SSR-Pre-Rendering der React-App durch und kopiert dist/client/ nach server/frontend/. Der Go-Compiler bündelt es dann in das Binary. Der Fiber-Server liefert diese Dateien für alle Nicht-API-Routen aus.

JWT-Authentifizierung

Die Middleware extrahiert das JWT aus dem Authorization: Bearer <token>-Header, validiert es und hängt den Benutzerkontext an die Anfrage an. Geschützte Routen verwenden die RequireAccess-Middleware zur Prüfung der Benutzerrollen.

LiveKit-Token-Generierung

Wenn ein Benutzer einem Raum beitritt, führt der Server Folgendes aus:

1. Validiert die Raumberechtigungen
2. Erstellt ein mit dem API-Secret signiertes LiveKit-Zugangstoken
3. Gibt das Token an den Client zurück
4. Der Client verbindet sich direkt unter Verwendung des Tokens mit LiveKit

Swagger-Dokumentation

Die API-Dokumentation wird automatisch aus Code-Anmerkungen mit swaggo generiert. In der Entwicklung ist sie unter /api/swagger/ verfügbar.

Datenbank

SQLite (Standard)

Für die Entwicklung und kleine Bereitstellungen verwendet Bedrud SQLite. Die Datenbankdatei wird am konfigurierten database.path gespeichert (Standard: data.db).

PostgreSQL

Für den Produktivbetrieb mit höheren Parallelitätsanforderungen konfigurieren Sie eine PostgreSQL-Verbindungszeichenfolge. GORM verarbeitet beide Dialekte transparent.

Migrationen

GORM migriert das Schema beim Start automatisch basierend auf den Model-Structs. Die Modelle sind in internal/models/ definiert.

Hintergrund-Jobs

Der gocron-Scheduler führt periodische Aufgaben aus, wie z. B.:

• Bereinigung abgelaufener Refresh-Token
• Entfernen veralteter Raumteilnehmer

Siehe auch

• Backend-Code-Struktur - Verzeichnisübersicht und Coding-Standards
• API-Handler - Routing und Anfrage-Lebenszyklus
• Datenbank und Modelle - GORM-Modelle und Repository-Muster
• Authentifizierungsablauf - JWT-, OAuth- und Passkey-Interna