Te przewodniki odwzorowują pojęcia branży na obiekty, które platforma ma dziś (bukiety, linie, pakiety, konta partnerów, węzły, API). To odwzorowania koncepcyjne, a nie funkcje specyficzne dla branż, a konto partnera jest kontem delegowanym, a nie odizolowanym najemcą.
Odwzorowanie koncepcyjne
Nic w panelu nie nazywa się sklepem ani franczyzobiorcą. Tabela mówi, który obiekt pełni jaką rolę; kolejne rozdziały konfigurują je w tej kolejności.
| W Twojej branży | Na platformie | Gdzie w panelu |
|---|---|---|
| Kanał sklepowy lub kolekcja szkoleń | Bukiet: nazwany zestaw kanałów, filmów lub seriali przyznawany przez pakiet | Bouquets, ze Streams oraz Movies / Series |
| Kanał sklepowy | Kanał na żywo: strumień ze źródłami, EPG i formatami wyjściowymi | Streams → dodaj strumień na żywo (adres źródła lub wysyłka RTMP) |
| Wideo szkoleniowe i produktowe | Katalog VOD: filmy i seriale z sezonami i odcinkami, kategorie i metadane | Movies i Series lub zadanie pobierania VOD |
| Ekran sklepu lub dostęp pracownika | Linia: jeden dostęp z pakietem, bukietami, datą wygaśnięcia, limitem połączeń i wyjściami | Lines → dodaj, albo kody aktywacyjne, albo Reseller API |
| Konto franczyzobiorcy | Konto partnera (reseller): delegowany panel z kredytami, uprawnieniami i własnymi liniami | Users → dodaj resellera; Groups dla jego uprawnień |
| Węzeł regionalny | Węzły streamingu: serwery brzegowe zarejestrowane z panelu, po jednym na lokalizację lub budynek | Servers → dodaj węzeł, instalowany przez SSH |
| Ekrany lub urządzenia na linię | Maks. liczba połączeń linii: ile urządzeń może oglądać jednocześnie | Maks. liczba połączeń linii |
Wymagania wstępne
Co mieć przed instalacją.
- Serwer centrali (Ubuntu 22.04 lub 24.04), instalator oraz serwer dla każdego regionu z wieloma sklepami, osiągalny z tych sklepów.
- Treść kanału sklepowego (enkoder lub zapętlone źródło), nagrania wdrożeniowe i szkoleń produktowych oraz ekrany lub odtwarzacze multimediów w sklepach.
- Decyzję o strukturze franczyzy: które regiony dostają węzeł i kto u każdego franczyzobiorcy zarządza liniami.
Wdrożenie infrastruktury
Najpierw centrala, potem regiony.
- Uruchom instalator na serwerze centrali i ustaw bazowy URL odtwarzania na adres osiągalny dla sklepów, za TLS.
- Dodaj kanał sklepowy w sekcji Streamy, a nagrania szkoleniowe w sekcji Filmy, i sprawdź je w odtwarzaczu webowym.
- Zarejestruj węzeł na region w sekcji Serwery; panel instaluje go przez SSH albo węzeł rejestruje się jednorazowym kodem, i kieruje do niego sklepy tego regionu.
- Utwórz konto partnerskie dla zespołu treści w centrali z uprawnieniami do katalogu i bez uprawnień do linii sklepów.
Organizacja treści
Kanał sklepowy i biblioteka szkoleń.
- Utwórz stream na żywo dla kanału sklepowego i umieść go we własnym bukiecie.
- Utwórz kategorie według tematu i serial na kurs szkoleniowy, z jednym odcinkiem na lekcję; dodaj jeden bukiet na rolę (sprzedawcy, kierownicy, nowi pracownicy).
- Utwórz jeden pakiet dla ekranów sklepowych i jeden pakiet na rolę, każdy przyznający swoje bukiety i mający okres dostępu jako czas trwania.
- Przekaż franczyzobiorcom pakiety, które mogą odsprzedawać swoim sklepom i personelowi.
Konfiguracja partnerów (resellerów)
Jedno konto partnerskie na franczyzobiorcę.
- Utwórz grupę z uprawnieniami ograniczonymi do linii, bez zmian w katalogu.
- Dodaj każdego franczyzobiorcę w sekcji Użytkownicy → dodaj resellera, z tą grupą, jego pakietami i saldem kredytów.
- Franczyzobiorca z kilkoma regionami może dodać sub-resellera na region, każdego z własnymi sklepami.
Konfiguracja linii sklepów i personelu
Linia na ekran i na pracownika.
- Utwórz jedną linię na ekran sklepowy w sekcji Linie → dodaj z nazwą sklepu i pakietem sklepowym; franczyzobiorca robi to samo dla swoich sklepów.
- Ustaw maksymalną liczbę połączeń na liczbę ekranów w sklepie, a dla pracownika na dwa (sala sprzedaży i telefon).
- Przypisz linię sklepu do adresu sklepu, gdy ma on stały adres, aby dane logowania nie działały gdzie indziej.
- Skonfiguruj odtwarzacz ekranu raz (M3U, Xtream Codes API lub adres odtwarzacza webowego) i trzymaj dane logowania w dokumentacji sklepu.
Wideo szkoleniowe i produktowe
Biblioteka dla personelu.
- Prześlij każdy kurs szkoleniowy jako serial, a każdy film produktowy jako film, albo zaimportuj je zadaniem importu VOD do katalogu mediów.
- Umieść nagrania w bukiecie właściwej roli przez ich kategorie.
- Sprawdź linią testową, co widzi każda rola, zanim otworzysz bibliotekę franczyzobiorcom.
Kanał sklepowy
Jeden kanał dla wszystkich ekranów.
- Dodaj kanał sklepowy jako stream na żywo, zasilany enkoderem centrali przez RTMP lub zapętlonym źródłem.
- Włącz catch-up dla szkoleń nadawanych na żywo i prześlij nagranie do biblioteki po ich zakończeniu.
- Węzły w regionach pobierają kanał raz z origin i obsługują swoje sklepy, więc łącza sklepów nie są nasycone.
Wygasanie i odnawianie
Dostęp podąża za sklepem lub umową.
- Linia wygasa z końcem okresu swojego pakietu; franczyzobiorca odnawia ją pakietem lub kredytem.
- Wyłącz linię zamkniętego sklepu lub odchodzącego pracownika.
- Zasubskrybuj webhooki w systemie zarządzania franczyzą lub HR, aby widzieć linie, które zaraz wygasną lub już wygasły.
Integracja z systemami franczyzy lub HR
Systemy sterują liniami; odtwarzacz odtwarza.
- Utwórz klucz Reseller API dla systemu zarządzania franczyzą lub HR; wywołuje on create_line, renew_line, enable_line i disable_line, z identyfikatorem żądania przy każdym zapisie.
- Użyj konektora handlowego, gdy rozliczasz franczyzobiorców za usługę; każdy inny system korzysta z Reseller API i webhooków.
- Nie ma logowania jednokrotnego dla widzów: personel loguje się do odtwarzacza danymi swojej linii.
Kwestie bezpieczeństwa
Utrzymaj każdy sklep na jego własnych liniach.
- Udostępniaj panel za reverse proxy z TLS i ustaw TRUSTED_PROXIES, aby dziennik audytu i reguły IP widziały prawdziwe adresy.
- Logowanie dwuskładnikowe dla każdego konta centrali; franczyzobiorcy dostają grupę uprawnień ograniczoną do własnych linii.
- Limit połączeń na linię, podpisane i wygasające linki odtwarzania oraz przypisanie ekranów sklepowych do adresu.
- Włącz szyfrowaną kopię zapasową bazy z kopią zewnętrzną i używaj dziennika audytu do przeglądu zmian linii i katalogu.
Rozwiązywanie problemów
Typowe pierwsze kontrole.
- Ekran sklepu jest czarny: sprawdź, czy jego linia jest włączona i nie wygasła, przypisanie do adresu oraz limit połączeń, jeśli z linii korzysta drugie urządzenie.
- Region buforuje: sprawdź heartbeat węzła regionalnego i czy sklepy są do niego kierowane.
- Franczyzobiorca nie może tworzyć linii: sprawdź jego saldo kredytów, uprawnienia jego grupy i przypisane mu pakiety.
- Dziennik audytu pokazuje adres proxy: ustaw TRUSTED_PROXIES na to proxy i zrestartuj panel.