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 abonnement of een point of presence. 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 dealer of regionale partner | Partneraccount (reseller): een gedelegeerd dashboard met credits, rechten en eigen lijnen | Users → een reseller toevoegen; Groups voor zijn rechten |
| Kanaalniveau of uitbreidingspakket | Bouquet: een benoemde set kanalen, films of series die een pakket toekent | Bouquets, vanuit Streams en Movies / Series |
| Televisiekanaal | Live kanaal: een stream met zijn bronnen, EPG en uitvoerformaten | Streams → een live stream toevoegen (bron-URL of RTMP-push) |
| VOD-bibliotheek | VOD-catalogus: films en series met seizoenen en afleveringen, categorieën en metadata | Movies en Series, of de VOD-ingesttaak |
| Televisietoegang van de abonnee | Lijn: één toegang met pakket, bouquets, vervaldatum, verbindingslimiet en uitvoer | Lijnen → toevoegen, of activeringscodes, of de Reseller-API |
| Einde van de factuurperiode | Vervaldatum van de lijn, verlengd door een pakket, een credit of de API | De vervaldatum van de lijn en de looptijd van het pakket |
| Schermen per abonnement | Max. verbindingen van de lijn: hoeveel apparaten tegelijk mogen kijken | De max. verbindingen van de lijn |
| Integratie met facturatie en provisioning | Reseller-API en webhooks: de handelingen van het paneel vanuit je eigen systeem | Reseller-API-sleutels en webhooks in het dashboard van de reseller |
| Node van een point of presence | 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 op de kernlocatie (Ubuntu 22.04 of 24.04), de installer, een domein of adres dat abonnees kunnen bereiken, en een server in elke point of presence voor de nodes.
- De gelicentieerde kanaalfeeds, de VOD-bibliotheek en het facturatiesysteem waarin de abonnementen staan.
- Een besluit over de niveaus, hoe lang een factuurperiode duurt en welke dealers een partneraccount krijgen.
Uitrol van de infrastructuur
De kernlocatie, daarna de points of presence.
- Draai de installer op de kernserver; zet het paneel achter je reverse proxy en stel TRUSTED_PROXIES in zodat logs en IP-regels het echte adres van de abonnee zien.
- Stel de afspeelbasis in op het openbare adres dat abonnees bereiken, en de licentiesleutel op de server.
- Meld via Servers een node per point of presence aan; het paneel installeert hem via SSH, of de node meldt zich aan met een eenmalige code, en stuurt de abonnees in de buurt ernaartoe.
- Maak een partneraccount (reseller) voor support of voor het facturatieteam met alleen rechten voor lijnen.
Indeling van de content
Niveaus en uitbreidingen als bouquets.
- Voeg de kanalen toe onder Streams en de VOD-bibliotheek onder Movies en Series, met categorieën en een EPG-bron.
- Maak bouquets voor het basisaanbod, de premiumkanalen en de VOD-bibliotheek.
- Maak één pakket per abonnementsniveau met de bouquets die het toekent, de factuurperiode als looptijd en een prijs in credits.
- Maak een kort proefpakket voor een actie of een nieuwe klant.
Configuratie van partners (resellers)
Dealers met credits.
- Maak een groep voor dealers met rechten voor hun eigen lijnen en zonder toegang tot de catalogus of instellingen.
- Voeg elke regionale dealer toe als partneraccount met die groep, de pakketten die hij mag verkopen en een saldo aan credits; een dealer kan subresellers hebben tot vijf niveaus diep.
- De webhook credits.low en de melding over weinig credits laten een dealer bijstorten voordat de verkoop stopt.
Configuratie van lijnen voor abonnees
Eén lijn per abonnement.
- De facturatie maakt een lijn aan wanneer een abonnement start, via een connector of action=create_line van de Reseller-API met het pakket van het niveau en een request-id.
- Stel het maximale aantal verbindingen per niveau in: het aantal schermen dat een huishouden tegelijk mag gebruiken.
- Koppel een lijn aan het adres, het land of de ISP van de abonnee wanneer het aanbod alleen voor je eigen netwerk is.
- Voeg voor een pilot of een supportgeval lijnen toe via Lijnen → toevoegen en deel de inloggegevens uit.
VOD-bibliotheek
De catalogus op aanvraag.
- Voeg films en series met seizoenen en afleveringen toe, geïmporteerd met de VOD-ingesttaak of geüpload, met TMDB-metadata voor posters en beschrijvingen.
- Groepeer de titels in bouquets per niveau of uitbreiding, zodat een pakket precies toekent wat het abonnement bevat.
- De nodes cachen de VOD-bestanden, zodat populaire titels worden geleverd vanuit de point of presence bij de abonnee.
Live kanalen
Het kanaalaanbod.
- Voeg elk gelicentieerd kanaal toe onder Streams met zijn feed en schakel catch-up of timeshift alleen in waar de rechten dat toestaan.
- Voeg een EPG-bron toe zodat apps en boxen de programmagids tonen.
- Elke node haalt een live kanaal één keer op bij de origin en verspreidt het naar zijn abonnees.
Vervaldatum, verlenging en opzegging
De factuurperiode als geldigheid van de lijn.
- Een lijn duurt zo lang als de periode van zijn pakket; de facturatie verlengt hem elke periode met action=renew_line of via de connector.
- Wanneer een abonnement afloopt of wordt opgezegd, roept de facturatie action=disable_line aan en schakelt de lijn bij heractivering weer in.
- Abonneer de facturatie op de webhooks om aflopende en verlopen lijnen af te stemmen met haar administratie.
Integratie met de facturatie
De facturatie stuurt de toegang aan; de speler speelt af.
- Installeer de connector voor je facturatiesysteem aan zijn kant (WHMCS, Blesta, Odoo en andere), of roep de Reseller-API aan met een sleutel en een request-id vanuit je eigen systeem.
- Er is geen single sign-on voor kijkers: een abonnee meldt zich in een app of op een box aan met de inloggegevens van de lijn, die de facturatie in het klantenpaneel kan tonen.
- Gebruik Admin-API-sleutels met de alleen-lezenvlag, een IP-toegestaanlijst en een vervaldatum voor rapportagetools.
Beveiligingsoverwegingen
Houd de dienst voor abonnees.
- Zet het paneel achter de reverse proxy met TLS en stel TRUSTED_PROXIES in; houd het beheerverkeer van de nodes op een privénetwerk.
- Aanmelden met twee factoren voor elk paneelaccount en rechtengroepen voor support en dealers; reCAPTCHA of Turnstile bij het aanmelden.
- Ondertekende en verlopende afspeellinks, een verbindingslimiet per abonnement en binding aan een adres, een land of een ISP waar dat past.
- Versleutelde databaseback-ups met een off-sitekopie, en het auditlogboek voor elke wijziging van lijnen en credits.
Probleemoplossing
De gebruikelijke eerste controles.
- Een abonnee heeft geen televisie: controleer of de lijn is ingeschakeld en niet is verlopen, en daarna de aanroep van de facturatie in het Reseller-API-aanroeplogboek.
- Een kanaal ontbreekt voor één niveau: controleer de bouquets van het pakket van dat niveau.
- Een point of presence buffert: controleer de heartbeat van zijn node en of zijn abonnees ernaartoe worden gestuurd.
- Een dealer kan geen lijn aanmaken: controleer zijn credits en of het pakket er een is dat hij mag verkopen.