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á byt ani obyvatel. 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 správce nemovitosti | 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í |
| Nabídka kanálů | Bouquet: pojmenovaná sada kanálů, filmů nebo seriálů, kterou balíček zpřístupní | Bouquets, ze Streams a Movies / Series |
| Kanál nebo informační 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) |
| Uvítací videa a oznámení | VOD katalog: filmy a seriály se sezónami a epizodami, kategoriemi a metadaty | Movies a Series, nebo úloha ingestu VOD |
| Přístup bytu | 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 |
| Doba nájmu nebo bydlení | Datum expirace linky, obnovované balíčkem, kreditem nebo přes API | Datum expirace linky a trvání balíčku |
| Uzel budovy | 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 pro správcovskou společnost (Ubuntu 22.04 nebo 24.04), instalátor a server pro každou budovu, který dosáhne do sítě obyvatel.
- Signály kanálů, které smí komunita retransmitovat (pull URL nebo RTMP), oznámení a uvítací videa správcovské společnosti a zařízení obyvatel (set-top boxy, chytré televize s aplikací přehrávače nebo prohlížeč).
- Rozhodnutí o druzích bytů (standardní, seniorský, studentský) a o tom, kdo ve správcovské společnosti otevírá a obnovuje linky.
Nasazení infrastruktury
Centrální server, potom uzel na budovu.
- Spusťte instalátor na centrálním serveru a nastavte základní URL přehrávání na adresu, na kterou budovy dosáhnou.
- Přidejte signály kanálů v sekci Streamy a oznámení v sekci Filmy a zkontrolujte je ve webovém přehrávači.
- Zaregistrujte uzel na budovu v sekci Servery; panel ho nainstaluje přes SSH, nebo se uzel zaregistruje jednorázovým kódem, a směruje k němu obyvatele dané budovy.
- Přidejte správce nemovitosti v sekci Uživatelé → přidat resellera, se skupinou, která povoluje linky a zakazuje změny katalogu.
Organizace obsahu
Nabídky kanálů na druh bytu.
- Vytvořte jeden bouquet na nabídku z kanálů každého druhu bytu a bouquet pro informace správcovské společnosti.
- Přidejte informační bouquet do každého balíčku, aby každý obyvatel dostával oznámení.
- Vytvořte jeden balíček na druh bytu s jeho bouquety a dobou trvání odpovídající nájmu nebo době bydlení.
- Seřaďte kanály a dejte jim loga, aby se menu na televizi dobře četlo.
Konfigurace partnerů (resellerů)
Správce nemovitosti jako delegovaný účet.
- Vytvořte skupinu s oprávněními omezenými na linky, bez přístupu ke katalogu a serverům.
- Přidejte každého správce nemovitosti jako resellera s touto skupinou, balíčky jeho bytů a zůstatkem kreditů.
- Správce více budov může přidat sub-resellera na budovu, každého s vlastními byty a kredity.
Konfigurace bytu (linky)
Jedna linka na byt, pojmenovaná jeho číslem.
- Vytvořte jednu linku na byt v sekci Linky → přidat, s číslem bytu jako názvem a balíčkem daného druhu bytu.
- Nastavte maximální počet připojení na počet televizí v domácnosti.
- Použijte aktivační kód místo hesla, když má obyvatel na zařízení zadat krátký kód.
- Nakonfigurujte zařízení jednou (Xtream Codes API nebo M3U s údaji linky, nebo portál MAG či Enigma2); údaje zůstávají u bytu, dokud linka nedostane nové.
Uvítací videa a oznámení
Videa správcovské společnosti na vyžádání.
- Nahrajte uvítací video, domovní řád a návody k údržbě jako filmy, s kategorií podle tématu.
- Zařaďte je do informačního bouquetu, aby je zahrnoval každý balíček.
- Když se informace změní, nahraďte video z panelu; obyvatelé okamžitě vidí novou verzi.
Kanály a informační kanál
Nabídka kanálů a kanál oznámení jako živé streamy.
- Přidejte každý licencovaný kanál v sekci Streamy s jeho signálem a zdroj EPG, aby průvodce na televizi ukazoval pořady.
- Přidejte informační kanál jako živý stream, napájený encoderem přes RTMP nebo smyčkovým zdrojem, a umístěte ho do informačního bouquetu.
- Kanály s územním omezením držte v bouquetech, které uděluje jen správný balíček.
Nastěhování, odstěhování a expirace
Obsazenost jako platnost linky.
- Linka vyprší na konci období svého balíčku; obnovte ji balíčkem nebo kreditem na každé nové období nájmu.
- Když se obyvatel odstěhuje, linku zakažte; další obyvatel ji znovu povolí s novými přihlašovacími údaji, takže u staré domácnosti nic nezůstane.
- Přihlaste bytový systém nebo správce k webhookům, abyste viděli linky, kterým brzy vyprší platnost nebo už vypršela.
Integrace s bytovým nebo fakturačním systémem
Systémy otevírají přístup; přehrávač přehrává.
- Vytvořte klíč Reseller API pro bytový nebo fakturační systém; volá create_line, renew_line, enable_line a disable_line a u každého zápisu posílá ID požadavku.
- Použijte obchodní konektor, když obyvatelé kupují doplňkové balíčky online; jakýkoli jiný systém používá Reseller API a webhooky.
- Pro diváky neexistuje jednotné přihlášení: obyvatel se do přehrávače přihlašuje údaji linky.
Bezpečnostní hlediska
Udržte službu uvnitř komunity.
- Provozujte panel za reverse proxy s TLS a nastavte TRUSTED_PROXIES, aby auditní log a pravidla IP viděly skutečné adresy.
- Dvoufázové přihlášení pro každý účet správy; správci nemovitostí dostanou skupinu oprávnění omezenou na linky.
- Limit připojení na linku, podepsané a vypršující odkazy pro přehrávání a svázání s adresou tam, kde mají zařízení pevné adresy.
- Zapněte šifrovanou zálohu databáze s kopií mimo pracoviště; jsou v ní přihlašovací údaje linek.
Řešení potíží
Obvyklé první kontroly.
- Byt nemá televizi: zkontrolujte, zda je jeho linka povolená a nevypršela, poté údaje zařízení a adresu přehrávání.
- Budova se večer zasekává: zkontrolujte heartbeat uzlu budovy a zda jsou k němu její obyvatelé směrováni.
- Pro jeden druh bytu chybí kanál: zkontrolujte bouquety daného balíčku.
- Správce nemůže vytvářet linky: zkontrolujte zůstatek kreditů resellera, oprávnění jeho skupiny a balíčky, které mu jsou přiřazeny.