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ę subskrypcją ani punktem styku. 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 dealera lub partnera regionalnego | Konto partnera (reseller): delegowany panel z kredytami, uprawnieniami i własnymi liniami | Users → dodaj resellera; Groups dla jego uprawnień |
| Poziom kanałów lub pakiet dodatkowy | Bukiet: nazwany zestaw kanałów, filmów lub seriali przyznawany przez pakiet | Bouquets, ze Streams oraz Movies / Series |
| Kanał telewizyjny | 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) |
| Biblioteka VOD | Katalog VOD: filmy i seriale z sezonami i odcinkami, kategorie i metadane | Movies i Series lub zadanie pobierania VOD |
| Dostęp telewizyjny abonenta | 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 |
| Koniec okresu rozliczeniowego | Data wygaśnięcia linii, odnawiana przez pakiet, kredyt lub API | Data wygaśnięcia linii i czas trwania pakietu |
| Ekrany na subskrypcję | Maks. liczba połączeń linii: ile urządzeń może oglądać jednocześnie | Maks. liczba połączeń linii |
| Integracja rozliczeń i provisioningu | Reseller API i webhooki: operacje panelu z Twojego własnego systemu | Klucze Reseller API i webhooki w panelu resellera |
| Węzeł punktu styku | 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 w głównej lokalizacji (Ubuntu 22.04 lub 24.04), instalator, domenę lub adres osiągalny dla abonentów oraz serwer w każdym punkcie styku dla węzłów.
- Licencjonowane sygnały kanałów, bibliotekę VOD i system rozliczeń, w którym żyją subskrypcje.
- Decyzję o poziomach, długości okresu rozliczeniowego i o tym, którzy dealerzy dostaną konto partnerskie.
Wdrożenie infrastruktury
Główna lokalizacja, potem punkty styku.
- Uruchom instalator na serwerze głównym; umieść panel za swoim reverse proxy i ustaw TRUSTED_PROXIES, aby logi i reguły IP widziały prawdziwy adres abonenta.
- Ustaw bazę odtwarzania na publiczny adres, pod którym łączą się abonenci, oraz klucz licencji na serwerze.
- Zarejestruj węzeł na punkt styku w sekcji Serwery; panel instaluje go przez SSH albo węzeł rejestruje się jednorazowym kodem, i kieruje do niego pobliskich abonentów.
- Utwórz konto partnerskie (reseller) dla wsparcia lub zespołu rozliczeń z uprawnieniami tylko do linii.
Organizacja treści
Poziomy i pakiety jako bukiety.
- Dodaj kanały w sekcji Streamy, a bibliotekę VOD w sekcjach Filmy i Seriale, z kategoriami i źródłem EPG.
- Utwórz bukiety dla podstawowego zestawu kanałów, kanałów premium i biblioteki VOD.
- Utwórz jeden pakiet na poziom subskrypcji z bukietami, które przyznaje, okresem rozliczeniowym jako czasem trwania i ceną w kredytach.
- Utwórz krótki pakiet próbny na promocję lub dla nowego klienta.
Konfiguracja partnerów (resellerów)
Dealerzy z kredytami.
- Utwórz grupę dla dealerów z uprawnieniami do własnych linii i bez dostępu do katalogu i ustawień.
- Dodaj każdego regionalnego dealera jako konto partnerskie z tą grupą, pakietami, które może sprzedawać, i saldem kredytów; dealer może mieć sub-resellerów do pięciu poziomów w głąb.
- Webhook credits.low i powiadomienie o niskim saldzie kredytów informują dealera, że ma doładować konto, zanim sprzedaż się zatrzyma.
Konfiguracja linii abonentów
Jedna linia na subskrypcję.
- System rozliczeń tworzy linię, gdy zaczyna się subskrypcja, przez konektor lub action=create_line w Reseller API z pakietem poziomu i identyfikatorem żądania.
- Ustaw maksymalną liczbę połączeń na poziom, czyli liczbę ekranów, których gospodarstwo domowe może używać jednocześnie.
- Przypisz linię do adresu, kraju lub dostawcy internetu abonenta, gdy oferta jest tylko dla Twojej sieci.
- Na pilotaż lub zgłoszenie wsparcia dodaj linie w sekcji Linie → dodaj i przekaż dane logowania.
Biblioteka VOD
Katalog na żądanie.
- Dodaj filmy i seriale z sezonami i odcinkami, zaimportowane zadaniem importu VOD lub przesłane, z metadanymi TMDB dla plakatów i opisów.
- Pogrupuj tytuły w bukiety według poziomu lub dodatku, aby pakiet przyznawał dokładnie to, co obejmuje subskrypcja.
- Węzły buforują pliki VOD, więc popularne tytuły są serwowane z punktu styku w pobliżu abonenta.
Kanały na żywo
Zestaw kanałów.
- Dodaj każdy licencjonowany kanał w sekcji Streamy wraz z jego sygnałem i włączaj catch-up lub timeshift tylko tam, gdzie pozwalają na to prawa.
- Dodaj źródło EPG, aby aplikacje i dekodery pokazywały przewodnik programowy.
- Każdy węzeł pobiera kanał na żywo raz z origin i rozprowadza go do swoich abonentów.
Wygasanie, odnawianie i anulowanie
Okres rozliczeniowy jako ważność linii.
- Linia trwa przez okres swojego pakietu; system rozliczeń odnawia ją co okres przez action=renew_line lub przez konektor.
- Gdy subskrypcja wygasa lub jest anulowana, system rozliczeń wywołuje action=disable_line, a przy reaktywacji włącza linię ponownie.
- Zasubskrybuj webhooki w systemie rozliczeń, aby uzgadniać wygasające i wygasłe linie z jego rejestrami.
Integracja z rozliczeniami
Rozliczenia sterują dostępem; odtwarzacz odtwarza.
- Zainstaluj konektor dla swojego systemu rozliczeń po jego stronie (WHMCS, Blesta, Odoo i inne) albo wywołuj Reseller API z kluczem i identyfikatorem żądania z własnego systemu.
- Nie ma logowania jednokrotnego dla widzów: abonent loguje się do aplikacji lub dekodera danymi linii, które system rozliczeń może pokazać w panelu klienta.
- Używaj kluczy Admin API z flagą tylko do odczytu, listą dozwolonych IP i datą ważności dla narzędzi raportowych.
Kwestie bezpieczeństwa
Utrzymaj usługę dla abonentów.
- Umieść panel za reverse proxy z TLS i ustaw TRUSTED_PROXIES; ruch zarządzający węzłów trzymaj w sieci prywatnej.
- Logowanie dwuskładnikowe dla każdego konta panelu i grupy uprawnień dla wsparcia i dealerów; reCAPTCHA lub Turnstile przy logowaniu.
- Podpisane i wygasające linki odtwarzania, limit połączeń na subskrypcję oraz przypisanie do adresu, kraju lub dostawcy internetu tam, gdzie pasuje.
- Szyfrowane kopie zapasowe bazy z kopią zewnętrzną oraz dziennik audytu każdej zmiany linii i kredytów.
Rozwiązywanie problemów
Typowe pierwsze kontrole.
- Abonent nie ma telewizji: sprawdź, czy linia jest włączona i nie wygasła, a następnie wywołanie systemu rozliczeń w logu wywołań Reseller API.
- Brakuje kanału dla jednego poziomu: sprawdź bukiety pakietu tego poziomu.
- Punkt styku buforuje: sprawdź heartbeat jego węzła i czy jego abonenci są do niego kierowani.
- Dealer nie może utworzyć linii: sprawdź jego kredyty i czy pakiet jest jednym z tych, które może sprzedawać.