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ę mieszkaniem ani mieszkańcem. 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 |
|---|---|---|
| Konto zarządcy nieruchomości | Konto partnera (reseller): delegowany panel z kredytami, uprawnieniami i własnymi liniami | Users → dodaj resellera; Groups dla jego uprawnień |
| Zestaw kanałów | Bukiet: nazwany zestaw kanałów, filmów lub seriali przyznawany przez pakiet | Bouquets, ze Streams oraz Movies / Series |
| Kanał lub kanał informacyjny | 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) |
| Filmy powitalne i komunikaty | Katalog VOD: filmy i seriale z sezonami i odcinkami, kategorie i metadane | Movies i Series lub zadanie pobierania VOD |
| Dostęp mieszkania | 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 |
| Okres najmu lub zamieszkania | Data wygaśnięcia linii, odnawiana przez pakiet, kredyt lub API | Data wygaśnięcia linii i czas trwania pakietu |
| Węzeł budynku | Węzły streamingu: serwery brzegowe zarejestrowane z panelu, po jednym na lokalizację lub budynek | Servers → dodaj węzeł, instalowany przez SSH |
Wymagania wstępne
Co mieć przed instalacją.
- Serwer dla zarządcy (Ubuntu 22.04 lub 24.04), instalator oraz serwer dla każdego budynku, który ma dostęp do sieci mieszkańców.
- Sygnały kanałów, które wspólnota może retransmitować (adresy pull lub RTMP), komunikaty i filmy powitalne zarządcy oraz urządzenia mieszkańców (dekodery, telewizory Smart TV z aplikacją odtwarzacza lub przeglądarka).
- Decyzję o rodzajach mieszkań (standardowe, senioralne, studenckie) i o tym, kto u zarządcy otwiera i odnawia linie.
Wdrożenie infrastruktury
Serwer centralny, potem węzeł na budynek.
- Uruchom instalator na serwerze centralnym i ustaw bazowy URL odtwarzania na adres dostępny dla budynków.
- Dodaj sygnały kanałów w sekcji Streamy, a komunikaty w sekcji Filmy, i sprawdź je w odtwarzaczu webowym.
- Zarejestruj węzeł na budynek w sekcji Serwery; panel instaluje go przez SSH albo węzeł rejestruje się jednorazowym kodem, i kieruje do niego mieszkańców tego budynku.
- Dodaj zarządcę nieruchomości w sekcji Użytkownicy → dodaj resellera, z grupą, która pozwala na linie i nie pozwala na zmiany katalogu.
Organizacja treści
Zestawy kanałów na rodzaj mieszkania.
- Utwórz jeden bukiet na zestaw z kanałów każdego rodzaju mieszkania oraz bukiet z informacjami zarządcy.
- Dodaj bukiet informacyjny do każdego pakietu, aby każdy mieszkaniec otrzymywał komunikaty.
- Utwórz jeden pakiet na rodzaj mieszkania z jego bukietami i czasem trwania odpowiadającym najmowi lub okresowi zamieszkania.
- Uporządkuj kanały i nadaj im logo, aby menu w telewizorze dobrze się czytało.
Konfiguracja partnerów (resellerów)
Zarządca nieruchomości jako konto delegowane.
- Utwórz grupę z uprawnieniami ograniczonymi do linii, bez dostępu do katalogu i serwerów.
- Dodaj każdego zarządcę nieruchomości jako resellera z tą grupą, pakietami jego mieszkań i saldem kredytów.
- Zarządca kilku budynków może dodać sub-resellera na budynek, każdego z własnymi mieszkaniami i kredytami.
Konfiguracja mieszkania (linii)
Jedna linia na mieszkanie, nazwana jego numerem.
- Utwórz jedną linię na mieszkanie w sekcji Linie → dodaj, z numerem mieszkania jako nazwą i pakietem tego rodzaju mieszkania.
- Ustaw maksymalną liczbę połączeń na liczbę telewizorów w mieszkaniu.
- Użyj kodu aktywacyjnego zamiast hasła, gdy mieszkaniec ma wpisać krótki kod na urządzeniu.
- Skonfiguruj urządzenie raz (Xtream Codes API lub M3U z danymi linii albo portal MAG lub Enigma2); dane zostają przy mieszkaniu, dopóki linia nie dostanie nowych.
Filmy powitalne i komunikaty
Filmy zarządcy na żądanie.
- Prześlij film powitalny, regulamin domu i instrukcje konserwacji jako filmy, z kategorią na temat.
- Umieść je w bukiecie informacyjnym, aby każdy pakiet je zawierał.
- Zastąp film z panelu, gdy zmieniają się informacje; mieszkańcy od razu widzą nową wersję.
Kanały i kanał informacyjny
Zestaw kanałów i kanał komunikatów jako streamy na żywo.
- Dodaj każdy licencjonowany kanał w sekcji Streamy wraz z jego sygnałem oraz źródło EPG, aby przewodnik w telewizorze pokazywał programy.
- Dodaj kanał informacyjny jako stream na żywo, zasilany enkoderem przez RTMP lub zapętlonym źródłem, i umieść go w bukiecie informacyjnym.
- Trzymaj kanały z ograniczeniami terytorialnymi w bukietach przyznawanych wyłącznie przez właściwe pakiety.
Wprowadzenie, wyprowadzenie i wygasanie
Zamieszkanie jako ważność linii.
- Linia wygasa z końcem okresu swojego pakietu; odnawiaj ją pakietem lub kredytem na każdy nowy okres najmu.
- Gdy mieszkaniec się wyprowadza, wyłącz linię; następny mieszkaniec włącza ją ponownie z nowymi danymi logowania, więc nic nie zostaje przy dawnym gospodarstwie.
- Zasubskrybuj webhooki w systemie administracji mieszkaniowej lub u zarządcy, aby widzieć linie, które zaraz wygasną lub już wygasły.
Integracja z systemem administracji lub rozliczeń
Systemy otwierają dostęp; odtwarzacz odtwarza.
- Utwórz klucz Reseller API dla systemu administracji lub rozliczeń; wywołuje on create_line, renew_line, enable_line i disable_line oraz wysyła identyfikator żądania przy każdym zapisie.
- Użyj konektora handlowego, gdy mieszkańcy kupują dodatkowe pakiety online; każdy inny system korzysta z Reseller API i webhooków.
- Nie ma logowania jednokrotnego dla widzów: mieszkaniec loguje się do odtwarzacza danymi linii.
Kwestie bezpieczeństwa
Utrzymaj usługę wewnątrz wspólnoty.
- 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 zarządu; zarządcy nieruchomości dostają grupę uprawnień ograniczoną do linii.
- Limit połączeń na linię, podpisane i wygasające linki odtwarzania oraz przypisanie do adresu tam, gdzie urządzenia mają stałe adresy.
- Włącz szyfrowaną kopię zapasową bazy z kopią zewnętrzną; znajdują się w niej dane logowania linii.
Rozwiązywanie problemów
Typowe pierwsze kontrole.
- Mieszkanie nie ma telewizji: sprawdź, czy jego linia jest włączona i nie wygasła, a następnie dane urządzenia i adres odtwarzania.
- Budynek buforuje wieczorem: sprawdź heartbeat węzła budynku i czy jego mieszkańcy są do niego kierowani.
- Brakuje kanału dla jednego rodzaju mieszkania: sprawdź bukiety tego pakietu.
- Zarządca nie może tworzyć linii: sprawdź saldo kredytów resellera, uprawnienia jego grupy i przypisane mu pakiety.