Installatiegids voor mediamakers en contentcreators

Conceptuele toewijzing

Niets in het paneel heet een programma of een supporter. De tabel zegt welk object welke rol speelt; de hoofdstukken hieronder richten ze in die volgorde in.

1Vereisten

Wat je nodig hebt voor de installatie.

1. Een server (Ubuntu 22.04 of 24.04) met een openbaar adres of een domein, en genoeg upstreambandbreedte voor het publiek dat je verwacht.
2. De afgewerkte afleveringen, de playout of encoder van de studio voor het kanaal, en een shop op een platform met een connector, of de mogelijkheid om een HTTP-API aan te roepen.
3. Een besluit over niveaus en affiliates: wat elk abonnement toekent en wie het mag verkopen.

2Uitrol van de infrastructuur

Eerst één server, nodes naarmate het publiek groeit.

1. Draai de installer op de beheerserver en zet het paneel achter een reverse proxy met TLS; stel de vertrouwde proxy's in zodat IP-regels het echte adres van de kijker zien.
2. Stel de afspeelbasis-URL in op het openbare adres dat je publiek bereikt.
3. Meld via Servers een node aan in een regio waar veel supporters kijken; het paneel installeert hem via SSH en stuurt de kijkers van die regio ernaartoe.
4. Maak een partneraccount (reseller) voor elke medewerker die de catalogus of de supporters beheert, met een eigen rechtengroep.

3Indeling van de content

Programma's als series, niveaus als bouquets.

1. Maak categorieën per genre, en één serie per programma met een seizoen per uitgavebatch en één aflevering per video.
2. Maak een bouquet voor het live kanaal, één voor de gratis of instapcontent en één voor elk hoger niveau.
3. Maak één pakket per niveau met de factuurperiode als looptijd, een proefpakket voor nieuwe bezoekers als je dat wilt, en een prijs in credits voor de affiliates.
4. Houd de back-catalogus in een eigen categorie, zodat hij tussen niveaus kan worden verplaatst zonder de series aan te raken.

4Configuratie van partners (resellers)

Affiliates en distributeurs.

1. Maak een groep voor affiliates met alleen rechten voor lijnen, zodat ze de catalogus niet kunnen wijzigen.
2. Voeg elke affiliate toe als reseller met die groep en een creditsaldo; de pakketprijs bepaalt de studio.
3. Een distributeur met sub-affiliates mag onder zijn eigen account subresellers aanmaken, tot vijf niveaus diep.

5Configuratie van supportertoegang

Eén lijn per supporter.

1. Installeer de connector van je shop (bijvoorbeeld WooCommerce) en voer de Reseller-API-sleutel en het pakket in dat bij elk product hoort.
2. Bij een abonnement roept de connector create_line aan met het pakket en een request-id; de factuurperiode is de looptijd van het pakket.
3. Stel het maximale aantal verbindingen in op het aantal apparaten dat een supporter mag gebruiken, doorgaans twee of drie.
4. Genereer voor een giveaway of een lancering in bulk activeringscodes of voeg via Lijnen → toevoegen lijnen toe met een proefpakket.

6Programmabibliotheek

Afleveringen op aanvraag.

1. Upload elke aflevering als bron, of importeer hem met de VOD-ingesttaak; vul de titel, het seizoen, het afleveringsnummer en de TMDB-metadata in als het programma die heeft.
2. Koppel elke serie aan de bouquets van de niveaus die haar mogen bekijken.
3. Controleer het afspelen met een testlijn van elk niveau voordat je een uitgave aankondigt.

7Het kanaal van de studio

Een kanaal rond de klok.

1. Voeg een live stream toe voor de playout van de studio (RTMP-push) en plaats hem in de bouquets van elk niveau dat het kanaal bevat.
2. Laad de gids van het kanaal als XMLTV zodat supporters zien wat er is, en schakel catch-up in voor de programma's die herhalen waard zijn.
3. Houd de playout tussen uitgaves door draaiend met de eigen geplande content van de studio; het paneel relayt alleen de stream.

8Vervaldatum van abonnementen

Toegang volgt de betaling.

1. Een lijn verloopt aan het einde van de periode van zijn pakket; de shop verlengt hem met renew_line wanneer de volgende betaling binnenkomt.
2. Abonneer de shop op de webhooks om een herinnering te sturen bij line.expiring en een supporter terug te zetten bij line.expired.
3. Een supporter die opzegt wordt door de shop met disable_line uitgeschakeld, en de lijn kan later zonder nieuw account worden verlengd.

9Integratie met de shop

De shop verkoopt; de speler speelt af.

1. De connector maakt lijnen aan, verlengt en schakelt ze uit in de pas met bestellingen; elke andere shop gebruikt de Reseller-API en webhooks.
2. Affiliates zien hun eigen lijnen in hun dashboard, en met de Reseller-API kunnen ze dat automatiseren.
3. Er is geen single sign-on voor kijkers: supporters melden zich in de speler aan met de inloggegevens van hun lijn, die de shop hun stuurt.

10Beveiligingsoverwegingen

Bescherm het abonnement, niet alleen de server.

1. Serveer het paneel en de afspeelbasis-URL via TLS en stel TRUSTED_PROXIES in op je reverse proxy.
2. Aanmelden met twee factoren voor elk paneelaccount, en rechtengroepen zodat affiliates de catalogus niet kunnen wijzigen.
3. Ondertekende en verlopende afspeellinks en een verbindingslimiet per lijn; koppel een lijn aan een land als een licentie gebiedsgebonden is.
4. Versleutelde databaseback-ups met een off-sitekopie, en het auditlogboek voor elke wijziging van lijnen en catalogus.

11Probleemoplossing

De gebruikelijke eerste controles.

1. Een nieuwe supporter kan na betaling niet kijken: controleer de aanroep van de shopconnector in het Reseller-API-logboek en de vervaldatum van de lijn.
2. Een supporter ziet content van een hoger niveau: controleer het pakket van de lijn en de bouquets die het toekent.
3. Het kanaal stopt aan het einde van een playoutcyclus: controleer de push van de encoder naar de live stream en de probestatus van de stream.
4. De verkoop van een affiliate verschijnt niet: controleer zijn credits en of het gebruikte pakket bij zijn groep hoort.