Dessa guider kopplar en branschs begrepp till de objekt som plattformen har i dag (bouquets, linjer, paket, partnerkonton, noder, API:et). De är begreppsmässiga motsvarigheter, inte branschspecifika funktioner, och ett partnerkonto är ett delegerat konto, inte en isolerad hyresgäst.
Begreppsmässig mappning
Inget i panelen heter butik eller franchisetagare. Tabellen anger vilket objekt som spelar vilken roll; kapitlen nedan sätter upp dem i den ordningen.
| I din bransch | På plattformen | Var i panelen |
|---|---|---|
| Butikskanal eller utbildningssamling | Bouquet: en namngiven uppsättning kanaler, filmer eller serier som ett paket ger tillgång till | Bouquets, från Strömmar och Movies / Series |
| Butikskanal | Live-kanal: en ström med sina källor, EPG och utdataformat | Strömmar → lägg till en live-ström (käll-URL eller RTMP-push) |
| Utbildnings- och produktvideo | VOD-katalog: filmer och serier med säsonger och avsnitt, kategorier och metadata | Movies och Series, eller VOD-ingest-jobbet |
| Butiksskärm eller personalåtkomst | Linje: en åtkomst med sitt paket, sina bouquets, förfallodatum, anslutningsgräns och utdata | Linjer → lägg till, eller aktiveringskoder, eller Reseller API |
| Franchisetagarens konto | Partnerkonto (återförsäljare): en delegerad panel med krediter, behörigheter och egna linjer | Users → lägg till en återförsäljare; Groups för dess behörigheter |
| Regional nod | Streamingnoder: edge-servrar som registreras från panelen, en per plats eller byggnad | Servers → lägg till en nod, installerad via SSH |
| Skärmar eller enheter per linje | Linjens max antal anslutningar: hur många enheter som får titta samtidigt | Linjens max antal anslutningar |
Förutsättningar
Vad du ska ha innan du installerar.
- En server på huvudkontoret (Ubuntu 22.04 eller 24.04), installationsprogrammet och en server för varje region som har många butiker och kan nås från dem.
- Butikskanalens innehåll (en encoder eller en loopande källa), inspelningarna av introduktion och produktutbildning och skärmarna eller mediaspelarna i butikerna.
- Ett beslut om franchisestrukturen: vilka regioner som får en nod, och vem hos varje franchisetagare som hanterar linjer.
Driftsättning av infrastrukturen
Först huvudkontoret, sedan regionerna.
- Kör installationsprogrammet på huvudkontorets server och ange uppspelningsbasens URL till en adress butikerna kan nå, bakom TLS.
- Lägg till butikskanalen under Strömmar och utbildningsinspelningarna under Movies, och kontrollera dem i webbspelaren.
- Registrera en nod per region via Servers; panelen installerar den via SSH, eller så registrerar noden sig med en engångskod, och dirigerar den regionens butiker till sig.
- Skapa ett partnerkonto för huvudkontorets innehållsteam med behörigheter för katalogen och inga för butikernas linjer.
Organisation av innehållet
Butikskanalen och utbildningsbiblioteket.
- Skapa en live-ström för butikskanalen och lägg den i en egen bouquet.
- Skapa kategorier per ämne och en serie per utbildning, med ett avsnitt per lektion; lägg till en bouquet per roll (säljare, chefer, nyanställda).
- Skapa ett paket för butiksskärmarna och ett paket per roll, vart och ett med sina bouquets och med åtkomstperioden som löptid.
- Ge franchisetagarna de paket de får sälja vidare till sina butiker och sin personal.
Konfiguration av partner (återförsäljare)
Ett partnerkonto per franchisetagare.
- Skapa en grupp med behörigheter begränsade till linjer, utan katalogändringar.
- Lägg till varje franchisetagare under Users → lägg till en återförsäljare, med den gruppen, sina paket och ett kreditsaldo.
- En franchisetagare med flera regioner kan lägga till en underåterförsäljare per region, var och en med egna butiker.
Konfiguration av linjer för butiker och personal
En linje per skärm och per anställd.
- Skapa en linje per butiksskärm via Linjer → lägg till med butikens namn och butikspaketet; franchisetagaren gör samma sak för sina egna butiker.
- Ställ in max antal anslutningar på antalet skärmar i butiken, och på två för en anställd (butiksgolvet och telefonen).
- Bind en butikslinje till butikens adress när butiken har en fast, så att inloggningsuppgifterna inte fungerar någon annanstans.
- Konfigurera skärmens spelare en gång (M3U, Xtream Codes API eller webbspelarens adress) och förvara inloggningsuppgifterna i butikens akt.
Utbildnings- och produktvideo
Biblioteket för personal.
- Ladda upp varje utbildning som en serie och varje produktfilm som en film, eller importera dem med VOD-ingestjobbet till mediarooten.
- Lägg inspelningarna i rätt rolls bouquet via deras kategorier.
- Kontrollera vad varje roll ser med en testlinje innan du öppnar biblioteket för franchisetagarna.
Butikskanalen
En kanal för alla skärmar.
- Lägg till butikskanalen som en live-ström, matad av huvudkontorets encoder via RTMP eller av en loopande källa.
- Aktivera catch-up för de utbildningspass som sänds live, och ladda upp inspelningen till biblioteket efteråt.
- Noderna i regionerna hämtar kanalen en gång från origin och betjänar sina butiker, så att butikernas länkar inte blir mättade.
Förfallodatum och förnyelse
Åtkomsten följer butiken eller avtalet.
- En linje går ut vid slutet av sitt pakets period; franchisetagaren förnyar den med ett paket eller en kredit.
- Inaktivera linjen för en nedlagd butik eller en anställd som slutar.
- Prenumerera franchisehanterings- eller HR-systemet på webhooks för att se linjer som snart går ut eller redan har gått ut.
Integration med franchise- eller HR-system
Systemen styr linjer; spelaren spelar.
- Skapa en Reseller API-nyckel för franchisehanterings- eller HR-systemet; det anropar create_line, renew_line, enable_line och disable_line, med ett request-id på varje skrivning.
- Använd en handelsconnector när du fakturerar franchisetagare för tjänsten; alla andra system använder Reseller API och webhooks.
- Det finns ingen single sign-on för tittare: personalen loggar in i spelaren med inloggningsuppgifterna för sin linje.
Säkerhetsaspekter
Håll varje butik på sina egna linjer.
- Servera panelen bakom en reverse proxy med TLS och sätt TRUSTED_PROXIES så att granskningsloggen och IP-reglerna ser riktiga adresser.
- Tvåfaktorsinloggning för varje konto på huvudkontoret; franchisetagare får en behörighetsgrupp begränsad till sina egna linjer.
- En anslutningsgräns per linje, signerade uppspelningslänkar som går ut och adressbindning för butiksskärmarna.
- Aktivera den krypterade databassäkerhetskopian med en kopia utanför platsen, och använd granskningsloggen för att granska ändringar av linjer och katalog.
Felsökning
De vanliga första kontrollerna.
- En butiksskärm är svart: kontrollera att dess linje är aktiverad och inte har gått ut, adressbindningen, och anslutningsgränsen om en andra enhet använder linjen.
- En region buffrar: kontrollera den regionala nodens heartbeat och att butikerna dirigeras till den.
- En franchisetagare kan inte skapa linjer: kontrollera dess kreditsaldo, gruppbehörigheter och de paket som är tilldelade den.
- Granskningsloggen visar proxyns adress: sätt TRUSTED_PROXIES till proxyn och starta om panelen.