Diese Anleitungen bilden die Begriffe einer Branche auf die Objekte ab, die die Plattform heute hat (Bouquets, Lines, Pakete, Partnerkonten, Nodes, die API). Es sind konzeptionelle Zuordnungen, keine branchenspezifischen Funktionen, und ein Partnerkonto ist ein delegiertes Konto, kein isolierter Mandant.
Konzeptionelle Zuordnung
Nichts im Panel heißt Filiale oder Franchisenehmer. Die Tabelle zeigt, welches Objekt welche Rolle übernimmt; die folgenden Kapitel richten sie in dieser Reihenfolge ein.
| In Ihrer Branche | Auf der Plattform | Wo im Panel |
|---|---|---|
| Filialkanal oder Schulungssammlung | Bouquet: eine benannte Gruppe von Kanälen, Filmen oder Serien, die ein Paket freigibt | Bouquets, aus Streams und Movies / Series |
| Filialkanal | Live-Kanal: ein Stream mit seinen Quellen, EPG und Ausgabeformaten | Streams → Live-Stream hinzufügen (Quell-URL oder RTMP-Push) |
| Schulungs- und Produktvideo | VOD-Katalog: Filme und Serien mit Staffeln und Folgen, Kategorien und Metadaten | Movies und Series oder der VOD-Ingest-Job |
| Filialbildschirm oder Mitarbeiterzugang | Line: ein Zugang mit Paket, Bouquets, Ablaufdatum, Verbindungslimit und Ausgaben | Lines → hinzufügen, oder Aktivierungscodes, oder die Reseller API |
| Konto eines Franchisenehmers | Partnerkonto (Reseller): ein delegiertes Dashboard mit Credits, Berechtigungen und eigenen Lines | Users → Reseller hinzufügen; Groups für seine Berechtigungen |
| Regionaler Node | Streaming-Nodes: aus dem Panel registrierte Edge-Server, einer pro Standort oder Gebäude | Servers → Node hinzufügen, per SSH installiert |
| Bildschirme oder Geräte pro Line | Max. Verbindungen der Line: wie viele Geräte gleichzeitig schauen dürfen | Die max. Verbindungen der Line |
Voraussetzungen
Was vor der Installation bereitstehen sollte.
- Ein Server der Zentrale (Ubuntu 22.04 oder 24.04), der Installer und ein Server pro Region mit vielen Filialen, der von diesen aus erreichbar ist.
- Der Inhalt des Filialkanals (ein Encoder oder eine Schleifenquelle), die Aufzeichnungen zu Einarbeitung und Produktschulung und die Bildschirme oder Mediaplayer in den Filialen.
- Eine Entscheidung zur Franchise-Struktur: welche Regionen einen Node erhalten und wer bei jedem Franchisenehmer die Lines verwaltet.
Infrastruktur bereitstellen
Zuerst die Zentrale, dann die Regionen.
- Führen Sie den Installer auf dem Server der Zentrale aus und setzen Sie die Wiedergabe-Basis-URL auf eine Adresse, die die Filialen erreichen können, hinter TLS.
- Fügen Sie den Filialkanal unter Streams und die Schulungsaufzeichnungen unter Movies hinzu und prüfen Sie sie im Web-Player.
- Registrieren Sie unter Servers einen Node pro Region; das Panel installiert ihn per SSH, oder der Node registriert sich mit einem Einmalcode, und leitet die Filialen dieser Region zu ihm.
- Legen Sie ein Partnerkonto für das Content-Team der Zentrale an, mit Berechtigungen für den Katalog und keinen für die Lines der Filialen.
Inhalte organisieren
Der Filialkanal und die Schulungsbibliothek.
- Legen Sie einen Live-Stream für den Filialkanal an und legen Sie ihn in ein eigenes Bouquet.
- Legen Sie Kategorien pro Thema und eine Serie pro Schulungskurs an, mit einer Folge pro Lektion; fügen Sie ein Bouquet pro Rolle hinzu (Verkaufspersonal, Filialleitung, Neueinsteiger).
- Legen Sie ein Paket für die Filialbildschirme und ein Paket pro Rolle an, jeweils mit seinen Bouquets und dem Zugangszeitraum als Laufzeit.
- Geben Sie Franchisenehmern die Pakete, die sie an ihre Filialen und Mitarbeitenden weiterverkaufen dürfen.
Partner-Konfiguration (Reseller)
Ein Partnerkonto pro Franchisenehmer.
- Legen Sie eine Gruppe mit auf Lines beschränkten Berechtigungen an, ohne Katalogänderungen.
- Fügen Sie jeden Franchisenehmer unter Users → Reseller hinzufügen hinzu, mit dieser Gruppe, seinen Paketen und einem Credit-Guthaben.
- Ein Franchisenehmer mit mehreren Regionen kann pro Region einen Sub-Reseller hinzufügen, jeweils mit eigenen Filialen.
Filial- und Mitarbeiter-Lines konfigurieren
Eine Line pro Bildschirm und pro Mitarbeitendem.
- Legen Sie unter Lines → hinzufügen pro Filialbildschirm eine Line an, mit dem Namen der Filiale und dem Filialpaket; der Franchisenehmer tut dasselbe für seine eigenen Filialen.
- Setzen Sie die maximalen Verbindungen auf die Zahl der Bildschirme in der Filiale und auf zwei für einen Mitarbeitenden (Verkaufsfläche und Handy).
- Binden Sie eine Filial-Line an die Adresse der Filiale, wenn diese eine feste hat, damit die Zugangsdaten anderswo nicht funktionieren.
- Konfigurieren Sie den Player des Bildschirms einmal (M3U, Xtream Codes API oder die Adresse des Web-Players) und bewahren Sie die Zugangsdaten in der Akte der Filiale auf.
Schulungs- und Produktvideo
Die Bibliothek für Mitarbeitende.
- Laden Sie jeden Schulungskurs als Serie und jeden Produktfilm als Film hoch oder übernehmen Sie sie mit dem VOD-Ingest-Job in das Medienverzeichnis.
- Legen Sie die Aufzeichnungen über ihre Kategorien in das Bouquet der richtigen Rolle.
- Prüfen Sie mit einer Test-Line, was jede Rolle sieht, bevor Sie die Bibliothek für die Franchisenehmer öffnen.
Der Filialkanal
Ein Kanal für alle Bildschirme.
- Fügen Sie den Filialkanal als Live-Stream hinzu, gespeist vom Encoder der Zentrale über RTMP oder von einer Schleifenquelle.
- Aktivieren Sie Catch-up für die Schulungen, die live gesendet werden, und laden Sie die Aufzeichnung danach in die Bibliothek hoch.
- Die Nodes in den Regionen holen den Kanal einmal vom Origin und bedienen ihre Filialen, sodass die Anbindungen der Filialen nicht ausgelastet werden.
Ablauf und Verlängerung
Der Zugang folgt der Filiale oder dem Vertrag.
- Eine Line läuft am Ende des Zeitraums ihres Pakets ab; der Franchisenehmer verlängert sie mit einem Paket oder einem Credit.
- Deaktivieren Sie die Line einer geschlossenen Filiale oder eines ausscheidenden Mitarbeitenden.
- Abonnieren Sie die Webhooks für das Franchise-Management- oder HR-System, um Lines zu sehen, die bald ablaufen oder bereits abgelaufen sind.
Anbindung an Franchise- oder HR-Systeme
Systeme steuern die Lines; der Player spielt ab.
- Erstellen Sie einen Reseller-API-Schlüssel für das Franchise-Management- oder HR-System; es ruft create_line, renew_line, enable_line und disable_line auf, mit einer Request-ID bei jedem Schreibzugriff.
- Nutzen Sie einen Commerce-Konnektor, wenn Sie Franchisenehmer für den Dienst abrechnen; jedes andere System nutzt die Reseller API und Webhooks.
- Es gibt kein Single Sign-on für Zuschauer: Mitarbeitende melden sich im Player mit den Zugangsdaten ihrer Line an.
Sicherheitsaspekte
Jede Filiale auf ihren eigenen Lines halten.
- Betreiben Sie das Panel hinter einem Reverse Proxy mit TLS und setzen Sie TRUSTED_PROXIES, damit das Audit-Log und die IP-Regeln echte Adressen sehen.
- Zwei-Faktor-Anmeldung für jedes Konto der Zentrale; Franchisenehmer erhalten eine auf ihre eigenen Lines beschränkte Berechtigungsgruppe.
- Ein Verbindungslimit pro Line, signierte und ablaufende Wiedergabelinks und Adressbindung für die Filialbildschirme.
- Aktivieren Sie das verschlüsselte Datenbank-Backup mit einer Off-Site-Kopie und nutzen Sie das Audit-Log, um Änderungen an Lines und Katalog zu prüfen.
Fehlersuche
Die üblichen ersten Prüfungen.
- Ein Filialbildschirm ist schwarz: Prüfen Sie, ob seine Line aktiviert und nicht abgelaufen ist, die Adressbindung und das Verbindungslimit, falls ein zweites Gerät die Line nutzt.
- Eine Region puffert: Prüfen Sie den Heartbeat des regionalen Nodes und ob die Filialen zu ihm geleitet werden.
- Ein Franchisenehmer kann keine Lines anlegen: Prüfen Sie sein Credit-Guthaben, die Berechtigungen seiner Gruppe und die ihm zugewiesenen Pakete.
- Das Audit-Log zeigt die Adresse des Proxys: Setzen Sie TRUSTED_PROXIES auf den Proxy und starten Sie das Panel neu.