Deze gidsen koppelen de begrippen van een sector aan de objecten die het platform vandaag heeft (bouquets, lijnen, pakketten, partneraccounts, nodes, de API). Het zijn conceptuele toewijzingen, geen sectorspecifieke functies, en een partneraccount is een gedelegeerd account, geen geïsoleerde tenant.
Conceptuele toewijzing
Niets in het paneel heet een appartement of een bewoner. De tabel zegt welk object welke rol speelt; de hoofdstukken hieronder richten ze in die volgorde in.
| In je sector | Op het platform | Waar in het paneel |
|---|---|---|
| Account van vastgoedbeheerder | Partneraccount (reseller): een gedelegeerd dashboard met credits, rechten en eigen lijnen | Users → een reseller toevoegen; Groups voor zijn rechten |
| Kanaalaanbod | Bouquet: een benoemde set kanalen, films of series die een pakket toekent | Bouquets, vanuit Streams en Movies / Series |
| Kanaal of informatiekanaal | Live kanaal: een stream met zijn bronnen, EPG en uitvoerformaten | Streams → een live stream toevoegen (bron-URL of RTMP-push) |
| Welkomst- en mededelingenvideo's | VOD-catalogus: films en series met seizoenen en afleveringen, categorieën en metadata | Movies en Series, of de VOD-ingesttaak |
| Toegang van een appartement | Lijn: één toegang met pakket, bouquets, vervaldatum, verbindingslimiet en uitvoer | Lijnen → toevoegen, of activeringscodes, of de Reseller-API |
| Huur- of bewoningsperiode | Vervaldatum van de lijn, verlengd door een pakket, een credit of de API | De vervaldatum van de lijn en de looptijd van het pakket |
| Node van een gebouw | Streamingnodes: edge-servers die vanuit het paneel worden geregistreerd, één per locatie of gebouw | Servers → een node toevoegen, geïnstalleerd via SSH |
Vereisten
Wat je nodig hebt voor de installatie.
- Een server voor het beheerbedrijf (Ubuntu 22.04 of 24.04), de installer en een server voor elk gebouw die het netwerk van de bewoners kan bereiken.
- De kanaalfeeds die de gemeenschap mag doorgeven (pull-URL's of RTMP), de mededelingen en welkomstvideo's van het beheerbedrijf en de apparaten van de bewoners (set-topboxen, smart-tv's met een speler-app of een browser).
- Een besluit over de soorten woning (standaard, senior, student) en wie bij het beheerbedrijf de lijnen opent en verlengt.
Uitrol van de infrastructuur
De centrale server, daarna een node per gebouw.
- Draai de installer op de centrale server en stel de afspeelbasis-URL in op een adres dat de gebouwen kunnen bereiken.
- Voeg de kanaalfeeds toe onder Streams en de mededelingen onder Movies, en controleer ze in de webspeler.
- Meld via Servers een node per gebouw aan; het paneel installeert hem via SSH, of de node meldt zich aan met een eenmalige code, en stuurt de bewoners van dat gebouw ernaartoe.
- Voeg de vastgoedbeheerder toe onder Users → een reseller toevoegen, met een groep die lijnen toestaat en geen wijzigingen in de catalogus.
Indeling van de content
Kanaalaanbod per soort woning.
- Maak één bouquet per kanaalaanbod uit de kanalen van elke soort woning, en een bouquet voor de informatie van het beheerbedrijf.
- Voeg de informatiebouquet toe aan elk pakket, zodat elke bewoner de mededelingen ontvangt.
- Maak één pakket per soort woning met zijn bouquets en een looptijd die past bij het huurcontract of de bewoningsperiode.
- Zet de kanalen in volgorde en geef ze logo's, zodat het menu op de televisie goed leest.
Configuratie van partners (resellers)
De vastgoedbeheerder als gedelegeerd account.
- Maak een groep met rechten die beperkt zijn tot lijnen, zonder toegang tot de catalogus of de servers.
- Voeg elke vastgoedbeheerder toe als reseller met die groep, de pakketten van zijn woningen en een creditsaldo.
- Een beheerder van meerdere gebouwen kan per gebouw een subreseller toevoegen, elk met eigen woningen en credits.
Configuratie van appartementen (lijnen)
Eén lijn per appartement, genoemd naar het nummer.
- Maak onder Lijnen → toevoegen één lijn per appartement aan, met het appartementnummer als naam en het pakket van die soort woning.
- Stel het maximale aantal verbindingen in op het aantal televisies in de woning.
- Gebruik een activeringscode in plaats van een wachtwoord wanneer de bewoner een korte code op het apparaat moet invoeren.
- Configureer het apparaat eenmalig (Xtream Codes API of M3U met de inloggegevens van de lijn, of het MAG- of Enigma2-portal); de inloggegevens blijven bij het appartement totdat de lijn nieuwe krijgt.
Welkomst- en mededelingenvideo's
De video's van het beheerbedrijf op aanvraag.
- Upload de welkomstvideo, de huisregels en de onderhoudsgidsen als films, met een categorie per onderwerp.
- Zet ze in de informatiebouquet zodat elk pakket ze bevat.
- Vervang een video vanuit het paneel wanneer de informatie verandert; de bewoners zien de nieuwe versie meteen.
Kanalen en het informatiekanaal
Het kanaalaanbod en het mededelingenkanaal als live streams.
- Voeg elk gelicentieerd kanaal toe onder Streams met zijn feed, en een EPG-bron zodat de gids op de televisie de programma's toont.
- Voeg het informatiekanaal toe als live stream, gevoed door een encoder via RTMP of door een herhalende bron, en zet het in de informatiebouquet.
- Houd kanalen met gebiedsbeperkingen in bouquets die alleen de juiste pakketten toekennen.
Intrekken, vertrekken en vervaldatum
De bewoning als geldigheid van de lijn.
- Een lijn verloopt aan het einde van de periode van zijn pakket; verleng hem met het pakket of een credit voor elke nieuwe periode van het huurcontract.
- Schakel de lijn uit wanneer een bewoner vertrekt; de volgende bewoner schakelt hem weer in met nieuwe inloggegevens, zodat er niets bij het oude huishouden blijft.
- Abonneer het woningsysteem of de beheerder op de webhooks om lijnen te zien die bijna verlopen of al zijn verlopen.
Integratie met een woning- of facturatiesysteem
Systemen openen de toegang; de speler speelt af.
- Maak een Reseller-API-sleutel voor het woning- of facturatiesysteem; dat roept create_line, renew_line, enable_line en disable_line aan en stuurt bij elke schrijfactie een request-id mee.
- Gebruik een commerceconnector wanneer bewoners extra pakketten online kopen; elk ander systeem gebruikt de Reseller-API en webhooks.
- Er is geen single sign-on voor kijkers: een bewoner meldt zich in de speler aan met de inloggegevens van de lijn.
Beveiligingsoverwegingen
Houd de dienst binnen de gemeenschap.
- Serveer het paneel achter een reverse proxy met TLS en stel TRUSTED_PROXIES in, zodat het auditlogboek en de IP-regels echte adressen zien.
- Aanmelden met twee factoren voor elk beheeraccount; de vastgoedbeheerders krijgen een rechtengroep die beperkt is tot lijnen.
- Een verbindingslimiet per lijn, ondertekende en verlopende afspeellinks en adresbinding waar apparaten vaste adressen hebben.
- Schakel de versleutelde databaseback-up met een off-sitekopie in; de inloggegevens van de lijnen staan erin.
Probleemoplossing
De gebruikelijke eerste controles.
- Een appartement heeft geen televisie: controleer of de lijn is ingeschakeld en niet is verlopen, en daarna de inloggegevens van het apparaat en het afspeeladres.
- Een gebouw buffert in de avond: controleer de heartbeat van de gebouwnode en of zijn bewoners ernaartoe worden gestuurd.
- Een kanaal ontbreekt voor één soort woning: controleer de bouquets van dat pakket.
- Een beheerder kan geen lijnen aanmaken: controleer het creditsaldo van de reseller, de groepsrechten en de pakketten die eraan zijn toegewezen.