Tito průvodci promítají pojmy oboru do objektů, které platforma dnes má (bouquety, linky, balíčky, partnerské účty, uzly, API). Jde o konceptuální mapování, ne o funkce specifické pro obor, a partnerský účet je delegovaný účet, ne izolovaný tenant.
Konceptuální mapování
Nic v panelu se nenazývá předplatné ani bod přítomnosti. Tabulka říká, který objekt hraje jakou roli; následující kapitoly je nastavují v tomto pořadí.
| Ve vašem oboru | Na platformě | Kde v panelu |
|---|---|---|
| Účet dealera nebo regionálního partnera | Partnerský účet (reseller): delegovaný panel s kredity, oprávněními a vlastními linkami | Users → přidat resellera; Groups pro jeho oprávnění |
| Úroveň kanálů nebo doplňkový balík | Bouquet: pojmenovaná sada kanálů, filmů nebo seriálů, kterou balíček zpřístupní | Bouquets, ze Streams a Movies / Series |
| Televizní kanál | Živý kanál: stream se svými zdroji, EPG a výstupními formáty | Streams → přidat živý stream (URL zdroje nebo RTMP push) |
| Knihovna VOD | VOD katalog: filmy a seriály se sezónami a epizodami, kategoriemi a metadaty | Movies a Series, nebo úloha ingestu VOD |
| Televizní přístup předplatitele | Linka: jeden přístup se svým balíčkem, bouquety, expirací, limitem připojení a výstupy | Lines → přidat, nebo aktivační kódy, nebo Reseller API |
| Konec fakturačního období | Datum expirace linky, obnovované balíčkem, kreditem nebo přes API | Datum expirace linky a trvání balíčku |
| Obrazovky na předplatné | Max. připojení linky: kolik zařízení smí sledovat současně | Max. připojení linky |
| Integrace fakturace a provisioningu | Reseller API a webhooky: operace panelu z vašeho vlastního systému | Klíče Reseller API a webhooky v panelu resellera |
| Uzel bodu přítomnosti | Streamovací uzly: hraniční servery zaregistrované z panelu, jeden na lokalitu nebo budovu | Servers → přidat uzel, instalovaný přes SSH |
Předpoklady
Co mít před instalací.
- Server v hlavní lokalitě (Ubuntu 22.04 nebo 24.04), instalátor, doménu nebo adresu dostupnou předplatitelům a server v každém bodě přítomnosti pro uzly.
- Licencované signály kanálů, knihovnu VOD a fakturační systém, v němž žijí předplatná.
- Rozhodnutí o úrovních, jak dlouho trvá fakturační období a kteří dealeři dostanou partnerský účet.
Nasazení infrastruktury
Hlavní lokalita, potom body přítomnosti.
- Spusťte instalátor na hlavním serveru; umístěte panel za svůj reverse proxy a nastavte TRUSTED_PROXIES, aby logy a pravidla IP viděly skutečnou adresu předplatitele.
- Nastavte základ přehrávání na veřejnou adresu, na kterou se předplatitelé připojují, a licenční klíč na serveru.
- Zaregistrujte uzel na bod přítomnosti v sekci Servery; panel ho nainstaluje přes SSH, nebo se uzel zaregistruje jednorázovým kódem, a směruje k němu blízké předplatitele.
- Vytvořte partnerský účet (reseller) pro podporu nebo fakturační tým s oprávněními jen k linkám.
Organizace obsahu
Úrovně a balíky jako bouquety.
- Přidejte kanály v sekci Streamy a knihovnu VOD v sekcích Filmy a Seriály, s kategoriemi a zdrojem EPG.
- Vytvořte bouquety pro základní nabídku, prémiové kanály a knihovnu VOD.
- Vytvořte jeden balíček na úroveň předplatného s bouquety, které uděluje, fakturačním obdobím jako dobou trvání a cenou v kreditech.
- Vytvořte krátký zkušební balíček pro akci nebo nového zákazníka.
Konfigurace partnerů (resellerů)
Dealeři s kredity.
- Vytvořte skupinu pro dealery s oprávněními k vlastním linkám a bez přístupu ke katalogu a nastavení.
- Přidejte každého regionálního dealera jako partnerský účet s touto skupinou, balíčky, které smí prodávat, a zůstatkem kreditů; dealer může mít sub-resellery až do pěti úrovní do hloubky.
- Webhook credits.low a upozornění na nízký zůstatek kreditů dealerovi řeknou, aby dobil, než se prodej zastaví.
Konfigurace linek předplatitelů
Jedna linka na předplatné.
- Fakturace vytvoří linku při začátku předplatného, přes konektor nebo action=create_line v Reseller API s balíčkem úrovně a ID požadavku.
- Nastavte maximální počet připojení na úroveň, tedy počet obrazovek, které smí domácnost používat současně.
- Svažte linku s adresou, zemí nebo ISP předplatitele, když je nabídka jen pro vaši síť.
- Pro pilotní provoz nebo případ podpory přidejte linky v sekci Linky → přidat a předejte přihlašovací údaje.
Knihovna VOD
Katalog na vyžádání.
- Přidejte filmy a seriály se sezónami a epizodami, naimportované úlohou importu VOD nebo nahrané, s metadaty TMDB pro plakáty a popisy.
- Seskupte tituly do bouquetů podle úrovně nebo doplňku, aby balíček udělil přesně to, co předplatné zahrnuje.
- Uzly cachují soubory VOD, takže oblíbené tituly se servírují z bodu přítomnosti blízko předplatitele.
Živé kanály
Nabídka kanálů.
- Přidejte každý licencovaný kanál v sekci Streamy s jeho signálem a zapínejte catch-up nebo timeshift jen tam, kde to práva dovolují.
- Přidejte zdroj EPG, aby aplikace a boxy ukazovaly programového průvodce.
- Každý uzel si bere živý kanál jednou z originu a rozvádí ho svým předplatitelům.
Expirace, obnovení a zrušení
Fakturační období jako platnost linky.
- Linka trvá po dobu období svého balíčku; fakturace ji každé období obnoví přes action=renew_line nebo přes konektor.
- Když předplatné vyprší nebo je zrušeno, fakturace zavolá action=disable_line a při reaktivaci linku znovu povolí.
- Přihlaste fakturaci k webhookům, aby sladila vypršující a vypršené linky se svými záznamy.
Integrace s fakturací
Fakturace řídí přístup; přehrávač přehrává.
- Nainstalujte konektor pro svůj fakturační systém na jeho straně (WHMCS, Blesta, Odoo a další), nebo volejte Reseller API s klíčem a ID požadavku z vlastního systému.
- Pro diváky neexistuje jednotné přihlášení: předplatitel se do aplikace nebo boxu přihlašuje údaji linky, které může fakturace ukázat v zákaznické zóně.
- Pro reportovací nástroje používejte klíče Admin API s příznakem jen pro čtení, allow-listem IP a datem expirace.
Bezpečnostní hlediska
Držte službu pro předplatitele.
- Umístěte panel za reverse proxy s TLS a nastavte TRUSTED_PROXIES; řídicí provoz uzlů držte v privátní síti.
- Dvoufázové přihlášení pro každý účet panelu a skupiny oprávnění pro podporu a dealery; reCAPTCHA nebo Turnstile při přihlášení.
- Podepsané a vypršující odkazy pro přehrávání, limit připojení na předplatné a svázání s adresou, zemí nebo ISP tam, kde to sedí.
- Šifrované zálohy databáze s kopií mimo pracoviště a auditní log každé změny linek a kreditů.
Řešení potíží
Obvyklé první kontroly.
- Předplatitel nemá televizi: zkontrolujte, zda je linka povolená a nevypršela, poté volání fakturace v logu volání Reseller API.
- Pro jednu úroveň chybí kanál: zkontrolujte bouquety balíčku dané úrovně.
- Bod přítomnosti se zasekává: zkontrolujte heartbeat jeho uzlu a zda jsou k němu jeho předplatitelé směrováni.
- Dealer nemůže vytvořit linku: zkontrolujte jeho kredity a zda je balíček jedním z těch, které smí prodávat.