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á pořad ani podporovatel. 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 |
|---|---|---|
| Kanál studia | Ž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 pořadů | VOD katalog: filmy a seriály se sezónami a epizodami, kategoriemi a metadaty | Movies a Series, nebo úloha ingestu VOD |
| Úroveň předplatného | Bouquet: pojmenovaná sada kanálů, filmů nebo seriálů, kterou balíček zpřístupní | Bouquets, ze Streams a Movies / Series |
| Přístup podporovatele | 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 |
| Fakturační období | Datum expirace linky, obnovované balíčkem, kreditem nebo přes API | Datum expirace linky a trvání balíčku |
| Účet affiliate partnera nebo distributora | 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í |
| Integrace s obchodem nebo členstvím | Reseller API a webhooky: operace panelu z vašeho vlastního systému | Klíče Reseller API a webhooky v panelu resellera |
Předpoklady
Co mít před instalací.
- Server (Ubuntu 22.04 nebo 24.04) s veřejnou adresou nebo doménou a dostatečnou upstream šířkou pásma pro očekávané publikum.
- Hotové epizody, playout nebo encoder studia pro kanál a obchod na platformě s konektorem, nebo možnost volat HTTP API.
- Rozhodnutí o úrovních a affiliate partnerech: co každé předplatné uděluje a kdo ho smí prodávat.
Nasazení infrastruktury
Nejdřív jeden server, uzly s růstem publika.
- Spusťte instalátor na řídicím serveru a umístěte panel za reverse proxy s TLS; nastavte důvěryhodné proxy, aby pravidla IP viděla skutečnou adresu diváka.
- Nastavte základní URL přehrávání na veřejnou adresu, na kterou se vaše publikum připojuje.
- Zaregistrujte uzel v sekci Servery v regionu, kde sleduje mnoho podporovatelů; panel ho nainstaluje přes SSH a směruje k němu diváky tohoto regionu.
- Vytvořte partnerský účet (reseller) pro každého člena týmu, který spravuje katalog nebo podporovatele, s vlastní skupinou oprávnění.
Organizace obsahu
Pořady jako seriály, úrovně jako bouquety.
- Vytvořte kategorie podle žánru a jeden seriál na pořad se sezónou na dávku vydání a jednou epizodou na video.
- Vytvořte bouquet pro živý kanál, jeden pro volný nebo vstupní obsah a jeden pro každou vyšší úroveň.
- Vytvořte jeden balíček na úroveň s fakturačním obdobím jako dobou trvání, případně zkušební balíček pro nové návštěvníky a cenu v kreditech pro affiliate partnery.
- Držte archivní katalog ve vlastní kategorii, aby šel přesouvat mezi úrovněmi, aniž byste sahali na seriály.
Konfigurace partnerů (resellerů)
Affiliate partneři a distributoři.
- Vytvořte skupinu pro affiliate partnery jen s oprávněními k linkám, aby nemohli měnit katalog.
- Přidejte každého affiliate partnera jako resellera s touto skupinou a zůstatkem kreditů; cena jeho balíčku je to, co rozhodne studio.
- Distributor se sub-affiliate partnery může pod svým účtem vytvářet sub-resellery, až do pěti úrovní do hloubky.
Konfigurace přístupu podporovatelů
Jedna linka na podporovatele.
- Nainstalujte konektor svého obchodu (například WooCommerce) a zadejte klíč Reseller API a balíček odpovídající každému produktu.
- Při předplatném konektor zavolá create_line s balíčkem a ID požadavku; fakturační období je doba trvání balíčku.
- Nastavte maximální počet připojení na počet zařízení, která smí podporovatel používat, obvykle dvě nebo tři.
- Pro soutěž nebo spuštění vygenerujte aktivační kódy hromadně nebo přidejte linky v sekci Linky → přidat se zkušebním balíčkem.
Knihovna pořadů
Epizody na vyžádání.
- Nahrajte každou epizodu jako zdroj nebo ji naimportujte úlohou importu VOD; vyplňte název, sezónu, číslo epizody a metadata TMDB, pokud je pořad má.
- Přiřaďte každý seriál k bouquetům úrovní, které ho smějí sledovat.
- Před oznámením vydání zkontrolujte přehrávání testovací linkou každé úrovně.
Kanál studia
Kanál nepřetržitě.
- Přidejte živý stream pro playout studia (push RTMP) a umístěte ho do bouquetů každé úrovně, která kanál zahrnuje.
- Načtěte průvodce kanálu jako XMLTV, aby podporovatelé viděli, co běží, a zapněte catch-up u pořadů, které stojí za zopakování.
- Udržujte playout v chodu mezi vydáními vlastním plánovaným obsahem studia; panel stream jen přenáší.
Expirace předplatného
Přístup sleduje platbu.
- Linka vyprší na konci období svého balíčku; obchod ji obnoví přes renew_line, když přijde další platba.
- Přihlaste obchod k webhookům, aby posílal upomínku při line.expiring a snížil úroveň podporovatele při line.expired.
- Podporovatele, který zruší, obchod zakáže přes disable_line a linku lze později obnovit bez nového účtu.
Integrace s obchodem
Obchod prodává; přehrávač přehrává.
- Konektor vytváří, obnovuje a zakazuje linky v souladu s objednávkami; jakýkoli jiný obchod používá Reseller API a webhooky.
- Affiliate partneři vidí své linky ve svém panelu a Reseller API jim umožňuje to automatizovat.
- Pro diváky neexistuje jednotné přihlášení: podporovatelé se do přehrávače přihlašují údaji své linky, které jim pošle obchod.
Bezpečnostní hlediska
Chraňte předplatné, nejen server.
- Provozujte panel a základní URL přehrávání přes TLS a nastavte TRUSTED_PROXIES na svůj reverse proxy.
- Dvoufázové přihlášení pro každý účet panelu a skupiny oprávnění, aby affiliate partneři nemohli měnit katalog.
- Podepsané a vypršující odkazy pro přehrávání a limit připojení na linku; svažte linku se zemí, pokud je licence územní.
- Šifrované zálohy databáze s kopií mimo pracoviště a auditní log každé změny linek a katalogu.
Řešení potíží
Obvyklé první kontroly.
- Nový podporovatel po zaplacení nemůže sledovat: zkontrolujte volání konektoru obchodu v logu Reseller API a datum expirace linky.
- Podporovatel vidí obsah vyšší úrovně: zkontrolujte balíček linky a bouquety, které uděluje.
- Kanál se zastaví na konci cyklu playoutu: zkontrolujte push encoderu do živého streamu a stav sondování streamu.
- Prodej affiliate partnera se neobjeví: zkontrolujte jeho kredity a zda použitý balíček patří do jeho skupiny.