Bedienungsanleitung für Operatoren

Diese Seite beschreibt den Operator-Workflow, sobald ein Admin angelegt ist (siehe first-admin.md).

Öffnen Sie https://<your-domain>/login und melden Sie sich mit Ihren Admin-Zugangsdaten an. Ist 2FA aktiviert, geben Sie den TOTP-Code aus Ihrer Authenticator-App ein.

In der Entwicklung erlaubt ein Panel „Dev only — Connexion rapide” unterhalb des Formulars den Klick-Login als [email protected]. In der Produktion per Tree-Shaking entfernt.

Tipp — um die Schritte 2–4 unten zu überspringen, führen Sie nach pnpm dev den Befehl pnpm seed aus: Er legt über die API ein Demo-Event + Kommentator + Einladung an und gibt die URLs zum Einfügen aus. Praktisch, wenn Sie nur eine funktionierende Live-Ansicht zum Arbeiten brauchen.

2. Event anlegen

Klicken Sie in der Event-Liste auf „Nouveau”. Füllen Sie aus:

Nom — Anzeigename (z. B. „FC Sion vs Servette”)
Description — optionale Notizen
Date de début / fin — optionale Terminierung

Das Event wird im Status draft angelegt. Klicken Sie darauf, um die Detailansicht zu öffnen.

3. Kommentator hinzufügen

Scrollen Sie in der Event-Detailansicht zu „Commentateurs” und klicken Sie auf „Ajouter”. Füllen Sie aus:

Nom — Anzeigename des Kommentators
Langue — fr/en/de/it
Audio channels — optional, für Mehrkanal-Hardware-Setups
Gain micro — bei 0 dB beginnen

v1.x erlaubt nur einen Kommentator pro Event (Mono-Kommentator-Scope).

4. Einladungslink generieren

Klappen Sie in der Kommentator-Karte „Invitations” auf und klicken Sie auf „Générer une invitation”. Optionen:

Mot de passe (optional) — schützt den Link mit einem Passwort
Usage unique — Link verfällt nach der ersten Verwendung
Expiration — automatischer Ablaufzeitpunkt

Nach der Generierung wird die vollständige URL einmalig angezeigt. Klicken Sie auf „Copier”, um sie in die Zwischenablage zu kopieren, und senden Sie sie dann an den Kommentator (SMS, E-Mail, Telegram usw.).

⚠️ Die URL wird nur einmal angezeigt — kopieren Sie sie, bevor Sie das Modal schliessen.

5. Event-Status wechseln

Verfügbare Übergänge:

draft → scheduled (Planung bestätigt)
scheduled → live (Kommentator verbindet sich gleich)
live → ended (Übertragung abgeschlossen)
ended → archived (Langzeitarchivierung)

Klicken Sie auf die Buttons in der Event-Detailansicht. Ungültige Übergänge werden ausgeblendet.

6. Auf Sendung gehen (Studio-Seite)

Klicken Sie auf „Démarrer en direct”, um die Live-Ansicht zu öffnen:

Der LiveKit-Token wird serverseitig erstellt, das Studio tritt dem Raum des Kommentators bei
Das Audiometer animiert mit 60Hz
Das On-Air-Badge aktualisiert sich in Echtzeit via WebSocket, sobald der Kommentator auf ON-AIR klickt

Neu in v1.2 — zwei zusätzliche Videopanels erscheinen, sobald sich der Kommentator verbindet:

ComCam erscheint als Videopanel neben der PGM-Vorschau, wenn der Kommentator seine Webcam publiziert. Mit dem Augen-Symbol lässt sie sich lokal ausblenden, falls sie vom Audiometer ablenkt. Schaltet der Kommentator seine Kamera ab, sehen Sie den Platzhalter.
PGM-Vorschau zeigt, was der Kommentator sieht; das Audio ist stummgeschaltet, um Rückkopplungen zu vermeiden.

7. PGM + Talkback direkt im Browser publizieren (v1.6+)

Das Studio publiziert PGM-Video+Audio und Talkback-Intercom-Audio direkt aus dem Browser — kein OBS, kein externer Streamer.

In der Live-Ansicht erscheinen zwei Panels unter der Kommentator-Karte:

PGM (Programmrückführung) — Webcam + Mikrofon wählen, auf „Publier” klicken. Der Kommentator sieht das Video bildschirmfüllend hinter den On-Air-Bedienelementen. Das Audio wird auf den Track pgm-audio geroutet und in den Foldback des Kommentators gemischt.
Talkback — das Intercom-Mikrofon wählen (typischerweise ein geschlossenes Headset oder das Talkback-Handgerät der Regie), auf „Publier” klicken. Das Audio geht auf den Track talkback-audio. Der Kommentator hört es auf einem separaten Kanal, mit sichtbarem Talkback-PiP-Platzhalter in der Ecke des Kiosks.

Der Publish-Zustand gilt pro Tab. Schliesst der Operator den Studio-Tab, werden beide Tracks unpubliziert — der Kommentator fällt auf Stille zurück.

Historische Anmerkung: v1.1–v1.5 routeten PGM über OBS WHIP. Das eingesetzte LiveKit v1.7.2 bietet keinen /whip-Endpunkt, daher hat dieser Weg in der Produktion nie funktioniert. v1.6 ersetzte WHIP durch In-Browser-Publishing.

8. Einladungen widerrufen / rotieren

Klappen Sie in der Kommentator-Karte „Invitations” auf. Für jede aktive Einladung:

Révoquer — macht die Einladung sofort ungültig. Nützlich, falls der Link geleakt wurde.

Zum Rotieren (= widerrufen + neu erstellen) widerrufen Sie die bestehende Einladung und klicken erneut auf „Générer une invitation”.

9. Benutzer verwalten (nur Admins)

In der Kopfzeile der Event-Liste sehen Admins einen Link „Utilisateurs”. Auf der Benutzerseite:

Ajouter — neuen Operator oder Admin anlegen
Modifier — Rolle, Anzeigename, Sprache ändern
Désactiver — Soft-Delete (Benutzer kann sich nicht mehr anmelden, Audit-Log bleibt erhalten)

Sie können sich nicht selbst deaktivieren.

10. Einstellungen

Thème — Hell/Dunkel-Umschalter (in localStorage gespeichert)
Langue — fr/en/de
Sécurité — 2FA konfigurieren, Passwort ändern

Nach einer Passwortänderung werden Sie abgemeldet (alle Sitzungen widerrufen).